Newbie Open Toolkit installation problem
I read about DITA concepts; now, I want to see some working samples to find out what I can do with DITA, and how.
So I'm now trying to install the Open Toolkit 1.2.2, on Windows, as per insturctions found here; http://dita-ot.sourceforge.net/doc/installguide/installotoverview.html.
I'm encoutering two problems.
1) After I've downloaded and installed all the various components in the C:\ paths as directed, I'm supposed to set the environment variables.
http://dita-ot.sourceforge.net/doc/installguide/settingenvironmentvariables.html
Substep c) for "If you use Saxon" says;
Set up ANT_OPTS. For example:
  set ANT_OPTS=%ANT_OPTS% - Djavax.xml.transform.TransformerFactory=com.icl.saxon.TransformerFactoryImpl
I don't understand how exactly I do this. Am I still setting an environmental variable?
2) With everything else but the above complete in the installation process, I went on to the next step, "Testing DITA Installation".
This is what I get;
BUILD FAILED
C:\ditaot\build.xml:143 The following error occurred while executing this line:
C:\ditaot\conductor.xml:354 The following error occurred while executing this line:
C:\ditaot\ditatargets.xml:120 The following error occurred while executing this line:
java.lang.NoClassDefFoundError: org/apache/batik/util/XMLResourceDescriptor
What have I missed?
Sorry if these are obvious for techies. Thank you in advance.
- Yosuke
reenable FOP
The exception of NoClassFoundError indicate that batik.jar is not included in classpath. Batik is used by FOP. If you're using FOP 0.20.5, please check the CLASSPATH and include fop.jar, avalon-framework-cvs-20020806.jar and batik.jar. For example, if you installed fop at c:\fop. You need to make sure that the following string
c:\fop\build\fop.jar;c:\fop\lib\avalon-framework-cvs-20020806.jar;c:\fop\lib\batik.jar
appear in your CLASSPATH.
Best Regards,
Stephen
Problem solved
I figured it out.
Okay, so this is from one newbie to other newbies who might face the same problem.
- I had CLASSPATH defined for both XSLT processors (Saxon and Xalan), but I should only setup CLASSPATH for either.
- The *exact* procedure to "Set up ANT_OPTS", necessary when using Saxon, described consistently as the other environment variable settings, would be as follows;
- After installation, when you follow the insturctions found in "Testing DITA Installation" and do a ant all, you'll get a BUILD FAILED after a while --well, I did--, when building the "langref" demo, on either XSLT processor.
But the problem seems to be only for this case; build fails when I do ant demo.langref, but successful for all other demos, docs, and samples. So I figure I got passed installation.
--Yosuke
Another kind of newbie problem
I've been reading this post with great interest because I am myself experiencing some problems with the DITA Open Toolkit from the very beginning. I installed everything and followed all the instructions, but whatever I do, I get a BUILD FAILED message when I try to test the installation. I have not been able to find an answer, let alone figure out myself what I've done wrong.
So when I get the c:\ditaot> prompt, I type ant all, and then I get the following:
Buildfile: build.xml
BUILD FAILED
Target 'all' does not exist in this project.
Total time: 3 seconds
Anyone able to help?
Thanks a lot!!!
pki
Another newbie
I still get BUILD FAILED when everything is finished with this message:
C:\ditaot\build.xml:282: The following error occurred while executing this line: C:\ditaot\conductor.xml:350: The following error occurred while executing this l ine: java.lang.OutOfMemoryError
I guess it doesn't matter if the build passed or failed at this point since I'm just noodling to get a jump start on my company's imminent DITA migration, but does anyone have an idea what I'm doing wrong here?
-Derek
enlarge the memory limits of JVM
This error is caused by JVM heap memory limits. When you're trying to transform a large document to PDF, the memory usage would be very high. Sometimes exceed the default limit of 64MB in JVM. In this case, you need to adjust the limits to higher level. Please try to add string " -Xmx256m " in ANT_OPTS and try again. Thanks.
Note: the quotation mark shouldn't be inlcuded in ANT_OPTS.
Best Regards,
Stephen