RE: [dita] Instructions for "Configuring your build environment to generate OASIS-styled PDFs"

["Dick Hamilton" <rlhamilton@frii.com>]

Title: Message

Kris,

 

I'm building the spec from your instructions.

 

The good news is that I was able to successfully build the short version (archspec2pdf target in build_archspec_pdf.xml). It took a little tweaking to your instructions, since I'm running Linux, but nothing that wasn't obvious.

 

The bad news is that the full specification build failed: With your original settings I got the following error:

 

transform.fo2pdf.xep:
[java] Exception in thread "main" java.lang.OutOfMemoryError: GC overhead limit exceeded

I bumped the two space values in your instructions to 2000, things ran a bit longer, and I got the following error:

 

transform.fo2pdf.xep:

[java] Exception in thread "main" java.lang.OutOfMemoryError: Java heap space

The system is a dual core 64-bit AMD processor with 3GB memory, 2Gb swap, running Ubuntu 8.10. Looking at the system monitor, nearly all memory is used, but there is plenty of swap space.

 

Any idea what might be going on, or how I might be able to tweak things to get the build to work? I'll probably try 3000, but frankly, I doubt that will make a difference if you were successful with 1500; I suspect there's a different problem.

 

Also, here are a couple of random notes on the build:

 

- DITA OT 1.5 (at least the version I got back in May '09) was not sufficient; I downloaded 1.5.1 (1/26/2010) which worked fine (other than the space problem:).

 

- Is there a cheat sheet for which build files and which targets build which deliverables. I figured out how to build the big one (build_dita12_complete_pdf.xml), but it took some trial and error.

 

Thanks for your help.

 

Best Regards,

Dick Hamilton

---------------------------------
XML Press
XML for Technical Communicators
http://xmlpress.net
(970) 231-3624

-----Original Message-----
From: Kristen James Eberlein [mailto:kris@eberleinconsulting.com]
Sent: Tuesday, February 02, 2010 10:20 AM
To: stan@modularwriting.com; Dick Hamilton
Cc: DITA TC
Subject: [dita] 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)

--------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php