[Plplot-cvs] SF.net SVN: plplot:[12493] trunk/doc/docbook/src

[<ai...@us...>]

Revision: 12493
          http://sourceforge.net/p/plplot/code/12493
Author:   airwin
Date:     2013-08-21 21:18:36 +0000 (Wed, 21 Aug 2013)
Log Message:
-----------
Change funcsynopsis style to ansi and configure widths of the
resulting html table to auto (which gives nice looking spacing for the
arguments).  These changes make the new XML/XSL backend tools produce
the html form of the API chapter with a style comparable to what was
produced with the deprecated SGML/DSSSL backend tools.

Make some progress toward the goal of representing the overlined "S" and
underlined "freq" in S(freq) correctly represented in html.  However,
the final step of inserting the correct form of html needs additional
XSLT expertise that I currently don't have as mentioned in the
/plplotdoc-html.xsl.in comments.  So the result validates
fine but is currently rendered as a blank.

So aside from this one overline/underline issue (which appears just
before the Table of Greek letters), the complete html
results for the new XML/XSL backend tools are better (Table of Greek
letters) or similar (API chapter) to what they were before for the
deprecated SGML/DSSSL backend tools.

Tested by Alan W. Irwin <ai...@us...> using
the -DBUILD_DOC=ON cmake option and the "html" target.

Modified Paths:
--------------
    trunk/doc/docbook/src/plplotdoc-html.xsl.in
    trunk/doc/docbook/src/stylesheet.css.xsl.in

Modified: trunk/doc/docbook/src/plplotdoc-html.xsl.in
===================================================================
--- trunk/doc/docbook/src/plplotdoc-html.xsl.in	2013-08-20 19:10:05 UTC (rev 12492)
+++ trunk/doc/docbook/src/plplotdoc-html.xsl.in	2013-08-21 21:18:36 UTC (rev 12493)
@@ -35,16 +35,40 @@
 These ideas for customizing the PLplot html documentation are adapted
 from 
 http://www.sagehill.net/docbookxsl/CustomMethods.html#CustomizationLayer
+http://www.sagehill.net/docbookxsl/SettingParams.html
 http://www.sagehill.net/docbookxsl/Chunking.html#ChunkFilenames
+http://www.sagehill.net/docbookxsl/UsingCSS.html
+http://www.sagehill.net/docbookxsl/Parameters.html
+http://docbook.sourceforge.net/release/xsl/current/doc/html/
 ....
 -->
 <xsl:stylesheet  
-    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" 
+    xmlns:fo="http://www.w3.org/1999/XSL/Format"
+    version="1.0"> 
 
 <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl"/>
 
 <xsl:param name="chunk.quietly" select="1"/>
 <xsl:param name="use.id.as.filename" select="1"/>
 <xsl:param name="html.stylesheet" select="'stylesheet.css'"/>
+<xsl:param name="funcsynopsis.style" select="'ansi'"/>
 
+<!-- For this case (anchor tag with a name attribute of
+"over-under") we want the html result to be 
+
+<span class="overline">S</span>(<span class="underline">freq</span>)
+
+which the configured stylesheet.css will overline and underline
+as specified.  However (AWI comment), don't know how to produce
+that html yet from xslt so we do essentially nothing for this case
+at the moment.
+--> 
+<xsl:template match="anchor[@name = 'over-under']">
+  <fo:block xsl:use-attribute-sets="normal.para.spacing">
+    <xsl:call-template name="anchor"/>
+    <xsl:apply-templates/>
+  </fo:block>
+</xsl:template>
+
 </xsl:stylesheet> 

Modified: trunk/doc/docbook/src/stylesheet.css.xsl.in
===================================================================
--- trunk/doc/docbook/src/stylesheet.css.xsl.in	2013-08-20 19:10:05 UTC (rev 12492)
+++ trunk/doc/docbook/src/stylesheet.css.xsl.in	2013-08-21 21:18:36 UTC (rev 12493)
@@ -1,7 +1,7 @@
 /*
     HTML Cascade Style Sheet file for the PLplot documentation in Docbook
 
-    Copyright (C) 2004  Rafael Laboissiere
+    Copyright (C) 2013  Alan W. Irwin
 
     Redistribution and use in source (XML DocBook) and "compiled" forms
     (HTML, PDF, PostScript, DVI, TeXinfo and so forth) with or without
@@ -35,7 +35,7 @@
 SPAN.overline  { text-decoration: overline  }
 
 TABLE.funcprototype-table {
-  width: 90%;
+  width: auto;
   margin-top: 5px;
   margin-bottom: 5px;
   margin-left: 5%;
@@ -46,7 +46,7 @@
 }
 
 .variablelist {
-  width: 90%;
+  width: auto;
   margin-top: 5px;
   margin-bottom: 5px;
   margin-left: 5%;
@@ -57,7 +57,7 @@
 }
 
 .verbatim {
-  width: 90%;
+  width: auto;
   margin-top: 5px;
   margin-bottom: 5px;
   margin-left: 5%;

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.