Diff for parameters-to-the-DITA-OT-transform
| Mon, 2009-10-12 15:10 by robander | Wed, 2010-03-31 23:07 by esirois | ||
|---|---|---|---|
| < previous diff | next diff > | ||
| Changes to Body | |||
| Line 53 | Line 53 | ||
<li><em>item</em> </li>
| <li><em>item</em> </li>
| ||
</ul>
| </ul>
| ||
| - | <br />
| ||
<p>
| <p>
| ||
|
| ||
| + | </p>
| ||
| + | <h2>Eclipse Help specific parameters</h2>
| ||
| + | <p>
| ||
| + | The following parameters are used for processing base Eclipse Maps and only apply to to base maps.
| ||
| + | </p>
| ||
| + | <ul>
| ||
| + | <li>${args.eclipse.provider} - (default DITA) the name of the company providing the plugins. The content of this parameter will be found in the plugin.properties file. </li>
| ||
| + | <li>${args.eclipse.version} - (default is 1.0.0) the version number for the plugin.</li>
| ||
| + | </ul>
| ||
| + | The @id value from the Eclipse map or the Eclipse map collection (Eclipse help specialization) is the ID for the plugin in Eclipse. By default, the value org.sample.help.doc.<br />
| ||
| + | <br />
| ||
| + | The following values are used to create an Eclipse fragment instead of an Eclipse pluigns and move content to the appropriate directory structure [1]<br />
| ||
| + | <br />
| ||
| + | <ul>
| ||
| + | <li>args.eclipse.language - the base language for the translated content. For instance, en. </li>
| ||
| + | <li>args.eclipse.counrty - the more specifc country for the base language. For instance, US, CA of GB. </li>
| ||
| + | </ul>
| ||
| + | <p>
| ||
| + | [1] - <a href="http://help.eclipse.org/galileo/index.jsp?topic=/org.eclipse.platform.doc.isv/guide/product_def_nl.htm" target="_blank" title="Eclipse locale specific files">http://help.eclipse.org/galileo/index.jsp?topic=/org.eclipse.platform.doc.isv/guide/product_def_nl.htm</a>
| ||
</p>
| </p>
| ||
Revision of Wed, 2010-03-31 23:07:
parameters-to-the-DITA-OT-transform
Ant and XSLT Parameters to the DITA Open Toolkit
This page is a collection point for parameters in the core DITA-OT that can be set by tools or individual users running a build. Note: the main landing page for information about the toolkit is here: http://dita.xml.org/wiki/the-dita-open-toolkit
As you can see at this point, this item is just a starter page, with more information coming soon.
Most of this information would be more usable in a tabular format, but this wiki does not appear to support tables. For each parameter below, the Ant parameter is listed first, followed by valid values (if any), followed by a description. If applicable, a corresponding XSLT parameter is listed at the end. If you have an idea for a better way to store this, please comment!
General processing parameters
- ${args.draft} - "no" or "yes", default is "no". Indicates whether draft-comment and required-cleanup elements are included in the generated file. Corresponds to XSLT parameter DRAFT.
- ${dita.ext} - any value, defaults to ".xml". Specifies an extension to use for DITA topics; all DITA topics will use this single extension in the temp directory. Corresponds to XSLT parameter DITAEXT.
- ${dita.input.valfile} - any value. Specifies the DITAVAL file used for processing. Corresponds to XSLT parameter FILTERFILE.
- ${args.tablelink.style} - "NUMBER" or "TITLE" (default is "NUMBER"). Determines how cross references to tables are styled (currently for XHTML only, but may be picked up for other formats in the future). NUMBER results in "Table 5", TITLE results in the title of the table. Corresponds to the XSLT parameter TABLELINK.
- ${args.figurelink.style} - "NUMBER" or "TITLE" (default is "NUMBER"). Determines how cross references to figures are styled (currently for XHTML only, but may be picked up for other formats in the future). NUMBER results in "Figure 5", TITLE results in the title of the figure. Corresponds to the XSLT parameter FIGURELINK.
XHTML specific parameters
- ${args.artlbl} -"no" or "yes", defaults to "no". Indicates whether the filename of each image will appear alongside the image, typically for review purposes. Corresponds to the XSLT parameter ARTLBL.
- ${args.css} - any value. Specifies a CSS file, expected without path
- ${args.hdf} - any value. Specfies a file that contains an XHTML fragment to be inserted into the <head> of every generated XHTML file. NOTE: the fragment must be valid XML, with a single root element; if you need to add two peer elements, place them in a <div>, and the build will discard that wrapper. Corresponds to the XSLT parameter HDF.
- ${args.hdr} - any value. Specfies a file that contains an XHTML fragment to be inserted at the top of the body in each generated XHTML file. NOTE: the fragment must be valid XML, with a single root element; common practice is to place all contents into <div>. Corresponds to the XSLT parameter HDR.
- ${args.indexshow} - "no" or "yes", defaults to "no". When set to yes, index terms will appear inline in brackets, typically for review purposes. Corresponds to the XSLT parameter INDEXSHOW.
- ${args.ftr} - any value. Specfies a file that contains an XHTML fragment to be inserted at the bottom of the body in each generated XHTML file. NOTE: the fragment must be valid XML, with a single root element; common practice is to place all contents into <div>. Corresponds to the XSLT parameter FTR.
- ${out.ext} - any value, defaults to ".html". Specifies an output extension for XHTML topics. Corresponds to XSLT parameter OUTEXT.
- ${args.csspath} - any value, default is the root map's directory. Specifies a path for CSS links added to XHTML output (default and user files). Corresponds to XSLT parameter CSSPATH.
- ${args.xhtml.classattr} - "no" or "yes". Determines whether to include DITA class ancestry inside generated XHTML elements, to allow for extensive CSS styling. For example, the prereq element in a task would generate <task class="section prereq">. Corresponds to the XSLT parameter PRESERVE-DITA-CLASS.
- ${args.gen.task.lbl} - "NO" or "YES" (default is "NO"). Determines whether to generate locale based default headings for sections within task topics. Corresponds to the XSLT parameter GENERATE-TASK-LABELS.
- ${args.hide.parent.link} - "no" or "yes" (default is "no"). Determines whether to hide links to parent topics in the rendered XHTML. Corresponds to the XSLT parameter NOPARENTLINK.
- ${args.breadcrumbs} - "no" or "yes" (default is "no"). Determines whether to generate breadcrumb links. Corresponds to the XSLT parameter BREADCRUMBS.
- ${args.debug} - "no" or "yes" (default is "no"). Determines whether to generate extra debug information in the log. Corresponds to the XSLT parameter DBG.
- ${args.gen.default.meta} - "no" or "yes" (default is "no"). Determines whether to generate extra metadata that targets parental control scanners (meta elements with name="security" and name="Robots"). Corresponds to the XSLT parameter genDefMeta.
PDF specific parameters
- item
Eclipse Help specific parameters
The following parameters are used for processing base Eclipse Maps and only apply to to base maps.
- ${args.eclipse.provider} - (default DITA) the name of the company providing the plugins. The content of this parameter will be found in the plugin.properties file.
- ${args.eclipse.version} - (default is 1.0.0) the version number for the plugin.
The following values are used to create an Eclipse fragment instead of an Eclipse pluigns and move content to the appropriate directory structure [1]
- args.eclipse.language - the base language for the translated content. For instance, en.
- args.eclipse.counrty - the more specifc country for the base language. For instance, US, CA of GB.
Search
Recent Content
- Forum for DITA Users
35 weeks ago - Publishing for DITA
5 years ago - Optimizing the DITA Authoring Experience — Online Course
5 years ago - Linking to another chunked topic
5 years ago - Advanced Reuse Strategies — Online Course
5 years ago - 2019 Content Management Strategies/DITA North America Conference
5 years ago
Subscribe
Navigation
Currently online: 0 guests and 0 users:
