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