3 ms·

Ask HN: 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?

mtmail 5y ago
https://www.mkdocs.org/ https://www.mkdocs.org/ plus a theme https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes
auraham 5y ago
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/ https://docs.getpelican.com/en/latest/ [2] https://readthedocs.org/ https://readthedocs.org/ [3] https://www.sphinx-doc.org/en/master/ https://www.sphinx-doc.org/en/master/
martyalain 5y ago
What do you think of the "lambdaway project": http://lambdaway.free.fr 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 5y ago
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 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).
Jefro118 5y ago
Not directly relevant to your use case but I've built something that does what you ask from a Google Drive: https://neat.wiki https://neat.wiki (might be relevant since Google Drive is so widely used).
kingkongjaffa 5y ago
https://js.wiki/ https://js.wiki/ Has been enough for us to use across maybe 100 wiki pages regularly updated with ~40 users.

mtmail 5y ago

https://www.mkdocs.org/ https://www.mkdocs.org/ plus a theme https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes https://github.com/mkdocs/mkdocs/wiki/MkDocs-Themes

auraham 5y ago

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/ https://docs.getpelican.com/en/latest/ [2] https://readthedocs.org/ https://readthedocs.org/ [3] https://www.sphinx-doc.org/en/master/ https://www.sphinx-doc.org/en/master/

martyalain 5y ago

What do you think of the "lambdaway project": http://lambdaway.free.fr 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 5y ago

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 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).

Jefro118 5y ago

Not directly relevant to your use case but I've built something that does what you ask from a Google Drive: https://neat.wiki https://neat.wiki (might be relevant since Google Drive is so widely used).

kingkongjaffa 5y ago

https://js.wiki/ https://js.wiki/ Has been enough for us to use across maybe 100 wiki pages regularly updated with ~40 users.