1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 | WHAT IS THIS ? This is MIME::Lite::HTML, a module which provide routine to transform a HTML page in a MIME::Lite mail HOW DO I INSTALL IT ? To install this module, cd to the directory that contains this README file and type the following: perl Makefile.PL make make test make install If you can't do that, you can put HTML.pm file in directory $root/MIME/Lite/HTML.pm and then put use lib $root in your program (make same thing if you haven't MIME-Lite module). So it give: $root/MIME/Lite/HTML.pm $root/MIME/Lite.pm and in your script: #!/usr/bin/perl use lib '/home/alian/mylibperl'; use MIME::Lite; use MIME::Lite::HTML; REQUIREMENT ? libnet, MIME::Lite DOCUMENTATION ? You'll find documentation in the file HTML.pm in POD format See too the eg directory When you install MIME::Lite::HTML, the MakeMaker program will automatically install the manual pages for you (on Unix systems, type "man MIME::Lite::HTML"). Here an extract of POD documentation: NAME MIME::Lite::HTML - Provide routine to transform a HTML page in a MIME-Lite mail SYNOPSIS use MIME::Lite::HTML; my $mailHTML = new MIME::Lite::HTML From => 'MIME-Lite@alianwebserver.com', To => 'alian@saturne', Subject => 'Mail in HTML with images'; $MIMEmail = $mailHTML->parse('http://www.alianwebserver.com'); $MIMEmail->send; # or for win user : $mail->send_by_smtp('smtp.fai.com'); DESCRIPTION This module is a Perl mail client interface for sending message that support HTML format and build them for you.. This module provide routine to transform a HTML page in MIME::Lite mail. So you need this module to use MIME-Lite-HTML possibilities What's happen ? The job done is: * Get the file (LWP) if needed * Parse page to find include images * Attach them to mail with adequat header if asked (default) * Include external CSS,Javascript file * Replace relative url with absolute one * Build the final MIME-Lite object with each part found Usage Did you alread see link like "Send this page to a friend" ?. With this module, you can do script that to this in 3 lines. It can be used too in a HTML newsletter. You make a classic HTML page, and give just url to MIME::Lite::HTML. Construction MIME-Lite-HTML use a MIME-Lite object, and RFC2257 construction: If images and text are present, construction use is: --> multipart/alternative ------> text/plain ------> multipart/related -------------> text/html -------------> each images If no images but text is present, this is that: ---> multipart/alternative -------> text/plain if present -------> text/html If images but no text, this is: ---> multipart/related -------> text/html -------> each images If no images and no text, this is: ---> text/html Documentation Additionnal documentation can be found here: * MIME-lite module * RFC 822, RFC 1521, RFC 1522 and specially RFC 2257 (MIME Encapsulation of Aggregate Documents, such as HTML) Clients tested HTML in mail is not full supported so this module can't work with all email clients. If some client recognize HTML, they didn't support images include in HTML. So in fact, they recognize multipart/relative but not multipart/related. Netscape Messager (Linux-Windows) 100% ok Outlook Express (Windows) 100% ok Eudora (Windows) If this module just send HTML and text, (without images), 100% ok. With images, Eudora didn't recognize multipart/related part as describe in RFC 2257 even if he can read his own HTML mail. So if images are present in HTML part, text and HTML part will be displayed both, text part in first. Two additional headers will be displayed in HTML part too in this case. Version 1.0 of this module correct major problem of headers displayed with image include in HTML part. KMail (Linux) If this module just send HTML and text, (without images), 100% ok. In other case, Kmail didn't support image include in HTML. So if you set in KMail "Prefer HTML to text", it display HTML with images broken. Otherwise, it display text part. Pegasus (Windows) If this module just send HTML and text, (without images), 100% ok. Pegasus didn't support images in HTML. When it find a multipart/related message, it ignore it, and display text part. If you find others mail client who support (or not support) MIME-Lite-HTML module, give me some feedback ! If you want be sure that your mail can be read by maximum of people, (so not only OE and Netscape), don't include images in your mail, and use a text buffer too. If multipart/related mail is not recognize, multipart/alternative can be read by the most of mail client. Have fun, and let me know how it turns out! Alain BARBET alian@alianwebserver.com |
Commit History @3e615213-97ca-485e-a2e0-d0ea0eb12a15/main
0
»»
- Update debian/watch to use a secure source (https) Emmanuel Bouthenot 5 years ago
- Update changelog Emmanuel Bouthenot 7 years ago
- Add a patch to fix random FTBFS in test suite with the approximative size factor which can be too small in some cases (#844911) Emmanuel Bouthenot 7 years ago
- Add a fix to clean properly files modified by build process Emmanuel Bouthenot 7 years ago
- Add perl module name in long description Emmanuel Bouthenot 7 years ago
- Fix Vcs-(Git|Browser) fields to use secure URIs Emmanuel Bouthenot 7 years ago
- Bump Standards-Version to 3.9.8 Emmanuel Bouthenot 7 years ago
- Remove obsolete dependency on perl-modules Emmanuel Bouthenot 7 years ago
- Add patch to fix typos in manpage Emmanuel Bouthenot 7 years ago
- Update changelog Emmanuel Bouthenot 10 years ago
- Move the packaging to alioth (add Vcs-* fields accordingly Emmanuel Bouthenot 10 years ago
- Update changelog Emmanuel Bouthenot 10 years ago
- Refresh packaging: Emmanuel Bouthenot 10 years ago
- Refresh debian/copyright Emmanuel Bouthenot 10 years ago
- Add a patch to fix randomization hash issues in the test suite with perl >= 5.18 Emmanuel Bouthenot 10 years ago
- Add unapply-patches to debian/source/local-options Emmanuel Bouthenot 10 years ago
- Switch packaging to '3.0 (quilt)' format Emmanuel Bouthenot 10 years ago
- Merge tag 'upstream/1.24' into unstable Emmanuel Bouthenot 10 years ago
- Imported Upstream version 1.24 Emmanuel Bouthenot 10 years ago
- Imported Upstream version 1.24 Emmanuel Bouthenot 10 years ago
- Add git-buildpackage configuration Emmanuel Bouthenot 10 years ago
- Imported Upstream version 1.24 Emmanuel Bouthenot 10 years ago
- Imported Debian patch 1.23-1.1 gregor herrmann (commit: Emmanuel Bouthenot) 10 years ago
- Imported Upstream version 1.23 Emmanuel Bouthenot 10 years ago
0
»»