Initial commit of OpenSPARC T2 design and verification files.
[OpenSPARC-T2-DV] / tools / perl-5.8.0 / doc / MHonArc / rcfileexs / utf-8.mrc.html
CommitLineData
86530b38
AT
1<html>
2<body>
3<pre>
4&lt;!-- ================================================================== --&gt;
5&lt;!-- File:
6 $Id: utf-8.mrc,v 1.3 2002/07/27 05:13:13 ehood Exp $
7 Author:
8 Earl Hood &lt;earl@earlhood.com&gt;
9
10 Description:
11 MHonArc, &lt;http://www.mhonarc.org/&gt;, resource file to
12 generate UTF-8 pages.
13
14 Dependencies:
15 Requires that the Unicode::String and Unicode::MapUTF8 modules are
16 installed and the 'use utf8' Perl pragma is supported.
17
18 Notes:
19 The following is worth noting if you plan to generate UTF-8
20 archives:
21
22 * When defining text-oriented resources, try to stick
23 with ASCII and use numeric character entity references
24 for non-ASCII characters. This will avoid any possible
25 problems with resource variable expansion since resource
26 variable detection is done in the raw, byte domain (i.e.
27 a "character" is assumned to only comprise a single 8-bit
28 byte).
29
30 * Auto URL detection in text/plain messages could possibly
31 munge characters since it is a non-UTF-8 operation. However,
32 the probability should be low. If the problem becomes
33 visible in messages, disable URL detection by specifying
34 the "nourl" argument to m2h_text_plain::filter.
35
36 * If using a search engine with MHonArc, make sure it
37 supports UTF-8.
38 --&gt;
39&lt;!-- ==================================================================
40--&gt;
41
42&lt;!-- MHonArc::UTF8 uses the Unicode::MapUTF8 module to translate
43 character data into UTF-8. Besides US-ASCII data, we default
44 that all character data should be converted to UTF-8. The
45 Unicode::MapUTF8 module has a large set of supported characters
46 sets, so we should be covered for most locales.
47 --&gt;
48
49<b><a href="../resources/charsetconverters.html">&lt;CharsetConverters override&gt;</a></b>
50plain; mhonarc::htmlize;
51us-ascii; mhonarc::htmlize;
52default; MHonArc::UTF8::str2sgml; MHonArc/UTF8.pm
53<b>&lt;/CharsetConverters&gt;</b>
54
55&lt;!-- MHonArc v2.5.10 introduced the following resource to control
56 how text clipping is performed, mainly for resource variables
57 (e.g. <b><a href="../rcvars.html#SUBJECTNA">$SUBJECTNA:72$</a></b>).
58 --&gt;
59
60<b><a href="../resources/textclipfunc.html">&lt;TextClipFunc&gt;</a></b>
61MHonArc::UTF8::clip; MHonArc/UTF8.pm
62<b>&lt;/TextClipFunc&gt;</b>
63
64&lt;!-- The beginning page markup of MHonArc pages need to be modified
65 to tell clients that the pages are in UTF-8 by using a
66 &lt;meta http-equiv&gt; tag.
67
68 The following resource settings are just the default settings
69 for each resource but with the appropriate &lt;meta http-equiv&gt;
70 tag added.
71 --&gt;
72
73<b><a href="../resources/idxpgbegin.html">&lt;IdxPgBegin&gt;</a></b>
74&lt;!doctype html public "-//W3C//DTD HTML//EN"&gt;
75&lt;html&gt;
76&lt;head&gt;
77&lt;title&gt;<b><a href="../rcvars.html#IDXTITLE">$IDXTITLE$</a></b>&lt;/title&gt;
78&lt;meta http-equiv="Content-Type" content="text/html; charset=utf-8"&gt;
79&lt;/head&gt;
80&lt;body&gt;
81&lt;h1&gt;<b><a href="../rcvars.html#IDXTITLE">$IDXTITLE$</a></b>&lt;/h1&gt;
82<b>&lt;/IdxPgBegin&gt;</b>
83
84<b><a href="../resources/tidxpgbegin.html">&lt;TIdxPgBegin&gt;</a></b>
85&lt;!doctype html public "-//W3C//DTD HTML//EN"&gt;
86&lt;html&gt;
87&lt;head&gt;
88&lt;title&gt;<b><a href="../rcvars.html#TIDXTITLE">$TIDXTITLE$</a></b>&lt;/title&gt;
89&lt;meta http-equiv="Content-Type" content="text/html; charset=utf-8"&gt;
90&lt;/head&gt;
91&lt;body&gt;
92&lt;h1&gt;<b><a href="../rcvars.html#TIDXTITLE">$TIDXTITLE$</a></b>&lt;/h1&gt;
93<b>&lt;/TIdxPgBegin&gt;</b>
94
95
96<b><a href="../resources/msgpgbegin.html">&lt;MsgPgBegin&gt;</a></b>
97&lt;!doctype html public "-//W3C//DTD HTML//EN"&gt;
98&lt;html&gt;
99&lt;head&gt;
100&lt;title&gt;<b><a href="../rcvars.html#SUBJECTNA">$SUBJECTNA$</a></b>&lt;/title&gt;
101&lt;link rev="made" href="mailto:<b><a href="../rcvars.html#FROMADDR">$FROMADDR$</a></b>"&gt;
102&lt;meta http-equiv="Content-Type" content="text/html; charset=utf-8"&gt;
103&lt;/head&gt;
104&lt;body&gt;
105<b>&lt;/MsgPgBegin&gt;</b>
106</pre>
107</body>
108</html>