mirror of https://github.com/tLDP/LDP
converted another short section to bullet points
This commit is contained in:
parent
33db7e8a57
commit
4af8ba1038
|
@ -6,19 +6,27 @@
|
|||
<title>DocBook: Sample Markup</title>
|
||||
|
||||
<section id="writing-docbook">
|
||||
<title>Writing With DocBook Elements</title>
|
||||
<title>General Tips and Tricks</title>
|
||||
|
||||
<indexterm zone="writing-docbook">
|
||||
<primary>edition</primary>
|
||||
<secondary>using DocBook</secondary>
|
||||
</indexterm>
|
||||
|
||||
<para>
|
||||
For a general overview of what markup is all about, please read <xref
|
||||
linkend="ag-markup" />
|
||||
</para>
|
||||
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>An editor capable of inserting elements according to the
|
||||
<acronym>DTD</acronym> will help a lot since it will enforce
|
||||
the DTD.
|
||||
This way you can be sure that no invalid elements were added
|
||||
anywhere in your document.</para>
|
||||
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>In order to ensure that future changes are as easy as possible,
|
||||
authors should try to keep compatibility with
|
||||
the <acronym>XML</acronym> version of the DocBook DTD. This means
|
||||
|
@ -26,13 +34,15 @@
|
|||
attributes, and not omitting end tags. Most tools that
|
||||
automatically insert elements (like psgml+emacs) follow these
|
||||
rules automatically or with some fine tuning.</para>
|
||||
|
||||
<para>Each type of document created has a specific structure,
|
||||
and examples of documents can be found in the <xref
|
||||
linkend="templates" />.</para>
|
||||
|
||||
<para>Considering the explanation above we can proceed to instructions on
|
||||
how to write a document using DocBook.</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Each type of document created has a specific structure. This
|
||||
document is in <quote>book</quote> format. Most authors, however, will
|
||||
want to use the shorter <quote>article</quote> format instead.
|
||||
Templates are available from <xref linkend="templates" />.
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
|
||||
<section id="useful-markup">
|
||||
<title>Useful markup</title>
|
||||
|
|
Loading…
Reference in New Issue