Create separate xml source files for anticipated FAQ and Glossary sections (as

appendices). Add sections from Chris's proposed outline, and add a links
section.
This commit is contained in:
hal 2003-06-12 02:41:03 +00:00
parent dec9452716
commit 744a673068
3 changed files with 189 additions and 4 deletions

View File

@ -2,11 +2,12 @@
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://docbook.org/xml/4.2/docbookx.dtd" [
<!ENTITY % draft "IGNORE" >
<!ENTITY % release "INCLUDE" >
<!ENTITY doctitle "Anti-Spam HOWTO"> ]>
<!ENTITY faq SYSTEM "faq.xml">
<!ENTITY glossary SYSTEM "glossary.xml">
<!ENTITY doctitle "Anti-Spam HOWTO"> ]>
<!--
File : $Source$
Purpose : Main file for the Anti-Spam-HOWTO
@ -67,7 +68,8 @@
</articleinfo>
<!-- Content follows...include introduction, license information, feedback -->
<!-- ~~~~~~~~ New section Header ~~~~~~~~~ -->
<sect1 id="intro">
<title>Introduction</title>
@ -188,5 +190,71 @@
</sect1>
<!-- ~ End section ~ -->
<!-- ~~~~~~~~ New section Header ~~~~~~~~~ -->
<sect1 id="technology">
<title>Anti-Spam Technology</title>
<para>
</para>
</sect1>
<!-- ~ End section ~ -->
<!-- ~~~~~~~~ New section Header ~~~~~~~~~ -->
<sect1 id="lfiltering">
<title>Local Filtering</title>
<para>
</para>
</sect1>
<!-- ~ End section ~ -->
<!-- ~~~~~~~~ New section Header ~~~~~~~~~ -->
<sect1 id="sfiltering">
<title>Site Filtering</title>
<para>
</para>
</sect1>
<!-- ~ End section ~ -->
<!-- ~~~~~~~~ New section Header ~~~~~~~~~ -->
<sect1 id="protocols">
<title>Network Protocols</title>
<para>
</para>
</sect1>
<!-- ~ End section ~ -->
<!-- ~~~~~~~~ New section Header ~~~~~~~~~ -->
<sect1 id="links">
<title>References</title>
<para>
Placeholder for list of links and reference material.
</para>
</sect1>
<!-- external entities -->
&glossary;
&faq;
</article>

View File

@ -0,0 +1,59 @@
<!--
File : $Source$
Purpose : FAQ for Anti-Spam-HOWTO Appendix
$Id$
The Anti-Spam-HOWTO team Welcomes you ;-)
-->
<appendix id="faq">
<title>FAQ</title>
<qandaset>
<qandaentry>
<question>
<para><emphasis>
What is spam?
</emphasis></para>
</question>
<answer>
<para>
Meat.
</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para><emphasis>
Why is there so much spam?
</emphasis></para>
</question>
<answer>
<para>
'Cause.
</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para><emphasis>
How do I get it, when it is addressed to someone else?
</emphasis></para>
</question>
<answer>
<para>
Just 'cause.
</para>
</answer>
</qandaentry>
</qandaset>
</appendix>

View File

@ -0,0 +1,58 @@
<!--
File : $Source$
Purpose : Glossary for Anti-Spam-HOWTO Appendix
$Id$
The Anti-Spam-HOWTO team Welcomes you ;-)
-->
<!--
HB: I cannot get this markup to work:
<glossary><title>Example Glossary</title>
<para>
This is not a real glossary, it's just an example.
</para>
<glossdiv><title>E</title>
<glossentry id="xml"><glossterm>Extensible Markup Language</glossterm>
<acronym>XML</acronym>
<glossdef>
<para>Some reasonable definition here.</para>
<glossseealso otherterm="sgml">
</glossdef>
</glossentry>
</glossdiv>
</glossary>
So ... we go with this ...
-->
<appendix>
<title>Glossary</title>
<para>
<variablelist>
<varlistentry>
<term>Spam</term>
<listitem>
<para>
Unsolicted electronic mail (or usenet postings), often commercial in
nature, typically targeting many individuals at the same time, and where
the sender's actual real identity is concealed from his victim.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</appendix>