xhtmail

This PHP commandline utility transforms multiple mail files into a web archive. Some highlights:

• Generates strict XHTML. The right semantics are used whenever possible;
• All the messages in a thread are shown on the same page.;
• Icons for message properties (mail user agent, sender country, operating system, X-Faces, gravatars...);
• Stable URIs with embedded subject line. No purely numerical indexes without meaning..

Written under a GNU/Linux environment, this script should work on any platform supporting PHP; should you use it successfully on anything else than GNU/Linux, please let know the developer so that this info becomes public.

• PHP 4/5;
• PHP::iconv; Optional if only used with english mail messages
• PHP::Mailparse; ≥ 2.1.5
• PHP::Mail_Mime;
• PHP::mbstring.

Version 0.5 [New faces]

xhtmail-0.5.tar.lzma [348K]

xhtmail-0.5.zip [496K]

The development version is available through subversion. The follow command allows you to download it:

svn co https://svn.ptaff.ca/xhtmail/trunk/

Note that the ptaff.ca certificate is self-signed; it's possible that you get a warning — you may safely ignore it.

xhtmail -a samples/after.simple.html \
-b samples/before.simple.html \
-c samples/after.simple.html \
-i samples/after.simple.html \
-n my_list \
-t "My mail archives" \
-o /var/www/html/my_list \
mail1 mail2 mail3

Creates in /var/www/html/my_list a web archive from the mail1, mail2 and mail3 messages in XHTML. Pages will title the list as "my_list", with "My mail archives" as description. Headers and footers are copied from "samples/before.simple.html" and "samples/after.simple.html".

xhtmail is used here on ptaff.ca; you can peek at the french-speaking ptafflist archives.

Documentation is available in multiple formats.

• xhtmail Projet documentation (XHTML) [En]
• xhtmail Projet documentation (Plain text) [En]
• xhtmail Projet documentation (PDF) [En]

You can consult the xhtmail's API.

Should you find a bug, you must report it to xhtmail.wayne@ptaff.ca

Patrice Levesque

Copyright © 2005 Patrice Levesque.

xhtmail is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.