HACKER Q&A
📣 JonathanBuchh

What’s the best way to publish a wiki to the web?


What’s your favorite way to publish a wiki to the web?

Personally, I’m looking for something that takes a folder of Markdown files with wiki links and generates HTML files. Ideally, I’d like to be able to use my own CSS. I don’t need other features, just something simple. Do you have any suggestions?

  👤 auraham Accepted Answer ✓
Pelican [1] can translate markdown to html. However, I think read the docs [2] and Sphinx [3] are more suitable for a wiki (but it uses RST). Also, you can use themes [3].

[1] https://docs.getpelican.com/en/latest/

[2] https://readthedocs.org/

[3] https://www.sphinx-doc.org/en/master/

👤 martyalain
What do you think of the "lambdaway project": http://lambdaway.free.fr, an attempt to unify writing, styling and scripting under a unique syntax.

It is said that the LISP's father, John McCarthy, lamented the W3C's choice of SGML as the basis for HTML : « An environment where the markup, styling and scripting is all s-expression based would be nice. » The lambdaway project could be an answer, small and simple.

👤 rcarmo
I am using roughly 200 lines of Fennel to do that, and my current website (taoofmac.com) is nothing more than 17+ years of that exact approach, but using Python.

If you’re looking for inspiration, the older source code is up at https://github.com/rcarmo/sushy. The current version is pure Python 3, but I haven’t cleaned it up for public use (and likely never will, since I want to do something simpler now).

👤 mtmail
https://www.mkdocs.org/ plus a theme https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes
👤 Jefro118
Not directly relevant to your use case but I've built something that does what you ask from a Google Drive: https://neat.wiki (might be relevant since Google Drive is so widely used).
👤 kingkongjaffa
https://js.wiki/ Has been enough for us to use across maybe 100 wiki pages regularly updated with ~40 users.