DITA Open Toolkit Version 1.0.2

DITA Open Toolkit 1.0.2 Minor Release Availability

Date:      Tue, 07 Jun 2005 19:44:23 -0000
From:      Don R. Day <dond@us.ibm.com>
To:        dita-users@yahoogroups.com
Subject:   DITA Open Toolkit 1.0.2 minor release availability

Since I have mentioned this level of toolkit several times, I guess I should make it official: minor release 1.0.2 of the DITA Open Toolkit is now available from its project page at:

http://sourceforge.net/projects/dita-ot/

— look for the 'Download' link

This release contains the following fixed bugs and Requests For Enhancement (RFEs):

1. SF Bug 1181950: format attribute should be set to 'dita' for dita topic 
2. SF Patch 1176909: Add template for getting image URI 
3. SF RFE 1183487: Document the usage of footer property 
4. SF RFE 1198847: command line interface support  
5. SF RFE 1198850: architecture document update  
6. SF RFE 1200410: need explanation for dita.list 
7. SF RFE 1201175: XML catalog support

The enhancements mainly make the package easier to integrate into existing production systems, but the command line interface in particular is in response to user feedback from recent conferences and workshops, requesting simpler access to processing features for non-programmer users and evaluators. I posted the mini-reference for this feature in message 664 [also below]; see http://groups.yahoo.com/group/dita-users/message/664.

Windows users, select the *bin.zip file; Linux users, you know the tar file is for you. The *src* downloads are the obligatory all-code-source versions which are just snapshots of the pertinent CVS tree on the project site. When you unzip this file, it will create a /dita-ot1.0.2 directory which contains all the DITA toolkit files, so you can install it as a peer to your existing DITA directories with no overlap.

Enjoy!

Don Day <dond@us.ibm.com>
Chair, OASIS DITA Technical Committee
IBM Lead DITA Architect
11501 Burnet Rd., MS 9037D018, Austin TX 78758
Ph. 512-838-8550 (T/L 678-8550)

"Where is the wisdom we have lost in knowledge?
Where is the knowledge we have lost in information?"
--T.S. Eliot

Mini reference for the parameter-building tool

From http://groups.yahoo.com/group/dita-users/message/664, for convenience:

1. Change into the root directory of your current DITA-OT

2. Enter the command after this form:

"java -jar lib\dost1.0.jar /i:samples/sequence.ditamap /outdir:out /transtype:xhtml"

This particular example will create a properties file and then call Ant using those properties to build the sample sequence.ditamap and output the XHTML results to the out directory. You can add other parameters to the property file — see below.

Notes:

1. The properties file is saved in the temp directory. You can reuse the properties file in this way: ant -f conductor.xml -propertyfile temp/property.temp
2. In this example, the '/' character preceded by a space is the separator for each parameter.
3. Currently /filter, /ftr, /hdr, and /hdf require an absolute path.

Here are the supported parameters (showing their Ant names within the braces) that you can set with this tool:

Parameters for input/output control:
/i:{args.input}
The input file(can be relative or absolute path).
/if:{dita.input}
The input file(requires the /id parameter).
/id:{dita.input.dirname}
The argument for the input directory which contains the input file
specified by /if.
/ditaext:{dita.extname}
Specify whether the input topic files use .xml or .dita as the file
extension name. The default is .xml.
/transtype:{transtype}
Specify the transformation type. Currently supported values include
xhtml, pdf, javahelp, eclipsehelp, htmlhelp, and docbook.
/outdir:{output.dir}
The directory into which you want the output results to be placed.
Defaults to /out.

Parameters that change the processing logic (any output):
/filter:{dita.input.valfile}
Specify the ditaval file to be used for conditional processing.
/draft:{args.draft}
Causes the output to show draft-comment and required-cleanup content in
plainly-marked style for review.
/artlbl:{args.artlbl}
Causes the output to include the file name of each graphic to be
included after each graphic (useful for recapturing screen images after
translation, for example).

Parameters that insert additional content into HTML output:
/ftr:{args.ftr}
Indicates the name of the well-formed footer file to be embedded in any
HTML-based output.
/hdr:{args.hdr}
Indicates the name of the well-formed header file to be embedded at the
top of the BODY of HTML-based output.
/hdf:{args.hdf}
Indicates the name of the well-formed header file to be embedded at the
end of the HEAD of HTML-based output.
/csspath:{args.csspath}
Specifies a path for the cascading style sheet (CSS). This allows you to
place the CSS file in one place and have several different topics point to
it (requires the /css parameter).
/css:{args.css}
Specifies the name of a stylesheet in addition to the default common
stylesheet to be linked into HTML-based output.

Prepared by Robin Cover for The XML Cover Pages archive. General references in "Darwin Information Typing Architecture (DITA XML)."

SEARCH Advanced Search ABOUT Site Map CP RSS Channel Contact Us Sponsoring CP About Our Sponsors NEWS Cover Stories Articles & Papers Press Releases CORE STANDARDS XML SGML Schemas XSL/XSLT/XPath XLink XML Query CSS SVG TECHNOLOGY REPORTS XML Applications General Apps Government Apps Academic Apps EVENTS LIBRARY Introductions FAQs Bibliography Technology and Society Semantics Tech Topics Software Related Standards Historic	DITA Open Toolkit Version 1.0.2 DITA Open Toolkit 1.0.2 Minor Release Availability Date: Tue, 07 Jun 2005 19:44:23 -0000 From: Don R. Day <dond@us.ibm.com> To: dita-users@yahoogroups.com Subject: DITA Open Toolkit 1.0.2 minor release availability Since I have mentioned this level of toolkit several times, I guess I should make it official: minor release 1.0.2 of the DITA Open Toolkit is now available from its project page at: http://sourceforge.net/projects/dita-ot/ — look for the 'Download' link This release contains the following fixed bugs and Requests For Enhancement (RFEs): 1. SF Bug 1181950: format attribute should be set to 'dita' for dita topic 2. SF Patch 1176909: Add template for getting image URI 3. SF RFE 1183487: Document the usage of footer property 4. SF RFE 1198847: command line interface support 5. SF RFE 1198850: architecture document update 6. SF RFE 1200410: need explanation for dita.list 7. SF RFE 1201175: XML catalog support The enhancements mainly make the package easier to integrate into existing production systems, but the command line interface in particular is in response to user feedback from recent conferences and workshops, requesting simpler access to processing features for non-programmer users and evaluators. I posted the mini-reference for this feature in message 664 [also below]; see http://groups.yahoo.com/group/dita-users/message/664. Windows users, select the bin.zip file; Linux users, you know the tar file is for you. The src* downloads are the obligatory all-code-source versions which are just snapshots of the pertinent CVS tree on the project site. When you unzip this file, it will create a /dita-ot1.0.2 directory which contains all the DITA toolkit files, so you can install it as a peer to your existing DITA directories with no overlap. Enjoy! Don Day <dond@us.ibm.com> Chair, OASIS DITA Technical Committee IBM Lead DITA Architect 11501 Burnet Rd., MS 9037D018, Austin TX 78758 Ph. 512-838-8550 (T/L 678-8550) "Where is the wisdom we have lost in knowledge? Where is the knowledge we have lost in information?" --T.S. Eliot Mini reference for the parameter-building tool From http://groups.yahoo.com/group/dita-users/message/664, for convenience: 1. Change into the root directory of your current DITA-OT 2. Enter the command after this form: "java -jar lib\dost1.0.jar /i:samples/sequence.ditamap /outdir:out /transtype:xhtml" This particular example will create a properties file and then call Ant using those properties to build the sample sequence.ditamap and output the XHTML results to the out directory. You can add other parameters to the property file — see below. Notes: 1. The properties file is saved in the temp directory. You can reuse the properties file in this way: ant -f conductor.xml -propertyfile temp/property.temp 2. In this example, the '/' character preceded by a space is the separator for each parameter. 3. Currently /filter, /ftr, /hdr, and /hdf require an absolute path. Here are the supported parameters (showing their Ant names within the braces) that you can set with this tool: Parameters for input/output control: /i:{args.input} The input file(can be relative or absolute path). /if:{dita.input} The input file(requires the /id parameter). /id:{dita.input.dirname} The argument for the input directory which contains the input file specified by /if. /ditaext:{dita.extname} Specify whether the input topic files use .xml or .dita as the file extension name. The default is .xml. /transtype:{transtype} Specify the transformation type. Currently supported values include xhtml, pdf, javahelp, eclipsehelp, htmlhelp, and docbook. /outdir:{output.dir} The directory into which you want the output results to be placed. Defaults to /out. Parameters that change the processing logic (any output): /filter:{dita.input.valfile} Specify the ditaval file to be used for conditional processing. /draft:{args.draft} Causes the output to show draft-comment and required-cleanup content in plainly-marked style for review. /artlbl:{args.artlbl} Causes the output to include the file name of each graphic to be included after each graphic (useful for recapturing screen images after translation, for example). Parameters that insert additional content into HTML output: /ftr:{args.ftr} Indicates the name of the well-formed footer file to be embedded in any HTML-based output. /hdr:{args.hdr} Indicates the name of the well-formed header file to be embedded at the top of the BODY of HTML-based output. /hdf:{args.hdf} Indicates the name of the well-formed header file to be embedded at the end of the HEAD of HTML-based output. /csspath:{args.csspath} Specifies a path for the cascading style sheet (CSS). This allows you to place the CSS file in one place and have several different topics point to it (requires the /css parameter). /css:{args.css} Specifies the name of a stylesheet in addition to the default common stylesheet to be linked into HTML-based output. Prepared by Robin Cover for The XML Cover Pages archive. General references in "Darwin Information Typing Architecture (DITA XML)."