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).
We use outline (https://github.com/outline/outline) at work and it works pretty well for us. It supports collaborative editing, which was the main reason we went with it.
Personally, I use bookstack (https://github.com/BookStackApp/BookStack) at home. Mostly because I really like the mental model of using Bookshelves, Books, Chapters and Pages to sort my notes in.
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
[1] https://docsify.js.org
[2] https://notes.keithkim.org
We use outline (https://github.com/outline/outline) at work and it works pretty well for us. It supports collaborative editing, which was the main reason we went with it.
Personally, I use bookstack (https://github.com/BookStackApp/BookStack) at home. Mostly because I really like the mental model of using Bookshelves, Books, Chapters and Pages to sort my notes in.
My biggest beef with Outline is that I can initially use Markdown, as soon as it is saved, you cannot see the raw markdown again for editing.