Very preliminary versions of the stylesheets.

4 files changed, 529 insertions, 0 deletions

diff --git a/tools/user_guide.xsl b/tools/user_guide.xsl
new file mode 100755
index 0000000..9a0cdb7
--- /dev/null
+++ b/tools/user_guide.xsl
@@ -0,0 +1,37 @@
+<?xml version='1.0'?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                version='1.0'>
+
+<!-- Import original style sheet: chunk.xsl (multi-page) or docbook.xsl (one page) -->
+
+  <xsl:import href="/usr/share/sgml/docbook/xsl-stylesheets-1.66.1/html/docbook.xsl"/>
+
+<!-- ******************************************************************
+   -
+   -  Load the common custimzation for HTML:
+   -
+   - ******************************************************************
+   -->
+
+	<xsl:include href="user_guide_common.xsl"/>
+	<!-- xsl:include href="html_titlepage.xsl"/ -->
+
+	<xsl:param name="page.margin.top">10in</xsl:param>
+	<xsl:param name="page.margin.bottom">10in</xsl:param>
+	<xsl:param name="page.margin.inner">10in</xsl:param>
+	<xsl:param name="page.margin.outer">10in</xsl:param>
+
+<!-- ******************************************************************
+   -
+   -  Custimization starts here:
+   -
+   - ******************************************************************
+   -->
+
+<!--
+   -  Do not use the chunker in this version:
+   -->
+
+<xsl:param name="using.chunker" select="0"/>
+
+</xsl:stylesheet>
diff --git a/tools/user_guide_chunks.xsl b/tools/user_guide_chunks.xsl
new file mode 100755
index 0000000..7d75dc9
--- /dev/null
+++ b/tools/user_guide_chunks.xsl
@@ -0,0 +1,75 @@
+<?xml version='1.0'?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                version='1.0'>
+
+<!-- Import original style sheet: chunk.xsl (multi-page) or docbook.xsl (one page) -->
+
+	<xsl:import href="/usr/share/sgml/docbook/xsl-stylesheets-1.66.1/html/chunk.xsl"/>
+
+<!-- ******************************************************************
+   -
+   -  Load the common custimzation for HTML:
+   -
+   - ******************************************************************
+   -->
+
+	<xsl:include href="user_guide_common.xsl"/>
+	<!-- xsl:include href="html_titlepage.xsl"/ -->
+
+	<xsl:param name="page.margin.top">10in</xsl:param>
+	<xsl:param name="page.margin.bottom">10in</xsl:param>
+	<xsl:param name="page.margin.inner">10in</xsl:param>
+	<xsl:param name="page.margin.outer">10in</xsl:param>
+
+	<xsl:param name="generate.legalnotice.link" select="1"/>
+
+<!-- ******************************************************************
+   -
+   -  Chunks specific customization:
+   -
+   - ******************************************************************
+   -->
+
+<!-- Generate a message for each chunked file -->
+
+<xsl:param name="chunk.quietly" select="0"/>
+
+<!-- New top-level file name: index.html is reserved for the index  -->
+
+<xsl:param name="root.filename" select="'user_guide'"/>
+
+<!-- Yes we use the chunker: splits the output into several files. -->
+
+<xsl:param name="using.chunker" select="0"/>
+
+<!-- Chunk only the first level of chapter/sections -->
+
+<xsl:param name="chunk.section.depth" select="1"/>
+
+<!-- Generate a separate chunk for the first element of each section -->
+
+<xsl:param name="chunk.first.sections" select="1"/>
+
+<!-- Do not use the ID as filename: they contain forbidden chars -->
+
+<xsl:param name="use.id.as.filename" select="'0'"/>
+
+<!-- Use the following extension for output files: .html -->
+
+<xsl:param name="html.ext" select="'.html'"/>
+
+<!-- Generate extra HEAD links for Mozilla -->
+
+<xsl:param name="html.extra.head.links" select="1"/>
+
+<!-- Use graphics in navigation headers/footers -->
+
+<xsl:param name="navig.graphics" select="1"/>
+<xsl:param name="navig.graphics.extension" select="'.png'"/>
+<xsl:param name="navig.graphics.path">images/</xsl:param>
+
+<!-- Show next and previous sections titles in nav bars -->
+
+<xsl:param name="navig.showtitles">1</xsl:param>
+
+</xsl:stylesheet>
diff --git a/tools/user_guide_common.xsl b/tools/user_guide_common.xsl
new file mode 100755
index 0000000..7270fab
--- /dev/null
+++ b/tools/user_guide_common.xsl
@@ -0,0 +1,293 @@
+<?xml version='1.0'?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                version='1.0'>
+
+<!-- Allow extensions usage -->
+
+<xsl:param name="tablecolumns.extension">1</xsl:param>
+<xsl:param name="use.extensions"        >1</xsl:param>
+
+<!-- Insert the abstract into the META header part -->
+
+<xsl:param name="generate.meta.abstract">1</xsl:param>
+
+<!-- =================================================================
+   -  HTML: Navigation parts: Leave nav buttons on footer, keep rulers.
+   - =================================================================
+   -->
+
+<xsl:param name="suppress.footer.navigation">0</xsl:param>
+<xsl:param name="header.rule"               >1</xsl:param>
+<xsl:param name="footer.rule"               >1</xsl:param>
+
+<xsl:param name="admon.graphics"            >1</xsl:param>
+
+<!-- URL rendering:                          -->
+
+<xsl:param name="ulink.show">1</xsl:param>
+
+<!-- Cross references: add page number in cross-refs -->
+
+<xsl:param name="insert.xref.page.number">1</xsl:param>
+
+
+<!-- =================================================================
+   -  HTML: Use HTML stylesheet with the output:
+   - =================================================================
+   -->
+
+<xsl:param name="html.stylesheet"     >user_guides.css</xsl:param>
+<xsl:param name="html.stylesheet.type">text/css</xsl:param>
+<xsl:param name="css.decoration"      >1</xsl:param>
+
+<!-- Show revision flag as class attribute for CSS decoration -->
+
+<xsl:param name="show.revisionflag">0</xsl:param>
+
+
+<!-- =================================================================
+   -  Automatically generated parts: ToC, numbering, index,....
+   - =================================================================
+   -->
+
+<!-- Auto label chapters, appendix and sections -->
+
+<xsl:param name="chapter.autolabel" >1</xsl:param>
+<xsl:param name="section.autolabel" >1</xsl:param>
+<xsl:param name="appendix.autolabel">1</xsl:param>
+
+<xsl:param name="part.autolabel"    >1</xsl:param>
+<xsl:param name="preface.autolabel" >0</xsl:param>
+
+<!-- Section label includes parent hierarchy -->
+
+<xsl:param name="section.label.includes.component.label">1</xsl:param>
+
+<!-- Do not restart numbering at each part -->
+
+<xsl:param name="label.from.part">0</xsl:param>
+
+<!-- Generate ToC for book, article, chapter and appendix -->
+
+<xsl:param name="generate.toc">
+	appendix toc
+	article toc
+	book toc,figure
+	chapter toc
+</xsl:param>
+
+<!-- Indent between levels of the ToC..: 10       -->
+<!-- ToC char between number and title.: '.<tab>' -->
+<!-- Show bridgeheads in ToC...........: false    -->
+<!-- HTML type for ToC entries.........: 'dl'     -->
+<!-- Recursive depth of ToC ...........: 5        -->
+<!-- Depth of sections in ToC..........: not used -->
+<!-- Generate the index................: true     -->
+
+
+<xsl:param name="toc.indent.width"          >10</xsl:param>
+<xsl:param name="autotoc.label.separator"   >.  </xsl:param>
+<xsl:param name="bridgehead.in.toc"         >0</xsl:param>
+<xsl:param name="toc.list.type"             >dl</xsl:param>
+<xsl:param name="toc.section.depth"         >5</xsl:param>
+<xsl:param name="generate.section.toc.level">3</xsl:param>
+
+<xsl:param name="generate.index"            >1</xsl:param>
+
+<!-- ToC margin settings -->
+
+<xsl:attribute-set name="toc.margin.properties">
+	<xsl:attribute name="space-before.minimum">0.5em</xsl:attribute>
+	<xsl:attribute name="space-before.optimum">1em</xsl:attribute>
+	<xsl:attribute name="space-before.maximum">2em</xsl:attribute>
+	<xsl:attribute name="space-after.minimum" >0.5em</xsl:attribute>
+	<xsl:attribute name="space-after.optimum" >1em</xsl:attribute>
+	<xsl:attribute name="space-after.maximum" >2em</xsl:attribute>
+</xsl:attribute-set>
+
+
+<!-- =================================================================
+   -  Generic decoration and rendering:
+   - =================================================================
+   -->
+
+<!-- Do not include dummy paras for spacing -->
+
+<xsl:param name="spacing.paras">0</xsl:param>
+
+<!-- Text justification: justified -->
+
+<xsl:param name="alignment">justify</xsl:param>
+
+<!-- Pass the role attribute of 'emphasis'/'phrase' as HTML class attribute -->
+
+<xsl:param name="emphasis.propagates.style">1</xsl:param>
+<xsl:param name="phrase.propagates.style"  >1</xsl:param>
+
+<!-- Number of columns...................: 1 -->
+<!-- Number of columns in back matter....: 1 -->
+<!-- Number of columns in front matter...: 1 -->
+<!-- Number of columns in body...........: 1 -->
+<!-- Number of columns in index..........: 1 -->
+<!-- Number of columns in list-of-titles.: 1 -->
+
+<xsl:param name="column.count"          >1</xsl:param>
+<xsl:param name="column.count.back"     >1</xsl:param>
+<xsl:param name="column.count.front"    >1</xsl:param>
+<xsl:param name="column.count.body"     >1</xsl:param>
+<xsl:param name="column.count.index"    >1</xsl:param>
+<xsl:param name="column.count.lot"      >1</xsl:param>
+<xsl:param name="column.count.titlepage">1</xsl:param>
+
+<!-- Formal element title placement: any element with title -->
+
+<xsl:param name="formal.title.placement">
+	figure    after
+	example   after
+	equation  after
+	table     after
+	procedure after
+</xsl:param>
+
+<!-- Fonts: *********************************** -->
+
+<xsl:param name="body.font.family"     >Times</xsl:param>
+<xsl:param name="title.font.family"    >Helvetica</xsl:param>
+<xsl:param name="monospace.font.family">Courier</xsl:param>
+<xsl:param name="sans.font.family"     >Helvetica</xsl:param>
+<xsl:param name="dingbat.font.family"  >Times Roman</xsl:param>
+
+<xsl:param name="body.font.master"     >12</xsl:param>
+<xsl:param name="body.font.size">
+  <xsl:value-of select="$body.font.master"/><xsl:text>pt</xsl:text>
+</xsl:param>
+
+<xsl:param name="monospace.verbatim.font.master" select="$body.font.master * 0.8"/>
+<xsl:attribute-set name="monospace.verbatim.properties">
+	<xsl:attribute name="font-size">
+		<xsl:value-of select="$monospace.verbatim.font.master"/><xsl:text>pt</xsl:text>
+	</xsl:attribute>
+</xsl:attribute-set>
+
+<!-- =================================================================
+   -  Specific parts layout:
+   - =================================================================
+   -->
+
+<!-- Paragraph: -->
+
+<xsl:attribute-set name="normal.para.spacing">
+	<xsl:attribute name="space-before.optimum">1em</xsl:attribute>
+	<xsl:attribute name="space-before.minimum">0.8em</xsl:attribute>
+	<xsl:attribute name="space-before.maximum">1.2em</xsl:attribute>
+</xsl:attribute-set>
+
+<!-- Lists: -->
+
+<xsl:attribute-set name="list.block.spacing">
+	<xsl:attribute name="space-before.optimum">0.2cm</xsl:attribute>
+	<xsl:attribute name="space-before.minimum">0.1cm</xsl:attribute>
+	<xsl:attribute name="space-before.maximum">0.5cm</xsl:attribute>
+</xsl:attribute-set>
+
+<xsl:attribute-set name="list.item.spacing">
+	<xsl:attribute name="start-indent"        >0.3cm</xsl:attribute>
+	<xsl:attribute name="space-before.optimum">0.1cm</xsl:attribute>
+	<xsl:attribute name="space-before.minimum">0.0cm</xsl:attribute>
+	<xsl:attribute name="space-before.maximum">0.2cm</xsl:attribute>
+</xsl:attribute-set>
+
+<xsl:attribute-set name="compact.list.item.spacing">
+	<xsl:attribute name="space-before.optimum">0cm</xsl:attribute>
+	<xsl:attribute name="space-before.minimum">0cm</xsl:attribute>
+	<xsl:attribute name="space-before.maximum">0.1cm</xsl:attribute>
+</xsl:attribute-set>
+
+<!-- Verbatim sections: -->
+
+<xsl:attribute-set name="verbatim.properties">
+	<xsl:attribute name="space-before.minimum">0.1cm</xsl:attribute>
+	<xsl:attribute name="space-before.optimum">0.2cm</xsl:attribute>
+	<xsl:attribute name="space-before.maximum">0.3cm</xsl:attribute>
+	<xsl:attribute name="text-align">left</xsl:attribute>
+</xsl:attribute-set>
+
+<xsl:param name="shade.verbatim">1</xsl:param>
+<xsl:attribute-set name="shade.verbatim.style">
+	<xsl:attribute name="background-color">#E0E0E0</xsl:attribute>
+</xsl:attribute-set>
+
+
+<!-- blockquote rendering: -->
+
+<xsl:attribute-set name="blockquote.properties">
+	<xsl:attribute name="start-indent"        >0.2cm</xsl:attribute>
+	<xsl:attribute name="end-indent"          >0.1cm</xsl:attribute>
+	<xsl:attribute name="space-after.minimum" >0.1cm</xsl:attribute>
+	<xsl:attribute name="space-after.optimum" >0.2cm</xsl:attribute>
+	<xsl:attribute name="space-after.maximum" >0.3cm</xsl:attribute>
+	<xsl:attribute name="space-before.minimum">0.1cm</xsl:attribute>
+	<xsl:attribute name="space-before.optimum">0.2cm</xsl:attribute>
+	<xsl:attribute name="space-before.maximum">0.3cm</xsl:attribute>
+</xsl:attribute-set>
+
+<!-- Sections and chapters titles: -->
+
+<xsl:attribute-set name="section.title.properties">
+	<xsl:attribute name="font-family">
+		<xsl:value-of select="$title.font.family"></xsl:value-of>
+	</xsl:attribute>
+	<xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
+	<xsl:attribute name="space-before.minimum">0.5cm</xsl:attribute>
+	<xsl:attribute name="space-before.optimum">1cm</xsl:attribute>
+	<xsl:attribute name="space-before.maximum">1.5cm</xsl:attribute>
+</xsl:attribute-set>
+
+<xsl:attribute-set name="section.title.level1.properties">
+	<xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
+	<xsl:attribute name="font-size">16pt</xsl:attribute>
+</xsl:attribute-set>
+
+<xsl:attribute-set name="section.title.level2.properties">
+	<xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
+	<xsl:attribute name="font-size">14pt</xsl:attribute>
+</xsl:attribute-set>
+
+<xsl:attribute-set name="section.title.level3.properties">
+	<xsl:attribute name="keep-with-next.within-column">always</xsl:attribute>
+	<xsl:attribute name="font-size">12pt</xsl:attribute>
+</xsl:attribute-set>
+
+<!-- Do not use table to create images viewports: breaks the alignement -->
+
+<xsl:param name="make.graphic.viewport">0</xsl:param>
+
+<!-- Functions synopsys style: -->
+
+<xsl:param name="funcsynopsis.style">ansi</xsl:param>
+
+
+<!-- =================================================================
+   -  Tables layout and properties:
+   - =================================================================
+   -->
+
+<xsl:param name="table.frame.border.thickness">1pt</xsl:param>
+<xsl:param name="table.frame.border.style"    >solid</xsl:param>
+<xsl:param name="table.cell.border.thickness" >1pt</xsl:param>
+<xsl:param name="table.cell.border.style"     >solid</xsl:param>
+
+<xsl:attribute-set name="table.cell.padding">
+	<xsl:attribute name="padding-left"  >2pt</xsl:attribute>
+	<xsl:attribute name="padding-right" >2pt</xsl:attribute>
+	<xsl:attribute name="padding-top"   >2pt</xsl:attribute>
+	<xsl:attribute name="padding-bottom">2pt</xsl:attribute>
+</xsl:attribute-set>
+
+<xsl:param name="table.entry.padding">2pt</xsl:param>
+
+<xsl:param name="default.table.width">18cm</xsl:param>
+<xsl:param name="nominal.table.width">18cm</xsl:param>
+
+
+</xsl:stylesheet>
diff --git a/tools/user_guide_fo.xsl b/tools/user_guide_fo.xsl
new file mode 100755
index 0000000..93f8543
--- /dev/null
+++ b/tools/user_guide_fo.xsl
@@ -0,0 +1,124 @@
+<?xml version='1.0'?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                version='1.0'>
+
+<!-- Import original style sheet: chunk.xsl (multi-page) or docbook.xsl (one page) -->
+
+  <xsl:import href="/usr/share/sgml/docbook/xsl-stylesheets-1.66.1/fo/docbook.xsl"/>
+
+<!-- ******************************************************************
+   -
+   -  Load the common custimzation layer:
+   -
+   - ******************************************************************
+   -->
+
+	<xsl:include href="user_guide_common.xsl"/>
+
+	<!-- xsl:include href="fo_titlepage.xsl"/ -->
+
+<!-- ******************************************************************
+   -
+   -  Custimization starts here:
+   -
+   - ******************************************************************
+   -->
+
+<!--
+   - Trial: use FOP extensions. Put here the stuf to generate PDF using FOP.
+   -->
+<xsl:param name="fop.extensions">1</xsl:param>
+<xsl:param name="xep.extensions">1</xsl:param>
+
+<!--
+   - DO NOT HYPHENATE WORD IN PDF: as hyphenation is not intelligent, it
+	- can produce strange output in some cases...
+   -
+   -->
+
+<xsl:param name="hyphenate">false</xsl:param>
+
+<!--
+   - Page layout: page size, paper type, margins,...
+	-
+  -->
+
+<!-- A4, portrait orientation/size, single sided -->
+
+<xsl:param name="page.orientation">portrait</xsl:param>
+<xsl:param name="paper.type"      >USletter</xsl:param>
+<xsl:param name="double.sided"    >0</xsl:param>
+
+<xsl:param name="draft.mode" select="'no'"></xsl:param>
+
+<!-- Right margin -->
+
+<xsl:param name="page.margin.inner"  >1.5cm</xsl:param>
+
+<!-- Left margin -->
+
+<xsl:param name="page.margin.outer"  >1.5cm</xsl:param>
+
+<!-- Bottom margin, extend,... -->
+
+<xsl:param name="page.margin.bottom" >0.5cm</xsl:param>
+<xsl:param name="body.margin.bottom" >2.5cm</xsl:param>
+<xsl:param name="region.after.extent">1.5cm</xsl:param>
+
+<!-- Top margin, extend,... -->
+
+<xsl:param name="page.margin.top"     >0.5cm</xsl:param>
+<xsl:param name="body.margin.top"     >2.5cm</xsl:param>
+<xsl:param name="region.before.extent">1.5cm</xsl:param>
+
+<!-- Left margin for titles -->
+
+<xsl:param name="title.margin.left"   >-0.5cm</xsl:param>
+
+<!--
+   - Headers and footers settings:
+	-
+	-->
+
+<!-- Print headers and footers on blank pages -->
+
+<xsl:param name="headers.on.blank.pages">1</xsl:param>
+<xsl:param name="footers.on.blank.pages">1</xsl:param>
+
+<xsl:param name="variablelist.as.blocks" select="1"></xsl:param>
+
+<!-- monospace font size set to 0.8 of master font size -->
+<!-- Affects programlisting, screen etc -->
+
+<xsl:attribute-set name="monospace.properties">
+  <xsl:attribute name="font-size">
+    <xsl:value-of select="$body.font.master * 0.8"/>
+    <xsl:text>pt</xsl:text>
+  </xsl:attribute>
+  <xsl:attribute name="font-family">
+    <xsl:value-of select="$monospace.font.family"/>
+  </xsl:attribute>
+</xsl:attribute-set>
+
+<xsl:attribute-set name="monospace.verbatim.properties" use-attribute-sets="verbatim.properties monospace.properties">
+  <xsl:attribute name="font-size">
+    <xsl:value-of select="$body.font.master * 0.8"/>
+    <xsl:text>pt</xsl:text>
+  </xsl:attribute>
+  <xsl:attribute name="text-align">start</xsl:attribute>
+</xsl:attribute-set>
+
+<xsl:attribute-set name="verbatim.properties">
+  <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute>
+  <xsl:attribute name="space-before.optimum">1em</xsl:attribute>
+  <xsl:attribute name="space-before.maximum">1.2em</xsl:attribute>
+  <xsl:attribute name="space-after.minimum">0.8em</xsl:attribute>
+  <xsl:attribute name="space-after.optimum">1em</xsl:attribute>
+  <xsl:attribute name="space-after.maximum">1.2em</xsl:attribute>
+  <xsl:attribute name="font-size">
+    <xsl:value-of select="$body.font.master * 0.8"/>
+    <xsl:text>pt</xsl:text>
+  </xsl:attribute>
+</xsl:attribute-set>
+
+</xsl:stylesheet>