On 2010-06-06 01:37-0700 Alan W. Irwin wrote: > The message also included an intriguing snippet about how to fix the problem > > <quote> > [...]it requires a little stylesheet customization. > You can add this small template: > > <xsl:template match="book" mode="for-menu-title"> > <xsl:text>PLplot</xsl:text> > </xsl:template> > > </quote> > > Orion's request for clarification of that snippet was never answered. > However, from the docbook2X documentation it appears that you can generate > info files with a specific docbook2X stylesheet as follows: > > xsltproc /usr/share/docbook2X/xslt/backend/db2x_texixml.xsl mydoc.txml > > and if you look in that stylesheet there are xsl:template tags of various > kinds. So I believe the thing to do is copy that stylesheet (which has a > MIT license) to the PLplot source tree and customize it for our own needs by > adding the above snippet. I have played a bit with xsltproc and stylesheets > before, and I always have trouble with it but eventually I get it to do what > I want. So I am not exactly looking forward to this, but getting the > correct menu entry for PLplot in the info files it is a long-standing issue > that would be nice to get fixed so I will give this idea a try tomorrow > unless someone else with more xslt experience than me wants to give it a go.
In brief it doesn't work. The first issue is db2x_texixml.xsl refers to charmap2.xsl which is not distributed any more with docbook2x. I retrieved that file from the docbook2x cvs attic at SF, but then the showstopper issue becomes apparent which is xsltproc (or xalan if you try that xslt processor) sends a lot of extra text to stdout. It is been a while since I have done xslt processing, but if memory serves this means the sourcefile (in this case plplotdoc.txml) has xml tags which cannot be understood by db2x_texixml.xsl. My interpretation of the missing charmap2.xsl, and incomplete db2x_texixml.xsl style sheet is that db2x_texixml.xsl was something done early in the docbook2x development history that has not been maintained since. Instead, the perl script db2x_texixml has been preferentially developed instead to do the same task, but I don't know how to gain control of the style sheet for that method of generating our info files and therefore cannot fix the bug that started this discussion. I will see what the docbook2x developer says about all this, but since development has stopped, he may not respond so we may be stuck until somebody else revives docbook2x or some other good alternative for deriving info files from docbook source is developed. Alan __________________________ Alan W. Irwin Astronomical research affiliation with Department of Physics and Astronomy, University of Victoria (astrowww.phys.uvic.ca). Programming affiliations with the FreeEOS equation-of-state implementation for stellar interiors (freeeos.sf.net); PLplot scientific plotting software package (plplot.org); the libLASi project (unifont.org/lasi); the Loads of Linux Links project (loll.sf.net); and the Linux Brochure Project (lbproject.sf.net). __________________________ Linux-powered Science __________________________ ------------------------------------------------------------------------------ ThinkGeek and WIRED's GeekDad team up for the Ultimate GeekDad Father's Day Giveaway. ONE MASSIVE PRIZE to the lucky parental unit. See the prize list and enter to win: http://p.sf.net/sfu/thinkgeek-promo _______________________________________________ Plplot-devel mailing list Plplot-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/plplot-devel
