The <substeps> element allows you to break a step down into a series of separate actions, and should be used only if necessary. Try to describe the steps of a task in a single level of steps. If you need to use more than one level of substep nesting, you should probably rewrite the task to simplify it.


Note: These models represent only the default document types distributed by OASIS. Actual content models will differ with each new document type.
Doctype Content model
ditabase, task, machineryTask, learningContent (substep) (one or more)

Contained by

Doctype Content model
ditabase, task (strict), task (general), machineryTask, learningContent step


- topic/ol task/substeps


<substep><cmd>Hold pencil in a steady, level position.</cmd></substep>
<substep><cmd>Turn handle until resistance diminishes.</cmd>
<info>Note: initially, it may be somewhat difficult to turn the handle if 
pencil has never been sharpened before.</info></substep>
<substep><cmd>To determine if pencil is sharp, remove it from the sharpener 
and inspect the tip.</cmd></substep>


Name Description Data Type Default Value Required?
univ-atts attribute group (includes select-atts, id-atts, and localization-atts groups) A set of related attributes, described in univ-atts attribute group      
global-atts attribute group (xtrf, xtrc) A set of related attributes, described in global-atts attribute group      
class, outputclass Common attributes described in Other common DITA attributes      

Return to main page.

DITA v1.2 CS 01
Copyright © OASIS Open 2005, 2010. All Rights Reserved.