From b0e30303cf73652164bcee0ee4837b8257f57dc3 Mon Sep 17 00:00:00 2001
From: "Martin A. Brown" <martin@linux-ip.net>
Date: Wed, 2 Mar 2016 23:32:37 -0800
Subject: [PATCH] snatching the stuff packaged by Frank Lichtenheld

---
 extras/xsl/ldp-html-chunk.xsl  |  27 ----
 extras/xsl/ldp-html-common.xsl | 239 ---------------------------------
 extras/xsl/ldp-html.xsl        |  27 ----
 extras/xsl/ldp-print.xsl       |  40 ------
 extras/xsl/tldp-chapters.xsl   |  14 ++
 extras/xsl/tldp-common.xsl     |  22 +++
 extras/xsl/tldp-one-page.xsl   |  12 ++
 extras/xsl/tldp-sections.xsl   |  20 +++
 8 files changed, 68 insertions(+), 333 deletions(-)
 delete mode 100644 extras/xsl/ldp-html-chunk.xsl
 delete mode 100644 extras/xsl/ldp-html-common.xsl
 delete mode 100644 extras/xsl/ldp-html.xsl
 delete mode 100644 extras/xsl/ldp-print.xsl
 create mode 100644 extras/xsl/tldp-chapters.xsl
 create mode 100644 extras/xsl/tldp-common.xsl
 create mode 100644 extras/xsl/tldp-one-page.xsl
 create mode 100644 extras/xsl/tldp-sections.xsl

diff --git a/extras/xsl/ldp-html-chunk.xsl b/extras/xsl/ldp-html-chunk.xsl
deleted file mode 100644
index f047074..0000000
--- a/extras/xsl/ldp-html-chunk.xsl
+++ /dev/null
@@ -1,27 +0,0 @@
-<?xml version='1.0'?>
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-                version='1.0'
-                xmlns="http://www.w3.org/TR/xhtml1/transitional"
-                exclude-result-prefixes="#default">
-
-<!-- $Id$ -->
-
-<!-- This stylesheet calls Norman Walsh's 'docbook.xsl' stylesheet
-     and therefore generates MULTIPLE HTML FILES as output. -->
-
-<!-- Note the the *order* of the import statements below is important and
-     should not be changed. -->
-
-<!-- Change this to the path to where you have installed Norman
-     Walsh's XSL stylesheets -->
-<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl"/>
-
-<!-- Imports the common LDP customization layer. -->
-<xsl:import href="ldp-html-common.xsl"/>
-
-<!-- If there was some reason to override 'ldp-html-common.xsl' or to 
-     perform any other customizations that affect *only* the generation
-     of multiple HTML files, those templates or parameters could be
-     entered here. -->
-
-</xsl:stylesheet>
diff --git a/extras/xsl/ldp-html-common.xsl b/extras/xsl/ldp-html-common.xsl
deleted file mode 100644
index 32e436e..0000000
--- a/extras/xsl/ldp-html-common.xsl
+++ /dev/null
@@ -1,239 +0,0 @@
-<?xml version='1.0'?>
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-                version='1.0'
-                xmlns="http://www.w3.org/TR/xhtml1/transitional"
-                exclude-result-prefixes="#default"
-		>
-
-<!-- $Id -->
-
-<!-- Experimental stylesheet by Dan York
-     This is an attempt to replicate the customizations done in ldp.dsl
-     Each customization in ldp.dsl is listed in the order in which it
-     appears (in ldp.dsl) with the corresponding XSLT template or setting
-     below it.  Where there is no XSLT code below an item, that particular
-     customization of ldp.dsl is not yet supported here.  Some additional
-     options and features have been added and are noted as not being in
-     ldp.dsl.  The work on this stylesheet began 5 Jul 2001. -->
-
-<!-- Note that this file, 'ldp-html-common.xsl', is NOT intended to be
-     called directly.  Instead, you should call either of two stylesheets:
-     'ldp-html.xsl' or 'ldp-html-chunk.xsl'.  The former generates a SINGLE
-     HTML file, while the latter performs "chunking" to generate MULTIPLE
-     HTML files.  Both of those files import the appropriate Norman Walsh
-     stylesheet and then import this customization layer. -->
-
-<!-- NOT IN LDP.DSL - This stylesheet supports the additional use of the
-     "role" and "condition" attributes to the <author> tag. The XSLT template
-     is listed later in the stylesheet, but the text lables are listed
-     here in order to make localization of the stylesheet easier. Note
-     that spaces *are* significant in the value, so you should have a
-     space after the colon. -->
-
-<xsl:variable name="maintainerlabel">Maintainer: </xsl:variable>
-<xsl:variable name="authorlabel">Author: </xsl:variable>
-
-
-<!-- NOT IN LDP.DSL
-     Creates header content in all generated HTML files -->
-
-<xsl:template name="user.head.content">
-  <xsl:param name="node" select="."/>
-  <meta name="generator" content="Experimental LDP.XSL $Revision$"/>
-  <xsl:text>
-  </xsl:text>
-  <xsl:comment> Generated by LDP XSLT customization layer
-      based on Norman Walsh's DocBook XSL stylesheets.
-      More information at http://www.linuxdoc.org/ </xsl:comment>
-  <xsl:text>
-  </xsl:text>
-
-</xsl:template>
-
-<!-- declare-characteristic preserve-sdata?
-     No longer appears necessary as it is a JadeTex issue. -->
-
-<!-- generate-legalnotice-link? 
-     Not currently supported in Norm's XSL stylesheets. Logged
-     at SourceForge as a bug. -->
-
-<!-- Should graphics be used for admonitions (notes, warnings)? 0 or 1 -->
-<xsl:param name="admon.graphics" select="0"/>
-
-<!-- If using admon graphics (1 above), what is path to graphics? 
-     Should be the path relative to your document and MUST end with
-     a trailing slash.  Also, this parameter needs to be on a 
-     single line. -->
-<xsl:param name="admon.graphics.path">images/</xsl:param>
-
-
-<!-- Make funcsynopsis look pretty -->
-<xsl:param name="funcsynopsis.decoration" select="1" type="boolean" />
-
-<!-- Extension for HTML files -->
-<xsl:param name="html.ext" select="'.html'"/>
-
-<!-- Generate TOCs for book, article, part -->
-<xsl:param name="generate.book.toc" select="1" type="boolean"/>
-<xsl:param name="generate.article.toc" select="1" type="boolean"/>
-<xsl:param name="generate.part.toc" select="1" type="boolean"/>
-
-<!-- generate-book-titlepage -->
-
-<!-- generate-article-titlepage -->
-
-<!-- Equivalent to chunk-skip-first-element-list - forces TOC on separate page 
-     If 0, first sect is on page for chapter or article -->
-<xsl:param name="chunk.first.sections" select="'1'"/>
-
-
-<!-- NOT IN LDP.DSL -->
-<!-- Create chunks for top-level sections. If 0, chunks will only be
-     created for chapters/appendixes, and NOT for sectx elements -->
-<xsl:param name="chunk.sections" select="'1'"/>
-
-<!-- list-element-list - NO LONGER NEEDED - bug fix -->
-
-<!-- Filename for the root chunk -->
-<xsl:param name="root.filename" select="'index'"/>
-
-<!-- shade-verbatim 
-     I have created a function below that shades the verbatim sections.
-     logic would need to be added to check if this is set.
-     Norm has added parameters to his 1.44 stylesheets that support
-     shading verbatim sections. However, it looks like it requires
-     an attribute to a table to have verbatim shading.  Needs to be
-     explored further. -->
-
-<!-- When chunking, use id attribute as filename? 0 or 1 -->
-<xsl:param name="use.id.as.filename" select="1"/>
-
-<!-- graphic-extensions - NO LONGER NEEDED?? -->
-
-<!-- default graphic filename extension -->
-<xsl:param name="graphic.default.extension" select="'.gif'" type="string"/>
-
-<!-- Should chapters be labeled? 0 or 1 -->
-<xsl:param name="chapter.autolabel" select="1"/>
-
-<!-- Should sections be labeled? 0 or 1 -->
-<xsl:param name="section.autolabel" select="1"/>
-
-<!-- Related to section labels, should those labels include the chapter
-     number in them (i.e., 1.1, 1.2, 1.3, 1.4 )-->
-<xsl:param name="section.label.includes.component.label" select="1" type="boolean"/>
-
-<!-- To what depth (in sections) should the TOC go? -->
-<xsl:param name="toc.section.depth" select="2"/>
-
-<!-- Custom 'emphasis' template to allow 'role="strong"' to 
-     also produce a bold item. -->
-<xsl:template match="emphasis">
-  <xsl:choose>
-    <xsl:when test="(@role='strong') or (@role='bold')">
-      <xsl:call-template name="inline.boldseq"/>
-    </xsl:when>
-    <xsl:otherwise>
-      <xsl:call-template name="inline.italicseq"/>
-    </xsl:otherwise>
-  </xsl:choose>
-</xsl:template>
-
-<!-- book-titlepage-recto-elements
-     article-titlepage-recto-elements 
-     article-titlepage-recto-mode 
-     article-title 
-     
-     - Customizing these elements (for instance, to list what is on the
-       title page) involves writing a layer for html/titlepage.templates.xml and the
-       other files html/titlepage.xsl and html/titlepage.templates.xsl - Norm
-       is doing something funky here and I haven't fully figured it out. -->
-
-<!-- The remainder of ldp.dsl deals with changing the foreground and
-     background colors of verbatim elements although in reading through the
-     DSSSL it doesn't look like it actually changed the foreground colors. 
-     The changing of the background shading can be done at two locations
-     (one numbered, one not) in the template below. -->
-
-<!-- Custom template for programlisting, screen and synopsis to generate a gray
-     background to the item. -->
-<xsl:template match="programlisting|screen|synopsis">
-  <xsl:param name="suppress-numbers" select="'0'"/>
-  <xsl:variable name="vendor" select="system-property('xsl:vendor')"/>
-  <xsl:variable name="id"><xsl:call-template name="object.id"/></xsl:variable>
-
-  <xsl:if test="@id">
-    <a href="{$id}"/>
-  </xsl:if>
-
-  <xsl:choose>
-    <xsl:when test="$suppress-numbers = '0'
-                    and @linenumbering = 'numbered'
-                    and $use.extensions != '0'
-                    and $linenumbering.extension != '0'">
-      <xsl:variable name="rtf">
-        <xsl:apply-templates/>
-      </xsl:variable>
-      <!-- Change the color bacground color in the line below. -->
-      <table border="0" bgcolor="#E0E0E0" width="90%">
-      <tr><td>
-      <pre class="{name(.)}">
-        <xsl:call-template name="number.rtf.lines">
-          <xsl:with-param name="rtf" select="$rtf"/>
-        </xsl:call-template>
-      </pre>
-      </td></tr></table>
-    </xsl:when>
-    <xsl:otherwise>
-      <!-- Change the color bacground color in the line below. -->
-      <table border="0" bgcolor="#E0E0E0" width="90%">
-      <tr><td>
-      <pre class="{name(.)}">
-        <xsl:apply-templates/>
-      </pre>
-      </td></tr></table>
-    </xsl:otherwise>
-  </xsl:choose>
-</xsl:template>
-
-<!-- NOT IN LDP.DSL. Custom template to allow Maintainer to be a role in
-     the Author element.  It also checks for a "condition" attribute
-     to the <author> element. If it finds the condition attribute, it
-     copies VERBATIM the value of the attribute to be in front of the
-     word Author or Maintainer. This is done to allow maximum flexibility.
-     Note that an <xsl:text> element was necessary to put the space
-     between the condition and the word Author or Maintainer.  -->
-
-<xsl:template match="author" mode="titlepage.mode">
-  <h3 class="{name(.)}">
-     <!-- If there is a condition attribute, print it VERBATIM first -->
-  <xsl:if test="@condition"><i><xsl:value-of select="@condition"/></i>
-  <xsl:text> </xsl:text></xsl:if>
-     <!-- Test to see if there is a role. If maintainer, print that. If not,
-          assume it is an author. -->
-  <xsl:choose>
-    <xsl:when test="@role='maintainer'">
-        <i><xsl:value-of select="$maintainerlabel"/></i>
-    </xsl:when>
-    <xsl:otherwise>
-        <i><xsl:value-of select="$authorlabel"/></i>
-    </xsl:otherwise>
-  </xsl:choose>
-  <xsl:call-template name="person.name"/>
-  </h3>
-  <xsl:apply-templates mode="titlepage.mode" select="./contrib"/>
-  <xsl:apply-templates mode="titlepage.mode" select="./affiliation"/>
-</xsl:template>
-
-<!-- NOT IN LDP.DSL. Format Q and A labels. 
-     Added by dcm 2003-05-19. -->
-
-<xsl:template match="question" mode="label.markup">
-  <xsl:text>Q</xsl:text>
-</xsl:template>
-
-<xsl:template match="answer" mode="label.markup">
-  <xsl:text>A</xsl:text>
-</xsl:template>
-
-</xsl:stylesheet>
diff --git a/extras/xsl/ldp-html.xsl b/extras/xsl/ldp-html.xsl
deleted file mode 100644
index 1e33a1e..0000000
--- a/extras/xsl/ldp-html.xsl
+++ /dev/null
@@ -1,27 +0,0 @@
-<?xml version='1.0'?>
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-                version='1.0'
-                xmlns="http://www.w3.org/TR/xhtml1/transitional"
-                exclude-result-prefixes="#default">
-
-<!-- $Id$  -->
-
-<!-- This stylesheet calls Norman Walsh's 'docbook.xsl' stylesheet
-     and therefore generates a SINGLE HTML FILE as output. -->
-
-<!-- Note the the *order* of the import statements below is important and
-     should not be changed. -->
-
-<!-- Change this to the path to where you have installed Norman
-     Walsh's XSL stylesheets.  -->
-<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl"/>
-
-<!-- Imports the common LDP customization layer. -->
-<xsl:import href="ldp-html-common.xsl"/>
-
-<!-- If there was some reason to override 'ldp-html-common.xsl' or to 
-     perform any other customizations that affect *only* the generation
-     of a single HTML file, those templates or parameters could be
-     entered here. -->
-
-</xsl:stylesheet>
diff --git a/extras/xsl/ldp-print.xsl b/extras/xsl/ldp-print.xsl
deleted file mode 100644
index cc6bc6b..0000000
--- a/extras/xsl/ldp-print.xsl
+++ /dev/null
@@ -1,40 +0,0 @@
-<?xml version='1.0'?>
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-                version='1.0'
-                xmlns="http://www.w3.org/TR/xhtml1/transitional"
-                exclude-result-prefixes="#default">
-
-<!-- $Id$  -->
-
-<!-- This stylesheet will eventually include print customizations
-     from LDP.DSL.  At the current time, it has not been developed.-->
-
-<!-- Change this to the path to where you have installed Norman
-     Walsh's XSL stylesheets.  -->
-<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
-
-<!-- Number all sections in the style of 'CH.S1.S2 Section Title' where
-     CH is the chapter number,  S1 is the section number and S2 is the
-     sub-section number.  The lables are not limited to any particular
-     depth and can go as far as there are sections. -->
-<xsl:param name="section.autolabel" select="1"></xsl:param>
-<xsl:param name="section.label.includes.component.label" select="0"></xsl:param>
-
-<!-- Turn off the default 'full justify' and go with 'left justify'
-     instead.  This avoids the large gaps that can sometimes appear
-     between words in fully-justified documents.  -->
-<xsl:param name="alignment">start</xsl:param>
-
-<!-- Shade Verbatim Sections such as programlisting and screen -->
-<xsl:param name="shade.verbatim" select="1"/>
-
-<!-- Create bookmarks in .PDF files -->
-<xsl:param name="fop.extensions" select="0"/>
-
-<!-- Use fop1 extensions, per 
-     https://lists.oasis-open.org/archives/docbook-apps/201110/msg00080.html
-  -->
-<xsl:param name="fop1.extensions" select="1"/>
-
-
-</xsl:stylesheet>
diff --git a/extras/xsl/tldp-chapters.xsl b/extras/xsl/tldp-chapters.xsl
new file mode 100644
index 0000000..5d21a0a
--- /dev/null
+++ b/extras/xsl/tldp-chapters.xsl
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<xsl:stylesheet version="1.0"
+xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+<xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/html/chunk.xsl"/>
+<xsl:import href="tldp-common.xsl"/>
+
+<!-- Generate a separate HTML page for each preface, chapter or
+     appendix.  Contrast this behavior with the tldp-one-page.xsl
+     and tldp-section.xsl customizations. -->
+<xsl:param name="chunk.section.depth" select="0"></xsl:param>
+
+</xsl:stylesheet>
diff --git a/extras/xsl/tldp-common.xsl b/extras/xsl/tldp-common.xsl
new file mode 100644
index 0000000..f8cf7b1
--- /dev/null
+++ b/extras/xsl/tldp-common.xsl
@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<xsl:stylesheet version="1.0"
+xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+<!-- This file contains parameters that are applicable to all of the
+     tldp-*.xsl files in the html directory. -->
+
+<!-- Create a link to a CSS stylesheet named 'style.css' in all html
+     output so that pages can be beautified.  Browsers not supporting
+     CSS should safely ignore the link. -->
+<xsl:param name="html.stylesheet.type">text/css</xsl:param>
+<xsl:param name="html.stylesheet" select="'style.css'"></xsl:param>
+
+<!-- Number all sections in the style of 'CH.S1.S2 Section Title' where
+     CH is the chapter number,  S1 is the section number and S2 is the
+     sub-section number.  The lables are not limited to any particular
+     depth and can go as far as there are sections. -->
+<xsl:param name="section.autolabel" select="1"></xsl:param>
+<xsl:param name="section.label.includes.component.label" select="0"></xsl:param>
+
+</xsl:stylesheet>
diff --git a/extras/xsl/tldp-one-page.xsl b/extras/xsl/tldp-one-page.xsl
new file mode 100644
index 0000000..0d19e0e
--- /dev/null
+++ b/extras/xsl/tldp-one-page.xsl
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<xsl:stylesheet version="1.0"
+xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+<xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/html/docbook.xsl"/>
+<xsl:import href="tldp-common.xsl"/>
+
+<!-- This set of customizations is used to generate the entire XML
+     document on a single HTML page. -->
+
+</xsl:stylesheet>
diff --git a/extras/xsl/tldp-sections.xsl b/extras/xsl/tldp-sections.xsl
new file mode 100644
index 0000000..fba4fa7
--- /dev/null
+++ b/extras/xsl/tldp-sections.xsl
@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<xsl:stylesheet version="1.0"
+xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+<xsl:import href="/usr/share/xml/docbook/stylesheet/nwalsh/html/chunk.xsl"/>
+<xsl:import href="tldp-common.xsl"/>
+
+<!-- Generate a separate HTML page for each section.  Doing this
+     divides the document into many pages with a shorter amount of
+     text on each page.  Shorter pages result in less scrolling when
+     viewing the document in a web browser.  Contrast this behavior
+     with the tldp-chapter.xsl and tldp-one-page.xsl customizations. -->
+<xsl:param name="chunk.section.depth" select="1"></xsl:param>
+
+<!-- Make sure that the chapter table of contents is on its own page
+     rather than being placed on the same chuck as the first section. -->
+<xsl:param name="chunk.first.sections" select="1"></xsl:param>
+
+</xsl:stylesheet>