Diff for DITA 1.2 Specification - Building Specification Subsets

Tue, 2010-11-16 12:30 by StanDohertySat, 2010-11-27 22:38 by StanDoherty
< previous diffnext diff >
Changes to Body
Line 31Line 31
 
<li>PDF (Idiom) transformation</li>
 
<li>PDF (Idiom) transformation</li>
 
<li>XHTML transformation</li>
 
<li>XHTML transformation</li>
-
</ul>
  
-
</li>
  
-
<li>DITA for Publishers (D4P Version 0.9.10 available at http://sourceforge.net/projects/dita4publishers/)
  
-
<ul>
  
-
<li>ePub transformation</li>
  
-
<li>Kindle transformation</li>
  
 
</ul>
 
</ul>
 
</li>
 
</li>
Line 44Line 38
 
<p>
 
<p>
 
To set up a default build environment, do the following.
 
To set up a default build environment, do the following.
-
</p>
  
-
<p>
  
-
&nbsp;
  
 
</p>
 
</p>
 
<ol>
 
<ol>
 
<li>Download and install the most current version of the DITA Open Toolkit.
 
<li>Download and install the most current version of the DITA Open Toolkit.
 
<p>
 
<p>
-
For purposes of illustration, let's assume that you have installed the toolkit in a folder named DITA-OT1.5.2.
+
http://sourceforge.net/projects/dita-ot/
  +
</p>
  +
<p>
  +
For purposes of illustration, let's assume that you have installed the toolkit with its default folder name DITA-OT1.5.2.
  +
</p>
  +
<p>
  +
REMINDER: Execute the command 'ant -f integrator.xml' before attempting to build any DITA specification subsets.
 
</p>
 
</p>
 
</li>
 
</li>
-
<li>Download the DITA Version 1.2 specification sourec files from the following site.
+
<li>Download the DITA Version 1.2 specification source files from the following site.
 
<p>
 
<p>
 
http://docs.oasis-open.org/dita/v1.2/cs01/spec/DITA1.2-spec.zip
 
http://docs.oasis-open.org/dita/v1.2/cs01/spec/DITA1.2-spec.zip
Line 61Line 58
 
<li>Unarchive these source files to a new folder at the root of the DITA Open Toolkit that you just installed.
 
<li>Unarchive these source files to a new folder at the root of the DITA Open Toolkit that you just installed.
 
<p>
 
<p>
-
For example, create a folder named DITA-OT1.5.2\dita1.2 and extract the source file to it.
+
For purposes of illustration, let's assume that you unarchive the sources into a folder named DITA-OT1.5.2\dita1.2.
 
</p>
 
</p>
-
</li>
+
<p>
-
<li>Write one or more build scripts (typically ant) for specific transform types and specific specification subset maps.
+
Once unarchived, that folder would contain the following:
  +
</p>
  +
/archSpec<br />
  +
/common<br />
  +
/introduction<br />
  +
/langref<br />
  +
/non-normative<br />
  +
/resources<br />
  +
architectural-specification.ditamap<br />
  +
architectural_specification.dita<br />
  +
archSpec-base.dita<br />
  +
archSpec-learningTraining.dita<br />
  +
archSpec-technicalContent.dita<br />
  +
base_elements.ditamap<br />
  +
conformance.dita<br />
  +
dita-1.2-specification.ditamap<br />
  +
DITA1.2-spec.zip<br />
  +
ditaref-commonatts.ditamap<br />
  +
ditaref-ditaval.ditamap<br />
  +
element-quick-reference.dita<br />
  +
introduction.ditamap<br />
  +
langRef-base.dita<br />
  +
langRef-learningTraining.dita<br />
  +
langRef-technicalContent.dita<br />
  +
language-reference.ditamap<br />
  +
language_reference.dita<br />
  +
learningTraining_elements.ditamap<br />
  +
non-normative-information.ditamap<br />
  +
r-acknowledgments.dita<br />
  +
technicalContent_elements.ditamap</li>
  +
<li>Copy one or more of the ant build scripts documented below into this same DITA-OT1.5.2/dita1.2 folder.</li>
  +
<li>Edit (uncomment) these ant scripts to specify which DITA 1.2 Specification map you woudl like to build as a subset.
 
<ul>
 
<ul>
 
<li>Introduction (introduction.ditamap)</li>
 
<li>Introduction (introduction.ditamap)</li>
Line 72Line 100
 
<li>Non-normative Information (non-normative-information.ditamap)</li>
 
<li>Non-normative Information (non-normative-information.ditamap)</li>
 
</ul>
 
</ul>
  +
</li>
  +
<li>
  +
</li>
  +
<li>Run the ant build script from the DITA-OT1.5.2/dita1.2 directory.
 
<p>
 
<p>
-
Modeling these build scripts on the ones in DITA-OT1.5.2\samples\ant_sample is a good starting place.
+
For example, 'ant -f ant_dita1.2_subset_pdf2.xml'.
 
</p>
 
</p>
 
</li>
 
</li>
-
<li>Run the build scripts.</li>
+
<li>Review build output in DITA-OT1.5.2/dita1.2/out/*.</li>
 
</ol>
 
</ol>
-
  
 
<h2>Basic Build Results and Notes</h2>
 
<h2>Basic Build Results and Notes</h2>
 
<hr />
 
<hr />
Line 88Line 119
 
<tr>
 
<tr>
 
<td>Specification Subet Map/Topic</td>
 
<td>Specification Subet Map/Topic</td>
  +
<td>EclipseHelp</td>
 
<td>MS HTMLHelp</td>
 
<td>MS HTMLHelp</td>
 
<td>Open Office</td>
 
<td>Open Office</td>
 
<td>PDF</td>
 
<td>PDF</td>
  +
<td>TOCJS</td>
 
<td>XHTML</td>
 
<td>XHTML</td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
 
<td>introduction.ditamap</td>
 
<td>introduction.ditamap</td>
  +
<td>Successful</td>
  +
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
Line 102Line 137
 
<tr>
 
<tr>
 
<td>architectural-specification.ditamap</td>
 
<td>architectural-specification.ditamap</td>
  +
<td>Successful</td>
  +
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
Line 111Line 148
 
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
  +
<td>Successful</td>
  +
<td>Not supported. [1]</td>
 
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
Line 116Line 155
 
<tr>
 
<tr>
 
<td>conformance.dita</td>
 
<td>conformance.dita</td>
  +
<td>Successful</td>
  +
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
Line 123Line 164
 
<tr>
 
<tr>
 
<td>non-normative-information.ditamap</td>
 
<td>non-normative-information.ditamap</td>
  +
<td>Successful</td>
  +
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
 
<td>Successful</td>
Line 132Line 175
 
<h3>Notes and limitations</h3>
 
<h3>Notes and limitations</h3>
 
<ul>
 
<ul>
-
<li>Note-1: Java memory</li>
+
<li>[1] The DITA 1.2 Specification Language Reference makes extensive use of keyrefs and conrefs. The default fo-to-PDF processor in the DITA Open Toolkit runs out of memory when attempting to build the Language Reference subset. If you have purchased a commercial processor such as XEP or Antenna House, you can build a PDF for Language Reference.
  +
<p>
  +
When Java runs out of memory while building this subset, you will see the following error message.
  +
</p>
  +
BUILD FAILED<br />
  +
F:\DITA-OT1.5.2_m7\dita1.2\ant_dita1.2_subset_pdf2.xml:6: The following error oc<br />
  +
curred while executing this line:<br />
  +
F:\DITA-OT1.5.2_m6\build.xml:64: The following error occurred while executing th<br />
  +
is line:<br />
  +
F:\DITA-OT1.5.2_m6\build.xml:134: java.lang.OutOfMemoryError: Java heap space</li>
 
<li>Note-2: TBD</li>
 
<li>Note-2: TBD</li>
 
<li>Note-3: TBD</li>
 
<li>Note-3: TBD</li>
 
<li>Note-4: TBD</li>
 
<li>Note-4: TBD</li>
 
</ul>
 
</ul>
-
<h2>Generating Specification Subsets for ePub and Kindle</h2>
+
<h2>DITA-OT Transformations and ANT Build Scripts</h2>
 
<hr />
 
<hr />
 
<p>
 
<p>
-
Incremental requirements:
+
This section documents provides ANT build scripts that you an copy/paste into your DITA-OT1.5.2/dita1.2 folder in order to build DITA 1.2 Specification subsets for the following standard DITA-OT transformations:
 
</p>
 
</p>
 
<ul>
 
<ul>
-
<li>ePub Plugin . . . </li>
+
<li>Specification Subet Map/Topic</li>
-
<li>kindlegarden . . . </li>
+
<li>EclipseHelp</li>
  +
<li>MS HTMLHelp</li>
  +
<li>Open Office</li>
  +
<li>PDF</li>
  +
<li>TOCJS</li>
  +
<li>XHTML</li>
 
</ul>
 
</ul>
-
<table border="0">
+
<h3>Specifying DITA 1.2 Specification Map in ANT Scripts</h3>
-
<tbody>
+
<p>
-
<tr>
+
Each of the following ANT scripts contains the following lines (or minor variation of them):
-
<td>Specification Subet Map/Topic</td>
+
</p>
-
<td>ePub</td>
+
&lt;!-- //////////////////////////////////////////////////// --&gt;<br />
-
<td>Kindle</td>
+
&lt;!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER --&gt;<br />
-
</tr>
+
&lt;!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. --&gt;<br />
-
<tr>
+
&lt;!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS --&gt;<br />
-
<td>introduction.ditamap</td>
+
&lt;!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. --&gt;<br />
-
<td>Successful</td>
+
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;introduction.ditamap&quot;/&gt; --&gt;<br />
-
<td>Successful</td>
+
&lt;property name=&quot;args.input&quot; value=&quot;architectural-specification.ditamap&quot;/&gt;<br />
-
</tr>
+
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;language-reference.ditamap&quot;/&gt; --&gt;<br />
-
<tr>
+
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;conformance.dita&quot;/&gt; --&gt;<br />
-
<td>architectural-specification.ditamap</td>
+
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;r-acknowledgments.dita&quot;/&gt; --&gt;<br />
-
<td>Successful</td>
+
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;non-normative-information.ditamap&quot;/&gt; --&gt;<br />
-
<td>Successful</td>
+
<p>
-
</tr>
+
To build different subsets of the specification, uncomment or re-comment the lines that call specific DITA maps. For example, in the above sample, teh DITA map for the DITA Architectural Specification (architectural-specification.ditamap) is uncommented and will build when you run an ANT script with these lines.
-
<tr>
+
</p>
-
<td>language-reference.ditamap</td>
+
<h3>Building EclipseHelp</h3>
-
<td>Successful</td>
+
<p>
-
<td>Successful</td>
+
To build one or more DITA 1.2 Specification subsets for EclipseHelp, copy the following text into a file named ant_dita1.2_subset_eclipsehelp.xml and save that file to the DITA-OT1.5.2/dita1.2 directory.
-
</tr>
+
</p>
-
<tr>
+
<p>
-
<td>conformance.dita</td>
+
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; ?&gt;<br />
-
<td>Successful</td>
+
&lt;project name=&quot;sample_eclipsehelp&quot; default=&quot;sample2eclipsehelp&quot; basedir=&quot;.&quot;&gt;<br />
-
<td>Successful</td>
+
&lt;property name=&quot;dita.dir&quot; value=&quot;${basedir}${file.separator}..${file.separator}..${file.separator}DITA-OT1.5.2_m6&quot;/&gt;<br />
-
</tr>
+
&lt;import file=&quot;${dita.dir}${file.separator}integrator.xml&quot;/&gt;<br />
-
<tr>
+
&lt;target name=&quot;sample2eclipsehelp&quot; depends=&quot;integrate&quot;&gt;<br />
-
<td>non-normative-information.ditamap</td>
+
&lt;ant antfile=&quot;${dita.dir}${file.separator}build.xml&quot; target=&quot;init&quot;&gt;<br />
-
<td>Successful</td>
+
&lt;!-- //////////////////////////////////////////////////// --&gt;<br />
-
<td>Successful</td>
+
&lt;!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER --&gt;<br />
-
</tr>
+
&lt;!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. --&gt;<br />
-
</tbody>
+
&lt;!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS --&gt;<br />
-
</table>
+
&lt;!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. --&gt;<br />
-
<h2>Advanced Configurations</h2>
+
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;introduction.ditamap&quot;/&gt; --&gt;<br />
-
<hr />
+
&lt;property name=&quot;args.input&quot; value=&quot;architectural-specification.ditamap&quot;/&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;language-reference.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;conformance.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;r-acknowledgments.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;non-normative-information.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;property name=&quot;output.dir&quot;
  +
value=&quot;out${file.separator}eclipsehelp&quot;/&gt;<br />
  +
&lt;property name=&quot;transtype&quot; value=&quot;eclipsehelp&quot;/&gt;<br />
  +
&lt;/ant&gt;<br />
  +
&lt;/target&gt;<br />
  +
&lt;/project&gt;<br />
  +
</p>
  +
<p>
  +
CD to the DITA-OT1.5.2/dita1.2 subdirectory and run the following command.
  +
</p>
  +
$ ant -f ant_dita1.2_subset_eclipsehelp.xml
  +
<p>
  +
Review build output in DITA-OT1.5.2/dita1.2/out/eclipsehelp.
  +
</p>
  +
<h3>Building Microsoft HTMLHelp</h3>
  +
<p>
  +
To build one or more DITA 1.2 Specification subsets for Microsoft HTMLHelp, copy the following text into a file named ant_dita1.2_subset_htmlhelp.xml and save that file to the DITA-OT1.5.2/dita1.2 directory.
  +
</p>
  +
<p>
  +
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; ?&gt;<br />
  +
&lt;project name=&quot;dita1.2_subsets_htmlhelp&quot; default=&quot;sample2htmlhelp&quot; basedir=&quot;.&quot;&gt;<br />
  +
&lt;property name=&quot;dita.dir&quot; value=&quot;${basedir}${file.separator}..${file.separator}..${file.separator}DITA-OT1.5.2_m6&quot;/&gt;<br />
  +
&lt;import file=&quot;${dita.dir}${file.separator}integrator.xml&quot;/&gt;<br />
  +
&lt;target name=&quot;sample2htmlhelp&quot; depends=&quot;integrate&quot;&gt;<br />
  +
&lt;ant antfile=&quot;${dita.dir}${file.separator}build.xml&quot; target=&quot;init&quot;&gt;<br />
  +
&lt;!-- //////////////////////////////////////////////////// --&gt;<br />
  +
&lt;!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER --&gt;<br />
  +
&lt;!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. --&gt;<br />
  +
&lt;!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS --&gt;<br />
  +
&lt;!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;introduction.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;property name=&quot;args.input&quot; value=&quot;architectural-specification.ditamap&quot;/&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;language-reference.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;conformance.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;r-acknowledgments.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;non-normative-information.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;property name=&quot;output.dir&quot; value=&quot;out${file.separator}htmlhelp&quot;/&gt;<br />
  +
&lt;property name=&quot;transtype&quot; value=&quot;htmlhelp&quot;/&gt;<br />
  +
&lt;/ant&gt;<br />
  +
&lt;/target&gt;<br />
  +
&lt;/project&gt;<br />
  +
</p>
  +
<p>
  +
CD to the DITA-OT1.5.2/dita1.2 subdirectory and run the following command.
  +
</p>
  +
$ ant -f ant_dita1.2_subset_htmlhelp.xml
  +
<p>
  +
Review build output (*.chm) in DITA-OT1.5.2/dita1.2/out/htmlhelp.
  +
</p>
  +
<h3>Building Open Office</h3>
  +
<p>
  +
To build one or more DITA 1.2 Specification subsets for Open Office (ODT), copy the following text into a file named ant_dita1.2_subset_odt.xml and save that file to the DITA-OT1.5.2/dita1.2 directory.
  +
</p>
  +
<p>
  +
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; ?&gt;<br />
  +
&lt;project name=&quot;sample_odt&quot; default=&quot;sample2odt&quot; basedir=&quot;.&quot;&gt;<br />
  +
&lt;property name=&quot;dita.dir&quot; value=&quot;${basedir}${file.separator}..${file.separator}..${file.separator}DITA-OT1.5.2_m6&quot;/&gt;<br />
  +
&lt;import file=&quot;${dita.dir}${file.separator}integrator.xml&quot;/&gt;<br />
  +
&lt;target name=&quot;sample2odt&quot; depends=&quot;integrate&quot;&gt;<br />
  +
&lt;ant antfile=&quot;${dita.dir}${file.separator}build.xml&quot; target=&quot;init&quot;&gt;<br />
  +
&lt;!-- //////////////////////////////////////////////////// --&gt;<br />
  +
&lt;!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER --&gt;<br />
  +
&lt;!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. --&gt;<br />
  +
&lt;!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS --&gt;<br />
  +
&lt;!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;introduction.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;property name=&quot;args.input&quot; value=&quot;architectural-specification.ditamap&quot;/&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;language-reference.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;conformance.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;r-acknowledgments.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;non-normative-information.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;property name=&quot;output.dir&quot; value=&quot;out${file.separator}odt&quot;/&gt;<br />
  +
&lt;property name=&quot;transtype&quot; value=&quot;odt&quot;/&gt;<br />
  +
&lt;property name=&quot;outer.control&quot; value=&quot;quiet&quot;/&gt;<br />
  +
&lt;/ant&gt;<br />
  +
&lt;/target&gt;<br />
  +
&lt;/project&gt;<br />
  +
</p>
  +
<p>
  +
CD to the DITA-OT1.5.2/dita1.2 subdirectory and run the following command.
  +
</p>
  +
$ ant -f ant_dita1.2_subset_odt.xml
  +
<p>
  +
Review build output in DITA-OT1.5.2/dita1.2/out/odt.
  +
</p>
  +
<h3>Building PDF</h3>
  +
<p>
  +
To build one or more DITA 1.2 Specification subsets for PDF, copy the following text into a file named ant_dita1.2_subset_pdf2.xml and save that file to the DITA-OT1.5.2/dita1.2 directory.
  +
</p>
  +
<p>
  +
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; ?&gt;<br />
  +
&lt;project name=&quot;dita1.2_subsets_pdf&quot; default=&quot;sample2pdf2&quot; basedir=&quot;.&quot;&gt;<br />
  +
&lt;property name=&quot;dita.dir&quot; value=&quot;${basedir}${file.separator}..${file.separator}..${file.separator}DITA-OT1.5.2_m6&quot;/&gt;<br />
  +
&lt;import file=&quot;${dita.dir}${file.separator}integrator.xml&quot;/&gt;<br />
  +
&lt;target name=&quot;sample2pdf2&quot; depends=&quot;integrate&quot;&gt;<br />
  +
&lt;ant antfile=&quot;${dita.dir}${file.separator}build.xml&quot; target=&quot;init&quot;&gt;<br />
  +
&lt;!-- //////////////////////////////////////////////////// --&gt;<br />
  +
&lt;!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER --&gt;<br />
  +
&lt;!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. --&gt;<br />
  +
&lt;!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS --&gt;<br />
  +
&lt;!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;introduction.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;property name=&quot;args.input&quot; value=&quot;architectural-specification.ditamap&quot;/&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;language-reference.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;conformance.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;r-acknowledgments.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;non-normative-information.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;property name=&quot;output.dir&quot; value=&quot;out${file.separator}pdf2&quot;/&gt;<br />
  +
&lt;property name=&quot;transtype&quot; value=&quot;pdf2&quot;/&gt;<br />
  +
&lt;property name=&quot;outer.control&quot; value=&quot;quiet&quot;/&gt;<br />
  +
&lt;/ant&gt;<br />
  +
&lt;/target&gt;<br />
  +
&lt;/project&gt;<br />
  +
</p>
  +
<p>
  +
CD to the DITA-OT1.5.2/dita1.2 subdirectory and run the following command.
  +
</p>
  +
$ ant -f ant_dita1.2_subset_pdf2.xml
  +
<p>
  +
Review build output in DITA-OT1.5.2/dita1.2/out/pdf2.
  +
</p>
  +
<h3>Building TOCJS</h3>
  +
<p>
  +
To build one or more DITA 1.2 Specification subsets for TOCJS, copy the following text into a file named ant_dita1.2_subset_tocjs.xml and save that file to the DITA-OT1.5.2/dita1.2 directory.
  +
</p>
  +
<p>
  +
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; ?&gt;<br />
  +
&lt;project name=&quot;docondoc&quot; default=&quot;all&quot;&gt;<br />
  +
&lt;import file=&quot;..${file.separator}conductor.xml&quot;/&gt;<br />
  +
&lt;property name=&quot;dita.extname&quot; value=&quot;.xml&quot;/&gt;<br />
  +
&lt;property name=&quot;content.frame&quot; value=&quot;contentwin&quot;/&gt;<br />
  +
&lt;target name=&quot;sample2html&quot; depends=&quot;use-init&quot;&gt;<br />
  +
&lt;antcall target=&quot;dita2xhtml&quot;&gt;<br />
  +
&lt;!-- //////////////////////////////////////////////////// --&gt;<br />
  +
&lt;!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER --&gt;<br />
  +
&lt;!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. --&gt;<br />
  +
&lt;!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS --&gt;<br />
  +
&lt;!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. --&gt;<br />
  +
&lt;!-- &lt;param name=&quot;args.input&quot; value=&quot;introduction.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;param name=&quot;args.input&quot; value=&quot;architectural-specification.ditamap&quot;/&gt;<br />
  +
&lt;!-- &lt;param name=&quot;args.input&quot; value=&quot;language-reference.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;param name=&quot;args.input&quot; value=&quot;conformance.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;param name=&quot;args.input&quot; value=&quot;r-acknowledgments.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;param name=&quot;args.input&quot; value=&quot;non-normative-information.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;param name=&quot;output.dir&quot; value=&quot;out${file.separator}tocjs&quot;/&gt;<br />
  +
&lt;param name=&quot;args.css&quot; value=&quot;..${file.separator}demo${file.separator}tocjs${file.separator}sample${file.separator}basefiles${file.separator}sample.css&quot;/&gt;<br />
  +
&lt;param name=&quot;args.copycss&quot; value=&quot;yes&quot;/&gt;<br />
  +
&lt;/antcall&gt;<br />
  +
&lt;copy overwrite=&quot;true&quot; file=&quot;..${file.separator}demo${file.separator}tocjs${file.separator}sample${file.separator}basefiles${file.separator}frameset.html&quot;
  +
tofile=&quot;out${file.separator}tocjs${file.separator}frameset.html&quot;/&gt;<br />
  +
&lt;/target&gt;<br />
  +
&lt;target name=&quot;sample2tocjs&quot; description=&quot;Generate tocjs javascript file&quot; depends=&quot;sample2html&quot;&gt;<br />
  +
&lt;antcall target=&quot;dita2tocjs&quot;&gt;<br />
  +
&lt;param name=&quot;transtype&quot; value=&quot;tocjs&quot;/&gt;<br />
  +
&lt;!-- //////////////////////////////////////////////////// --&gt;<br />
  +
&lt;!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER --&gt;<br />
  +
&lt;!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. --&gt;<br />
  +
&lt;!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS --&gt;<br />
  +
&lt;!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. --&gt;<br />
  +
&lt;!-- &lt;param name=&quot;args.input&quot; value=&quot;introduction.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;param name=&quot;args.input&quot; value=&quot;architectural-specification.ditamap&quot;/&gt;<br />
  +
&lt;!-- &lt;param name=&quot;args.input&quot; value=&quot;language-reference.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;param name=&quot;args.input&quot; value=&quot;conformance.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;param name=&quot;args.input&quot; value=&quot;r-acknowledgments.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;param name=&quot;args.input&quot; value=&quot;non-normative-information.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;param name=&quot;output.file&quot;
  +
value=&quot;out${file.separator}tocjs${file.separator}toctree.js&quot;/&gt;<br />
  +
&lt;/antcall&gt;<br />
  +
&lt;copy todir=&quot;out${file.separator}tocjs&quot;&gt;<br />
  +
&lt;fileset
  +
dir=&quot;${dita.dir}${file.separator}demo${file.separator}tocjs${file.separator}basefiles&quot;&gt;<br />
  +
&lt;include name=&quot;**/*&quot;/&gt;<br />
  +
&lt;/fileset&gt;<br />
  +
&lt;/copy&gt;<br />
  +
&lt;/target&gt;<br />
  +
&lt;target name=&quot;sampleclean&quot; description=&quot;clean tocjs sample output&quot;&gt;<br />
  +
&lt;delete dir=&quot;${dita.dir}${file.separator}demo${file.separator}tocjs${file.separator}out&quot;/&gt;<br />
  +
&lt;/target&gt;<br />
  +
&lt;/project&gt;<br />
  +
</p>
  +
<p>
  +
CD to the DITA-OT1.5.2/dita1.2 subdirectory and run the following command.
  +
</p>
  +
$ ant -f ant_dita1.2_subset_tocjs.xml
  +
<p>
  +
Review build output (frameset.html) in DITA-OT1.5.2/dita1.2/out/tocjs.
  +
</p>
  +
<h3>Building XHTML</h3>
  +
<p>
  +
To build one or more DITA 1.2 Specification subsets for XHTML, copy the following text into a file named ant_dita1.2_subset_xhtml.xml and save that file to the DITA-OT1.5.2/dita1.2 directory.
  +
</p>
 
<p>
 
<p>
-
See &quot;Configuring your build environment to generate OASIS-styled PDFs&quot;.
+
&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; ?&gt;<br />
  +
&lt;project name=&quot;sample_xhtml&quot; default=&quot;sample2xhtml&quot; basedir=&quot;.&quot;&gt;<br />
  +
&lt;property name=&quot;dita.dir&quot; value=&quot;${basedir}${file.separator}..${file.separator}..${file.separator}DITA-OT1.5.2_m6&quot;/&gt;<br />
  +
&lt;import file=&quot;${dita.dir}${file.separator}integrator.xml&quot;/&gt;<br />
  +
&lt;target name=&quot;sample2xhtml&quot; depends=&quot;integrate&quot;&gt;<br />
  +
&lt;ant antfile=&quot;${dita.dir}${file.separator}build.xml&quot; target=&quot;init&quot;&gt;<br />
  +
&lt;!-- //////////////////////////////////////////////////// --&gt;<br />
  +
&lt;!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER --&gt;<br />
  +
&lt;!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. --&gt;<br />
  +
&lt;!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS --&gt;<br />
  +
&lt;!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;introduction.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;property name=&quot;args.input&quot; value=&quot;architectural-specification.ditamap&quot;/&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;language-reference.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;conformance.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;r-acknowledgments.dita&quot;/&gt; --&gt;<br />
  +
&lt;!-- &lt;property name=&quot;args.input&quot; value=&quot;non-normative-information.ditamap&quot;/&gt; --&gt;<br />
  +
&lt;property name=&quot;output.dir&quot; value=&quot;out${file.separator}xhtml&quot;/&gt;<br />
  +
&lt;property name=&quot;transtype&quot; value=&quot;xhtml&quot;/&gt;<br />
  +
&lt;property name=&quot;outer.control&quot; value=&quot;quiet&quot;/&gt;<br />
  +
&lt;/ant&gt;<br />
  +
&lt;/target&gt;<br />
  +
&lt;/project&gt;<br />
 
</p>
 
</p>
 
<p>
 
<p>
-
&nbsp;
+
CD to the DITA-OT1.5.2/dita1.2 subdirectory and run the following command.
 
</p>
 
</p>
  +
$ ant -f ant_dita1.2_subset_xhtml.xml
 
<p>
 
<p>
-
&nbsp;
+
Review build output (index.html) in DITA-OT1.5.2/dita1.2/out/xhtml.
 
</p>
 
</p>
 
<p>
 
<p>
Revision of Sat, 2010-11-27 22:38:

DITA 1.2 Specification - Building Specification Subsets

WORK IN PROGRESS

Background

OASIS (soon) has released Version 1.2 of the OASIS Darwin Information Typing Architecture (DITA) specification developed by the OASIS DITA Technical Committee. Complete, OASIS-branded versions of the spceification are available for you to download at the following site:

 

http://dita.xml.org/news/dita-12-submitted-for-oasis-ballot

In its complete form, this specification consists of the following separately buildable sections, each with its own DITA map:

  • Introduction (spec/introduction.ditamap)
  • Architectural Specification (architectural-specification.ditamap)
  • Language Reference Specification (language-reference.ditamap)
  • DITA Conformance Statement (conformance.dita)
  • Non-normative Information (non-normative-information.ditamap)

To build these specification subsets, you must install a build environment that is compliant with DITA Version 1.2 DTDs or schema. These DITA-compliant build environments are available as separate, downloadable packages or as components integrated with your DITA-compliant editor or content management system. For purposes of illustration, the build environment documented here consists of the following freely available, and uncustomized packages:

  • DITA Open Toolkit (DITA-OT1.5.2_m6 available at http://sourceforge.net/projects/dita-ot/)
    • MS HTMLHelp (.chm) transformation
    • OpenOffice Document (.odt) transformation
    • PDF (Idiom) transformation
    • XHTML transformation

Basic Build Procedure

To set up a default build environment, do the following.

  1. Download and install the most current version of the DITA Open Toolkit.

    http://sourceforge.net/projects/dita-ot/

    For purposes of illustration, let's assume that you have installed the toolkit with its default folder name DITA-OT1.5.2.

    REMINDER: Execute the command 'ant -f integrator.xml' before attempting to build any DITA specification subsets.

  2. Download the DITA Version 1.2 specification source files from the following site.

    http://docs.oasis-open.org/dita/v1.2/cs01/spec/DITA1.2-spec.zip

  3. Unarchive these source files to a new folder at the root of the DITA Open Toolkit that you just installed.

    For purposes of illustration, let's assume that you unarchive the sources into a folder named DITA-OT1.5.2\dita1.2.

    Once unarchived, that folder would contain the following:

    /archSpec
    /common
    /introduction
    /langref
    /non-normative
    /resources
    architectural-specification.ditamap
    architectural_specification.dita
    archSpec-base.dita
    archSpec-learningTraining.dita
    archSpec-technicalContent.dita
    base_elements.ditamap
    conformance.dita
    dita-1.2-specification.ditamap
    DITA1.2-spec.zip
    ditaref-commonatts.ditamap
    ditaref-ditaval.ditamap
    element-quick-reference.dita
    introduction.ditamap
    langRef-base.dita
    langRef-learningTraining.dita
    langRef-technicalContent.dita
    language-reference.ditamap
    language_reference.dita
    learningTraining_elements.ditamap
    non-normative-information.ditamap
    r-acknowledgments.dita
    technicalContent_elements.ditamap
  4. Copy one or more of the ant build scripts documented below into this same DITA-OT1.5.2/dita1.2 folder.
  5. Edit (uncomment) these ant scripts to specify which DITA 1.2 Specification map you woudl like to build as a subset.
    • Introduction (introduction.ditamap)
    • Architectural Specification (architectural-specification.ditamap)
    • Language Reference Specification (language-reference.ditamap)
    • DITA Conformance Statement (conformance.dita)
    • Non-normative Information (non-normative-information.ditamap)
  7. Run the ant build script from the DITA-OT1.5.2/dita1.2 directory.

    For example, 'ant -f ant_dita1.2_subset_pdf2.xml'.

  8. Review build output in DITA-OT1.5.2/dita1.2/out/*.

Basic Build Results and Notes

The DITA Version 1.2 specification is a great resource for learning about new features such as , , and many others. That said, the specification is a complex and not all specification subsets build with a default DITA-OT configuration.

Specification Subet Map/Topic EclipseHelp MS HTMLHelp Open Office PDF TOCJS XHTML
introduction.ditamap Successful Successful Successful Successful Successful Successful
architectural-specification.ditamap Successful Successful Successful Successful Successful Successful
language-reference.ditamap Successful Successful Successful Not supported. [1] Successful Successful
conformance.dita Successful Successful Successful Successful Successful Successful
non-normative-information.ditamap Successful Successful Successful Successful Successful Successful

Notes and limitations

  • [1] The DITA 1.2 Specification Language Reference makes extensive use of keyrefs and conrefs. The default fo-to-PDF processor in the DITA Open Toolkit runs out of memory when attempting to build the Language Reference subset. If you have purchased a commercial processor such as XEP or Antenna House, you can build a PDF for Language Reference.

    When Java runs out of memory while building this subset, you will see the following error message.

    BUILD FAILED
    F:\DITA-OT1.5.2_m7\dita1.2\ant_dita1.2_subset_pdf2.xml:6: The following error oc
    curred while executing this line:
    F:\DITA-OT1.5.2_m6\build.xml:64: The following error occurred while executing th
    is line:
    F:\DITA-OT1.5.2_m6\build.xml:134: java.lang.OutOfMemoryError: Java heap space
  • Note-2: TBD
  • Note-3: TBD
  • Note-4: TBD

DITA-OT Transformations and ANT Build Scripts

This section documents provides ANT build scripts that you an copy/paste into your DITA-OT1.5.2/dita1.2 folder in order to build DITA 1.2 Specification subsets for the following standard DITA-OT transformations:

  • Specification Subet Map/Topic
  • EclipseHelp
  • MS HTMLHelp
  • Open Office
  • PDF
  • TOCJS
  • XHTML

Specifying DITA 1.2 Specification Map in ANT Scripts

Each of the following ANT scripts contains the following lines (or minor variation of them):

<!-- //////////////////////////////////////////////////// -->
<!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER -->
<!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. -->
<!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS -->
<!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. -->
<!-- <property name="args.input" value="introduction.ditamap"/> -->
<property name="args.input" value="architectural-specification.ditamap"/>
<!-- <property name="args.input" value="language-reference.ditamap"/> -->
<!-- <property name="args.input" value="conformance.dita"/> -->
<!-- <property name="args.input" value="r-acknowledgments.dita"/> -->
<!-- <property name="args.input" value="non-normative-information.ditamap"/> -->

To build different subsets of the specification, uncomment or re-comment the lines that call specific DITA maps. For example, in the above sample, teh DITA map for the DITA Architectural Specification (architectural-specification.ditamap) is uncommented and will build when you run an ANT script with these lines.

Building EclipseHelp

To build one or more DITA 1.2 Specification subsets for EclipseHelp, copy the following text into a file named ant_dita1.2_subset_eclipsehelp.xml and save that file to the DITA-OT1.5.2/dita1.2 directory.

<?xml version="1.0" encoding="UTF-8" ?>
<project name="sample_eclipsehelp" default="sample2eclipsehelp" basedir=".">
<property name="dita.dir" value="${basedir}${file.separator}..${file.separator}..${file.separator}DITA-OT1.5.2_m6"/>
<import file="${dita.dir}${file.separator}integrator.xml"/>
<target name="sample2eclipsehelp" depends="integrate">
<ant antfile="${dita.dir}${file.separator}build.xml" target="init">
<!-- //////////////////////////////////////////////////// -->
<!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER -->
<!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. -->
<!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS -->
<!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. -->
<!-- <property name="args.input" value="introduction.ditamap"/> -->
<property name="args.input" value="architectural-specification.ditamap"/>
<!-- <property name="args.input" value="language-reference.ditamap"/> -->
<!-- <property name="args.input" value="conformance.dita"/> -->
<!-- <property name="args.input" value="r-acknowledgments.dita"/> -->
<!-- <property name="args.input" value="non-normative-information.ditamap"/> -->
<property name="output.dir" value="out${file.separator}eclipsehelp"/>
<property name="transtype" value="eclipsehelp"/>
</ant>
</target>
</project>

CD to the DITA-OT1.5.2/dita1.2 subdirectory and run the following command.

$ ant -f ant_dita1.2_subset_eclipsehelp.xml

Review build output in DITA-OT1.5.2/dita1.2/out/eclipsehelp.

Building Microsoft HTMLHelp

To build one or more DITA 1.2 Specification subsets for Microsoft HTMLHelp, copy the following text into a file named ant_dita1.2_subset_htmlhelp.xml and save that file to the DITA-OT1.5.2/dita1.2 directory.

<?xml version="1.0" encoding="UTF-8" ?>
<project name="dita1.2_subsets_htmlhelp" default="sample2htmlhelp" basedir=".">
<property name="dita.dir" value="${basedir}${file.separator}..${file.separator}..${file.separator}DITA-OT1.5.2_m6"/>
<import file="${dita.dir}${file.separator}integrator.xml"/>
<target name="sample2htmlhelp" depends="integrate">
<ant antfile="${dita.dir}${file.separator}build.xml" target="init">
<!-- //////////////////////////////////////////////////// -->
<!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER -->
<!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. -->
<!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS -->
<!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. -->
<!-- <property name="args.input" value="introduction.ditamap"/> -->
<property name="args.input" value="architectural-specification.ditamap"/>
<!-- <property name="args.input" value="language-reference.ditamap"/> -->
<!-- <property name="args.input" value="conformance.dita"/> -->
<!-- <property name="args.input" value="r-acknowledgments.dita"/> -->
<!-- <property name="args.input" value="non-normative-information.ditamap"/> -->
<property name="output.dir" value="out${file.separator}htmlhelp"/>
<property name="transtype" value="htmlhelp"/>
</ant>
</target>
</project>

CD to the DITA-OT1.5.2/dita1.2 subdirectory and run the following command.

$ ant -f ant_dita1.2_subset_htmlhelp.xml

Review build output (*.chm) in DITA-OT1.5.2/dita1.2/out/htmlhelp.

Building Open Office

To build one or more DITA 1.2 Specification subsets for Open Office (ODT), copy the following text into a file named ant_dita1.2_subset_odt.xml and save that file to the DITA-OT1.5.2/dita1.2 directory.

<?xml version="1.0" encoding="UTF-8" ?>
<project name="sample_odt" default="sample2odt" basedir=".">
<property name="dita.dir" value="${basedir}${file.separator}..${file.separator}..${file.separator}DITA-OT1.5.2_m6"/>
<import file="${dita.dir}${file.separator}integrator.xml"/>
<target name="sample2odt" depends="integrate">
<ant antfile="${dita.dir}${file.separator}build.xml" target="init">
<!-- //////////////////////////////////////////////////// -->
<!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER -->
<!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. -->
<!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS -->
<!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. -->
<!-- <property name="args.input" value="introduction.ditamap"/> -->
<property name="args.input" value="architectural-specification.ditamap"/>
<!-- <property name="args.input" value="language-reference.ditamap"/> -->
<!-- <property name="args.input" value="conformance.dita"/> -->
<!-- <property name="args.input" value="r-acknowledgments.dita"/> -->
<!-- <property name="args.input" value="non-normative-information.ditamap"/> -->
<property name="output.dir" value="out${file.separator}odt"/>
<property name="transtype" value="odt"/>
<property name="outer.control" value="quiet"/>
</ant>
</target>
</project>

CD to the DITA-OT1.5.2/dita1.2 subdirectory and run the following command.

$ ant -f ant_dita1.2_subset_odt.xml

Review build output in DITA-OT1.5.2/dita1.2/out/odt.

Building PDF

To build one or more DITA 1.2 Specification subsets for PDF, copy the following text into a file named ant_dita1.2_subset_pdf2.xml and save that file to the DITA-OT1.5.2/dita1.2 directory.

<?xml version="1.0" encoding="UTF-8" ?>
<project name="dita1.2_subsets_pdf" default="sample2pdf2" basedir=".">
<property name="dita.dir" value="${basedir}${file.separator}..${file.separator}..${file.separator}DITA-OT1.5.2_m6"/>
<import file="${dita.dir}${file.separator}integrator.xml"/>
<target name="sample2pdf2" depends="integrate">
<ant antfile="${dita.dir}${file.separator}build.xml" target="init">
<!-- //////////////////////////////////////////////////// -->
<!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER -->
<!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. -->
<!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS -->
<!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. -->
<!-- <property name="args.input" value="introduction.ditamap"/> -->
<property name="args.input" value="architectural-specification.ditamap"/>
<!-- <property name="args.input" value="language-reference.ditamap"/> -->
<!-- <property name="args.input" value="conformance.dita"/> -->
<!-- <property name="args.input" value="r-acknowledgments.dita"/> -->
<!-- <property name="args.input" value="non-normative-information.ditamap"/> -->
<property name="output.dir" value="out${file.separator}pdf2"/>
<property name="transtype" value="pdf2"/>
<property name="outer.control" value="quiet"/>
</ant>
</target>
</project>

CD to the DITA-OT1.5.2/dita1.2 subdirectory and run the following command.

$ ant -f ant_dita1.2_subset_pdf2.xml

Review build output in DITA-OT1.5.2/dita1.2/out/pdf2.

Building TOCJS

To build one or more DITA 1.2 Specification subsets for TOCJS, copy the following text into a file named ant_dita1.2_subset_tocjs.xml and save that file to the DITA-OT1.5.2/dita1.2 directory.

<?xml version="1.0" encoding="UTF-8" ?>
<project name="docondoc" default="all">
<import file="..${file.separator}conductor.xml"/>
<property name="dita.extname" value=".xml"/>
<property name="content.frame" value="contentwin"/>
<target name="sample2html" depends="use-init">
<antcall target="dita2xhtml">
<!-- //////////////////////////////////////////////////// -->
<!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER -->
<!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. -->
<!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS -->
<!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. -->
<!-- <param name="args.input" value="introduction.ditamap"/> -->
<param name="args.input" value="architectural-specification.ditamap"/>
<!-- <param name="args.input" value="language-reference.ditamap"/> -->
<!-- <param name="args.input" value="conformance.dita"/> -->
<!-- <param name="args.input" value="r-acknowledgments.dita"/> -->
<!-- <param name="args.input" value="non-normative-information.ditamap"/> -->
<param name="output.dir" value="out${file.separator}tocjs"/>
<param name="args.css" value="..${file.separator}demo${file.separator}tocjs${file.separator}sample${file.separator}basefiles${file.separator}sample.css"/>
<param name="args.copycss" value="yes"/>
</antcall>
<copy overwrite="true" file="..${file.separator}demo${file.separator}tocjs${file.separator}sample${file.separator}basefiles${file.separator}frameset.html" tofile="out${file.separator}tocjs${file.separator}frameset.html"/>
</target>
<target name="sample2tocjs" description="Generate tocjs javascript file" depends="sample2html">
<antcall target="dita2tocjs">
<param name="transtype" value="tocjs"/>
<!-- //////////////////////////////////////////////////// -->
<!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER -->
<!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. -->
<!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS -->
<!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. -->
<!-- <param name="args.input" value="introduction.ditamap"/> -->
<param name="args.input" value="architectural-specification.ditamap"/>
<!-- <param name="args.input" value="language-reference.ditamap"/> -->
<!-- <param name="args.input" value="conformance.dita"/> -->
<!-- <param name="args.input" value="r-acknowledgments.dita"/> -->
<!-- <param name="args.input" value="non-normative-information.ditamap"/> -->
<param name="output.file" value="out${file.separator}tocjs${file.separator}toctree.js"/>
</antcall>
<copy todir="out${file.separator}tocjs">
<fileset dir="${dita.dir}${file.separator}demo${file.separator}tocjs${file.separator}basefiles">
<include name="**/*"/>
</fileset>
</copy>
</target>
<target name="sampleclean" description="clean tocjs sample output">
<delete dir="${dita.dir}${file.separator}demo${file.separator}tocjs${file.separator}out"/>
</target>
</project>

CD to the DITA-OT1.5.2/dita1.2 subdirectory and run the following command.

$ ant -f ant_dita1.2_subset_tocjs.xml

Review build output (frameset.html) in DITA-OT1.5.2/dita1.2/out/tocjs.

Building XHTML

To build one or more DITA 1.2 Specification subsets for XHTML, copy the following text into a file named ant_dita1.2_subset_xhtml.xml and save that file to the DITA-OT1.5.2/dita1.2 directory.

<?xml version="1.0" encoding="UTF-8" ?>
<project name="sample_xhtml" default="sample2xhtml" basedir=".">
<property name="dita.dir" value="${basedir}${file.separator}..${file.separator}..${file.separator}DITA-OT1.5.2_m6"/>
<import file="${dita.dir}${file.separator}integrator.xml"/>
<target name="sample2xhtml" depends="integrate">
<ant antfile="${dita.dir}${file.separator}build.xml" target="init">
<!-- //////////////////////////////////////////////////// -->
<!-- INSTALL THIS ANT FILE AT THE ROOT OF THE SAME FOLDER -->
<!-- THAT CONTAINS THE DITA1.2 SOURCE FILES. -->
<!-- UNCOMMENT ONE OR MORE OF THE FOLLOWING DITA MAPS -->
<!-- TO BUILD IT AS A SUBSET OF THE DITA 1.2 SPECIFICATION. -->
<!-- <property name="args.input" value="introduction.ditamap"/> -->
<property name="args.input" value="architectural-specification.ditamap"/>
<!-- <property name="args.input" value="language-reference.ditamap"/> -->
<!-- <property name="args.input" value="conformance.dita"/> -->
<!-- <property name="args.input" value="r-acknowledgments.dita"/> -->
<!-- <property name="args.input" value="non-normative-information.ditamap"/> -->
<property name="output.dir" value="out${file.separator}xhtml"/>
<property name="transtype" value="xhtml"/>
<property name="outer.control" value="quiet"/>
</ant>
</target>
</project>

CD to the DITA-OT1.5.2/dita1.2 subdirectory and run the following command.

$ ant -f ant_dita1.2_subset_xhtml.xml

Review build output (index.html) in DITA-OT1.5.2/dita1.2/out/xhtml.

Stan Doherty (Stan@modularwriting.com)

OASIS DITA Technical Committee

stan@modularwriting.com

 

XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I

dita-bird_0.jpg

Hosted by:

OASIS

Sponsored by:

adobe-systems-incorporated_0_0_0.png

ibm.gif

Sponsored links:

Adobe DITA CCMS