home *** CD-ROM | disk | FTP | other *** search
/ Computer Club Elmshorn Atari PD / CCE_PD.iso / pc / 0400 / CCE_0417.ZIP / CCE_0417.PD / ASCREEN.ZOO / liesmich < prev    next >
Text File  |  1992-03-14  |  12KB  |  281 lines
  1.  
  2. LIESMICH für ASCREEN 3.1 --- 14. März 1992
  3. ==========================================
  4.  
  5. Installation
  6. ------------
  7. Die Dateien ASCREEN.PRG, ASCREEN.RSC und ASCREEN.SET an einen geeigneten
  8. Platz auf der Platte kopieren, etwa in die Nähe des bisherigen
  9. Previewers. 
  10. In ASCREEN.SET mit einem Texteditor die Pfadangaben anpassen. Bei den
  11. Schablonen für Zeichensatznamen sind verschiedene Möglichkeiten
  12. vorgegeben, bei denen die jeweils zum verwendeten TeX passende
  13. einkommentiert und alle anderen auskommentiert werden sollten. Dito bei
  14. der Auflösung.
  15. Oder ASCREEN ohne Angabe einer DVI-Datei aufrufen, die Voreinstellungen
  16. in den Dialogen ändern und dann die Optionen unter dem Titel ASCREEN.SET
  17. sichern.
  18.  
  19. Environment
  20. -----------
  21. ASCREEN 3.1 beachtet zwei Environmentvariable:
  22.  
  23. ASCREENSET    Pfad und Name der Voreinstellungsdatei (ASCREEN.SET)
  24. ASCREENRSC    Pfad und Name der Resourcedatei (ASCREEN.RSC)
  25.  
  26. ASCRNENG.RSC enthält englische Resourcen. Um diese zu benutzen, die
  27. Datei entweder umbenennen oder ASCREENRSC auf den Namen dieser Datei
  28. setzen.
  29.  
  30.  
  31. Benutzung
  32. ---------
  33. Aufruf mit
  34.  
  35.     ascreen [ &Setupdatei ] [ Optionen ] Datei
  36.  
  37. oder aus einer TeX-Shell. Es gibt die folgenden Optionen:
  38.  
  39.     -A            Vorausarbeiten umschalten (normal an)
  40.     -c <Farbe>        Farbe für Anzeige setzen (s. u.)
  41.     -D <Verzeichnis>    Verzeichnis für DVI-Dateien
  42.     -d            Desktophintergrund mitbenutzen
  43.     -e <Endung>        Endung für `%e' in PK-Dateinamen festlegen
  44.     -F <Verzeichnis>    Zeichensatzverzeichnis
  45.     -f <2 oder 3>        Verkleinerungsfaktor (normal 2)
  46.     -G <Verzeichnis>    Verzeichnis für IMG-Dateien
  47.     -H <Maß>        Linker Rand (normal 0pt)
  48.     -I            IMG-Dateien nicht zeigen (normal doch)
  49.     -J            wird ignoriert (HKM-TeXshell-Kompatibilität)
  50.     -l            Protokolldatei wird angelegt (normal nein)
  51.     -M <Zahl>        Vergrößerungsstufe (in Promille)
  52.     -m            magisches ENTER (normal ja)
  53.     -p <Zahl>        Maximalanzahl der Seiten im Cache
  54.     -V <Maß>        Oberer Rand (normal 0pt)
  55.     -v            Geschwätzigkeit umschalten (normal aus)
  56.     -w <Geometrie>        Größe und Position des Meldungsfensters
  57.     -x <Maß>        Seitenbreite (normal aus DVI-Datei)
  58.     -y <Maß>        Seitenhöhe (dito)
  59.     -Z <Zahl>        Maximalanzahl von Zeichensätzen (normal 32)
  60.     -z <Zeichenkette>    Schablone zum Erzeugen der Namen von PK-Dateien
  61.  
  62. Ein <Maß> ist dabei eine Fließkommazahl gefolgt von einer der bei TeX
  63. legalen Maßeinheiten mm, cm, in, pt, sp, cc, dd oder bp.
  64. Eine <Geometrie> ist eine Zeichenkette der Form `wxh' oder `wxh+x+y'.
  65. w und h stehen dabei für die Breite und die Höhe des Fensters, x und y für
  66. den Abstand vom linken bzw. oberen Rand des Arbeitsbereichs (ohne Menüzeile).
  67. Statt `+x' und `+y' können `-x' und `-y' verwendet werden, wobei dies
  68. sich dann auf den Abstand des *rechten* bzw. *unteren* Rands des Fensters
  69. vom *rechten* bzw. *unteren* Rand des Arbeitsbereichs bezieht. Zum Beispiel
  70. wäre `100x100-0-0' ein 100 mal 100 Pixel großes Fenster in der rechten unteren
  71. Ecke des Bildschirms. (Dies kommt aus X11.)
  72. Die <Farbe> steuert das Erscheinungsbild der formatierten Seiten auf dem
  73. Bildschirm. Hierbei handelt es sich um eine 16-Bit-Zahl, deren oberes bzw.
  74. unteres Byte die Grundfarbe bzw. Farbe der `Druckerschwärze' angeben,
  75. und zwar als Index in die aktuelle Palette. Alle Zahlen bei Kommandooptionen
  76. können dezimal (123), oktal (0173) oder hexadezimal (0x7b) angegeben werden,
  77. was insbesondere hierbei nützlich ist. Der Standardwert für die Farbe
  78. ist übrigens Farbe 0 für den Hinter- und Farbe 15 für den Vordergrund.
  79.  
  80. Analog zu bei TeX kann man bei ASCREEN als erstes Argument den Namen der
  81. zu lesenden Setupdatei angeben. Dies macht es möglich, einfach
  82. verschiedene Setupdateien parallel zu benutzen. Die Leute, die immer
  83. alles ganz genau wissen möchten, können sich zum Beispiel eine
  84. Setupdatei machen, die statt Bildschirmzeichensätzen geeignete
  85. Druckerzeichensätze spezifiziert und so eine Riesendarstellung erlaubt.
  86. Mit `ascreen &huge.set foo' statt `ascreen foo' wird dann die große
  87. Darstellung gewählt. Hierfür bieten sich auch Aliasdefinitionen in
  88. Shells wie der Mupfel an.
  89.  
  90. Tastaturbelegung
  91. ----------------
  92. Die Äquivalente für Menüpunkte sind im Menü angegeben (und können mit
  93. einem Resource-Construction-Set geändert werden). Ferner gilt:
  94.  
  95.     Cursortasten        Bewegung des Textes im aktuellen Fenster
  96.                 (große Schritte)
  97.     Ziffernblock-1,2,3,5    dito
  98.     Ziffernblock-7,8,9,)    Bewegung um kleine Schritte
  99.     Clr/Home        an linke obere Ecke der Seite gehen
  100.     Ziffernblock -        zur vorigen Seite gehen
  101.     Ziffernblock +        zur nächsten Seite gehen
  102.     Ziffernblock 0        zu einer beliebigen Seite gehen
  103.     Enter            entweder wie `Ziffernblock +' oder magisch
  104.     Ziffernblock .        magisches Zurück
  105.     Help            Onlinehilfe
  106.  
  107. Das `magische Enter' geht so: Normalerweise entspricht die magische
  108. Entertaste der Taste `Pfeil nach unten' bzw. Ziffernblock-2. Steht man
  109. aber am unteren Seitenrand und kann nicht mehr weiter nach unten gehen,
  110. dann geht es auf die nächste Seite an den oberen Rand. Man kann ein
  111. Dokument also nur durch Drücken der Enter-Taste durchblättern. Die
  112. Dezimalpunkttaste auf dem Ziffernblock funktioniert genauso, bloss
  113. rückwärts.
  114.  
  115. Verwandt ist das `schlaue Umblättern': beim Zurückblättern, wenn man am
  116. oberen Seitenrand steht, kommt man an den unteren Rand der vorigen Seite
  117. und umgekehrt.
  118.  
  119. In einem Fenster (oder einer auf dem Desktop liegenden Seite) kann mit
  120. der linken Maustaste ein Popupmenü aufgeklappt werden, das die Optionen
  121. `Weiterblättern', `Zurückblättern', `Gehe zu Seite ...', `Verkleinern'
  122. und `Klemmen' bzw. `Lösen' bietet. Verkleinern einer Doppelseite geht
  123. noch nicht.
  124.  
  125. FLIB-Dateien
  126. ------------
  127. ASCREEN unterstützt FLIB-Dateien, also zu `Libraries' gepackte Mengen
  128. von Zeichensätzen. Das Format entspricht dem von emTeX (Danke an
  129. Eberhard Mattes für die Beschreibung). FLIB-Dateien werden angesprochen,
  130. indem man ihren Namen im `fontpath' angibt, etwa so:
  131.  
  132.     fontpath    d:\fonts\fdori101.fli,d:\fonts
  133.  
  134. (Alles, was mit `.fli' aufhört, wird als FLIB-Datei angesehen.) Wie man
  135. sieht, können FLIB-Dateien und Pfade gemischt auftreten und werden der
  136. Reihe nach abgesucht, so daß man sehr genau festlegen kann, wo bestimmte
  137. Zeichensätze herkommen. Leider gibt es noch kein Programm, das
  138. FLIB-Dateien komfortabel verwaltet; die ASCREEN-Distribution enthält
  139. allerdings ein Perl-Skript, das aus einer Menge PK-Dateien eine
  140. FLIB-Datei machen kann. (Ich habe es aber bisher nur auf einer
  141. UNIX-Workstation benutzt und weiß nicht, ob es auf dem Atari geht.)
  142. Einige FLIB-Dateien mit den wichtigsten Zeichensätzen sind über FTP
  143. erhältlich.
  144.  
  145. GEM-Message-Pipe
  146. ----------------
  147. Man kann ASCREEN 3.1 über die AES-Funktion appl_write() Messages
  148. schicken und so bestimmte Programmfunktionen auslösen. Messages haben
  149. das Format
  150.  
  151.     Wort 0:    Messagetyp (bei ASCREEN immer MSG_ASCREEN = 8196)
  152.     Wort 1: Kennung (Application ID) des sendenden Prozesses
  153.     Wort 2: Überlänge der Message (bei ASCREEN meist 0, siehe unten)
  154.     Wort 3:    Subtyp der Message
  155.     Wort 4: weitere Parameter
  156.        :
  157.  
  158. ASCREEN ignoriert alle Messages bis auf die, die den Typ MSG_ASCREEN,
  159. definiert als die Dezimalzahl 8196, haben. ASCREEN erkennt zwei
  160. verschiedene Subtypen, namentlich
  161.  
  162.     MSG_REREAD (1)    die gerade aktuelle DVI-Datei wird neu eingelesen.
  163.         Diese Message ist interessant für Benutzer von MultiGEM;
  164.         sie können ein Programm schreiben, das nach einem
  165.         TeX-Lauf diese Message an ASCREEN schickt, damit das
  166.         Programm automatisch die neueste DVI-Datei liest
  167.         (Siehe `Bekannte Fehler' für den Haken an der Sache.)
  168.     MSG_NEWPAGE (2)    ASCREEN schickt sich selbst diese Message, um
  169.         das `Vorausbearbeiten' der nächsten Seite auszulösen.
  170.         Andere Programme können die Message aber natürlich auch
  171.         schicken. Wort 4 enthält die absolute Seitennummer der
  172.         zu formatierenden Seite. (Die Seite wird nicht auf dem
  173.         Bildschirm gezeigt, sondern nur im Cachespeicher abgelegt.)
  174.     MSG_NEWWIN (3) Diese Message veranlasst ASCREEN, ein neues Fenster
  175.         zu öffnen. Wort 4 ist 1 für ein normales und 2 für ein
  176.         verkleinertes Fenster; Wort 5 gibt die absolute Seitennummer
  177.         der Seite an, die in dem Fenster erscheinen soll.
  178.         Die Wörter 6-9 (ja, die Message hat Überlänge) enthalten
  179.         die Koordinaten des Fensters, wobei Rahmen, Slider usw.
  180.         enthalten sind.
  181.  
  182. HyperTeX
  183. --------
  184. HyperTeX ist ein experimentelles Verfahren zur Erstellung von
  185. `Dokumenten mit Querverbindungen', etwa für Online-Dokumentation, in
  186. LaTeX. Die Dateien HYPTEST.TEX, HYPTEST.DVI und HYPERTEX.STY erklären
  187. beispielhaft die LaTeX-Seite des Verfahrens. Im wesentlichen werden
  188. Begriffe im Text, die miteinander verbunden werden sollen, ausgezeichnet
  189. und für diese `Links' geeignete \special-Befehle in die DVI-Datei
  190. geschrieben, und es wird zum Dokument eine HYP-Datei angelegt, die man
  191. anschließend mit dem Perl-Programm HYP.PL sortieren kann.
  192.  
  193.     +---------+
  194.     | foo.tex |
  195.     +---------+
  196.          |
  197.        LaTeX
  198.          |        +---------+        +---------+
  199.          +--------->| foo.hyp |-- hyp.pl -->| foo.hl  |
  200.          |        +---------+        +---------+
  201.          |                         |
  202.          |        +---------+             V
  203.          +--------->| foo.dvi |------------>  ASCREEN
  204.             +---------+
  205.  
  206. Die HL-Datei ist dabei nach den `Links', den Stichwörtern, sortiert und
  207. erlaubt das schnelle Auffinden aller Verweise auf ein Stichwort. ASCREEN
  208. liest die DVI-Datei und die HL-Datei und zeichnet bei der Darstellung
  209. der Datei um jedes Link einen Rahmen. Klickt man in diesen Rahmen, so
  210. erscheint ein Popup-Menü, mit dem man wahlweise zur Definition oder zum
  211. nächsten oder vorigen Verweis auf den Begriff springen kann. Mit
  212. `Zurück' kann man die Verweiskette für das betreffende Fenster
  213. zurückrollen und so wieder zum Ausgangspunkt gelangen. Bei
  214. standardgemäßen Druckertreibern haben die \special-Befehle in der
  215. DVI-Datei auf das Ausdrucken übrigens keinen Einfluß, es sollten beim
  216. Drucken nur Warnungen auf dem Bildschirm erscheinen, die man ohne
  217. weiteres ignorieren kann.
  218.  
  219. Diverse Tips
  220. ------------
  221. 64000 Bytes für ausgepackte Glyphen sind normalerweise mehr als genug.
  222.  
  223. Man kann auch in `verkleinerten' Fenstern blättern, sie klemmen usw. Nur
  224. weiter verkleinern kann man sie nicht :-(
  225.  
  226. Bekannte Fehler
  227. ---------------
  228. Man kann noch keine Doppelseiten verkleinern (nicht schlimm, einstweilen
  229. zwei Fenster nebeneinanderlegen).
  230. Wenn man einen Rollpfeil an einem Fenster `festhält' (bei TOS-Versionen,
  231. die dafür Autorepeat unterstützen), kann ASCREEN sich nach einer Weile
  232. aufhängen.
  233. ASCREEN 3.1 hält die DVI-Datei während des gesamten Programmlaufs offen.
  234. Dies schränkt die Möglichkeiten des TeX-Laufs unter MultiGEM ein. Eine
  235. elegante und effiziente Lösung des Problems läßt noch auf sich warten;
  236. einstweilen sollte man den DVI-Puffer so groß wählen, daß die Datei
  237. ganz hineinpaßt. In diesem Fall wird die DVI-Datei nämlich gelesen und
  238. gleich wieder geschlossen, so daß TeX darauf zugreifen kann.
  239.  
  240. Traurige Mitteilung
  241. -------------------
  242. ASCREEN enthält diverse unaufgelöste Vorwärtsreferenzen in die
  243. unbestimmte Zukunft, etwa Menüpunkte und Setupeinträge für virtuelle
  244. Fonts usw. usf. Eine gewisse Vorfreude auf alle diese Features ist
  245. sicher nicht unberechtigt, beim Warten sollte man aber besser nicht die
  246. Luft anhalten, denn es gibt auch noch andere wichtige Dinge für mich zu
  247. tun (Diplomarbeit, ...)
  248.  
  249. Kopieren
  250. --------
  251. Sie dürfen ASCREEN benutzen und weiterverteilen, solange Sie damit kein
  252. Geld verdienen oder behaupten, Sie hätten das Programm geschrieben. Wenn
  253. ASCREEN Ihnen gefällt, so würde ich mich über eine Ansichtskarte von
  254. Ihrem Wohnort freuen.
  255.  
  256. Aktuelle Versionen
  257. ------------------
  258. ASCREENs `Heimat' ist ftp.math.uni-frankfurt.de [141.2.90.2]; dort steht
  259. die aktuelle Version zur Verfügung, zusammen mit FLIB-Dateien und
  260. anderen Dingen. Da ASCREEN frei kopierbar ist, wird es vermutlich aber
  261. auch anderswo auftauchen.
  262.  
  263. Es gibt eine Mailingliste für ASCREEN-Ankündigungen, Diskussionen usw.;
  264. man schicke Post an ascreen-request@math.uni-frankfurt.de, um Näheres
  265. herauszufinden.
  266.  
  267. Ich schicke Ihnen gerne die aktuelle Version des Programms, wenn Sie mir
  268. eine formatierte 720KB-Diskette und einen ausreichend frankierten
  269. Rückumschlag zusenden.
  270.  
  271. Kommentare, Fehlermeldungen, Vorschläge, Kritik usw.
  272. ----------------------------------------------------
  273. sind natürlich immer willkommen. Bitte einschicken an...
  274.  
  275.     Anselm Lingnau
  276.     Buchenweg 1
  277.     6239 Eppstein i. Ts.
  278.  
  279.     Telefon: (06198) 8555
  280.     E-Mail:  lingnau@math.uni-frankfurt.de
  281.