Changes made by XMLmind to the docbook-xsl-1.75.2 distribution
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 (DocBook 5: replace docbook-xsl-1.75.2 by docbook-xsl-ns-1.75.2)

  [1] mv XXE_install_dir/config/docbook/xsl \
              XXE_install_dir/config/docbook/OLDxsl

      mv XXE_install_dir/config/docbook/docbook-xsl-saxon.jar \
          XXE_install_dir/config/docbook/OLDdocbook-xsl-saxon.jar

  [2] tar zxvf /tmp/docbook-xsl-1.75.2.tar.gz

      mv docbook-xsl-1.75.2 XXE_install_dir/config/docbook/xsl

      cd XXE_install_dir/config/docbook/xsl

  [3] rm -rf epub catalog.xml \
         doc docsrc INSTALL Makefile NEWS.html NEWS.xml \
         RELEASE-NOTES.xml RELEASE-NOTES.pdf RELEASE-NOTES.html \
         slides website tools install.sh tests \
         .CatalogManager.properties.example \
         .urilist AUTHORS BUGS NEWS TODO .gitignore .profile.incl \
         .cshrc.incl .emacs.el test.sh uninstall.sh DOCBOOK-BUILD.LOG

  [4] mv extensions/saxon65.jar ../docbook-xsl-saxon.jar

      rm -rf extensions/

      DocBook 5: docbook-xsl-saxon.jar not useful. Already present in
      ../docbook/. However, make sure to delete extensions/!!!

  [5] cp -r ../OLDxsl/css/ .

  [6] cp ../OLDxsl/make_image_lists .
      
      Run ./make_image_lists to create image lists in images/ and
      images/callouts/.

  [7] cd html/

      Changed param.xsl: 

        * callout.graphics from 1 to 0

        * Change all
          http://docbook.sourceforge.net/release/images/XXX to
          images/XXX

  [8] cd xhtml/, same changes as in html/.

      cd xhtml-1_1/, same changes as in html/.

  [9] cd fo/

       Changed param.xsl: 

         * Same as in html and xhtml

         * callout.graphics.extension from .svg to .png

         * body.start.indent from 4pc to 0pt 
           (4pc may be nicer but in such case generated TOCs are buggy).

         * Title fonts are much too big (qanda.title.level1.properties,
           section.title.level1.properties, etc). 
           Change max factor from 2.0736 to 1.728.

         * Added to monospace.properties (included by 
           monospace.verbatim.properties)

+---+
  <xsl:attribute name="font-size">
    <xsl:value-of select="$body.font.master * 0.83"/>
    <xsl:text>pt</xsl:text>
  </xsl:attribute>
+---+

       Changed table.xsl:

         * table-layout="auto" may be supported by some FO processors,
           unfortunately it is not supported by Saxon extension
           com.nwalsh.saxon.Table#adjustColumnWidths().

           Reverted to $table.width=100% when $explicit.table.width and
           $default.table.width are not specified.

       Changed autotoc.xsl:

         * Declared 
           xmlns:xfc="http://www.xmlmind.com/foconverter/xsl/extensions"

         * Added xfc:tab-position="-({$toc.indent.width}pt+7.5mm)" and 
           xfc:tab-align="right" to <fo:leader>.

       Changed graphics.xsl:

         * Change variable content-type as follows. 
           The comments below explain why.

+---+
<xsl:variable name="content-type">
  <!-- Do not convert @format to a content-type attribute when
       the graphics file has an extension.
       This is incompatible with the fact that XXE can convert 
       on the fly between different image formats. -->

  <xsl:variable name="ext">
    <xsl:if test="@fileref">
      <xsl:call-template name="filename-extension">
        <xsl:with-param name="filename" select="@fileref"/>
      </xsl:call-template>
    </xsl:if>
  </xsl:variable>

  <xsl:if test="@format and $ext = ''">
    <xsl:call-template name="graphic.format.content-type">
      <xsl:with-param name="format" select="@format"/>
    </xsl:call-template>
  </xsl:if>
</xsl:variable>
+---+

         * If scalefit=1 and both width and depth are specified, 
           both content-width and content-height must be set to
           scale-to-fit. If content-width is set to scale-to-fit and
           content-height is left to auto, XEP does not fit the image in the
           viewport but just adjusts the height to the width of the viewport
           in order to preserve the aspect ratio of the image. (XEP behavior
           does not seem nonsensical.)

           This required replacing variable $scalefit by two variables
           $scalefitwidth and $scalefitdepth.

  [10] Update catalog.xml

  [11] Update slides_config/xsl/, including slides_catalog.xml 

* Alternate epub style sheet:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  [1] rm -rf epub; cp -r CHANGES_MADE_BY_XMLMIND/epub epub

      (DocBook 5: copy ../../docbook/xsl/CHANGES_MADE_BY_XMLMIND/5epub.)

  [2] Modifications made to xhtml-1_1/

      [docbook.xsl] Changed:

---
<xsl:output method="xml" encoding="UTF-8" indent="no" 
  doctype-public="-//W3C//DTD XHTML 1.1//EN" 
  doctype-system="http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"/>
---

          to:

---
<xsl:output method="xml" encoding="UTF-8" indent="no" />
---

          This is needed to be able to generate .opf and .ncx files not having
          a XHTML 1.1 doctype. Doing this does not prevent generated XHTML 1.1
          files from having XHTML 1.1 doctype (this is specified in
          chunker.xsl).

      [graphics.xsl] Attribute alt is required for elements such as img. So
          automatically generate something sensible for this attribute.

          in:

---
          <xsl:call-template name="process.image.attributes">
            <xsl:with-param name="alt">
              <xsl:choose>
              ...
---

          add:

---
                <xsl:otherwise>
                  <!-- alt is a required attribute -->
                  <xsl:call-template name="filename-basename">
                    <xsl:with-param name="filename" select="$output_filename"/>
                  </xsl:call-template>
                </xsl:otherwise>

              </xsl:choose>
            </xsl:with-param>
---
