• Français
  • English

xhtmail

Screenshots
Index view
Month view
Thread view

Mailing list archives conversion to web pages

Introduction

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

Requirements

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.

Download

Version 0.5 [New faces]
xhtmail-0.5.tar.lzma [348K]
xhtmail-0.5.zip [496K]

Subversion

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.

Usage

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

Documentation is available in multiple formats.

API

You can consult the xhtmail's API.

Bugs

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

Author

Patrice Levesque

License

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.


xhtmail

Creation : August 14th, 2005
Villeray
N 45° 33′ W 73° 36′

xhtmail

Last update : July 28th, 2009,
Villeray,
N 45° 33′ W 73° 36′