Re: LONG LIVE DEBIANDOC (was: How to edit debiandoc in emacs with nxml)

[Osamu Aoki <osamuaoki@e01.itscom.net>]

Hi,

Oops...
On Sat, Oct 01, 2016 at 07:49:55AM +0900, Osamu Aoki wrote:
> HI,
> 
> On Fri, Sep 30, 2016 at 11:50:03AM -0400, Bob Bernstein wrote:
> > Please forgive me this cross-post from debian-user.
> > 
> > -- snip --
> ...
> > Thanks all, and please let's not allow debiandoc to wither on the vine.
> 
> debiandoc-sgml now comes with debiandoc2dbk.  If you wish to migrate
> tags to new Docbook XML, this does most of the conversion for you.
> 
> You do not need to use all the tags in Docbook XML.
> 
> You can see several Debian document sources to know how we build
> document from there.  
> 
> For HTML, nwalsh's stylesheet and xslt command.
>   xsltproc --novalid --nonet your-xml-source.dbk

Wrong.  You need to call nwalsh's stylesheet by something like (Untested)

 xsltproc --novalid --nonet --xinclude \
   /usr/share/xml/docbook/stylesheet/docbook-xsl/xhtml-1_1/chunk.xsl \
   your-xml-source.dbk


> You can customize html build with XSL stylesheet
>   xsltproc --novalid --nonet --xinclude stylesheet.xsl your-xml-source.dbk

Of course your stylesheet.xsl needs to be like (You need some adjustment):
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"; version="1.0">

<!-- Import our base stylesheet -->
<xsl:import href="file:///usr/share/xml/docbook/stylesheet/docbook-xsl/xhtml-1_1/chunk.xsl"/>

<!-- Since I use xsltproc (not saxon), this is workaround to ensure UTF-8 -->
<xsl:template xmlns="http://www.w3.org/1999/xhtml"; name="head.content.generator">
  <xsl:param name="node" select="."/>
  <meta name="generator" content="DocBook {$DistroTitle} V{$VERSION}"/>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
</xsl:template>

<xsl:template name="generate.html.title"/>

<!-- We don't want title in HTML -->
<xsl:param name="generate.meta.abstract" select="0"/>
<xsl:param name="html.stylesheet">debian-reference.css</xsl:param>
<xsl:param name="root.filename">index</xsl:param>

<!-- I hate when the first subsection is on the same page as content -->
<xsl:param name="chunk.first.sections" select="0"/>
<xsl:param name="chunk.section.depth" select="0"/>
<xsl:param name="chunker.output.indent" select="'yes'"/>

<!-- Do we want fancy icons around note, warning, etc.? -->
<xsl:param name="admon.graphics" select="1"/>
<!-- Do we want fancy icons instead of Next, Prev, Up, Home? -->
<xsl:param name="navig.graphics" select="1"/>
<xsl:param name="navig.graphics.extension">.png</xsl:param>

<xsl:param name="toc.section.depth">4</xsl:param>
<xsl:param name="section.label.includes.component.label" select="1"/>
<xsl:param name="section.autolabel" select="1"/>

</xsl:stylesheet>

(This is from debian-reference but maint-guide etc may also be referenced.)



> I recommend to use dblatex to build PDF.
> 
> Osamu
>