From Fedora Project Wiki

m (added DocsProject header)
(→‎DocBook preparation: Changed editors to contributors)
Line 23: Line 23:
</pre>
</pre>


GNU Emacs is the standard tool for DocsProject work.  Although contributors may use any tool they wish for initial markup and drafts, most DocsProject [[DocsProject/Editors| editors]]  use Emacs for markup and editing.  Emacs recognizes "sentences" as being groups of words followed by a period (or "full stop") and two spaces.  The convention of following a period with two spaces has fallen out of the mainstream.  This short command will take care of most instances of this irregularity:
GNU Emacs is the standard tool for DocsProject work.  Although contributors may use any tool they wish for initial markup and drafts, most DocsProject [[DocsProject/Contributors| contributors]]  use Emacs for markup and editing.  Emacs recognizes "sentences" as being groups of words followed by a period (or "full stop") and two spaces.  The convention of following a period with two spaces has fallen out of the mainstream.  This short command will take care of most instances of this irregularity:


<pre>
<pre>
sed -i 's/\. \([A-Z] \)/\.  \1/g' my-docbook-file.xml
sed -i 's/\. \([A-Z] \)/\.  \1/g' my-docbook-file.xml
</pre>
</pre>


== Docbook Validation ==
== Docbook Validation ==

Revision as of 17:46, 20 June 2008

Useful Scripts

We do not expect every writer or editor to be an extremely experienced system administrator. This page is part of the overall effort to lower entry barriers to the DocsProject. Some of the scripts here are also used in various FDP processes.

DocBook preparation

The DocsProject does not use DocBook <sect1>...<sect9> tags for sections in final markup, because this reduces the portability of sections. Use <section> instead. Similarly, although sections should each have an id attribute, the attribute should not use a section number (like "s2-some-section"). Use "sn-some-section" instead.

The following command will fix this irregularity:

sed -i 's/<\(\/\)\?sect[0-9] /<\1section/g' my-docbook-file.xml

Similarly, although sections should each have an id attribute, the attribute should not use a section number (like "s2-some-section"). Use "sn-some-section" instead.

The following command will fix this irregularity:

sed -i 's/id="s[0-9] -/id="sn-/g' my-docbook-file.xml

GNU Emacs is the standard tool for DocsProject work. Although contributors may use any tool they wish for initial markup and drafts, most DocsProject contributors use Emacs for markup and editing. Emacs recognizes "sentences" as being groups of words followed by a period (or "full stop") and two spaces. The convention of following a period with two spaces has fallen out of the mainstream. This short command will take care of most instances of this irregularity:

sed -i 's/\. \([A-Z] \)/\.  \1/g' my-docbook-file.xml

Docbook Validation

GavinHenry was getting quite fed up when running:

make html

and the xml not being valid because of typos, so he wrote a tiny wrapper for xmllint, a xmlto program.

It's a Perl program.

Or you could just use (previously undocumented) the document build system feature:

make validate-xml
make validate-xml-en_US

Package Listing

This Python script can be used for listing packages for the ReleaseNotes .