home *** CD-ROM | disk | FTP | other *** search
/ M.u.C.S. Disc 2000 / MUCS2000.iso / online / amail / rsc_de / amail_de.txt < prev   
Text File  |  1999-02-23  |  16KB  |  361 lines
  1.                               Handbuch zu aMail
  2.                                               .__.__   
  3.                         _____    _____ _____  |__|  |  
  4.                         \__  \  /     \\__  \ |  |  |  
  5.                          / __ \|  Y Y  \/ __ \|  |  |__
  6.                         (____  /__|_|  (____  /__|____/
  7.                              \/      \/     \/         
  8.    
  9.                             v1.05beta vom 23.02.1999
  10.  
  11.                             
  12. aMail ist ein GEM Mail-Client zum Empfangen, Schreiben und Senden von 
  13. email via Internet. Die hauptsächlichen Features sind:
  14.  
  15. o vollständig mausgesteuertes GEM-Programm mit geringeren 
  16.   Speicheranforderungen als andere textuelle mail clients, die von 
  17.   UNIX portiert wurden
  18. o arbeitet mit MiNTnet - es werden keine anderen TCP/IP Sockets 
  19.   benötigt oder mit STiK/STinG
  20. o voll zu UNIX kompatible Mailboxen - man kann sich seine Mail von 
  21.   anderen Systemen von der Arbeit oder Uni holen
  22. o unterstützt UUENCODE und BASE64
  23. o unterstützt den MIME Standard (man kann MIME Attachments direkt per 
  24.   drag&drop an den Desktop schicken, dank des AV-Protokolls; auf diese 
  25.   Art verschobene Attachments erhalten eine Dateiendung entsprechend 
  26.   der Datei mime.types
  27. o ASCII Konfigurationsdatei, d.h. die Konfiguration kann auch in einem 
  28.   Texteditor bearbeitet werden
  29. o man kann bis zu 25 Mailboxen (Ablagen) definieren, wobei die Mail nach 
  30.   vorgebbaren Regeln automatisch einsortiert wird
  31. o aMail hat keinen eigenen Texteditor, d.h. man seinen gewohnten 
  32.   Lieblingstexteditor verwenden, der aber das OLGA Protokoll unterstützen 
  33.   mu₧ (qed, Everest)
  34. o unterstützt AV-Protokoll, FONT-Protokoll, XFSL und UFSL
  35. o versteht VA_START
  36. p parst URL innerhalb von Nachrichten
  37. o unterstützt Tschechisch
  38. o und weitere Features, die man selbst herauszufinden hat ;)
  39.  
  40. Was benötigt man, um aMail laufen zu lassen?
  41. --------------------------------------------
  42. o MiNT
  43. o AES ab Version 4.0
  44. o OLGA
  45. o einen Texteditor der das OLGA-Protocol unterstützt (qed, Everest)
  46. o 300 KB freies RAM
  47. o MiNTnet oder STiK/STinG (zum Senden und Empfangen von Mail)
  48.  
  49. Wir empfehlen:
  50. --------------
  51. o MiNT 1.15.x (ftp://piwo.bl.pg.gda.pl/pub/atari/mint/Kernel/)
  52. o N.AES 1.2 (http://www.inx.de/w+l/)
  53. o QED 4.x (http://www.tu-harburg.de/~smcf1605/qed/main.html)
  54.  
  55. Einige grundlegende Tips und Hinweise:
  56. --------------------------------------
  57.  
  58. 1. Falls das Programm auf einer minixfs-Partition abgelegt wird und 
  59.    nicht laufen sollte, überprüfe man die Dateiattribute (rwx--x--x)
  60. 2. Falls man eine Mailbox von einem UNIX-System benutzen will, sauge man 
  61.    es sich (z.B. mit dem aFTP client) herüber und benenne sie in 
  62.    $HOME/amail/inbox um
  63. 3. Falls man eine Mailbox von Newsie weiterverwenden möchte, benutze man 
  64.    das beigefügte Shellscript zur Konvertierung
  65. 4. Ihr Texteditor MUSS das OLGA Protokoll unterstützen, da aMail die 
  66.    Mail nach Erhalt der "Save File"-Meldung vom OLGA-Manager sendet
  67.    Das TempDir mu₧ in folgendem Format angegeben werden:
  68.    drive:\dir\ und NICHT /dir/ !
  69.    
  70. Als ein kleiner Bonus gibt es als Beilage ein Shellscript namens 
  71. n2amail.sh zum Konvertieren von Newsie-Mailboxen in das UNIX-Format. Nur 
  72. das Script von der Shell aus starten und es wird dann nach den 
  73. erforderlichen Pfaden fragen.
  74.  
  75. Start mit Parametern oder über VA_START
  76. ---------------------------------------
  77. Man kann aMail über eine Kommandozeile mit Parametern starten oder über 
  78. VA_START. Der Parameter mu₧ in jedem Fall im URL-Format zum Versenden 
  79. von Mail vorliegen (z.B. "mailto: atack@szt.cdrail.cz"). Man kann ein 
  80. subject anhängen, das durch ein Fragezeichen eingeleitet wird (z.B. 
  81. "mailto: atack@szt.cdrail.cz?subject=Testmail").
  82.  
  83. URL parsing
  84. -----------
  85. Wenn man in den Nachrichtentext klickt, wird das angeklickte Wort 
  86. analysiert und falls es sich um eine Zeichenkette im URL-Format (z.B. 
  87. http://www.pwp.cz/atack) handelt, wird es via VA_START an die 
  88. entsprechende Anwendung verschickt (in diesem Fall z.B. CAB) unter 
  89. Zuhilfenahme von URLSRV.
  90. URLSRV ist Freeware. Es ist diesem Paket beigefügt. Eine neuere Version 
  91. findet sich stets auf der WWW-Seite von Atack.
  92. Bemerkung: URLs sind noch nicht farblich hervorgehoben!
  93.  
  94. Benutzerdefinierte Mailboxen (Ablagen)
  95. --------------------------------------
  96. aMail kann bis zu 30 Ablagen verwalten. 5 Ablagen (inbox, sent-mail, 
  97. outbox, 2 tempboxes) werden bereits intern genutzt, somit verbleiben 
  98. weitere 25, die man festlegen kann. Wenn man die Konfiguration von aMail 
  99. sichert, erzeugt aMail ein dreizeiliges Beispiel in der 
  100. Konfigurationsdatei.
  101.  
  102. -- start ------------- part of amail.cfg file -----------
  103. CustomBoxName = Atari CZ
  104. CustomBoxPath = g:\home\root\amail\atari
  105. DefaultTo = Atari@alpha.inf.upol.cz
  106. RuleSet = To: Atari@alpha.inf.upol.cz
  107. RuleSet = Reply-To: Atari@alpha.inf.upol.cz
  108. CustomBoxName = Work-outbox
  109. CustomBoxPath = g:\home\root\amail\work_out
  110. CustomBoxType = 1
  111. DefaultFrom = somebody@work.com
  112. -- end --------------- part of amail.cfg file -----------
  113.  
  114. Hier eine nähere Erläuterung der Schlüsselworte:
  115. CustomBoxName - Name der Ablage. Sie wird im Popup-Menü angezeigt
  116.               - compulsory keyword
  117. CustomBoxPath - Pfad und Dateiname der Ablage
  118.               - compulsory keyword
  119. CustomBoxType - see English DOCs
  120. DefaultTo     - falls diese Ablage geöffnet ist und eine neue Nachricht
  121.                 erezugt wurde, wird die nachfolgende Zeichenkette automatisch
  122.                 als Adresse des Empfängers verwendet
  123.                 (z.B. To: address)
  124. DefaultFrom   - falls diese Ablage geöffnet ist und eine neue Nachricht
  125.                 erezugt wurde, wird die nachfolgende Zeichenkette automatisch
  126.                 als Adresse des Senders verwendet
  127.                 (z.B. From: address)
  128. RuleSet       - nach dem "="-Zeichen kann man eine Regel zum Einsortieren der
  129.                 Nachricht angeben. Die Regel wird im Nachrichtenkopf
  130.                 gesucht und entsprechend der Regel wird die Nachricht in die
  131.                 definierte Ablage einsortiert
  132.  
  133. Hinweise zur Funktion von RuleSet:
  134.     "To: honza" - die Nachricht gelangt in diese Ablage wenn irgendwo im 
  135.        Nachrichtenkopf eine Zeile mit "To:" beginnt und irgendwo sonst die
  136.        Zeichenkette "honza" gefunden wird (z.B. "To: Friend honza")
  137.     "atari.com" - alle Nachrichten, die die Zeichenkette "atari.com" im
  138.        Nachrichtenkopf beinhalten, gelangen in diese Ablage
  139.     Es ist weiterhin möglich eine sogenannte schwarze Liste zu erzeugen
  140.     (Nachrichten von sonstwo her werden automatisch gelöscht), wie in
  141.     folgendem Beispiel:
  142.     
  143. CustomBoxName = Black Hole
  144. CustomBoxPath = /dev/null
  145. RuleSet = From: scott
  146.  
  147. Objekt Menü
  148. -----------
  149.  
  150. Dieses Menü kann aufgerufen werden, indem man die rechte Maustaste über dem
  151. Nachrichtenkopf (im oberen Teil des Fensters) drückt. Dann bezieht sich alles
  152. auf die Nachricht unter dem Mauszeiger (die Nachricht wird hervorgehoben). Nun
  153. kann man die Nachricht löschen, verschieben oder in eine andere Ablage kopieren
  154. (Kopieren = mit gedrückter Shift-Taste verschieben), eine neue Nachricht erzeugen,
  155. auf eine Nachricht antworten, alle Kennzeichnungen (z.B. gelöscht, gelesen usw.)
  156. entfernen oder die Nachricht bearbeiten (dabei wird eine neue Nachricht erzeugt,
  157. die man bearbeiten kann, und die alte wird als gelöscht gekennzeichnet).
  158.  
  159.  
  160. STOP Knopf
  161. ----------
  162.  
  163. Mit diesem Knopf kann man asock.ovl, welches die Nachrichten holt/sendet,
  164. stoppen. Deshalb sollte amn diesen Knopf nur dann benutzen wenn es wirklich
  165. notwendig ist. Üblicherweise wenn lange Zeit nichts passiert (Verbindung
  166. unterbrochen) oder wenn man z.B. merkt, da₧ man gerade eine Nachricht an die
  167. falsche Person schickt.
  168.  
  169. AV-Protokoll
  170. ------------
  171.  
  172. aMail unterstützt und benutzt einige GEM Protokolle zur Erhöhung des Komforts.
  173. Ausgenommen von untergeordneten Dingen wie FONT Protokoll, UFSL, xFSL,
  174. Selectric, ... ist die Hauptsache das AV Protokoll. Hauptzweck ist der Aufruf
  175. von externen Dateibetrachtern für MIME Nachrichtenanhänge. In diesem Fall
  176. wird das Icon in der oberen rechten Ecke des Fensters anwählbar und man
  177. kann folgende Dinge tun:
  178.  
  179.    1) Klick auf das Icon (Einfachklick)
  180.       - eine Dateiauswahlbox erscheint und man kann einen Pfad zum Sichern
  181.         des Anhangs auswählen
  182.    2) Doppelklick auf das Icon
  183.       - der Anhang wird in das TMP Verzeichnis exportiert und zum AV server
  184.         gesendet. Beispiel: falls man amail.lzh als angehängte Datei empfängt
  185.         und man die LZH-Shell zum Öffnen von *.lzh-Dateien angemeldet hat, wird
  186.         die LZH-Shell mit amail.lzh als Argument gestartet.
  187.    3) das Icon mit gedrückter, linker Maustaste über ein beliebiges Laufwerks-
  188.       Icon, Verzeichnis, was auch immer ... Ihres Desktops ziehen und die
  189.       angehängte Datei wird direkt dort gespeichert, wo die Maustaste
  190.       losgelassen wurde.
  191.  
  192.    Falls die Datei in einem der beiden möglichen Verfahren kodiert ist (was
  193.    wirklich immer der Fall ist), wird sie beim Schreiben automatisch dekodiert.
  194.    Text ist normalerweise "quoted-printable" ('=3A' etc.), Binärdateien
  195.    normalerweise base64 (Zeichensalat). 
  196.  
  197.  
  198. Tastaturbedienung
  199. -----------------
  200.  
  201. Nun können wir die Tasten, die in aMail benutzt werden können, beschreiben.
  202. Mit Ausnahme der Hotkeys, welche ja ganz einfach in den Menüs abzulesen sind,
  203. gibt es noch:
  204.  
  205. Cursor up/down     - scrollt die Nachricht zur nächsten/vorherigen Zeile
  206. Shift + up/down    - scrollt die Nachricht zur nächsten/vorherigen Seite
  207. Clr/Home           - springt zum Anfang der Nachricht
  208. Shift + Clr/Home   - springt zum Ende der Nachricht
  209. Cursor left/right  - springt zur nächsten/vorherigen Nachricht
  210. Space              - springt zur nächsten Seite/Nachricht
  211. Shift + left/right - springt zur nächsten/vorherigen Seite der Nachricht
  212.  
  213. Adressbuch
  214. ----------
  215.  
  216. Die grundlegende Funktion und die Pflege des Adressbuches ist hoffentlich
  217. jedermann klar, doch wofür steht die Gruppenauswahl? Allgemein gesprochen
  218. macht es die Arbeit mit cc: oder bcc: Kopien leichter. Wenn Sie
  219. Nachrichten immer der gleichen Gruppe von Empfängern schicken wollen,
  220. müssen Sie nicht jedem einzelnen schreiben. Sie können alle email-Adressen
  221. in eine Textdatei schreiben und diese Datei als Gruppe im Adressbuch
  222. auswählen. Es darf nur EINE Adresse pro Zeile eingetragen werden.
  223. Die erste Zeile wird als Primäradresse genommen, d.h. sie erscheint
  224. im to: Feld des Nachrichtenkopfes.
  225.  
  226. Sound
  227. -----
  228.  
  229. Falls der audio device Treiber (audiodev.xdd) installiert ist, kann
  230. aMail ein Sample als Hinweis auf ein aufgetretenes Ereignis abspielen.
  231.  
  232. Alle Samples müssen raw sound data, mono, 8 bit signed, 12500 Hz sein.
  233. Wenn Sie keine Samples wollen, müssen Sie nur
  234. a) das audio device de-installieren
  235. b) alle Samples löschen oder umbenennen  (sound/new.raw, sound/error.raw)
  236.    oder das sound/ Verzeichnis.
  237.  
  238. Reply-to
  239. --------
  240.  
  241. aMail kann mit folgenden verschiedenen Varianten von Nachrichtenköpfen
  242. umgehen. Wir beschreiben sie hier:
  243.  
  244.    o Der Kopf enthält lediglich from:
  245.      - ohne weitere Nachfrage wird auf die Adresse im from: Feld
  246.        geantwortet
  247.  
  248.    o Der Kopf enthält nur from: und to:, welches aber nicht mit Ihrer
  249.      email-Adresse korrespondiert
  250.      - der [from: | to: | Alle] Dialog erscheint, wobei die [Alle]
  251.        Auswahl auf die Adressen im from: und to: Feld antwortet.
  252.  
  253.    o Der Kopf enthält nur from: und reply-to:
  254.      - der [from: | reply-to | Alle] Dialog erscheint, wobei die [Alle]
  255.        Auswahl auf die Adressen im from: und reply-to: Feld antwortet.
  256.  
  257.    o Der Kopf enthält nur from: und cc:
  258.      - der [from: | reply-to | Alle] Dialog erscheint, wobei die [Alle]
  259.        Auswahl auf die Adressen im from: und cc: Feld antwortet.
  260.  
  261.    o Der Kopf enthält nur from: reply-to: und cc:
  262.      - der [from: | reply-to | Alle] Dialog erscheint, wobei die [Alle]
  263.        Auswahl auf die Adressen im from:, reply-to: und cc: Feld antwortet.
  264.  
  265.    Wenn in den letzten drei Fällen die Adresse im to: Feld nicht mit
  266.    Ihrer email-Adresse korrespondiert (wie im zweiten Fall), dann wird
  267.    diese Adresse ebenfalls angehängt, wenn Sie [Alle] wählen.
  268.  
  269.    In jedem anderen Fall erscheint der normale Dialog zum Ausfüllen des
  270.    Nachrichtenkopfes (to:, subject:, cc:, Anhang) und Sie können
  271.    ändern was Sie möchten.
  272.     
  273. Zitatzeichenkette
  274. -----------------
  275.  
  276. Sie können sich eine eigene Zeichenkette, max. 10 Zeichen (warum länger,
  277. dann wird sie länger als die Häfte einer Zeile), weiterhin spezielle
  278. Formatierungszeichen definieren. Zur Zeit unterscheidet aMail nur %i
  279. als die Initialen eines Namens, z.B. wenn Sie auf eine Nachricht
  280. "from: Jan Evangelista Purkyne" antworten und Ihre Zitatzeichenkette
  281. "%i > " ist, werden alle Zeilen mit einem "JEP > " beginnen.
  282.  
  283.  
  284. MIME Nachrichtenanhänge
  285. -----------------------
  286.  
  287. Der Typ eines Nachrichtenanhangs wird automatisch während des Versendens
  288. gesetzt, gemä₧ seiner Dateiendung und der Datei mime.types, welche in
  289. folgenden Verzeichnissen gesucht wird (in dieser Reihenfolge):
  290. 1) /usr/local/share/mime.types
  291. 2) ~/.mime.types
  292. 3) ./mime.types
  293.  
  294. Das Dateiformat ist reiner Text - Standard und einfach:
  295. --- mime.types ----
  296. application/postscript  ps eps ai
  297. image/gif               gif
  298. image/jpeg              jpg jpeg jpe
  299. text/html               htm html
  300. text/plain              txt c h cc
  301. --- mime.types ----
  302.  
  303. Falls es sich bei dem Typ um text/* handelt, wird quoted-printable Code
  304. benutzt, wie es für Textdateien erforderlich ist, die ASCII-Zeichen 
  305. grö₧er 127 oder Zeilen länger als 72 Zeichen entahlten, oder base64 Code,
  306. wenn es sich nicht um eine Textdatei handelt.
  307.  
  308. Einschränkungen
  309. ---------------
  310.  
  311. Die Anzahl von Nachrichten in einer Ablage ist begrenzt, aber sie wird
  312. in der Konfigurationsdatei (eine reine Textdatei) vorgegeben, wo Sie
  313. einfach geändert werden kann.
  314. Es gibt zwei Zahlen, eine für den Bedarf an Speicher, der für 
  315. Nachrichtenköpfe zu reservieren ist (standardmä₧ig 200 kB, was
  316. ausreichend genug ist), und die andere für die maximale Anzahl an
  317. Nachrichten in der Ablage (standardmä₧ig 1000, maximal 32768).
  318. Beide Zahlen korrespondieren und es wäre möglich, die eine aufgrund
  319. der anderen zu berechnen, doch auf diese Weise ist das Programm
  320. mehr konfigurierbar und Leute mit kurzen Namen mögen sie auf andere
  321. Werte setzen, was wir aber nicht wissen können.
  322. Falls irgendeiner dieser Beschränkungen währen des Öffnens der Ablage
  323. überschritten wird, wird diese Aktion unterbrochen und die Ablage wird
  324. im Weiteren als "nur lesen" gesperrt, weil die Nachrichten, die nicht
  325. mehr hineingepa₧t hätten, nach dem Schlie₧en der Ablage verloren wären.
  326. Deshalb würden die Kennzeichnungen (gelesen, neu) nicht gesichert, 
  327. Nachrichten, die zum Löschen gekennzeichnet wurden (selbst zum 
  328. Verschieben in eine andere mailbox), würden nicht gelöscht und die
  329. Ablage könnte nicht komprimiert werden.
  330. Eine andere Beschränkung, die hoffentlich bald Geschichte werden
  331. wird, ist die falsche Behandlung von Nachrichten mit mehr als einer
  332. Adresse im to: Feld.
  333. Die nächste Beschränkung: das Weiterleiten von Nachrichten arbeitet
  334. ohne Weiterleiten von MIME-Dateianhängen.
  335. Die letzte bekannte Beschränkung ist die Behandlung von eingeschlossenen
  336. MIME-Dateianhängen (ein MIME-Anhang innerhalb eines anderen). Niemand
  337. hatte uns davon berichtet und daher war niemand auf so etwas vorbereitet
  338. und unglücklicherweise kommen solche Nachrichten immer häufiger und
  339. häufiger vor.
  340.  
  341. Danksagung
  342. ----------
  343.  
  344. Wir möchten gerne allen Betatestern danken, die ihre kostbare Zeit damit
  345. verbrachten, zu programmieren und mit ihren Vorschlägen und Ratschlägen
  346. halfen. Wir möchten auch Christian Felsch für sein qed danken - ein
  347. gro₧artiger Texteditor. Sämtliche aMail-Quelltexte sind mit qed
  348. geschrieben worden. Und natürlich U2, Pink Floyd und die Stones für
  349. beste Musik zum Programmieren.
  350.  
  351. Falls aMail nicht funktioniert, schreiben Sie einfach auf, was es tut
  352. oder nicht tut, wann genau und wo, und die Versionen Ihrer
  353. Systemkomponenten (Betriebssystemversion, MiNTnet-Version, AES, freier
  354. Speicher bei Start von aMail, Environmentvariablen, ...).
  355.  
  356.                                            Mit freundlichen Grü₧en
  357.  
  358.                                            ATACK (InterNET division :)
  359.    
  360.                                            e-mail: atack@szt.cdrail.cz
  361.                                            http://www.pwp.cz/atack/