tools/perl-5.8.0/doc/MHonArc/rcfileexs/utf-8.mrc.html

<html>
<body>
<pre>
&lt;!-- ================================================================== --&gt;
&lt;!--  File:
        $Id: utf-8.mrc,v 1.3 2002/07/27 05:13:13 ehood Exp $
      Author:
        Earl Hood &lt;earl@earlhood.com&gt;

      Description:
        MHonArc, &lt;http://www.mhonarc.org/&gt;, resource file to
        generate UTF-8 pages.

      Dependencies:
        Requires that the Unicode::String and Unicode::MapUTF8 modules are
        installed and the 'use utf8' Perl pragma is supported.

      Notes:
        The following is worth noting if you plan to generate UTF-8
        archives:

        * When defining text-oriented resources, try to stick
          with ASCII and use numeric character entity references
          for non-ASCII characters.  This will avoid any possible
          problems with resource variable expansion since resource
          variable detection is done in the raw, byte domain (i.e.
          a "character" is assumned to only comprise a single 8-bit
          byte).

        * Auto URL detection in text/plain messages could possibly
          munge characters since it is a non-UTF-8 operation.  However,
          the probability should be low.  If the problem becomes
          visible in messages, disable URL detection by specifying
          the "nourl" argument to m2h_text_plain::filter.

        * If using a search engine with MHonArc, make sure it
          supports UTF-8.
  --&gt;
&lt;!-- ==================================================================
--&gt;

&lt;!-- MHonArc::UTF8 uses the Unicode::MapUTF8 module to translate
     character data into UTF-8.  Besides US-ASCII data, we default
     that all character data should be converted to UTF-8.  The
     Unicode::MapUTF8 module has a large set of supported characters
     sets, so we should be covered for most locales.
  --&gt;

<b><a href="../resources/charsetconverters.html">&lt;CharsetConverters override&gt;</a></b>
plain;          mhonarc::htmlize;
us-ascii;       mhonarc::htmlize;
default;        MHonArc::UTF8::str2sgml;     MHonArc/UTF8.pm
<b>&lt;/CharsetConverters&gt;</b>

&lt;!-- MHonArc v2.5.10 introduced the following resource to control
     how text clipping is performed, mainly for resource variables
     (e.g. <b><a href="../rcvars.html#SUBJECTNA">$SUBJECTNA:72$</a></b>).
  --&gt;

<b><a href="../resources/textclipfunc.html">&lt;TextClipFunc&gt;</a></b>
MHonArc::UTF8::clip; MHonArc/UTF8.pm
<b>&lt;/TextClipFunc&gt;</b>

&lt;!-- The beginning page markup of MHonArc pages need to be modified
     to tell clients that the pages are in UTF-8 by using a
     &lt;meta http-equiv&gt; tag.

     The following resource settings are just the default settings
     for each resource but with the appropriate &lt;meta http-equiv&gt;
     tag added.
  --&gt;

<b><a href="../resources/idxpgbegin.html">&lt;IdxPgBegin&gt;</a></b>
&lt;!doctype html public "-//W3C//DTD HTML//EN"&gt;
&lt;html&gt;
&lt;head&gt;
&lt;title&gt;<b><a href="../rcvars.html#IDXTITLE">$IDXTITLE$</a></b>&lt;/title&gt;
&lt;meta http-equiv="Content-Type" content="text/html; charset=utf-8"&gt;
&lt;/head&gt;
&lt;body&gt;
&lt;h1&gt;<b><a href="../rcvars.html#IDXTITLE">$IDXTITLE$</a></b>&lt;/h1&gt;
<b>&lt;/IdxPgBegin&gt;</b>

<b><a href="../resources/tidxpgbegin.html">&lt;TIdxPgBegin&gt;</a></b>
&lt;!doctype html public "-//W3C//DTD HTML//EN"&gt;
&lt;html&gt;
&lt;head&gt;
&lt;title&gt;<b><a href="../rcvars.html#TIDXTITLE">$TIDXTITLE$</a></b>&lt;/title&gt;
&lt;meta http-equiv="Content-Type" content="text/html; charset=utf-8"&gt;
&lt;/head&gt;
&lt;body&gt;
&lt;h1&gt;<b><a href="../rcvars.html#TIDXTITLE">$TIDXTITLE$</a></b>&lt;/h1&gt;
<b>&lt;/TIdxPgBegin&gt;</b>


<b><a href="../resources/msgpgbegin.html">&lt;MsgPgBegin&gt;</a></b>
&lt;!doctype html public "-//W3C//DTD HTML//EN"&gt;
&lt;html&gt;
&lt;head&gt;
&lt;title&gt;<b><a href="../rcvars.html#SUBJECTNA">$SUBJECTNA$</a></b>&lt;/title&gt;
&lt;link rev="made" href="mailto:<b><a href="../rcvars.html#FROMADDR">$FROMADDR$</a></b>"&gt;
&lt;meta http-equiv="Content-Type" content="text/html; charset=utf-8"&gt;
&lt;/head&gt;
&lt;body&gt;
<b>&lt;/MsgPgBegin&gt;</b>
</pre>
</body>
</html>