Fw: [docbook] DB4 to DB5 conversion stylesheet

Hi all,

Does anyone know about these issues?  Does 
anyone know who maintains the db4-upgrade.xsl stylesheet?  It sounds like 
it needs some fixes.

 

Bob Stayton
Sagehill Enterprises


From: Alexey Neyman 

Sent: Thursday, April 11, 2013 11:16 PM

To:  

Subject: [docbook] DB4 to DB5 conversion 
stylesheet

Hi,

 

I 
am exploring possibility of conversion of our documents from DB4 to DB5 using 
the db4-upgrade.xsl stylesheet provided at docbook.org. I have a few questions 
regarding the stuff that the stylesheet drops from DB4 elements.

 

1. 
Is there a particular reason why that stylesheet drops @class attribute from 
<productname/>?

 

<xsl:template 
match="productname[@class]" priority="200">

<xsl:call-template 
name="emit-message">

<xsl:with-param 
name="message">

<xsl:text>Dropping 
class attribute from productname</xsl:text>

</xsl:with-param>

</xsl:call-template>

<xsl:copy>

<xsl:call-template 
name="copy.attributes">

<xsl:with-param 
name="suppress" select="'class'"/>

</xsl:call-template>

<xsl:apply-templates/>

</xsl:copy>

</xsl:template>

 

As 
far as I can see from TDG5.1, it is perfectly legal in DocBook 5.0: 
http://www.docbook.org/tdg51/en/html/productname.html

 

At 
first I thought this removal is because of some element models changing before 
the final release of DocBook 5.0 specification (the stylesheet claims 
conformance to 5.0CR5), but I don't see any productname/remark mentions in the 
specification change history.

 

2. 
Similar question: why all mark-up is removed from inside of the <remark/> 
element?

 

<xsl:template 
match="remark" priority="200">

<!-- 
get rid of any embedded markup -->

<remark>

<xsl:copy-of 
select="@*"/>

<xsl:value-of 
select="."/>

</remark>

</xsl:template>

 

Again, 
TDG5.1 says most mark-up is allowed in <remark/>: 
http://www.docbook.org/tdg51/en/html/remark.html

 

3. 
Is there a reason why all <title>xxx</title> elements are converted 
to <info><title>xxx</title></info>? As far as I can see, 
both are legal in DB5. Is <title> going to be deprecated as a direct child 
of <sectX/> elements?

 

We 
don't use anything but titles on lower level elements (such as sections), so 
<info> just adds some clutter to the documents.

 

 

Regards,

Alexey.