All print materials and course samples are provided to attendees.
 

Follow up support on topics covered is available for 60 days.
 

Please contact us for a list of available dates.
 

This course is 2 days in duration.

Testimonial

Bernard's ability to not only understand deep technical issues, but explain them in terms that anyone would understand is second to none. He has solid reasoning skills and often thinks outside of the box in order to solve complex problems. Whether addressing business users or an entire IT department, his strong interpersonal skills give him the ability to work in any environment and be credible in that environment. If you are looking for someone to help you ensure the success of your project, I can wholeheartedly and without hesitation give Bernard my highest recommendation!

Bret Freeman, Business Development Manager EMEA, JustSystems, Inc.

This article is a part of a multiple article set. You can download and reuse it in numerous formats and lengths. If you plan to edit the content in any way, please contact us for permission first. If you share or distribute the article, please include the full article, including all contact information for the author.

Subsetting and customizing DITA (in 500 words)

Remember:

A complete copy of all 4000 words in the original version of this article can be found online at:

www.publishingsmarter.com

Subsetting, in the context of this document, means to remove or reorganize elements, attributes and attribute values to customize the way that options are presented, while ensuring all the DITA specifications are followed.

The three main reasons to subset include changing default tags, modifying the order or elements and adjusting the frequency of element use.

The default tags in the DITA specification include close to 200 elements. In many cases, tags provide features that are not required in your documentation or provide undesired redundancy.

Modifications to the default element order allow restrictions to the organization of information. If this still adheres to the principles of the DITA specification your content remains compliant and your authors have a guided workflow.

Many of the elements in the DITA specification allow child elements to appear with no restrictions. This means that, basically, authors can insert a wide variety of elements as often as desired.

Subsetting tags and attributes

There are close to 200 tags in the DITA specification. One of the easiest things you can do to make a DITA implementation simpler is to reduce the number of tags.

Remember that many of the attributes are reused throughout the DITA specification and it may be better to remove them on an element by element basis rather than removing them from the DITA specification completely.

Drawbacks to subsetting

There are two key drawbacks to consider before subsetting: tab limitation and stricter rule requirements. If a DITA implementation is well planned neither should be a major problem in managing the way DITA is used.

While subsetting helps to implement a stricter implementation of the DITA standard, it also deviates from it. By only supporting a key set of tags you restrict the ability to import other content that complies with the DITA specification.

By redefining the order of elements and their frequency, you effectively rule out some combinations of elements that others may use. In doing so, you may be limiting the usefulness of content that others provide that match the DITA specification.

Conclusion

Subsetting the DITA specification and modifying the default rules can provide many benefits to an organization. A restricted set of elements reduces the need to develop formatting and transformation rules for all possible combinations of elements. It also allows organizations to further control the types of content used and the way that they are used. This results in far more consistent documentation.

Author information

A recognized publishing technologies expert, Bernard Aschwanden presents at conferences and events across Europe and North America. Bernard is an Adobe Certified Expert, a Certified Technical Trainer, a senior member of the STC and the author of numerous publications on publishing and single sourcing.

Home Page: http://www.publishingsmarter.com