I'm the project lead of a small Linux distribution and we are writing our user documentation in DocBook (XML). I'd like to host the documentation on a Web server somewhere, so people can refer to the documentation before installation and to troubleshoot on another computer if their system has an issue.
- Open source license.
- Support for multiple versions of our distribution, and multiple books per version (ex: Adélie 1.0: Installation Guide, Admin Guide; Adélie 2.0: Installation Guide, Admin Guide)
- Permanent URLs (/version/bookname/chapter or such "clean" URL would be a bonus).
- Multiple language support.
- Good CSS that supports things like
@media printfor printing and graceful degradation for screen readers.
- Ability to serve PDF or EPUB copies of books for archival / offline reading.
- Server-side "search" feature to search books. For instance,
"install software"could show a result for how to use our package manager.
I'm not even sure if such a system exists, but if it does I cannot find it anywhere. Right now I am manually converting the docs to MediaWiki and serving it off that, but it is not a very nice solution and doesn't support the kind of theme or multilingual support that we want to offer.
The software can run on any open-source OS that supports either x86 or PowerPC, but it'd be nice if we could "self-host" on our own Linux distro. (Obviously we would have to package it.)
Thanks for any suggestions!