OASIS DocBook TC2

 View Only

Fw: [docbook] DB4 to DB5 conversion stylesheet

  • 1.  Fw: [docbook] DB4 to DB5 conversion stylesheet

    Posted 04-12-2013 17:27
    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 bobs@sagehill.net From: Alexey Neyman Sent: Thursday, April 11, 2013 11:16 PM To: docbook@lists.oasis-open.org 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.