Re: [boost] [boostbook] woes: take 1

From: John Maddock (john_at_[hidden])
Date: 2007-07-16 04:27:28

Gennadiy Rozental wrote:
> Hi,
>
> Following are varios issues I'm expiriencing with boostbook:
>
> 1. No support for chapter, part under library.
> I need to be able to split by docs usign these elements

Then maybe use Docbook alone rather than the BoostBook extentions?

> 2. xmlns:xi="http://www.w3.org/2001/XInclude"
> When I put above attribute in library element my editor complains
> about validation failure
>
> 3. Local customization layer
> I don't see how to configure Jamfile to use my own cvustomization
> later (local html.xsl) for chunked output generation
>
> 4. Directory structure
> Why can't bjam create nessesary directories for me? In chunked output
> directory structure is deep and keep changing while I am adding ids.
> It' realy incnvinient to be required to create these dirs manually

Are you building on Win32?  If so this a well known bug in the Win32 port of 
xsltproc.  There's a patched version of xsltproc here: 
http://www.meta-comm.com/engineering/boost/xsltproc-win32.zip

> 5. Clean command
> Is there a command to clean generated output (but leave directory
> structure)

Not that I'm aware of :-(

> 6. catalog errors
>
> My local path is: "D:\Source Code\boost\libs\test\docbook"
>
> And I've got following entries in my user-config.jam
>
> using xsltproc ;
>
> using boostbook
>  : D:\xml\docbook\xsl\
>  : D:\xml\docbook\dtd\
>  ;
>
> I see following messages in bjam output:
>
> ../../../bin.v2/libs/test/docbook/msvc-8.0/debug/catalog.xml:0:
> element rewriteURI: Catalog error : rewriteURI entry 'rewritePrefix'
> broken ?: file:///D:/Source Code/boost/tools/boostbook/dtd/
> ../../../bin.v2/libs/test/docbook/msvc-8.0/debug/catalog.xml:0:
> element rewriteURI: Catalog error : rewriteURI entry 'rewritePrefix'
> broken ?: file:///D:xmldocbookxsl /
> ../../../bin.v2/libs/test/docbook/msvc-8.0/debug/catalog.xml:0:
> element rewriteURI: Catalog error : rewriteURI entry 'rewritePrefix'
> broken ?: file:///D:xmldocbookdtd /

Hmmm, try forward slashes in the docbook path names in user-config.jam.

> 7. Manual xsltproc invocation
>
> When I am trying to invoke the xsltproc manually
>
> xsltproc -o html/index.html "html.xsl" UTF.xml
>
> and my html.xsl looks like this:
>
> <?xml version="1.0" encoding="utf-8"?>
> <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
>                version="1.0">
>
>  <xsl:import href="../../../tools/boostbook/xsl/html.xsl"/>
>
>  <xsl:param name="boost.root" select="'../../..'"/>
> </xsl:stylesheet>
>
> (path is correct)
>
> I am getting following error messages:
>
> Element library in namespace '' encountered, but no template matches.
> Element libraryinfo in namespace '' encountered in library, but no
> template matches.

> what  am I doing wrong?

I think you need to include boostbook.xsl first.  Translate BoostBook to 
Docbook, then translate the Docbook to HTML or whatever.

HTH, John.