Re: [Boost-docs] HTML to PDF translations?

Subject: Re: [Boost-docs] HTML to PDF translations?
From: John Maddock (john_at_[hidden])
Date: 2009-02-12 09:50:20

>>> I think we need to make it easier to get the toolchain working (figuring 
>>> out
>>> why it doesn't is the major hassle), and provide a template and testing 
>>> pack
>>> to get new documenters started.
>>
>> Don't forget a WYSIWYG editor:-)

I think a WYSIWYG editor is rather missing the point - DocBook is not based 
around how things *look*, but around how they are *structured*.  It's an 
important conceptual difference IMO.

> I'd be happy with an emacs editing mode.  Getting colorization and other
> dynamic feedback about the status of your markup is extremely valuable,
> even if it isn't strictly WYSIWYG.  For example, when I'm editing
> ReStructuredText in emacs, it still shows me the markup I'm entering,
> but the text responds as I enter it.  Italicized sections italicize,
> headings highlight, etc.  That's enough to make editing a lot faster.

Nod, have you seen 
http://www.boost.org/doc/libs/1_38_0/doc/html/quickbook/editors.html, I 
haven't personally tried any of these, but they look to do most of what you 
want.

Personally I find emacs utterly incomprehensible so I'm not going to offer 
to write you a syntax highlighter, but if any emacs experts would like to 
chip here, I'd be more than happy to assist with the quickbook side of 
things...

John.