I’ve noticed that there are awvully few programming tutorials in my native language (Latvian). And one of the best ones seems to have gone permanently offline recently. As such I’m ever more inclined to start writing my own programming tutorial.
Since I’m no writer and free time is scarce, I thought of making this a wiki-thing. This way other interested enthusiasts (I already know a few) could also join in easily.
The question is – which wiki software out there is best suited for such a task? I’ve a few key features in mind that would be nice to have, I’ll list them here:
- Full Unicode support, since Latvian has some nonstandard characters in it;
- Revision control;
- Access control (with anonymous access supported);
- Code syntax coloring, preferably extensible so that tutorials for different programming languages can be made;
- Automatic TOC generation from all the pages would be nice (but can be done by hand too);
- Support for diagrams and mathematical formulas would be nice (but can also be done with picture uploads);
- The ability to provide a ‘printable’ version for pages would be nice, not to mention a possibility to compile the whole thing in a downloadable e-book.
The server that I have has Linux on it, so preferably no ASP/ASP.NET – but that can be arranged too if really needed.
Added: Well, it seems that there are really just two good candidates – DokuWiki and MediaWiki. Both have the great feature of already having a Latvian localization. I’d go for MediaWiki, as it seems to have at least one major advantage – versioning of attachments. (Plus undoubtedly the best tested wiki system in the world) However I’m afraid if it isn’t a bit too over-feature-ful for such a small project. Any comments on this?
The king kong of wiki software is MediaWiki. It supports all the features you specify, including:
In addition the software is run on Linux across Wikipedia I believe, so it has been fully tested on the Linux platform. It’s not too difficult to install, but perhaps has the risk of having too many features.