chapter.docbook.list.xml

<?xml version="1.0" encoding="UTF-8"?>
<chapter id="list">
	<title>Lists 项目符号与编号</title>
	<info>
		<keywordset>
			<keyword>calloutlist, glosslist, itemizedlist, listitem, orderedlist, segmentedlist, simplelist, variablelist</keyword>
		</keywordset>
	</info>
	<para>calloutlist, glosslist, itemizedlist, listitem, orderedlist, segmentedlist, simplelist, variablelist</para>
	<section id="itemizedlist">
		<title>itemizedlist 符号列表</title>
		<para>itemizedlist</para>
		<programlisting>
		<![CDATA[
<itemizedlist>
	<listitem><para>item 1</para></listitem>
	<listitem><para>item 2</para></listitem>
	<listitem><para>item 3</para></listitem>
</itemizedlist>

<itemizedlist>
	<title>Title</title>
	<listitem>item 1</listitem>
	<listitem>item 2</listitem>
	<listitem>item 3</listitem>
</itemizedlist>
		]]>
		</programlisting>
		<itemizedlist>
			<listitem>
				<para>item 1</para>
			</listitem>
			<listitem>
				<para>item 2</para>
			</listitem>
			<listitem>
				<para>item 3</para>
			</listitem>
		</itemizedlist>
		<programlisting>
		<![CDATA[
<itemizedlist mark='opencircle'>
<listitem>
<para>
Item 1
</para>
</listitem>
<listitem override='bullet'>
<para>
Item 2
</para>
</listitem>
<listitem>
<para>
Item 3
</para>
</listitem>
</itemizedlist>
		]]>
		</programlisting>
		<itemizedlist mark='opencircle'>
			<listitem>
				<para>
					Item 1
				</para>
			</listitem>
			<listitem override='bullet'>
				<para>
					Item 2
				</para>
			</listitem>
			<listitem>
				<para>
					Item 3
				</para>
			</listitem>
		</itemizedlist>
	</section>
	<section id="orderedlist">
		<title>orderedlist 编号列表</title>
		<para>普通列表 orderedlist</para>
		<programlisting>
		<![CDATA[
<orderedlist>
	<title>普通列表</title>
	<listitem><para>列表内容 1</para></listitem>
	<listitem><para>列表内容 2</para></listitem>
	<listitem><para>列表内容 3</para></listitem>
</orderedlist>
			]]>
		</programlisting>
		<para>有序列表可以指定序号形式（arabic，upperalpha，loweralpha，upperroman，lowerroman）</para>
		<programlisting>
		<![CDATA[
<orderedlist numeration="lowerroman">
	<listitem><para>One</para></listitem>
	<listitem><para>Two</para></listitem>
	<listitem><para>Three</para></listitem>
	<listitem><para>Four</para></listitem>
</orderedlist>

<orderedlist numeration="loweralpha">
	<title>Title</title>
	<listitem>One</listitem>
	<listitem>Two</listitem>
	<listitem>Three</listitem>
	<listitem>Four</listitem>
</orderedlist>
		]]>
		</programlisting>
		<orderedlist>
			<title>普通列表</title>
			<listitem>
				<para>列表内容 1</para>
			</listitem>
			<listitem>
				<para>列表内容 2</para>
			</listitem>
			<listitem>
				<para>列表内容 3</para>
			</listitem>
		</orderedlist>
	</section>
	<section id="simplelist">
		<title>simplelist 简单列表</title>
		<para>简单列表只是分行显示</para>
		<example>
			<title>SimpleList</title>
			<programlisting>
			<![CDATA[
<para>Here is a <tag>SimpleList</tag>, rendered inline:
<simplelist type='inline'>
	<member>A</member>
	<member>B</member>
	<member>C</member>
	<member>D</member>
	<member>E</member>
	<member>F</member>
	<member>G</member>
</simplelist>
</para>
			]]>
			</programlisting>
			<para>
				Here is a
				<tag>SimpleList</tag>
				, rendered inline:
				<simplelist type='inline'>
					<member>A</member>
					<member>B</member>
					<member>C</member>
					<member>D</member>
					<member>E</member>
					<member>F</member>
					<member>G</member>
				</simplelist>
			</para>

			<programlisting>
			<![CDATA[
<para>Here is the same <tag>SimpleList</tag> rendered horizontally with
three columns:
<simplelist type='horiz' columns='3'>
<member>A</member>
<member>B</member>
<member>C</member>
<member>D</member>
<member>E</member>
<member>F</member>
<member>G</member>
</simplelist>
</para>
			]]>
			</programlisting>
			<para>
				Here is the same
				<tag>SimpleList</tag>
				rendered horizontally with
				three columns:
				<simplelist type='horiz' columns='3'>
					<member>A</member>
					<member>B</member>
					<member>C</member>
					<member>D</member>
					<member>E</member>
					<member>F</member>
					<member>G</member>
				</simplelist>
			</para>

			<programlisting>
			<![CDATA[
<para>Finally, here is the list rendered vertically:
<simplelist type='vert' columns='3'>
<member>A</member>
<member>B</member>
<member>C</member>
<member>D</member>
<member>E</member>
<member>F</member>
<member>G</member>
</simplelist>
</para>
			]]>
			</programlisting>
			<para>
				Finally, here is the list rendered vertically:
				<simplelist type='vert' columns='3'>
					<member>A</member>
					<member>B</member>
					<member>C</member>
					<member>D</member>
					<member>E</member>
					<member>F</member>
					<member>G</member>
				</simplelist>
			</para>
		</example>
	</section>
	<section id="variablelist">
		<title>variablelist 定义列表</title>
		<para>定义列表主要用于名词解释</para>
		<programlisting>
		<![CDATA[
<variablelist>
  <title>A variable list</title>
  <varlistentry>
    <term>First term</term>
    <listitem>
      <para>Definition or explanation.</para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term>Second term</term>
    <listitem>
      <para>Definition or explanation.</para>
    </listitem>
  </varlistentry>
</variablelist>


		]]>
		</programlisting>
		<variablelist>
			<title>A variable list</title>
			<varlistentry>
				<term>First term</term>
				<listitem>
					<para>Definition or explanation.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>Second term</term>
				<listitem>
					<para>Definition or explanation.</para>
				</listitem>
			</varlistentry>
		</variablelist>
		<programlisting>
		<![CDATA[
<variablelist>
	<title>Font Filename Extensions</title>
	<varlistentry>
		<term>
			<filename>TTF</filename>
		</term>
		<listitem>
			<para>TrueType fonts.</para>
		</listitem>
	</varlistentry>
	<varlistentry>
		<term>
			<filename>PFA</filename>
		</term>
		<term>
			<filename>PFB</filename>
		</term>
		<listitem>
			<para>
				PostScript fonts.
				<filename>PFA</filename>
				files are common on
				<acronym>UNIX</acronym>
				systems,
				<filename>PFB</filename>
				files
				are more common on Windows systems.
			</para>
		</listitem>
	</varlistentry>
</variablelist>		
		]]>
		</programlisting>
		<variablelist>
			<title>Font Filename Extensions</title>
			<varlistentry>
				<term>
					<filename>TTF</filename>
				</term>
				<listitem>
					<para>TrueType fonts.</para>
				</listitem>
			</varlistentry>
			<varlistentry>
				<term>
					<filename>PFA</filename>
				</term>
				<term>
					<filename>PFB</filename>
				</term>
				<listitem>
					<para>
						PostScript fonts.
						<filename>PFA</filename>
						files are common on
						<acronym>UNIX</acronym>
						systems,
						<filename>PFB</filename>
						files
						are more common on Windows systems.
					</para>
				</listitem>
			</varlistentry>
		</variablelist>
	</section>
	<section id="segmentedlist">
		<title>segmentedlist</title>
		<screen>
		<![CDATA[
<segmentedlist>
	<segtitle>Name</segtitle>
	<segtitle>Occupation</segtitle>
	<segtitle>Favorite Food</segtitle>
	<seglistitem>
		<seg>Tux</seg>
		<seg>Linux mascot</seg>
		<seg>Herring</seg>
	</seglistitem>
	<seglistitem>
		<seg>Konqui</seg>
		<seg>The KDE Dragon</seg>
		<seg>Gnomes</seg>
	</seglistitem>
</segmentedlist>
		]]>
		</screen>

		<segmentedlist>
			<segtitle>Name</segtitle>
			<segtitle>Occupation</segtitle>
			<segtitle>Favorite Food</segtitle>
			<seglistitem>
				<seg>Tux</seg>
				<seg>Linux mascot</seg>
				<seg>Herring</seg>
			</seglistitem>
			<seglistitem>
				<seg>Konqui</seg>
				<seg>The KDE Dragon</seg>
				<seg>Gnomes</seg>
			</seglistitem>
		</segmentedlist>

	</section>
	<section id="procedure">
		<title>procedure 过程</title>
		<para>procedure</para>
		<programlisting>
		<![CDATA[
<procedure>
	<title>A procedure</title>
	<step>
		<para>Do this.</para>
	</step>

	<step>
		<para>Then do this.</para>
	</step>

	<step>
		<para>And now do this.</para>
	</step>
</procedure>
		]]>
		</programlisting>
		<programlisting>
		<![CDATA[
<procedure>
  <title>A procedure</title>
  <step>
    <para>Step 1.</para>
  </step>
  <step>
    <para>Step 2.</para>
    <substeps>
      <step>
        <para>Substep a.</para>
      </step>
      <step>
        <para>Substep b.</para>
      </step>
    </substeps>
  </step>
  <step>
    <para>Step 3.</para>
  </step>
</procedure>
		]]>
		</programlisting>
		<procedure>
			<title>A procedure</title>
			<step>
				<para>Do this.</para>
			</step>

			<step>
				<para>Then do this.</para>
			</step>

			<step>
				<para>And now do this.</para>
			</step>
		</procedure>
		<procedure>
			<title>A procedure</title>
			<step>
				<para>Step 1.</para>
			</step>
			<step>
				<para>Step 2.</para>
				<substeps>
					<step>
						<para>Substep a.</para>
					</step>
					<step>
						<para>Substep b.</para>
					</step>
				</substeps>
			</step>
			<step>
				<para>Step 3.</para>
			</step>
		</procedure>
	</section>
	<section id="qandaset">
		<title>question/answer 问答</title>
		<screen>
		<![CDATA[
<qandaset>
	<qandaentry>
		<question>
			<para>What are little boys made of?</para>
		</question>
		<answer>
			<para>Snips and snails and puppy dog tails.</para>
		</answer>
	</qandaentry>
	<qandaentry>
		<question>
			<para>What are little girls made of?</para>
		</question>
		<answer>
			<para>Sugar and spice and everything nice.</para>
		</answer>
	</qandaentry>
</qandaset>
		]]>
		</screen>

		<qandaset>
			<qandaentry>
				<question>
					<para>What are little boys made of?</para>
				</question>
				<answer>
					<para>Snips and snails and puppy dog tails.</para>
				</answer>
			</qandaentry>
			<qandaentry>
				<question>
					<para>What are little girls made of?</para>
				</question>
				<answer>
					<para>Sugar and spice and everything nice.</para>
				</answer>
			</qandaentry>
		</qandaset>
		<screen>
		<![CDATA[
<article xmlns='http://docbook.org/ns/docbook'>
    <title>Example qandaset</title>
    
    <qandaset defaultlabel='qanda'>
      <qandaentry>
        <question>
          <para>To be, or not to be?</para>
        </question>
        <answer>
   		    <para>That is the question.</para>
        </answer>
   	  </qandaentry>
    </qandaset>

</article>		
		]]>
		</screen>
		<qandaset defaultlabel='qanda'>
			<qandaentry>
				<question>
					<para>To be, or not to be?</para>
				</question>
				<answer>
					<para>That is the question.</para>
				</answer>
			</qandaentry>
		</qandaset>
	</section>
	<section id="glosslist">
		<title>glosslist 注解</title>
		<programlisting>
		<![CDATA[
<article xmlns='http://docbook.org/ns/docbook'>
	<title>Example glosslist</title>

	<glosslist>
		<glossentry><glossterm>C</glossterm>
			<glossdef>
				<para>A procedural programming language invented by K&amp;R.</para>
			</glossdef>
		</glossentry>
		<glossentry><glossterm>Pascal</glossterm>
			<glossdef>
				<para>A procedural programming language invented by Niklaus Wirth.</para>
			</glossdef>
		</glossentry>
	</glosslist>

</article>		
		]]>
		</programlisting>
		<programlisting>
		<![CDATA[
<glosslist>
	<glossentry>
		<glossterm>C</glossterm>
		<glossdef>
			<para>
				A procedural programming language invented by K&amp;R.
			</para>
		</glossdef>
	</glossentry>
	<glossentry>
		<glossterm>Pascal</glossterm>
		<glossdef>
			<para>
				A procedural programming language invented by Niklaus Wirth.
			</para>
		</glossdef>
	</glossentry>
</glosslist>
		]]>
		</programlisting>

		<glosslist>
			<glossentry>
				<glossterm>C</glossterm>
				<glossdef>
					<para>
						A procedural programming language invented by K&amp;R.
					</para>
				</glossdef>
			</glossentry>
			<glossentry>
				<glossterm>Pascal</glossterm>
				<glossdef>
					<para>
						A procedural programming language invented by Niklaus Wirth.
					</para>
				</glossdef>
			</glossentry>
		</glosslist>
	</section>

	<section id="glossary">
		<title>glossary 术语表</title>
		<programlisting>
		<![CDATA[
<glossary><title>词汇表的例子</title>
	<glossdiv><title>E</title>

		<glossentry id="xml"><glossterm>Extensible Markup Language</glossterm>
			<acronym>XML</acronym>
			<glossdef>
			<para>关于XML的定义...</para>
			<glossseealso otherterm="sgml">
			</glossdef>
		</glossentry>

	</glossdiv>
</glossary>
		]]>
		</programlisting>
		<para>引用</para>
		<programlisting>
		<![CDATA[
<glossterm linkend="xml">Extensible Markup Language</glossterm> is a new standard…
		]]>
		</programlisting>
	</section>

</chapter>