Subscribe to RSS
Posts Tagged ‘DITA builds’
DITA round up
Just doing a little data mining of the posts I’ve written about DITA in the last few years. I think that there’s a gap for DITA users who are writers or content creators and not coders. I’d like to say that DITA bloggers can bridge that gap. Join me on the DITA blog by writing your own experiences with DITA.
These posts are ordered from newest to oldest, and I wrote them to share my experiences with DITA and to chronicle some of the Central Texas DITA User Group meetings I attended.
A watched folder for publishing from DITA source files
June 15, 2007: I’ve figured out a way to automate DITA builds where you just drop a zip file of your DITA source files into a “watched folder” and PDF and CHM files are automatically built.
Usability and inline links in user assistance systems
May 19, 2007: Examining DITA’s linking and usability.
Getting Started with DITA
April 12, 2007: A brief overview for a couple of fellow Austin writers who have asked me recently how and where to get started with DITA.
Checking out the new DITA Users website
April 10, 2007: Using a coupon code (it’s BETA) I joined the new DITA Users website for free today.
A new DITA Open ToolKit release and brand new DITA newbie blog
October 04, 2006 : A couple of blog-worthy items in the DITA world
Turning information into DITA topics
September 14, 2006: What would you do to make this particular type of content into topics?
How to substitute your custom CSS when using DITA Open Toolkit transforms
September 07, 2006 : When you want to use the DITA Open Toolkit transforms but you want to use your own CSS, here’s how to substitute your CSS for HTML Help (CHM)
DITA Open ToolKit now has a User Guide
August 22, 2006: Just released last week, the DITA Open ToolKit now has its own User Guide
Using the DITA catalog for your specializations, creating a Public ID
August 16, 2006 : Thought our discovery might help you as you specialize DITA
Evaluating XML editors for DITA
August 01, 2006: Notes from the July 2006 Central Texas DITA User Group meeting
A web-form-based DITA editor
July 14, 2006: Could this be the perfect storm for a DITA wiki?
Troubleshooting tip for the DITA Open Toolkit install
June 23, 2006 : Finally figured out the fix for my DITA Open Toolkit “resource/messages.xml” not found error
Where to put your files and other setup for DITA
June 09, 2006: Working with the environment setup for DITA
Defining OPML and relating to DITA maps
May 31, 2006: I found a nice definition for OPML from whatis.com as their word of the day, and I’m starting to wonder about similarities between OPML and DITA maps
Learning more about DITA
May 18, 2006: Learning about how to get started with DITA and a trivia item for fun
Notes from the central Texas DITA user group meeting
April 21, 2006: Two speakers shared their takeaways from DITA 2006 and CMS 2006
Our DITA experience at BMC Software
March 02, 2006: Link to a case study published about BMC’s DITA experience
DITA from the trenches
February 20, 2006: Information Architect from IBM, Kristin Thomas, presented to the Central Texas DITA User’s Group meeting last week, and here are my notes.
Moving from Books to Topic-oriented Writing
January 27, 2006 : A report from JoAnn Hackos’ talk at the Central Texas DITA Users Group meeting January 2006
DITA and wiki combo
December 05, 2005: Darwin Information Typing Architecture, meet Wiki.
Darwin Information Typing Architecture - DITA (dih tuh)
November 04, 2005: Roundup of the DITA reading I’ve been diving back in to lately.
A watched folder for publishing from DITA source files
This post describes creating a watched folder that runs DITA transforms on content that is copied into the folder on a shared server. It also gives instructions for using this “transform engine” to output both PDF and CHM files using the default DITA Open Toolkit transform files. I devised this set up so that we could test our prototypes while we model our existing content, and I wanted to share it with others who are getting started with DITA on a small scale.
Now for the disclaimers! To many, reading my batch file coding will be like watching amateur mic night at an improv comedy club, but I welcome suggestions and improvements to this system. I offer it without warranty and fully disclose that the batch files actually delete files on your system (in a space-saving effort) and may very well fill up your hard drive with generated PDF and CHM files. So don’t say I didn’t warn you! I tell you, use at your own risk.
Now that I’ve disclaimed appropriately, I want to say that I think it offers a bootstrap automation effort for DITA builds and I wanted to give it out in case it helps others.
Prerequisites
Ensure that WinZip can be run within a batch file (command line).
The batch files for the server-based transform engine call WinZip using DOS commands. In order to ensure that the version of WinZip that the server is using supports command-line calls, download and install the Winzip Command Line Support Plug-In from this link.
Ensure that the DITA Open Toolkit works properly
The DITA Open Toolkit must be installed and running correctly on a Windows computer by installing all the pre-requisites and testing transforms. Refer to the documentation accompanying the DITA Open Toolkit to meet this prerequisite. Basically, you’ll need the DITA Open Toolkit, available at http://sourceforge.net/project/showfiles.php?group_id=132728. Download and unpackage the zip on your hard drive. The full packages of the DITA Open Toolkit contain all the sub-tools that you need for full evaluation from authoring to building output. Most of these tools require the Java Platform, so, Java is a prerequisite to using the DITA Open Toolkit. Download and install the Java Platform Standard Edition (SE) 5.0, available at http://java.sun.com/j2se/index.jsp.
Ensure that the Idiom Plug-in works properly
To run PDF2 transforms, follow these instructions to install the pre-requisites for it and install the plug-in itself. http://dita-ot.sourceforge.net/doc/ot-userguide13/xhtml/plugins/installing_fo.html. For some reason, this detailed-level topic has been eliminated from the 1.3.1 documentation, and I couldn’t find another detailed installation topic like this one, so, that’s why I’m linking to an outdated topic in the DITA Open Toolkit.
Download the bootstrap automation files
Download this zip of batch files, ant files, and a custom css file that make up the “transform engine.” The “engine” consists of five batch files and three Ant build files. They are currently set to work in a DITA-base directory named c:\DITA-OT1.3.1 but you can rename the DITA-base directory as needed.
Installing the transform engine on a shared server
- In the DITA Open Toolkit working directory, create a dita_in directory. For example, c:\dita-ot\dita_in.
- Unzip the batch files and Ant build files into the <dita-ot>\dita_in directory.
- Unzip the CSS file into the <dita-ot>\css directory.
- Edit the files if needed to match your directory structure. For example, the DITA working directory is set to C:\DITA-OT1.3.1 and you might need to change that in every file to match your environment.
- Enable sharing for the dita_in folder.
- In the DITA Open Toolkit working directory, create a dita_out directory.
- Enable sharing for the dita_out folder.
- Copy the bmc_dita_chm.css file to the DITA Open Toolkit working directory in the css directory, for example C:\DITA-OT1.3.1\css. The ant CHM build file uses this CSS file to substitute a Verdana-font-based CSS file instead of the default DITA CSS.
- Create a Windows Scheduled Task to run the dita_in\buildDITA.bat file every 10 minutes.
Submitting DITA maps to be transformed
- Place all topic files, graphics files, and the ditamap file in a folder, ensuring that the map file has the .ditamap extension and is in the root directory.
- Zip the folder into a zip file. Be sure to check the Save full path info option.
You can name the zip file anything. - Copy the zip file into the \\serverName\dita_in folder.
The next time the buildDITA.bat scheduled task starts, it will kick off the transforms. - Wait at least 10-12 minutes for the transform to complete.
Note: The transform itself should not take this long, but the timing of the watched batch file to run is scheduled on 10 minute intervals. - Once the transforms are complete, copy the PDF and CHM files from the \\serverName\dita_out\htmlhelp and \\serverName\dita_out\pdf or \pdf2 folders.Thanks to the renameOutputFiles.bat batch file, the file names will have a time/date stamp with the following notation: yymmdd_hhmmss.pdf. Example: 052507_101540.pdf. Also, extra files that are generated during the transform are deleted with this batch file, so you can modify that batch file if you want to keep dita.list and other precursor files.
That’s all there is to it. Please let me know your feedback and suggestions for improvement.
