Sophie

Sophie

distrib > Mandriva > 2010.1 > x86_64 > media > contrib-release > by-pkgid > ca66b76e2240674c05aaf276e07079a2 > files > 35

flood-1.1-3.r719568.3mdv2010.1.x86_64.rpm

<?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>XML Survival Guide</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="Flood manual" /><link rel="up" href="ch05.html" title="Chapter 5. Flood Configuration File" /><link rel="prev" href="ch05.html" title="Chapter 5. Flood Configuration File" /><link rel="next" href="ch05s03.html" title="Mass URLs retrieval" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">XML Survival Guide</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch05.html">Prev</a> </td><th width="60%" align="center">Chapter 5. Flood Configuration File</th><td width="20%" align="right"> <a accesskey="n" href="ch05s03.html">Next</a></td></tr></table><hr /></div><div class="section" title="XML Survival Guide"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id318859"></a>XML Survival Guide</h2></div></div></div><p>
            Preparing flood configuration file can be a little troublesome.
            At the time of writting this manual there are no external tools,
            that could aid in this process (although there are plans to
            develop those -- see next section). So you have to pick up editor
            that has some sort of XML support. For various Unix systems
            <span class="application">vi</span> and
            <span class="application">emacs</span> seems to be reasonable choices.
            You'll get colored syntax, possibly run-time (that is -- as you
            type) DTD checking and maybe other switches to help you work with
            XML files. 
            </p><p>
            There are characters that are used by XML markup itself, and you
            need a bit of magic when you want to use them as plain text.
            Everytime you need such a character, you'll have to reference it
            by an XML entity.  XML entities start with ampersand (character
            '&amp;') and end with semicolon (character ';'). Text between
            those character must refer to valid XML entity. Below is a table
            that lists all 'reserved' XML characters and their coresponding
            XML entities. 
            </p><div class="informaltable"><table border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th align="center">character name</th><th align="center">character glyph</th><th align="center">entity</th></tr></thead><tbody><tr><td align="center">ampersand</td><td align="center">&amp;</td><td align="center">&amp;amp;</td></tr><tr><td align="center">less than</td><td align="center">&lt;</td><td align="center">&amp;lt;</td></tr><tr><td align="center">greater than</td><td align="center">&gt;</td><td align="center">&amp;gt;</td></tr><tr><td align="center">apostrophe</td><td align="center">'</td><td align="center">&amp;apos;</td></tr><tr><td align="center">quotation mark</td><td align="center">"</td><td align="center">&amp;quot;</td></tr></tbody></table></div><p>
            If you intend to use international characters in your flood
            configuration file, and you don't have Unicode enabled editor,
            you'll have to encode those characters. XML has special entity
            for including just about any UTF-8 character. Basically it is
            &amp;#XXX; for decimal and &amp;#xXXX for hex where XXX is a
            Unicode character position. For example, polish letter "small
            letter a with ogonek" can be referenced as &amp;#261; (decimal)
            or &amp;#x105; (hex) while german umlaut (latin small letter u
            with diaeresis) schould be entered as &amp;#252; (decimal) or
            &amp;#xFC (hex). If you intend to use a lot of international
            characters, you'd better get Unicode enabled text editor, since
            number of XML entities will make your flood configuration file
            less readable (not to mention typing hassle).
            
            </p></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch05.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch05.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch05s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 5. Flood Configuration File </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Mass URLs retrieval</td></tr></table></div></body></html>