Raneto : markdown knowledgebase

[jdaviescoates]

@timconsidine nice.

See also https://github.com/appsecco/raneto-docker

[chetbaker]

Oh this is a nice app. Upvote!

[robi]

no DB, so really fast and easy to package.

[LoudLemur]

@timconsidine

Please accept my little upvote.

So, Raneto is like a next-generation wiki software?

If anybody is familiar with Raneto, have people tried importing a wiki and converting it to a Raneto?

I wonder if Raneto works well with Kiwix to produce readable .zim files.

Raneto is like a static site generator, so it might work well with IPFS. I don't know if that has been tried.

Raneto might pair well with yn (yank-note).

Why do you all like Raneto?

[timconsidine]

@LoudLemur Personally I don't see Raneto as a wiki, more as a nice simple app for documentation, knowledge-base etc. That's my 'use case' anyway. In that scenario, nice clean layout is more important than fancy presentation, and ease of updating is critical, because documentation is very often a weak point for systems & work-flows, so making it easy to update helps to keep docs up to date.

But maybe you can envisage a wiki type of usage.

Sorry, I don't know the answers to the other interesting questions you ask.

[timconsidine]

@robi : after some fiddling, I have self-packaged Raneto for Cloudron

https://git.cloudron.io/timconsidine/raneto-for-cloudron

Biggest challenge was adapting to the Cloudron separation of /app/code and /app/data. The app author seemed to envisage a single directory structure for app and content/config. Not technically difficult, just fiddly to work out where things were hiding.

As ever, I may not have done it the best way, so happy to receive advice on improvements.

NB : I have added a postinstallMessage about the default login credentials. They need to be changed in /app/data/config.js. Other config changes possible there too. The message shows in the app settings Documentation drop-down, but it doesn't pop up on first run, like the App Store apps. Haven't found out how to do that.

Background : I have Raneto running nicely on a small CapRover deployment, but I was 'itch-scratching' as I want it on my primary VPS which is Cloudron.

No idea whether it is suitable for the AppStore or what improvements needed for that. But if the self-package helps someone to scratch their own itch, yay!

EDIT : Raneto can probably be installed in a Cloudron LAMP app, if that's easier for people than doing a self-install.

[robi]

@timconsidine well done!

@staff can take it from here.

[timconsidine]

@nookscape posted about Gitbooks https://forum.cloudron.io/post/51860
That's locked so posting here that Raneto is worth a look
My self-package available above

[timconsidine]

Raneto original repo has been archived, but someone seems to have taken it over.

https://github.com/ryanlelek/Raneto

I am (trying to) update the custom package I did for it.
Will post here when (if) I am successful.

Interesting update is that the new version now allows for it to be private (no anonymous readers, only logged in users). So it can function as a private KB or a public KB.

I like Raneto because it fills a gap between unstructured note taking (e.g. Meemo, FlatNotes) and more complex wiki style sites (MediaWiki), with easy editing and clean looking rendered pages.

I like CodexDocs also, but also struggling to get that fully working as a Cloudron package.

[chetbaker]

@timconsidine said in Raneto : markdown knowledgebase:

Interesting update is that the new version now allows for it to be private (no anonymous readers, only logged in users). So it can function as a private KB or a public KB.

Oh this is interesting. Looking forward to hear your success story

[timconsidine]

Yay !
My custom package is now updated : https://git.cloudron.io/timconsidine/raneto-for-cloudron

The source repo has been recently updated.
The release version is low : 0.17.5 but it's stable and mature and some hope for the future with a new owner.
Waiting for it to be V1.0 before adding to the Cloudron App Store might be a long wait !

Website : https://raneto.com
Demo/Docs : https://docs.raneto.com

Remember to change default login in /app/data/config/config.js and then RESTART the app.

I feel this fills a gap in the current documentation / knowledgebase apps in the App Store, so I hope it helps others and can be considered for the App Store.

Visual design is simple, but that's what I like about it.
Kinda just works.

I have been using it as public knowledge base for a small business.
With the addition of authentication just to view any pages, it's now addresses need for private documentation which is more structured than note collections.

[timconsidine]

Hmmm
There seems to be an issue with html encoding affecting code segments in Markdown
Doesn't invalidate usefulness of Raneto but it does perhaps limit its scope
https://github.com/ryanlelek/Raneto/issues/381
Creation works ok : subsequent editing of the file gets screwed.

I have found that not using the built-in editor but editing and saving the content file directly gets around this.
But yes, this detracts from ease of app interface.

Maybe not ready for the app store until is fixed.