One of the greatest benefits of using DITA is specialization. However, specialized DITA is more challenging and expensive to implement than standard, out-of-the-box DITA, which is something you should consider before you take the plunge.
When you’re coming up with a metadata strategy for your content, you should start by developing a taxonomy, or a hierarchy used to organize metadata. A taxonomy will help shape your metadata strategy and make implementation of that strategy possible. In this follow-up post to Making metadata in DITA work for you, you’ll learn some tips for creating a taxonomy that will succeed in helping your audience—both internal and external—find what they need.
This year’s tekom/tcworld conference reinforced the ongoing doctrinal chasm between North American technical communication and German technical communication.
I am speaking, of course, of the proper role of DITA in technical communication. If any.
March 2025 update: Read this article to learn about what’s new with LearningDITA. The Introduction to DITA course is still free, and you can sign up for courses at store.scriptorium.com.
Thank you all for your great response to our DITA courses at LearningDITA.com (over 500 registrants and counting)! Now that you’ve got your feet wet with the Introduction, concept topic type, and task topic type courses, are you ready for the next challenge?
Dave Young – originally posted to Flickr as surfer chicks
Thanks to everyone who has signed up for LearningDITA.com and taken the free Introduction to DITA course. The introductory course offers a high-level overview of DITA.
Want a deeper dive into the DITA information types (concept, topic, reference, and glossary)? Today, we are releasing our second course on the DITA concept topic. The course and supporting videos were created by a Scriptorium team led by Gretyl Kinsey (with help from Simon Bate, Jake Campbell, and me).
In testing one day, I was running a set of sample content through the DITA-OT, and much to my consternation, the build was succeeding, but generating no content. The error log helped to ferret out the source of the problem; the preprocessor was attempting to extract a linktext and navtitle from an image file that could not be found.
The image in question was a keyref pulled in from a map referenced in the main map file. Everything validated, previews showed the images resolving correctly, yet the images steadfastly refused to be pulled in during preprocessing—so what was wrong?
Metadata is one of the most important factors in making the most of your DITA XML-based content environment. Whether you’re converting legacy content into DITA or creating new structured content, it’s important to know what metadata (or data about data) your files will keep track of and why. Coming up with a plan for using metadata can be tricky, so here are some tips to make the process easier.
March 2025 update: Read this article to learn about what’s new with LearningDITA. The Introduction to DITA course is still free, and you can sign up for courses at store.scriptorium.com.
Our DITA learning site, LearningDITA.com, is now live with its first course, Introduction to DITA.
This guest post is by Carlos Evia, Ph.D., the director of Professional and Technical Writing at Virginia Tech.
The DITA Troubleshooting topic is one of the “new” features in version 1.3 of the standard. However, troubleshooting has been around the DITA world for some good eight years now.
This post provides an overview of techniques you can use to handle conditional content in DITA. The need for complex conditions is a common reason organizations choose DITA as their content model. As conditional requirements get more complex, the basic Show/Hide functionality offered in many desktop publishing tools is no longer sufficient.
Conditional processing is especially interesting–or maybe problematic—when you combine it with reuse requirements. You identify a piece of content that could be reused except for one small bit that needs to be different in the two reuse scenarios.
