2005-10-03 [paul] 1.9.14cvs67
[claws.git] / doc / manual / en / sylpheed-14.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2 <html>
3 <head>
4   <meta name="GENERATOR" content="LinuxDoc-Tools 0.9.21">
5   <title>Sylpheed-Claws User's Manual: Handling MIME types</title>
6   <link href="sylpheed-15.html" rel="next">
7   <link href="sylpheed-13.html" rel="previous">
8   <link href="sylpheed.html#toc14" rel="contents">
9 </head>
10 <body>
11 <a href="sylpheed-15.html">Next</a>
12 <a href="sylpheed-13.html">Previous</a>
13 <a href="sylpheed.html#toc14">Contents</a>
14 <hr>
15 <h2><a name="s14">12.</a> <a href="sylpheed.html#toc14">Handling MIME
16 types</a></h2>
17 <h2><a name="ss14.1">12.1</a> <a href="sylpheed.html#toc14.1">How
18 Sylpheed-Claws checks for Mime types</a>
19 </h2>
20 <p>When attaching a file to a message (composing a new message), the
21 MIME type of the attached file is choosen based on the file extension
22 from the mapping list defined in the <i>mime.types</i> file(s).
23 Sylpheed-Claws defines its MIME type mapping table by loading the
24 system wide MIME types file, then the user file.
25 The systeme file is <span style="font-style: italic;">/usr/share/mime/globs
26 </span>or, if this doesn't exist, <span style="font-style: italic;">SYSCONFDIR/</span><i>mime.types</i>
27 (SYSCONFDIR can
28 be defined at compile time), or if it does not exist, <i>/etc/mime.types</i>.&nbsp;</p>
29 <p>A <i>mime.types</i> file consist of one MIME type definition per
30 line,
31 each definition line starting with the name of the MIME type, followed
32 by
33 a space separated list of the corresponding file extensions.
34 The file can contain empty lines, and comments start with the <code>#</code>
35 character and close at line's end.</p>
36 <p>Following is a typical <i>mime.types</i> file (an extract of mine):</p>
37 <p>
38 </p>
39 <pre># This file controls what Internet media types are sent to the client for<br># given file extension(s).  Sending the correct media type to the client<br># is important so they know how to handle the content of the file.<br># The Internet media type registry is at <br># &lt;ftp://ftp.iana.org/in-notes/iana/assignments/media-types/&gt;.<br><br># MIME type                     Extension<br>application/mac-binhex40        hqx<br>application/mac-compactpro      cpt<br>application/msword              doc<br>application/pdf                 pdf<br>application/postscript          ai eps ps<br>application/rtf                 rtf<br>application/x-bcpio             bcpio<br>application/x-bzip2             bz2<br>application/x-csh               csh<br>application/x-gtar              gtar<br>application/x-gzip              gz tgz<br>application/x-kword             kwd kwt<br>application/x-kspread           ksp<br>application/x-kpresenter        kpr kpt<br>application/x-kchart            chrt<br>application/x-latex             latex<br>application/x-sh                sh<br>application/x-shar              shar<br>application/x-shockwave-flash   swf<br>application/x-tar               tar<br>application/x-tcl               tcl<br>application/x-tex               tex<br>application/x-texinfo           texinfo texi<br>application/x-troff             t tr roff<br>application/x-troff-man         man<br>application/zip                 zip<br>audio/mpeg                      mpga mp2 mp3<br>audio/x-aiff                    aif aiff aifc<br>audio/x-wav                     wav<br>image/gif                       gif<br>image/ief                       ief<br>image/jpeg                      jpeg jpg jpe<br>image/png                       png<br>image/tiff                      tiff tif<br>text/plain                      asc txt<br>text/rtf                        rtf<br>text/sgml                       sgml sgm<br>text/xml                        xml<br>video/mpeg                      mpeg mpg mpe<br>video/x-msvideo                 avi<br>text/html                       html htm<br></pre>
40 <p></p>
41 <p>If the file can be found or has the wrong format, Sylpheed-Claws will
42 assume
43 the default MIME type for all the attachments: <i>application/octet-stream</i>.
44 In such a case, the recipients mail client may not know what
45 application to use to view the attachment.</p>
46 <h2><a name="ss14.2">12.2</a> <a href="sylpheed.html#toc14.2">How
47 Sylpheed-Claws handles attachments (reception)</a>
48 </h2>
49 <p>When opening an attachment (select the attachment, right click and
50 select
51 <i>Open</i>) Sylpheed-Claws uses one of the following methods to determine
52 the application to launch:</p>
53 <p>
54 </p>
55 <ul>
56   <li>The attachment is an image: the application is the one defined by
57 the
58     <i>mime_image_viewer</i> variable of the common preferences
59 configuration
60 file (<i>$HOME/.sylpheed/sylpheedrc</i>). If no application is defined,
61 or
62 if the format of the definition is not valid, the default application
63 command is <i>display</i> (ImageMagick viewer).</li>
64   <li>The attachment is a sound file: the application is the one
65 defined by the
66     <i>mime_audio_player</i> variable of the common preferences
67 configuration
68 file (<i>$HOME/.sylpheed/sylpheedrc</i>). If no application is defined,
69 or
70 if the format of the definition is not valid, the default application
71 command is <i>play</i>.</li>
72   <li>The attachment is a HTML file: the application is the one defined
73 by the
74     <i>uri_cmd</i> variable of the common preferences configuration
75 file (<i>$HOME/.sylpheed/sylpheedrc</i>). This can also be changed in
76 the
77     <i>Common preferences</i>, by changing the <i>Web browser</i>
78 defined
79 in the <i>Other</i> tab.</li>
80   <li>Any other attachment type: Sylpheed-Claws relies on <i>metamail</i> to
81 use
82 the correct application (Sylpheed-Claws starts <i>metamail</i> giving it
83 the attachment file and the MIME type taken from the mail).</li>
84 </ul>
85 <p></p>
86 <p>The binding of the applications to each MIME type is defined in the
87 <i>mailcap</i> file. The systeme wide file is <i>/etc/mailcap</i>,
88 while the user file is <i>$HOME/.mailcap</i>.</p>
89 <p>In the mailcap file, there is one definition per line, big lines
90 can be broken by escaping the newline with a <i>\</i> character,
91 the first element of the line is the MIME type, then a semi-colon,
92 (<i>;</i>), and finally the application to launch.
93 The application part (right side of the semi-colon) can contain several
94 shell commands separated by an escaped semi-colon (<i>\;</i>) and
95 the <i>%s</i> string is replaced by the name of the file when
96 launching the command.</p>
97 <p>Following is a typical <i>mailcap</i> file (an extract of mine):</p>
98 <p>
99 </p>
100 <pre>
101 image/*; ee %s
102
103 video/mpeg; gtv %s
104 video/*; xanim %s
105
106 application/pdf; xpdf %s
107
108 text/html; dillo %s
109 </pre>
110 <p></p>
111 <hr>
112 <a href="sylpheed-15.html">Next</a>
113 <a href="sylpheed-13.html">Previous</a>
114 <a href="sylpheed.html#toc14">Contents</a>
115 </body>
116 </html>