A few more simplifications and corrections to the structure chapter.
This commit is contained in:
parent
27144d9f43
commit
6384cc8971
Notes:
svn2git
2020-12-08 03:00:23 +00:00
svn path=/head/; revision=42311
1 changed files with 6 additions and 6 deletions
|
@ -56,7 +56,7 @@
|
|||
</listitem>
|
||||
</orderedlist>
|
||||
|
||||
<para>In addition, the documentation tree has to accommodate
|
||||
<para>In addition, the documentation tree must accommodate
|
||||
documents in many different languages and encodings. It is
|
||||
important that the documentation tree structure does not enforce
|
||||
any particular defaults or cultural preferences.</para>
|
||||
|
@ -172,7 +172,7 @@
|
|||
|
||||
<para>Not every <filename
|
||||
class="directory"><replaceable>lang</replaceable>.<replaceable>encoding</replaceable></filename>
|
||||
directory will contain all of these subdirectories. It depends
|
||||
directory will have all of these subdirectories. It depends
|
||||
on how much translation has been accomplished by that
|
||||
translation team.</para>
|
||||
</sect1>
|
||||
|
@ -189,7 +189,7 @@
|
|||
<subtitle><filename>books/handbook/</filename></subtitle>
|
||||
|
||||
<para>The Handbook is written in DocBook <acronym>XML</acronym>
|
||||
using the &os; DocBook extended DTD.</para>
|
||||
using the &os; DocBook extended <acronym>DTD</acronym>.</para>
|
||||
|
||||
<para>The Handbook is organized as a DocBook
|
||||
<sgmltag>book</sgmltag>. The book is divided into
|
||||
|
@ -264,7 +264,7 @@
|
|||
<para>Then it will be called
|
||||
<filename>chapter.xml</filename> in the
|
||||
<filename>kernelconfig</filename> directory. In general,
|
||||
the entire contents of the chapter will be held in this
|
||||
the entire contents of the chapter are in this one
|
||||
file.</para>
|
||||
|
||||
<para>When the <acronym>XHTML</acronym> version of the
|
||||
|
@ -281,9 +281,9 @@
|
|||
to include images in each chapter. Images for each
|
||||
Handbook chapter are stored within <filename
|
||||
class="directory">share/images/books/handbook</filename>.
|
||||
Note that the localized version of these images should be
|
||||
The localized version of these images should be
|
||||
placed in the same directory as the <acronym>XML</acronym>
|
||||
sources for each chapter. Namespace collisions would be
|
||||
sources for each chapter. Namespace collisions are
|
||||
inevitable, and it is easier to work with several
|
||||
directories with a few files in them than it is to work
|
||||
with one directory that has many files in it.</para>
|
||||
|
|
Loading…
Reference in a new issue