Diff for Writing DITA topics
Tue, 2007-09-18 23:05 by syeo | Tue, 2007-09-18 23:05 by syeo | ||
---|---|---|---|
Copy of the revision from Thu, 2007-06-21 20:45. | |||
< previous diff | next diff > | ||
Changes to Title | |||
- | DITA Topics and Information Typing | + | Writing DITA topics |
Changes to Body | |||
Line 1 | Line 1 | ||
- | <p>DITA topics are the basic units of DITA content.</p>
| + | <p>
|
- | <p>Topics are the basis for high-quality information. Each topic is organized around a single subject or answers a single question.</p>
| + | DITA topics are the basic units of DITA content.
|
- | <p>Each topic is typically authored as a unit. It consists of a title, which captures the subject of the topic, and further content.</p>
| + | </p>
|
- | <p>As stated in the <a href="http://dita.xml.org/arch-intro">Introduction to the DITA architecture</a>, <a href="http://dita.xml.org/arch-topics">DITA topics</a> are organized by <a href="http://dita.xml.org/arch-maps">DITA maps</a>. It is also possible to nest sub-topics within a topic. <a href="http://dita.xml.org/arch-specialization">Specialization</a> enables the creation of specialized topics and other units of content that are tailored to particular structural requirements. <a href="http://dita.xml.org/arch-conref">Content referencing (conref)</a> enables fragments of content to be reused from a single source. <a href="http://dita.xml.org/node/1104">Conditional processing</a> permits a single source to support the needs of multiple audiences.</p>
| + | <p>
|
- | <p>The architectural specification describes topics and information typing at</p>
| + | Topics are the basis for high-quality information. Each topic is organized around a single subject or answers a single question.
|
+ | </p>
| ||
+ | <p>
| ||
+ | Each topic is typically authored as a unit. It consists of a title, which captures the subject of the topic, and further content.
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | As stated in the <a href="/arch-intro">Introduction to the DITA architecture</a>, <a href="/arch-topics">DITA topics</a> are organized by <a href="/arch-maps">DITA maps</a>. It is also possible to nest sub-topics within a topic. <a href="/arch-specialization">Specialization</a> enables the creation of specialized topics and other units of content that are tailored to particular structural requirements. <a href="/arch-conref">Content referencing (conref)</a> enables fragments of content to be reused from a single source. <a href="/node/1104">Conditional processing</a> permits a single source to support the needs of multiple audiences.
| ||
+ | </p>
| ||
+ | <p>
| ||
+ | The architectural specification describes topics and information typing at
| ||
+ | </p>
| ||
<ul>
| <ul>
| ||
- | <li><font face="Lucida Sans Unicode" size="2"><a href="http://docs.oasis-open.org/dita/v1.0/archspec/topicover.html">http://docs.oasis-open.org/dita/v1.0/archspec/topicover.html</a>.</font> </li>
| + | <li><span style="font-size: x-small; font-family: Lucida Sans Unicode"><a href="http://docs.oasis-open.org/dita/v1.0/archspec/topicover.html">http://docs.oasis-open.org/dita/v1.0/archspec/topicover.html</a>.</span> </li>
|
</ul>
| </ul>
| ||
- | <p>Editors for the Architecture area:</p>
| + | <p>
|
+ | Editors for the Architecture area:
| ||
+ | </p>
| ||
<ul>
| <ul>
| ||
- | <li><a title="View user profile." href="http://dita.xml.org/user/26"><strong><font color="#ac083e">Bruce Esrig</font></strong></a> </li>
| + | <li><a href="/user/26" title="View user profile."><strong><span style="color: #ac083e">Bruce Esrig</span></strong></a> </li>
|
- | <li><a title="View user profile." href="http://dita.xml.org/user/25"><strong><font color="#ac083e">Michael Priestley</font></strong></a> </li>
| + | <li><a href="/user/25" title="View user profile."><strong><span style="color: #ac083e">Michael Priestley</span></strong></a> </li>
|
- | </ul> | + | </ul>
|
+ |
Writing DITA topics
DITA topics are the basic units of DITA content.
Topics are the basis for high-quality information. Each topic is organized around a single subject or answers a single question.
Each topic is typically authored as a unit. It consists of a title, which captures the subject of the topic, and further content.
As stated in the Introduction to the DITA architecture, DITA topics are organized by DITA maps. It is also possible to nest sub-topics within a topic. Specialization enables the creation of specialized topics and other units of content that are tailored to particular structural requirements. Content referencing (conref) enables fragments of content to be reused from a single source. Conditional processing permits a single source to support the needs of multiple audiences.
The architectural specification describes topics and information typing at
Editors for the Architecture area: