The <task> element is the top-level element for a task topic. Tasks are the main building blocks for task-oriented user assistance. They generally provide step-by-step instructions that will enable a user to perform a task. A task answers the question of "how to?" by telling the user precisely what to do and the order in which to do it. Tasks have the same high-level structure as other topics, with a title, short description and body.
<task id="sqlj"> <title>Creating an SQLJ file</title> <taskbody> <context>Once you have set up SQLJ, you need to create a new SQLJ file. </context> <steps> <step><cmd>Open...</cmd></step> </steps> </taskbody> </task>
Doctype | Content model |
---|---|
ditabase | ( ( title) then ( titlealts) (optional) then ( shortdesc or abstract) (optional) then ( prolog) (optional) then ( taskbody) (optional) then ( related-links) (optional) then ( topic or concept or task or reference or glossentry) (any number) ) |
task | ( ( title) then ( titlealts) (optional) then ( shortdesc or abstract) (optional) then ( prolog) (optional) then ( taskbody) (optional) then ( related-links) (optional) then ( task) (any number) ) |
- topic/topic task/task
Name | Description | Data Type | Default Value | Required? |
---|---|---|---|---|
id | This ID enables topics to be referenced uniquely by topicrefs in DITA maps. | ID | Yes | |
conref | This attribute is used to reference an ID on a topic that can be reused. See The conref attribute for examples and details about the syntax. | CDATA | #IMPLIED | No |
xmlns:ditaarch | Declares the default DITA namespace. | CDATA | #FIXED http://dita.oasis-open.org/architecture/2005/ | |
DITAArchVersion | Designates the version of the architecture that is in use. | CDATA | "1.1" (version dependent; will increase) | No |
domains | Indicates the specialized domains that are included in the DTD or Schema. | CDATA | (topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic indexing-d) | No |
%select-atts; (props, base, platform, product, audience, otherprops, importance, rev, status) | A set of related attributes, described at %select-atts; | parameter entity | PE not applicable | Not applicable |
%localization-atts; (translate, xml:lang, dir) | A set of related attributes, described at %localization-atts;. | parameter entity | PE not applicable | Not applicable |
%global-atts; (xtrf, xtrc) | A set of related attributes, described at %global-atts; | parameter entity | PE not applicable | Not applicable |
class, outputclass | Common attributes described in Other common DITA attributes. |
Return to main page.
OASIS DITA Language Specification v1.1 -- Committee Draft 13 February 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.