Re: Instructions for "Configuring your build environment to generate OASIS-styled PDFs"

["stan@modularwriting.com" <stan@modularwriting.com>]

Hi all --

I had no difficulty in following Kris' instructions and in building the entire DITA 1.2 spec in PDF. Kudos to Eliot et al. for the nifty technology, Tony Self for the OASIS branding, and Kris for the nifty write-up.

FWIW ... here are my config specs and results:

* OS: Windows XP Pro
* Hardware: IBM Thinkpad T61 (2.0Ghz CPU, 2GB RAM)
* DITA-OT: DITA-OT1.5.1_m1
* PDF formatter: XEP 4.17
* Build time: 28.5 minutes
* Output: 14.096MB PDF (1193 pages)

Stan

-----Original Message-----
From: "Kristen James Eberlein" [kris@eberleinconsulting.com]
Date: 02/02/2010 12:20 PM
To: "stan@modularwriting.com" <stan@modularwriting.com>, "Dick Hamilton"
CC: "DITA TC" <dita@lists.oasis-open.org>
Subject: Re: Instructions for "Configuring your build environment to generate OASIS-styled PDFs"

The source for this (rough) topic is in the SVN repository:
build/t-configuring-your-build-environment.dita

Please let me know if there are errors, ambiguities, or ways that this topic could be improved. I'll follow this up with another topic about "Generating the OASIS-styled PDFs".

Configuring your build environment to generate OASIS-styled PDFs

Before you can successfully generate PDF files of the DITA 1.2 specification, you must configure your build environment. This involves installing a patched build.xml file for the Idiom plug-in, integrating a plug-in that contains the OASIS style sheets, increasing the Java memory, and creating a build.properties file.

Before you begin

You must have the following software installed:

• DITA Open Toolkit, version 1.5 or later
• RenderX XEP

1. Ensure that your Subversion working copy includes the most recent files in the SVN repository.
2. Copy the following file to the Toolkit/demo/fo directory:

   basedir/toolkit-plugins/patches/fo/build.xml

   where:
   • basedir is the root directory of your Subversion working copy.
   • Toolkit is the directory where the DITA Open Toolkit is installed.
3. Copy the following plug-in to the Toolkit/plugins directory:

   basedir/toolkit-plugins/org.oasis.dita.ditaspec.fo

4. To increase the Java memory, modify the startcmd.bat file so that it contains the following content:

   set ANT_OPTS=-Xmx1500m %ANT_OPTS% set ANT_OPTS=%ANT_OPTS%  -Djavax.xml.transform.TransformerFactory=net.sf.saxon.TransformerFactoryImpl

5. Run the startcmd.bat file.
6. From the command prompt, run the following command and press Enter:

   ant -f integrator.xml

7. Create a build.properties file that contains the following content:

   dita-ot-dir=Toolkit max.java.memory=1500m

   where Toolkit is the directory where the DITA Open Toolkit is installed, for example, C:\\DITA-OT1.5.1-Test. (Note that an extra backspace is required to escape the backspace character.)
8. Save the build.properties file to either the basedir or the user.home directory, where basedir is the root directory of your Subversion working copy, and user.home is your user home directory, for example, C:\Documents and Settings\keberlein.
9. Change to the basedir directory.
10. From the command prompt, type the following command and press Enter:

    ant -f build_archspec_pdf.xml deploy-toolkit-plugins

Best,

Kris

Kristen James Eberlein
Principal consultant, Eberlein Consulting
Secretary, OASIS DITA Technical Committee
Charter member, OASIS DITA Adoption Committee
www.eberleinconsulting.com
http://www.linkedin.com/in/kristeneberlein
+1 919 682-2290 ET (GMT -5); keberlein (skype)