DITA快速入门¶

官网说明：https://docs.oasis-open.org/dita/v1.0/archspec/topicover.html

各种Topic类型¶

General Topic

<topic id="topic">
<title>Some little topic</title>
<body>
    <p>Here's a little topic.</p>
    <ul>
    <li>Some item</li>
    <li>Another item</li>
    </ul>
</body>
</topic>

Concept Topic

<concept id="concept">
<title>Bird Calling</title>
    <conbody>
    <p>Bird calling attracts birds.</p>
    <example>
    <p>Bird calling requires learning:</p>
    <ul>
        <li>Popular and classical bird songs</li>
        <li>How to whistle like a bird</li>
    </ul>
    </example>
    </conbody>
</concept>

Task Topic

<task id="ertx">
<title>Creating an ERTX file</title>
    <taskbody>
    <context>Each morning before breakfast you need to
    create a fresh ERTX file.</context>
    <steps>
    <step><cmd>Start ERTX.</cmd></step></steps>
    <step><cmd>Click New ERTX File.</cmd></step></steps>
    </steps>
    <result>You now have your ERTX file for today!</result>
    </taskbody>
</task>

Reference Topic

<reference id = "boldproperty">
<title>Bold property</title>
<shortdesc>(Read-write) Whether to use a bold font for the specified
text string.</shortdesc>
<refbody>
<refsyn>
    <synph>
    <var>object</var><delim>.</delim><kwd>Font</kwd><delim>.</delim>
    <kwd>Bold</kwd><delim> = </delim><var>trueorfalse</var>
    </synph>
</refsyn>
<properties>
    <property>
    <proptype>Data type</proptype>
    <propvalue>Boolean</propvalue>
    </property>
    <property>
    <proptype>Legal values</proptype>
    <propvalue>True (1) or False (0)</propvalue>
    </property>
</properties>
</refbody>
</reference>

DITA MAP

<topicref href="A.dita" collection-type="sequence">
<topicref href="A1.dita"/>
<topicref href="A2.dita"/>
</topicref>
<reltable>
<relrow>
    <relcell>A.dita</relcell>
    <relcell>B.dita</relcell>
</relrow>
</reltable>

task.dita¶

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task id="replace" xml:lang="zh-cn">
    <title>更换燃气灶电池</title>
    <shortdesc></shortdesc>
    <taskbody>
    <prereq>务必需要关上阀门</prereq>
    <steps>
        <step>
            <cmd>打开电池盒</cmd>
        </step>
        <step>
            <cmd>去除旧电池</cmd>
        </step>
        <step>
            <cmd>装上新电池</cmd>
        </step>
        <step>
            <cmd>合上电池盖</cmd>
        </step>
    </steps>

    </taskbody>
</task>

concept.dita¶

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="gas">
<title>电火花原理</title>
<shortdesc>电火花由电池点火发出。</shortdesc>
<conbody>
    <p>脉冲点火的工作原理：输气管→阀体通孔→气阀芯→电磁阀阀门→引射管→喷嘴（与空气一次混合）→炉头→风门→火盖（与空气二次混合），遇火后燃烧</p>
</conbody>

</concept>

map.ditamap¶

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "map.dtd">

<map xml-lang="zh-cn">
<title>更换燃气灶电池</title>
<topicref href="concept.xml" type="concept"/>
<topicref href="task.xml" type="task"/>
</map>

DITA OT¶

发布命令： bin/dita --input=sourfile --format=pdf