[oXygen-user] how to customize the docbook-to-epub ant script?

26 Sep 2011

      I am trying to customize the ant-build script for docbook epub so that
the customizations and the epub stylesheets are in my Windows user
directories rather than in the system directories. for example I want
to use the latest snapshot instead of the version which comes with
Oxygen. Namely:

my snapshot of docbook xsl:  I:\My Documents\1latest\docbook-xsl-snapshot
xml/xsl source to be here: I:\My Documents\My Dropbox\xml
build.xml file is currently here C:\Program Files (x86)\Oxygen XML
Editor 13\frameworks\docbook\xsl\epub\bin

Could I still use this build.xml file in modified form? In which
directory  would be the best place to put the build.xml file?

Should I copy the AddImagesContentOpf.xsl, copy.xsl, images.xsl,
removeImagesContentOpf.xsl into I:\My
Documents\1latest\docbook-xsl-snapshot\epub ?

If I kept the build.xml file in my project directory I:\My
Documents\My Dropbox\xml\ , which references would I need to fix? For
example, I see

<xmlcatalog>
        <catalogpath>
          <pathelement location="../../../catalog.xml"/>
        </catalogpath>
      </xmlcatalog>

in the build.xml file. I'm not sure where this catalog.xml file ought
to reside.

Finally in build.xml I see

    <xslt in="${xmlFile}" out="${xincluded-profiled.xml}"
style="../../profiling/profile.xsl"
      classpath="classpath">
      <!--OXYGEN PATCH for EXM-19733-->
      <xmlcatalog>
        <catalogpath>
          <pathelement location="../../../catalog.xml"/>
        </catalogpath>
      </xmlcatalog>
      <sysproperty key="org.apache.xerces.xni.parser.XMLParserConfiguration"
        value="org.apache.xerces.parsers.XIncludeParserConfiguration"/>
      <param name="profile.arch" expression="${profile.arch}"
if="profile.arch"/>
      <param name="profile.audience" expression="${profile.audience}"
if="profile.audience"/>
      <param name="profile.condition"
expression="${profile.condition}" if="profile.condition"/>
      <param name="profile.conformance"
expression="${profile.conformance}" if="profile.conformance"/>
      <param name="profile.lang" expression="${profile.lang}"
if="profile.lang"/>
      <param name="profile.os" expression="${profile.os}" if="profile.os"/>
      <param name="profile.revision" expression="${profile.revision}"
if="profile.revision"/>
      <param name="profile.revisionflag"
expression="${profile.revisionflag}" if="profile.revisionflag"/>
      <param name="profile.role" expression="${profile.role}"
if="profile.role"/>
      <param name="profile.security" expression="${profile.security}"
if="profile.security"/>
      <param name="profile.status" expression="${profile.status}"
if="profile.status"/>
      <param name="profile.userlevel"
expression="${profile.userlevel}" if="profile.userlevel"/>
      <param name="profile.vendor" expression="${profile.vendor}"
if="profile.vendor"/>
      <param name="profile.wordsize" expression="${profile.wordsize}"
if="profile.wordsize"/>
      <param name="profile.attribute"
expression="${profile.attribute}" if="profile.attribute"/>
      <param name="profile.value" expression="${profile.value}"
if="profile.value"/>
    </xslt>

I'm not sure what this is supposed to do. Isn't this stuff I can
already  control from my docbook xsl customization layer? Why is it
mentioned here?

Thanks for your help.

-- 
Robert Nagle
6121 Winsome Ln #56C, Houston TX 77057-5581
(H) 713 893 3424/ (W) 832-251-7522 Carbon Neutral Since Jan 2010
http://www.robertnagle.info