doc/util/scott.notes

   1
   2 # $Id: scott.notes,v 1.1 2007/03/10 05:16:02 scott Exp $
   3
   4 The docbook-xml & docbook-xsl subdirectories contain source files
   5 from other projects.
   6
   7
   8 Download DocBook DTDs from:
   9
  10         http://www.oasis-open.org/docbook/xml/4.5/docbook-xml-4.5.zip
  11
  12 Download XSL stylesheets from:
  13
  14         http://sourceforge.net/project/showfiles.php?group_id=21935&package_id=16608
  15
  16         docbook-xsl-1.72.0.tar.bz2
  17
  18         Actually, I ended up using a snapshot (28-Feb-2007) from:
  19
  20         http://docbook.sourceforge.net/snapshots/
  21
  22 Strip the XSL release:
  23
  24         subdir=~/fvwm/fvwm/doc/docbook-xsl
  25         mkdir $subdir/html
  26         cp -p --parents $(/bin/grep xsl:include docbook.xsl | cut -f 2 -d \") !$
  27         cd ..
  28         cp -p --parents html/docbook.xsl ~/fvwm/fvwm/doc/docbook-xsl
  29         cp -p --parents highlighting/common.xsl !$
  30         cp -rp manpages !$
  31         cp -p --parents html/manifest.xsl !$
  32         cp -rp common !$
  33         cp -p --parents html/highlight.xsl !$
  34         cd !$/common
  35         rm -f $(grep ENTITY l10n.xml | cut -d \" -f 2 | grep -v en.xml)
  36         vim l10n.xml # Just use en.xml -- comment out the rest.
  37
  38
  39 Hack the XSL release:
  40
  41         manpages/other.xsl:
  42
  43         We disable string substitution because it uses WAAAYYY too much
  44         memory & instead post-process the output with a Perl script.
  45
  46         This is fixed in the 28-Feb-2007 snapshot, so we don't need to hack
  47         this anymore.
  48
  49         <xsl:variable name="adjusted.content">
  50       <xsl:call-template name="apply-string-subst-map">
  51         <xsl:with-param name="content" select="$pre.adjusted.content"/>
  52         <xsl:with-param name="map.contents" select="''"/>
  53       </xsl:call-template>
  54     </xsl:variable>
  55
  56 Other:
  57
  58         http://mail.gnome.org/archives/xslt/2007-February/msg00010.html
  59         https://sourceforge.net/tracker/?func=detail&aid=1659625&group_id=21935&atid=373749
  60
  61         <thead> in <informaltable> output twice:
  62         https://sourceforge.net/tracker/index.php?func=detail&aid=1673004&group_id=21935&atid=373747