Diff for Tips for debugging PDF2 plugin PDF issues
Sun, 2007-11-25 07:46 by Bruce Esrig | Sat, 2012-06-16 10:08 by jelovirt | ||
---|---|---|---|
Tags: Plugins | |||
< previous diff | |||
Changes to Body | |||
Line 1 | Line 1 | ||
- | <strong>Keeping the generated FO file</strong><br />
| + | <p>
|
+ | Note: this page is out-of-date, see [[http://dita-ot.sourceforge.net/latest/]] for current documentation.
| ||
+ | </p>
| ||
+ | <p>
| ||
+ |  
| ||
+ | </p>
| ||
+ | <h1><strong>Keeping the generated FO file</strong></h1>
| ||
<br />
| <br />
| ||
One of the most important things to do to debug the PDF generated by the PDF2 plugin (also known as the Idiom PDF plugin) is to look at the FO file the plugin generates. The plugin, by default, deletes all intermediate files, though, so you need to modify the plugin to save those files.<br />
| One of the most important things to do to debug the PDF generated by the PDF2 plugin (also known as the Idiom PDF plugin) is to look at the FO file the plugin generates. The plugin, by default, deletes all intermediate files, though, so you need to modify the plugin to save those files.<br />
| ||
<br />
| <br />
| ||
- | To stop the plugin from deleting the FO file:<br />
| + | To stop the plugin from deleting the FO file:
|
- | <br />
| + | <p>
|
+ |  
| ||
+ | </p>
| ||
<ol>
| <ol>
| ||
<li>Open demo\fo\build.xml in a n editor.</li>
| <li>Open demo\fo\build.xml in a n editor.</li>
| ||
Line 12 | Line 20 | ||
<li>Change that target to look like the following:<br />
| <li>Change that target to look like the following:<br />
| ||
<br />
| <br />
| ||
- | <antcall target="transform.fo2pdf"><br />
| + | <antcall target="transform.fo2pdf"><br />
|
- | <param name="inputFile" value="${dita.map.output.dir}/topic.fo"/><br />
| + | <param name="inputFile" value="${dita.map.output.dir}/topic.fo"/><br />
|
- | <param name="outputFile" value="${outputFile}"/><br />
| + | <param name="outputFile" value="${outputFile}"/><br />
|
- | <param name="xep.failOnError" value="${xep.failOnError}"/><br />
| + | <param name="xep.failOnError" value="${xep.failOnError}"/><br />
|
- | </antcall><br />
| + | </antcall><br />
|
- | <br />
| + | |
- | <!-- Keep the fo around for debugging purposes --><br />
| + | |
- | <!--<br />
| + | |
- | <delete><br />
| + | |
- | <fileset dir="${buildDir}" includes="stage?.*"/><br />
| + | |
- | <fileset dir="${dita.map.output.dir}" includes="topic.fo"/><br />
| + | |
- | </delete><br />
| + | |
- | --><br />
| + | |
<br />
| <br />
| ||
- | </target><br />
| + | <!-- Keep the fo around for debugging purposes --><br />
|
+ | <!--<br />
| ||
+ | <delete><br />
| ||
+ | <fileset dir="${buildDir}" includes="stage?.*"/><br />
| ||
+ | <fileset dir="${dita.map.output.dir}" includes="topic.fo"/><br />
| ||
+ | </delete><br />
| ||
+ | --><br />
| ||
<br />
| <br />
| ||
+ | </target><br />
| ||
</li>
| </li>
| ||
</ol>
| </ol>
|
Current revision:
Tips for debugging PDF2 plugin PDF issues
Note: this page is out-of-date, see http://dita-ot.sourceforge.net/latest/ for current documentation.
Keeping the generated FO file
One of the most important things to do to debug the PDF generated by the PDF2 plugin (also known as the Idiom PDF plugin) is to look at the FO file the plugin generates. The plugin, by default, deletes all intermediate files, though, so you need to modify the plugin to save those files.
To stop the plugin from deleting the FO file:
- Open demo\fo\build.xml in a n editor.
- Search for the line
<antcall target="transform.fo2pdf"> - Change that target to look like the following:
<antcall target="transform.fo2pdf">
<param name="inputFile" value="${dita.map.output.dir}/topic.fo"/>
<param name="outputFile" value="${outputFile}"/>
<param name="xep.failOnError" value="${xep.failOnError}"/>
</antcall>
<!-- Keep the fo around for debugging purposes -->
<!--
<delete>
<fileset dir="${buildDir}" includes="stage?.*"/>
<fileset dir="${dita.map.output.dir}" includes="topic.fo"/>
</delete>
-->
</target>
Usually issues can be diagnosed by looking at the FO to see what is really getting put into it, as opposed to what you think is getting put into it.
But, if that's not the case, then you tweak the FO until it generates the PDF you want, then you fix the XSLT to generate the FO you want.
-- Contributed by Steve Anderson (steveo@member.fsf.org)