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

From: Gennadiy Rozental (gennadiy.rozental_at_[hidden])
Date: 2007-07-17 00:10:14

"John Maddock" <john_at_[hidden]> wrote in message 
news:00c901c7c784$0e602160$0a520e52_at_fuji...
> 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?

Why? Why so black and white?

Anyway. I think it's incorrect design decision to treat library element on 
chapter level. It should be book level.

>> 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

How does it match to the latest version on official site?

>> 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.

No difference (as expected)

>> 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.

why?

> Translate BoostBook to
> Docbook, then translate the Docbook to HTML or whatever.

Why can't I do it in one step?

Gennadiy