<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 5. Flood Configuration File</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="Flood manual" /><link rel="up" href="index.html" title="Flood manual" /><link rel="prev" href="ch04.html" title="Chapter 4. Running Flood" /><link rel="next" href="ch05s02.html" title="XML Survival Guide" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 5. Flood Configuration File</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch04.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch05s02.html">Next</a></td></tr></table><hr /></div><div class="chapter" title="Chapter 5. Flood Configuration File"><div class="titlepage"><div><div><h2 class="title"><a id="id279699"></a>Chapter 5. Flood Configuration File</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch05.html#id279707">About File format</a></span></dt><dt><span class="section"><a href="ch05s02.html">XML Survival Guide</a></span></dt><dt><span class="section"><a href="ch05s03.html">Mass URLs retrieval</a></span></dt></dl></div><p>This sections discusses flood configuration file.</p><div class="section" title="About File format"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id279707"></a>About File format</h2></div></div></div><p>
Flood XML parsing is built around apr-util XML capabilities, which
in turn are based on tweaked version of James Clark's marvelous
expat library. Because of that flood understands XML v1.0, so you
schould start your configuration file with following processing
instruction (PI for short):
</p><pre class="screen">
<?xml version="1.0"?>
</pre><p>
It is not required by flood, but it's good practice and may be
useful if you decide to use other XML tools for additional
processing. Please note, that expat support for different
encodings is rather limited. In particular it understands only
UTF-8 and ISO-8859-1 encodings, so processing of your
configuration may fail if you specify different encoding in your
configuration file, like this:
</p><pre class="screen">
<?xml version="1.0" encoding="iso-8859-2"?>
</pre><p>
Please note, that you can get around that limitation, by converting
you national characters to UTF-8. Flood itself only checks XML file
for well-formdess, which means checking if it is formed after basic
XML rules. If you want to do full validation of flood configuration
file, you may want to include following line right next to XML
processing instruction:
</p><pre class="screen">
<!DOCTYPE configuration SYSTEM "flood.dtd">
</pre><p>
With this declaration you can use software with validating XML
parser (like ASF's Xalan) and validate your configuration before
actually processing it with flood. That way you can ensure, that
flood.xml file is valid and obeys flood configuration rules. You
can find <code class="filename">flood.dtd</code> in
<code class="filename">examples/</code>directory relative
to package root directory.
</p><p>
Please note that all configure elements in flood aren't using
their own dedicated XML namespace, so if you (for some reason)
intend to mix flood configuration file with other XML, you may
experience tag name collision.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch04.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch05s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 4. Running Flood </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> XML Survival Guide</td></tr></table></div></body></html>
distrib
>
Mandriva
>
2010.1
>
x86_64
>
media
>
contrib-release
>
by-pkgid
>
ca66b76e2240674c05aaf276e07079a2
>
files
>
34
