aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/books/fdp-primer/examples
diff options
context:
space:
mode:
authorGabor Kovesdan <gabor@FreeBSD.org>2013-11-07 15:39:28 +0000
committerGabor Kovesdan <gabor@FreeBSD.org>2013-11-07 15:39:28 +0000
commit24d129e8d1984a0b46a543bc523b63d216813bb0 (patch)
tree7dd0501c857c6f2139f4a71191c93bf19136412a /en_US.ISO8859-1/books/fdp-primer/examples
parent35f1d6c78be90eb13320d655cd68f94333a0ab26 (diff)
downloaddoc-24d129e8d1984a0b46a543bc523b63d216813bb0.tar.gz
doc-24d129e8d1984a0b46a543bc523b63d216813bb0.zip
- Definitively upgrade to DocBook 5.0
Notes
Notes: svn path=/projects/db5/; revision=43125
Diffstat (limited to 'en_US.ISO8859-1/books/fdp-primer/examples')
-rw-r--r--en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml174
1 files changed, 86 insertions, 88 deletions
diff --git a/en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml b/en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml
index f8a98e33fc..6b6ea42ca9 100644
--- a/en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml
+++ b/en_US.ISO8859-1/books/fdp-primer/examples/appendix.xml
@@ -30,8 +30,7 @@
$FreeBSD$
-->
-
-<appendix id="examples">
+<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="examples">
<title>Examples</title>
<para>This appendix contains example <acronym>XML</acronym> files
@@ -46,7 +45,7 @@
examine the <acronym>XML</acronym> source for this and other
documents available in the <application>svn</application>
<literal>doc</literal> repository, or available online starting at
- <ulink url="http://svnweb.FreeBSD.org/doc/"></ulink>.</para>
+ <uri xlink:href="http://svnweb.FreeBSD.org/doc/">http://svnweb.FreeBSD.org/doc/</uri>.</para>
<para>To avoid confusion, these examples use the standard DocBook
4.1 <acronym>DTD</acronym> rather than the &os; extension. They
@@ -55,106 +54,106 @@
Documentation Project. This makes them more useful as generic
DocBook examples.</para>
- <sect1 id="examples-docbook-book">
- <title>DocBook <sgmltag>book</sgmltag></title>
+ <sect1 xml:id="examples-docbook-book">
+ <title>DocBook <tag>book</tag></title>
<example>
- <title>DocBook <sgmltag>book</sgmltag></title>
+ <title>DocBook <tag>book</tag></title>
<programlisting>&lt;!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"&gt;
-<sgmltag class="starttag">book lang='en'</sgmltag>
- <sgmltag class="starttag">bookinfo</sgmltag>
- <sgmltag class="starttag">title</sgmltag>An Example Book<sgmltag class="endtag">title</sgmltag>
+<tag class="starttag">book lang='en'</tag>
+ <tag class="starttag">bookinfo</tag>
+ <tag class="starttag">title</tag>An Example Book<tag class="endtag">title</tag>
- <sgmltag class="starttag">author</sgmltag>
- <sgmltag class="starttag">firstname</sgmltag>Your first name<sgmltag class="endtag">firstname</sgmltag>
- <sgmltag class="starttag">surname</sgmltag>Your surname<sgmltag class="endtag">surname</sgmltag>
- <sgmltag class="starttag">affiliation</sgmltag>
- <sgmltag class="starttag">address</sgmltag><sgmltag class="starttag">email</sgmltag>foo@example.com<sgmltag class="endtag">email</sgmltag><sgmltag class="endtag">address</sgmltag>
- <sgmltag class="endtag">affiliation</sgmltag>
- <sgmltag class="endtag">author</sgmltag>
+ <tag class="starttag">author</tag>
+ <tag class="starttag">firstname</tag>Your first name<tag class="endtag">firstname</tag>
+ <tag class="starttag">surname</tag>Your surname<tag class="endtag">surname</tag>
+ <tag class="starttag">affiliation</tag>
+ <tag class="starttag">address</tag><tag class="starttag">email</tag>foo@example.com<tag class="endtag">email</tag><tag class="endtag">address</tag>
+ <tag class="endtag">affiliation</tag>
+ <tag class="endtag">author</tag>
- <sgmltag class="starttag">copyright</sgmltag>
- <sgmltag class="starttag">year</sgmltag>2000<sgmltag class="endtag">year</sgmltag>
- <sgmltag class="starttag">holder</sgmltag>Copyright string here<sgmltag class="endtag">holder</sgmltag>
- <sgmltag class="endtag">copyright</sgmltag>
+ <tag class="starttag">copyright</tag>
+ <tag class="starttag">year</tag>2000<tag class="endtag">year</tag>
+ <tag class="starttag">holder</tag>Copyright string here<tag class="endtag">holder</tag>
+ <tag class="endtag">copyright</tag>
- <sgmltag class="starttag">abstract</sgmltag>
- <sgmltag class="starttag">para</sgmltag>If your book has an abstract then it should go here.<sgmltag class="endtag">para</sgmltag>
- <sgmltag class="endtag">abstract</sgmltag>
- <sgmltag class="endtag">bookinfo</sgmltag>
+ <tag class="starttag">abstract</tag>
+ <tag class="starttag">para</tag>If your book has an abstract then it should go here.<tag class="endtag">para</tag>
+ <tag class="endtag">abstract</tag>
+ <tag class="endtag">bookinfo</tag>
- <sgmltag class="starttag">preface</sgmltag>
- <sgmltag class="starttag">title</sgmltag>Preface<sgmltag class="endtag">title</sgmltag>
+ <tag class="starttag">preface</tag>
+ <tag class="starttag">title</tag>Preface<tag class="endtag">title</tag>
- <sgmltag class="starttag">para</sgmltag>Your book may have a preface, in which case it should be placed
- here.<sgmltag class="endtag">para</sgmltag>
- <sgmltag class="endtag">preface</sgmltag>
+ <tag class="starttag">para</tag>Your book may have a preface, in which case it should be placed
+ here.<tag class="endtag">para</tag>
+ <tag class="endtag">preface</tag>
- <sgmltag class="starttag">chapter</sgmltag>
- <sgmltag class="starttag">title</sgmltag>My First Chapter<sgmltag class="endtag">title</sgmltag>
+ <tag class="starttag">chapter</tag>
+ <tag class="starttag">title</tag>My First Chapter<tag class="endtag">title</tag>
- <sgmltag class="starttag">para</sgmltag>This is the first chapter in my book.<sgmltag class="endtag">para</sgmltag>
+ <tag class="starttag">para</tag>This is the first chapter in my book.<tag class="endtag">para</tag>
- <sgmltag class="starttag">sect1</sgmltag>
- <sgmltag class="starttag">title</sgmltag>My First Section<sgmltag class="endtag">title</sgmltag>
+ <tag class="starttag">sect1</tag>
+ <tag class="starttag">title</tag>My First Section<tag class="endtag">title</tag>
- <sgmltag class="starttag">para</sgmltag>This is the first section in my book.<sgmltag class="endtag">para</sgmltag>
- <sgmltag class="endtag">sect1</sgmltag>
- <sgmltag class="endtag">chapter</sgmltag>
-<sgmltag class="endtag">book</sgmltag></programlisting>
+ <tag class="starttag">para</tag>This is the first section in my book.<tag class="endtag">para</tag>
+ <tag class="endtag">sect1</tag>
+ <tag class="endtag">chapter</tag>
+<tag class="endtag">book</tag></programlisting>
</example>
</sect1>
- <sect1 id="examples-docbook-article">
- <title>DocBook <sgmltag>article</sgmltag></title>
+ <sect1 xml:id="examples-docbook-article">
+ <title>DocBook <tag>article</tag></title>
<example>
- <title>DocBook <sgmltag>article</sgmltag></title>
+ <title>DocBook <tag>article</tag></title>
<programlisting>&lt;!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"&gt;
-<sgmltag class="starttag">article lang='en'</sgmltag>
- <sgmltag class="starttag">articleinfo</sgmltag>
- <sgmltag class="starttag">title</sgmltag>An Example Article<sgmltag class="endtag">title</sgmltag>
+<tag class="starttag">article lang='en'</tag>
+ <tag class="starttag">articleinfo</tag>
+ <tag class="starttag">title</tag>An Example Article<tag class="endtag">title</tag>
- <sgmltag class="starttag">author</sgmltag>
- <sgmltag class="starttag">firstname</sgmltag>Your first name<sgmltag class="endtag">firstname</sgmltag>
- <sgmltag class="starttag">surname</sgmltag>Your surname<sgmltag class="endtag">surname</sgmltag>
- <sgmltag class="starttag">affiliation</sgmltag>
- <sgmltag class="starttag">address</sgmltag><sgmltag class="starttag">email</sgmltag>foo@example.com<sgmltag class="endtag">email</sgmltag><sgmltag class="endtag">address</sgmltag>
- <sgmltag class="endtag">affiliation</sgmltag>
- <sgmltag class="endtag">author</sgmltag>
+ <tag class="starttag">author</tag>
+ <tag class="starttag">firstname</tag>Your first name<tag class="endtag">firstname</tag>
+ <tag class="starttag">surname</tag>Your surname<tag class="endtag">surname</tag>
+ <tag class="starttag">affiliation</tag>
+ <tag class="starttag">address</tag><tag class="starttag">email</tag>foo@example.com<tag class="endtag">email</tag><tag class="endtag">address</tag>
+ <tag class="endtag">affiliation</tag>
+ <tag class="endtag">author</tag>
- <sgmltag class="starttag">copyright</sgmltag>
- <sgmltag class="starttag">year</sgmltag>2000<sgmltag class="endtag">year</sgmltag>
- <sgmltag class="starttag">holder</sgmltag>Copyright string here<sgmltag class="endtag">holder</sgmltag>
- <sgmltag class="endtag">copyright</sgmltag>
+ <tag class="starttag">copyright</tag>
+ <tag class="starttag">year</tag>2000<tag class="endtag">year</tag>
+ <tag class="starttag">holder</tag>Copyright string here<tag class="endtag">holder</tag>
+ <tag class="endtag">copyright</tag>
- <sgmltag class="starttag">abstract</sgmltag>
- <sgmltag class="starttag">para</sgmltag>If your article has an abstract then it should go here.<sgmltag class="endtag">para</sgmltag>
- <sgmltag class="endtag">abstract</sgmltag>
- <sgmltag class="endtag">articleinfo</sgmltag>
+ <tag class="starttag">abstract</tag>
+ <tag class="starttag">para</tag>If your article has an abstract then it should go here.<tag class="endtag">para</tag>
+ <tag class="endtag">abstract</tag>
+ <tag class="endtag">articleinfo</tag>
- <sgmltag class="starttag">sect1</sgmltag>
- <sgmltag class="starttag">title</sgmltag>My First Section<sgmltag class="endtag">title</sgmltag>
+ <tag class="starttag">sect1</tag>
+ <tag class="starttag">title</tag>My First Section<tag class="endtag">title</tag>
- <sgmltag class="starttag">para</sgmltag>This is the first section in my article.<sgmltag class="endtag">para</sgmltag>
+ <tag class="starttag">para</tag>This is the first section in my article.<tag class="endtag">para</tag>
- <sgmltag class="starttag">sect2</sgmltag>
- <sgmltag class="starttag">title</sgmltag>My First Sub-Section<sgmltag class="endtag">title</sgmltag>
+ <tag class="starttag">sect2</tag>
+ <tag class="starttag">title</tag>My First Sub-Section<tag class="endtag">title</tag>
- <sgmltag class="starttag">para</sgmltag>This is the first sub-section in my article.<sgmltag class="endtag">para</sgmltag>
- <sgmltag class="endtag">sect2</sgmltag>
- <sgmltag class="endtag">sect1</sgmltag>
-<sgmltag class="endtag">article</sgmltag></programlisting>
+ <tag class="starttag">para</tag>This is the first sub-section in my article.<tag class="endtag">para</tag>
+ <tag class="endtag">sect2</tag>
+ <tag class="endtag">sect1</tag>
+<tag class="endtag">article</tag></programlisting>
</example>
</sect1>
- <sect1 id="examples-formatted">
+ <sect1 xml:id="examples-formatted">
<title>Producing Formatted Output</title>
<para>Before using these examples, install the required tools as
@@ -167,12 +166,12 @@
<title>Converting DocBook to <acronym>XHTML</acronym> (One
Large File)</title>
- <screen>&prompt.user; <userinput>jade -V nochunks \ <co id="examples-co-jade-1-nochunks"/>
- -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-1-catalog"/>
+ <screen>&prompt.user; <userinput>jade -V nochunks \ <co xml:id="examples-co-jade-1-nochunks"/>
+ -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ <co xml:id="examples-co-jade-1-catalog"/>
-c /usr/local/share/xml/docbook/catalog \
-c /usr/local/share/xml/jade/catalog \
- -d /usr/local/share/xml/docbook/dsssl/modular/html/docbook.dsl \<co id="examples-co-jade-1-dsssl"/>
- -t sgml <co id="examples-co-jade-1-transform"/> <replaceable>file</replaceable>.xml &gt; <replaceable>file</replaceable>.html <co id="examples-co-jade-1-filename"/></userinput></screen>
+ -d /usr/local/share/xml/docbook/dsssl/modular/html/docbook.dsl \<co xml:id="examples-co-jade-1-dsssl"/>
+ -t sgml <co xml:id="examples-co-jade-1-transform"/> file.xml &gt; file.html <co xml:id="examples-co-jade-1-filename"/></userinput></screen>
<calloutlist>
<callout arearefs="examples-co-jade-1-nochunks">
@@ -223,11 +222,11 @@
Small Files)</title>
<screen>&prompt.user; <userinput>jade \
- -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-2-catalog"/>
+ -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ <co xml:id="examples-co-jade-2-catalog"/>
-c /usr/local/share/xml/docbook/catalog \
-c /usr/local/share/xml/jade/catalog \
- -d /usr/local/share/xml/docbook/dsssl/modular/html/docbook.dsl \<co id="examples-co-jade-2-dsssl"/>
- -t sgml <co id="examples-co-jade-2-transform"/> <replaceable>file</replaceable>.xml <co id="examples-co-jade-2-filename"/></userinput></screen>
+ -d /usr/local/share/xml/docbook/dsssl/modular/html/docbook.dsl \<co xml:id="examples-co-jade-2-dsssl"/>
+ -t sgml <co xml:id="examples-co-jade-2-transform"/> file.xml <co xml:id="examples-co-jade-2-filename"/></userinput></screen>
<calloutlist>
<callout arearefs="examples-co-jade-2-catalog">
@@ -273,18 +272,18 @@
for splitting output.</para>
</example>
- <example id="examples-docbook-postscript">
+ <example xml:id="examples-docbook-postscript">
<title>Converting DocBook to &postscript;</title>
<para>The source <acronym>XML</acronym> file must be converted
to a &tex; file.</para>
- <screen>&prompt.user; <userinput>jade -V tex-backend \ <co id="examples-co-jade-3-tex-backend"/>
- -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ <co id="examples-co-jade-3-catalog"/>
+ <screen>&prompt.user; <userinput>jade -V tex-backend \ <co xml:id="examples-co-jade-3-tex-backend"/>
+ -c /usr/local/share/xml/docbook/dsssl/modular/catalog \ <co xml:id="examples-co-jade-3-catalog"/>
-c /usr/local/share/xml/docbook/catalog \
-c /usr/local/share/xml/jade/catalog \
- -d /usr/local/share/xml/docbook/dsssl/modular/print/docbook.dsl \<co id="examples-co-jade-3-dsssl"/>
- -t tex <co id="examples-co-jade-3-tex"/> <replaceable>file</replaceable>.xml</userinput></screen>
+ -d /usr/local/share/xml/docbook/dsssl/modular/print/docbook.dsl \<co xml:id="examples-co-jade-3-dsssl"/>
+ -t tex <co xml:id="examples-co-jade-3-tex"/> file.xml</userinput></screen>
<calloutlist>
<callout arearefs="examples-co-jade-3-tex-backend">
@@ -320,7 +319,7 @@
run through <command>tex</command>, specifying the
<literal>&amp;jadetex</literal> macro package.</para>
- <screen>&prompt.user; <userinput>tex "&amp;jadetex" <replaceable>file</replaceable>.tex</userinput></screen>
+ <screen>&prompt.user; <userinput>tex "&amp;jadetex" file.tex</userinput></screen>
<para><command>tex</command> commands must be run
<emphasis>at least</emphasis> three times. The first run
@@ -342,12 +341,12 @@
necessary.</para>
<para>The output from this stage will be
- <filename><replaceable>file</replaceable>.dvi</filename>.</para>
+ <filename>file.dvi</filename>.</para>
<para>Finally, run <command>dvips</command> to convert the
<filename>.dvi</filename> file to &postscript;.</para>
- <screen>&prompt.user; <userinput>dvips -o <replaceable>file</replaceable>.ps <replaceable>file.dvi</replaceable></userinput></screen>
+ <screen>&prompt.user; <userinput>dvips -o file.ps file.dvi</userinput></screen>
</example>
<example>
@@ -355,20 +354,19 @@
<para>The first part of this process is identical to that of
converting DocBook to &postscript;, using the same
- <command>jade</command> command line (<xref
- linkend="examples-docbook-postscript"/>).</para>
+ <command>jade</command> command line (<xref linkend="examples-docbook-postscript"/>).</para>
<para>After the <filename>.tex</filename> file has been
generated, run <application>pdfTeX</application>.
However, use the <literal>&amp;pdfjadetex</literal> macro
package instead.</para>
- <screen>&prompt.user; <userinput>pdftex "&amp;pdfjadetex" <replaceable>file</replaceable>.tex</userinput></screen>
+ <screen>&prompt.user; <userinput>pdftex "&amp;pdfjadetex" file.tex</userinput></screen>
<para>Again, run this command three times.</para>
<para>This will generate
- <filename><replaceable>file</replaceable>.pdf</filename>,
+ <filename>file.pdf</filename>,
which does not need to be processed any further.</para>
</example>
</sect2>