Hi, Yes Alexander, actually I wrote this by XML and compiled by DocBook tools, SGML here just means Docbook :), LaTeX is really the best for wrtting tecnical docs, but it's also complicated and need much to write.
I'm sorry I just finished part of the configuration guide, there maybe many errors, and I will finish it soon. Thanks. FinalBSD 2009/3/2 Alexander Staubo <[email protected]> > 2009/3/2 FinalBSD <[email protected]>: > > I'm sorry, I feel too hard to read and search about current txt-based > > docs. > > So, I spent some time in writing the SGML format for the docs this > weekend, > > now I can convert it to Single/Split HTML or other supported format > easily, > > I just finished most of the "Configuration Guide". Can you consider > writing > > your > > docs use SGML in the future？ > > While I applaud the initiative to turn the documentation into a markup > language... SGML, really? People still use that? Most technical > documentation these days is either in XML via DocBook, or LaTeX. > > > People can check it here: > > Single HTML: http://www.haproxy.org/download/1.3/doc/configuration.html > > Split HTML : http://www.haproxy.org/download/1.3/doc/chunk/index.html > > I assume you are not quite finished? There are numerous problems with > the conversion, mostly tons of missing markup: > > http://www.grabup.com/uploads/19e6f435881ed9fb00c1e907853195e4.png > http://www.grabup.com/uploads/784c3e97001873c12fe199de2e08676a.png > > Alexander. > >
