Blogs

Post new blog entry
View blogs by name

The DITA Caper

Converting FrameMaker content to DITA (brief)

FrameMaker 8 includes DITA support, and works well for creating new content.  Converting existing FrameMaker content poses a few challenges.  One of these challenges, converting FrameMaker cross references to Structured FrameMaker cross reference elements, is addressed herein.

Read more

DITA is not a PITA

When moving to structured authoring, DITA is working out to be less of a pain in the a** (PITA) than other options. The reason for this is that many of the tools have DITA support built in.

If you move to structured authoring and choose to make your own custom structure, there is set up you will need to do to get your tools publishing.  While all authoring tools require some kind of set up, I'll use FrameMaker as an example.  With a custom designed structure in FrameMaker, an EDD has to be created, the DTD or schema saved and adjusted, read/write rules written, and a Structured Application set up.  For DITA, FrameMaker's EDD, DTD, rules, and application are already built into the software.  So, with some tweaking of the FrameMaker DITA template (to look the way your docs are supposed to look) you can be up and running fairly quickly.

Read more

Do Wah DITA

One of the cool things about DITA is how applicable it is to multiple types of docs.  Lots of documents can be authored in a topic-oriented way, whether user guides or training guides or online help or ... whatever.

Read more