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)
* 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
