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)
I'm thinking maybe we should focus on HTML, since it appears to be to only truly portable format. CHM is nice to have but, maybe HTML can handle it equally well too? Of course, every application software seems to be shipping the doc in PDF format also. Hmm... which way should I go for? > 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) > * 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 docbook works for TortoiseSVN, it will probably work for TortoiseHg too. I will do some research on docbook > 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/ ------------------------------------------------------------------------- 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
