Re: [Boost-users] NewBie: help needed generating documentation with quickbook and bjam

Am 06.12.2010 13:13, schrieb Daniel James:

On 6 December 2010 11:28, Wilhelm wrote:

...

Ok, thank you for this advise. I'm now able to generate the documentation.

The next question is how to enable non-US language for all generated sections e.g. "Table of Contents". I tried to set the XSL parameter "lang=de" but that seems to have no effect.

Any hints?

I think you have to set the language in the docbook document itself, adding 'lang=de' to the root element. There's currently no support for the lang attribute in quickbook. If you can wait it's pretty trivial to implement (should just take a day or two, and will be released in a few months).

Well, I'm looking around for efficient documentation tools. And I want to decide that in a few weeks... If you can't, you have to write a boostbook/docbook

document and use 'xi:include' to include the quickbook documentation. I'll write an example for you later if you wish,

that would be very nice and helpfull or you can look at

'doc/src/boost.xml' which uses a lot of quickbook generated documentation.

In boostbook you should currently only use the docbook document types (such as book, chapter etc. not 'boostbook' or 'library') as the 'lang' attribute is lost when converting boostbook document types from to docbook document types. I'll also fix that in the next release.

And finally, you'll need to avoid anything that generates text during the boostbook to docbook conversion. I think that's just the reference documentation features, although there might be other parts. I'm afraid I don't know what's involved with implementing localisation in xsl.

Hope that helps,

Daniel _______________________________________________ Boost-users mailing list Boost-users@lists.boost.org http://lists.boost.org/mailman/listinfo.cgi/boost-users

-- Wilhelm