| 1 |
<html> |
| 2 |
<head> |
| 3 |
<title>MHonArc Resources: MIMEFILTERS</title> |
| 4 |
<link rel="stylesheet" type="text/css" href="../docstyles.css"> |
| 5 |
</head> |
| 6 |
<body> |
| 7 |
<!--x-rc-nav--> |
| 8 |
<table border=0><tr valign="top"> |
| 9 |
<td align="left" width="50%">[Prev: <a href="mimeexcs.html">MIMEEXCS</a>]</td><td><nobr>[<a href="../resources.html#mimefilters">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="mimeincs.html">MIMEINCS</a>]</td></tr></table> |
| 10 |
<!--/x-rc-nav--> |
| 11 |
<hr> |
| 12 |
<h1>MIMEFILTERS</h1> |
| 13 |
<!--X-TOC-Start--> |
| 14 |
<ul> |
| 15 |
<li><a href="#syntax">Syntax</a> |
| 16 |
<li><a href="#description">Description</a> |
| 17 |
<ul> |
| 18 |
<li><small><a href="#defaultfilters">Default Filters</a></small> |
| 19 |
<li><small><a href="#writefilters">Writing Filters</a></small> |
| 20 |
</ul> |
| 21 |
<li><a href="#filters">Available Filters</a> |
| 22 |
<ul> |
| 23 |
<li><small><a href="#m2h_external">m2h_external::filter</a></small> |
| 24 |
<li><small><a href="#m2h_msg_extbody">m2h_msg_extbody::filter</a></small> |
| 25 |
<li><small><a href="#m2h_text_enriched">m2h_text_enriched::filter</a></small> |
| 26 |
<li><small><a href="#m2h_text_html">m2h_text_html::filter</a></small> |
| 27 |
<li><small><a href="#m2h_text_plain">m2h_text_plain::filter</a></small> |
| 28 |
<li><small><a href="#m2h_text_tsv">m2h_text_tsv::filter</a></small> |
| 29 |
<li><small><a href="#m2h_null">m2h_null::filter</a></small> |
| 30 |
</ul> |
| 31 |
<li><a href="#default">Default Setting</a> |
| 32 |
<li><a href="#rcvars">Resource Variables</a> |
| 33 |
<li><a href="#examples">Examples</a> |
| 34 |
<li><a href="#version">Version</a> |
| 35 |
<li><a href="#seealso">See Also</a> |
| 36 |
</ul> |
| 37 |
<!--X-TOC-End--> |
| 38 |
|
| 39 |
<!-- *************************************************************** --> |
| 40 |
<hr> |
| 41 |
<h2><a name="syntax">Syntax</a></h2> |
| 42 |
|
| 43 |
<dl> |
| 44 |
|
| 45 |
<dt><strong>Envariable</strong></dt> |
| 46 |
<dd><p>N/A |
| 47 |
</p> |
| 48 |
</dd> |
| 49 |
|
| 50 |
<dt><strong>Element</strong></dt> |
| 51 |
<dd><p> |
| 52 |
<code><MIMEFILTERS></code><br> |
| 53 |
<var>filter-specification</var><br> |
| 54 |
<var>...</var><br> |
| 55 |
<code></MIMEFILTERS></code><br> |
| 56 |
</p> |
| 57 |
</dd> |
| 58 |
|
| 59 |
<dt><strong>Command-line Option</strong></dt> |
| 60 |
<dd><p>N/A |
| 61 |
</p> |
| 62 |
</dd> |
| 63 |
|
| 64 |
</dl> |
| 65 |
|
| 66 |
<!-- *************************************************************** --> |
| 67 |
<hr> |
| 68 |
<h2><a name="description">Description</a></h2> |
| 69 |
|
| 70 |
<P>The resource MIMEFILTERS is used to hook in user specifed filters |
| 71 |
into MHonArc. The MIMEFILTERS resource can only be set via the |
| 72 |
<CODE>MIMEFILTERS</CODE> element. The syntax for each line of the |
| 73 |
the <CODE>MIMEFILTERS</CODE> element is as follows: </P> |
| 74 |
|
| 75 |
<P><var>content-type</var><CODE>;</CODE><var>routine-name</var><CODE>;</CODE><var>file-of-routine</var> </P> |
| 76 |
|
| 77 |
<P>The definition of each semi-colon-separated value is as follows: |
| 78 |
</P> |
| 79 |
|
| 80 |
<DL> |
| 81 |
<DT><var>content-type</var> |
| 82 |
|
| 83 |
<DD><P>The MIME content-type the filter processes. An explicit |
| 84 |
content-type (base/subtype) or a base content-type (base/*) |
| 85 |
can be specified. |
| 86 |
</P> |
| 87 |
|
| 88 |
<DT><var>routine-name</var> |
| 89 |
<DD><P>The actual routine name of the filter. The name |
| 90 |
should be fully qualified by the package it is defined in |
| 91 |
(e.g. "<CODE>mypackage::filter</CODE>"). </P> |
| 92 |
|
| 93 |
<DT><var>file-of-routine</var> |
| 94 |
<DD><P>The name of the file that defines |
| 95 |
<var>routine-name</var>. If the file is not a full |
| 96 |
pathname, MHonArc finds the file by looking in the |
| 97 |
standard include paths of Perl, and the paths specified by the |
| 98 |
<A HREF="perlinc.html">PERLINC</A> |
| 99 |
resource. |
| 100 |
</P> |
| 101 |
|
| 102 |
</DL> |
| 103 |
|
| 104 |
<P>Whitespace is stripped out for each filter specification. |
| 105 |
</P> |
| 106 |
|
| 107 |
<H3><a name="defaultfilters">Default Filters</a></H3> |
| 108 |
|
| 109 |
<p>MHonArc provides an existing set of filters which should be sufficient |
| 110 |
for most of your needs. For information about the filters, see |
| 111 |
the <a href="#filters"><cite>Available Filters</cite></a> section below. |
| 112 |
</p> |
| 113 |
|
| 114 |
<H3><a name="writefilters">Writing Filters</a></H3> |
| 115 |
|
| 116 |
<P>If you want to write your own filter for use in MHonArc, |
| 117 |
you need to know the Perl programming language. The following |
| 118 |
information assumes you know Perl. |
| 119 |
</P> |
| 120 |
|
| 121 |
<table class="note" width="100%"> |
| 122 |
<tr valign=top> |
| 123 |
<td><strong>NOTE:</strong></td> |
| 124 |
<td width="100%"><p>As of v2.5 of MHonArc, the API for filters is different from |
| 125 |
v2.4.x, and earlier. The following describes the v2.5 API for |
| 126 |
filters. |
| 127 |
</p> |
| 128 |
</td> |
| 129 |
</tr> |
| 130 |
</table> |
| 131 |
|
| 132 |
<H4>Function Interface of Filter</H4> |
| 133 |
|
| 134 |
<P>MHonArc interfaces with MIME filters by calling a routine |
| 135 |
with a specific set of arguments. The prototype of the interface |
| 136 |
routine is as follows: </P> |
| 137 |
|
| 138 |
<PRE class="code"> |
| 139 |
sub <var>filter</var> { |
| 140 |
my(<b>$fields_hash_ref</b>, <b>$body_data_ref</b>, <b>$is_decoded</b>, <b>$filter_args</b>) = <!-- |
| 141 |
-->@<!-- |
| 142 |
-->_; |
| 143 |
|
| 144 |
<var># Filter code here |
| 145 |
|
| 146 |
# The last statement should be the return value, unless an |
| 147 |
# explicit return is done. See the following for the format of the |
| 148 |
# return value.</var> |
| 149 |
} |
| 150 |
</PRE> |
| 151 |
|
| 152 |
<H5>Parameter Descriptions</H5> |
| 153 |
|
| 154 |
<table cellspacing=1 border=0 cellpadding=4> |
| 155 |
|
| 156 |
<tr valign=top> |
| 157 |
<td><strong><code><a name="fields_hash_ref" |
| 158 |
>$fields_hash_ref</a></code></strong></td> |
| 159 |
<td><p>A reference to hash of message/part header |
| 160 |
fields. Keys are field names in lowercase |
| 161 |
and values are array references containing the |
| 162 |
field values. For example, to obtain the |
| 163 |
content-type, if defined, you would do: |
| 164 |
</p> |
| 165 |
<pre class="code"> |
| 166 |
$fields_hash_ref->{'content-type'}[0]</pre> |
| 167 |
<p>Values for a fields are stored in arrays since |
| 168 |
duplication of fields are possible. For example, |
| 169 |
the <tt>Received:</tt> header field is typically repeated |
| 170 |
multiple times. For fields that only occur once, |
| 171 |
the array for the field will only contain one |
| 172 |
item. |
| 173 |
</p> |
| 174 |
<p>See <a href="#xmhafields"><cite>Special Variables and Header |
| 175 |
Fields</a> for more information about this parameter. |
| 176 |
</p> |
| 177 |
</td> |
| 178 |
</tr> |
| 179 |
|
| 180 |
<tr valign=top> |
| 181 |
<td><strong><code>$body_data_ref</code></strong></td> |
| 182 |
<td><p>Reference to body data. The filter can safely |
| 183 |
modify referenced data. |
| 184 |
</p> |
| 185 |
</td> |
| 186 |
</tr> |
| 187 |
|
| 188 |
<tr valign=top> |
| 189 |
<td><strong><code>$is_decoded</code></strong></td> |
| 190 |
<td><p>Boolean flag if body data has been decoded. |
| 191 |
This is normally true unless some non-standard |
| 192 |
content-transfer-encoding is used. See |
| 193 |
<a href="mimedecoders.html">MIMEDECODERS</a> on how |
| 194 |
to register decoders for various content-transfer-encodings. |
| 195 |
</p> |
| 196 |
</td> |
| 197 |
</tr> |
| 198 |
|
| 199 |
<tr valign=top> |
| 200 |
<td><strong><code>$filter_args</code></strong></td> |
| 201 |
<td><P>This is an optional argument string that may be used to modify the |
| 202 |
behavior of the filter. The format of this string is determined by the filter |
| 203 |
itself. The value of the string is set by the |
| 204 |
<a href="mimeargs.html">MIMEARGS</a> resource. |
| 205 |
</P> |
| 206 |
</td> |
| 207 |
</tr> |
| 208 |
|
| 209 |
</table> |
| 210 |
|
| 211 |
<H5>Return Value</H5> |
| 212 |
|
| 213 |
<p>The return value is treated as a list. The first item of the list |
| 214 |
is a string representing the HTML markup to insert in the HTMLized |
| 215 |
message. An empty string, or <tt>undef</tt> may be returned to tell MHonArc |
| 216 |
that the routine was unable to filter data. |
| 217 |
</p> |
| 218 |
<p>Any other list items are treated as names of any files that were |
| 219 |
generated by the filter. MHonArc needs to keep track if any |
| 220 |
extra files that a filter may generate in order for MHonArc to |
| 221 |
delete those files if the message gets removed from the archive. |
| 222 |
</p> |
| 223 |
|
| 224 |
<table class="note" width="100%"> |
| 225 |
<tr valign=top> |
| 226 |
<td><strong>NOTE:</strong></td> |
| 227 |
<td width="100%"><p>If you want MHonArc to treat the data as filtered, but not |
| 228 |
have anything displayed on the page, just return a string with |
| 229 |
a single space character. |
| 230 |
</p> |
| 231 |
</td> |
| 232 |
</tr> |
| 233 |
</table> |
| 234 |
<p> </p> |
| 235 |
<table class="note" width="100%"> |
| 236 |
<tr valign=top> |
| 237 |
<td><strong>NOTE:</strong></td> |
| 238 |
<td width="100%"><p>If the filter creates a subdirectory with files, the filter |
| 239 |
only needs to return the subdirectory in the return list. If |
| 240 |
the message gets removed, MHonArc will delete the entire |
| 241 |
directory. |
| 242 |
</p> |
| 243 |
</td> |
| 244 |
</tr> |
| 245 |
</table> |
| 246 |
|
| 247 |
<H4><a name="xmhafields">Special Variables and Header Fields</a></H4> |
| 248 |
|
| 249 |
<p>The following global variables are made available to filters: |
| 250 |
</p> |
| 251 |
|
| 252 |
<table cellspacing=1 border=0 cellpadding=4> |
| 253 |
|
| 254 |
<tr valign=top> |
| 255 |
<td><b><tt><nobr>$mhonarc::MHAindex</nobr></tt></b></td> |
| 256 |
<td><p>Index key of message. Various MHonArc data structures and |
| 257 |
utility routines require the index key of the message. |
| 258 |
</p> |
| 259 |
</td> |
| 260 |
</tr> |
| 261 |
<tr valign=top> |
| 262 |
<td><b><tt><nobr>$mhonarc::MHAmsgid</nobr></tt></b></td> |
| 263 |
<td><p>Message ID of message. |
| 264 |
</p> |
| 265 |
</td> |
| 266 |
</tr> |
| 267 |
<tr valign=top> |
| 268 |
<td><b><tt><nobr>$mhonarc::MHAmsgnum</nobr></tt></b></td> |
| 269 |
<td><p>Message number. The format of the number will at least |
| 270 |
be five digits wide, with leading zero padding. For example, |
| 271 |
if the number for a message is <tt>15</tt>, <tt>$mhonarc::$MHAmsgnum</tt> |
| 272 |
will be equal to <tt>00015</tt>. |
| 273 |
</p> |
| 274 |
</td> |
| 275 |
</tr> |
| 276 |
<tr valign=top> |
| 277 |
<td><b><tt><nobr>$mhonarc::OUTDIR</nobr></tt></b></td> |
| 278 |
<td><p>Pathname to archive directory. This variable is useful for |
| 279 |
filters that create derived files. |
| 280 |
</p> |
| 281 |
</td> |
| 282 |
</tr> |
| 283 |
</table> |
| 284 |
|
| 285 |
<p>The <code><a href="#fields_hash_ref">$fields_hash_ref</a></code> |
| 286 |
parameter will have special MHonArc-specific keys defined. Unlike |
| 287 |
regular header field values, the values are <strong>not</strong> arrays |
| 288 |
(unless noted). The following special keys are defined: |
| 289 |
</p> |
| 290 |
|
| 291 |
<dl> |
| 292 |
|
| 293 |
<dt><b><tt>x-mha-charset</tt></b></dt> |
| 294 |
<dd><pre class="code">my $charset = $fields_hash_ref->{'x-mha-charset'}</pre> |
| 295 |
<p>Only defined for <tt>text</tt> entities, the value |
| 296 |
represents the character set encoding of the text entity. |
| 297 |
</p> |
| 298 |
<p>If your filter will take character encoding into account, you |
| 299 |
should use this value vs what is specified in regular entity header |
| 300 |
fields because <a href="textencode.html">TEXTENCODE</a> may be affect, |
| 301 |
so the effective character encoding of the data may be different from |
| 302 |
the original encoding specified in the message. |
| 303 |
</p> |
| 304 |
</dd> |
| 305 |
|
| 306 |
<dt><b><tt>x-mha-content-type</tt></b></dt> |
| 307 |
<dd><pre class="code">my $content_type = $fields_hash_ref->{'x-mha-content-type'}</pre> |
| 308 |
<p>The media type of the entity extracted from content-type entity header. |
| 309 |
</p> |
| 310 |
</dd> |
| 311 |
|
| 312 |
<dt><b><tt>x-mha-part-number</tt></b></dt> |
| 313 |
<dd><pre class="code"> |
| 314 |
my $part_no = $fields_hash_ref->{'x-mha-part-number'} |
| 315 |
my $full_part_no = readmail::gen_full_part_number($fields_hash_ref);</pre> |
| 316 |
<p>The child number of the entity within a multipart entity. Numbering |
| 317 |
starts with 1, and if data is not part of a multipart entity, this |
| 318 |
key may not be defined. |
| 319 |
</p> |
| 320 |
</dd> |
| 321 |
|
| 322 |
<dt><b><tt>x-mha-parent-header</tt></b></dt> |
| 323 |
<dd><pre class="code"> |
| 324 |
my $parent_header = $fields_hash_ref->{'x-mha-parent-header'} |
| 325 |
</pre> |
| 326 |
<p>The header field hash for the parent entity, if applicable. |
| 327 |
</p> |
| 328 |
</dd> |
| 329 |
|
| 330 |
</dl> |
| 331 |
|
| 332 |
<H4><a name="cidhash">Accessing Other Parts</a></H4> |
| 333 |
|
| 334 |
<p>For some media-types, a filter may need to access other entity |
| 335 |
parts to properly process a given part. |
| 336 |
For example, |
| 337 |
<a href="#m2h_text_html">m2h_text_html::filter</a> must access |
| 338 |
other entity parts when processing MHTML messages. |
| 339 |
</p> |
| 340 |
|
| 341 |
<p>When MHonArc parses a multipart message, it fills the |
| 342 |
<tt><b>%readmail::Cid</b></tt> hash for each entity that defines either |
| 343 |
a <tt>Content-Id</tt> or <tt>Content-Location</tt>. |
| 344 |
The <tt>%readmail::Cid</tt> hash is mainly for use by media types, |
| 345 |
like <tt>multipart/related</tt> where message parts may reference other |
| 346 |
message parts. |
| 347 |
</p> |
| 348 |
|
| 349 |
<p>The keys of the <tt>%readmail::Cid</tt> hash will be the |
| 350 |
<tt>Content-Id</tt>s and <tt>Content-Location</tt>s and each value |
| 351 |
will be a reference to an entity hash structure. Code example: |
| 352 |
</p> |
| 353 |
<pre class="code">my $entity = $readmail::Cid{$content_id};</pre> |
| 354 |
<p>The hash structure defines the following fields: </p> |
| 355 |
|
| 356 |
<dl> |
| 357 |
<dt><strong><code>body</code></strong></td> |
| 358 |
<dd><pre class="code"> |
| 359 |
my $entity_body_ref = $readmail::Cid{$content_id}->{'body'} |
| 360 |
</pre> |
| 361 |
<p>Scalar reference to the body of the entity. |
| 362 |
</p> |
| 363 |
</dd> |
| 364 |
</tr> |
| 365 |
<tr valign=top> |
| 366 |
<td><strong><code>fields</code></strong></td> |
| 367 |
<dd><pre class="code"> |
| 368 |
my $entity_header_ref = $readmail::Cid{$content_id}->{'fields'} |
| 369 |
</pre> |
| 370 |
<p>Entity header fields hash reference. The format is the same |
| 371 |
as described for <code><a href="#fields_hash_ref">$fields_hash_ref</a></code>. |
| 372 |
</p> |
| 373 |
</dd> |
| 374 |
</tr> |
| 375 |
<tr valign=top> |
| 376 |
<td><strong><code>filtered</code></strong></td> |
| 377 |
<dd><pre class="code"> |
| 378 |
my $is_filtered = $readmail::Cid{$content_id}->{'filtered'} |
| 379 |
</pre> |
| 380 |
<p>Boolean if part has already been filtered. This field should |
| 381 |
be set to a true value by filters that explicitly filters other entity parts. |
| 382 |
This tells MHonArc to not invoke a filter for the entity. |
| 383 |
</p> |
| 384 |
</dd> |
| 385 |
</tr> |
| 386 |
<tr valign=top> |
| 387 |
<td><strong><code>uri</code></strong></td> |
| 388 |
<dd><pre class="code"> |
| 389 |
my $entity_uri = $readmail::Cid{$content_id}->{'uri'} |
| 390 |
</pre> |
| 391 |
<p>The URI to the filtered version of the entity. This field should |
| 392 |
be set by filters that explicitly filters other entity parts. |
| 393 |
</p> |
| 394 |
</dd> |
| 395 |
</dl> |
| 396 |
|
| 397 |
<p>For a detailed example on how <tt>%readmail::Cid</tt> can be used, see |
| 398 |
the MHonArc library <tt>mhtxthtml.pl</tt>. |
| 399 |
</p> |
| 400 |
|
| 401 |
<H4>Utility Routines</H4> |
| 402 |
|
| 403 |
<p>See <cite><a href="../app-api.html#utilities">Utilities |
| 404 |
Routines</a></cite> in the appendix for various helper routines that |
| 405 |
can be used by your filter. |
| 406 |
</p> |
| 407 |
|
| 408 |
<H4>Filter Writing Tips</H4> |
| 409 |
|
| 410 |
<P>The following recommendations/tips are given to help you write |
| 411 |
filters: </P> |
| 412 |
|
| 413 |
<UL> |
| 414 |
<LI><P>Qualify your filter in its own package. This eliminates possible |
| 415 |
variable/routine conflicts with MHonArc. |
| 416 |
</P> |
| 417 |
|
| 418 |
<LI><P>If the filter creates derived files (like the image filters), |
| 419 |
you may use the variable <strong><CODE>$mhonarc::OUTDIR</CODE></strong> |
| 420 |
to determine the |
| 421 |
location of the mail archive. |
| 422 |
</P> |
| 423 |
<table class="note" width="100%"> |
| 424 |
<tr valign=top> |
| 425 |
<td><strong>NOTE:</strong></td> |
| 426 |
<td width="100%"><p><strong>Do not include</strong> |
| 427 |
<strong><CODE>$mhonarc::OUTDIR</CODE></strong> as part as the |
| 428 |
filename that is returned to MHonArc. If the filter |
| 429 |
does create files, just return the base name. |
| 430 |
</p> |
| 431 |
</td> |
| 432 |
</tr> |
| 433 |
</table> |
| 434 |
<p></p> |
| 435 |
|
| 436 |
<LI><P>Look at the default filters contained in the distribution |
| 437 |
of MHonArc. You can use these as templates for writing |
| 438 |
your own. </P> |
| 439 |
|
| 440 |
<LI><P>Make sure your Perl source file ends with a true statement |
| 441 |
(like "<CODE>1;</CODE>"). MHonArc just performs a |
| 442 |
<strong><CODE>require</CODE></strong> |
| 443 |
on the file, and if the file does not return |
| 444 |
true, Perl will abort execution. </P> |
| 445 |
|
| 446 |
<li><p>Test your filter before production use. |
| 447 |
</p> |
| 448 |
|
| 449 |
</UL> |
| 450 |
|
| 451 |
<H4>Using C</H4> |
| 452 |
|
| 453 |
<P>If a MIME filter requires the utilization of a C program, or |
| 454 |
other non-Perl executable, a Perl wrapper must be written for the |
| 455 |
program in-order to interface with MHonArc. The wrapper must |
| 456 |
follow the conventions described in |
| 457 |
<a href="#writefilters">Writing Filters</a>. |
| 458 |
</P> |
| 459 |
|
| 460 |
<!-- *************************************************************** --> |
| 461 |
<hr> |
| 462 |
<h2><a name="filters">Available Filters</a></h2> |
| 463 |
|
| 464 |
<p>The following is the list of filters available in the standard |
| 465 |
MHonArc distribution: |
| 466 |
</p> |
| 467 |
|
| 468 |
<table class="note" width="100%"> |
| 469 |
<tr valign=top> |
| 470 |
<td><strong>NOTE:</strong></td> |
| 471 |
<td width="100%"><p>The filters use a <a href="mimeargs.html">MIMEARGS</a> |
| 472 |
argument style similiar to HTML attribute values. For example: |
| 473 |
</p> |
| 474 |
<pre class="code"> |
| 475 |
<b><MIMEArgs></b> |
| 476 |
m2h_text_plain::filter; attachcheck fancyquote maxwidth=80 |
| 477 |
<b></MIMEArgs></b> |
| 478 |
</pre> |
| 479 |
<p>If writing your own filters, you are encouraged to use the same |
| 480 |
style for consistency. |
| 481 |
</p> |
| 482 |
</td> |
| 483 |
</tr> |
| 484 |
</table> |
| 485 |
|
| 486 |
<H3><a name="m2h_external">m2h_external::filter</a></h3> |
| 487 |
|
| 488 |
<P>The filter extracts the data into a separate file and puts |
| 489 |
a hyperlink to the file into the HTMLized message. The following |
| 490 |
is an example how the link is formatted: |
| 491 |
</P> |
| 492 |
<dl> |
| 493 |
<dd><p><strong>Attachment: |
| 494 |
<a href=""><tt>blueball.gif</tt></a></strong><br> |
| 495 |
<em>Description:</em> Blue ball GIF icon</p> |
| 496 |
</dd></dl> |
| 497 |
|
| 498 |
<p>The description text is retrieved from the <tt>Content-Disposition</tt> |
| 499 |
message header field, if defined. If not defined, a generic description |
| 500 |
will be provided based on the specified content-type of the data. |
| 501 |
</p> |
| 502 |
|
| 503 |
<p>If the <tt>useicon</tt> filter argument has been specified for the |
| 504 |
filter, the following format will be used: |
| 505 |
</p> |
| 506 |
<dl><dd><p><strong><a href="" ><img src="../monicon.png" align="left" border=0 alt="Attachment:"></a> |
| 507 |
<a href="" ><tt>blueball.gif</tt></a></strong><br> |
| 508 |
<em>Description:</em> Blue ball GIF icon</p> |
| 509 |
</dd></dl> |
| 510 |
|
| 511 |
<p>The actual icon used is based upon the <a href="icons.html">ICONS</a> |
| 512 |
resource. |
| 513 |
</p> |
| 514 |
|
| 515 |
<P>By default, the filter ignores any filename specification |
| 516 |
given in the message when writing the data to disk. |
| 517 |
A unique filename with an extension based upon sub-type is |
| 518 |
generated. |
| 519 |
</P> |
| 520 |
|
| 521 |
<p><strong><tt>m2h_external::filter</tt></strong> can take the |
| 522 |
following |
| 523 |
<a href="mimeargs.html">MIMEARGS arguments</a>: |
| 524 |
</p> |
| 525 |
|
| 526 |
<table cellspacing=1 border=0 cellpadding=4> |
| 527 |
<tr valign=top> |
| 528 |
<td><strong><tt>excludeexts=</tt></strong><var>ext1</var><tt>,</tt>...</td> |
| 529 |
<td width="100%"><p>A comma separated list of message specified filename extensions |
| 530 |
to exclude. I.e. If the filename extension matches an extension |
| 531 |
in excludeexts, the content will not be written. The return markup |
| 532 |
will contain the name of the attachment, but no link to the data. |
| 533 |
This option is best used with application/octet-stream to exclude |
| 534 |
unwanted data that is not tagged with the proper content-type. |
| 535 |
</p> |
| 536 |
</td> |
| 537 |
</tr> |
| 538 |
<tr valign=top> |
| 539 |
<td><strong><tt>ext=<var>ext</var></tt></strong></td> |
| 540 |
<td><p>Use <var>ext</var> as the filename extension. |
| 541 |
The filter already has a large list of extensions for various |
| 542 |
content-types. Use this argument if you process a |
| 543 |
content-type not recognized by the filter. |
| 544 |
</p></td> |
| 545 |
</tr> |
| 546 |
<tr valign=top> |
| 547 |
<td><strong><tt>forceattach</tt></strong></td> |
| 548 |
<td><p>Force images to never be displayed inline, overriding any |
| 549 |
Content-Disposition setting. |
| 550 |
</p></td> |
| 551 |
</tr> |
| 552 |
<tr valign=top> |
| 553 |
<td><strong><tt>forceinline</tt></strong></td> |
| 554 |
<td><p>Force images to be displayed inline, overriding any |
| 555 |
Content-Disposition setting. |
| 556 |
</p></td> |
| 557 |
</tr> |
| 558 |
<tr valign=top> |
| 559 |
<td><strong><tt>frame</tt></strong></td> |
| 560 |
<td><p>Draw a border around the attachment link. |
| 561 |
</p></td> |
| 562 |
</tr> |
| 563 |
<tr valign=top> |
| 564 |
<td><strong><tt>iconurl="<var>url</var>"</tt></strong></td> |
| 565 |
<td><p>Use "<var>url</var>" as the url for the icon to use |
| 566 |
if the <strong><tt>useicon</tt></strong> option is set. |
| 567 |
This option will override any setting defined by the |
| 568 |
<a href="icons.html">ICONS</a> resource. |
| 569 |
The double quotes are required. |
| 570 |
</p></td> |
| 571 |
</tr> |
| 572 |
<tr valign=top> |
| 573 |
<td><strong><tt>inline</tt></strong></td> |
| 574 |
<td><p>Inline image data by default if content-disposition not defined. |
| 575 |
</p></td> |
| 576 |
</tr> |
| 577 |
<tr valign=top> |
| 578 |
<td><strong><tt>inlineexts=</tt></strong><var>ext1</var><tt>,</tt>...</td> |
| 579 |
<td><p>A comma separated list of message specified filename |
| 580 |
extensions to treat as possible inline data. |
| 581 |
Applicable when content-type is not <tt>image/</tt><var>*</var> and |
| 582 |
<b><tt>usename</tt></b> or <b><tt>usenameext</tt></b> is in effect. |
| 583 |
</p></td> |
| 584 |
</tr> |
| 585 |
<tr valign=top> |
| 586 |
<td><strong><tt>type="<var>description</var>"</tt></strong></td> |
| 587 |
<td><p>Use "<var>description</var>" as type description of the |
| 588 |
data. The double quotes are required. |
| 589 |
The filter already has a large list of descriptions for various |
| 590 |
content-types. Use this argument if you process a |
| 591 |
content-type not recognized by the filter. |
| 592 |
</p></td> |
| 593 |
</tr> |
| 594 |
<tr valign=top> |
| 595 |
<td><strong><tt>subdir</tt></strong></td> |
| 596 |
<td><p>Place derived file in a subdirectory of the archive. |
| 597 |
The subdirectory will be called "<tt>msg<var>MSGNUM</var></tt>". |
| 598 |
This option may be useful if <strong><tt>usename</tt></strong> is |
| 599 |
specified to minimize security and name conflict problems. |
| 600 |
</p></td> |
| 601 |
</tr> |
| 602 |
<tr valign=top> |
| 603 |
<td><strong><tt>target=</tt></strong><var>name</var></td> |
| 604 |
<td><p>Set the TARGET attribute of anchor link to file |
| 605 |
Default value is undefined (ie. no TARGET attribute will be |
| 606 |
written). |
| 607 |
</p></td> |
| 608 |
</tr> |
| 609 |
<tr valign=top> |
| 610 |
<td><strong><tt>useicon</tt></strong></td> |
| 611 |
<td><p>Include a content-type icon with the hyperlink to |
| 612 |
the derived file. The icon used is the value of the |
| 613 |
<strong><tt>iconurl</tt></strong> option or the icon |
| 614 |
defined by the <a href="icons.html">ICONS</a> resource. |
| 615 |
</p></td> |
| 616 |
</tr> |
| 617 |
<tr valign=top> |
| 618 |
<td><strong><tt>usename</tt></strong></td> |
| 619 |
<td><p>Use (file)name attribute for determining name |
| 620 |
of derived file. |
| 621 |
</p> |
| 622 |
<table class="caution" width="100%"> |
| 623 |
<tr valign=top> |
| 624 |
<td><strong style="color: red;">CAUTION:</strong></td> |
| 625 |
<td width="100%"><p> |
| 626 |
Use this option with caution |
| 627 |
since it can lead to filename conflicts and |
| 628 |
security problems. |
| 629 |
</p> |
| 630 |
</td></tr></table> |
| 631 |
</td> |
| 632 |
</tr> |
| 633 |
<tr valign=top> |
| 634 |
<td><strong><tt>usenameext</tt></strong></td> |
| 635 |
<td><p>Use (file)name attribute for determining the extension |
| 636 |
of derived file. |
| 637 |
</p> |
| 638 |
<table class="caution" width="100%"> |
| 639 |
<tr valign=top> |
| 640 |
<td><strong style="color: red;">CAUTION:</strong></td> |
| 641 |
<td width="100%"><p> |
| 642 |
Use this option with caution since it can lead to |
| 643 |
security problems. |
| 644 |
</p> |
| 645 |
</td></tr></table> |
| 646 |
</td> |
| 647 |
</tr> |
| 648 |
</table> |
| 649 |
|
| 650 |
<p>All arguments should be separated by at least one space.</p> |
| 651 |
|
| 652 |
<p>The following table shows the default list of content-types with the |
| 653 |
filename extension used and a short |
| 654 |
description that <strong><tt>m2h_external::filter</tt></strong> |
| 655 |
recognizes: |
| 656 |
</p> |
| 657 |
|
| 658 |
<center> |
| 659 |
<!--X-Ext-CType-Start--> |
| 660 |
<table border=1 cellpadding=1> |
| 661 |
<tr bgcolor="#C0C0C0"> |
| 662 |
<th align=left>Content-type</th><th align=center>Extension</th><th align=left>Description</th></tr> |
| 663 |
<tr valign="top"> |
| 664 |
<td align=left><strong>application/astound</strong></td> |
| 665 |
<td align=center><tt>asd</tt></td> |
| 666 |
<td>Astound presentation</td></tr> |
| 667 |
<tr valign="top"> |
| 668 |
<td align=left><strong>application/envoy</strong></td> |
| 669 |
<td align=center><tt>evy</tt></td> |
| 670 |
<td>Envoy file</td></tr> |
| 671 |
<tr valign="top"> |
| 672 |
<td align=left><strong>application/fastman</strong></td> |
| 673 |
<td align=center><tt>lcc</tt></td> |
| 674 |
<td>fastman file</td></tr> |
| 675 |
<tr valign="top"> |
| 676 |
<td align=left><strong>application/fractals</strong></td> |
| 677 |
<td align=center><tt>fif</tt></td> |
| 678 |
<td>Fractal Image Format</td></tr> |
| 679 |
<tr valign="top"> |
| 680 |
<td align=left><strong>application/iges</strong></td> |
| 681 |
<td align=center><tt>iges</tt></td> |
| 682 |
<td>IGES file</td></tr> |
| 683 |
<tr valign="top"> |
| 684 |
<td align=left><strong>application/mac-binhex40</strong></td> |
| 685 |
<td align=center><tt>hqx</tt></td> |
| 686 |
<td>Mac BinHex archive</td></tr> |
| 687 |
<tr valign="top"> |
| 688 |
<td align=left><strong>application/mathematica</strong></td> |
| 689 |
<td align=center><tt>ma</tt></td> |
| 690 |
<td>Mathematica Notebook document</td></tr> |
| 691 |
<tr valign="top"> |
| 692 |
<td align=left><strong>application/mbedlet</strong></td> |
| 693 |
<td align=center><tt>mbd</tt></td> |
| 694 |
<td>mbedlet file</td></tr> |
| 695 |
<tr valign="top"> |
| 696 |
<td align=left><strong>application/ms-excel</strong></td> |
| 697 |
<td align=center><tt>xls</tt></td> |
| 698 |
<td>MS-Excel spreadsheet</td></tr> |
| 699 |
<tr valign="top"> |
| 700 |
<td align=left><strong>application/ms-powerpoint</strong></td> |
| 701 |
<td align=center><tt>ppt</tt></td> |
| 702 |
<td>MS-Powerpoint presentation</td></tr> |
| 703 |
<tr valign="top"> |
| 704 |
<td align=left><strong>application/ms-project</strong></td> |
| 705 |
<td align=center><tt>mpp</tt></td> |
| 706 |
<td>MS-Project file</td></tr> |
| 707 |
<tr valign="top"> |
| 708 |
<td align=left><strong>application/msword</strong></td> |
| 709 |
<td align=center><tt>doc</tt></td> |
| 710 |
<td>MS-Word document</td></tr> |
| 711 |
<tr valign="top"> |
| 712 |
<td align=left><strong>application/octet-stream</strong></td> |
| 713 |
<td align=center><tt>bin</tt></td> |
| 714 |
<td>Binary data</td></tr> |
| 715 |
<tr valign="top"> |
| 716 |
<td align=left><strong>application/oda</strong></td> |
| 717 |
<td align=center><tt>oda</tt></td> |
| 718 |
<td>ODA file</td></tr> |
| 719 |
<tr valign="top"> |
| 720 |
<td align=left><strong>application/pdf</strong></td> |
| 721 |
<td align=center><tt>pdf</tt></td> |
| 722 |
<td>Adobe PDF document</td></tr> |
| 723 |
<tr valign="top"> |
| 724 |
<td align=left><strong>application/pgp</strong></td> |
| 725 |
<td align=center><tt>pgp</tt></td> |
| 726 |
<td>PGP message</td></tr> |
| 727 |
<tr valign="top"> |
| 728 |
<td align=left><strong>application/pgp-signature</strong></td> |
| 729 |
<td align=center><tt>pgp</tt></td> |
| 730 |
<td>PGP signature</td></tr> |
| 731 |
<tr valign="top"> |
| 732 |
<td align=left><strong>application/pkcs7-mime</strong></td> |
| 733 |
<td align=center><tt>p7m</tt></td> |
| 734 |
<td>S/MIME encrypted message</td></tr> |
| 735 |
<tr valign="top"> |
| 736 |
<td align=left><strong>application/pkcs7-signature</strong></td> |
| 737 |
<td align=center><tt>p7s</tt></td> |
| 738 |
<td>S/MIME cryptographic signature</td></tr> |
| 739 |
<tr valign="top"> |
| 740 |
<td align=left><strong>application/postscript</strong></td> |
| 741 |
<td align=center><tt>ps</tt></td> |
| 742 |
<td>PostScript document</td></tr> |
| 743 |
<tr valign="top"> |
| 744 |
<td align=left><strong>application/rtf</strong></td> |
| 745 |
<td align=center><tt>rtf</tt></td> |
| 746 |
<td>RTF file</td></tr> |
| 747 |
<tr valign="top"> |
| 748 |
<td align=left><strong>application/sgml</strong></td> |
| 749 |
<td align=center><tt>sgml</tt></td> |
| 750 |
<td>SGML document</td></tr> |
| 751 |
<tr valign="top"> |
| 752 |
<td align=left><strong>application/studiom</strong></td> |
| 753 |
<td align=center><tt>smp</tt></td> |
| 754 |
<td>Studio M file</td></tr> |
| 755 |
<tr valign="top"> |
| 756 |
<td align=left><strong>application/timbuktu</strong></td> |
| 757 |
<td align=center><tt>tbt</tt></td> |
| 758 |
<td>timbuktu file</td></tr> |
| 759 |
<tr valign="top"> |
| 760 |
<td align=left><strong>application/vis5d</strong></td> |
| 761 |
<td align=center><tt>v5d</tt></td> |
| 762 |
<td>Vis5D dataset</td></tr> |
| 763 |
<tr valign="top"> |
| 764 |
<td align=left><strong>application/vnd.framemaker</strong></td> |
| 765 |
<td align=center><tt>fm</tt></td> |
| 766 |
<td>FrameMaker document</td></tr> |
| 767 |
<tr valign="top"> |
| 768 |
<td align=left><strong>application/vnd.hp-hpgl</strong></td> |
| 769 |
<td align=center><tt>hpg</tt></td> |
| 770 |
<td>HPGL file</td></tr> |
| 771 |
<tr valign="top"> |
| 772 |
<td align=left><strong>application/vnd.lotus-1-2-3</strong></td> |
| 773 |
<td align=center><tt>123</tt></td> |
| 774 |
<td>Lotus 1-2-3</td></tr> |
| 775 |
<tr valign="top"> |
| 776 |
<td align=left><strong>application/vnd.lotus-approach</strong></td> |
| 777 |
<td align=center><tt>apr</tt></td> |
| 778 |
<td>Lotus Approach</td></tr> |
| 779 |
<tr valign="top"> |
| 780 |
<td align=left><strong>application/vnd.lotus-freelance</strong></td> |
| 781 |
<td align=center><tt>prz</tt></td> |
| 782 |
<td>Lotus Freelance</td></tr> |
| 783 |
<tr valign="top"> |
| 784 |
<td align=left><strong>application/vnd.lotus-organizer</strong></td> |
| 785 |
<td align=center><tt>org</tt></td> |
| 786 |
<td>Lotus Organizer</td></tr> |
| 787 |
<tr valign="top"> |
| 788 |
<td align=left><strong>application/vnd.lotus-screencam</strong></td> |
| 789 |
<td align=center><tt>scm</tt></td> |
| 790 |
<td>Lotus Screencam</td></tr> |
| 791 |
<tr valign="top"> |
| 792 |
<td align=left><strong>application/vnd.lotus-wordpro</strong></td> |
| 793 |
<td align=center><tt>lwp</tt></td> |
| 794 |
<td>Lotus WordPro</td></tr> |
| 795 |
<tr valign="top"> |
| 796 |
<td align=left><strong>application/vnd.mif</strong></td> |
| 797 |
<td align=center><tt>mif</tt></td> |
| 798 |
<td>Frame MIF document</td></tr> |
| 799 |
<tr valign="top"> |
| 800 |
<td align=left><strong>application/vnd.ms-excel</strong></td> |
| 801 |
<td align=center><tt>xls</tt></td> |
| 802 |
<td>MS-Excel spreadsheet</td></tr> |
| 803 |
<tr valign="top"> |
| 804 |
<td align=left><strong>application/vnd.ms-powerpoint</strong></td> |
| 805 |
<td align=center><tt>ppt</tt></td> |
| 806 |
<td>MS-Powerpoint presentation</td></tr> |
| 807 |
<tr valign="top"> |
| 808 |
<td align=left><strong>application/vnd.ms-project</strong></td> |
| 809 |
<td align=center><tt>mpp</tt></td> |
| 810 |
<td>MS-Project file</td></tr> |
| 811 |
<tr valign="top"> |
| 812 |
<td align=left><strong>application/vnd.stardivision.calc</strong></td> |
| 813 |
<td align=center><tt>sdc</tt></td> |
| 814 |
<td>StarCalc spreadsheet</td></tr> |
| 815 |
<tr valign="top"> |
| 816 |
<td align=left><strong>application/vnd.stardivision.chart</strong></td> |
| 817 |
<td align=center><tt>sds</tt></td> |
| 818 |
<td>StarChart document</td></tr> |
| 819 |
<tr valign="top"> |
| 820 |
<td align=left><strong>application/vnd.stardivision.draw</strong></td> |
| 821 |
<td align=center><tt>sda</tt></td> |
| 822 |
<td>StarDraw document</td></tr> |
| 823 |
<tr valign="top"> |
| 824 |
<td align=left><strong>application/vnd.stardivision.impress</strong></td> |
| 825 |
<td align=center><tt>sdd</tt></td> |
| 826 |
<td>StarImpress presentation</td></tr> |
| 827 |
<tr valign="top"> |
| 828 |
<td align=left><strong>application/vnd.stardivision.impress-packed</strong></td> |
| 829 |
<td align=center><tt>sdp</tt></td> |
| 830 |
<td>StarImpress packed file</td></tr> |
| 831 |
<tr valign="top"> |
| 832 |
<td align=left><strong>application/vnd.stardivision.mail</strong></td> |
| 833 |
<td align=center><tt>smd</tt></td> |
| 834 |
<td>StarMail mail file</td></tr> |
| 835 |
<tr valign="top"> |
| 836 |
<td align=left><strong>application/vnd.stardivision.math</strong></td> |
| 837 |
<td align=center><tt>smf</tt></td> |
| 838 |
<td>StarMath document</td></tr> |
| 839 |
<tr valign="top"> |
| 840 |
<td align=left><strong>application/vnd.stardivision.writer</strong></td> |
| 841 |
<td align=center><tt>sdw</tt></td> |
| 842 |
<td>StarWriter document</td></tr> |
| 843 |
<tr valign="top"> |
| 844 |
<td align=left><strong>application/vnd.stardivision.writer-global</strong></td> |
| 845 |
<td align=center><tt>sgl</tt></td> |
| 846 |
<td>StarWriter global document</td></tr> |
| 847 |
<tr valign="top"> |
| 848 |
<td align=left><strong>application/vnd.sun.xml.calc</strong></td> |
| 849 |
<td align=center><tt>sxc</tt></td> |
| 850 |
<td>OpenOffice Calc spreadsheet</td></tr> |
| 851 |
<tr valign="top"> |
| 852 |
<td align=left><strong>application/vnd.sun.xml.calc.template</strong></td> |
| 853 |
<td align=center><tt>stc</tt></td> |
| 854 |
<td>OpenOffice Calc template</td></tr> |
| 855 |
<tr valign="top"> |
| 856 |
<td align=left><strong>application/vnd.sun.xml.draw</strong></td> |
| 857 |
<td align=center><tt>sxd</tt></td> |
| 858 |
<td>OpenOffice Draw document</td></tr> |
| 859 |
<tr valign="top"> |
| 860 |
<td align=left><strong>application/vnd.sun.xml.draw.template</strong></td> |
| 861 |
<td align=center><tt>std</tt></td> |
| 862 |
<td>OpenOffice Draw Template</td></tr> |
| 863 |
<tr valign="top"> |
| 864 |
<td align=left><strong>application/vnd.sun.xml.impress</strong></td> |
| 865 |
<td align=center><tt>sxi</tt></td> |
| 866 |
<td>OpenOffice Impress presentation</td></tr> |
| 867 |
<tr valign="top"> |
| 868 |
<td align=left><strong>application/vnd.sun.xml.impress.template</strong></td> |
| 869 |
<td align=center><tt>sti</tt></td> |
| 870 |
<td>OpenOffice Impress template</td></tr> |
| 871 |
<tr valign="top"> |
| 872 |
<td align=left><strong>application/vnd.sun.xml.math</strong></td> |
| 873 |
<td align=center><tt>sxm</tt></td> |
| 874 |
<td>OpenOffice Math documents</td></tr> |
| 875 |
<tr valign="top"> |
| 876 |
<td align=left><strong>application/vnd.sun.xml.writer</strong></td> |
| 877 |
<td align=center><tt>sxw</tt></td> |
| 878 |
<td>OpenOffice Writer document</td></tr> |
| 879 |
<tr valign="top"> |
| 880 |
<td align=left><strong>application/vnd.sun.xml.writer.global</strong></td> |
| 881 |
<td align=center><tt>sxg</tt></td> |
| 882 |
<td>OpenOffice Writer global document</td></tr> |
| 883 |
<tr valign="top"> |
| 884 |
<td align=left><strong>application/vnd.sun.xml.writer.template</strong></td> |
| 885 |
<td align=center><tt>stw</tt></td> |
| 886 |
<td>OpenOffice Write template</td></tr> |
| 887 |
<tr valign="top"> |
| 888 |
<td align=left><strong>application/winhlp</strong></td> |
| 889 |
<td align=center><tt>hlp</tt></td> |
| 890 |
<td>WinHelp document</td></tr> |
| 891 |
<tr valign="top"> |
| 892 |
<td align=left><strong>application/wordperfect5.1</strong></td> |
| 893 |
<td align=center><tt>wp</tt></td> |
| 894 |
<td>WordPerfect 5.1 document</td></tr> |
| 895 |
<tr valign="top"> |
| 896 |
<td align=left><strong>application/x-asap</strong></td> |
| 897 |
<td align=center><tt>asp</tt></td> |
| 898 |
<td>asap file</td></tr> |
| 899 |
<tr valign="top"> |
| 900 |
<td align=left><strong>application/x-bcpio</strong></td> |
| 901 |
<td align=center><tt>bcpio</tt></td> |
| 902 |
<td>BCPIO file</td></tr> |
| 903 |
<tr valign="top"> |
| 904 |
<td align=left><strong>application/x-bzip2</strong></td> |
| 905 |
<td align=center><tt>bz2</tt></td> |
| 906 |
<td>BZip2 compressed data</td></tr> |
| 907 |
<tr valign="top"> |
| 908 |
<td align=left><strong>application/x-compress</strong></td> |
| 909 |
<td align=center><tt>Z</tt></td> |
| 910 |
<td>Unix compressed data</td></tr> |
| 911 |
<tr valign="top"> |
| 912 |
<td align=left><strong>application/x-cpio</strong></td> |
| 913 |
<td align=center><tt>cpio</tt></td> |
| 914 |
<td>CPIO file</td></tr> |
| 915 |
<tr valign="top"> |
| 916 |
<td align=left><strong>application/x-csh</strong></td> |
| 917 |
<td align=center><tt>csh</tt></td> |
| 918 |
<td>C-Shell script</td></tr> |
| 919 |
<tr valign="top"> |
| 920 |
<td align=left><strong>application/x-dot</strong></td> |
| 921 |
<td align=center><tt>dot</tt></td> |
| 922 |
<td>dot file</td></tr> |
| 923 |
<tr valign="top"> |
| 924 |
<td align=left><strong>application/x-dvi</strong></td> |
| 925 |
<td align=center><tt>dvi</tt></td> |
| 926 |
<td>TeX dvi file</td></tr> |
| 927 |
<tr valign="top"> |
| 928 |
<td align=left><strong>application/x-earthtime</strong></td> |
| 929 |
<td align=center><tt>etc</tt></td> |
| 930 |
<td>Earthtime file</td></tr> |
| 931 |
<tr valign="top"> |
| 932 |
<td align=left><strong>application/x-envoy</strong></td> |
| 933 |
<td align=center><tt>evy</tt></td> |
| 934 |
<td>Envoy file</td></tr> |
| 935 |
<tr valign="top"> |
| 936 |
<td align=left><strong>application/x-excel</strong></td> |
| 937 |
<td align=center><tt>xls</tt></td> |
| 938 |
<td>MS-Excel spreadsheet</td></tr> |
| 939 |
<tr valign="top"> |
| 940 |
<td align=left><strong>application/x-gtar</strong></td> |
| 941 |
<td align=center><tt>gtar</tt></td> |
| 942 |
<td>GNU Unix tar archive</td></tr> |
| 943 |
<tr valign="top"> |
| 944 |
<td align=left><strong>application/x-gzip</strong></td> |
| 945 |
<td align=center><tt>gz</tt></td> |
| 946 |
<td>GNU Zip compressed data</td></tr> |
| 947 |
<tr valign="top"> |
| 948 |
<td align=left><strong>application/x-hdf</strong></td> |
| 949 |
<td align=center><tt>hdf</tt></td> |
| 950 |
<td>HDF file</td></tr> |
| 951 |
<tr valign="top"> |
| 952 |
<td align=left><strong>application/x-javascript</strong></td> |
| 953 |
<td align=center><tt>js</tt></td> |
| 954 |
<td>JavaScript source</td></tr> |
| 955 |
<tr valign="top"> |
| 956 |
<td align=left><strong>application/x-ksh</strong></td> |
| 957 |
<td align=center><tt>ksh</tt></td> |
| 958 |
<td>Korn Shell script</td></tr> |
| 959 |
<tr valign="top"> |
| 960 |
<td align=left><strong>application/x-latex</strong></td> |
| 961 |
<td align=center><tt>latex</tt></td> |
| 962 |
<td>LaTeX document</td></tr> |
| 963 |
<tr valign="top"> |
| 964 |
<td align=left><strong>application/x-maker</strong></td> |
| 965 |
<td align=center><tt>fm</tt></td> |
| 966 |
<td>FrameMaker document</td></tr> |
| 967 |
<tr valign="top"> |
| 968 |
<td align=left><strong>application/x-mif</strong></td> |
| 969 |
<td align=center><tt>mif</tt></td> |
| 970 |
<td>Frame MIF document</td></tr> |
| 971 |
<tr valign="top"> |
| 972 |
<td align=left><strong>application/x-mocha</strong></td> |
| 973 |
<td align=center><tt>moc</tt></td> |
| 974 |
<td>mocha file</td></tr> |
| 975 |
<tr valign="top"> |
| 976 |
<td align=left><strong>application/x-msaccess</strong></td> |
| 977 |
<td align=center><tt>mdb</tt></td> |
| 978 |
<td>MS-Access database</td></tr> |
| 979 |
<tr valign="top"> |
| 980 |
<td align=left><strong>application/x-mscardfile</strong></td> |
| 981 |
<td align=center><tt>crd</tt></td> |
| 982 |
<td>MS-CardFile</td></tr> |
| 983 |
<tr valign="top"> |
| 984 |
<td align=left><strong>application/x-msclip</strong></td> |
| 985 |
<td align=center><tt>clp</tt></td> |
| 986 |
<td>MS-Clip file</td></tr> |
| 987 |
<tr valign="top"> |
| 988 |
<td align=left><strong>application/x-msmediaview</strong></td> |
| 989 |
<td align=center><tt>m14</tt></td> |
| 990 |
<td>MS-Media View file</td></tr> |
| 991 |
<tr valign="top"> |
| 992 |
<td align=left><strong>application/x-msmetafile</strong></td> |
| 993 |
<td align=center><tt>wmf</tt></td> |
| 994 |
<td>MS-Metafile</td></tr> |
| 995 |
<tr valign="top"> |
| 996 |
<td align=left><strong>application/x-msmoney</strong></td> |
| 997 |
<td align=center><tt>mny</tt></td> |
| 998 |
<td>MS-Money file</td></tr> |
| 999 |
<tr valign="top"> |
| 1000 |
<td align=left><strong>application/x-mspublisher</strong></td> |
| 1001 |
<td align=center><tt>pub</tt></td> |
| 1002 |
<td>MS-Publisher document</td></tr> |
| 1003 |
<tr valign="top"> |
| 1004 |
<td align=left><strong>application/x-msschedule</strong></td> |
| 1005 |
<td align=center><tt>scd</tt></td> |
| 1006 |
<td>MS-Schedule file</td></tr> |
| 1007 |
<tr valign="top"> |
| 1008 |
<td align=left><strong>application/x-msterminal</strong></td> |
| 1009 |
<td align=center><tt>trm</tt></td> |
| 1010 |
<td>MS-Terminal</td></tr> |
| 1011 |
<tr valign="top"> |
| 1012 |
<td align=left><strong>application/x-mswrite</strong></td> |
| 1013 |
<td align=center><tt>wri</tt></td> |
| 1014 |
<td>MS-Write document</td></tr> |
| 1015 |
<tr valign="top"> |
| 1016 |
<td align=left><strong>application/x-net-install</strong></td> |
| 1017 |
<td align=center><tt>ins</tt></td> |
| 1018 |
<td>Net Install file</td></tr> |
| 1019 |
<tr valign="top"> |
| 1020 |
<td align=left><strong>application/x-netcdf</strong></td> |
| 1021 |
<td align=center><tt>cdf</tt></td> |
| 1022 |
<td>Cdf file</td></tr> |
| 1023 |
<tr valign="top"> |
| 1024 |
<td align=left><strong>application/x-ns-proxy-autoconfig</strong></td> |
| 1025 |
<td align=center><tt>proxy</tt></td> |
| 1026 |
<td>Netscape Proxy Auto Config</td></tr> |
| 1027 |
<tr valign="top"> |
| 1028 |
<td align=left><strong>application/x-patch</strong></td> |
| 1029 |
<td align=center><tt>patch</tt></td> |
| 1030 |
<td>Source code patch</td></tr> |
| 1031 |
<tr valign="top"> |
| 1032 |
<td align=left><strong>application/x-perl</strong></td> |
| 1033 |
<td align=center><tt>pl</tt></td> |
| 1034 |
<td>Perl program</td></tr> |
| 1035 |
<tr valign="top"> |
| 1036 |
<td align=left><strong>application/x-pointplus</strong></td> |
| 1037 |
<td align=center><tt>css</tt></td> |
| 1038 |
<td>pointplus file</td></tr> |
| 1039 |
<tr valign="top"> |
| 1040 |
<td align=left><strong>application/x-salsa</strong></td> |
| 1041 |
<td align=center><tt>slc</tt></td> |
| 1042 |
<td>salsa file</td></tr> |
| 1043 |
<tr valign="top"> |
| 1044 |
<td align=left><strong>application/x-script</strong></td> |
| 1045 |
<td align=center><tt>script</tt></td> |
| 1046 |
<td>A script file</td></tr> |
| 1047 |
<tr valign="top"> |
| 1048 |
<td align=left><strong>application/x-sh</strong></td> |
| 1049 |
<td align=center><tt>sh</tt></td> |
| 1050 |
<td>Bourne shell script</td></tr> |
| 1051 |
<tr valign="top"> |
| 1052 |
<td align=left><strong>application/x-shar</strong></td> |
| 1053 |
<td align=center><tt>shar</tt></td> |
| 1054 |
<td>Unix shell archive</td></tr> |
| 1055 |
<tr valign="top"> |
| 1056 |
<td align=left><strong>application/x-sprite</strong></td> |
| 1057 |
<td align=center><tt>spr</tt></td> |
| 1058 |
<td>sprite file</td></tr> |
| 1059 |
<tr valign="top"> |
| 1060 |
<td align=left><strong>application/x-stuffit</strong></td> |
| 1061 |
<td align=center><tt>sit</tt></td> |
| 1062 |
<td>Macintosh archive</td></tr> |
| 1063 |
<tr valign="top"> |
| 1064 |
<td align=left><strong>application/x-sv4cpio</strong></td> |
| 1065 |
<td align=center><tt>sv4cpio</tt></td> |
| 1066 |
<td>SV4Cpio file</td></tr> |
| 1067 |
<tr valign="top"> |
| 1068 |
<td align=left><strong>application/x-sv4crc</strong></td> |
| 1069 |
<td align=center><tt>sv4crc</tt></td> |
| 1070 |
<td>SV4Crc file</td></tr> |
| 1071 |
<tr valign="top"> |
| 1072 |
<td align=left><strong>application/x-tar</strong></td> |
| 1073 |
<td align=center><tt>tar</tt></td> |
| 1074 |
<td>Unix tar archive</td></tr> |
| 1075 |
<tr valign="top"> |
| 1076 |
<td align=left><strong>application/x-tcl</strong></td> |
| 1077 |
<td align=center><tt>tcl</tt></td> |
| 1078 |
<td>Tcl script</td></tr> |
| 1079 |
<tr valign="top"> |
| 1080 |
<td align=left><strong>application/x-tex</strong></td> |
| 1081 |
<td align=center><tt>tex</tt></td> |
| 1082 |
<td>TeX document</td></tr> |
| 1083 |
<tr valign="top"> |
| 1084 |
<td align=left><strong>application/x-texinfo</strong></td> |
| 1085 |
<td align=center><tt>texinfo</tt></td> |
| 1086 |
<td>TeXInfo document</td></tr> |
| 1087 |
<tr valign="top"> |
| 1088 |
<td align=left><strong>application/x-timbuktu</strong></td> |
| 1089 |
<td align=center><tt>tbp</tt></td> |
| 1090 |
<td>timbuktu file</td></tr> |
| 1091 |
<tr valign="top"> |
| 1092 |
<td align=left><strong>application/x-tkined</strong></td> |
| 1093 |
<td align=center><tt>tki</tt></td> |
| 1094 |
<td>tkined file</td></tr> |
| 1095 |
<tr valign="top"> |
| 1096 |
<td align=left><strong>application/x-troff</strong></td> |
| 1097 |
<td align=center><tt>roff</tt></td> |
| 1098 |
<td>Troff document</td></tr> |
| 1099 |
<tr valign="top"> |
| 1100 |
<td align=left><strong>application/x-troff-man</strong></td> |
| 1101 |
<td align=center><tt>man</tt></td> |
| 1102 |
<td>Unix manual page</td></tr> |
| 1103 |
<tr valign="top"> |
| 1104 |
<td align=left><strong>application/x-troff-me</strong></td> |
| 1105 |
<td align=center><tt>me</tt></td> |
| 1106 |
<td>Troff ME-macros document</td></tr> |
| 1107 |
<tr valign="top"> |
| 1108 |
<td align=left><strong>application/x-troff-ms</strong></td> |
| 1109 |
<td align=center><tt>ms</tt></td> |
| 1110 |
<td>Troff MS-macros document</td></tr> |
| 1111 |
<tr valign="top"> |
| 1112 |
<td align=left><strong>application/x-ustar</strong></td> |
| 1113 |
<td align=center><tt>ustar</tt></td> |
| 1114 |
<td>UStar file</td></tr> |
| 1115 |
<tr valign="top"> |
| 1116 |
<td align=left><strong>application/x-wais-source</strong></td> |
| 1117 |
<td align=center><tt>src</tt></td> |
| 1118 |
<td>WAIS Source</td></tr> |
| 1119 |
<tr valign="top"> |
| 1120 |
<td align=left><strong>application/x-zip-compressed</strong></td> |
| 1121 |
<td align=center><tt>zip</tt></td> |
| 1122 |
<td>Zip compressed data</td></tr> |
| 1123 |
<tr valign="top"> |
| 1124 |
<td align=left><strong>application/xml</strong></td> |
| 1125 |
<td align=center><tt>xml</tt></td> |
| 1126 |
<td>XML document</td></tr> |
| 1127 |
<tr valign="top"> |
| 1128 |
<td align=left><strong>application/zip</strong></td> |
| 1129 |
<td align=center><tt>zip</tt></td> |
| 1130 |
<td>Zip archive</td></tr> |
| 1131 |
<tr valign="top"> |
| 1132 |
<td align=left><strong>audio/basic</strong></td> |
| 1133 |
<td align=center><tt>snd</tt></td> |
| 1134 |
<td>Basic audio</td></tr> |
| 1135 |
<tr valign="top"> |
| 1136 |
<td align=left><strong>audio/echospeech</strong></td> |
| 1137 |
<td align=center><tt>es</tt></td> |
| 1138 |
<td>Echospeech audio</td></tr> |
| 1139 |
<tr valign="top"> |
| 1140 |
<td align=left><strong>audio/microsoft-wav</strong></td> |
| 1141 |
<td align=center><tt>wav</tt></td> |
| 1142 |
<td>Wave audio</td></tr> |
| 1143 |
<tr valign="top"> |
| 1144 |
<td align=left><strong>audio/midi</strong></td> |
| 1145 |
<td align=center><tt>midi</tt></td> |
| 1146 |
<td>MIDI audio</td></tr> |
| 1147 |
<tr valign="top"> |
| 1148 |
<td align=left><strong>audio/wav</strong></td> |
| 1149 |
<td align=center><tt>wav</tt></td> |
| 1150 |
<td>Wave audio</td></tr> |
| 1151 |
<tr valign="top"> |
| 1152 |
<td align=left><strong>audio/x-aiff</strong></td> |
| 1153 |
<td align=center><tt>aif</tt></td> |
| 1154 |
<td>AIF audio</td></tr> |
| 1155 |
<tr valign="top"> |
| 1156 |
<td align=left><strong>audio/x-epac</strong></td> |
| 1157 |
<td align=center><tt>pae</tt></td> |
| 1158 |
<td>epac audio</td></tr> |
| 1159 |
<tr valign="top"> |
| 1160 |
<td align=left><strong>audio/x-midi</strong></td> |
| 1161 |
<td align=center><tt>midi</tt></td> |
| 1162 |
<td>MIDI audio</td></tr> |
| 1163 |
<tr valign="top"> |
| 1164 |
<td align=left><strong>audio/x-mpeg</strong></td> |
| 1165 |
<td align=center><tt>mp2</tt></td> |
| 1166 |
<td>MPEG audio</td></tr> |
| 1167 |
<tr valign="top"> |
| 1168 |
<td align=left><strong>audio/x-pac</strong></td> |
| 1169 |
<td align=center><tt>pac</tt></td> |
| 1170 |
<td>pac audio</td></tr> |
| 1171 |
<tr valign="top"> |
| 1172 |
<td align=left><strong>audio/x-pn-realaudio</strong></td> |
| 1173 |
<td align=center><tt>ra</tt></td> |
| 1174 |
<td>PN Realaudio</td></tr> |
| 1175 |
<tr valign="top"> |
| 1176 |
<td align=left><strong>audio/x-wav</strong></td> |
| 1177 |
<td align=center><tt>wav</tt></td> |
| 1178 |
<td>Wave audio</td></tr> |
| 1179 |
<tr valign="top"> |
| 1180 |
<td align=left><strong>chemical/chem3d</strong></td> |
| 1181 |
<td align=center><tt>c3d</tt></td> |
| 1182 |
<td>Chem3d chemical test</td></tr> |
| 1183 |
<tr valign="top"> |
| 1184 |
<td align=left><strong>chemical/chemdraw</strong></td> |
| 1185 |
<td align=center><tt>chm</tt></td> |
| 1186 |
<td>Chemdraw chemical test</td></tr> |
| 1187 |
<tr valign="top"> |
| 1188 |
<td align=left><strong>chemical/cif</strong></td> |
| 1189 |
<td align=center><tt>cif</tt></td> |
| 1190 |
<td>CIF chemical test</td></tr> |
| 1191 |
<tr valign="top"> |
| 1192 |
<td align=left><strong>chemical/cml</strong></td> |
| 1193 |
<td align=center><tt>cml</tt></td> |
| 1194 |
<td>CML chemical test</td></tr> |
| 1195 |
<tr valign="top"> |
| 1196 |
<td align=left><strong>chemical/cmsl</strong></td> |
| 1197 |
<td align=center><tt>cml</tt></td> |
| 1198 |
<td>Chemical Structure Markup</td></tr> |
| 1199 |
<tr valign="top"> |
| 1200 |
<td align=left><strong>chemical/cxf</strong></td> |
| 1201 |
<td align=center><tt>cxf</tt></td> |
| 1202 |
<td>Chemical Exhange Format file</td></tr> |
| 1203 |
<tr valign="top"> |
| 1204 |
<td align=left><strong>chemical/daylight-smiles</strong></td> |
| 1205 |
<td align=center><tt>smi</tt></td> |
| 1206 |
<td>SMILES format file</td></tr> |
| 1207 |
<tr valign="top"> |
| 1208 |
<td align=left><strong>chemical/embl-dl-nucleotide</strong></td> |
| 1209 |
<td align=center><tt>emb</tt></td> |
| 1210 |
<td>EMBL nucleotide format file</td></tr> |
| 1211 |
<tr valign="top"> |
| 1212 |
<td align=left><strong>chemical/gaussian</strong></td> |
| 1213 |
<td align=center><tt>gau</tt></td> |
| 1214 |
<td>Gaussian data</td></tr> |
| 1215 |
<tr valign="top"> |
| 1216 |
<td align=left><strong>chemical/gaussian-input</strong></td> |
| 1217 |
<td align=center><tt>gau</tt></td> |
| 1218 |
<td>Gaussian input data</td></tr> |
| 1219 |
<tr valign="top"> |
| 1220 |
<td align=left><strong>chemical/gaussian-log</strong></td> |
| 1221 |
<td align=center><tt>gal</tt></td> |
| 1222 |
<td>Gaussian log</td></tr> |
| 1223 |
<tr valign="top"> |
| 1224 |
<td align=left><strong>chemical/gcg8-sequence</strong></td> |
| 1225 |
<td align=center><tt>gcg</tt></td> |
| 1226 |
<td>GCG format file</td></tr> |
| 1227 |
<tr valign="top"> |
| 1228 |
<td align=left><strong>chemical/genbank</strong></td> |
| 1229 |
<td align=center><tt>gen</tt></td> |
| 1230 |
<td>GENbank data</td></tr> |
| 1231 |
<tr valign="top"> |
| 1232 |
<td align=left><strong>chemical/jcamp-dx</strong></td> |
| 1233 |
<td align=center><tt>jdx</tt></td> |
| 1234 |
<td>Jcamp chemical spectra test</td></tr> |
| 1235 |
<tr valign="top"> |
| 1236 |
<td align=left><strong>chemical/kinemage</strong></td> |
| 1237 |
<td align=center><tt>kin</tt></td> |
| 1238 |
<td>Kinemage</td></tr> |
| 1239 |
<tr valign="top"> |
| 1240 |
<td align=left><strong>chemical/macromodel-input</strong></td> |
| 1241 |
<td align=center><tt>mmd</tt></td> |
| 1242 |
<td>Macromodel chemical test</td></tr> |
| 1243 |
<tr valign="top"> |
| 1244 |
<td align=left><strong>chemical/mdl-molfile</strong></td> |
| 1245 |
<td align=center><tt>mol</tt></td> |
| 1246 |
<td>MOL mdl chemical test</td></tr> |
| 1247 |
<tr valign="top"> |
| 1248 |
<td align=left><strong>chemical/mdl-rdf</strong></td> |
| 1249 |
<td align=center><tt>rdf</tt></td> |
| 1250 |
<td>RDF chemical test</td></tr> |
| 1251 |
<tr valign="top"> |
| 1252 |
<td align=left><strong>chemical/mdl-rxn</strong></td> |
| 1253 |
<td align=center><tt>rxn</tt></td> |
| 1254 |
<td>RXN chemical test</td></tr> |
| 1255 |
<tr valign="top"> |
| 1256 |
<td align=left><strong>chemical/mdl-sdf</strong></td> |
| 1257 |
<td align=center><tt>sdf</tt></td> |
| 1258 |
<td>SDF chemical test</td></tr> |
| 1259 |
<tr valign="top"> |
| 1260 |
<td align=left><strong>chemical/mdl-tgf</strong></td> |
| 1261 |
<td align=center><tt>tgf</tt></td> |
| 1262 |
<td>TGF chemical test</td></tr> |
| 1263 |
<tr valign="top"> |
| 1264 |
<td align=left><strong>chemical/mif</strong></td> |
| 1265 |
<td align=center><tt>mif</tt></td> |
| 1266 |
<td>MIF chemical test</td></tr> |
| 1267 |
<tr valign="top"> |
| 1268 |
<td align=left><strong>chemical/mmd</strong></td> |
| 1269 |
<td align=center><tt>mmd</tt></td> |
| 1270 |
<td>Macromodel data</td></tr> |
| 1271 |
<tr valign="top"> |
| 1272 |
<td align=left><strong>chemical/mopac-input</strong></td> |
| 1273 |
<td align=center><tt>mop</tt></td> |
| 1274 |
<td>MOPAC data </td></tr> |
| 1275 |
<tr valign="top"> |
| 1276 |
<td align=left><strong>chemical/ncbi-asn1</strong></td> |
| 1277 |
<td align=center><tt>asn</tt></td> |
| 1278 |
<td>NCBI data</td></tr> |
| 1279 |
<tr valign="top"> |
| 1280 |
<td align=left><strong>chemical/ncbi-asn1-binary</strong></td> |
| 1281 |
<td align=center><tt>val</tt></td> |
| 1282 |
<td>NCBI data</td></tr> |
| 1283 |
<tr valign="top"> |
| 1284 |
<td align=left><strong>chemical/pdb</strong></td> |
| 1285 |
<td align=center><tt>pdb</tt></td> |
| 1286 |
<td>Protein Databank data</td></tr> |
| 1287 |
<tr valign="top"> |
| 1288 |
<td align=left><strong>chemical/rosdal</strong></td> |
| 1289 |
<td align=center><tt>ros</tt></td> |
| 1290 |
<td>Rosdal data</td></tr> |
| 1291 |
<tr valign="top"> |
| 1292 |
<td align=left><strong>chemical/xyz</strong></td> |
| 1293 |
<td align=center><tt>xyz</tt></td> |
| 1294 |
<td>Xmol XYZ data</td></tr> |
| 1295 |
<tr valign="top"> |
| 1296 |
<td align=left><strong>image/bmp</strong></td> |
| 1297 |
<td align=center><tt>bmp</tt></td> |
| 1298 |
<td>Windows bitmap</td></tr> |
| 1299 |
<tr valign="top"> |
| 1300 |
<td align=left><strong>image/cgm</strong></td> |
| 1301 |
<td align=center><tt>cgm</tt></td> |
| 1302 |
<td>Computer Graphics Metafile</td></tr> |
| 1303 |
<tr valign="top"> |
| 1304 |
<td align=left><strong>image/fif</strong></td> |
| 1305 |
<td align=center><tt>fif</tt></td> |
| 1306 |
<td>Fractal Image Format image</td></tr> |
| 1307 |
<tr valign="top"> |
| 1308 |
<td align=left><strong>image/g3fax</strong></td> |
| 1309 |
<td align=center><tt>g3f</tt></td> |
| 1310 |
<td>Group III FAX image</td></tr> |
| 1311 |
<tr valign="top"> |
| 1312 |
<td align=left><strong>image/gif</strong></td> |
| 1313 |
<td align=center><tt>gif</tt></td> |
| 1314 |
<td>GIF image</td></tr> |
| 1315 |
<tr valign="top"> |
| 1316 |
<td align=left><strong>image/ief</strong></td> |
| 1317 |
<td align=center><tt>ief</tt></td> |
| 1318 |
<td>IEF image</td></tr> |
| 1319 |
<tr valign="top"> |
| 1320 |
<td align=left><strong>image/ifs</strong></td> |
| 1321 |
<td align=center><tt>ifs</tt></td> |
| 1322 |
<td>IFS image</td></tr> |
| 1323 |
<tr valign="top"> |
| 1324 |
<td align=left><strong>image/jpeg</strong></td> |
| 1325 |
<td align=center><tt>jpg</tt></td> |
| 1326 |
<td>JPEG image</td></tr> |
| 1327 |
<tr valign="top"> |
| 1328 |
<td align=left><strong>image/pbm</strong></td> |
| 1329 |
<td align=center><tt>pbm</tt></td> |
| 1330 |
<td>Portable bitmap</td></tr> |
| 1331 |
<tr valign="top"> |
| 1332 |
<td align=left><strong>image/pgm</strong></td> |
| 1333 |
<td align=center><tt>pgm</tt></td> |
| 1334 |
<td>Portable graymap</td></tr> |
| 1335 |
<tr valign="top"> |
| 1336 |
<td align=left><strong>image/png</strong></td> |
| 1337 |
<td align=center><tt>png</tt></td> |
| 1338 |
<td>PNG image</td></tr> |
| 1339 |
<tr valign="top"> |
| 1340 |
<td align=left><strong>image/tiff</strong></td> |
| 1341 |
<td align=center><tt>tif</tt></td> |
| 1342 |
<td>TIFF image</td></tr> |
| 1343 |
<tr valign="top"> |
| 1344 |
<td align=left><strong>image/vnd</strong></td> |
| 1345 |
<td align=center><tt>dwg</tt></td> |
| 1346 |
<td>VND image</td></tr> |
| 1347 |
<tr valign="top"> |
| 1348 |
<td align=left><strong>image/wavelet</strong></td> |
| 1349 |
<td align=center><tt>wi</tt></td> |
| 1350 |
<td>Wavelet image</td></tr> |
| 1351 |
<tr valign="top"> |
| 1352 |
<td align=left><strong>image/x-cmu-raster</strong></td> |
| 1353 |
<td align=center><tt>ras</tt></td> |
| 1354 |
<td>CMU raster</td></tr> |
| 1355 |
<tr valign="top"> |
| 1356 |
<td align=left><strong>image/x-pbm</strong></td> |
| 1357 |
<td align=center><tt>pbm</tt></td> |
| 1358 |
<td>Portable bitmap</td></tr> |
| 1359 |
<tr valign="top"> |
| 1360 |
<td align=left><strong>image/x-pcx</strong></td> |
| 1361 |
<td align=center><tt>pcx</tt></td> |
| 1362 |
<td>PCX image</td></tr> |
| 1363 |
<tr valign="top"> |
| 1364 |
<td align=left><strong>image/x-pgm</strong></td> |
| 1365 |
<td align=center><tt>pgm</tt></td> |
| 1366 |
<td>Portable graymap</td></tr> |
| 1367 |
<tr valign="top"> |
| 1368 |
<td align=left><strong>image/x-pict</strong></td> |
| 1369 |
<td align=center><tt>pict</tt></td> |
| 1370 |
<td>Mac PICT image</td></tr> |
| 1371 |
<tr valign="top"> |
| 1372 |
<td align=left><strong>image/x-pnm</strong></td> |
| 1373 |
<td align=center><tt>pnm</tt></td> |
| 1374 |
<td>Portable anymap</td></tr> |
| 1375 |
<tr valign="top"> |
| 1376 |
<td align=left><strong>image/x-portable-anymap</strong></td> |
| 1377 |
<td align=center><tt>pnm</tt></td> |
| 1378 |
<td>Portable anymap</td></tr> |
| 1379 |
<tr valign="top"> |
| 1380 |
<td align=left><strong>image/x-portable-bitmap</strong></td> |
| 1381 |
<td align=center><tt>pbm</tt></td> |
| 1382 |
<td>Portable bitmap</td></tr> |
| 1383 |
<tr valign="top"> |
| 1384 |
<td align=left><strong>image/x-portable-graymap</strong></td> |
| 1385 |
<td align=center><tt>pgm</tt></td> |
| 1386 |
<td>Portable graymap</td></tr> |
| 1387 |
<tr valign="top"> |
| 1388 |
<td align=left><strong>image/x-portable-pixmap</strong></td> |
| 1389 |
<td align=center><tt>ppm</tt></td> |
| 1390 |
<td>Portable pixmap</td></tr> |
| 1391 |
<tr valign="top"> |
| 1392 |
<td align=left><strong>image/x-ppm</strong></td> |
| 1393 |
<td align=center><tt>ppm</tt></td> |
| 1394 |
<td>Portable pixmap</td></tr> |
| 1395 |
<tr valign="top"> |
| 1396 |
<td align=left><strong>image/x-rgb</strong></td> |
| 1397 |
<td align=center><tt>rgb</tt></td> |
| 1398 |
<td>RGB image</td></tr> |
| 1399 |
<tr valign="top"> |
| 1400 |
<td align=left><strong>image/x-xbitmap</strong></td> |
| 1401 |
<td align=center><tt>xbm</tt></td> |
| 1402 |
<td>X bitmap</td></tr> |
| 1403 |
<tr valign="top"> |
| 1404 |
<td align=left><strong>image/x-xbm</strong></td> |
| 1405 |
<td align=center><tt>xbm</tt></td> |
| 1406 |
<td>X bitmap</td></tr> |
| 1407 |
<tr valign="top"> |
| 1408 |
<td align=left><strong>image/x-xpixmap</strong></td> |
| 1409 |
<td align=center><tt>xpm</tt></td> |
| 1410 |
<td>X pixmap</td></tr> |
| 1411 |
<tr valign="top"> |
| 1412 |
<td align=left><strong>image/x-xpm</strong></td> |
| 1413 |
<td align=center><tt>xpm</tt></td> |
| 1414 |
<td>X pixmap</td></tr> |
| 1415 |
<tr valign="top"> |
| 1416 |
<td align=left><strong>image/xwd</strong></td> |
| 1417 |
<td align=center><tt>xwd</tt></td> |
| 1418 |
<td>X window dump</td></tr> |
| 1419 |
<tr valign="top"> |
| 1420 |
<td align=left><strong>image/xwindowdump</strong></td> |
| 1421 |
<td align=center><tt>xwd</tt></td> |
| 1422 |
<td>X window dump</td></tr> |
| 1423 |
<tr valign="top"> |
| 1424 |
<td align=left><strong>message/news</strong></td> |
| 1425 |
<td align=center><tt>822</tt></td> |
| 1426 |
<td>News post</td></tr> |
| 1427 |
<tr valign="top"> |
| 1428 |
<td align=left><strong>message/rfc822</strong></td> |
| 1429 |
<td align=center><tt>822</tt></td> |
| 1430 |
<td>Mail message</td></tr> |
| 1431 |
<tr valign="top"> |
| 1432 |
<td align=left><strong>model/iges</strong></td> |
| 1433 |
<td align=center><tt>iges</tt></td> |
| 1434 |
<td>IGES model</td></tr> |
| 1435 |
<tr valign="top"> |
| 1436 |
<td align=left><strong>model/mesh</strong></td> |
| 1437 |
<td align=center><tt>mesh</tt></td> |
| 1438 |
<td>Mesh model</td></tr> |
| 1439 |
<tr valign="top"> |
| 1440 |
<td align=left><strong>model/vrml</strong></td> |
| 1441 |
<td align=center><tt>wrl</tt></td> |
| 1442 |
<td>VRML model</td></tr> |
| 1443 |
<tr valign="top"> |
| 1444 |
<td align=left><strong>text/enriched</strong></td> |
| 1445 |
<td align=center><tt>rtx</tt></td> |
| 1446 |
<td>Text-enriched document</td></tr> |
| 1447 |
<tr valign="top"> |
| 1448 |
<td align=left><strong>text/html</strong></td> |
| 1449 |
<td align=center><tt>html</tt></td> |
| 1450 |
<td>HTML document</td></tr> |
| 1451 |
<tr valign="top"> |
| 1452 |
<td align=left><strong>text/plain</strong></td> |
| 1453 |
<td align=center><tt>txt</tt></td> |
| 1454 |
<td>Text document</td></tr> |
| 1455 |
<tr valign="top"> |
| 1456 |
<td align=left><strong>text/richtext</strong></td> |
| 1457 |
<td align=center><tt>rtx</tt></td> |
| 1458 |
<td>Richtext document</td></tr> |
| 1459 |
<tr valign="top"> |
| 1460 |
<td align=left><strong>text/setext</strong></td> |
| 1461 |
<td align=center><tt>stx</tt></td> |
| 1462 |
<td>Setext document</td></tr> |
| 1463 |
<tr valign="top"> |
| 1464 |
<td align=left><strong>text/sgml</strong></td> |
| 1465 |
<td align=center><tt>sgml</tt></td> |
| 1466 |
<td>SGML document</td></tr> |
| 1467 |
<tr valign="top"> |
| 1468 |
<td align=left><strong>text/tab-separated-values</strong></td> |
| 1469 |
<td align=center><tt>tsv</tt></td> |
| 1470 |
<td>Tab separated values</td></tr> |
| 1471 |
<tr valign="top"> |
| 1472 |
<td align=left><strong>text/x-speech</strong></td> |
| 1473 |
<td align=center><tt>talk</tt></td> |
| 1474 |
<td>Speech document</td></tr> |
| 1475 |
<tr valign="top"> |
| 1476 |
<td align=left><strong>text/x-vcard</strong></td> |
| 1477 |
<td align=center><tt>vcf</tt></td> |
| 1478 |
<td>Vcard</td></tr> |
| 1479 |
<tr valign="top"> |
| 1480 |
<td align=left><strong>text/xml</strong></td> |
| 1481 |
<td align=center><tt>xml</tt></td> |
| 1482 |
<td>XML document</td></tr> |
| 1483 |
<tr valign="top"> |
| 1484 |
<td align=left><strong>video/isivideo</strong></td> |
| 1485 |
<td align=center><tt>fvi</tt></td> |
| 1486 |
<td>isi video</td></tr> |
| 1487 |
<tr valign="top"> |
| 1488 |
<td align=left><strong>video/mpeg</strong></td> |
| 1489 |
<td align=center><tt>mpg</tt></td> |
| 1490 |
<td>MPEG movie</td></tr> |
| 1491 |
<tr valign="top"> |
| 1492 |
<td align=left><strong>video/msvideo</strong></td> |
| 1493 |
<td align=center><tt>avi</tt></td> |
| 1494 |
<td>MS Video</td></tr> |
| 1495 |
<tr valign="top"> |
| 1496 |
<td align=left><strong>video/quicktime</strong></td> |
| 1497 |
<td align=center><tt>mov</tt></td> |
| 1498 |
<td>QuickTime movie</td></tr> |
| 1499 |
<tr valign="top"> |
| 1500 |
<td align=left><strong>video/vivo</strong></td> |
| 1501 |
<td align=center><tt>viv</tt></td> |
| 1502 |
<td>vivo video</td></tr> |
| 1503 |
<tr valign="top"> |
| 1504 |
<td align=left><strong>video/wavelet</strong></td> |
| 1505 |
<td align=center><tt>wv</tt></td> |
| 1506 |
<td>Wavelet video</td></tr> |
| 1507 |
<tr valign="top"> |
| 1508 |
<td align=left><strong>video/x-sgi-movie</strong></td> |
| 1509 |
<td align=center><tt>movie</tt></td> |
| 1510 |
<td>SGI movie</td></tr> |
| 1511 |
</table> |
| 1512 |
<!--X-Ext-CType-End--> |
| 1513 |
</center> |
| 1514 |
|
| 1515 |
<H3><a name="m2h_msg_extbody">m2h_msg_extbody::filter</a></h3> |
| 1516 |
|
| 1517 |
<p>This filter is designed to process <tt>message/external-body</tt> |
| 1518 |
data. |
| 1519 |
The filter attempts to translate the external-body paramaters |
| 1520 |
into a linked URL with some descriptive information, |
| 1521 |
if provided. The following access-types are supported: |
| 1522 |
ANON-FTP, FTP, TFTP, HTTP, LOCAL-FILE, and URL. Note, LOCAL-FILE is |
| 1523 |
only supported if the <tt>local-file</tt> option is specified. |
| 1524 |
</p> |
| 1525 |
|
| 1526 |
<p><strong><tt>m2h_msg_extbody::filter</tt></strong> can take the |
| 1527 |
following |
| 1528 |
<a href="mimeargs.html">MIMEARGS arguments</a>: |
| 1529 |
</p> |
| 1530 |
|
| 1531 |
<table cellspacing=1 border=0 cellpadding=4> |
| 1532 |
<tr valign=top> |
| 1533 |
<td><strong><tt>local-file</tt></strong></td> |
| 1534 |
<td><p>Support LOCAL-FILE access-type. This option |
| 1535 |
is best used for internal local mail archives |
| 1536 |
where it is known that readers will have |
| 1537 |
direct access to the file. |
| 1538 |
</p> |
| 1539 |
</tr> |
| 1540 |
</table> |
| 1541 |
|
| 1542 |
|
| 1543 |
<H3><a name="m2h_text_enriched">m2h_text_enriched::filter</a></h3> |
| 1544 |
|
| 1545 |
<p>This filter is designed to process text/enriched, or |
| 1546 |
text/richtext, data. The following table summarizes the |
| 1547 |
translation of text/enriched commands to HTML tags: |
| 1548 |
</p> |
| 1549 |
|
| 1550 |
<center> |
| 1551 |
<table border=1 cellpadding=2> |
| 1552 |
<tr valign=top align=left bgcolor="#C0C0C0"> |
| 1553 |
<th>Text/Enriched Command</th><th>HTML Translation</th> |
| 1554 |
</tr> |
| 1555 |
<tr valign=top> |
| 1556 |
<td><strong><Bold></strong></td> |
| 1557 |
<td><b></td> |
| 1558 |
</tr> |
| 1559 |
<tr valign=top> |
| 1560 |
<td><strong><Italic></strong></td> |
| 1561 |
<td><i></td> |
| 1562 |
</tr> |
| 1563 |
<tr valign=top> |
| 1564 |
<td><strong><Underline></strong></td> |
| 1565 |
<td><u></td> |
| 1566 |
</tr> |
| 1567 |
<tr valign=top> |
| 1568 |
<td><strong><Fixed></strong></td> |
| 1569 |
<td><tt></td> |
| 1570 |
</tr> |
| 1571 |
<tr valign=top> |
| 1572 |
<td><strong><Smaller></strong></td> |
| 1573 |
<td><small></td> |
| 1574 |
</tr> |
| 1575 |
<tr valign=top> |
| 1576 |
<td><strong><Bigger></strong></td> |
| 1577 |
<td><big></td> |
| 1578 |
</tr> |
| 1579 |
<tr valign=top> |
| 1580 |
<td><strong><FontFamily><Param><var>family</var></Param></strong></td> |
| 1581 |
<td><font face="<var>family</var>"></td> |
| 1582 |
</tr> |
| 1583 |
<tr valign=top> |
| 1584 |
<td><strong><Color><Param><var>color</var></Param></strong></td> |
| 1585 |
<td><font color="<var>color</var>"></td> |
| 1586 |
</tr> |
| 1587 |
<tr valign=top> |
| 1588 |
<td><strong><Center></strong></td> |
| 1589 |
<td><p align="center"></td> |
| 1590 |
</tr> |
| 1591 |
<tr valign=top> |
| 1592 |
<td><strong><FlushLeft></strong></td> |
| 1593 |
<td><p align="left"></td> |
| 1594 |
</tr> |
| 1595 |
<tr valign=top> |
| 1596 |
<td><strong><FlushRight></strong></td> |
| 1597 |
<td><p align="right"></td> |
| 1598 |
</tr> |
| 1599 |
<tr valign=top> |
| 1600 |
<td><strong><FlushBoth></strong></td> |
| 1601 |
<td><p align="justify"></td> |
| 1602 |
</tr> |
| 1603 |
<tr valign=top> |
| 1604 |
<td><strong><ParaIndent></strong></td> |
| 1605 |
<td><blockquote></td> |
| 1606 |
</tr> |
| 1607 |
<tr valign=top> |
| 1608 |
<td><strong><Excerpt></strong></td> |
| 1609 |
<td><blockquote></td> |
| 1610 |
</tr> |
| 1611 |
<tr valign=top> |
| 1612 |
<td><strong><Lang><Param><var>lang</var></Param></strong></td> |
| 1613 |
<td><div lang="<var>lang</var>"></td> |
| 1614 |
</tr> |
| 1615 |
</table> |
| 1616 |
</center> |
| 1617 |
|
| 1618 |
<p>Character data will be translated as specified by the |
| 1619 |
<a href="charsetconverters.html">CHARSETCONVERTERS</a> resources. |
| 1620 |
</p> |
| 1621 |
|
| 1622 |
<H3><a name="m2h_text_html">m2h_text_html::filter</a></h3> |
| 1623 |
|
| 1624 |
<table class="caution" width="100%"> |
| 1625 |
<tr valign=top> |
| 1626 |
<td><strong style="color: red;">CAUTION:</strong></td> |
| 1627 |
<td width="100%"><p>For |
| 1628 |
<a href="../faq/security.html#htmldata">security reasons</a>, |
| 1629 |
it is highly recommended to disable |
| 1630 |
support of HTML messages in your mail archives. There is no |
| 1631 |
guarantee this filter is robust enough to eliminate all possible |
| 1632 |
exploits that can occur with HTML data. |
| 1633 |
See the following <a href="../faq/faq.html">FAQ</a> questions for more |
| 1634 |
information: |
| 1635 |
</p> |
| 1636 |
<ul> |
| 1637 |
<li><a href="../faq/security.html#htmldata">Why are HTML messages a security risk?</a></li> |
| 1638 |
<li><a href="../faq/security.html#htmlexchow">So how can I exclude HTML mail?</a></li> |
| 1639 |
</ul> |
| 1640 |
<p> </p> |
| 1641 |
</td> |
| 1642 |
</tr> |
| 1643 |
</table> |
| 1644 |
|
| 1645 |
<p>This filter is designed to process <tt>text/html</tt>, or |
| 1646 |
<tt>text/x-html</tt>, data. |
| 1647 |
The following modifications are done to HTML documents when |
| 1648 |
processed by MHonArc: |
| 1649 |
</p> |
| 1650 |
<ul> |
| 1651 |
<li><p>The HEAD element is removed. Since some content within the HEAD |
| 1652 |
element may be relevant to the rest of the document, the following is |
| 1653 |
done when the HEAD element is removed:</p> |
| 1654 |
<ul> |
| 1655 |
<li>The title will be extracted and prepended |
| 1656 |
to the body data.</li> |
| 1657 |
<li>Any BASE URL will be propogated to relative URLs in the |
| 1658 |
document.</li> |
| 1659 |
</ul> |
| 1660 |
<p></p> |
| 1661 |
</li> |
| 1662 |
<li><p>Any markup related to scripting is removed for security |
| 1663 |
reasons. Javascript URLs are munged to make them ineffective. |
| 1664 |
At a minimum, the following tags are stripped: |
| 1665 |
<tt><applet></tt>, |
| 1666 |
<tt><base></tt>, |
| 1667 |
<tt><embed></tt>, |
| 1668 |
<tt><form></tt>, |
| 1669 |
<tt><ilayer></tt>, |
| 1670 |
<tt><input></tt>, |
| 1671 |
<tt><layer></tt>, |
| 1672 |
<tt><link></tt>, |
| 1673 |
<tt><meta></tt>, |
| 1674 |
<tt><object></tt>, |
| 1675 |
<tt><option></tt>, |
| 1676 |
<tt><param></tt>, |
| 1677 |
<tt><script></tt>, |
| 1678 |
<tt><select></tt>, |
| 1679 |
<tt><style></tt>, |
| 1680 |
<tt><textarea></tt>. |
| 1681 |
At a minimum, the following attributes are removed: |
| 1682 |
<tt>onload</tt>, |
| 1683 |
<tt>onunload</tt>, |
| 1684 |
<tt>onclick</tt>, |
| 1685 |
<tt>ondblclick</tt>, |
| 1686 |
<tt>onmousedown</tt>, |
| 1687 |
<tt>onmouseup</tt>, |
| 1688 |
<tt>onmouseover</tt>, |
| 1689 |
<tt>onmousemove</tt>, |
| 1690 |
<tt>onmouseout</tt>, |
| 1691 |
<tt>onkeypress</tt>, |
| 1692 |
<tt>onkeydown</tt>, |
| 1693 |
<tt>onkeyup</tt>. |
| 1694 |
The <strong><tt>allowscript</tt></strong> option can be |
| 1695 |
be used to override this behavior (see below). |
| 1696 |
</p></li> |
| 1697 |
<li><p><b><tt>cid:</tt></b> URLs are resolved, if possible. Therefore, |
| 1698 |
if image data related to the HTML document is included with the message, |
| 1699 |
the URLs in the HTML will be modified to reference the decoded image |
| 1700 |
data. |
| 1701 |
</p> |
| 1702 |
</li> |
| 1703 |
</ul> |
| 1704 |
|
| 1705 |
<p><strong><tt>m2h_text_html::filter</tt></strong> can take the |
| 1706 |
following |
| 1707 |
<a href="mimeargs.html">MIMEARGS arguments</a>: |
| 1708 |
</p> |
| 1709 |
|
| 1710 |
<table cellspacing=1 border=0 cellpadding=4> |
| 1711 |
<tr valign=top> |
| 1712 |
<td><strong><tt>allowcomments</tt></strong></td> |
| 1713 |
<td><p>Preserve any comment declarations. |
| 1714 |
By default, comment declarations are munged |
| 1715 |
to protect against potential exploits, but this option will |
| 1716 |
disable that behavior. |
| 1717 |
</p> |
| 1718 |
<table class="caution" width="100%"> |
| 1719 |
<tr valign=top> |
| 1720 |
<td><strong style="color: red;">CAUTION:</strong></td> |
| 1721 |
<td width="100%"><p> |
| 1722 |
Using this option can open up security vulnerabilies, including the |
| 1723 |
accessing of server resources. If you have server-side includes |
| 1724 |
enabled for your site, you SHOULD NOT use this option. |
| 1725 |
</p> |
| 1726 |
</td></tr></table> |
| 1727 |
</td> |
| 1728 |
</tr> |
| 1729 |
<tr valign=top> |
| 1730 |
<td><strong><tt>allownoncidurls</tt></strong></td> |
| 1731 |
<td><p>Preserve URL-based attributes that are not cid: URLs. |
| 1732 |
By default, any URL-based attribute -- <tt>href</tt>, <tt>src</tt>, |
| 1733 |
<tt>background</tt>, <tt>classid</tt>, <tt>data</tt>, <tt>longdesc</tt> |
| 1734 |
-- will be stripped if it is not a cid URL. |
| 1735 |
This prevents |
| 1736 |
malicious URLs from verifying mail addresses, secretly |
| 1737 |
setting cookies, or gathering statistical data with the |
| 1738 |
use of elements that cause browsers to automatically fetch data without |
| 1739 |
user interaction: |
| 1740 |
<tt>IMG</tt>, <tt>BODY</tt>, <tt>IFRAME</tt>, <tt>FRAME</tt>, |
| 1741 |
<tt>OBJECT</tt>, <tt>SCRIPT</tt>, <tt>INPUT</tt>. |
| 1742 |
</p> |
| 1743 |
<table class="note" width="100%"> |
| 1744 |
<tr valign=top> |
| 1745 |
<td><strong>NOTE:</strong></td> |
| 1746 |
<td width="100%"><p><tt>Href</tt> attributes for anchor, <tt><A></tt>, |
| 1747 |
elements are preserved, even if <tt>allownoncidurls</tt> is |
| 1748 |
not specified. This is so regular hyperlinks will function. Javascript |
| 1749 |
URLs will still be munged (unless the <tt>allowscript</tt> option is |
| 1750 |
specified). |
| 1751 |
</p> |
| 1752 |
</td></tr></table> |
| 1753 |
</td> |
| 1754 |
</tr> |
| 1755 |
<tr valign=top> |
| 1756 |
<td><strong><tt>allowscript</tt></strong></td> |
| 1757 |
<td><p>Preserve any markup associated with scripting. |
| 1758 |
This includes elements and attributes related to scripting. |
| 1759 |
</p> |
| 1760 |
<table class="caution" width="100%"> |
| 1761 |
<tr valign=top> |
| 1762 |
<td><strong style="color: red;">CAUTION:</strong></td> |
| 1763 |
<td width="100%"><p> |
| 1764 |
Use of this option can open up your archives to cross-site scripting (XSS) |
| 1765 |
attacks. It is highly recommended to NOT use this option, especially |
| 1766 |
for publicly accessible archives. |
| 1767 |
</p> |
| 1768 |
</td></tr></table> |
| 1769 |
</td> |
| 1770 |
</tr> |
| 1771 |
<tr valign=top> |
| 1772 |
<td><strong><tt>attachcheck</tt></strong></td> |
| 1773 |
<td><p>Honor attachment disposition. By default, |
| 1774 |
all text/html data is displayed inline on |
| 1775 |
the message page. If <tt>attachcheck</tt> is specified |
| 1776 |
and Content-Disposition specifies the data as |
| 1777 |
an attachment, the data is saved to a file |
| 1778 |
with a link to it from the message page. |
| 1779 |
</p> |
| 1780 |
<table class="caution" width="100%"> |
| 1781 |
<tr valign=top> |
| 1782 |
<td><strong style="color: red;">CAUTION:</strong></td> |
| 1783 |
<td width="100%"><p> |
| 1784 |
If <tt>attachcheck</tt> is specified, the HTML |
| 1785 |
data is saved "as-is". For example, no stripping of scripting-based |
| 1786 |
markup is performed and no resolution of cid URLs are performed, allowing |
| 1787 |
your archive to be used for cross-site scripting (XSS) exploits. |
| 1788 |
This option <strong>SHOULD NOT BE USED</strong> for archives unless all mail |
| 1789 |
from all senders can be trusted. |
| 1790 |
</p> |
| 1791 |
</td></tr></table> |
| 1792 |
</td> |
| 1793 |
</tr> |
| 1794 |
<tr valign=top> |
| 1795 |
<td><strong><tt>disablerelated</tt></strong></td> |
| 1796 |
<td><p>Disable processing of related parts processing: |
| 1797 |
cid URLs will not be resolved. |
| 1798 |
</p></td> |
| 1799 |
</tr> |
| 1800 |
<tr valign=top> |
| 1801 |
<td><strong><tt>nofont</tt></strong></td> |
| 1802 |
<td><p>Remove font tags and styles, including CSS styles. |
| 1803 |
</p></td> |
| 1804 |
</tr> |
| 1805 |
<tr valign=top> |
| 1806 |
<td><strong><tt>notitle</tt></strong></td> |
| 1807 |
<td><p>Do not print extracted title at the beginning of converted |
| 1808 |
output. By default, the title is printed before the document |
| 1809 |
body. The <tt>notitle</tt> argument disables this behavior. |
| 1810 |
</p></td> |
| 1811 |
<tr valign=top> |
| 1812 |
<td><strong><tt>subdir</tt></strong></td> |
| 1813 |
<td><p>Place attachment files in a subdirectory of the archive. |
| 1814 |
This option is used for MHTML messages that include inline images |
| 1815 |
are other referenced data. |
| 1816 |
</p></td> |
| 1817 |
</tr> |
| 1818 |
</table> |
| 1819 |
|
| 1820 |
<H3><a name="m2h_text_plain">m2h_text_plain::filter</a></h3> |
| 1821 |
|
| 1822 |
<p>This filter is designed to process text/plain messages and |
| 1823 |
messages with no MIME information. The |
| 1824 |
filter is also used to process text messages of an unknown |
| 1825 |
subtype. |
| 1826 |
</p> |
| 1827 |
|
| 1828 |
<p>The default behavior of the filter is to wrap the data in |
| 1829 |
the HTML <tt>PRE</tt> element and escape special characters. It |
| 1830 |
also converts text that looks like a URL into a hyperlink. |
| 1831 |
Character data will be translated as specified by the |
| 1832 |
<a href="charsetconverters.html">CHARSETCONVERTERS</a> resources. |
| 1833 |
</p> |
| 1834 |
|
| 1835 |
<p>This filter supports text data donoted with flowed sematics as |
| 1836 |
defined by <a href="http://www.ietf.org/rfc/rfc2646.txt">RFC 2646</a>. |
| 1837 |
Quoted text will be wrapped in HTML <tt>BLOCKQUOTE</tt> tags with |
| 1838 |
inline CSS styles to highlight quoted text with a vertical bar in the |
| 1839 |
left margin: |
| 1840 |
</p> |
| 1841 |
<blockquote style="border-left: #0000FF solid 0.1em; margin-left: 0.0em; padding-left: 1.0em">This is some quoted text. |
| 1842 |
This is some quoted text. |
| 1843 |
This is some quoted text. |
| 1844 |
This is some quoted text. |
| 1845 |
This is some quoted text.</blockquote> |
| 1846 |
|
| 1847 |
<p>CSS style customization can be done by using the |
| 1848 |
<tt>quoteclass</tt> argument described below. |
| 1849 |
</p> |
| 1850 |
|
| 1851 |
<p><strong><tt>m2h_text_plain::filter</tt></strong> can take the |
| 1852 |
following |
| 1853 |
<a href="mimeargs.html">MIMEARGS arguments</a>: |
| 1854 |
</p> |
| 1855 |
|
| 1856 |
<table cellspacing=1 border=0 cellpadding=4> |
| 1857 |
|
| 1858 |
<tr valign=top> |
| 1859 |
<td><strong><tt>asis=</tt></strong><var>set1</var><tt>:</tt>...</td> |
| 1860 |
<td><p>Colon separated lists of charsets to leave as-is. |
| 1861 |
Only HTML special characters will be converted into entities. |
| 1862 |
</p> |
| 1863 |
<table class="note" width="100%"> |
| 1864 |
<tr valign=top> |
| 1865 |
<td><strong>NOTE:</strong></td> |
| 1866 |
<td width="100%"><p>The <tt>asis</tt> option is deprecated. |
| 1867 |
It is recommended to use the |
| 1868 |
<a href="charsetconverters.html">CHARSETCONVERTERS</a> resource to |
| 1869 |
control how character data is converted. |
| 1870 |
</p> |
| 1871 |
</td></tr></table> |
| 1872 |
</tr> |
| 1873 |
<tr valign=top> |
| 1874 |
<td><strong><tt>attachcheck</tt></strong></td> |
| 1875 |
<td><p>Honor attachment disposition. By default, |
| 1876 |
all text/plain data is displayed inline on |
| 1877 |
the message page. If <tt>attachcheck</tt> is specified |
| 1878 |
and Content-Disposition specifies the data as |
| 1879 |
an attachment, the data is saved to a file |
| 1880 |
with a link to it from the message page. |
| 1881 |
</p> |
| 1882 |
</tr> |
| 1883 |
<tr valign=top> |
| 1884 |
<td><strong><tt>disableflowed</tt></strong></td> |
| 1885 |
<td><p>Flowed sematics will be ignored for text denoted with flowed |
| 1886 |
formatting. |
| 1887 |
</p> |
| 1888 |
<table class="note" width="100%"> |
| 1889 |
<tr valign=top> |
| 1890 |
<td><strong>NOTE:</strong></td> |
| 1891 |
<td width="100%"><p> |
| 1892 |
The effects of <tt>fancyquote</tt> and |
| 1893 |
<tt>quote</tt> will still occur if either option is specified. |
| 1894 |
</p> |
| 1895 |
</td></tr></table> |
| 1896 |
</tr> |
| 1897 |
<tr valign=top> |
| 1898 |
<td><strong><tt>fancyquote</tt></strong></td> |
| 1899 |
<td><p>Highlight quoted message text. Quoted text will be wrapped |
| 1900 |
in HTML <tt>BLOCKQUOTE</tt> elements. By default, inline CSS style |
| 1901 |
settings are generated to render a vertical bar in the left margin. The |
| 1902 |
inline styles are suppressed if the <tt>quoteclass</tt> option is set. |
| 1903 |
</p> |
| 1904 |
<p>This option generates similiar rendering of quoted text as is done |
| 1905 |
for flowed text data, but without the flowed text wrapping sematics. |
| 1906 |
</p> |
| 1907 |
<table class="note" width="100%"> |
| 1908 |
<tr valign=top> |
| 1909 |
<td><strong>NOTE:</strong></td> |
| 1910 |
<td width="100%"><p> |
| 1911 |
If message text is denoted as flowed text by |
| 1912 |
message headers, the text will always be rendered with flowed sematics |
| 1913 |
unless the <tt>disableflowed</tt> option is specified. |
| 1914 |
</p> |
| 1915 |
</td></tr></table> |
| 1916 |
</tr> |
| 1917 |
<tr valign=top> |
| 1918 |
<td><strong><tt>htmlcheck</tt></strong></td> |
| 1919 |
<td><p>Check if message is actually an HTML message |
| 1920 |
(to get around abhorrent MUAs). The message |
| 1921 |
is treated as HTML if the first non-whitespace |
| 1922 |
data looks like the start of an HTML document. |
| 1923 |
</p> |
| 1924 |
<p>If the data looks like HTML, the <a href="#m2h_text_html">HTML filter</a> |
| 1925 |
will be invoked on it. |
| 1926 |
</p> |
| 1927 |
</tr> |
| 1928 |
<tr valign=top> |
| 1929 |
<td><strong><tt>inlineexts=</tt></strong><var>ext1</var><tt>,</tt>...</td> |
| 1930 |
<td><p>A comma separated list of message specified filename |
| 1931 |
extensions to treat as inline data. |
| 1932 |
Applicable only when <b><tt>uudecode</tt></b> and |
| 1933 |
<b><tt>usename</tt></b> are specified. |
| 1934 |
</p> |
| 1935 |
</tr> |
| 1936 |
<tr valign=top> |
| 1937 |
<td><strong><tt>keepspace</tt></strong></td> |
| 1938 |
<td><p>Preserve all spaces if the <strong><tt>nonfixed</tt></strong> |
| 1939 |
option is specified. All spaces and tabs will be translated to the |
| 1940 |
equivalent number of <strong>&nbsp;</strong> entity references. |
| 1941 |
</p> |
| 1942 |
</tr> |
| 1943 |
<tr valign=top> |
| 1944 |
<td><strong><a name="tpa_link"><tt>link=</tt></strong><var>scheme1</var><tt>,</tt>...</a></td> |
| 1945 |
<td><p>A comma separated list of URL schemes denoting which URLs |
| 1946 |
to convert into hyperlinks. By default, all URLs will be converted |
| 1947 |
into hyperlinks. This option allows you to restrict the set of |
| 1948 |
URLs converted. |
| 1949 |
</p> |
| 1950 |
<p>Compare this argument with <a href="#tpa_nolink"><tt>nolink</tt></a>. |
| 1951 |
</p> |
| 1952 |
</tr> |
| 1953 |
<tr valign=top> |
| 1954 |
<td><strong><tt>maxwidth=</tt></strong><var>#</var></td> |
| 1955 |
<td><p>Force the maximum width of lines to be <var>#</var> characters |
| 1956 |
in length. Any lines longer than <var>#</var> characters will be |
| 1957 |
wrapped. |
| 1958 |
</p> |
| 1959 |
<table class="note" width="100%"> |
| 1960 |
<tr valign=top> |
| 1961 |
<td><strong>NOTE:</strong></td> |
| 1962 |
<td width="100%"><p>A line that contains no whitespace and is longer |
| 1963 |
than <tt>maxwidth</tt>, will not be wrapped. |
| 1964 |
</p> |
| 1965 |
</td></tr></table> |
| 1966 |
</tr> |
| 1967 |
<tr valign=top> |
| 1968 |
<td><strong><a name="tpa_nolink"><tt>nolink=</tt></strong><var>scheme1</var><tt>,</tt>...</a></td> |
| 1969 |
<td><p>A comma separated list of URL schemes denoting which URLs |
| 1970 |
to <strong>not</strong> convert into hyperlinks. By default, all |
| 1971 |
URLs will be converted into hyperlinks. |
| 1972 |
This option allows you to specify URLs that should never be converted. |
| 1973 |
</p> |
| 1974 |
<p>Compare this argument with <a href="#tpa_link"><tt>link</tt></a>. |
| 1975 |
</p> |
| 1976 |
</tr> |
| 1977 |
<tr valign=top> |
| 1978 |
<td><strong><tt>nonfixed</tt></strong></td> |
| 1979 |
<td><p>Do not wrap message text in the HTML <tt>PRE</tt> element. This will |
| 1980 |
cause text to be rendered in the default font (which is normally |
| 1981 |
proportionally spaced). Each line of the message will have |
| 1982 |
a <tt><br></tt> appended in order to preserve the line representation |
| 1983 |
of the message. |
| 1984 |
</p> |
| 1985 |
</tr> |
| 1986 |
<tr valign=top> |
| 1987 |
<td><strong><tt>nourl</tt></strong></td> |
| 1988 |
<td><p>Do not hyperlink URLs. This option overrides |
| 1989 |
<tt>link</tt> and <tt>nolink</tt>. |
| 1990 |
</p> |
| 1991 |
</tr> |
| 1992 |
<tr valign=top> |
| 1993 |
<td><strong><tt>quote</tt></strong></td> |
| 1994 |
<td><p>Italicize quoted message text. Any quoted lines in the message |
| 1995 |
will be wrapped in the HTML <tt>I</tt> element. |
| 1996 |
Compare this option with the <tt>fancyquote</tt> option. |
| 1997 |
</p> |
| 1998 |
</tr> |
| 1999 |
<tr valign=top> |
| 2000 |
<td><strong><tt>quoteclass=</tt></strong><var>classname</var></td> |
| 2001 |
<td><p>CSS classname to use for quoted text. This option applies only |
| 2002 |
for flowed text data or if <tt>fancyquote</tt> is specified. The |
| 2003 |
<var>classname</var> will be the value of the <tt>CLASS</tt> attbribute |
| 2004 |
for the <tt>BLOCKQUOTE</tt> elements, and this option suppresses the |
| 2005 |
generation of inline styles. |
| 2006 |
</p> |
| 2007 |
<p>This option is useful if a master stylesheet controls the |
| 2008 |
appearance of archives. By using this option, the master stylesheet |
| 2009 |
can be used to control the rendering of quoted text. |
| 2010 |
</p> |
| 2011 |
</tr> |
| 2012 |
<tr valign=top> |
| 2013 |
<td><strong><tt>subdir</tt></strong></td> |
| 2014 |
<td><p>Place attachment files in a subdirectory of the archive. |
| 2015 |
This option is only applicable if <b><tt>uudecode</tt></b> is specified. |
| 2016 |
</p></td> |
| 2017 |
</tr> |
| 2018 |
<tr valign=top> |
| 2019 |
<td><strong><tt>target=</tt></strong><var>name</var></td> |
| 2020 |
<td><p>Set the TARGET attribute of anchors generated from |
| 2021 |
hyperlinking URLs. |
| 2022 |
</p> |
| 2023 |
</tr> |
| 2024 |
<tr valign=top> |
| 2025 |
<td><strong><tt>usename</tt></strong></td> |
| 2026 |
<td><p>When decoding uuencoded data, use the full filename specified |
| 2027 |
in the message instead of the filename extension. |
| 2028 |
</p> |
| 2029 |
<table class="caution" width="100%"> |
| 2030 |
<tr valign=top> |
| 2031 |
<td><strong style="color: red;">CAUTION:</strong></td> |
| 2032 |
<td width="100%"><p> |
| 2033 |
Use this option with caution |
| 2034 |
since it can lead to filename conflicts and |
| 2035 |
security problems. If you plan on using <tt>usename</tt>, consider |
| 2036 |
using the <tt>subdir</tt> option with it. |
| 2037 |
</p> |
| 2038 |
</td></tr></table> |
| 2039 |
</td> |
| 2040 |
</tr> |
| 2041 |
<tr valign=top> |
| 2042 |
<td><strong><tt>uudecode</tt></strong></td> |
| 2043 |
<td><p>Decode any embedded uuencoded data. Including uuencoded data |
| 2044 |
within messages was a way to transmit binary data |
| 2045 |
via email before MIME was developed. The inclusion of uuencoded |
| 2046 |
data is deprecated within email, but is still common in the |
| 2047 |
USENET (binary) newsgroups. |
| 2048 |
</p> |
| 2049 |
<p>Uuencoded data is treated as <tt>application/octet-stream</tt> |
| 2050 |
for data exclusion purposes: <a href="mimeexcs.html">MIMEEXCS</a>. |
| 2051 |
If <tt>application/octet-stream</tt> data is listed |
| 2052 |
in MIMEEXCS, uuencoded data will be excluded. |
| 2053 |
</p> |
| 2054 |
<table class="note" width="100%"> |
| 2055 |
<tr valign="baseline"> |
| 2056 |
<td><strong>NOTE:</strong></td> |
| 2057 |
<td width="100%"><p>Specifying <b><tt>uudecode</tt></b> |
| 2058 |
adds extra |
| 2059 |
overhead in the processing of text messages, including messages without |
| 2060 |
any uuencoded data. |
| 2061 |
</p> |
| 2062 |
</td> |
| 2063 |
</tr> |
| 2064 |
</table> |
| 2065 |
</td> |
| 2066 |
</tr> |
| 2067 |
|
| 2068 |
</table> |
| 2069 |
|
| 2070 |
<H3><a name="m2h_text_tsv">m2h_text_tsv::filter</a></h3> |
| 2071 |
|
| 2072 |
<p>This filter converts text/tab-separated-values to HTML. The |
| 2073 |
tabular data will be converted into an HTML table. |
| 2074 |
</p> |
| 2075 |
|
| 2076 |
<H3><a name="m2h_null">m2h_null::filter</a></h3> |
| 2077 |
|
| 2078 |
<p>This filter can be used to exclude message content from archives. |
| 2079 |
You can register this filter to any content-type you do not want |
| 2080 |
to store in your archives. For example, the following resource setting |
| 2081 |
excludes all images: |
| 2082 |
</p> |
| 2083 |
<pre class="code"> |
| 2084 |
<b><MIMEFilters></b> |
| 2085 |
image/*; m2h_null::filter</a>; mhnull.pl |
| 2086 |
<b></MIMEFilters></b> |
| 2087 |
</pre> |
| 2088 |
<p>The markup returned by this filter displays the one line description |
| 2089 |
of what was excluded. Examples: |
| 2090 |
</p> |
| 2091 |
<pre class="code"> |
| 2092 |
<<attachment: HelloWorld.jpg>> |
| 2093 |
<<application/postscript>> |
| 2094 |
<<inline: image/jpg>> |
| 2095 |
</pre> |
| 2096 |
<p>If the disposition is available, it will be shown. If a filename |
| 2097 |
was specified, it will be shown. If there was no filename, the |
| 2098 |
content-type is shown. |
| 2099 |
</p> |
| 2100 |
|
| 2101 |
<table class="note" width="100%"> |
| 2102 |
<tr valign=top> |
| 2103 |
<td><strong>NOTE:</strong></td> |
| 2104 |
<td width="100%"><p>The sematics of using the |
| 2105 |
<a href="mimeexcs.html">MIMEEXCS</a> resource vs this filter are different. |
| 2106 |
When using this filter, MHonArc considers the data |
| 2107 |
successfully converted. But with <a href="mimeexcs.html">MIMEEXCS</a>, |
| 2108 |
MHonArc does not consider the data converted. This is relevant when |
| 2109 |
MHonArc determines which alternative part to use for an |
| 2110 |
<tt>multipart/alternative</tt> entity. |
| 2111 |
</p> |
| 2112 |
</td> |
| 2113 |
</tr> |
| 2114 |
</table> |
| 2115 |
|
| 2116 |
<!-- *************************************************************** --> |
| 2117 |
<hr> |
| 2118 |
<h2><a name="default">Default Setting</a></h2> |
| 2119 |
|
| 2120 |
<table class="note" width="100%"> |
| 2121 |
<tr valign=top> |
| 2122 |
<td><strong>NOTE:</strong></td> |
| 2123 |
<td width="100%"><p>It is important to have an explicit entry for |
| 2124 |
<b><tt>application/octet-stream</tt></b> for handling unknown |
| 2125 |
media-types. |
| 2126 |
</p> |
| 2127 |
</td> |
| 2128 |
</tr> |
| 2129 |
</table> |
| 2130 |
|
| 2131 |
<PRE class="code"> |
| 2132 |
<b><MIMEFilters></b> |
| 2133 |
application/octet-stream; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl |
| 2134 |
application/*; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl |
| 2135 |
application/x-patch; <a href="#m2h_text_plain">m2h_text_plain::filter</a>; mhtxtplain.pl |
| 2136 |
audio/*; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl |
| 2137 |
chemical/*; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl |
| 2138 |
model/*; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl |
| 2139 |
image/*; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl |
| 2140 |
message/delivery-status; <a href="#m2h_text_plain">m2h_text_plain::filter</a>; mhtxtplain.pl |
| 2141 |
message/external-body; <a href="#m2h_msg_extbody">m2h_msg_extbody::filter</a>; mhmsgextbody.pl |
| 2142 |
message/partial; <a href="#m2h_text_plain">m2h_text_plain::filter</a>; mhtxtplain.pl |
| 2143 |
text/*; <a href="#m2h_text_plain">m2h_text_plain::filter</a>; mhtxtplain.pl |
| 2144 |
text/enriched; <a href="#m2h_text_enriched">m2h_text_enriched::filter</a>; mhtxtenrich.pl |
| 2145 |
text/html; <a href="#m2h_text_html">m2h_text_html::filter</a>; mhtxthtml.pl |
| 2146 |
text/plain; <a href="#m2h_text_plain">m2h_text_plain::filter</a>; mhtxtplain.pl |
| 2147 |
text/richtext; <a href="#m2h_text_enriched">m2h_text_enriched::filter</a>; mhtxtenrich.pl |
| 2148 |
text/tab-separated-values; <a href="#m2h_text_tsv">m2h_text_tsv::filter</a>; mhtxttsv.pl |
| 2149 |
text/x-html; <a href="#m2h_text_html">m2h_text_html::filter</a>; mhtxthtml.pl |
| 2150 |
video/*; <a href="#m2h_external">m2h_external::filter</a>; mhexternal.pl |
| 2151 |
x-sun-attachment; <a href="#m2h_text_plain">m2h_text_plain::filter</a>; mhtxtplain.pl |
| 2152 |
<b></MIMEFilters></b> |
| 2153 |
</PRE> |
| 2154 |
|
| 2155 |
|
| 2156 |
<!-- *************************************************************** --> |
| 2157 |
<hr> |
| 2158 |
<h2><a name="rcvars">Resource Variables</a></h2> |
| 2159 |
|
| 2160 |
<p>N/A |
| 2161 |
</p> |
| 2162 |
|
| 2163 |
<!-- *************************************************************** --> |
| 2164 |
<hr> |
| 2165 |
<h2><a name="examples">Examples</a></h2> |
| 2166 |
|
| 2167 |
<p>The following code is an example filter for converting |
| 2168 |
<tt>text/tab-separated-values</tt> into an HTML table: |
| 2169 |
</p> |
| 2170 |
<pre class="code"> |
| 2171 |
package m2h_text_tsv; |
| 2172 |
|
| 2173 |
sub filter { |
| 2174 |
my($fields, $data, $isdecode, $args) = <!-- |
| 2175 |
-->@<!-- |
| 2176 |
-->_; |
| 2177 |
my($field, $line, $ret); |
| 2178 |
local($_); |
| 2179 |
|
| 2180 |
$$data =~ s/^\s+//; |
| 2181 |
$ret = "<table border=1>\n"; |
| 2182 |
foreach $line (split(/\r?\n/, $$data)) { |
| 2183 |
$ret .= "<tr>"; |
| 2184 |
foreach $field (split(/\t/, $line)) { |
| 2185 |
$ret .= '<td>' . mhonarc::htmlize($field) . '</td>'; |
| 2186 |
} |
| 2187 |
$ret .= "</tr>\n"; |
| 2188 |
} |
| 2189 |
$ret .= "</table>\n"; |
| 2190 |
($ret); |
| 2191 |
} |
| 2192 |
|
| 2193 |
1; |
| 2194 |
</pre> |
| 2195 |
|
| 2196 |
<!-- *************************************************************** --> |
| 2197 |
<hr> |
| 2198 |
<h2><a name="version">Version</a></h2> |
| 2199 |
|
| 2200 |
<p>1.0 |
| 2201 |
</p> |
| 2202 |
|
| 2203 |
<!-- *************************************************************** --> |
| 2204 |
<hr> |
| 2205 |
<h2><a name="seealso">See Also</a></h2> |
| 2206 |
|
| 2207 |
<p> |
| 2208 |
<a href="charsetconverters.html">CHARSETCONVERTERS</a>, |
| 2209 |
<a href="mimealtprefs.html">MIMEALTPREFS</a>, |
| 2210 |
<a href="mimeargs.html">MIMEARGS</a>, |
| 2211 |
<a href="mimedecoders.html">MIMEDECODERS</a>, |
| 2212 |
<a href="mimeexcs.html">MIMEEXCS</a>, |
| 2213 |
<a href="perlinc.html">PERLINC</a> |
| 2214 |
</p> |
| 2215 |
|
| 2216 |
<!-- *************************************************************** --> |
| 2217 |
<hr> |
| 2218 |
<!--x-rc-nav--> |
| 2219 |
<table border=0><tr valign="top"> |
| 2220 |
<td align="left" width="50%">[Prev: <a href="mimeexcs.html">MIMEEXCS</a>]</td><td><nobr>[<a href="../resources.html#mimefilters">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="mimeincs.html">MIMEINCS</a>]</td></tr></table> |
| 2221 |
<!--/x-rc-nav--> |
| 2222 |
<hr> |
| 2223 |
<address> |
| 2224 |
$Date: 2010/12/31 20:33:59 $ <br> |
| 2225 |
<img align="top" src="../monicon.png" alt=""> |
| 2226 |
<a href="http://www.mhonarc.org"><strong>MHonArc</strong></a><br> |
| 2227 |
Copyright © 1997-2005 <a href="http://www.mhonarc.org/~ehood/">Earl Hood</a>, <a href="mailto:mhonarc%40mhonarc.org">mhonarc<!-- |
| 2228 |
-->@<!-- |
| 2229 |
-->mhonarc.org</a><br> |
| 2230 |
</address> |
| 2231 |
|
| 2232 |
</body> |
| 2233 |
</html> |