hi guys, I basically coded brainless php which works without any database, have search form and does not require any kind sort of setup. Basically its bunch of php files with css and js and what it does, it watching data folder for anything inside. when it see any markdown file named.md it will generate in browser on a fly html version. All seo friendly as well.
Whole ‘‘wiki’’ are coded in bootstrap so its responsive and any device friendly. From point of documentation all it needs it markdown files to be uploaded to /data folder and thats it, no coding no problem. Markdown in wiki support everything except the tables in markdown language eh but sometimes in future I might update it…however html tables (bootsrap) are working just fine. Also it support nested documentation… so if you will have for example:
/data/custom scripts/some.php or some.sh
It will create sort of menu on your left and searching filter is instant via names of the markdown files or folders or words inside of those. There is sort of option to have button on top of the page to view source which will show raw markdown file or any file as text without html in browser.
And in the end… Idea could be awesome… setup git repo where you will keep your all folders with markdown.md files… somewhere locally on your lan or perhaps private github or your own git solution, then setup wiki.sh script (I can help you with this) which will basically push new or any changes to documentation to git repo plus will refresh your data folder (sync with git repo) in one go. This way everything is trackable, safe and also when you need to put documentation into another wiki for example git wiki on github, you can recover all pure text markdown files from data folder or your existing git, or you can just download whole wiki and upload to diferent server, not even need to change single line of code
I think right now all docs are in drupal database… I can translate existing web pages to pure markdown and show you an example if you want, but please only if you would really consider this seriously
I might will need from you some links or just told me what to convert or use in wikis. No access to bd or server need it, all I would use is existing web documentation.
Let me know guys, also sorry for long post eh.
Edit: I’ve done sort of video for irc user Gizmokid2005 as he wanted to see… so I guess I can share… please keep in mind its raw and its just to show you how it would or could possibly looks like… In video there are my personal notes there but idea is same. See it here: https://youtu.be/-DxQuOdCNfo