How to center an element in Boost QuickBook?

newer
Weird Boost 1.55 beta failure on...

Niall Douglas

31 Jul 2013 31 Jul '13

3:35 p.m.

As the documentation for proposed Boost.AFIO comes together for this week's GSoC Milestone 1 (feel free to check it out at https://ci.nedprod.com/job/Boost.AFIO%20Build%20Documentation/Boost.AFIO_Doc umentation/?), a problem has emerged. We'd like a matrix table containing ticks and crosses, and building such a thing in QuickBook is easy. However, we'd also like to center the ticks and crosses in each table cell, otherwise it looks poor. Is there some way I haven't realized of aligning content in Boost QuickBook, or even BoostBook itself? The DocBook documentation suggests one can do a '''<entry align="center">'''__tick__'''</entry>''' (the triple single ticks escape from QuickBook into BoostBook). However unfortunately BoostBook defines CSS which overrides the per-cell alignment :( Thanks in advance for the help. Niall --- Opinions expressed here are my own and do not necessarily represent those of BlackBerry Inc.

Attachments:

smime.p7s (application/pkcs7-signature — 6.0 KB)

Show replies by date

Mathias Gaunard

31 Jul 31 Jul

5:14 p.m.

On 31/07/13 17:35, Niall Douglas wrote:

...

As the documentation for proposed Boost.AFIO comes together for this week's GSoC Milestone 1 (feel free to check it out at https://ci.nedprod.com/job/Boost.AFIO%20Build%20Documentation/Boost.AFIO_Doc umentation/?), a problem has emerged. We'd like a matrix table containing ticks and crosses, and building such a thing in QuickBook is easy.

However, we'd also like to center the ticks and crosses in each table cell, otherwise it looks poor. Is there some way I haven't realized of aligning content in Boost QuickBook, or even BoostBook itself?

The DocBook documentation suggests one can do a '''<entry align="center">'''__tick__'''</entry>''' (the triple single ticks escape from QuickBook into BoostBook). However unfortunately BoostBook defines CSS which overrides the per-cell alignment :(

How about trying <colspec align="center"> instead? If I understand the documentation right, you should put that in the table heading.

Niall Douglas

7 Aug 7 Aug

3:26 p.m.

...

...
The DocBook documentation suggests one can do a '''<entry align="center">'''__tick__'''</entry>''' (the triple single ticks escape from QuickBook into BoostBook). However unfortunately BoostBook defines CSS which overrides the per-cell alignment :(

How about trying <colspec align="center"> instead? If I understand the documentation right, you should put that in the table heading.

I actually stumbled across an answer to this quite by accident, and at the same time I solved how to do coloured text in Boost Quickbook. Witness the beauty of coloured and centered Quickbook text in the table at https://ci.nedprod.com/view/All/job/Boost.AFIO%20Build%20Documentation/Boost .AFIO_Documentation/doc/html/afio/design/acid_write_ordering/write_ordering_ data.html. Here's how I did it in Quickbook: [table:power_loss_safety Power loss safety matrix: What can you lose if power is suddenly lost? [[][[role aligncenter Metadata no longer matches data[footnote This doesn't mean that metadata is corrupted, this means for example that a file is said to have 100Kb but is in fact partially garbage because metadata was updated before data was fully changed on storage.]]][[role aligncenter Newly created file content corrupted]][[role aligncenter File data content rewrite corrupted]][[role aligncenter Max seconds of writes reordered without using `fsync()`]][[role aligncenter Max seconds of writes lost]]] [[[role alignright FAT32]][__tick__][__tick__][__tick__][][]] [[[role alignright ext2]][__tick__][__tick__][__tick__][[role aligncenter 5]][[role aligncenter 5]]] [[[role alignright ext3/4 `data=writeback`]][__tick__][__tick__][__tick__][[role aligncenter 5/60]][[role aligncenter 60]]] [[[role alignright ext3/4 `data=ordered` (default)]][__cross__][__cross__][__tick__][[role aligncenter 5/60]][[role aligncenter 60]]] [[[role alignright UFS + soft updates]][__cross__][__cross__][__tick__][][]] [[[role alignright HFS+]][__cross__][__cross__][__tick__][][]] [[[role alignright NTFS]][__cross__][__cross__][__tick__][][]] [[[role alignright ext3/4 `data=journal`]][__cross__][__cross__][__cross__][[role aligncenter 60]][[role aligncenter 60]]] [[[role alignright BTRFS]][__cross__][__cross__][__cross__][][]] [[[role alignright ZFS]][__cross__][__cross__][__cross__][[role aligncenter 5]][[role aligncenter 30]]] ] The key here is the [role styleclass text] modifier: this just happens to spit out text. By adding suitable extra CSS to the main CSS file, one can make coloured text, or in my case, turn a span into a display:inline-block; and therefore can do text-align:center. I hope this is useful to someone someday. If [role] will continue to always do this, and it's not just by accident, it might be worth adding to the Quickbook FAQ. That said, a proper formally specified typesetting mechanism would be a lot better again. Niall --- Opinions expressed here are my own and do not necessarily represent those of BlackBerry Inc.

Paul A. Bristow

8 Aug 8 Aug

8:56 a.m.

...

-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Niall Douglas Sent: Wednesday, August 07, 2013 4:26 PM To: boost@lists.boost.org Subject: Re: [boost] How to center an element in Boost QuickBook?

...
...
The DocBook documentation suggests one can do a '''<entry align="center">'''__tick__'''</entry>''' (the triple single ticks escape from QuickBook into BoostBook). However unfortunately BoostBook defines CSS which overrides the per-cell alignment :(

How about trying <colspec align="center"> instead? If I understand the documentation right, you should put that in the table heading.

I actually stumbled across an answer to this quite by accident, and at the same time I solved how to do coloured text in Boost Quickbook.

<snip>

...

The key here is the [role styleclass text] modifier: this just happens to spit out text. By adding suitable extra CSS to the main CSS file, one can make

coloured > text, or in my case, turn a span into a display:inline-block; and therefore can do text-align:center. > > I hope this is useful to someone someday. If [role] will continue to always do this, and it's not just by > accident, it might be worth adding to the Quickbook FAQ. That said, a proper formally specified > typesetting mechanism would be a lot better again.

Whoops of delight! Please can we have this in Quickbook asap. Please can you provide the extra CSS and the cross and tick templates - commonly useful to go in the Quickbook toolkit. Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com

Niall Douglas

2:55 p.m.

...

...
The key here is the [role styleclass text] modifier: this just happens to spit out text. By adding suitable extra CSS to the main CSS file, one can make

coloured > text, or in my case, turn a span into a display:inline-block; and > therefore can do text-align:center. > > I hope this is useful to someone someday. If [role] will continue to > always do this, and it's not just by > accident, it might be worth adding to the Quickbook FAQ. That said, a > proper formally specified typesetting mechanism would be a lot better again.

Whoops of delight!

Please can we have this in Quickbook asap.

Please can you provide the extra CSS and the cross and tick templates - commonly useful to go in the Quickbook toolkit.

Sure. Proposed Boost.AFIO is technically fully ported to Boost now, so you'll find its QuickBook sources at: https://github.com/BoostGSoC/boost.afio/tree/master/libs/afio/doc For coloured ticks and crosses: https://github.com/BoostGSoC/boost.afio/blob/master/libs/afio/doc/afio.qbk contains the Quickbook macros: [def __tick__ [role aligncenter [role green \u2714]]] [def __cross__ [role aligncenter [role red \u2718]]] The requisite CSS can be found appended to the bottom of this boostbook.css at https://github.com/BoostGSoC/boost.afio/blob/master/libs/afio/doc/html/myboo stbook.css#L660. You'll note I did some funky CSS things with getting the BoostBook TOC to go multi-column which has generated (what I consider to be) a most pleasing compact TOC layout which can be seen at https://ci.nedprod.com/job/Boost.AFIO%20Build%20Documentation/Boost.AFIO_Doc umentation/doc/html/index.html. Niall --- Opinions expressed here are my own and do not necessarily represent those of BlackBerry Inc.

Joel de Guzman

9 Aug 9 Aug

1:43 a.m.

On 8/8/13 10:55 PM, Niall Douglas wrote:

...

Sure. Proposed Boost.AFIO is technically fully ported to Boost now, so you'll find its QuickBook sources at:

https://github.com/BoostGSoC/boost.afio/tree/master/libs/afio/doc

For coloured ticks and crosses:

https://github.com/BoostGSoC/boost.afio/blob/master/libs/afio/doc/afio.qbk contains the Quickbook macros:

[def __tick__ [role aligncenter [role green \u2714]]] [def __cross__ [role aligncenter [role red \u2718]]]

The requisite CSS can be found appended to the bottom of this boostbook.css at https://github.com/BoostGSoC/boost.afio/blob/master/libs/afio/doc/html/myboo stbook.css#L660.

You'll note I did some funky CSS things with getting the BoostBook TOC to go multi-column which has generated (what I consider to be) a most pleasing compact TOC layout which can be seen at https://ci.nedprod.com/job/Boost.AFIO%20Build%20Documentation/Boost.AFIO_Doc umentation/doc/html/index.html.

That *IS* wonderful! Regards, -- Joel de Guzman http://www.ciere.com http://boost-spirit.com http://www.cycfi.com/

Rene Rivera

3:33 a.m.

On Thu, Aug 8, 2013 at 8:43 PM, Joel de Guzman wrote:

...

On 8/8/13 10:55 PM, Niall Douglas wrote:

...
[def __tick__ [role aligncenter [role green \u2714]]] [def __cross__ [role aligncenter [role red \u2718]]]

The requisite CSS can be found appended to the bottom of this boostbook.css

That *IS* wonderful!

ANother example of what can be done with quickbook+css manipulation with that role (and a bunch of other class and id attributes I added to the boostbook XSLT) take a look at N3700 < http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2013/n3700.html>. It includes things like: * Mixed styles per sections. * Mixed/explicit numbering of sections. * Embedded CSS * Repositioned doc info header * Automatic numbered paragraphs Quickbook source code is at < https://github.com/grafikrobot/boost-tree/tree/master/proposal>. After the September meeting I'm hoping to clean up the CSS and template to make it reusable as a way to quickly write standards documents. -- -- -- Grafik - Don't Assume Anything -- Redshift Software, Inc. - http://redshift-software.com -- rrivera/acm.org - grafik/redshift-software.com -- 102708583/icq - grafikrobot/aim - grafikrobot/yahoo

Paul A. Bristow

9:14 a.m.

...

-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Rene Rivera Sent: Friday, August 09, 2013 4:33 AM To: boost@lists.boost.org Subject: Re: [boost] How to center an element in Boost QuickBook?

On Thu, Aug 8, 2013 at 8:43 PM, Joel de Guzman wrote:

...
On 8/8/13 10:55 PM, Niall Douglas wrote:

...
[def __tick__ [role aligncenter [role green \u2714]]] [def __cross__ [role aligncenter [role red \u2718]]]

The requisite CSS can be found appended to the bottom of this boostbook.css

That *IS* wonderful!

ANother example of what can be done with quickbook+css manipulation with that role (and a bunch of other class and id attributes I added to the boostbook XSLT) take a look at N3700 < http://www.open- std.org/jtc1/sc22/wg21/docs/papers/2013/n3700.html>. It includes things like:

* Mixed styles per sections. * Mixed/explicit numbering of sections. * Embedded CSS * Repositioned doc info header * Automatic numbered paragraphs

Quickbook source code is at < https://github.com/grafikrobot/boost-tree/tree/master/proposal>. After the September meeting I'm hoping to clean up the CSS and template to make it reusable as a way to quickly write standards documents.

Truly Cool! (Although the font size of code is a bit small compared to the text - and I am violently allergic to red for comments - red is for warnings!) This should be *really useful* for those tackling the ugly task of preparing Standard documents. Automatic numbered paragraphs looks very useful (if you want numbered paragraphs ;-) Will this also produce a pdf version as with other Quickbook docs? Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com

Paul A. Bristow

8 Oct 8 Oct

8 a.m.

...

-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Paul A. Bristow Sent: Friday, August 09, 2013 10:14 AM To: boost@lists.boost.org Subject: Re: [boost] How to center an element in Boost QuickBook?

...
-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Rene Rivera Sent: Friday, August 09, 2013 4:33 AM To: boost@lists.boost.org Subject: Re: [boost] How to center an element in Boost QuickBook?

On Thu, Aug 8, 2013 at 8:43 PM, Joel de Guzman wrote:

...
On 8/8/13 10:55 PM, Niall Douglas wrote:

...
[def __tick__ [role aligncenter [role green \u2714]]] [def __cross__ [role aligncenter [role red \u2718]]]

The requisite CSS can be found appended to the bottom of this boostbook.css

I've finally got round to trying this with Quickbook 1.7 and I find it very neat to be able to control the alignment, both in text, and most usefully, in tables, so that the heading and/or body text can be centered or even right aligned. (justify seems less useful). /* alignment and coloring use role feature, available from Quickbook 1.7 up. */ /* Add text alignment (see http://www.w3schools.com/cssref/pr_text_text-align.asp) */ span.aligncenter { display: inline-block; width: 100%; text-align: center; } span.alignright { display: inline-block; width: 100%; text-align: right; } span.alignjustify { display: inline-block; width: 15%; text-align: justify; } /* align justify stretches the lines so that each line has equal width within a chosen fraction of page width (here 15%). *Not* useful inside table items as the column width is the full string width. Nor very useful, except to restrict the width. */ Colors are nice too - [role red Some red text] [role blue Some blue text] ... I'd like to add a few to the boostbook.css /* Text colors (names at http://www.w3schools.com/cssref/css_colornames.asp) */ span.red { color: red; } span.green { color: green; } span.lime { color: #00FF00; } span.blue { color: blue; } span.navy { color: navy; } span.yellow { color: yellow; } span.magenta { color: magenta; } span.indigo { color: #4B0082; } span.cyan { color: cyan; } span.purple { color: purple; } span.gold { color: gold; } span.silver { color: silver; } span.grey { color: grey; } It will also be useful to have a few defs in your Quickbook file. [/ ticks and crosses from dingbats http://www.unicodemap.org/range/56/Dingbats/ eg http://www.unicodemap.org/details/0x2714/] [def __tick [role aligncenter [role green \u2714]]] [/ u2714 is a HEAVY CHECK MARK tick (2713 check mark)] [def __cross [role aligncenter [role red \u2718]]] [/ u2718 is a heavy cross] [def __star [role aligncenter [role red \u2736]]] [/ 6-point star]

...

Will this also produce a pdf version as with other Quickbook docs?

So far, the answer to my other question is not yet. My jamfile contains this pointer to my special css with the above added items (and works for html) xsl:paramhtml.stylesheet=myboostbook.css and I presume this applies to for both html and pdf ? Sadly neither color nor alignment seem to work with generating pdf :-( Is there something that I need to add to <format>pdf:xsl:param specifically for the pdf version? Thanks for any suggestions. Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com

Daniel James

10:21 a.m.

On 8 October 2013 09:00, Paul A. Bristow wrote:

...

I've finally got round to trying this with Quickbook 1.7 and I find it very neat to be able to control the alignment, both in text, and most usefully, in tables, so that the heading and/or body text can be centered or even right aligned. (justify seems less useful).

/* alignment and coloring use role feature, available from Quickbook 1.7 up. */

It's a 1.6 feature. There are still changes to be made in 1.7, so it's best to stick with 1.6 for now. I've got a lot of changes that haven't been made to trunk yet.

...

I'd like to add a few to the boostbook.css

/* Text colors (names at http://www.w3schools.com/cssref/css_colornames.asp) */ span.red { color: red; } span.green { color: green; } span.lime { color: #00FF00; } span.blue { color: blue; } span.navy { color: navy; } span.yellow { color: yellow; } span.magenta { color: magenta; } span.indigo { color: #4B0082; } span.cyan { color: cyan; } span.purple { color: purple; } span.gold { color: gold; } span.silver { color: silver; } span.grey { color: grey; }

Go for it.

...

It will also be useful to have a few defs in your Quickbook file.

[/ ticks and crosses from dingbats http://www.unicodemap.org/range/56/Dingbats/ eg http://www.unicodemap.org/details/0x2714/]

[def __tick [role aligncenter [role green \u2714]]] [/ u2714 is a HEAVY CHECK MARK tick (2713 check mark)] [def __cross [role aligncenter [role red \u2718]]] [/ u2718 is a heavy cross] [def __star [role aligncenter [role red \u2736]]] [/ 6-point star]

Personally, I'd use templates, but it's your choice.

...

...
Will this also produce a pdf version as with other Quickbook docs?

So far, the answer to my other question is not yet.

My jamfile contains this pointer to my special css with the above added items (and works for html)

xsl:paramhtml.stylesheet=myboostbook.css

and I presume this applies to for both html and pdf ?

No, css is only for html. I'm sure it's possible to do at least coloured text in pdfs, a quick search suggests: https://lists.oasis-open.org/archives/docbook-apps/201202/msg00106.html I guess we need to add something similar to the boostbook xsl.

Daniel James

10:32 a.m.

On 8 October 2013 11:21, Daniel James wrote:

...

It's a 1.6 feature. There are still changes to be made in 1.7, so it's best to stick with 1.6 for now. I've got a lot of changes that haven't been made to trunk yet.

Btw. I forgot to remove the 1.6 warning message from the beta release, you can safely ignore it. Sorry about that, it will be removed in the final release.

Paul A. Bristow

2:54 p.m.

...

-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Daniel James Sent: Tuesday, October 08, 2013 11:21 AM To: boost@lists.boost.org Subject: Re: [boost] How to center an element in Boost QuickBook?

On 8 October 2013 09:00, Paul A. Bristow wrote:

...
I've finally got round to trying this with Quickbook 1.7 and I find it very neat to be able to control the alignment, both in text, and most usefully, in tables, so that the heading and/or body text can be centered or even right aligned.

(justify seems less useful).

...
/* alignment and coloring use role feature, available from Quickbook 1.7 up. */

It's a 1.6 feature. There are still changes to be made in 1.7, so it's best to stick with 1.6 for now. I've got a lot of changes that haven't been made to trunk yet.

...
I'd like to add a few to the boostbook.css

/* Text colors (names at http://www.w3schools.com/cssref/css_colornames.asp) */ span.red { color: red; } span.green { color: green; } span.lime { color: #00FF00; } span.blue { color: blue; } span.navy { color: navy; } span.yellow { color: yellow; } span.magenta { color: magenta; } span.indigo { color: #4B0082; } span.cyan { color: cyan; } span.purple { color: purple; } span.gold { color: gold; } span.silver { color: silver; } span.grey { color: grey; }

Go for it.

...
It will also be useful to have a few defs in your Quickbook file.

[/ ticks and crosses from dingbats http://www.unicodemap.org/range/56/Dingbats/ eg http://www.unicodemap.org/details/0x2714/]

[def __tick [role aligncenter [role green \u2714]]] [/ u2714 is a HEAVY CHECK MARK tick (2713 check mark)] [def __cross [role aligncenter [role red \u2718]]] [/ u2718 is a heavy cross] [def __star [role aligncenter [role red \u2736]]] [/ 6-point star]

Personally, I'd use templates, but it's your choice.

OK, I'll try that instead. I'll put them in the html_symbols.qbk file, hoping they won't clash with users other symbols (if they use that file - uncommon).

...

...
...
Will this also produce a pdf version as with other Quickbook docs?

So far, the answer to my other question is not yet.

...

I'm sure it's possible to do at least coloured text in pdfs, a quick search suggests:

https://lists.oasis-open.org/archives/docbook-apps/201202/msg00106.html

I guess we need to add something similar to the boostbook xsl.

I'll fumble with that locally and report if I get it to work. Thanks Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com

Paul A. Bristow

9 Oct 9 Oct

9:20 a.m.

...

-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Paul A. Bristow Sent: Tuesday, October 08, 2013 3:55 PM To: boost@lists.boost.org Subject: Re: [boost] How to center an element in Boost QuickBook?

...
...
...
Will this also produce a pdf version as with other Quickbook docs?

So far, the answer to my other question is not yet.

...
I'm sure it's possible to do at least coloured text in pdfs, a quick search suggests:

https://lists.oasis-open.org/archives/docbook-apps/201202/msg00106.htm l

I guess we need to add something similar to the boostbook xsl.

I'll fumble with that locally and report if I get it to work.

No - I've concluded that it is treading where angels fear again. I started to copy the 'bold' emphasis in Docbook.xsl <emphasis role="bold"> </emphasis> using the many xsl examples from googling, with xsl:apply-templates/ but fo: isn't defined, and anyway this will require fixing on a group of colors and adding a block like this for each color, instead of passing the specified color. So I think I should leave it to an expert :-( Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com

Daniel James

10:34 a.m.

On 9 October 2013 10:20, Paul A. Bristow wrote:

...

xsl:apply-templates/

but fo: isn't defined, and anyway this will require fixing on a group of colors and adding a block like this for each color, instead of passing the specified color.

It needs to be in 'fo.xsl'. The colouring for syntax highlighting is done in a similar manner in that file, so I think it should work.

Paul A. Bristow

4:30 p.m.

...

-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Daniel James Sent: Wednesday, October 09, 2013 11:35 AM To: boost@lists.boost.org Subject: Re: [boost] How to center an element in Boost QuickBook?

On 9 October 2013 10:20, Paul A. Bristow wrote:

...
xsl:apply-templates/

but fo: isn't defined, and anyway this will require fixing on a group of colors and adding a block like this for each color, instead of passing the specified color.

It needs to be in 'fo.xsl'. The colouring for syntax highlighting is done in a similar manner in that file, so I think it should work.

As usual, you are correct. (Though I'm sure my multiple pasting is pretty brainless :-( ) I've now got glorious cool colors on both the pdf and html :-) Samples attached. How to get Niall's alignment in tables to work in pdf will need some more expert input. (OK for html). boostbook.css entry is: span.aligncenter { display: inline-block; width: 100%; text-align: center; } span.alignright { display: inline-block; width: 100%; text-align: right; } Hints? What other testing should I do? When is a convenient time to commit doc/src/boostbook.css? Paul

Niall Douglas

7:58 p.m.

On 9 Oct 2013 at 17:30, Paul A. Bristow wrote:

...

How to get Niall's alignment in tables to work in pdf will need some more expert input. (OK for html). [snip] When is a convenient time to commit doc/src/boostbook.css?

I would class my table alignment and colour solution as a temporary workaround which just happens to work by chance on HTML output. Really QuickBook needs more formal explicit support for both colouring and alignment. The syntax for that I am unsure of, but it really must not be lots of nested []'s. It's already bad enough with my temporary workaround when I accidentally mismatch those and spend too long hand groking them for the mistake :( Niall -- Currently unemployed and looking for work. Work Portfolio: http://careers.stackoverflow.com/nialldouglas/

Paul A. Bristow

10 Oct 10 Oct

9:42 a.m.

...

-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Niall Douglas Sent: Wednesday, October 09, 2013 8:58 PM To: boost@lists.boost.org Subject: Re: [boost] How to center an element in Boost QuickBook?

On 9 Oct 2013 at 17:30, Paul A. Bristow wrote:

...
How to get Niall's alignment in tables to work in pdf will need some more expert input. (OK for html). [snip] When is a convenient time to commit doc/src/boostbook.css?

I would class my table alignment and colour solution as a temporary workaround which just happens to work by chance on HTML output.

Really QuickBook needs more formal explicit support for both colouring and alignment. The syntax for that I am unsure of, but it really must not be lots of nested []'s. It's already bad enough with my temporary workaround when I accidentally mismatch those and spend too long hand groking them for

the mistake :( Been there - done that - really, really tiresome! But considering the amount of use people will make of color within text (and alignment), I think it is good enough for now. Thanks for your very useful input on this. Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com

Daniel James

9 Oct 9 Oct

11:20 p.m.

On 9 October 2013 17:30, Paul A. Bristow wrote:

...

How to get Niall's alignment in tables to work in pdf will need some more expert input.

I'm not an expert here. I usually just search for the answers to docbook questions. Although the other day, the answer was in a mail I wrote in 2009.

...

What other testing should I do?

Just check that it looks okay really. Try building some other libraries' documentation. Unfortunately we don't have any means of testing this.

...

When is a convenient time to commit doc/src/boostbook.css?

Now is fine.

Paul A. Bristow

10 Oct 10 Oct

4:06 p.m.

...

-----Original Message----- From: Boost [mailto:boost-bounces@lists.boost.org] On Behalf Of Daniel James Sent: Thursday, October 10, 2013 12:20 AM To: boost@lists.boost.org Subject: Re: [boost] How to center an element in Boost QuickBook?

On 9 October 2013 17:30, Paul A. Bristow wrote:

...
How to get Niall's alignment in tables to work in pdf will need some more expert input.

I'm not an expert here. I usually just search for the answers to docbook questions. Although the other day, the answer was in a mail I wrote in 2009.

...
What other testing should I do?

Just check that it looks okay really. Try building some other libraries' documentation. Unfortunately we don't have any means of testing this.

...
When is a convenient time to commit doc/src/boostbook.css?

Now is fine.

I:\boost-trunk\doc\src\boostbook.css At revision: 86228 and also Revision: 86229 Author: pbristow Date: 10 October 2013 16:40:07 Message: Additions to implement colors from Quickbook 1.6. But align feature (done in boostbook.css for html) is still not implemented. ---- Modified : /trunk/tools/boostbook/xsl/fo.xsl Am hoping to pick John's much larger brain for hints on the align fo.xsl changes needed for align feature. Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com

Niall Douglas

9 Aug 9 Aug

2:40 p.m.

...

ANother example of what can be done with quickbook+css manipulation with that role (and a bunch of other class and id attributes I added to the boostbook XSLT) take a look at N3700 < http://www.open- std.org/jtc1/sc22/wg21/docs/papers/2013/n3700.html>. It includes things like:

I genuinely think that the prettiest N paper I've ever seen yet on ISO. Well done on that. Niall --- Opinions expressed here are my own and do not necessarily represent those of BlackBerry Inc.

Dave Abrahams

4:39 a.m.

on Thu Aug 08 2013, Niall Douglas wrote:

...

You'll note I did some funky CSS things with getting the BoostBook TOC to go multi-column which has generated (what I consider to be) a most pleasing compact TOC layout which can be seen at https://ci.nedprod.com/job/Boost.AFIO%20Build%20Documentation/Boost.AFIO_Doc umentation/doc/html/index.html.

Hmm... Status Code: 404 Exception: Stacktrace: (none) Generated by Winstone Servlet Engine v0.9.10 at Fri Aug 09 05:38:52 BST 2013 -- Dave Abrahams

Mateusz Loskot

8:32 a.m.

On 9 August 2013 05:39, Dave Abrahams wrote:

...

on Thu Aug 08 2013, Niall Douglas wrote:

...
You'll note I did some funky CSS things with getting the BoostBook TOC to go multi-column which has generated (what I consider to be) a most pleasing compact TOC layout which can be seen at https://ci.nedprod.com/job/Boost.AFIO%20Build%20Documentation/Boost.AFIO_Doc umentation/doc/html/index.html.

Hmm...

Status Code: 404

Exception: Stacktrace: (none)

Generated by Winstone Servlet Engine v0.9.10 at Fri Aug 09 05:38:52 BST 2013

Dave, You probably used the link broken across two lines. The link is long: https://ci.nedprod.com/job/Boost.AFIO%20Build%20Documentation/Boost.AFIO_Doc... Best regards, -- Mateusz Loskot, http://mateusz.loskot.net "Participation in this whole process is a form of torture" ~~ Szalony, wspinanie.pl

Niall Douglas

2:44 p.m.

...

on Thu Aug 08 2013, Niall Douglas wrote:

...
You'll note I did some funky CSS things with getting the BoostBook TOC to go multi-column which has generated (what I consider to be) a most pleasing compact TOC layout which can be seen at

https://ci.nedprod.com/job/Boost.AFIO%20Build%20Documentation/Boost.AF

...
IO_Doc umentation/doc/html/index.html.

Hmm...

Status Code: 404

Exception: Stacktrace: (none)

Generated by Winstone Servlet Engine v0.9.10 at Fri Aug 09 05:38:52 BST 2013

Apologies for that. Yesterday I realized that the CI wasn't generating HTML from my quickbook changes, so after work I was trying to figure out why. Part of that involved wiping the HTML, so on and off last night you would have seen 404s. I finally nailed the problem at 1am last night. It works correctly now. GSoC is a lot of work :( Niall --- Opinions expressed here are my own and do not necessarily represent those of BlackBerry Inc.

4065

Age (days ago)

4136

Last active (days ago)

List overview

Download

22 comments

9 participants

participants (9)

Daniel James
Dave Abrahams
Joel de Guzman
Mateusz Loskot
Mathias Gaunard
Niall Douglas
Niall Douglas
Paul A. Bristow
Rene Rivera