Diff for Getting started

Wed, 2007-10-24 00:31 by syeoSun, 2007-11-25 07:18 by Bruce Esrig

+keyword

Changes to Body
Line 1Line 1
 
<p>
 
<p>
-
Getting started with DITA requires a multi-step process:
+
Getting started with DITA requires a multi-step process:
 
</p>
 
</p>
 
<ul>
 
<ul>
-
<li><strong>Understand the topic-based architecture underlying the DITA model.</strong>
+
<li><strong>Understand the topic-based architecture underlying the DITA model.</strong>
 
<p>
 
<p>
-
Topic-based authoring is the basis of DITA. In order to understand the best approach to DITA, first understand how to work with topics and structured writing. For information about topic-based authoring see <a href="/topic-based-authoring">http://dita.xml.org/topic-based-authoring</a>
+
Topic-based authoring is the basis of DITA. In order to understand the best approach to DITA, first understand how to work with topics and structured writing. For information about topic-based authoring see <a href="/topic-based-authoring">http://dita.xml.org/topic-based-authoring</a>
 
</p>
 
</p>
 
<p>
 
<p>
-
For information about structured writing and DITA implementation methodology, you may want to refer to <a href="/taxonomy/term/44">http://dita.xml.org/taxonomy/term/44</a>
+
For information about structured writing and DITA implementation methodology, you may want to refer to <a href="/taxonomy/term/44">http://dita.xml.org/taxonomy/term/44</a>
 
</p>
 
</p>
 
<p>
 
<p>
Line 16Line 16
 
Metadata and folder/repository structure definitions<br />
 
Metadata and folder/repository structure definitions<br />
 
Naming conventions<br />
 
Naming conventions<br />
-
Document definitions
+
Document definitions
 
</p>
 
</p>
 
</li>
 
</li>
 
</ul>
 
</ul>
 
<ul>
 
<ul>
-
<li><strong>Read the DITA Architecture and Language Specification to understand how the model works.</strong>
+
<li><strong>Read the DITA Architecture and Language Specification to understand how the model works.</strong>
 
<p>
 
<p>
 
For help creating your information model, you may find the DITA Architecture and Language Specification helpful. You can find both of these at<br />
 
For help creating your information model, you may find the DITA Architecture and Language Specification helpful. You can find both of these at<br />
 
<a href="http://docs.oasis-open.org/dita/v1.0/archspec/ditaspec.toc.html">Architectural Specification</a><br />
 
<a href="http://docs.oasis-open.org/dita/v1.0/archspec/ditaspec.toc.html">Architectural Specification</a><br />
 
<a href="http://docs.oasis-open.org/dita/v1.0/langspec/ditaref-type.toc.html">Language Specification</a><br />
 
<a href="http://docs.oasis-open.org/dita/v1.0/langspec/ditaref-type.toc.html">Language Specification</a><br />
-
The Language Specification provides you with element and attribute definitions you can use as part of the DITA standard. The DITA Architecture Specification provides you with information about the features DITA provides such as content reuse, conditional processing, and specialization.
+
The Language Specification provides you with element and attribute definitions you can use as part of the DITA standard. The DITA Architecture Specification provides you with information about the features DITA provides such as content reuse, conditional processing, and specialization.
 
</p>
 
</p>
 
</li>
 
</li>
-
<li><strong>Inventory your own content and transform it into topics.</strong>
+
<li><strong>Inventory your own content and transform it into topics.</strong>
 
<p>
 
<p>
 
In order to fully develop your processes and information model, consider developing a pilot project. Your pilot project should be small enough to not discourage employees and other stakeholders from continuing the project, but also large enough to fully test your content with the DITA model and test your workflow processes. <br />
 
In order to fully develop your processes and information model, consider developing a pilot project. Your pilot project should be small enough to not discourage employees and other stakeholders from continuing the project, but also large enough to fully test your content with the DITA model and test your workflow processes. <br />
-
It's best to first inventory your content to identify consistencies in structure and information you can minimalize and reuse. Then, start marking up your content using DITA markup to identify special needs to fit your content.<br />
+
It's best to first inventory your content to identify consistencies in structure and information you can minimalize and reuse. Then, start marking up your content using DITA markup to identify special needs to fit your content.<br />
 
<strong><br />
 
<strong><br />
 
</strong>
 
</strong>
 
</p>
 
</p>
 
</li>
 
</li>
-
<li><strong>Download the DITA Open Toolkit and processing information from Source Forge (sourceforge.com).</strong>
+
<li><strong>Download the DITA Open Toolkit and processing information from Source Forge (sourceforge.com).</strong>
 
<p>
 
<p>
 
For processing, you may want to use the DITA Open Toolkit to create PDF, XHTML pages, HTML Help (.chm), Java Help, and Eclipse Help. The DITA Open Toolkit provides processing and rendering techniques to create your output. You can find out more about the DITA Open Toolkit at <a href="/toolkit">http://dita.xml.org/toolkit</a><br />
 
For processing, you may want to use the DITA Open Toolkit to create PDF, XHTML pages, HTML Help (.chm), Java Help, and Eclipse Help. The DITA Open Toolkit provides processing and rendering techniques to create your output. You can find out more about the DITA Open Toolkit at <a href="/toolkit">http://dita.xml.org/toolkit</a><br />
-
Many vendors are also choosing to adopt the DITA Open Toolkit to integrate in their products to create DITA output. If you need to find out about authoring, storage, and processing tools to help with your DITA implementation, see <a href="/products-services">http://dita.xml.org/products-services<br />
+
Many vendors are also choosing to adopt the DITA Open Toolkit to integrate in their products to create DITA output. If you need to find out about authoring, storage, and processing tools to help with your DITA implementation, see <a href="/products-services">http://dita.xml.org/products-services<br />
 
</a>
 
</a>
 
</p>
 
</p>
 
</li>
 
</li>
-
<li><strong>Learn from all the information available on this site and others.</strong>
+
<li><strong>Learn from all the information available on this site and others.</strong>
 
<p>
 
<p>
-
Many companies have already adopted DITA successfully. This web site (<a href="//">http://dita.xml.org</a>) and other resources provide great learning material to create advanced DITA applications. You can find information about other resources at <a href="/taxonomy/term/42">http://dita.xml.org/taxonomy/term/42</a>
+
Many companies have already adopted DITA successfully. This web site (<a href="//">http://dita.xml.org</a>) and other resources provide great learning material to create advanced DITA applications. You can find information about other resources at <a href="/taxonomy/term/42">http://dita.xml.org/taxonomy/term/42</a>
 
</p>
 
</p>
 
</li>
 
</li>
 
</ul>
 
</ul>
 
<p>
 
<p>
-
<strong>Have Fun!</strong>
+
<strong>Have Fun!</strong>
 
</p>
 
</p>
 
<p>
 
<p>
-
For more information, see Michael Priestley's <a href="/node/1253">DITA<strong> </strong>Introduction and Authoring Workshop</a> presentation.
+
For more information, see Michael Priestley's <a href="/node/1253">DITA<strong> </strong>Introduction and Authoring Workshop</a> presentation.
 
</p>
 
</p>
 
 
Revision of Sun, 2007-11-25 07:18:

Preparing to move to DITA

Getting started with DITA requires a multi-step process:

  • Understand the topic-based architecture underlying the DITA model.

    Topic-based authoring is the basis of DITA. In order to understand the best approach to DITA, first understand how to work with topics and structured writing. For information about topic-based authoring see http://dita.xml.org/topic-based-authoring

    For information about structured writing and DITA implementation methodology, you may want to refer to http://dita.xml.org/taxonomy/term/44

    Creating an information model is the best way to provide your employees with a guideline to follow throughout your DITA adoption and implementation process. An information model includes information such as
    Information Type descriptions
    Content Unit descriptions
    Metadata and folder/repository structure definitions
    Naming conventions
    Document definitions

  • Read the DITA Architecture and Language Specification to understand how the model works.

    For help creating your information model, you may find the DITA Architecture and Language Specification helpful. You can find both of these at
    Architectural Specification
    Language Specification
    The Language Specification provides you with element and attribute definitions you can use as part of the DITA standard. The DITA Architecture Specification provides you with information about the features DITA provides such as content reuse, conditional processing, and specialization.

  • Inventory your own content and transform it into topics.

    In order to fully develop your processes and information model, consider developing a pilot project. Your pilot project should be small enough to not discourage employees and other stakeholders from continuing the project, but also large enough to fully test your content with the DITA model and test your workflow processes.
    It's best to first inventory your content to identify consistencies in structure and information you can minimalize and reuse. Then, start marking up your content using DITA markup to identify special needs to fit your content.

  • Download the DITA Open Toolkit and processing information from Source Forge (sourceforge.com).

    For processing, you may want to use the DITA Open Toolkit to create PDF, XHTML pages, HTML Help (.chm), Java Help, and Eclipse Help. The DITA Open Toolkit provides processing and rendering techniques to create your output. You can find out more about the DITA Open Toolkit at http://dita.xml.org/toolkit
    Many vendors are also choosing to adopt the DITA Open Toolkit to integrate in their products to create DITA output. If you need to find out about authoring, storage, and processing tools to help with your DITA implementation, see http://dita.xml.org/products-services

  • Learn from all the information available on this site and others.

    Many companies have already adopted DITA successfully. This web site (http://dita.xml.org) and other resources provide great learning material to create advanced DITA applications. You can find information about other resources at http://dita.xml.org/taxonomy/term/42

Have Fun!

For more information, see Michael Priestley's DITA Introduction and Authoring Workshop presentation.

XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I