Re: [Boost-docs] Docbook to html optimizations

Subject: Re: [Boost-docs] Docbook to html optimizations
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2010-03-25 12:50:04

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of Daniel James
> Sent: Tuesday, March 23, 2010 10:46 AM
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] Docbook to html optimizations

I've rebuilt the SVGPlot docs using Steven's improvements.

(I spent some times ignoring obvious clue before I found that 

  $images\my_imate.jpg is not longer allowed in pdfs - it must be $images/ not $images\  

 (where the image is in doc.html/images)

(I blame Bill Gates ;-)  (again)

and all seems fine in html and pdf.  Feels faster - these docs are even bigger than Boost.Units - zillions of tiddly
functions to set uptions).

Now I've got my draft of a guide to this whole toolchain (including auto-indexing, started by John Maddock) working in
html mode.  Looks fine, including images :-)

But when I try to create the pdf version with RenderX, I still get this

> > fop.render.pdf
> >
I:\boost-sandbox\tools\quick_auto_dox_index\libs\quick_auto_dox_index\doc\..\bin.v2\doc\msvc-9.0\debug\auto-index-on\thr
> > eading-multi\quick_auto_dox_index.modified.pdf
> > (document [system-id
> >
file:/I:/boost-sandbox/tools/quick_auto_dox_index/libs/quick_auto_dox_index/doc/../bin.v2/doc/msvc-9.0/debug/auto-index-
> > on/threading-multi/quick_auto_dox_index.modified.fo]
> >  (validate
> >    [error] There can be only one 'rx:outline' element as a child of 'fo:root'.
> >    [validation total: 1 error]
> > Parse error: Invalid XSL FO source
> >
'file:/I:/boost-sandbox/tools/quick_auto_dox_index/libs/quick_auto_dox_index/doc/../bin.v2/doc/msvc-9.0/debug/auto-index
> > -on/threading-multi/quick_auto_dox_index.modified.fo': 1 error found during validation

I've looked at quick_auto_dox_index.modified.fo file quickly, but I can only find 'outline' twice and as expected.

<fo.root>

<rx:outline> 
...
 </rx:outline>
...
</fo.root>

The quick_auto_dox_index.modified.docbook file also looks fine (it there a validation program somewhere?)

So I can't see what is wrong.

> That looks like it's caused by invalid docbook. I'd have to see your
> documentation files to give you an answer. 

The docbook is too big (80k and the modified.fo 250K) to send to the group.  how shall I get it to you?  zip and send
privately? Commit the whole lot to sandbox (this is my eventual intention, if people think it is/could be helpful).

Or give me some hints on where to look?

Many Thanks

Paul

---
Paul A. Bristow
Prizet Farmhouse
Kendal, UK   LA8 8AB
[phone], mobile [phone]
pbristow_at_[hidden]