[quickbook] issues writing the documentation for has_operator_xxx

I am trying to write the documentation of the operator traits using quickbook. You can have a look at it here: http://www.boostpro.com/vault/index.php?action=downloadfile&filename=type_traits.tar.bz2&directory=Extension& untar and open type_traits/libs/type_traits/doc/html/boost_typetraits/category/value_traits/operators.html I have encountered some issues: * syntax highlighting is not working (c++ code is not in color, just in courrier font) * tables have no lines around cells, header has no special formatting as in the documentation of quickbook * table columns are two large because they adjust to their content. I would like to have some new lines inside some cells (in particular header cells) but the only way I found was to have a new paragraph which creates huge vertical space between lines. In fact, the best would be to set the column width but I did not find how to do that. * I was not able to put macros in table captions. * `code` is not recognized in table caption Maybe somebody could help me, Apart from that, quickbook is easy to use and the documentation is easy to follow. Regards, Frédéric

On 2/18/2011 8:18 AM, Frédéric Bron wrote:
I am trying to write the documentation of the operator traits using quickbook.
You can have a look at it here: http://www.boostpro.com/vault/index.php?action=downloadfile&filename=type_traits.tar.bz2&directory=Extension& untar and open type_traits/libs/type_traits/doc/html/boost_typetraits/category/value_traits/operators.html
I have encountered some issues:
[...] Check if you have the correct CSS installed. Regards, -- Joel de Guzman http://www.boostpro.com http://boost-spirit.com

On 2/18/2011 8:30 AM, Frédéric Bron wrote:
Check if you have the correct CSS installed.
Could you tell me where I can find the correct CSS and where it should be installed?
Boost-Root/doc/src/boostbook.css. Regards, -- Joel de Guzman http://www.boostpro.com http://boost-spirit.com

On 2/17/2011 7:30 PM, Frédéric Bron wrote:
Check if you have the correct CSS installed.
Could you tell me where I can find the correct CSS and where it should be installed?
Add to your jamfile for building the docs at the very end: install css : [ glob $(BOOST_ROOT)/doc/src/*.css ] : <location>html ; install images : [ glob $(BOOST_ROOT)/doc/src/images/*.png ] : <location>html/images ; explicit css ; explicit images ; At the end of your "boostbook standalone" rule add: <dependency>css <dependency>images Take a look at my jamfile for the variadic_macro_data library or the tti library, both in the sandbox, for how to set it up if the above instructions are confusing.

Check if you have the correct CSS installed.
Could you tell me where I can find the correct CSS and where it should be installed?
OK, thank you, both of you. I copied boostbook.css in sandbox/type_traits/doc/html and this works now. In fact, the doc in the sandbox should just work when installed in a normal boost distribution. So I just needed that file. I prefer not to change the Jamfile.v2 because I am not very familiar with it... Frédéric
participants (3)
-
Edward Diener
-
Frédéric Bron
-
Joel de Guzman