XML Source of "taskMod.xsd"
See Also: |
|
Schema Location: |
http://docs.oasis-open.org/dita/v1.1/OS/schema/taskMod.xsd |
XML Source
<?xml version="1.0" encoding="UTF-8"?>
<!-- ============================================================= -->
<!-- HEADER -->
<!-- ============================================================= -->
<!-- MODULE: DITA Task XSD Module -->
<!-- VERSION: 1.1 -->
<!-- DATE: November 2006 -->
<!-- -->
<!-- ============================================================= -->
<!-- ============================================================= -->
<!-- SYSTEM: Darwin Information Typing Architecture (DITA) -->
<!-- -->
<!-- PURPOSE: W3C XML Schema to describe DITA Tasks -->
<!-- -->
<!-- ORIGINAL CREATION DATE: -->
<!-- March 2001 -->
<!-- -->
<!-- (C) Copyright OASIS-Open.org 2005, 2006 -->
<!-- (C) Copyright IBM Corporation 2001, 2004. -->
<!-- All Rights Reserved. -->
<!-- ============================================================= -->
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<!-- ==================== Import Section ======================= -->
<!-- Base type: univ-atts -->
<xs:attributeGroup ref="id-atts"/>
<xs:attribute name="base" type="xs:string"/>
<xs:attribute name="rev" type="xs:string"/>
</xs:attributeGroup>
<!-- Base type: importance-atts.class -->
<xs:restriction base="importance-atts.class">
<xs:enumeration value="optional"/>
<xs:enumeration value="required"/>
<xs:enumeration value="-dita-use-conref-target"/>
</xs:restriction>
</xs:simpleType>
<!-- Element declarations for task.mod -->
<xs:annotation>
<xs:documentation>
The <
<keyword>task</keyword>
> 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.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="task.class">
<xs:attribute default="- topic/topic task/task " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>taskbody</keyword>
> element is the main body-level
element inside a task topic. A task body has a very specific structure, with
the following elements in this order: <
<keyword>prereq</keyword>
>, <
<keyword>context</keyword>
>,
<
<keyword>steps</keyword>
>, <
<keyword>result</keyword>
, <
<keyword>example</keyword>
>
and <
<keyword>postreq</keyword>
>. Each of the body sections are optional.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="taskbody.class">
<xs:attribute default="- topic/body task/taskbody " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The pre-requisite (<
<keyword>prereq</keyword>
>) section of a
task should document things the user needs to know or do before starting the
current task. Prerequisite links will be placed in a list after the related-links
section; on output the <
<keyword>prereq</keyword>
> links from the related-links
section are added to the <
<keyword>prereq</keyword>
> section.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="prereq.class">
<xs:attribute default="- topic/section task/prereq " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>context</keyword>
> section of a task provides
background information for the task. This information helps the user understand
what the purpose of the task is and what they will gain by completing the
task. This section should be brief and does not replace or recreate a concept
topic on the same subject, although the context section may include some conceptual
information
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="context.class">
<xs:attribute default="- topic/section task/context " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>result</keyword>
> element describes the expected
outcome for the task as a whole.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="result.class">
<xs:attribute default="- topic/section task/result " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>postreq</keyword>
> element describes steps or
tasks that the user should do after the successful completion of the current
task. It is often supported by links to the next task or tasks in the <
<keyword>related-links</keyword>
>
section.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="postreq.class">
<xs:attribute default="- topic/section task/postreq " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
Each <
<keyword>choice</keyword>
> element describes one way that
the user could accomplish the current step.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="choice.class">
<xs:attribute default="- topic/li task/choice " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>step</keyword>
> element represents an action that
a user must follow to accomplish a task. Each step in a task must contain
a command <
<keyword>cmd</keyword>
> element which describes the particular
action the user must do to accomplish the overall task. The step element can
also contain information <
<keyword>info</keyword>
>, substeps <
<keyword>substeps</keyword>
>,
tutorial information <
<keyword>tutorialinfo</keyword>
>, a step example
<
<keyword>stepxmp</keyword>
>, choices <
<keyword>choices</keyword>
> or
a stepresult <
<keyword>stepresult</keyword>
>, although these are optional.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="step.class">
<xs:attribute default="- topic/li task/step " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
A <
<keyword>substep</keyword>
> element has the same structure
as a <
<keyword>step</keyword>
>, except that it does not allow lists of
choices or substeps within it, in order to prevent unlimited nesting of steps.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="substep.class">
<xs:attribute default="- topic/li task/substep " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
Like the <
<keyword>steps</keyword>
> element, the <
<keyword>steps-unordered</keyword>
>
section of a task provides the main content of the task topic, but particularly
for cases in which the order of steps may vary from one situation to another.
For example, fields of a form can be filled in without particular regard
to order as long as the required ones are filled in before submitting the
form. One or more steps is required inside the <
<keyword>steps-unordered</keyword>
>
section.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="steps-unordered.class">
<xs:attribute default="- topic/ul task/steps-unordered " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>choices</keyword>
> element contains a list of
<
<keyword>choice</keyword>
> elements. It is used when the user will need
to choose one of several actions while performing the steps of a task.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="choices.class">
<xs:attribute default="- topic/ul task/choices " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:element name="steps">
<xs:annotation>
<xs:documentation>
The <
<keyword>steps</keyword>
> section of a task provides the
main content of the task topic. The task is described as a series of steps
that the user must follow to accomplish the task. One or more <
<keyword>steps</keyword>
>
elements is required inside the <
<keyword>steps</keyword>
> section.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="steps.class">
<xs:attribute default="- topic/ol task/steps " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>substeps</keyword>
> 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.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="substeps.class">
<xs:attribute default="- topic/ol task/substeps " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The command (<
<keyword>cmd</keyword>
>) element is required as
the first element inside a <
<keyword>step</keyword>
>. It provides the active
voice instruction to the user for completing the step, and should not be more
than one sentence. If the step needs additional explanation, this can follow
the <
<keyword>cmd</keyword>
> element inside an
<ph>
<xref href="info.xml">info</xref>
</ph>
element.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="cmd.class">
<xs:attribute default="- topic/ph task/cmd " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The information element (<
<keyword>info</keyword>
>) occurs inside
a <
<keyword>step</keyword>
> element to provide additional information about
the step.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="info.class">
<xs:attribute default="- topic/itemgroup task/info " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The tutorial info (<
<keyword>tutorialinfo</keyword>
>) element
contains information that is included in a step when a task is part of a tutorial.
The <
<keyword>tutorialinfo</keyword>
> element allows you to turn a task
into a learning exercise by including explanatory content about methods for
completing the current step. This information is currently included in all
output processing results, not just tutorials. It is not for use in tasks
that are being used outside of tutorials.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="tutorialinfo.class">
<xs:attribute default="- topic/itemgroup task/tutorialinfo " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The step example (<
<keyword>stepxmp</keyword>
>) element is used
to illustrate a step of a task. The example can be a couple of words, or an
entire paragraph.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="stepxmp.class">
<xs:attribute default="- topic/itemgroup task/stepxmp " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>stepresult</keyword>
> element provides information
on the expected outcome of a step. If a user interface is being documented,
the outcome could describe a dialog box opening, or the appearance of a progress
indicator. Step results are useful to assure a user that they are on track,
but should not be used for every step, as this quickly becomes tedious.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="stepresult.class">
<xs:attribute default="- topic/itemgroup task/stepresult " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>choicetable</keyword>
> element contains a series
of optional choices available within a step of a task.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="choicetable.class">
<xs:attribute default="- topic/simpletable task/choicetable " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>chhead</keyword>
> element is a container inside
the <
<keyword>choicetable</keyword>
> element that provides specific heading
text to override the default
<b>Options</b>
and
<b>Description</b>
headings.
The <
<keyword>chhead</keyword>
> element contains both a
<ph>
<xref href="choptionhd.xml">choptionhd</xref>
</ph>
and
<ph>
<xref href="chdeschd.xml">chdeschd</xref>
</ph>
element as a pair.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="chhead.class">
<xs:attribute default="- topic/sthead task/chhead " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:element name="chrow">
<xs:annotation>
<xs:documentation>
The <
<keyword>chrow</keyword>
> element is a container inside
the <
<keyword>choicetable</keyword>
> element. The <
<keyword>chrow</keyword>
>
element contains both a <
<keyword>choption</keyword>
> and <
<keyword>chdesc</keyword>
>
element as a pair.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="chrow.class">
<xs:attribute default="- topic/chrow " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>choptionhd</keyword>
> element provides a specific
label for the list of options that a user chooses from to accomplish a step.
The default label for options is
<b>Option</b>
.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="choptionhd.class">
<xs:attribute default="- topic/stentry task/choptionhd " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>chdeschd</keyword>
> option provides a specific
label for the list of descriptions of options that a user must choose to accomplish
a step of a task. The default label overridden by <
<keyword>chdeschd</keyword>
>
is
<b>Description</b>
.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="chdeschd.class">
<xs:attribute default="- topic/stentry task/chdeschd " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>choption</keyword>
> element describes an option
that a user could choose to accomplish a step of a task. In a user interface,
for example, this might be the name of radio button.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="choption.class">
<xs:attribute default="- topic/stentry task/choption " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<xs:annotation>
<xs:documentation>
The <
<keyword>chdesc</keyword>
> element is a description of
an option that a user chooses while performing a step to accomplish a task.
It explains why the user would choose that option, and might explain the result
of the choice when it is not immediately obvious.
</xs:documentation>
</xs:annotation>
<xs:complexType mixed="true">
<xs:complexContent>
<xs:extension base="chdesc.class">
<xs:attribute default="- topic/stentry task/chdesc " ref="class"/>
</xs:extension>
</xs:complexContent>
</xs:complexType>
</xs:element>
<!-- Element declarations for task.mod -->
</xs:group>
<!-- Base type: topic.class -->
<xs:sequence>
<xs:group ref="title"/>
<xs:choice minOccurs="0">
</xs:choice>
<xs:group minOccurs="0" ref="prolog"/>
<xs:group minOccurs="0" ref="taskbody"/>
</xs:sequence>
<xs:attribute name="id" type="xs:ID" use="required"/>
<xs:attribute name="conref" type="xs:string"/>
</xs:complexType>
<!-- Base type: body.class -->
<xs:sequence>
<xs:group minOccurs="0" ref="prereq"/>
<xs:group minOccurs="0" ref="context"/>
<xs:choice maxOccurs="1" minOccurs="0">
</xs:choice>
<xs:group minOccurs="0" ref="result"/>
<xs:group minOccurs="0" ref="example"/>
<xs:group minOccurs="0" ref="postreq"/>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:sequence>
<xs:attribute name="base" type="xs:string"/>
</xs:complexType>
<!-- Base type: section.class -->
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:complexType>
<!-- Base type: section.class -->
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:complexType>
<!-- Base type: ol.class -->
<xs:choice>
<xs:group maxOccurs="unbounded" ref="step"/>
</xs:choice>
</xs:complexType>
<!-- Base type: ul.class -->
<xs:choice maxOccurs="unbounded" minOccurs="1">
</xs:choice>
</xs:complexType>
<!-- Base type: li.class -->
<xs:sequence>
<xs:group ref="cmd"/>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:sequence>
</xs:complexType>
<!-- Base type: ph.class -->
<xs:complexType mixed="true" name="cmd.class">
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
<xs:attribute name="keyref" type="xs:string"/>
</xs:complexType>
<!-- Base type: itemgroup.class -->
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:complexType>
<!-- Base type: ol.class -->
<xs:choice maxOccurs="unbounded">
</xs:choice>
</xs:complexType>
<!-- Base type: li.class -->
<xs:sequence>
<xs:group ref="cmd"/>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:sequence>
</xs:complexType>
<!-- Base type: itemgroup.class -->
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:complexType>
<!-- Base type: itemgroup.class -->
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:complexType>
<!-- Base type: ul.class -->
<xs:choice maxOccurs="unbounded">
</xs:choice>
</xs:complexType>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:complexType>
<!-- Base type: itemgroup.class -->
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:complexType>
<!-- Base type: section.class -->
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:complexType>
<!-- Base type: section.class -->
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
</xs:complexType>
<!-- Base type: simpletable.class -->
<xs:sequence>
<xs:group minOccurs="0" ref="chhead"/>
<xs:group maxOccurs="unbounded" minOccurs="0" ref="chrow"/>
</xs:sequence>
<xs:attribute name="keycol" type="xs:NMTOKEN"/>
<xs:attribute name="refcols" type="xs:NMTOKENS"/>
<xs:attribute name="spectitle" type="xs:string"/>
</xs:complexType>
<!-- Base type: sthead.class -->
<xs:sequence>
</xs:sequence>
</xs:complexType>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
<xs:attribute name="specentry" type="xs:string"/>
</xs:complexType>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
<xs:attribute name="specentry" type="xs:string"/>
</xs:complexType>
<xs:sequence>
</xs:sequence>
</xs:complexType>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
<xs:attribute name="specentry" type="xs:string"/>
</xs:complexType>
<xs:choice maxOccurs="unbounded" minOccurs="0">
</xs:choice>
<xs:attribute name="specentry" type="xs:string"/>
</xs:complexType>
</xs:schema>