----------------------------------------------------------------------------
Was ist RichConv?
----------------------------------------------------------------------------

Einige Emailprogramme (speziell Eudora) verschicken Emails im Format text/enriched, einem in RFC 1896 spezifizierten MIME-Typ (Multipurpose Internet Mail Extensions). Dieser Typ erlaubt das Verschicken von Emails zusammen mit einfachen Formatinformationen, wie z.B. die Verwendung einer kursiven oder fetten Schriftart.

Das Format text/enriched ist brigens weder mit dem Rich Text Format (RTF) verwandt noch mit irgendeinem anderen Format, das die Bezeichnung "rich" oder "enriched" im Namen hat.

Es gibt folgende Probleme mit text/enriched-Emails in PMMail:

(1) Empfangene text/enriched-Emails werden nur als Anhang einer ansonsten leeren Email angezeigt.

(2) Man mu den Anhang ffnen, um die eigentliche Email lesen zu knnen. 

(3) Sobald man die Email dann geffnet hat, sieht man den unvernderten, und eventuell etwas schwer lesbaren text/enriched-Text vor sich, mit allerlei seltsamen Formartierungskommandos, wie z.B. <italic> oder <bold>.

Nebenbei merkt man auch normalerweise sofort, da der Inhalt der Email in keiner Weise den Gebrauch von text/enriched rechtfertigt, aber das ist schon wieder ein anderes Problem... ;-)

RichConv wandelt text/enriched-Emails in multipart/alternative-Emails um, mit einer text/plain-Version der ursprnglichen Email als erstem Teil.

RichConv ist ursprnglich als Hilfsprogramm fr die Filterfunktion von PMMail/2 gedacht. Es kann aber genau so gut mit jeder anderen Software verwendet werden, die ein externes Programm zur Bearbeitung eingehender Emails aufrufen kann.

RichConv kann auch als Kommandozeilenprogramm laufen. Die Eingabedatei darf allerdings maximal eine MIME-Email enthalten. Und diese Email mu RFC 822 gengen.

----------------------------------------------------------------------------
Wichtig!
----------------------------------------------------------------------------

RichConv ist kostenlose und freie benutz- und kopierbare Software. 

Man sollte also von diesem Programm nicht all zu viel erwarten, abgesehen davon da es wahrscheinlich Festplattenplatz bentigt. Wenn man den Preis in Betracht zieht, ist das eigentlich sogar schon etwas zu viel des Guten... ;-)

Andererseits freue ich mich natrlich ber jede konstruktive Kritik. Einfach eine Email an mich schicken, falls bei irgendwelchen Emails Probleme auftreten. Wenn mglich, bitte ein Beispiel anhngen.

----------------------------------------------------------------------------
Die aktuelle Version von RichConv
----------------------------------------------------------------------------

Die aktuelle Version ist auf Hobbes (http://hobbes.nmsu.edu/ oder ftp://hobbes.nmsu.edu/) zu finden.

Ich habe keine spezielle Vorliebe fr Hobbes, abgesehen davon, da ich zur Zeit in den USA lebe und Hobbes einer der bekannteren Softwareserver ist, der in diesem Teil der Welt steht.

----------------------------------------------------------------------------
Dateien in diesem Paket
----------------------------------------------------------------------------

Im Verzeichnis richconv:

filter.bmp   - Beispiel fr Filtereinstellungen in PMMail
liesmich     - Diee Datei
mime.bmp     - Beispiel fr MIME-Einstellungen fr text/html
readme       - English version of this file
richconv.c   - Quellcode von RichConv
richconv.exe - Ausfhrbare Datei von RichConv
todo         - Liste offener Punkte

Im Verzeichnis richconv\pgp:

filter.sig   - Meine PGP-Unterschrift fr filter.bmp
liesmich.sig - Meine PGP-Unterschrift fr liesmich
mime.sig     - Meine PGP-Unterschrift fr mime.bmp
readme.sig   - Meine PGP-Unterschrift fr readme
richconv.sig - Meine PGP-Unterschrift fr richconv.c
todo.sig     - Meine PGP-Unterschrift fr todo

Im Verzeichnis richconv\nt:

richconv.exe - Ausfhrbare Datei fr Windows NT (siehe nachfolgende Anmerkung!)

Die ausfhrbare Datei fr Windows NT ist nicht auf dem aktuellen Versionsstand. Ich selbst habe leider weder Windows NT noch einen Compiler fr Windows NT verfgbar.

Wenn es Probleme mit dem Compilieren fr Windows NT gibt, bitte bei mir melden (siehe "richconv /h"). Ich werde versuchen, falls notwendig, den Quellcode zu ndern um das Problem zu beheben.

----------------------------------------------------------------------------
Wie RichConv funktioniert
----------------------------------------------------------------------------

Mit einem geeigneten PMMail-Filter (siehe unten) konvertiert RichConv alle eingehenden text/enriched-Emails in multipart/alternative-Emails, die aus drei Teilen bestehen:

(1) Ein text/plain-Teil:
Gleicher Textinhalt wie die ursprngliche Email, aber ausschlielich unformatierter, simpler Text. Die meisten Formatierungsanweisungen werden einfach aus dem Text entfernt. Einige werden auf Wunsch interpretiert. Zum Beispiel kann ursprnglich kursive Schrift in Grobuchstaben umgesetzt werden. Dieser Teil wird nach dem ffnen der konvertierten Email im PMMail-Fenster direkt angezeigt.

(2) Ein text/html-Teil:
Dies ist eine HTML-Version des ursprnglichen Textes, die einen Eindruck der Originalformatierung geben soll. Die Umsetzung von text/enriched nach HTML ist nicht perfekt und kann es per Prinzip auch nicht sein. Es gibt weder fr HTML noch fr text/enriched irgendeinen Standard, der exakt festlegt, wie eine bestimmte Formatierungsanweisung genau zu interpretieren ist. Der text/html-Teil ist der erste Anhang der multipart/alternative-Email.

(3) Ein text/enriched-Teil:
Dies ist der komplette ursprngliche Text. Er ist in keiner Weise verndert, abgesehen davon, da er jetzt in eine mehrteilige Email eingebettet ist. Dieser Teil ist der letzte Anhang der multipart/alternative-Email.

Anmerkung: RichConv erwartet, da sich die Formatierung einer text/enriched-Email an RFC 1896 hlt. Angeblich verwenden manche Softwarehersteller eigene Erweiterungen von RFC 1896. Das konnte ich bisher allerdings nicht verifizieren.

----------------------------------------------------------------------------
Wie RichConv einsetzen?
----------------------------------------------------------------------------

Mit "richconv /h" aufgerufen, gibt RichConv einige Benutzungshinweise auf den Bildschirm aus.

Um RichConv zu benutzen, mu natrlich die Datei richconv.exe in einem beliebigen Verzeichnis verfgbar sein. Dieses Verzeichnis mu nicht in der Umgebungsvariablen PATH aufgefhrt sein, und es mu auch nicht eines der PMMail-Verzeichnisse sein.

Um RichConv zum Konvertieren von eingehenden text/enriched-Emails zu verwenden, mu in PMMail ein Filter definiert werden, der RichConv aufruft. Den Filter definiert man so:

(1) Den Dialog "Account->Account Settings...->Filters" ffnen.

In PMMail 1.96 und lteren Versionen heit dieser Dialog "Account->Utilities Settings...->Filters". In PMMail 2.0 und neueren Versionen gibt es die Abkrzung "Account->Filters..."

(2) Auf "New" klicken.

(3) Folgende Werte in die entsprechenden Felder eingeben (siehe filter.bmp fr die Bildschirmkopie eines Beispiels):

  Description Irgendein Name
  Enabled     [sollte markiert sein]
  Simple
    Search    <Header> 
    For       Content-Type: text/enriched
  Type        Incoming
  Actions     REXX Exit (Background) x:\pfad\zu\richconv.exe

Hinter richconv.exe mssen keine Argumente und auch kein %s angegeben werden. 

Man kann allerdings Schalter angeben, die RichConv versteht. Im folgenden Beispiel wird "-html" verwendet: "x:\vollstndiger\pfad\zu\richconv.exe -nohtml". PMMail reicht alle Argumente an RichConv weiter.

Fr weitere Informationen ber die mglichen Schalter siehe "richconv /h".

Am Anfang ist es hilfreich, nach "REXX Exit" noch "Inform User" einzuschalten. So bekommt man mit, wann RichConv jeweils aufgerufen wird.

(4) Auf "OK" klicken.

(5) Sicherstellen, da kein anderer Filter eingehende text/enriched-Emails aus der Inbox verschiebt, bevor RichConv berhaupt aufgerufen wurde. 

Mit den "Up"/"Down"-Knpfen kann man die Aufrufreihenfolge von Filtern ndern.

(6) Sicherstellen, da es keine weiteren Konflikte mit anderen Filtern gibt. Das ist nicht ganz einfach, deshalb... viel Glck! ;-)

Und das war's schon.

----------------------------------------------------------------------------
Wie den text/plain-Teil anschauen?
----------------------------------------------------------------------------

Der text/plain-Teil sollte automatisch am Bildschirm erscheinen, sobald man die konvertierte Email aufmacht.

----------------------------------------------------------------------------
Wie den text/htmlTeil anschauen?
----------------------------------------------------------------------------

Es gibt zwei Wege, wie man den text/html-Teil sichtbar machen kann:

(1) Man zieht ihn auf das Symbol oder Fenster eines WWW-Browsers. 

(2) Mit den richtigen MIME-Einstellungen von PMMail gengt es, doppelt auf das Symbol des text/html-Teils klicken. Fr die Einstellungen ist der Dialog "PMMail->Settings...->MIME" Associations zustndig. Dort folgendes eingeben (vergleiche mime.bmp):

  Description           HTML
  MIME Type             text / html
  File Extension        html htm
  Program To Execute:   x:\pfad\zum\www\browser.exe
  Arguments:            [weitere Argumente, falls notwendig] %s
  Working Directory     [bleibt leer]
  Program Type          [hngt vom Browser ab, z.B. "OS/2 PM" fr Netscape]

----------------------------------------------------------------------------
Wie den text/enriched-Teil anschauen?
----------------------------------------------------------------------------

Die unvernderte text/enriched-Email kann man durch einen Doppelklick auf das Symbol des letzten Anhangs ffnen. Was bei diesem Doppelklick passiert, hngt allerdings wiederum von den MIME-Einstellungen in PMMail ab. Mit den Standardeinstellungen ffnet sich der Systemeditor mit dem Emailtext.

----------------------------------------------------------------------------
Wie RichConv testen?
----------------------------------------------------------------------------

RichConv liest eine Datei, ndert sie, und berschreibt den ursprnglichen Inhalt der Datei mit dem genderten Inhalt. Man kann also RichConv mit jeder Datei testen, die eine Email in gltiger MIME-Syntax enthlt.

Warnung: RichConv berschreibt die Eingabedatei. Man sollte also vor irgendwelchen Versuchen eine Sicherheitskopie dieser Datei machen.

Die Eingabedatei darf auf jeden Fall nur eine einzige Email enthalten. Wenn man die Datei durch Abspeichern einer Email erzeugen will, mu man darauf achten, da der Emailkopf mit abgespeichert wird. Wenn PMMail so konfiguriert ist, da standardmig der Emailkopf nicht angezeigt wird, wird dieser Teil der Email standardmig auch nicht mit in eine Datei abgespeichert. Um den Emailkopf mit abzuspeichern, mu man in diesem Fall vor dem Abspeichern auf "Toggle Display Of The Message Header" drcken.

----------------------------------------------------------------------------
Wer geholfen hat
----------------------------------------------------------------------------

Allen H Cogbill <ahc@lanl.gov> wollte eine Obergrenze fr die Gre der Eingabedatei und eine Mglichkeit, die Umwandlung von kursivem oder fettem Text in Grobuchstaben komplett zu verhindern.

Per Jessen <per@ibm.net> hat RichConv fr Windows NT compiliert.

Paul Hodges <paul@qbss.co.uk> hat ihn dazu gebracht, das zu tun, und hat mir das Ergebnis geschickt.

Roger Lindmark <roger-li@algonet.se> war Betatester.

Robb Selby <robbselby@earthlink.net> wollte mehr Farbe im Text und unterschiedliche Schriftgren und half mir beim Fehlersuchen.

----------------------------------------------------------------------------
Der Autor
----------------------------------------------------------------------------

Nach Eingabe von "richconv /h" wird meine Emailadresse angezeigt.

Meinen ffentlichen PGP-Schlssel bekommt, wer mir eine (leere) Email schickt, in deren Betreff "Schicke PGP-Schluessel" steht.

----------------------------------------------------------------------------
Verschiedenes
----------------------------------------------------------------------------

Es gibt ein hnliches Program namens HtmlConv, das text/html konvertiert. HtmlConv sollte auf dem gleichen Server wie RichConv verfgbar sein. Allerdings wird HtmlConv nur fr PMMail/2 1.x bentigt, da neuere Versionen von PMMail diese Funktion bereits eingebaut haben.





Rolf Lochbhler
Vermont, USA
--
$Id: liesmich,v 1.8 1998-10-17 10:12:00-04 rl Exp $

