diff options
Diffstat (limited to 'en_US/getting-files.xml')
| -rw-r--r-- | en_US/getting-files.xml | 45 |
1 files changed, 44 insertions, 1 deletions
diff --git a/en_US/getting-files.xml b/en_US/getting-files.xml index 21c6481..7789d4e 100644 --- a/en_US/getting-files.xml +++ b/en_US/getting-files.xml @@ -56,7 +56,50 @@ To work on existing documents in CVS, refer to <xref linkend="ch-cvs"/>. </para> - + <para>The most powerful component in the &FDP; toolbox is + <firstterm>DocBook XML</firstterm>. DocBook XML is a specific + scheme for authoring technical documentation using + <firstterm>Extensible Markup Language</firstterm>, or + <acronym>XML</acronym>. XML allows authors to mark pieces of + content with descriptive tags. The following output is an example + of DocBook XML:</para> + <screen><![CDATA[<article> + <title>A Very Short Article</title> + <para>This very short article is a + demonstration of DocBook XML in + its simplest form. Notice how the + tags <emphasis>describe</emphasis> + the content they surround, and how + that content fits into the meaning + of the text as a written work.</para> +</article>]]></screen> + <para>This example article, entitled <citetitle>A Very Short + Article</citetitle>, consists of only a single paragraph. The + tags, or markup, surround elements of content to define the sense + in which they are used. A paragraph, for example, is marked with + <sgmltag>para</sgmltag> tags. Text that requires emphasis is + marked with <sgmltag>emphasis</sgmltag> tags. The author does not + worry about the visual formatting such as italics or font size. + &FDP; build tools automatically perform all formatting + tasks.</para> + <para>The custom tools built by the &FDP; render DocBook source into + a variety of formats for publication and distribution. They also + allow translators to create localized versions of the XML + documents for &DISTRO; users around the world. The flexibility of + XML allows for a single document to be used many times for many + purposes, like reusable code for a programmer.</para> + <para>DocBook is iself very well documented. For more information + about DocBook, visit <ulink url="http://www.docbook.org/"/>. The + DocBook site also features complete browseable and downloadable + copies of <citetitle>DocBook: The Definitive Guide</citetitle>, + the canonical source for DocBook information.</para> + <note> + <title>DocBook XML Versions</title> + <para>DocBook XML, like a computer progam, has version numbers. + The version used by &FDP; right now is &DBVER;. The DocBook web + site may document a slightly newer version, but the majority of + the schema still applies.</para> + </note> </section> <section id="sn-getting-files-names"> |