hgbook on bitbucket

Gabor Grothendieck ggrothendieck at gmail.com
Thu Feb 12 16:26:48 CST 2009


On Thu, Feb 12, 2009 at 5:10 PM, Christian Ebert <blacktrash at gmx.net> wrote:
> * Matt Mackall on Thursday, February 12, 2009 at 15:49:09 -0600
>> On Thu, 2009-02-12 at 19:49 +0100, Peer Sommerlund wrote:
>>> 2009/2/12 Arne Babenhauserheide <arne_bab at web.de>
>>>        [cut]
>>>
>>>        So I'd say, please stop talking about "HTML or PDF" and start
>>>        talking about
>>>        "What's the best way to create HTML _and_ PDF?"
>>>
>>>
>>>        The ideas we already have is
>>>
>>>        * LaTeX
>
> There's also plasTeX (written in pyton) for html conversion, but
> ...
>
>>>        * Docbook
>>>        * reStructuredText
>>>
>>> How about asciidoc? It is already used for man pages.
>>
>> And I'm not particularly happy with it. There are annoying corner-cases
>> that are hard to work around.
>>
>> I also don't think it (or reST) is up to the demands of making a
>> well-typeset book with lots of pretty pictures and diagrams of the kind
>> a major publisher would put in bookstores. And that's what we're aiming
>> for, folks.
>
> I don't see a really well typeset book and html coming from the
> same source. The media differ too much. Almost like making a
> movie from a book. The logical structure, and logical markup
> approach may be similar, but all conversions I've seen so far are
> a compromise and smell of it.
>
> That being said, it's Bryan's book, it's phantastic, and it's his
> decision how to screw it up ;-)

Perhaps its not so important to have the best typeset book and
html but rather just to have something that is good enough but
is easily maintainable.

docbook would presumably be the most powerful in terms of
transformations by style sheets but there is some question
about the level of effort.

txt2tags is a simple markup language that has back ends
for the following. Its written in python which would be consistent
with hg.

# HTML
# XHTML
# SGML
# LaTeX
# Lout
# Man page
# Wikipedia / MediaWiki
# Google Code Wiki
# DokuWiki
# MoinMoin
# MagicPoint
# PageMaker
# Plain text


More information about the Mercurial mailing list