summaryrefslogtreecommitdiffstats
path: root/tools
diff options
context:
space:
mode:
authorfbarriere <fbarriere>2005-06-22 19:41:33 +0000
committerfbarriere <fbarriere>2005-06-22 19:41:33 +0000
commitb78ffae1414364e7fcad8def43a67b6c948c858c (patch)
tree0b284aa7f0a0e921a8d71d72d42adef75ec678cd /tools
parentc7e1553446ccd4bbd4b311fe6753e274616e0573 (diff)
downloadsylpheeddoc-doc-b78ffae1414364e7fcad8def43a67b6c948c858c.zip
sylpheeddoc-doc-b78ffae1414364e7fcad8def43a67b6c948c858c.tar.gz
sylpheeddoc-doc-b78ffae1414364e7fcad8def43a67b6c948c858c.tar.xz
Very preliminary versions of the stylesheets.
Diffstat (limited to 'tools')
-rwxr-xr-xtools/user_guide.xsl37
-rwxr-xr-xtools/user_guide_chunks.xsl75
-rwxr-xr-xtools/user_guide_common.xsl293
-rwxr-xr-xtools/user_guide_fo.xsl124
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>