←back to thread

18 points jMyles | 1 comments | | HN request time: 0.435s | source

The two things I wish mediawiki had:

* APIs with deeper functional inroads in multiple languages. There are lots of great tools for writing bots, but if you want to write a parser extension, you're stuck with PHP right? Or has that changed?

* Multiplayer. Edit conflicts can be a real pain and turnoff for beginner users. I wish that simultaneous use felt more like a collaborative social experience and less like a minefield.

...but I do think mediawiki is wonderful, and I'm inclined to use it despite these drawbacks.

1. karmakaze ◴[] No.45070622[source]
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