Diff for Publishing with the DITA Open Toolkit
Wed, 2007-11-28 07:50 by Bruce Esrig | Sat, 2008-03-15 23:05 by Bob Doyle | ||
---|---|---|---|
Tag: Publishing capabilities | |||
< previous diff | next diff > | ||
Changes to Body | |||
Line 1 | Line 1 | ||
<p>
| <p>
| ||
<br />
| <br />
| ||
- | The DITA Open Toolkit, or dita-ot for short, is a set of Java-based, open source tools that provide a "reference implementation" for processing DITA maps and topical content.
| + | The DITA Open Toolkit, or dita-ot for short, is a set of Java-based, open source tools that provide a "reference implementation" for processing DITA maps and topical content. You
|
+ | can download the OT and install it for free on your computer, to get started
| ||
+ | with topic-based writing and publishing.
| ||
</p>
| </p>
| ||
<p>
| <p>
| ||
- | The home page of the DITA Open Toolkit is <a href="http://sourceforge.net/projects/dita-ot/">http://sourceforge.net/projects/dita-ot/</a>. The DITA Open Toolkit Installation Guide, which is on that page, contains a list of supporting open-source software to download, together with a set of versions that are known to be compatible.<br />
| + | The DITA Open Toolkit is a modest publishing system. The Toolkit
|
- | <br />
| + | transforms DITA content (maps and topics) into publishing deliverable
|
- | This article will provide resources and ideas for how to use the Toolkit at your site or with your products that support DITA.<br />
| + | formats for web (XHTML), print (PDF), and Help (CHM and Eclipse). Your
|
- | <br />
| + | output files are simply generated in your file system. It is up to you
|
- | We plan to develop the following resource topics:
| + | to move them to your website, or into your print publishing process.
|
+ | </p>
| ||
+ | <p>
| ||
+ | The OT is integrated into many authoring tools (<em>e.g.,FrameMaker</em>, <em><oXygen/></em>, <em>XMetaL</em>) and
| ||
+ | content management systems (e.g., <em>Astoria, Bluestream, IXIASOFT, XyEnterprise</em>).
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | If you find installing the OT too difficult, consider a free running
| ||
+ | version of the DITA Open Toolkit provided as an online
| ||
+ | software-as-a-service by the <a rel="nofollow" href="http://www.ditausers.org/">DITA Users</a>
| ||
+ | organization.
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | There you can have an online workspace folder with DITA
| ||
+ | docsets from IBM and Comtech Services. Edit the files and build/publish them as
| ||
+ | web (XHTML), print (PDF), and Help (Eclipse). All your work can be
| ||
+ | browsed on the web by your colleagues as a portfolio of your DITA work
| ||
+ | with the OT.
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | The home page of the DITA Open Toolkit is <a href="http://dita-ot.sourceforge.net/">http://dita-ot.sourceforge.net/</a>. The DITA Open Toolkit Installation Guide, which is on that page, contains a list of supporting open-source software to download, together with a set of versions that are known to be compatible.
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | The instructions on how to install and use the OT are maintained by Anna van Raaphorst and Dick Johnson as the <a rel="nofollow" href="http://dita-ot.sourceforge.net/SourceForgeFiles/doc/user_guide2.html">DITA Open Toolkit User Guide</a>.<br />
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | Don Day maintains a <a rel="nofollow" href="http://www.ditaopentoolkit.org/">DITA Open Toolkit Resources Page</a>.
| ||
</p>
| </p>
| ||
- | <ul>
| ||
- | <li>suggestions for a low-end repeatable process </li>
| ||
- | <li>best practices for including toolkit components in products </li>
| ||
- | <li>how users can update the toolkit between product upgrades </li>
| ||
- | <li>the role of plugins </li>
| ||
- | <li>contributing to the DITA-OT project </li>
| ||
- | <li>about licenses </li>
| ||
- | <li>more... </li>
| ||
- | </ul>
| ||
- | In addition, new features are available at <a href="/dita-ot-design-documents">DITA-OT design documents</a>.<br />
| ||
<br />
| <br />
| ||
<h2>See also:<br />
| <h2>See also:<br />
|
Publishing with the DITA Open Toolkit
The DITA Open Toolkit, or dita-ot for short, is a set of Java-based, open source tools that provide a "reference implementation" for processing DITA maps and topical content. You
can download the OT and install it for free on your computer, to get started
with topic-based writing and publishing.
The DITA Open Toolkit is a modest publishing system. The Toolkit transforms DITA content (maps and topics) into publishing deliverable formats for web (XHTML), print (PDF), and Help (CHM and Eclipse). Your output files are simply generated in your file system. It is up to you to move them to your website, or into your print publishing process.
The OT is integrated into many authoring tools (e.g.,FrameMaker, <oXygen/>, XMetaL) and content management systems (e.g., Astoria, Bluestream, IXIASOFT, XyEnterprise).
If you find installing the OT too difficult, consider a free running version of the DITA Open Toolkit provided as an online software-as-a-service by the DITA Users organization.
There you can have an online workspace folder with DITA docsets from IBM and Comtech Services. Edit the files and build/publish them as web (XHTML), print (PDF), and Help (Eclipse). All your work can be browsed on the web by your colleagues as a portfolio of your DITA work with the OT.
The home page of the DITA Open Toolkit is http://dita-ot.sourceforge.net/. The DITA Open Toolkit Installation Guide, which is on that page, contains a list of supporting open-source software to download, together with a set of versions that are known to be compatible.
The instructions on how to install and use the OT are maintained by Anna van Raaphorst and Dick Johnson as the DITA Open Toolkit User Guide.
Don Day maintains a DITA Open Toolkit Resources Page.