Raneto : markdown knowledgebase
-
@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/codeand/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
postinstallMessageabout 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.
Indie app dev, scratching my itches, lover of Cloudron PaaS, communityapps.appx.uk
-
@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/codeand/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
postinstallMessageabout 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 : 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/codeand/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
postinstallMessageabout 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.
@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 -
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.
Indie app dev, scratching my itches, lover of Cloudron PaaS, communityapps.appx.uk
-
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.
@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
-
Yay !
My custom package is now updated : https://git.cloudron.io/timconsidine/raneto-for-cloudronThe 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.comRemember to change default login in
/app/data/config/config.jsand 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. -
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.
-
Updated Raneto custom app repo for latest (v5) cloudron base image and latest (v0.17.8) source repo
https://git.cloudron.io/timconsidine/raneto-for-cloudronI know it's not a V1.0 release but not sure it will ever be
But it's still a good little app, highly effective for markdown documentation / knowledgebase.Bug in last post was fixed in 0.17.7.
Will test it out. -
Repackaged as a Community App
Cloudron Versions :
https://communityapps.appx.uk/cloudron-raneto/CloudronVersions.jsonWebsite : https://communityapps.appx.uk
[ @community-apps ]
-
Repackaged as a Community App
Cloudron Versions :
https://communityapps.appx.uk/cloudron-raneto/CloudronVersions.jsonWebsite : https://communityapps.appx.uk
[ @community-apps ]
@timconsidine Well done! Another accolade!
Hello! It looks like you're interested in this conversation, but you don't have an account yet.
Getting fed up of having to scroll through the same posts each visit? When you register for an account, you'll always come back to exactly where you were before, and choose to be notified of new replies (either via email, or push notification). You'll also be able to save bookmarks and upvote posts to show your appreciation to other community members.
With your input, this post could be even better 💗
Register Login