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? > * write-yourself (?) > > Note that some of the basic concepts of Mercurial have excellent > descriptions on the wiki, e.g. > http://www.selenic.com/mercurial/wiki/index.cgi/UnderstandingMercurial > > > Subversion and TortoiseSvn use docbook - so a lot of help on tools ought to > be available from that front. > > If I should start on this project now I would probably first examine how > TortoiseSvn works with docbook, then examine how easy it is to get asciidoc > to do the stuff I wanted. > > > > Tools > > > AsciiDoc (wiki -> docbook) > http://www.methods.co.nz/asciidoc/ > > > LyX (TeX with wysiwyg editor) > http://www.lyx.org/ > > > Open Office Writer > http://www.openoffice.org/ > > > > > Regards, > Peer ------------------------------------------------------------------------- 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
