Anleitung zum invers RTF-Importtreiber
======================================


1   Copyright
-------------
Alle Programmrechte:
    1997 Michael Kammerlander, Herford

Vertrieb und Anleitung:
    1997 inversmedia Verlag GbR, Lningen. Alle Rechte vorbehalten.


Konzept/Entwicklung:
   Michael Kammerlander
Handbuchtext:
   Ulf Dunkel, Michael Kammerlander, Volker Ronneberger

Das vorliegende Handbuch darf, auch auszugsweise, ohne die schriftliche 
Genehmigung vom inversmedia Verlag weder reproduziert, bertragen, 
umgeschrieben, auf Datentrger gespeichert noch in eine andere Sprache 
bzw. Computersprache bersetzt werden, weder in mechanischer, 
elektronischer, magnetischer, optischer, chemischer noch manueller Form.

Fr Anfragen wenden Sie sich bitte schriftlich an:

   inversmedia Verlag
   Jrgen Funcke, Frank Mller, Ulf Dunkel
   Gesellschaft brgerlichen Rechts
   Alter Postweg 6
   D-49624 Lningen

Der inversmedia Verlag bernimmt die Gewhr dafr, da das Produkt und 
das dazugehrige Handbuch nicht mit Fehlern behaftet sind, die ihren Wert 
oder ihre Tauglichkeit zu dem vorausgesetzten Gebrauch aufheben oder 
mindern.

Im brigen gelten die Allgemeinen Geschftsbedingungen vom inversmedia 
Verlag.

Die Rechte aller in diesem Handbuch genannten und eingetragenen 
Firmennamen und Firmenzeichen sowie Warennamen und Warenzeichen liegen 
bei den jeweiligen Firmen. Calamus ist ein eingetragenes Warenzeichen fr 
mgi Corp., Ontario.



2   Nutzungsvereinbarung zum invers RTF-Importtreiber
-----------------------------------------------------
Der Lizenznehmer ist berechtigt, den Treiber auf einer einzelnen Anlage 
einzusetzen. Dabei mu die gelieferte Diskette in direktem rtlichen 
Bezug zu der Anlage gelagert sein und darf nicht zeitgleich auf einer 
zweiten Anlage eingesetzt werden. Jede Art der Vervielfltigung oder 
Verbreitung durch den Lizenznehmer ist untersagt.

Der Lizenznehmer ist nicht berechtigt, das Modul in irgendeiner Form 
selbst oder durch Dritte zu verndern. Dritten gegenber darf das 
Programm nur insoweit zugnglich gemacht werden, als dies zur Nutzung 
unbedingt erforderlich ist.

Die Bedienungsanleitung darf nur mit Genehmigung des Autors reproduziert 
werden (etwa durch Fotokopie, Mikrofilm, Datentrger oder ein anderes 
Verfahren).

Bei der Herstellung des Treibers und dessen Dokumentation wurde mit groer 
Sorgfalt vorgegangen, um die Richtigkeit und Funktionsfhigkeit zu 
gewhrleisten. Da jedoch stndig Verbesserungen und Nacharbeiten an der 
Software vorgenommen werden, knnen Autor, Hersteller oder Vertrieb 
keinerlei Haftung oder Gewhrleistung bernehmen.

Die Lizenz zur Nutzung des Treibers erlischt, wenn der Lizenznehmer gegen 
die vorliegenden Lizenzbestimmungen verstt.

Falls eine der Bestimmung dieses Lizenzvertrages unwirksam ist oder wird, 
so berhrt dies die Wirksamkeit der anderen Bestimmungen nicht. Die 
unwirksame Bestimmung ist durch eine inhaltlich am nchsten kommende, 
wirksame Bestimmung zu ersetzen.

Gerichtsstand ist Cloppenburg.



3   Installation
----------------
Bitte kopieren Sie die Dateien RTF_I.CIR und RTF_I.INF in Ihren Calamus-
Treiberordner (der blicherweise eben TREIBER heit).

Wenn Sie den invers RTF-Importtreiber nutzen wollen, starten Sie bitte 
Calamus und legen Sie ein neues Dokument an. Anschlieend erzeugen Sie 
bitte einen Textrahmen, den Sie dann selektiert lassen.

Um RTF-Texte in diesen Textrahmen importieren zu knnen, whlen Sie bitte 
im Datei-Men den Eintrag "Import". Im nun erscheinenden Dialog klicken 
Sie den Button "Laden" und whlen anschlieend den RTF-Import (RTF_I.CIR) 
aus. Der Treiber wird geladen und steht Ihnen nun zur Verfgung.

Wenn Sie fter mit dem RTF-Importtreiber arbeiten wollen, empfiehlt es 
sich, diesen Treiber direkt beim Start von Calamus mitladen zu lassen. 
Damit das geschieht, sichern Sie bitte das Calamus-Setup nach dem Laden 
des RTF-Importtreibers erneut, wobei mindestens der Setupeintrag "Treiber" 
gewhlt sein mu.



4   Anwendung
-------------


4.1 Was ist RTF?
----------------
RTF steht fr "Rich Text Format" und meint ein von Microsoft entwickeltes,
systembergreifendes Textformat, das eine grtmgliche Schnittmenge von 
Textformatanweisungen enthlt. Mit diesem Format ist es generell mglich, 
mit verschiedensten Textverarbeitungen Dokumente so untereinander 
auszutauschen, da die programmtypische Formatierung des Textes im nchsten 
Programm identisch wieder dargestellt wird.

Grau, theurer Freund, ist alle Theorie ...

Natrlich ist Ihnen wie uns klar, da es vom Konzept zur Realitt ein weiter 
Weg ist. Wir haben whrend der Entwicklungsphase des invers RTF-Importtreibers 
die (wahn)witzigsten RTF-Formate entdeckt. Jedes Programm implementiert 
dieses genau definierte Format leider etwas anders. Einige "fressen so gut 
wie alles" und "spucken es auch genauso wieder aus" - andere Programme 
verstehen nicht mal ihren eigenen "Mist". Erhoffen Sie sich daher bitte 
keine Wunder vom RTF-Importtreiber. Er nimmt Ihnen beim bertragen fremder, 
vorformatierter Textdokumente in den Calamus hinein sicher einen Groteil 
der Arbeit ab, aber er kann mit "halbgarem Zeugs" leider ebensowenig 
anfangen wie andere Programme, die ein vernnftiges RTF erwarten.

Der invers-RTF-Importtreiber interpretiert zu ladende RTF-Texte und setzt 
sie weitgehend in Calamus-Texte um, wobei mglichst alle in RTF abbildbaren 
Textattribute, Stile und Formatierungen erhalten bleiben und nicht in 
Calamus ein zweites Mal mhsam nachformatiert werden mssen.


4.2 Los geht's ...
------------------
Der invers RTF-Import hat, im Vergleich zu vielen Ihnen bekannten Import-
Treibern, ein erweitertes Bedienkonzept. Der Treiber trgt sich mit einem 
Icon in die Moduleiste ein, hnlich wie viele Module. ber dieses Icon 
kann man (ebenfalls von den Modulen bekannt) das Befehlsfeld des RTF-
Importtreibers aufrufen. Hier knnen alle Einstellungen fr den Import 
vorgenomen werden und der Imprt selbst auch gestartet werden.

Legen Sie ggf. ein neues Calamus-Dokument an und erzeugen Sie einen neuen 
Textrahmen. Selektieren Sie den Textrahmen und rufen Sie den RTF-Import 
auf, indem Sie im Dateimen den Meneintrag "Import" whlen und dort den 
invers RTF-Import selektieren. In der Dateiauswahlbox whlen Sie die RTF-
Datei und besttigen die Wahl mit "OK" oder der Return-Taste.

Alternativ kann der Import auch ber das entsprechende Icon im 
Modulbefehlsfeld gestartet werden.

Bevor der Import das erste Mal startet, sehen Sie ein Formular namens 
"Import-Einstellung". Hier sind ggf. verschiedene Parameter von Ihnen zu 
setzen, damit der Import der RTF-Daten reibungslos funktioniert:

- Infoblock ignorieren

(Der Infoblock einer RTF-Datei wird als Kommentare im Text gelassen, 
falls Sie diesen Schalter nicht setzen.)

- Seitenende ignorieren
- Spaltenende ignorieren

Setzen Sie einen dieser Schalter, so wird die entsprechende Information 
aus dem RTF-Dokument ignoriert, was durchaus das Aussehen der importierten 
Daten verndern kann. Ansonsten wird an den entsprechenden Stellen ein 
fester Spaltenwechsel eingefgt. Wir empfehlen, ggf. zuerst einen 
Testdurchlauf mit einer kleineren RTF-Datei zu machen, um zu sehen, wie 
sie sich beim Import verhlt.

Hinweis: Die meisten Programme (z.B. auch WinWord und Papyrus) schreiben 
nicht automatisch ihren Spalten- bzw. Seitenumbruch in die Datei, sondern 
der Text fliet (wie Sie es auch von mehreren Textrahmen bei Calamus 
kennen) ber die vorgegebenen Spalten und Seiten. Beim RTF-Export werden 
nur die "erzwungenen" Umbrche bercksichtigt und nur diese kann der 
RTF-Importtreiber daher auch umsetzen oder ignorieren.

- Schatten

Sie knnen dem RTF-Dokument beim Import global eine Einstellung fr 
Schattierungen zuweisen.

- Unterstrich

Auch das Aussehen unterstrichener Textpassagen knnen Sie beim Import 
global einstellen.

- Dialog anzeigen

Falls Sie der Meinung sind, die von Ihnen gesetzten Parameter sind fr 
alle Flle in Ordnung, schalten Sie diesen Eintrag ab. Dann werden Sie 
den Dialog beim nchsten RTF-Importversuch nicht mehr sehen.


4.3 Der Importdialog ist futsch
-------------------------------
Natrlich knnen Sie den Importdialog auf diesem Wege nie mehr sehen,
wenn Sie den Schalter "Dialog anzeigen" ausgeschaltet haben. Damit Sie 
ihn jedoch wieder ffnen knnen, besitzt der RTF-Import-Treiber ein 
Befehlsfeld, genau wie ein Modul! - Sie knnen das RTF-Befehlsfeld 
aktivieren, indem Sie in der Modulleiste das RTF-Treiber-Symbol anklicken. 
Dann sehen Sie das Befehlsfeld und knnen den Importparameter-Dialog 
aufrufen, indem Sie auf das entsprechende Icon klicken.

Optional halten Sie nach der Auswahl der zu importierenden RTF-Datei die 
Control-Taste gedrckt, dann wird der Importdialog auf jeden Fall gezeigt.


4.4 Der Import luft ...
------------------------
Whrend der Treiber die Daten importiert und interpretiert, sehen Sie 
einen Zeitbalken, der Sie ber den Fortgang des Imports informiert. 
Den Ladevorgang knnen Sie jederzeit ber die Tastenkombination 
Ctrl-Alt-Shift abbrechen.

Ist das RTF-Dokument vollstndig geladen, wird es prompt im Textrahmen 
dargestellt. Natrlich kann es durchaus sein, da der Textrahmen noch 
nicht die optimalen Ausmae hat, um die Daten richtig darstellen zu knnen.
Auch ist es mglich, da Sie noch weitere Textrahmen anlegen und mit 
diesem Textrahmen verketten mssen (Piping), damit der Text in die nchsten 
Textrahmen weiterfliet. - Alle diese Textrahmen-Operationen sind Ihnen 
aus dem Calamus-Handbuch und Ihrer tglichen Arbeit vertraut.


4.5 Einstellung sichern
-----------------------
Im Befehlsfeld finden Sie ein Icon, mit dem Sie die aktuellen Einstellungen 
des RTF-Importtreibers sichern knnen.



5   RTF-Formatuntersttzung
---------------------------
- Die RTF-Formatanweisungen werden grtenteils im Calamus-Text durch 
  entsprechende Lineale und Textstile dargestellt, so da der RTF-Import
  die grtmgliche Nherung an die Originalformatierung des RTF-Formats
  ergibt:

- Tabellen (mit Tabulatoren):
  Calamus hat noch keine Tabellenverwaltung. Der invers RTF-Import mu 
  daher bei der Interpretation der Tabellen die in Calamus zur Verfgung 
  stehenden Mittel benutzen. Er behilft sich damit, da der Text aus der 
  Tabelle entsprechend der Zellen (*) der Originaltabelle durch 
  Tabulatoren getrennt ausgegeben wird. Dabei werden auch leere Zellen 
  bercksichtigt.

  (*) Eine Zelle ist der Bereich einer Tabelle, der durch eine Spalte 
  und Zeile definiert wird. Eine solche Zelle kann (z.B. in WinWord und 
  Papyrus) auch mehrzeiligen Text enthalten. Diese Formatierungen gehen 
  beim Import (wegen fehlender Tabellenfunktionen in Calamus) verloren. 
  Der gesamte Text einer Zelle wird in Calamus in einer Zeile ausgegeben 
  und durch den Text der vorigen und nachfolgenden Zelle durch 
  Tabulatoren getrennt.

- Aufzhlungen 

- Verschiedene ASCII-Zeichenstze (DOS, Windows, Atari, Mac etc.)

- Zeilenabstnde und Einzge

- Halbe Anfhrungszeichen oben und unten

- Textstile (Fontgre, Unterstreichen, Schatten usw.)

- Die Fontaustauschtabelle wird in einer INF-Datei gespeichert.

- Falsche Dateien (kein RTF-Format) werden direkt abgewiesen.



6   Die Fontaustausch-Tabelle
-----------------------------
In einer RTF-Datei wird der vom Erzeugerprogramm verwendete Fontname sowie 
ein Fonttyp (soweit vorhanden) fr jeden Font gespeichert. Die Programme 
gehen dabei aber unterschiedlich sauber vor. WinWord z.B. speichert immer 
den vollstndigen Fontnamen, TempusWord nur ein Krzel (aus Times wird 
Tms) und bei Papyrus wird aus Times -> TIMES.

Anhand dieser Informationen mu der invers RTF-Import dem Text die 
entsprechenden Fonts zuordnen. Hinzu kommt, da die Schriften, die von 
den meisten RTF-erzeugenden Programmen auf Mac und PC verwendet werden, 
blicherweise keine CFN-Fonts sind, sondern Type-1-Schriften oder 
TrueType-Fonts. Diese mssen beim Import in Calamus durch CFN-Zuweisungen 
ersetzt werden.

Und genau diese Aufgaben des invers RTF-Import werden durch die 
Fontaustauschtabelle gesteuert.

Die Fontaustauschtabelle wird durch das entsprechende Icon im Befehlsfeld 
aufgerufen. In der Dialogbox ist eine Liste der bereits vorhandenen 
Eintrge zusehen. Dabei werden in jeder Zeile die Namen (durch Semikolon 
getrennt) dargestellt, die einem Satz von Calamusfonts zugeordnet sind.

ber das Bearbeiten-Men knnen alle Eintrge selektiert oder deselektiert 
werden, selektierte Eintrge gelscht oder ein neuer Eintrag angelegt 
werden.

Mit dem Button "fester Fontpfad" wird festgelegt, da beim Laden von 
CFN-Fonts nur ber den festen Font-Suchpfad zugegriffen wird (das geht 
natrlich nur ab Calamus SL96 - Sommerrelease 97).

Ein Doppelklick auf einen Eintrag ffnet den Fontverwaltungs-Dialog, so 
da die Daten verndert werden knnen.

Der gleiche Dialog erscheint (allerdings leer), wenn man unter Bearbeiten 
"Neuer Eintrag" whlt.

Im Fontverwaltungsdialog werden die Einstellungen fr einen Satz von 
CFN-Fonts vorgenommen. Ein CFN-Satz besteht aus den vier Schnitten 
"normal", "Italic", "Bold" und "Bold-italic". In der Box "Calamus-Font" 
werden durch Anklicken der entsprechenden Eintrge in der Dialogbox die 
zugehrigen Fonts in der Dateiauswahl ausgesucht. Bei leeren italic-
Eintrgen werden die Fonts, sofern sie bentigt werden, ber den Stil 
"Schrgstellen" von Calamus simuliert.

In die Zeilen der Box "RTF-Fontname" auf der linken Dialogseite werden die 
RTF-Fonts eingetragen, fr die der CFN-Satz gelten soll. Dabei werden auch 
RTF-Fonts erkannt, die nur die angebenen Schlsselwrter enthalten. Die 
Namen sollten also so allgemein wie mglich sein. Der Eintrag "times" 
reicht, damit der RTF-Font "Times New Roman" mit den CFN-Fonts ersetzt 
wird. Gro- und Kleinschreibung hat keine Bedeutung.

In jeder Dialogzeile darf nur ein RTF-Font stehen!

ber die Schalter in der Box "Font-Typ" werden dem CFN-Satz sogenannte 
Stilelemente zugeordnet. Diese Stilelemente werden vom invers-RTF-Import 
in dem Fall benutzt, da anhand der Schlsselwrter einem RTF-Font kein 
CFN-Satz zugeordnet werden kann. Der Import versucht dann einen mglichst 
hnlichen Satz an CFN-Fonts zu finden.

Der erste Schalter, "Default", weist den invers RTF-Import an, immer 
diesen CFN-Satz zu benutzen, wenn auch anhand der Stilelemente eine 
Zuordnung nicht mglich ist. Es wird immer der erste CFN-Satz in der Liste 
benutzt, bei dem dieser Schalter gesetzt ist. Ist der Schalter bei keinem 
Eintrag gesetzt, wird als Notlsung der erste Font aus der Calamus-
Fontliste genommen.

Die Fontaustauschtabelle wird zusammen mit den anderen Einstellungen des 
Treibers gespeichert. Will man nderungen in der Liste dauerhaft erhalten, 
ist es also notwendig die Einstellungen einmal zu speichern.


6.1 Wie luft das nun beim Import?
----------------------------------
Der RTF-Importtreiber scannt die RTF-Datei nach dort enthaltenen Font-
Anweisungen und sucht anschlieend in der Fontaustauschtabelle ber den 
Namen nach einem passenden Font. Dabei wird die Gro- und Kleinschreibung 
nicht beachtet.

Wird kein passender Font gefunden, wird versucht anhand der eingestellten 
Stilelemente einen hnlichen zu benutzen. Wird auch hier kein passender 
gefunden, wird der erste Eintrag aus der Tabelle genommen, fr den der 
Schalter "Default" aktiviert ist. Ist bei keinem Eintrag dieser Schalter 
aktiv, wird der erste Zeichensatz aus der Fontliste von Calamus genommen.



7   Bekannte Probleme
---------------------
RTF ist ein Format, das Microsoft als systembergreifendes Format ins 
Leben gerufen hat (siehe oben). Doch whrend Microsoft sich selbst noch 
leidlich an die Vorgaben dieses Formats hlt, sieht es bei anderen 
Programmen manchmal ziemlich bel aus. Leider sind auch die RTF schreibenden 
Programme der Atari-Welt nicht alle empfehlenswert. Hier eine Auflistung 
bekannter oder unvermeidbarer Probleme zum Zeitpunkt der Auslieferung:


7.1 Sonderzeichen
-----------------
Sonderzeichen knnen nicht erkannt werden, wenn die RTF schreibenden 
Programme diese "schlicht" einfgen und sich nicht an die RTF-Nomenklatur 
halten.

Sonderzeichen erscheinen nach dem Import nur richtig, wenn der ausgewhlte 
Calamus-Zeichensatz sich an die Standard-Vorgaben hlt. Einige PD-
Zeichenstze tragen z.B. die Anfhrungen und Bindestriche an falscher 
Position; diese werden dann nach dem Import nicht richtig dargestellt. 
Natrlich lt sich dieses "kleine" Problem durch Suchen&Ersetzen im Eddie 
rasch beheben. Es sei hier nur darauf hingewiesen, da dieses Problem 
nicht durch den invers RTF-Import verursacht wird.

Sonderzeichen, die in WinWord ber die gleichlautende Funktion eingefgt 
werden und z.B. aus dem Zeichensatz Symbol stammen, werden von WinWord 
nicht richtig in die RTF-Datei geschrieben. So geschriebene Sonderzeichen 
fehlen nach dem Import!


7.2 Tabellen
------------
WinWord 6.0 und Papyrus schreiben Tabellen nicht immer sauber. Die
fehlerhaften Tabellen von WinWord 6.0 knnen zum grten Teil dennoch 
richtig interpretiert werden. Papyrus scheint das RTF-Format nicht ganz 
korrekt zu untersttzen.


7.3 Aufzhlungen
----------------
Papyrus erzeugt bei Aufzhlungen nur Mll, selbst Word kann nichts damit 
anfangen.

                        
7.4 TempusWORD 2.85
-------------------
Der RTF-Export dieser TWORD-Version ist so unverdaulich, da TWORD 2.85 
ihn selbst nicht versteht ...



8   Eine Bitte zum Schlu
-------------------------
Es ist eine Sache, einen Importtreiber zu entwickeln, der irgendwas 
importieren kann, was genau festgelegt ist. Es ist eine vllig andere 
Sache, wenn es ein Textformat wie RTF gibt, das von verschiedensten 
Programmen unterschiedlich gehandhabt wird. Daher kann auch der invers 
RTF-Importtreiber nie perfekt sein. Wir haben uns natrlich allergrte 
Mhe gegeben, ihn fr die Mehrzahl der vorkommenden Flle praxistauglich 
zu machen.

Falls Ihnen ein RTF-Dokument unterkommt, das der RTF-Import partout nicht 
verstehen will oder das Ihnen nach dem Import "spanisch" vorkommt, zgern 
Sie bitte nicht, uns dieses Dokument zu schicken. Ohne Beispieldokumente 
lassen sich Fehlinterpretationen oder Bugs in einem solchen Treiber nicht 
finden.

Vertrauliche Behandlung Ihrer Daten ist natrlich garantiert.


Viel Erfolg mit dem neuen invers RTF-Importtreiber
wnscht Ihnen der inversmedia Verlag.

[+++ 15.09.97 fd]
