examples in toc and another customization

[Massimo Manghi <ma...@unipr.it>]

I've managed to get a list of the examples 
in the TOC of the manual. This was done 
changing the docbook xsl param 'generate.toc'. 
I wanted to have the examples listed as 
items in the tree of the toc, but chose 
to go this way, given the minimum effort 
and maximum future portability (being this
param a feature of docbook)

As a consequence of the splitting of the 
manual the timestamp on the front page was 
updated only when the main rivet.xml was 
modified. This implied the timestamp
would not have reflected most of the new 
changes, being the totality of the contents 
in the files bound toghether by rivet.xml. 
I replaced the svn "Date" property with the 
component <?dbtimestamp=... ?> that calls
a timestamp function of the xslt processor.
It seems that this processing istruction is
supported by most xslt processors except for
MSXSL though.

-- Massimo

Index: doc/rivet.xml
===================================================================
--- doc/rivet.xml	(revision 722819)
+++ doc/rivet.xml	(working copy)
@@ -73,7 +73,7 @@
   </para-->
 
   <para>
-    Document revision: $Revision$, last modified $Date$ by $Author$.
+    Document revision: $Revision$, last modified <?dbtimestamp format="Y-m-d
X" ?>$ by $Author$.
   </para>
 
     <!-- Introduction -->

Index: doc/rivet.xsl
===================================================================
--- doc/rivet.xsl	(revision 722819)
+++ doc/rivet.xsl	(working copy)
@@ -29,6 +29,7 @@
   <xsl:param name="admon.graphics" select="1"/>
   <xsl:param name="generate.section.toc.level" select="1"/>
   <xsl:param name="refentry.separator" select="1"/>
+  <xsl:param name="generate.toc">article toc,title,example</xsl:param>
 
 <!--
   <xsl:param name="refentry.generate.title" select="1"/>
@@ -52,6 +53,7 @@
 
   <xsl:variable name="group.rep.repeat.str">...</xsl:variable>
 
+
   <xsl:template name="inline.underlineseq">
     <xsl:param name="content">
       <xsl:call-template name="anchor"/>




---------------------------------------------------------------------
To unsubscribe, e-mail: rivet-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: rivet-dev-help@tcl.apache.org

Re: examples in toc and another customization

[Massimo Manghi <ma...@unipr.it>]

On Wed, 3 Dec 2008 22:50:01 +0100, David Welton wrote
> > I replaced the svn "Date" property with the
> > component <?dbtimestamp=... ?> that calls
> > a timestamp function of the xslt processor.
> > It seems that this processing istruction is
> > supported by most xslt processors except for
> > MSXSL though.
> 
> Since we run the xslt processor ourselves to generate the HTML, it's
> not that big a deal if other people have to fiddle a bit to get it
> right.  If we can make it easier, great, but it's not like building
> the source code where everyone *needs* to be able to do it.
> 
Actually I don't see the point in having the generated 
html in repository. I think we may generate the pages 
when needed and build an archive out of them to be placed
on the website (or anywhere the Apache organization requires
so, I'm still not familiar with these aspects of Apache).

The doc/html directory may be given an 'ignore' property 
to tell svn to leave it alone. Anyone wanting to build
their own manual will be enable to do it exactly like
they do it now. Any thoughts?

-- Massimo



---------------------------------------------------------------------
To unsubscribe, e-mail: rivet-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: rivet-dev-help@tcl.apache.org

Re: examples in toc and another customization

[David Welton <da...@gmail.com>]

> I replaced the svn "Date" property with the
> component <?dbtimestamp=... ?> that calls
> a timestamp function of the xslt processor.
> It seems that this processing istruction is
> supported by most xslt processors except for
> MSXSL though.

Since we run the xslt processor ourselves to generate the HTML, it's
not that big a deal if other people have to fiddle a bit to get it
right.  If we can make it easier, great, but it's not like building
the source code where everyone *needs* to be able to do it.

-- 
David N. Welton

http://www.welton.it/davidw/

http://www.dedasys.com/

---------------------------------------------------------------------
To unsubscribe, e-mail: rivet-dev-unsubscribe@tcl.apache.org
For additional commands, e-mail: rivet-dev-help@tcl.apache.org