view release on metacpan or  search on metacpan

doc/guides/performance.html  view on Meta::CPAN

<!-- .................................................................... -->
<h3><a name="avoidchars">Avoid conversion if you do not need it</a></h3>

<p>If your archive will only contain messages in a single encoding,
then avoid unnecessary conversion processing.  The following
resource settings define the absolute minimum in text processing and
causes archive messages to be rendered in the default locale of
the web browser:
</p>
<pre class="code">
&lt;!-- DECODEHEADS can be used to improve resource variable
     expansion.  See <a href="../resources/decodeheads.html">DECODEHEADS</a> resource for more information.  --&gt;
<b><a href="../resources/decodeheads.html">&lt;DecodeHeads&gt;</a></b>

&lt;!-- Only convert HTML specials --&gt;
<b><a href="../resources/charsetconverters.html">&lt;CharsetConverters override&gt;</a></b>
plain;          mhonarc::htmlize;
default;        -decode-
<b>&lt;/CharsetConverters&gt;</b>
</pre>
<p>If your locale is a non-English, non-Latin-1 one,
you may need to specify the locale explicitly in archive pages;
the default locale of web browsers may not 
match the locale of the archive.  For example, if your
locale is Polish (ISO-8859-2), then something like the following
resource settings can be used:
</p>
<pre class="code">
&lt;!-- 
     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;DefineVar chop&gt;</a></b>
HTTP-EQUIV
<span class="highlight">&lt;meta http-equiv="Content-Type" content="text/html; charset=iso-8859-2"&gt;</span>
<b>&lt;/DefineVar&gt;</b>

<b><a href="../resources/idxpgbegin.html">&lt;IdxPgBegin&gt;</a></b>
&lt;html&gt;
&lt;head&gt;
&lt;title&gt;<b><a href="../rcvars.html#IDXTITLE">$IDXTITLE$</a></b>&lt;/title&gt;
<span class="highlight">$HTTP-EQUIV$</span>
&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;html&gt;
&lt;head&gt;
&lt;title&gt;<b><a href="../rcvars.html#TIDXTITLE">$TIDXTITLE$</a></b>&lt;/title&gt;
<span class="highlight">$HTTP-EQUIV$</span>
&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;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;
<span class="highlight">$HTTP-EQUIV$</span>
&lt;/head&gt;
&lt;body&gt;
<b>&lt;/MsgPgBegin&gt;</b>
</pre>

<!-- .................................................................... -->
<h3><a name="latestperl">Use the latest version of Perl</a></h3>

<p>Perl 5.8, and later, provides built-in support for character
encodings, with UTF-8 supported internally and the <tt>Encode</tt>
module providing character encoding conversion facilities.  MHonArc
will leverage such features if available and applicable to
improve performance.
</p>
<p>If using older versions of Perl, MHonArc still provides robust
character encoding support, but performance is not as good.
</p>

<!-- .................................................................... -->
<h3><a name="textencode">Use TEXTENCODE</a></h3>

<p>If your archive will contain data in multiple encodings, consider
using the
<a href="../resources/textencode.html">TEXTENCODE</a> resource.
The <a href="../resources/textencode.html">TEXTENCODE</a> resource
allows you to convert all message data into a single encoding,
simplifying subsequent processing done by MHonArc.  The most
common usage of <a href="../resources/textencode.html">TEXTENCODE</a>
is to normalize all message data to UTF-8 (Unicode).
See the
<tt><a href="../rcfileexs/utf-8-encode.mrc.html">utf-8-encode.mrc</a></tt>
example resource file on how to encode all text to UTF-8.
</p>
<table class="caution" width="100%">
<tr valign="baseline">
<td><strong style="color: red;">CAUTION:</strong></td>
<td width="100%"><p>Although most modern web browsers support
UTF-8, not all search engines do.  If you use a search engine, or
plan to use one, verify that UTF-8 is supported.
</p>
</td>
</tr>
</table>

<p>
</p>

<!-- ===================================================================== -->
<hr>
<address>
$Date: 2011/01/03 06:42:38 $ <br>
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/"
><strong>MHonArc</strong></a><br>
Copyright &#169; 2005, <a href="http://www.earlhood.com/"