Commit | Line | Data |
---|---|---|
86530b38 AT |
1 | <html> |
2 | <body> | |
3 | <pre> | |
4 | <!-- ================================================================== --> | |
5 | <!-- File: | |
6 | $Id: utf-8.mrc,v 1.3 2002/07/27 05:13:13 ehood Exp $ | |
7 | Author: | |
8 | Earl Hood <earl@earlhood.com> | |
9 | ||
10 | Description: | |
11 | MHonArc, <http://www.mhonarc.org/>, 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 | --> | |
39 | <!-- ================================================================== | |
40 | --> | |
41 | ||
42 | <!-- 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 | --> | |
48 | ||
49 | <b><a href="../resources/charsetconverters.html"><CharsetConverters override></a></b> | |
50 | plain; mhonarc::htmlize; | |
51 | us-ascii; mhonarc::htmlize; | |
52 | default; MHonArc::UTF8::str2sgml; MHonArc/UTF8.pm | |
53 | <b></CharsetConverters></b> | |
54 | ||
55 | <!-- 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 | --> | |
59 | ||
60 | <b><a href="../resources/textclipfunc.html"><TextClipFunc></a></b> | |
61 | MHonArc::UTF8::clip; MHonArc/UTF8.pm | |
62 | <b></TextClipFunc></b> | |
63 | ||
64 | <!-- 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 | <meta http-equiv> tag. | |
67 | ||
68 | The following resource settings are just the default settings | |
69 | for each resource but with the appropriate <meta http-equiv> | |
70 | tag added. | |
71 | --> | |
72 | ||
73 | <b><a href="../resources/idxpgbegin.html"><IdxPgBegin></a></b> | |
74 | <!doctype html public "-//W3C//DTD HTML//EN"> | |
75 | <html> | |
76 | <head> | |
77 | <title><b><a href="../rcvars.html#IDXTITLE">$IDXTITLE$</a></b></title> | |
78 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> | |
79 | </head> | |
80 | <body> | |
81 | <h1><b><a href="../rcvars.html#IDXTITLE">$IDXTITLE$</a></b></h1> | |
82 | <b></IdxPgBegin></b> | |
83 | ||
84 | <b><a href="../resources/tidxpgbegin.html"><TIdxPgBegin></a></b> | |
85 | <!doctype html public "-//W3C//DTD HTML//EN"> | |
86 | <html> | |
87 | <head> | |
88 | <title><b><a href="../rcvars.html#TIDXTITLE">$TIDXTITLE$</a></b></title> | |
89 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> | |
90 | </head> | |
91 | <body> | |
92 | <h1><b><a href="../rcvars.html#TIDXTITLE">$TIDXTITLE$</a></b></h1> | |
93 | <b></TIdxPgBegin></b> | |
94 | ||
95 | ||
96 | <b><a href="../resources/msgpgbegin.html"><MsgPgBegin></a></b> | |
97 | <!doctype html public "-//W3C//DTD HTML//EN"> | |
98 | <html> | |
99 | <head> | |
100 | <title><b><a href="../rcvars.html#SUBJECTNA">$SUBJECTNA$</a></b></title> | |
101 | <link rev="made" href="mailto:<b><a href="../rcvars.html#FROMADDR">$FROMADDR$</a></b>"> | |
102 | <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> | |
103 | </head> | |
104 | <body> | |
105 | <b></MsgPgBegin></b> | |
106 | </pre> | |
107 | </body> | |
108 | </html> |