On 11/15/08, Peer Sommerlund <[EMAIL PROTECTED]> wrote: > > > 2008/11/15 TK Soh <[EMAIL PROTECTED]> > > > > On 11/14/08, Peer Sommerlund <[EMAIL PROTECTED]> wrote: > > > > > > > > > > > 2008/11/14 TK Soh <[EMAIL PROTECTED]> > > > > > > > I've spent a little time lately working on a 'book' for TortoiseHg > > > > (not that there's a lot to talk about). One of the main issue is which > > > > is the right tool for this job. FYI, I started the draft work with > > > > M$-Word. Not the best choice obviously. > > > > > > > > Any suggestion on the good (and open source) tools out there I can > > > > use? I see hgbook using Tex, but setting up in Windows seem quite > > > > complicated. And I don't know nothing about Tex too. > > > > > > > > > > > > > Where should this be used? I can think of the following which is all > > > relevant > > > * on the web (HTML) > > > * for context sensitive help (CHM) > > > * as a book (PDF) > > > > > > > > > In my mind this makes translation of the documentation source file very > > > interesting, which is why I would go with something like docbook or > asciidoc > > > > > > The content could come from several sources > > > * hgbook (TeX) > > > * mercurial wiki (moinmoin -> docbook) > > > * mercurial man pages (asciidoc -> docbook) > > > > I am not clear on you mean by "moinmoin -> docbook" and "asciidoc -> > > docbook" above. Are these some sort of conversions? > > Yes. > > > MoinMoin can generate DocBook > > http://moinmoin.wikiwikiweb.de/DocBook > > If selenic.com installed PyXML then it would be easy to extract pages, e.g. > http://www.selenic.com/mercurial/wiki/index.cgi/UnderstandingMercurial?action=format&mimetype=xml/docbook > > > AsciiDoc can generate DocBook > > http://www.methods.co.nz/asciidoc/asciidoc.html#_docbook > > > There are several other conversion tools, for example DocBook -> LaTeX > http://dblatex.sourceforge.net/doc/index.html > > Or for importing into DocBook > http://wiki.docbook.org/topic/ConvertOtherFormatsToDocBook
I googled a bit. It appears that DocBook is more of a file format, and not author-friendly. I am look at asciidoc now. It seem to have most of what I need, based on the what I saw in the examples, and it simple enough for more to port my draft over within a few hours of reading. However, the user guide has much to desire. I can't even find the 'right' way to regenerate the sample html files (specifically book.html) that are shipped with asciidoc from their .txt counterpart. I wonder if anyone has some help they can offer. The book.html sample has most of what I need: - TOC - Doc revisioning - List of figure, table, etc. - Index - automatic numbering on figures and tables. I'd also like to know how to xref to the figure and tables automatically. I learned from the user guide on how to generate the TOC and auto-numbering of chapters using 'asciidoc -a toc -a numbered book.txt', but the output didn't come out to match the sample book.html file. ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ _______________________________________________ Tortoisehg-discuss mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/tortoisehg-discuss
