home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / rconv112.zip / richconv / liesmich < prev    next >
Text File  |  1998-10-17  |  13KB  |  212 lines

  1. ----------------------------------------------------------------------------
  2. Was ist RichConv?
  3. ----------------------------------------------------------------------------
  4.  
  5. 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.
  6.  
  7. 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.
  8.  
  9. Es gibt folgende Probleme mit text/enriched-Emails in PMMail:
  10.  
  11. (1) Empfangene text/enriched-Emails werden nur als Anhang einer ansonsten leeren Email angezeigt.
  12.  
  13. (2) Man muß den Anhang öffnen, um die eigentliche Email lesen zu können. 
  14.  
  15. (3) Sobald man die Email dann geöffnet hat, sieht man den unveränderten, und eventuell etwas schwer lesbaren text/enriched-Text vor sich, mit allerlei seltsamen Formartierungskommandos, wie z.B. <italic> oder <bold>.
  16.  
  17. 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... ;-)
  18.  
  19. RichConv wandelt text/enriched-Emails in multipart/alternative-Emails um, mit einer text/plain-Version der ursprünglichen Email als erstem Teil.
  20.  
  21. RichConv ist ursprünglich als Hilfsprogramm für 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.
  22.  
  23. RichConv kann auch als Kommandozeilenprogramm laufen. Die Eingabedatei darf allerdings maximal eine MIME-Email enthalten. Und diese Email muß RFC 822 genügen.
  24.  
  25. ----------------------------------------------------------------------------
  26. Wichtig!
  27. ----------------------------------------------------------------------------
  28.  
  29. RichConv ist kostenlose und freie benutz- und kopierbare Software. 
  30.  
  31. Man sollte also von diesem Programm nicht all zu viel erwarten, abgesehen davon daß es wahrscheinlich Festplattenplatz benötigt. Wenn man den Preis in Betracht zieht, ist das eigentlich sogar schon etwas zu viel des Guten... ;-)
  32.  
  33. Andererseits freue ich mich natürlich über jede konstruktive Kritik. Einfach eine Email an mich schicken, falls bei irgendwelchen Emails Probleme auftreten. Wenn möglich, bitte ein Beispiel anhängen.
  34.  
  35. ----------------------------------------------------------------------------
  36. Die aktuelle Version von RichConv
  37. ----------------------------------------------------------------------------
  38.  
  39. Die aktuelle Version ist auf Hobbes (http://hobbes.nmsu.edu/ oder ftp://hobbes.nmsu.edu/) zu finden.
  40.  
  41. Ich habe keine spezielle Vorliebe für 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.
  42.  
  43. ----------------------------------------------------------------------------
  44. Dateien in diesem Paket
  45. ----------------------------------------------------------------------------
  46.  
  47. Im Verzeichnis richconv:
  48.  
  49. filter.bmp   - Beispiel für Filtereinstellungen in PMMail
  50. liesmich     - Diee Datei
  51. mime.bmp     - Beispiel für MIME-Einstellungen für text/html
  52. readme       - English version of this file
  53. richconv.c   - Quellcode von RichConv
  54. richconv.exe - Ausführbare Datei von RichConv
  55. todo         - Liste offener Punkte
  56.  
  57. Im Verzeichnis richconv\pgp:
  58.  
  59. filter.sig   - Meine PGP-Unterschrift für filter.bmp
  60. liesmich.sig - Meine PGP-Unterschrift für liesmich
  61. mime.sig     - Meine PGP-Unterschrift für mime.bmp
  62. readme.sig   - Meine PGP-Unterschrift für readme
  63. richconv.sig - Meine PGP-Unterschrift für richconv.c
  64. todo.sig     - Meine PGP-Unterschrift für todo
  65.  
  66. Im Verzeichnis richconv\nt:
  67.  
  68. richconv.exe - Ausführbare Datei für Windows NT (siehe nachfolgende Anmerkung!)
  69.  
  70. Die ausführbare Datei für Windows NT ist nicht auf dem aktuellen Versionsstand. Ich selbst habe leider weder Windows NT noch einen Compiler für Windows NT verfügbar.
  71.  
  72. Wenn es Probleme mit dem Compilieren für Windows NT gibt, bitte bei mir melden (siehe "richconv /h"). Ich werde versuchen, falls notwendig, den Quellcode zu ändern um das Problem zu beheben.
  73.  
  74. ----------------------------------------------------------------------------
  75. Wie RichConv funktioniert
  76. ----------------------------------------------------------------------------
  77.  
  78. Mit einem geeigneten PMMail-Filter (siehe unten) konvertiert RichConv alle eingehenden text/enriched-Emails in multipart/alternative-Emails, die aus drei Teilen bestehen:
  79.  
  80. (1) Ein text/plain-Teil:
  81. Gleicher Textinhalt wie die ursprüngliche Email, aber ausschließlich unformatierter, simpler Text. Die meisten Formatierungsanweisungen werden einfach aus dem Text entfernt. Einige werden auf Wunsch interpretiert. Zum Beispiel kann ursprünglich kursive Schrift in Großbuchstaben umgesetzt werden. Dieser Teil wird nach dem Öffnen der konvertierten Email im PMMail-Fenster direkt angezeigt.
  82.  
  83. (2) Ein text/html-Teil:
  84. Dies ist eine HTML-Version des ursprünglichen 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 für HTML noch für 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.
  85.  
  86. (3) Ein text/enriched-Teil:
  87. Dies ist der komplette ursprüngliche Text. Er ist in keiner Weise verändert, abgesehen davon, daß er jetzt in eine mehrteilige Email eingebettet ist. Dieser Teil ist der letzte Anhang der multipart/alternative-Email.
  88.  
  89. Anmerkung: RichConv erwartet, daß sich die Formatierung einer text/enriched-Email an RFC 1896 hält. Angeblich verwenden manche Softwarehersteller eigene Erweiterungen von RFC 1896. Das konnte ich bisher allerdings nicht verifizieren.
  90.  
  91. ----------------------------------------------------------------------------
  92. Wie RichConv einsetzen?
  93. ----------------------------------------------------------------------------
  94.  
  95. Mit "richconv /h" aufgerufen, gibt RichConv einige Benutzungshinweise auf den Bildschirm aus.
  96.  
  97. Um RichConv zu benutzen, muß natürlich die Datei richconv.exe in einem beliebigen Verzeichnis verfügbar sein. Dieses Verzeichnis muß nicht in der Umgebungsvariablen PATH aufgeführt sein, und es muß auch nicht eines der PMMail-Verzeichnisse sein.
  98.  
  99. 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:
  100.  
  101. (1) Den Dialog "Account->Account Settings...->Filters" öffnen.
  102.  
  103. In PMMail 1.96 und älteren Versionen heißt dieser Dialog "Account->Utilities Settings...->Filters". In PMMail 2.0 und neueren Versionen gibt es die Abkürzung "Account->Filters..."
  104.  
  105. (2) Auf "New" klicken.
  106.  
  107. (3) Folgende Werte in die entsprechenden Felder eingeben (siehe filter.bmp für die Bildschirmkopie eines Beispiels):
  108.  
  109.   Description Irgendein Name
  110.   Enabled     [sollte markiert sein]
  111.   Simple
  112.     Search    <Header> 
  113.     For       Content-Type: text/enriched
  114.   Type        Incoming
  115.   Actions     REXX Exit (Background) x:\pfad\zu\richconv.exe
  116.  
  117. Hinter richconv.exe müssen keine Argumente und auch kein %s angegeben werden. 
  118.  
  119. Man kann allerdings Schalter angeben, die RichConv versteht. Im folgenden Beispiel wird "-html" verwendet: "x:\vollständiger\pfad\zu\richconv.exe -nohtml". PMMail reicht alle Argumente an RichConv weiter.
  120.  
  121. Für weitere Informationen über die möglichen Schalter siehe "richconv /h".
  122.  
  123. Am Anfang ist es hilfreich, nach "REXX Exit" noch "Inform User" einzuschalten. So bekommt man mit, wann RichConv jeweils aufgerufen wird.
  124.  
  125. (4) Auf "OK" klicken.
  126.  
  127. (5) Sicherstellen, daß kein anderer Filter eingehende text/enriched-Emails aus der Inbox verschiebt, bevor RichConv überhaupt aufgerufen wurde. 
  128.  
  129. Mit den "Up"/"Down"-Knöpfen kann man die Aufrufreihenfolge von Filtern ändern.
  130.  
  131. (6) Sicherstellen, daß es keine weiteren Konflikte mit anderen Filtern gibt. Das ist nicht ganz einfach, deshalb... viel Glück! ;-)
  132.  
  133. Und das war's schon.
  134.  
  135. ----------------------------------------------------------------------------
  136. Wie den text/plain-Teil anschauen?
  137. ----------------------------------------------------------------------------
  138.  
  139. Der text/plain-Teil sollte automatisch am Bildschirm erscheinen, sobald man die konvertierte Email aufmacht.
  140.  
  141. ----------------------------------------------------------------------------
  142. Wie den text/htmlTeil anschauen?
  143. ----------------------------------------------------------------------------
  144.  
  145. Es gibt zwei Wege, wie man den text/html-Teil sichtbar machen kann:
  146.  
  147. (1) Man zieht ihn auf das Symbol oder Fenster eines WWW-Browsers. 
  148.  
  149. (2) Mit den richtigen MIME-Einstellungen von PMMail genügt es, doppelt auf das Symbol des text/html-Teils klicken. Für die Einstellungen ist der Dialog "PMMail->Settings...->MIME" Associations zuständig. Dort folgendes eingeben (vergleiche mime.bmp):
  150.  
  151.   Description           HTML
  152.   MIME Type             text / html
  153.   File Extension        html htm
  154.   Program To Execute:   x:\pfad\zum\www\browser.exe
  155.   Arguments:            [weitere Argumente, falls notwendig] %s
  156.   Working Directory     [bleibt leer]
  157.   Program Type          [hängt vom Browser ab, z.B. "OS/2 PM" für Netscape]
  158.  
  159. ----------------------------------------------------------------------------
  160. Wie den text/enriched-Teil anschauen?
  161. ----------------------------------------------------------------------------
  162.  
  163. Die unveränderte text/enriched-Email kann man durch einen Doppelklick auf das Symbol des letzten Anhangs öffnen. Was bei diesem Doppelklick passiert, hängt allerdings wiederum von den MIME-Einstellungen in PMMail ab. Mit den Standardeinstellungen öffnet sich der Systemeditor mit dem Emailtext.
  164.  
  165. ----------------------------------------------------------------------------
  166. Wie RichConv testen?
  167. ----------------------------------------------------------------------------
  168.  
  169. RichConv liest eine Datei, ändert sie, und überschreibt den ursprünglichen Inhalt der Datei mit dem geänderten Inhalt. Man kann also RichConv mit jeder Datei testen, die eine Email in gültiger MIME-Syntax enthält.
  170.  
  171. Warnung: RichConv überschreibt die Eingabedatei. Man sollte also vor irgendwelchen Versuchen eine Sicherheitskopie dieser Datei machen.
  172.  
  173. 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ß standardmäßig der Emailkopf nicht angezeigt wird, wird dieser Teil der Email standardmäßig 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" drücken.
  174.  
  175. ----------------------------------------------------------------------------
  176. Wer geholfen hat
  177. ----------------------------------------------------------------------------
  178.  
  179. Allen H Cogbill <ahc@lanl.gov> wollte eine Obergrenze für die Größe der Eingabedatei und eine Möglichkeit, die Umwandlung von kursivem oder fettem Text in Großbuchstaben komplett zu verhindern.
  180.  
  181. Per Jessen <per@ibm.net> hat RichConv für Windows NT compiliert.
  182.  
  183. Paul Hodges <paul@qbss.co.uk> hat ihn dazu gebracht, das zu tun, und hat mir das Ergebnis geschickt.
  184.  
  185. Roger Lindmark <roger-li@algonet.se> war Betatester.
  186.  
  187. Robb Selby <robbselby@earthlink.net> wollte mehr Farbe im Text und unterschiedliche Schriftgrößen und half mir beim Fehlersuchen.
  188.  
  189. ----------------------------------------------------------------------------
  190. Der Autor
  191. ----------------------------------------------------------------------------
  192.  
  193. Nach Eingabe von "richconv /h" wird meine Emailadresse angezeigt.
  194.  
  195. Meinen öffentlichen PGP-Schlüssel bekommt, wer mir eine (leere) Email schickt, in deren Betreff "Schicke PGP-Schluessel" steht.
  196.  
  197. ----------------------------------------------------------------------------
  198. Verschiedenes
  199. ----------------------------------------------------------------------------
  200.  
  201. Es gibt ein ähnliches Program namens HtmlConv, das text/html konvertiert. HtmlConv sollte auf dem gleichen Server wie RichConv verfügbar sein. Allerdings wird HtmlConv nur für PMMail/2 1.x benötigt, da neuere Versionen von PMMail diese Funktion bereits eingebaut haben.
  202.  
  203.  
  204.  
  205.  
  206.  
  207. Rolf Lochbühler
  208. Vermont, USA
  209. --
  210. $Id: liesmich,v 1.8 1998-10-17 10:12:00-04 rl Exp $
  211.  
  212.