4 ms·
I had wanted to use Gitbook for blog/wiki[0] but then discovered that it's not opensource anymore. After not finding anything for a long while finally found som
by karmakaze 1y ago
I had wanted to use Gitbook for blog/wiki[0] but then discovered that it's not opensource anymore. After not finding anything for a long while finally found something close that will work for me: Docsify[1].
Docsify is git-backed but not a static site generator. Instead it reads the markdown as-is and renders to HTML/DOM (don't know the details) in the browser. I had 2 problems with it, first the sidebar wasn't convenient to edit/update, which I handled by creating a tags: `name` `name` annotation convention. The second was it didn't work for private github repos, which was solved by using Cloudflare Pages to auto-publish changes from git. Effectively now it has a 'build' step like a static-site-generator but it's only to write _sidebar.md from the tagged *.md files.
You can see the start of my personal wiki/notes[2] which includes some info about Docsify and Cloudflare Pages & Access (transparently login-protect http paths). Note the 'Edit' buttons (which open Github in edit mode) won't work (as you don't have access to private repo).
[0] https://blog.keithkim.org https://blog.keithkim.org
[1] https://docsify.js.org https://docsify.js.org
[2] https://notes.keithkim.org https://notes.keithkim.org