| 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> |