top | item 4895747

Ask HN: Looking for a Static wiki generator

1 points| bobcattr | 13 years ago | reply

I am looking for a simple static wiki (not blog) generator. All I really need is the static generation of markdown files to be presented in a parent child fashion. Does anything like this exist?

The reason being the host system is not powerful enough to run a wiki engine like dokuwiki

11 comments

order
[+] 1331|13 years ago|reply
It seems that the terminology is causing some confusion. The definition of a wiki is "a website which allows its users to add, modify, or delete its content via a web browser" [1], which is pretty much the opposite of "static." I assume that what you want is a static site generator that has organisational features that are common in wiki software...

My favourite wiki software is Gitit [2]. It uses Pandoc [3] to convert from an input format (such as Markdown) to HTML. Perhaps you could write a simple script that iterates through all source files and renders the HTML to a destination directory using Pandoc, creating any subdirectories as required. That minimal solution should be very easy to implement; adding organisational markup within the HTML would require some programming.

[1] http://en.wikipedia.org/wiki/Wiki

[2] http://gitit.net/

[3] http://johnmacfarlane.net/pandoc/

[+] ColinWright|13 years ago|reply
So if it's a wiki, how do you intend to make a change, given that it's static? I'd be interested to see how your solution to that design issue compares with the solution I came up with over a decade ago.
[+] bobcattr|13 years ago|reply
Through the markdown (or whatever else) files on the system via the shell.