Forum OpenACS Q&A: Best markup language? DocBook, Scribe, Wiki, HTML, LaTex, or etc.
As far as markup languages that can emit multiple output formats (HTML, PDF, man pages, etc.) go, has anyone used Scribe? It sounds very powerful.
Also, how do all these Wiki syntaxes compare to simply using straight good-old HTML? Or LaTeX, for that matter? In other words, what is the win with using one of the various specialized (but rather ad-hoc?) Wiki syntaxes?
- Download the documentation source code
- Use a decent editor for docbook (I used emacs) to edit the documentation. Make sure you keep up the markup
- Generate the HTML out of it
- CVS commit both files to the repository
- Make sure you are on the correct branch. Commit again
- Write an email to Joel to update the documentation on openacs.org
- Realize Joel is busy, login to openacs.org and do the update yourself (This steps used to work for OCT members, now this is restricted to even less people).
- Login to openacs.org/wiki/documentation
- Edit the documentation
- Reflect in glory about your excellent work