What’s new, cool, useful and powerful in DITA. Learn DITA best practices.


What happens when source content is bloated? DITA, minimalism, and agile development.

,
Too often, when we work on a DITA implementation we spend a lot of time on the bells and whistles of our CMS or the DITA-OT publishing scripts. But, often the content is bloated, uses unsemantic markup, is riddled with duplication, and suffers…

How to add a DITA specialization to oXygen Editor or oXygen Author

,
Congratulations. You just got your brand new DITA specialization. And, you want to use it.  Follow these instructions to successfully integrate your DITA Specialization to oXygen Editor or oXygen Author. These instructions apply when the…
using equations and math symbols in DITA

Including equations in DITA content

There are three possible containers for equations in the equation domain: equation-inline, equation-block, and equation-figure. Choose the DITA elements that makes the most sense for your equations: inline, in a separate block, and/or an equation…
using equations and math symbols in DITA

Should you use tables in DITA?

Writers are conditioned to using tables. We are creatures of habit, and using tables in DITA seems to come naturally if you are used to writing in Word or FrameMaker. Bottom line: When you need to present information that will be table-like…
using equations and math symbols in DITA

How to describe choices in a DITA task topic?

Why use <choices> or <choicetables> instead of <ol> or <ul> in a task topic when you need to choose what to do next? DITA markup offers different options for describing choices in a DITA task topic. The benefit of <choices>…
using equations and math symbols in DITA

Polygamous or Monogamous DITA Topics?

Embedding multiple topics inside one topic file (polygamous topics) is not good practice. We call these topics, "polygamous topics". If, in real life, polygamy tends to be a really bad idea, the same is true for DITA topics. The golden…
using equations and math symbols in DITA

How to organize a bookmap: nesting under the element

How you organize a bookmap will affect how easy or difficult it will be for you to maintain and update your content. Should you nest a DITA map under the <chapter> element in a bookmap, or should you nest topics directly under the <chapter>…
using equations and math symbols in DITA

Nest DITA topics under a topic or under a topichead?

When you have a collection of DITA topics to nest, or individual DITA topics to next, you have a lot of choices. Often, too many choices. In a ditamap, you can nest DITA topics under a topic, <topichead> or <topicgroup>. In a…
using equations and math symbols in DITA

Group topics in DITA maps

Referring to DITA maps from a bookmap or from another DITA map provides a great way for grouping topics. You can refer to the DITA map in the bookmap, or in a parent ditamap, whenever you want to include the collection of topics in the bookmap. Tip: You…
using equations and math symbols in DITA

DITA Bookmaps or regular DITA maps?

Bookmaps enable users to organize their DITA information into front matter, parts, chapters, and back matter. Typically, publications are created from a bookmap while DITA maps are used for simpler documents, or to group topics for reference…