DITA-OT Upgrade Process

Description of procedure for changing the DITA-OT version used by DITA-Word.

Periodically the DITA-OT is undated by the OASIA technical committee. These updates can be downloaded from http://sourceforge.net/projects/dita-ot. The DITA-OT installation procedure involves the un-zipping of files and directories, located in a downloaded ZIP file, into a computers drive-root directory.

Download the new version from http://sourceforge.net/projects/dita-ot. Un-Zip the DITA-OT folder into the drive root directory. Copy the subject folder for the older version DITA-OT into the new one just un-zipped.

Copy the following ant build files from the ant directory in the older DITA-OT directory to the ant directory in the new DITA-OT directory:

Copy the following xsl transformation file from the xsl directory in the older DITA-OT directory to the xsl directory in the new DITA-OT directory:

Add the following two targets to the build_dita2xhtml.xml (no longer in conductor.xml) file

  <!-- new DITA-Word aspx deliverables --> 
  <target name="dita2aspx" depends="dita-preprocess,  map2aspx">  
      <antcall target="dita.topics.aspx"></antcall>
  </target>
  <target name="map2aspx" unless="noMap">
      <antcall target="dita.map.aspx"></antcall></target>

Add the following two targets to the ditatargets.xml file

    <!-- aspx output for DITA-Word -->
    <target name="dita.topics.aspx" description="Build aspx output from dita topics">
        <condition property="out.ext" value=".html">
            <>
                <isset property="out.ext"/>
            </not>
        </condition>
        <condition property="args.xsl" value="${dita.script.dir}${file.separator}dita2xhtml.xsl">
            <>
                <isset property="args.xsl"/>
            </not>
        </condition>
        <xslt processor="trax"
            basedir="${dita.temp.dir}"
            destdir="${output.dir}"
            includes="${fullditatopiclist}"
            extension="${out.ext}"
            style="${args.xsl}">
            <param name="DITAEXT" expression="${dita.ext}" if="dita.ext"/>
            <param name="FILTERFILE" expression="${dita.input.valfile}" if="dita.input.valfile"/>
            <param name="CSS" expression="${args.css.file}" if="args.css.file"/>
            <param name="CSSPATH" expression="${user.csspath}" if="user.csspath"/>
            <param name="HDF" expression="${args.hdf}" if="args.hdf"/>
            <param name="HDR" expression="${args.hdr}" if="args.hdr"/>
            <param name="FTR" expression="${args.ftr}" if="args.ftr"/>
            <param name="DRAFT" expression="${args.draft}" if="args.draft"/>
            <param name="ARTLBL" expression="${args.artlbl}" if="args.artlbl"/>
            <param name="INDEXSHOW" expression="${args.indexshow}" if="args.indexshow"/>
            <param name="OUTEXT" expression="${out.ext}" if="out.ext"/>
        </xslt>
        <antcall target="copy-css"/>
    </target><target name="dita.map.aspx" description="Build aspx file from ditamap">
    <condition property="out.ext" value=".aspx">
        <>
            <isset property="out.ext"/>
        </not>
    </condition>
    <condition property="args.aspx.toc" value="default">
        <>
            <isset property="args.aspx.toc"/>
        </not>
    </condition>
    <xslt processor="trax"
        basedir="${dita.temp.dir}"
        destdir="${output.dir}"
        includes="${user.input.file}"
        style="${dita.script.dir}${file.separator}map2aspx.xsl">
        <param name="DITAEXT" expression="${dita.ext}" if="dita.ext"/>
        <param name="OUTEXT" expression="${out.ext}" if="out.ext"/>
        <mapper type="glob" from="*${dita.input.filename}" to="*${args.aspx.toc}.aspx"/>
    </xslt></target>
    <!-- end aspx output for DITA-Word -->

Change the registry key for the current distribution to the directory of the new version (i.e. c C:\DITA-OT1.3.1):

HKEY_CURRENT_USER\Software\PIDev\PI-DITA\Settings\DITA-OTDIR

Parent topic: DITA-Word