..Dies ist die Dokumentation im HyperMake (MakeIPF)-Format.
..Aus dieser Datei kann eine HTML oder IPF-Datei
..erzeugt werden. Lesen Sie bitte README.1ST.
..Falls Sie trotzdem den Rohtext als "AnfΣnger" anschauen m÷chten,
..folgende Hinweise:
..Punktbefehle beginnen mit einem Punkt und werden nur interpretiert,
..wenn sie unmittelbar am Anfang der Zeile stehen. In diesem Text werden
..viele Punktbefehle absichtlich ausgedruckt und nicht interpretiert,
..weil davor noch ein Leerzeichen steht.
..Kapitelⁿberschriften wird ein .n vorangestellt, wobei n die Hierarchie
..angibt (1 bis 6). Das Zeichen ╡ markiert W÷rter fⁿr den Index und als
..Querverweis-Ziel, ╡:Wort1 Wort2: markiert einen Ausdruck.
..Die restlichen Sonderzeichen sind Umschalter (Toggles), z. B. fⁿr
..fette Schrift.
.TI Dokumentation HyperMake 2.91
.fu[]
.bt┐ reddot
.ft┐
.st╡
.1
Einfⁿhrung
HyperMake (frⁿher MakeIPF) dient der einfachen Erstellung von Dateien im HTML- und IPF-Format. Statt direkt HTML-Dateien oder IPF-Dateien zu editieren, wird ein ASCII-Rohtext erstellt, der weitaus weniger Kommandos erhΣlt. Querverweise werden automatisch gezogen, mit nur einem Befehl werden Fenster verschiedener Gliederungsebenen gleichzeitig angezeigt ("Frames"), am Ende eines Kapitels wird automatisch auf Unterkapitel verwiesen und vieles mehr.
Die neue Version 2.9 ist die erste Version, die auch HTML-Dateien erzeugen kann. Aus nur einem Quelltext lassen sich sowohl HTML- als auch wie bisher IPF-Dateien erzeugen.
Neu in 2.9 ist auch eine RⁿckwΣrts-Konvertierung von IPF nach HyperMake. Dies ist dann sinnvoll, wenn eine Dokumentation schon im IPF-Format vorliegt.
Kⁿnftige HyperMake-Versionen wird es unter verschiedenen Betriebssystemen geben.
HyperMake ist nicht in erster Linie dafⁿr gedacht, eine einzelne Homepage zu schreiben. Seine StΣrke liegt in der Erstellung gr÷▀erer Dokumente wie wissenschaftliche Arbeiten oder Programmdokumentationen mit Inhaltsverzeichnis und Stichwortverzeichnis (Index).
Wenn Sie HyperMake verwenden, mⁿssen Sie lediglich das vergleichsweise einfache HyperMake-Format erlernen. Sie k÷nnen HyperMake Quelltexte erstellen mit
╢ einem ASCII-Editor mit autom. Zeilenumbruch
╢ einem ASCII-Editor ohne autom. Zeilenumbruch
╢ oder einem alten DOS WordStar Version 3.4 oder 4.
HyperMake hat einige leistungsstarke Features zu bieten:
╢ ⌐Automatische Querverweis- und Index-Erstellung⌐
Das Markieren eines Wortes oder eines Ausdrucks mehrerer W÷rter mit einem speziellen Zeichen hat zur Folge:
- Querverweise (engl. links) von allen gleichlautenden Ausdrⁿcken im Text zur markierten Textstelle hin
- einen entsprechenden Eintrag im Index (zu deutsch Stichwortverzeichnis).
.IF HTMLDOC
╢ ⌐Automatische Zerlegung in zahlreiche HTML-Dateien⌐
Beim Erzeugen von HTML-Dateien wird eine Quelldatei in zahlreiche einzelne HTML-Dateien zerlegt. Dies fⁿhrt zu h÷herer Performance bei der Benutzung von Browsern. Weder der Autor des Textes noch der Betrachter merkt etwas davon.
.END
.IF IPFDOC
╢ ⌐Automatische Erstellung von Helptables⌐
Fⁿr OS/2 HLP-Dateien dⁿrfen in den HyperMake ASCII-Quelltext direkt ID Konstanten wie "ID_buttonOK" eingetragen werden, um eine Verbindung zwischen dem Knopf und der erlΣuternden Textpassage herzustellen. HyperMake generiert eine Helptable-Datei, die in die RC-Datei eingebunden werden kann.
.END
╢ ⌐Automatische Erstellung von Querverweisen zu Unterkapiteln⌐
.sno
Am Ende eines Hauptkapitels, vor dem ersten Unterkapitel, werden Querverweise zu allen Unterkapiteln und zum nΣchsten Hauptkapitel erstellt.
.sn
╢ ⌐Automatische Anordnung von Kapiteln verschiedener Gliederungsebenen am Bildschirm⌐
Mit nur einem kurzen Befehl erhalten die folgenden Kapitel je nach Gliederungsebene verschiedene Positionen und Gr÷▀en am Bildschirm - es werden also Kindfenster (engl. Frames) generiert. Zwei oder gar drei Fenster verschiedener Gliederungsebenen, also Kapitel, Unterkapitel, Unterunterkapitel, erscheinen so gleichzeitig, vgl. Beispiel Fensteranordnung.
╢ ⌐Einfache Erstellung von Fu▀noten⌐
╢ ⌐Automatisches Linienziehen, um KΣstchen zu erstellen⌐
╢ ⌐Kurze, einfache Befehle⌐
- fⁿr Kapitelⁿberschriften und deren Gliederungsebene
- um Schriften auszuwΣhlen
- um Grafiken allein oder im Flie▀text auszugeben
- um unsortierte Listen / sortierte Listen (engl. unordered lists / ordered lists) zu generieren. (Dies hier ist eine zweistufige unsortierte Liste.)
In dieser Version 2.9 fehlt noch die Unterstⁿtzung von Tabellen (Tables) sowohl fⁿr HTML als auch fⁿr IPF. Dies ist fⁿr 3.0 vorgesehen.
.2
HTML-Dateien, Web-Browser und Internet
.in Dateiformat HTML
.in HTML-Datei
Die ╡:Hypertext-Markup-Language HTML: ist ein plattformⁿbergreifendes Dateiformat fⁿr Texte. Es handelt sich um einen ASCII-Text, in den mit spitzen Klammern <> Kommandos eingestreut sind. Wichtigstes Merkmal sind die Querverweise, sog. Links. Um HTML-Dateien zu betrachten, ben÷tigt man Browser.
In der Regel befinden sich die Dateien nicht lokal auf dem eigenen Rechner, sondern im Internet. Trotzdem aber lΣ▀t sich das HTML-Format dazu benutzen, lokal gespeicherte Daten wie Programmdokumentationen oder Nachschlagewerke anzuschauen.
Der aktuelle Entwicklungsstand von HTML ist 3.2. Dieser Stand wird von HyperMake unterstⁿtzt. Die wichtigste Neuerung sind Frames (Fensteranordnung). Mit HyperMake erzeugte HTML-Dateien, die Frames enthalten, k÷nnen auch mit Σlteren Browsern betrachtet werden, dann natⁿrlich ohne Frames.
.2
IPF, INF und HLP-Dateien
.in Dateiformat IBM INF
.in Dateiformat IBM HLP
.in Dateiformat IBM IPF
.in IPF-Datei
HTML Browser sind langsam und schwerfΣllig. IBM INF und HLP Dateien sind kompakte BinΣrdateien. Der Viewer (Betrachter) ist klein und sehr schnell. IBM INF Viewer gibt es fⁿr OS/2 (das Format aller OS/2-Programmdokumentationen), fⁿr Win16 und fⁿr DOS. Der Win16 Viewer ist Teil des Pakets "Just add Warp"; es werden die Dateien LIBIPFX.DLL, VIEW.EXE und VIEWH.HLP ben÷tigt. Der DOS Viewer ist in IBM DOS 7 enthalten und es gibt auch ein Freewareprogramm (VIEW01.ZIP Compuserve OS2DF1).
Um IBM INF-Dateien zu erstellen, ben÷tigen Sie den IBM IPFC Compiler (von IPF nach INF). Dieser ist Bestandteil von OS/2-Entwicklungssystemen, es soll ihn aber auch fⁿr Windows geben.[Die Windows-Version ist Bestandteil des IBM Visual Age C++ Entwicklungssystems.]
Im Vergleich zu HTML-Browsern haben die IBM INF Viewer einige leistungsstarke Features, die vor allem bei gro▀en Dokumenten zum Tragen kommen:
╢ der Index ist Bestandteil des binΣren INF Formates
╢ ebenso das Inhaltsverzeichnis, Kapitelⁿberschriften lassen sich wie VerzeichnisbΣume auf- und zuklappen
╢ sehr schnelle Such-Funktion: Da intern jedes Wort nur einmal gespeichert ist und Zeiger auf die tatsΣchlichen Textstellen zeigen, k÷nnen mehrere MB pro Sekunde nach bestimmten W÷rtern abgesucht werden. Der Benutzer erhΣlt dann ein Auswahlfenster mit allen Kapiteln, in denen der Suchbegriff vorkommt.
╢ Mehrere INF-Dateien k÷nnen per Kommandozeilenparameter "zusammengehΣngt" werden, so da▀ fⁿr den Benutzer eine gro▀e Hilfedatei mit entsprechend vergr÷▀ertem Inhaltsverzeichnis und Index entsteht.
Die wichtigen HTML-Features wie Tables, Frames, Bilder usw. sind alle auch im IBM INF-Format enthalten.
Der Inhalt von IBM INF- und HLP-Dateien wird in einer Sprache namens IPF eingegeben, Σhnlich HTML. Es ist ein mΣchtiges Werkzeug, mit dem praktisch alles machbar ist, was in einem solchen Hypertext denkbar ist. Allerdings ist diese Eingabesprache ziemlich umstΣndlich und hat kaum eine Eigenintelligenz. Deshalb findet man als OS/2-Anwender hΣufig farblose Hypertexte, die z. B. fast keine Querverweise enthalten.
Die Dokumentation zum IPF-Format gibt es nur in englischer Sprache, so da▀ manche Benutzer dabei ihre Schwierigkeiten haben.
HyperMake erleichtert Ihnen die Erstellung von IBM INF-Dateien[Das IBM information format ist ein Hypertext-Format, insbesondere fⁿr Programmdokumentationen.] und HLP-Dateien[Das HLP-Format ist Σhnlich dem INF-Format, erm÷glicht aber Verbindungen zwischen dem zu beschreibenden Programm und dem Hypertext. HLP-Dateien sind sozusagen Bestandteil des Anwenderprogramms.]. HyperMake generiert IPF[Das IPF Format (Information Presentation Facility) ist der Ausgangstext, um INF- oder HLP-Dateien zu erstellen.] Dateien von einem speziellen HyperMake ASCII-Format. Aus einer solch automatisch erstellten IPF-Datei wird dann mit dem IBM-Programm ╡IPFC[IPFC ist Bestandteil jedes OS/2 Programm-Entwicklungssystems. Auf meinem Rechner sind es die Dateien IPFC.EXE, IPFC20.INF und IPFCEXMP.INF sowie ein Verzeichnis IPFC mit lΣnderspezifischen Informationen.] die INF- oder HLP-Datei erzeugt.
.1
Erstellen eines HyperMake Quelltextes
.in Erstellen eines HyperMake Quelltextes
.FA verti 25
.2
Grundlagen
.3
Punktbefehle
Das HyperMake-Format verwendet ╡:Punktbefehl:e wie der gute alte DOS WordStar. Ein Punktbefehl ben÷tigt eine eigene Zeile und beginnt mit einem Punkt, zum Beispiel
.snb
.SN
.sn
stellt die Normalschrift auf den Standardwert (engl. default). Punktbefehle k÷nnen sowohl mit Klein- als auch mit Gro▀buchstaben geschrieben werden. Viele Punktbefehle erwarten die Eingabe von Parametern, z. B.
.snb
.LM10
.sn
verstellt den linken Rand auf 10. Dabei darf auch ein Leerzeichen zwischen Punktbefehl und Parameter stehen.
Die Zeile
.snb
..Kommentar
.sn
wird ignoriert.
.IF IPFDOC
.snb
.:IPFbefehl.
.:IPFbefehl. Ausdruck
.sn
Sie k÷nnen IPF-Befehle direkt eingeben (was jedoch eher die Ausnahme ist, da alle wichtigen Kommandos Bestandteil des einfacheren HyperMake Formates sind.)
.END IPFDOC
.IF HTMLDOC
.snb
.HTML
<HTML-Kommandos> Flie▀text usw.
.HYPERMAKE
.sn
Sie k÷nnen auch direkt HTML-Text und -Kommandos schreiben - z. B. fⁿr ╡:Java-Skript:s, er wird ohne ─nderung ⁿbernommen.
.END HTMLDOC
Wenn Punktbefehle aus mehr als zwei Buchstaben bestehen, mⁿssen Sie nur die ersten zwei Buchstaben unbedingt schreiben.
Beginnt ein Punktbefehl nicht in der ersten Spalte, so wird er nicht interpretiert, sondern erscheint im Flie▀text.
In diesem Hypertext befindet sich ein Verzeichnis aller Punktbefehle.
.3
Umschaltzeichen
.in Umschaltzeichen
.in toggle
.in Zeichen fⁿr Umschalter
In der Ini-Datei k÷nnen Sie einige íUmschaltzeichení (engl. toggle) definieren. Zwischen zwei identischen Umschaltzeichen wird eine bestimmte Funktion aktiviert, beispielsweise "fett". Wenn Sie in der Ini-Datei "*" fⁿr "fett" und " @" fⁿr "italic" (d. h. schrΣg) eingestellt haben, k÷nnen Sie schreiben:
.snb
Dieser *Teil des Satzes* ist besonders wichtig.
.sn
Sie erhalten dann:
Dieser ⌐Teil des Satzes⌐ ist besonders wichtig.
Sie k÷nnen Umschaltzeichen auch ⁿberlagert verwenden:
.snb
Das ist *fett und @gleichzeitig italic* und nur italic@.
.sn
Das ist ⌐fett und ígleichzeitig italic⌐ und nur italicí.
Aber achten Sie darauf, da▀ Sie die Umschaltzeichen nicht anderweitig im Text verwenden. Sie mⁿssen sich also Zeichen ⁿberlegen, die Sie auf jeden Fall im Text nicht ben÷tigen.
Sinnvoll sind bei der Verwendung der IBM Codepage die Steuerzeichen unter ASCII dezimal 32, wenn der verwendete Editor diese unterstⁿtzt,[natⁿrlich ohne 0x0A, 0x0D, 0x1A (dezimal 10, 13, 26)] und bei HTML die Zeichen oberhalb von ASCII dezimal 127.
.3
Bedeutung von Returns
.in Bedeutung von Returns
.in ASCIIHARDRET
.in ASCIISOFTRET
Wenn Sie einen HyperMake-Quelltext ≈mit einem ASCII Editor≈ schreiben, k÷nnen Sie zwischen zwei verschiedenen Arten wΣhlen, wie Returns (Zeilenvorschⁿbe) interpretiert werden sollen. Mit der ASCIIHARDRET Einstellung in der Ini-Datei, Abschnitt source format, wird jeder Return auch tatsΣchlich als eine neue Zeile verstanden. WΣhlen Sie diese Einstellung, wenn Ihr Editor zu lange Zeilen automatisch in die neue Zeile umbricht, íohneí aber selbstΣndig Return-Steuerzeichen in den Text zu schreiben. Der OS/2 E und EPM Editor unterstⁿtzen dies ("Optionen - Zeilenumbruch ein").
Andernfalls verwenden Sie besser ASCIISOFTRET. Das interpretiert ein Return-Steuerzeichen nur dann als wirkliche neue Zeile, wenn
╢ zwei Returns direkt aufeinander folgen (also eine Leerzeile eingefⁿgt ist)
╢ das letzte Zeichen in der vorangegangenen Zeile . ! ? : ; ist.
.IF WORDSTARDOC
Wenn Sie den Quelltext ≈mit einem DOS WordStar≈ schreiben, gibt es solche Probleme nicht, weil WordStar zwischen harten und weichen Returns unterscheidet.
.END
.2
Textanfang
Jedes Dokument hat einen ╡Titel. Dieser erscheint als Titel des Hauptfensters und auch in der Fensterliste.
.snb
.TI Dokumentation von meinem Programm
.sn
legt den Titel der HTML-Datei bzw. INF-Datei fest. Jeder HyperMake-Quelltext, mit dem eine INF-Datei erstellt wird, mu▀ mit einem solchen Titel beginnen, noch vor der ersten Kapitelⁿberschrift.
.IF HTMLDOC
HyperMake erzeugt aus nur einer Quelldatei mehrere HTML-Dateien. Jede HTML-Datei erhΣlt den selben Titel.
.END
.IF IPFDOC
Bei HLP-Dateien wird der Titel ⁿber den Programm-Quelltext festgelegt (siehe function InitHelp). Der Titel-Punktbefehl im HyperMake-Quelltext wird ignoriert.
In HLP-Dateien werden standardmΣ▀ig die Tasten "Inhalt", "Zurⁿck" und "VorwΣrts" ausgeblendet. Wenn Sie die gleichen Tasten wie bei INF-Dateien haben wollen, so verwenden Sie am Textanfang den folgenden Punktbefehl:
.snb
.<>
.sn
.END
.2
Kapitel
Die mit HyperMake erzeugten HTML-Dateien und IBM INF-Dateien verfⁿgen ⁿber ein ╡Inhaltsverzeichnis.
.IF IPFDOC
Wenn man eine INF-Datei aufruft, erhΣlt man zu Beginn ein Inhaltsverzeichnis, bei dem man wie in einem Verzeichnisbaum Kapitelⁿberschriften auf- und zuklappen kann. Der Text, der unter jeder ╡Kapitelⁿberschrift steht, erhΣlt ein eigenes Fenster.
.END
.IF HTMLDOC
Erzeugt HyperMake HTML-Dateien, dann erhΣlt man unter dem Dateinamen INDEX.HTML ein Inhaltsverzeichnis.
.END
Es lassen sich ╡Kapitel und Unterkapitel wie in einer wissenschaftlichen Arbeit gliedern:
.snA
Hauptⁿberschrift
Erste Unterⁿberschrift
Zweite Unterⁿberschrift
Erste Unterunterⁿberschrift
Zweite Unterunterⁿberschrift
Dritte Unterⁿberschrift
.sn
Im HyperMake Quelltext schreiben Sie Kapitelⁿberschriften wie folgt:
.snb
.1
Erste Hauptⁿberschrift
.2
Erste Unterⁿberschrift
.2
Zweite Unterⁿberschrift
.3
Erste Unterunterⁿberschrift
.3
Zweite Unterunterⁿberschrift
.2
Dritte Unterⁿberschrift
.1
Zweite Hauptⁿberschrift
.sn
Unter dem Punktbefehl, in dem sie die ╡Gliederungsebene angeben, schreiben Sie den Text der Kapitelⁿberschrift.
Der Text darf mehr als eine Zeile lang sein. Wenn Sie als Quelltextformat ASCIISOFTRET gewΣhlt haben, mⁿssen Sie zwei Returns (also eine Leerzeile) nach der Kapitelⁿberschrift eingeben.
In einem normalen, ausgedruckten Schriftstⁿck wⁿrde man stattdessen z. B. Dezimalklassifiation verwenden:
1. Erste Hauptⁿberschrift
1.1 Erste Unterⁿberschrift
1.2 Zweite Unterⁿberschrift
1.2.1 Erste Unterunterⁿberschrift
1.2.2 Zweite Unterunterⁿberschrift
1.3 Dritte Unterⁿberschrift
2. Zweite Hauptⁿberschrift
.IF IPFDOC
Der Text hinter dem Gliederungsebenen-Punktbefehl ist auf etwa 200 Buchstaben begrenzt[Der IPFC Compiler wⁿrde eine Fehlermeldung erzeugen.], aber man sieht im Fenstertitel nur etwa 70 bis 120 Buchstaben, abhΣngig von der Breite des Fensters auf dem Bildschirm.
.END
Zu Beginn des HyperMake-Quelltextes kann normaler Text erst nach der ersten Kapitelⁿberschrift eingegeben werden.[Jede Kapitelⁿberschrift steht fⁿr ein Fenster. Ohne Fenster kann kein normaler Text dargestellt werden, der IPFC Compiler wⁿrde Fehlermeldungen erzeugen.]
Es dⁿrfen bis zu 6 Gliederungsebenen verwendet werden.
Wenn ein Kapitel Unterkapitel hat, werden automatisch Verweise zu Unterkapiteln und ein Verweis auf das nΣchste Hauptkapitel generiert.
.3
Gleichzeitiges Anzeigen mehrerer Fenster
.in Fensteranordnung
.in Frames
Mit nur einem einmalig zu verwendenden Punktbefehl sind Sie in der Lage, das Hypertext-Fenster in zwei oder drei Abschnitte zu teilen, so da▀ zwei oder drei Kapitel verschiedener Gliederungsebenen gleichzeitig angezeigt werden.
.snL
Gleichzeitiges Anzeigen zweier Gliederungsebenen
.sn
Wenn Sie den Punktbefehl íFensteranordnungí
.snb
.FA verti 30
.sn
vor einem normalen Gliederungsebenen-Punktbefehl schreiben, wird das Hauptfenster ívertikalí in ein linkes Fenster (30% der Bildschirmbreite) und ein rechtes Fenster (die verbleibenden 70%) unterteilt. Im linken Fenster erscheint das Fenster, dessen Kapitelⁿberschrift nach dem FA Punktbefehl geschrieben wurde (im folgenden "Hauptkapitel" genannt); im rechten Fenster erscheint das Unterkapitel.
Geben Sie bitte zwischen den Parametern des FA Punktbefehls ein Leerzeichen ein.
Wenn Sie die Fensteranordnungs-Funktion verwenden, empfehle ich dringend, die automatischen Querverweise zu Unterkapitel nicht auszuschalten.
.snb
.FA hori 40
.sn
unterteilt das Hypertext-Hauptfenster íhorizontalí. Das Hauptkapitel erhΣlt das obere Fenster (40% der Gesamth÷he), das Unterkapitel das untere Fenster (die verbleibenden 60%).
Sie dⁿrfen Prozentwerte von 10 bis 90 eingeben.
Fⁿr ein Beispiel zur zweiteiligen Fensteranordnung siehe Verzeichnis aller Punktbefehle und Ini-Datei.
.snL
Gleichzeitiges Anzeigen dreier Gliederungsebenen
.sn
Diese Funktion steht bislang nur bei der Erstellung von IPF-Dateien zur Verfⁿgung.
.IF IPFDOC
In gleicher Art und Weise k÷nnen Sie auch drei Gliederungsebenen gleichzeitig anzeigen lassen. Dabei mⁿssen Sie eine Angabe zu íhorií und zu ívertií machen:
.snb
.FA hori 40 verti 30 III
.sn
.sab
Die erste hori/verti-Angabe unterteilt das Hauptfenster auf ganzer LΣnge von links nach rechts bzw. von oben nach unten. Die zweite Angabe unterteilt einen der Teile wiederum in zwei Teile, so da▀ Sie drei Fenster erhalten: zwei kleinere und ein gr÷▀eres. Sie k÷nnen wΣhlen, welche Gliederungsebene das gr÷▀ere Fenster bekommt, wobei Sie zwischen ~I~ und ~III~ einstellen k÷nnen. So k÷nnen Sie zwischen insgesamt vier Arten der Fensteranordnung wΣhlen:
.liXY
verti hori hori verti
+-----+----------+ +----------------+
| | II | | I |
I | I +----------+ +-----+----------+
| | III | | II | III |
| | | | | |
+-----+----------+ +-----+----------+
+-----+----------+ +-----+----------+
| I | | | I | II |
+-----+ | +-----+----------+
III | | III | | |
| II | | | III |
| | | | |
+-----+----------+ +----------------+
.li
~I~ ist das Hauptkapitel, ~II~ das Unterkapitel, ~III~ das Unterunterkapitel.
Der Punktbefehl Fensteranordnung gilt nur ⁿber ein Hauptkapitel mit seinen Unter- und Unterunterkapiteln.
Die Fensteranordnung arbeitet nur, wenn der Benutzer direkt das Hauptkapitel aufruft. Wenn ⁿber einen Querverweis direkt ins Unterunterkapitel gesprungen wird (~III~), wird das Hauptfenster nicht entsprechend unterteilt. Bei einem Querverweis ins Unterkapitel (~II~) erscheint zwar auch die Ebene ~III~, jedoch bleibt der fⁿr ~I~ reservierte Platz ungenutzt.
Wenn Sie drei Gliederungsebenen gleichzeitig angezeigt haben wollen, aber nicht jedes Kapitel ⁿber die dritte Gliederungsebene verfⁿgt, sollte immer Ebene ~I~ das gr÷▀te Fenster erhalten, also ~I~ und nicht ~III~ im FA-Punktbefehl stehen. Dann nimmt das Kapitel der Ebene II den sonst fⁿr III reservierten Platz mit ein.
.4
Beispiel Fensteranordnung - Quelltext
.snz
.FA verti 50 hori 40 I
.4
Beispiel Fensteranordnung - Ergebnis
Das Hauptkapitel mit Querverweisen zu Unterkapiteln.
.5
Erstes Unterkapitel
Das erste Unterkapitel mit Querverweisen zu Unterunterkapiteln. (3-fach-Unterteilung fⁿr HTML wird in HyperMake 2.9 noch nicht unterstⁿtzt.)
.6
Erstes Unterunterkapitel
Das erste Unterunterkapitel vom ersten Unterkapitel.
.6
Zweites Unterunterkapitel
Das zweite Unterunterkapitel vom ersten Unterkapitel.
.5
Zweites Unterkapitel
Das zweite Unterkapitel.
.6
Erstes Unterunterkapitel
Das erste Unterunterkapitel vom zweiten Unterkapitel.
.6
Zweites Unterunterkapitel
Das zweite Unterunterkapitel vom zweiten Unterkapitel.
.sn
.FA verti 40 hori 50 I
.4
Beispiel Fensteranordnung - Ergebnis
.in Beispiel Fensteranordnung
Das Hauptkapitel mit Querverweisen zu Unterkapiteln.
.5
Erstes Unterkapitel
Das erste Unterkapitel mit Querverweisen zu Unterunterkapiteln. (3-fach-Unterteilung fⁿr HTML wird in HyperMake 2.9 noch nicht unterstⁿtzt.)
.6
Erstes Unterunterkapitel
Das erste Unterunterkapitel vom ersten Unterkapitel.
.6
Zweites Unterunterkapitel
Das zweite Unterunterkapitel vom ersten Unterkapitel.
.5
Zweites Unterkapitel
Das zweite Unterkapitel.
.6
Erstes Unterunterkapitel
Das erste Unterunterkapitel vom zweiten Unterkapitel.
.6
Zweites Unterunterkapitel
Das zweite Unterunterkapitel vom zweiten Unterkapitel.
.END
.FA verti 75
.2
Schriften
.in Schrift
.in font
.snL
╡:Schrift Normal:
.sn
Mit dem Punktbefehl íSchrift Normalí
.sab
~.SNX~
k÷nnen Sie eine Schrift auswΣhlen, wobei ~X~ fⁿr einen Schrift-Buchstaben (A bis Z und a bis z) steht; Gro▀- und Kleinbuchstaben werden unterschieden! Ein Schrift-Buchstabe steht fⁿr eine bestimmte
Sie k÷nnen jedem der 2 x 26 Schrift-Buchstaben in der Ini-Datei verschiedene Schriften, Gr÷▀en und Farben zuordnen.
Es gibt noch zwei andere Schrift-Einstellungen in der Ini-Datei: ~OmitLinks~ ist beschrieben in Querverweise, íUnterdrⁿcken von Querverweisení, ~LineStandard~ in Linienziehen.
Um Schrift Normal auf den Standardwert (default) zu setzen, schreiben Sie einfach den Punktbefehl ohne weitere Parameter:
~.SN~
.IF HTMLDOC
.snL
╡:Phrase Element:
.sn
Eine besondere ErlΣuterung ben÷tigen die Phrase Elements von HTML.
Bei HTML k÷nnen Sie nicht direkt die Schriftart "Courier", "Helvetica" usw. auswΣhlen, denn das zugrundeliegende Konzept ist ein anderes - schlie▀lich wird vielleicht der Text auf einem Rechner angeschaut, der gar keine "Courier" Schrift verwendet. Die Schrift soll der Benutzer einstellen k÷nnen. Als Autor des HTML-Textes k÷nnen Sie stattdessen mittels Phrase Elements den íZweck des Textesí angeben: etwa CODE fⁿr Programmcode (es wird Schrift in festen Schritten verwendet). Der Browser wΣhlt dann eine passende Schrift dazu aus.
Es gibt die folgenden Phrase Elements:
PRE ADDRESS EM STRONG DFN CODE SAMP VAR CITE
PRE spielt dabei eine Sonderrolle: Wenn eine Schrift mit Phrase Element PRE gewΣhlt ist, bleiben die Zeilenumbrⁿche aus dem Rohtext alle erhalten - die automatische Formatierung von Flie▀text ist dann ausgeschaltet.
Die restlichen Phrase elements haben die folgende Bedeutung:
~EM~ Standard-Hervorhebung, meist kursiv dargestellt
~STRONG~ starke Hervorhebung, meist fett dargestellt
~DFN~ fⁿr Definitionen
~CODE~ fⁿr Programm-Quellcode
~SAMP~ fⁿr Programm-Beispielsausgaben
~VAR~ fⁿr Variablen oder Parameter von Befehlen
~CITE~ fⁿr Zitate
.END
.snL
Formatier-Attribute
.sn
Mit dem ~center~ Attribut in der Ini-Datei wird eine Schrift immer zentriert ausgegeben. Der Punktbefehl Output Centered lΣ▀t sich so sparen.
.IF IPFDOC
Fⁿr IPF lΣ▀t sich mit dem Attribut ~PRE~ die automatische Formatierung abstellen, beispielsweise fⁿr Quelltexte.
Der entsprechende Punktbefehl Formatierung ist in diesem Fall nicht mehr n÷tig.
.END
.snL
╡:Schrift Alternativ:
.sn
.in Zeichen fⁿr Schrift Alternativ
─hnlich ~.SN~ ist der Befehl ~.SA~ íSchrift Alternativí zu verwenden. Die alternative Schrift wird mit Hilfe des Umschaltzeichens (Toggle) "Alternativ" gesetzt. Das Alternativ-Umschaltzeichen wird in der Ini-Datei gesetzt.
So lassen sich Schrift und Farbe innerhalb des Flie▀textes umschalten:
.saZ
Das schaut ziemlich ~d~Σ~m~l~i~c~h~ aus.
.sab
.IF IPFDOC
Der IPFC Compiler erlaubt nicht mehr als 14 Schriften in einer Datei.
Ich empfehle, nicht mehr als 3 oder 4 verschiedene Schriften zu verwenden. Au▀erdem m÷chte ich Ihnen nahelegen, den Standardwert auch wirklich fⁿr den ⁿberwiegenden Teil des normalen Flie▀textes zu verwenden. weil der Standardwert eine vernⁿnftig lesbare Schrift auf íjedemí Bildschirm ist.
.END
Eine ausgewΣhlte Schrift ist bis zum nΣchsten Schrift-Punktbefehl aktiv, selbst ⁿber Kapitel hinweg.
Alternative Schriften sollten nur innerhalb eines Absatzes verwendet werden. Wenn Sie mehrere AbsΣtze mit einer anderen Schrift schreiben wollen, verwenden Sie besser den ~.SN~-Befehl.
.IF HTML
.3
Phrase element Beispiele
Phrase element Befehle werden von Browser zu Browser unterschiedlich dargestellt.
.HTML
<ADDRESS>Beispielstext mit Phrase element ADDRESS</ADDRESS><br>
<PRE>Beispielstext mit Phrase element PRE</PRE><br>
<EM>Beispielstext mit Phrase element EM</EM><br>
<STRONG>Beispielstext mit Phrase element STRONG</STRONG><br>
<DFN>Beispielstext mit Phrase element DFN</DFN><br>
<CODE>Beispielstext mit Phrase element CODE</CODE><br>
<SAMP>Beispielstext mit Phrase element SAMP</SAMP><br>
<VAR>Beispielstext mit Phrase element VAR</VAR><br>
<CITE>Beispielstext mit Phrase element CITE</CITE><br>
.HYPERMAKE
.END
.3
Schrift-Beispiele
.in Schrift-Beispiele
.IF HTMLDOC
HTML unterstⁿtzt nur Size (Schriftgr÷▀e), nicht direkt Font (Schrifttyp).
- Hintergrundfarbe (gleiche Farben wie bei Vordergrundfarben).
VerΣndern Sie einmal die Breite des Fensters und beobachten Sie die Textformatierung. Ein solches Ergebnis lΣ▀t sich nicht mit normalen Zeichen erzielen.
Die hier sichtbaren ╡Auflistungszeichen k÷nnen nicht beeinflu▀t werden, da sie im IPFC Compiler bzw. im HTML-Browser festgelegt sind.
Bei sortierten Listen wird Σhnlich wie bei unsortierte Listen vorgegangen.
Die HTML- und IPF-Funktion Definition List wird nicht unterstⁿtzt; sie k÷nnen es aber mit Hilfe des Befehls automatischer Rand simulieren.
.IF WORDSTARDOC
.3
Eingabe mit DOS WordStar
.sab
WordStar verfⁿgt ⁿber "╡:weiche Leerzeichen;" ~░~. Sie k÷nnen im WordStar mit ^OG erzeugt werden.[Weiche Leerzeichen werden im WordStar entweder als ~░~, oder einem mittigen Punkt oder einem anderen Sonderzeichen dargestellt. Wenn ein Absatz mit ^B neu formatiert wird, werden weiche Leerzeichen gel÷scht. Mit Tab (^I) lassen sich keine weichen Leerzeichen erzeugen.]
Es gibt keine bestimmten Auflistungszeichen fⁿr die verschiedenen Auflistungsebenen wie bei der Eingabe mit einem ASCII Editor. Stattdessen mⁿssen weiche Leerzeichen verwendet werden.
░░-░░Hintergrundfarbe (gleiche Farben wie bei Vordergrundfarben).
.sn
Mit Ausnahme der ersten Auflistungsebene mⁿssen sich alle Auflistungszeichen ízwischení weichen Leerzeichen befinden; in der ersten Ebene mu▀ dem Auflistungszeichen mindestens ein weiches Leerzeichen folgen. Wenn einmal die Position und das Zeichen des Auflistungszeichens einer Ebene gewΣhlt worden ist, darf innerhalb der gleichen Liste dies nicht mehr geΣndert werden. Beim folgenden Beispiel wⁿrde HyperMake Fehlermeldungen erzeugen:
Nachdem Sie einen normalen Abstatz ohne Listen-Funktion geschrieben haben, dⁿrfen Sie fⁿr die nΣchste unsortierte Liste wieder andere Auflistungszeichen-Positionen und -Zeichen verwenden.
.3
Eingabe mit einem ASCII-Editor
.END WORDSTARDOC
.in Auflistungen mit einem ASCII-Editor
.in Zeichen fⁿr Auflistungsebenen
In der Ini-Datei k÷nnen Sie Auflistungszeichen definieren. Auflistungszeichen stehen am Anfang einer Zeile. Angenommen, in der Ini-Datei sind folgende Auflistungszeichen festgelegt: * fⁿr die erste und = fⁿr die zweite Auflistungsebene.
Um die unsortiere Liste von der letzten Seite zu erstellen, geben Sie ein:
= Hintergrundfarbe (gleiche Farben wie bei Vordergrundfarben).
.sn
Sie k÷nnen auch noch Auflistungszeichen fⁿr weitere Ebenen definieren. Brauchbare Zeichen sind das Quadrat Alt-254, der Graphik-Doppelstrich Alt-205 und -Einfachstrich Alt-196 und der normale Strich -.
Es ist zulΣssig, zur eigenen ▄bersicht weitere Leerzeichen zu verwenden. Das gleiche Ergebnis wie oben erhΣlt man deshalb mit der folgenden Eingabe:
Eine sortierte Liste zΣhlt in der ersten Auflistungsebene mit 1., 2., 3., und in der zweiten Ebene mit a., b., c. Die dritte Ebene ist dann wieder numerisch usw. Dies lΣ▀t sich nicht beeinflussen.
Um eine sortierte Liste zu erstellen, geht man erst einmal genauso vor wie bei unsortierten Listen. ~Mit den Punktbefehlen ísortierte Listeí und íunsortierte Listeí~
.snb
.SL
.UL
.sn
lΣ▀t sich zwischen sortierten und unsortierten Listen hin- und herschalten. Um einmalig eine sortierte Liste zu erhalten, wird diese mit dem SL und UL-Punktbefehl quasi eingeklammert. Die Voreinstellung ist ~íunsortiere Listeí.~
.2
Einbindung von Grafiken
.in Zeichen fⁿr Grafiken
Um eine ╡Grafik (╡Bitmap) zentriert erscheinen zu lassen, verwenden Sie den Punktbefehl íbitmapí
.snb
.BM Dateiname
.sn
.IF IPFDOC
Wenn der Dateiname ohne Erweiterung geschrieben wird, wird bei IPF automatisch ".BMP" angehΣngt. IPFC unterstⁿtzt au▀erdem OS/2-MET-Dateien. [Um von GIF nach BMP zu konvertieren, bietet sich das Freeware-Tool GIF2BMP an (Graham Welland, September 1989, OS/2 16 bit).]
.END
.IF HTMLDOC
Bei der Erstellung von HTML-Dateien wird automatisch ".GIF" angehΣngt, wenn der Grafikdateiname ohne Erweiterung angegeben wird.
.END
.sab
Statt eines Dateinamens k÷nnen Sie mit den Schlⁿsselw÷rtern ~LINKS~ ~RECHTS~ ~MITTE~ (MITTE nur IPF) die Grafik ausrichten. Standardwert ist ~LINKS~. Die Ausrichtung der Grafik gilt so lange, bis diese erneut geΣndert wird. Um eine Grafik rechtsbⁿndig zu bekommen, schreiben Sie also
.snb
.BM RECHTS
.BM Dateiname
.sn
Mit einem zweiten Punktbefehl í╡:bitmap text:í lassen sich Grafiken in den Flie▀text integrieren:
.snb
.BTX Dateiname
.sn
.bt╜ box
.in Grafikzeichen
~X~ steht stellvertretend fⁿr ein Sonderzeichen, das sonst nicht im Text verwendet wird (sog. íGrafikzeichení). Dieses Sonderzeichen wird ersetzt durch die Grafik "Dateiname". Beachten Sie, da▀ Grafiken ╜ h÷her sind als Buchstaben, so da▀ sich ein gr÷▀erer Zeilenabstand ergibt, selbst wenn die Grafik so klein wie ein Buchstabe ist. Block-Zeichen wie █ (Alt-219), ▄ (Alt-220), ▀ (Alt-223) sind besonders geeignet (bei IBM codepage).
Es ist zulΣssig, verschiedene Grafikzeichen gleichzeitig zu definieren.
Um eine Grafikzeichen-Definition wieder aufzuheben, wird eingegeben:
.snb
.BTX
.sn
ohne Dateiname.
.fa hori 35
.2
Querverweise und Index
.in Querverweis
.in Index
.in Zeichen fⁿr Index- und Querverweismarkierung
.3
Automatische Erstellung von Querverweisen und IndexeintrΣgen
Die Erstellung von Querverweisen ist die mΣchtigste Funktion von HyperMake. Wenn man eine HTML-Datei oder IPF-Datei direkt schreiben wⁿrde, so mⁿ▀te man jeden Querverweis selbst ziehen - wenn also z. B. ein 1 MB langer Hypertext ⁿber Workgroup Computing geschrieben werden soll, und der Ausdruck "Workgroup Computing" tausend mal vorkommt, so mⁿ▀te man selbst 1000 mal einen Querverweis programmieren... Letztlich wird dann auf sinnvolle Querverweise ganz verzichtet.
Mit HyperMake mⁿssen Sie lediglich íeinmalí einen gewⁿnschten Ausdruck (ein Wort oder mehrere W÷rter) mit einem bestimmten Zeichen (dem Indexzeichen) markieren, und zwar an der Stelle, wo der Ausdruck erklΣrt wird bzw. wo es im Text um den Ausdruck geht (╡:Querverweis-Ziel:). Alle anderen Vorkommnisse des Ausdrucks im gesamten Hypertext erhalten automatisch einen Querverweis zu diesem Kapitel, wo der Ausdruck markiert wurde. Gleichzeitig wird der Ausdruck im Index (Stichwortverzeichnis) aufgenommen.
.IF HTMLDOC
.iv gro▀e Stichwortverzeichnis
Fⁿr HTML wird ein alphabetischer Index in einer eigenen Datei erzeugt. Dieses Stichwortverzeichnis gibt es in einer gro▀en und einer kleinen Ausgabe, abhΣngig von der Anzahl der EintrΣge. Das gro▀e Stichwortverzeichnis verfⁿgt ⁿber Querverweise zu den Anfangsbuchstaben A bis Z. Ab wann das gro▀e und bis wann das kleine Stichwortverzeichnis angelegt werden soll, kann in der Ini-Datei unter extended index angegeben werden.
.END
.3
Markieren eines einzelnen Wortes, ─ndern des Indexzeichens
.in Indexzeichen
.snL
Markieren eines einzelnen Wortes
.sn
Um ein einzelnes Wort fⁿr die Querverweis- und Index-Erstellung zu markieren, wird das Indexzeichen vorangestellt:
.snb
Eine #Workgroup ist eine Gruppe von Personen, die...
.sn
íAchtung:í verwenden Sie Indexzeichen nicht in Kapitelⁿberschriften, benutzen Sie hierfⁿr die Duplizierung von Kapitelⁿberschriften.
.snL
─ndern des Indexzeichens
.sn
Mit dem Punktbefehl íIndexzeichení
.snb
.IZ@
.sn
.sab
wird die aktuelle Einstellung fⁿr das Indexzeichen aus der Ini-Datei, z. B. ~#~, in ~@~ geΣndert.
.3
Markieren eines Ausdrucks
Wenn Sie ein Wort mit dem Indexzeichen markieren, wird nur das eine Wort gekennzeichnet. Ein Wort endet mit dem ersten Zeichen, das kein Buchstabe ist. (Zeichen, die als Buchstaben behandelt werden sollen, k÷nnen in der Ini-Datei unter íextended lettersí definiert werden.)
Um einen Ausdruck mehrerer W÷rter zu markieren, werden zusΣtzlich zum Indexzeichen Doppelpunkte wie Klammern verwendet:
.snb
Heutzutage ist die #:Sicherheit von Computern: fast schon...
...
Trotzdem kann die #:Sicherheit von Gro▀rechnern: nicht als...
...
Dafⁿr hat die #:Benutzerfreundlichkeit von Computern; doch...
.sn
Im Index wird folgendes erscheinen:
.snC
Sicherheit
von Computern
von Gro▀rechnern
Computern, Benutzerfreundlichkeit von
.sn
Achten Sie auf den feinen Unterschied zwischen dem ersten/zweiten und dem dritten Beispiel: Die Eingabe von "#:XXXX«:«" verwendet das erste Wort des Ausdrucks als das ╡:ífⁿhrende Wortí:, ein "#:XXXX«;«" das letzte Wort. Das fⁿhrende Wort wird im Index zuerst genannt und bestimmt somit die alphabetische Reihenfolge im Index. Die Wahl des fⁿhrenden Wortes hat keine Auswirkung auf Querverweise.
Wenn ein fⁿhrendes Wort im Index nur einmal vorkommt wie
.snC
Computern
Benutzerfreundlichkeit von
.sn
schreibt HyperMake im Index
.snC
Computern, Benutzerfreundlichkeit von
.sn
Ihnen wird schon aufgefallen sein, da▀ die Endung "Computern" nicht sehr sch÷n ausschaut. Solche unsch÷nen Endungen dⁿrfen Sie ausklammern:
.snb
Dafⁿr hat die #:Benutzerfreundlichkeit von Computer;n doch...
...
hat gezeigt, da▀ bei #:Computer:n
.sn
.3
Markieren eines Ausdruckes au▀erhalb des Flie▀textes
Mit dem Punktbefehl íINdexí
.snb
.IN Ausdruck
.sn
k÷nnen Sie ein Wort oder einen Ausdruck mehrerer W÷rter im Index ablegen und Querverweise von gleichlautenden Ausdrⁿcken anderer Textstellen zu dieser Stelle hin erzeugen. Das hat den Vorteil, da▀ der Indexeintrag bzw. das Querverweis-Ziel nicht wortw÷rtlich im Flie▀text vorkommen mu▀. Manchmal kann die Verwendung eines Punktbefehls statt dem Indexzeichen mit Doppelpunkt-Klammern auch ⁿbersichtlicher sein.
.in Index vertauscht
Normalerweise ist das erste Wort des Ausdrucks das fⁿhrende Wort. Wenn dagegen das letzte Wort das fⁿhrende Wort sein soll wie bei der Verwendung der Doppelpunkt-Strichpunkt-Klammerung, verwenden Sie den Punktbefehl íIndex Vertauschtí
.snb
.IV Benutzerfreundlichkeit von Computer
.sn
Wenn der Ausdruck in den Punktbefehlen íINí und íIVí mit einem Leerzeichen endet, wird der Ausdruck zwar in den Index aufgenommen, Querverweise werden aber nicht gezogen. Sie k÷nnen sich dies ggf. zunutze machen.
.3
Querverweise bei leicht abweichenden W÷rtern
.snL
╡:Verfahrensweise bei Wortendungen;
.sn
Was macht HyperMake, wenn das Wort "Maschine«n«" gefunden wird und an anderer Stelle das Wort "Maschine" ohne "n" markiert ist? Er zieht den Querverweis trotzdem, weil die Endung "n" in der Ini-Datei unter "endings of words" eingetragen ist (bzw. sein sollte). Dieser Eintrag ist sprachspezifisch.
Wenn umgekehrt "Maschine«n«" markiert wurde, so wird bei "Maschine" kein Querverweis gezogen. Markieren Sie deshalb die W÷rter in schlichter Form (Singular, 1. Fall).
Um bei W÷rtern, die mit Vokalen[Buchstaben a e i o u y] enden wie "Konto" "Konten" trotzdem die Gleichheit zu finden, kⁿrzt HyperMake vor dem Vergleich die W÷rter erst einmal um den letzten Buchstaben, wenn er ein Vokal ist.
.snL
Gro▀- und Kleinschreibung
.sn
Querverweise werden unabhΣngig von der Gro▀- bzw. Kleinschreibung des Anfangsbuchstabens gezogen. Wenn dagegen weitere Buchstaben in ihrer Gro▀- bzw. Kleinschreibung abweichen, wird der Querverweis nicht erstellt. Beispiel:
.sab
~.IN Wort~
.sn
Querverweise werden erstellt nach ~Wort~, ~wort~, aber nicht nach ~WORT~.
.3
Mehrmalige Markierung eines Wortes
HyperMake geht davon aus, da▀ Sie in einem Hypertext jedes Wort/jeden Ausdruck nur einmal markieren. Wenn er mehrmals markiert ist, erscheint er mehrmals im Index direkt untereinander und Querverweise werden an die erste markierte Stelle hin gezogen.
.3
Unterdrⁿcken von Querverweisen
.in omitting links
.in Unterdrⁿcken von Querverweisen
Querverweise werden natⁿrlich nicht gezogen, wenn sie auf das selbe Fenster (Kapitel) zeigen wⁿrden. Querverweise werden au▀erdem nicht gezogen, wenn der Ausdruck mehrmals im gleichen Absatz vorkommt. Also beispielsweise Punktbefehl Punktbefehl Punktbefehl - nur das erste Vorkommen von "Punktbefehl" im Absatz erhΣlt den Querverweis.
Wenn Sie lieber mehrfache Querverweise vom gleichen Ausdruck nicht nur in einem Absatz, sondern gleich im gesamten Fenster (Kapitel) unterdrⁿcken wollen, mⁿssen Sie in der Ini-Datei den Schalter "no more links in" von PARAGRAPH in WINDOW Σndern.
Es kann hin und wieder nⁿtzlich sein, bei bestimmten Schriften - etwa Beispielstext - Querverweise grundsΣtzlich zu unterdrⁿcken. Das erreichen Sie in der Ini-Datei mit dem Schalter Font, Parameter ~OmitLinks~.
Natⁿrlich ist es erlaubt, eine andere Schrift mit gleichen Einstellungen au▀er dem íOmitLinksí-Parameter zu definieren. Mit diesem Trick k÷nnen Sie Querverweise unterdrⁿcken, ohne wirklich die Schrift zu wechseln.
.IF IPFDOC
.3
Externe Querverweise bei IPF (external links)
╡:Externe Querverweise: sind Querverweise, die zu einem Kapitel eines anderen INF- oder HLP-Dokuments hin zeigen. Um solche externen Querverweise (external links) zu erzeugen, sind
╢ die Ini-Datei
╢ die Datei, zu deren Kapitel hin gesprungen werden soll (Sprungziel-Datei)
╢ die Datei, aus der heraus gesprungen werden soll (Sprungstart-Datei)
zu editieren.
Externe Querverweise nutzen die HyperMake Funktion der Erstellung von Panel ID's. Das Kapitel ⁿber Panel ID's mⁿssen Sie aber nicht extra lesen.
.snL
1. Ini-Datei
.sn
In der Ini-Datei mu▀ unter "Panel ID filename =" eine Bezeichnung beginnend mit *. eingetragen werden, also etwa
.snb
Panel ID filename = *.PAN
.sn
Der Dateiname der Quelldatei mit der Erweiterung PAN wird so zur Panel ID Datei, die HyperMake beim Kompilieren der Sprungziel-Datei automatisch erstellt. Diese Panel ID Datei verwendet HyperMake dann wiederum beim Kompilieren der Sprungstart-Datei.
.snL
2. Sprungziel-Datei
.sn
Beim Indizieren der ▄berschriften numeriert HyperMake die Kapitelⁿberschriften von eins fortlaufend durch. Da es unpraktisch wΣre, sich eine Nummer wie 237 zu merken und sich die Nummer eines bestimmten Kapitels schlie▀lich Σndert, wenn davor ein neues Kapitel eingeschoben wird, werden diese ID's (Identifikationsnummern) der Kapitelⁿberschriften durch verstΣndlichere Bezeichnungen wie íKapitel_Einleitungí ersetzt. Mit dem Befehl
.snb
.ID Kapitel_Einleitung
.sn
in der Sprungziel-Datei erhΣlt das Kapitel, wo der Punktbefehl steht, die Kurzbezeichnung "Kapitel_Einleitung", vgl. Datei BEISPIEL. Alle durch den ID-Punktbefehl deklarierten Kurzbezeichnungen speichert HyperMake in der Datei Quelldateiname.PAN oder einer anderen Erweiterung, je nach Eintrag in der Ini-Datei, ab. Auf diese Datei greift HyperMake dann zu, wenn die Sprungstart-Datei kompiliert wird.
.snL
3. Sprungstart-Datei
.sn
In der Datei, aus der gesprungen werden soll, wird der ID-Punktbefehl aus der Sprungziel-Datei wiederholt und darunter werden die gewohnten IN- und IV- (Index vertauscht) Punktbefehle gesetzt. Das ganze wird zwischen zwei neue EX-Punktbefehle plaziert.
.snb
.EX Dateiname.inf
.ID Kapitel_Einleitung
.IN Ausdruck
.EX
.sn
Hinter dem EXtern-Punktbefehl wird ein Dateiname angegeben, wobei sowohl die Erweiterung INF als auch HLP m÷glich ist. Alle folgenden ID, IN und IV-Befehle beziehen sich jetzt auf die externe Datei, bis .EX mit einem anderen Dateinamen oder ganz ohne Parameter dahinter geschrieben wird. Zwischen den beiden EX-Befehlen sollte kein Flie▀text stehen.
Alle in der Sprungstart-Datei gefundenen Ausdrⁿcke "Ausdruck" erhalten einen externen Querverweis zu dem Kapitel der Datei Dateiname.inf, das mit dem ID Punktbefehl ".ID Kapitel_Einleitung" gekennzeichnet ist.
Wo der .EX - .EX -Block in der Sprungstart-Datei steht, spielt ⁿberhaupt keine Rolle.
Pascal-Programmierer aufgepa▀t! Bei der Kurzbezeichnung hinter dem ID-Befehl wird íGro▀- und Kleinschreibung unterschieden!í
Beachten Sie die AktualitΣt der IPF-Dateien im Auge: bei einer ─nderung der Sprungziel-Datei mu▀ HyperMake erst die Sprungziel-Datei bearbeiten, so da▀ die Panel ID Datei den aktuellen Stand erhΣlt. Erst dann kann die Sprungstart-Datei kompiliert werden.
Bei der Angabe des Dateinamens
.snb
.EX Dateiname.inf
.sn
noch Pfade anzugeben, macht meist keinen Sinn, da sich die Datei bei verschiedenen Computern auf verschiedenen Pfaden und Laufwerken befinden kann. Wenn die Datei sich im gerade angemeldeten Pfad befindet, gibt es keine Probleme, auch nicht, wenn der Pfad bei SET BOOKSHELF der Datei CONFIG.SYS enthalten ist. Ist das jeweils nicht der Fall, sollten Sie Umgebungsvariablen verwenden.
Als Beispiel fⁿr externe Querverweise k÷nnen Sie Beispiel Externe Querverweise ausprobieren oder gleich hier auf die Worte Kanzler, SPD und CDU drⁿcken. Beim Erstellen dieses Hypertextes (also der Sprungstart-Datei) habe ich an einer beliebigen Stelle den folgenden Befehlsblock geschrieben:
.snb
.EX Beispiel.inf
.ID Kapitel_Kanzler
.IN Kanzler
.ID Kapitel_Parteien
.IN SPD
.IN CDU
.EX
.sn
.EX Beispiel.inf
.ID Kapitel_Kanzler
.IN Kanzler
.ID Kapitel_Parteien
.IN SPD
.IN CDU
.EX
In der Sprungziel Datei BEISPIEL finden sich in den Kapiteln ⁿber Kanzler und Parteien die zwei ID-Punktbefehle ebenfalls.
.END IPFDOC
.IF HTMLDOC
.3
Externe Querverweise bei HTML (external links)
Mit HyperMake k÷nnen Sie bestimmte W÷rter definieren, die grundsΣtzlich zu einer bestimmten ╡URL, also einer beliebigen Adresse im Internet, zeigen sollen. Wenn etwa alle W÷rter "Netscape" und "Netscape-Browser" auf die Netscape-Seite im Internet zeigen sollen, dann geben Sie dies wie folgt ein:
.snb
.URL http://home.netscape.com
.IN Netscape
.IN Netscape-Browser
.LOCAL
.sn
.URL http://home.netscape.com
.IN Netscape
.IN Netscape-Browser
.LOCAL
Achten Sie darauf, da▀ die gewohnten IN-Befehle zwischen einem URL-Befehl und einem LOCAL-Befehl quasi eingeklammert werden: Bevor normaler Text folgt, mu▀ also ein LOCAL-Befehl geschrieben werden. Es ist sinnvoll, z. B. am Anfang des Textes sΣmtliche externe Links zu konzentrieren.
.END HTMLDOC
.IF IPFDOC
.3
Programme per Querverweis starten (launching programs, nur IPF)
.in Programme starten
.in Starten von Programmen
.in launching programs
─hnlich wie externe Querverweise kann auf externe Programme verwiesen werden, k÷nnen also externe Programme gestartet werden.
.snb
.EX mppm.exe c:\mmos2\movies\macaw.avi
.IN Papagei
.EX e.exe BEISPIEL.TXT
.IN Datei BEISPIEL
.EX
.sn
.EX mppm.exe c:\mmos2\movies\macaw.avi
.IN Papagei
.EX e.exe BEISPIEL.TXT
.IN Datei BEISPIEL
.EX
.sao
Der Papagei ist ein Vogel. (Der Querverweis "Papagei" ist nur dann aktiv, wenn Sie OS/2 Multimedia installiert haben.) Der Querverweis zur Datei BEISPIEL, bei dem der Systemeditor gestartet wird, ist Ihnen vielleicht schon im vorangegangenen ~Kapitel~ aufgefallen.
Drⁿckt der Benutzer auf "Papagei" oder "Datei BEISPIEL", wird das entsprechende externe Programm gestartet. Im EX-Punktbefehl sind die Parameter hinter dem Programmnamen optional. Programmname und Parameter sind durch ein Leerzeichen getrennt. Die Erweiterung ~.EXE~ ímu▀í angegeben werden! Es k÷nnen natⁿrlich auch Batchdateien mit der Endung ~.CMD~ oder DOS-Dateien mit der Endung ~.BAT~ oder ~.COM~ gestartet werden.
Wenn Daten nicht bei jedem Benutzer in einem bestimmten Pfad, z. B. C:\MMOS2\MOVIES, zu finden sind, mⁿssen Umgebungsvariablen verwendet werden.
Sie k÷nnen einem EX-Punktbefehl auch mehrere IN-Punktbefehle folgen lassen, etwa um sowohl bei "Papagei" als auch bei "Papageienfilm" den Film starten zu lassen.
Damit eine Bezeichnung wie "CONFIG.SYS" oder "Eule (Film)" einen Querverweis bekommt, mⁿssen Punkt bzw. Klammern in der Ini-Datei unter extended letters aufgefⁿhrt sein.
.4
Umgebungsvariablen
.in Umgebungsvariable
Bei externen Querverweisen und beim Starten von Programmen k÷nnen Umgebungsvariablen sehr ratsam sein.
Beim Verwenden einer INF-Datei auf verschiedenen Rechnern sollten bestimmte Datenpfade durch Umgebungsvariablen ersetzt werden, etwa %MMVIDEO%. Jeder Rechner, der Ihren Hypertext benutzt, sollte dann in der Datei CONFIG.SYS z. B. folgenden Eintrag haben:
.snb
SET MMVIDEO=C:\MMOS2\MOVIES
.sn
Im HyperMake-Quelltext schreiben Sie dann:
.snb
.EX mppm.exe %MMVIDEO%\macaw.avi
.IN Papagei
.EX
.sn
OS/2 ersetzt dann den Ausdruck %MMVIDEO% gegen den in der CONFIG.SYS angegebenen Laufwerks- und Pfadnamen.
Genauso k÷nnen Sie bei externen Querverweisen verfahren.
In den FΣllen, wo die Pfadbezeichnung mit einem Strichpunkt endet, etwa
.snb
SET MMBASE=C:\MMOS2;
.sn
funktioniert allerdings die Umgebungsvariable nicht mehr und der Querverweis wird nicht gezogen.
.EX view.exe cmdref.inf
.IN OS/2-Referenzhandbuch
.EX
Zum Thema Umgebungsvariablen k÷nnen Sie auch unter "SET" im OS/2-Referenzhandbuch nachschlagen.
.END IPFDOC
.2
Duplizierung von Kapitelⁿberschriften
.in Duplizierung von Kapitelⁿberschriften
Es ist hΣufig erforderlich, die Kapitelⁿberschrift als Querverweis-Ziel zu deklarieren, in den Index aufzunehmen und - insbesondere bei IPF relevant - im Textfenster mit gr÷▀erer oder farbiger Schrift zu wiederholen:
.snb
.3
Kapitelⁿberschrift
.IN Kapitelⁿberschrift
.snX
Kapitelⁿberschrift
.sn
.sn
Diese Tipparbeit kann man sich sparen. Mit dem Punktbefehl DuPliziere
.snb
.dpX
.sn
wird die Kapitelⁿberschrift zu Beginn des Flie▀textes in Schrift C dupliziert, d.h. wiederholt, und zwar in íallení Gliederungsebenen.
.IF INFDOC
Besonders vorteilhaft ist dies bei sehr langen ▄berschriftstexten, da bei INF-Dateien in der Fensterleiste meist nur die ersten 70 Buchstaben Platz finden.
.END
Mit Hilfe der Einstellung Index Filter in der Ini-Datei k÷nnen bestimmte Zeichen im Stichwortverzeichnis und bei der Duplizierung von Kapitelⁿberschriften unterdrⁿckt werden.
.snb
.dp34X
.sn
fⁿhrt die Duplizierung nur fⁿr Gliederungshierarchie 3 und 4 aus.
.snb
.dp-
.sn
deaktiviert die Duplizierungs-Funktion ⁿber alle Gliederungsebenen.
.snb
.dp-234
.sn
deaktiviert die Duplizierungs-Funktion in den Gliederungsebenen 2, 3 und 4.
.snb
.dp#
.sn
verwendet den ▄berschrifts-Text als Querverweis-Ziel; die Wiederholung des Kapitelⁿberschrifts-Textes im .IN -Punktbefehl kann man so sparen. Statt # lΣ▀t sich auch das Stichwortzeichen aus der Ini-Datei verwenden.
.snb
.dp##
.sn
nimmt den ▄berschrifts-Text nicht nur als Querverweis-Ziel, sondern zusΣtzlich noch im Index auf. Diese Funktion sollte nur mit Bedacht gewΣhlt werden, da die Information sowohl im Index als auch im Inhaltsverzeichnis auftaucht, also redundant ist.
.IF IPFDOC
▄brigens kann ein gro▀er Index eine INF-Datei bei der Benutzung des Index sehr langsam machen.
.END
.snb
.dp3##X,
.3
Meier, Fritz
.sn
im Flie▀text wird "Fritz Meier" dupliziert, das ist auch das Querverweis-Ziel. Im Index, im Inhaltsverzeichnis und als Fenster-▄berschrift erscheint aber "Meier, Fritz".
Die Parameter hinter ".DP" k÷nnen beliebig kombiniert werden, wobei die Reihenfolge egal ist.
.3
Beispiel Duplizierung Kapitelⁿberschriften - Quelltext
.snz
.fa verti 30
.dp4R#,
.3
Beispiel Duplizierung Kapitelⁿberschriften - Ergebnis
Bundeskanzler seit 1949
(CDU, SPD und Kanzler sind externe Querverweise. Schrift R ist in Ini-Datei definiert.)
.4
Adenauer, Konrad
1949-1963, CDU, war der erste Kanzler nach dem zweiten Weltkrieg. Ihm folgte Ludwig Erhard.
.4
Erhard, Ludwig
1963-1966, CDU, Nachfolger von Konrad Adenauer. Zweiter Kanzler der Bundesrepublik. Ihm folgte Kurt Georg Kiesinger.
.4
Kiesinger, Kurt Georg
1966-1969, dritter Kanzler der CDU, leitete die gro▀e Koalition von CDU und SPD. Nachfolger von Ludwig Erhard.
.4
Brandt, Willy
1969-1974, erster Kanzler der SPD.
.4
Schmidt, Helmut
1974-1982, Kanzler der SPD aus den Siebzigern. Nachfolger von Willy Brandt.
.4
Kohl, Helmut
amtierender Kanzler der CDU seit 1982. Nachfolger von Helmut Schmidt.
.sn
.fa verti 30
.3
Beispiel Duplizierung Kapitelⁿberschriften - Ergebnis
.in Beispiel Duplizierung von Kapitelⁿberschriften
.in Beispiel Externe Querverweise
.dp4R#,
Bundeskanzler seit 1949
(CDU, SPD und Kanzler sind externe Querverweise. Schrift R ist in Ini-Datei definiert.)
.4
Adenauer, Konrad
1949-1963, CDU, war der erste Kanzler nach dem zweiten Weltkrieg. Ihm folgte Ludwig Erhard.
.4
Erhard, Ludwig
1963-1966, CDU, Nachfolger von Konrad Adenauer. Zweiter Kanzler der Bundesrepublik. Ihm folgte Kurt Georg Kiesinger.
.4
Kiesinger, Kurt Georg
1963-1966, dritter Kanzler der CDU, leitete die gro▀e Koalition von CDU und SPD. Nachfolger von Ludwig Erhard.
.4
Brandt, Willy
1969-1974, erster Kanzler der SPD.
.4
Schmidt, Helmut
1974-1982, Kanzler der SPD aus den Siebzigern. Nachfolger von Willy Brandt.
.4
Kohl, Helmut
amtierender Kanzler der CDU seit 1982. Nachfolger von Helmut Schmidt.
.2
Linienziehen
.in Zeichen fⁿr Linienziehen
Da das ╡Linienziehen zur Erstellung von Umrandungen und Tabellen normalerweise eine recht aufwendige Angelegenheit ist, gibt es einen Punktbefehl, der Ihnen die Arbeit sehr erleichtert, wie Sie im folgenden Beispiel sehen werden:
.snb
.LIXY
X X
Operating systems
Y Y X X
Novell IBM Hardware
Y Y X X
DOS Netware OS/2
X X
.LI
.sn
Und Sie erhalten:
.snb
.LIXY
X X
Operating systems
Y Y X X
Novell IBM Hardware
Y Y X X
DOS Netware OS/2
X X
.LI
.sn
.sab
Innerhalb des Punktbefehls ~.LIXYZ~ steht X fⁿr das Zeichen, welches die Ecken eines Rechtecks markiert und Y fⁿr den Beginn einer Unterteilung. Ein vorangestelltes Zeichen Z ergibt Doppelstriche (nur IPF). Verwenden Sie fⁿr X, Y und Z Zeichen, die sie sonst in der Liniengraphik nicht ben÷tigen.
Die standardmΣ▀ig eingestellte Schrift fⁿr Linienziehen k÷nnen Sie in der Ini-Datei bei den Schriften (Font) verstellen, und zwar mit dem Parameter ~LineStandard~.
.IF IPFDOC
Kombinierte Einfach/Doppel-Striche werden nur mit Codepage 437 unterstⁿtzt. Falls Sie andere Codepages verwenden mⁿssen, verwenden Sie bitte keine Doppelstriche.
.END
.IF WORDSTARDOC
.3
Linienziehen und WordStar
Das Zeichen Z im ~.LIXYZ~-Befehl zur Erstellung von Doppelstrichen mu▀ ein ^P-Steuerzeichen sein (z. B. ^PE oder ^PR). Verwenden Sie den ^OD-Umschalter, um die ^P-Steuerzeichen unsichtbar zu machen; so k÷nnen Sie die korrekte Ausrichtung des Rechtecks ⁿberprⁿfen.
.END
.2
Fu▀noten
.in Fu▀note
Die Erstellung von Fu▀noten geht mit HyperMake sehr leicht. Fu▀noten dⁿrfen etwa in Klammern geschrieben werden wie {Inhalt der Fu▀note}, nachdem Sie den Punktbefehl íFU▀notení verwendet haben:
~.FU{}~
Statt den Klammern und dem Fu▀noteninhalt erscheint nur ein Sternchen[Inhalt der Fu▀note], auf das Sie mit der Maus drⁿcken k÷nnen.
.fu{}
Andere brauchbare Fu▀notenzeichen sind [ ], < > oder ▄ (Alt-220) ▀ (Alt-223) - sozusagen fette GΣnsefⁿ▀chen (bei IBM codepage).
.fu[]
.IF HTMLDOC
Sie k÷nnen fⁿr das HTML-Fu▀notenfenster eine andere Schrift wΣhlen:
~.FU{}snX~
Fⁿr das HTML-Fu▀notenfenster wird dann Schrift X verwendet.
Mit dem Befehl íFu▀noten Sizeí
~.FS 30~
k÷nnen Sie die Gr÷▀e des Fu▀notenfensters in Prozent verstellen. Standard ist 15 Prozent. Dieser Befehl mu▀ vor einem neuen Kapitel, das die geΣnderte Fensteraufteilung haben soll, aktiviert werden.
.END
Die Fu▀notenfunktion kann zwischendurch auch wieder ausgeschaltet werden, indem keine Parameter dahinter geschrieben werden:
~.FU~
oder Sie k÷nnen zwischendurch auch andere Fu▀notenzeichen definieren. StandardmΣ▀ig sind gar keine Fu▀notenzeichen definiert.
Wenn Sie statt einem "*" als Knopf zur Aktivierung des Fu▀notenfensters einen anderen Text haben wollen, k÷nnen Sie dies mit dem Punktbefehl íFu▀noten Textí Σndern:
~.FT XXX~
Statt einem Sternchen erscheint dann der Text "XXX". Sie dⁿrfen dabei auch eine Grafik statt Text verwenden:
.snb
.BT& Dateiname
.FT&
.sn
(siehe Grafiken)
.FA hori 30
.2
RΣnder und Formatierung
.in Rand
.in margin
.3
Linken Rand verstellen
Das ist ein Beispielstext mit linkem Rand 1.
.LM10
Dies ist ein Beispielstext mit linkem Rand 10; beachten Sie, da▀ die Einrⁿckung auch in den folgenden Zeilen korrekt ist.
.LM20
Dies ist ein Beispielstext mit linkem Rand 20; beachten Sie, da▀ die Einrⁿckung auch in den folgenden Zeilen korrekt ist.
.LM1
Der linke Rand lΣ▀t sich mit dem Punktbefehl íLeft Marginí (linker Rand) verstellen:
~.LM n~
n steht fⁿr eine Zahl von 1 bis ca. 30; der Standardwert ist 1.
Wenn ~.LM~ ohne Zahl eingegeben wird, wird auf den Standardwert 1 geschaltet.
.IF HTMLDOC
HTML ist nicht in der Lage, den linken Rand in feinen Schritten zu verΣndern. HyperMake simuliert die Verstellung des linken Randes unter Verwendung der HTML definition list. Das hat zur Folge, da▀ der Rand nur in Fⁿnferschritten geΣndert werdn kann. Left Margin 1 und 2 hat gar keine Wirkung, 4 bis 8 stellt ihn auf ca. 5 (abhΣngig vom Browser), 9 bis 13 auf 10 usw.
.END
.IF WORDSTARDOC
Beim DOS WordStar mⁿssen weiche Leerzeichen statt dem Punktbefehl verwendet werden.[Der WordStar-Punktbefehl .LM generiert solche weichen Leerzeichen automatisch. HyperMake interpretiert nicht den LM-Befehl selbst, sondern nur die darⁿber erzeugten weichen Leerzeichen. Genauso k÷nnen Sie weiche Leerzeichen durch Tabulatoren (^OL) und der Absatzeinrⁿckung (^OG) generieren; beim nachtrΣglichen Formatieren werden weiche Leerzeichen mit ^OG ^B erzeugt.]
.END
.3
Formatierung aus- und einschalten
.IF IPFDOC
.in Formatierung
Bei Erstellung von IPF-Dateien lΣ▀t sich mit den Punktbefehlen íFormatierung ausí und íFormatierung aní
.snb
.FM aus
.sn
.snb
.FM an
.sn
der automatische Zeilenumbruch aus- und wieder einschalten. StandardmΣ▀ig ist die Formatierung eingeschaltet. Aus bedeutet, da▀ die Formatierung (Zeilenvorschⁿbe) so bleiben wie im Quelltext. Die Einstellung gilt bis zum nΣchsten Formatierungs-Befehl, selbst ⁿber Kapitelⁿberschriften hinweg.
Beim Linienziehen ist die Formatierung automatisch ausgeschaltet.
Verwenden Sie nicht Index/Querverweise, wenn Formatierung ausgeschaltet ist.[Und zwar wegen einem Fehler im IPFC 2.0 Compiler. Die EintrΣge im Index wⁿrden ein ASCII-10-Zeichen am Ende erhalten.] Klammern Sie in diesem Fall Index-Punktbefehle zwischen zwei Formatierungsbefehle ein:
.snb
.fm an
.in Wort1
.in Wort2
.fm aus
.sn
.END IPFDOC
.IF HTMLDOC
Fⁿr HTML-Dateien gibt es keine Punktbefehle zum Ein- und Ausschalten des Zeilenumbruches. Wenn Sie einen Text nicht formatiert haben wollen, mⁿssen Sie eine Schrift mit Phrase Element PRE verwenden.
.END
.IF IPFDOC
Bei IPF k÷nnen Sie bei Festlegung der Schrift ~PRE~ in der Ini-Datei deklarieren, Sie k÷nnen sich die eigenen Punktbefehle dann sparen.
.END
.3
Zentrierter Text
.in zentrierter Text
Bei zentriertem Text ist die Formatierung immer ausgeschaltet. Zentrierten Text kann man ein- und ausschalten mit dem Punktbefehl í╡:Output Centered;í
.snb
.OC an
.OC aus
.sn
Sie k÷nnen aber auch bei Festlegung der Schrift ~center~ schreiben, die eigenen Punktbefehle k÷nnen Sie dann sparen.
.3
Automatischer Rand (auto margin)
.in definition list
.sv automatischer Rand
Sie k÷nnen (z. B. fⁿr Definitions-Listen) den linken Rand zwischendurch mit Hilfe von Leerzeichen verΣndern.
.snb
*Motherboard*
Auf dem Motherboard befinden sich der Hauptprozessor, die RAM Speicherchips
und einige weitere wichtige Teile des Computers.
*Bildschirm*
Computer-Bildschirme gibt es mit Gr÷▀en von 14 bis 21
Zoll; Am Bildschirm sollte am wenigsten gespart werden.
.sn
⌐Motherboard⌐
Auf dem Motherboard befinden sich der Hauptprozessor, die RAM Speicherchips und einige weitere wichtige Teile des Computers.
⌐Bildschirm⌐
Computer-Bildschirme gibt es mit Gr÷▀en von 14 bis 21 Zoll; Am Bildschirm sollte am wenigsten gespart werden.
Mit dem Punktbefehl í╡:Auto Margin:í (autom. Rand) lΣ▀t sich diese Interpretation von Leerzeichen am Zeilenanfang abschalten und wieder einschalten:
.snb
.AM aus
.AM an
.sn
Die Standardeinstellung ist ían.í.
Man kann den AM Befehl in normalen Flie▀text auf íaní lassen. Wird die erste Zeile eines Absatzes eingerⁿckt, Σndert das den Rand fⁿr den einen Absatz. Sie mⁿssen den AM Befehl nur dann unbedingt auf íausí stellen, wenn Sie nur die erste Zeile eines Absatzes eingerⁿckt haben m÷chten.
Wenn Sie einen ≈ASCII-Editor mit ASCIIHARDRET≈ verwenden, so sollte die Einrⁿckung nur am Absatzanfang sein; die folgenden Zeilen, die vom Editor umgebrochen werden, dⁿrfen keine Leerzeichen am Anfang erhalten.
.IF WORDSTARDOC
≈WordStar≈-Dateien brauchen die Auto Margin Funktion gar nicht.[Sie k÷nnen im WordStar jederzeit mit ^OG und weichen Leerschritten den linken Rand beeinflu▀en.]
.END
.2
If-Bedingungen
.in If-Bedingung
Mit Hilfe von If-Bedingungen lassen sich fⁿr z. B. Σhnliche Programmversionen leicht unterschiedliche IPF- bzw HTML-Dateien aus dem selben Quelltext erstellen. Hierfⁿr gibt es drei neue Punktbefehle:
.snb
.IF BEDINGUNG
.ELSE
.END
.sn
Die Gro▀- oder Kleinschreibung der Bedingungen ist dabei egal. Der ELSE-Befehl ist natⁿrlich optional.
Zum Kompilieren des Quelltextes wird in der Kommandozeile z. B. eingegeben:
.snp
.fu
[C:\myProject] HMAKE MeinDoku.txt #BEDINGUNG
.fu[]
.sn
Es k÷nnen auch mehrere Bedingungen in die Kommandozeile eingegeben werden. Entscheidend ist das # Zeichen, nicht die Reihenfolge.
IF bedeutet "wenn", ELSE bedeutet "andernfalls". Mit END endet die If-Bedingung.
Mehrere Bedingungen in der If-Bedingung (verknⁿpft mit AND oder OR) werden ínichtí unterstⁿtzt.
StandardmΣ▀ig sind die Bedingungen #HTML bzw. #IPF gesetzt.
.1
Erstellung von Helptables
.IF HLPDOC
.in Helptable
.in Panel ID
Das wichtigste Merkmal einer HLP-Datei gegenⁿber einer INF-Datei ist die Verbindung von HLP-Dateien zu PM-orientierten Programmen. INF-Dateien treten alleine auf, HLP-Dateien nur in Verbindung mit einem Programm, das durch die HLP-Datei erklΣrt werden soll. In HLP-Dateien lassen sich Verbindungen zwischen Programmfenstern oder Programmkn÷pfen zu Kapiteln des Hypertexts herstellen. Drⁿckt man bei einem solchen Programm auf den fraglichen Knopf und gleichzeitig F1, wird der HLP-Text mit dem entsprechenden Kapitel aufgerufen.
Es gibt zwei verschiedene Arten solcher Verbindungen (engl. links):
╢ Verbindungen ⁿber Helptables
╢ direkte Verbindungen ⁿber Panel ID's.
Helptable-Verbindungen werden durch gleichzeitiges Drⁿcken von F1 mit dem entsprechenden Knopf (oder Menⁿpunkt) aktiviert; statt F1 kann man auch auf einen speziellen Hilfe-Knopf drⁿcken, dessen Flags BS_HELP | BS_NOPOINTERFOCUS gesetzt sind. Im Helptable ist eingetragen, welche Kn÷pfe / Menⁿpunkte zu welchen Kapiteln des Hypertext verbunden sind.
Direkte Verbindungen laufen nicht ⁿber einen Helptable, vielmehr verwenden sie direkt eine Funktion im Programm-Quelltext, die ein bestimmtes Kapitel aufruft; solche direkte Verbindungen k÷nnen auch bei textorientierten Programmen zum Einsatz kommen.
Ohne HyperMake mⁿ▀te also eine Helptable-Datei innerhalb der RC-Datei [Programmierer sollten RC-Dateien kennen; sonst k÷nnen Sie dieses Kapitel ⁿberspringen, da nur INF-Dateien fⁿr Sie in Frage kommen.] erstellt werden. Fⁿr direkte Verbindungen mⁿ▀te eine Panel ID header-Datei mit den IPF-internen Kapitel (resource) ID's angelegt werden, assoziiert mit ausdrucksstarken Bezeichnern wie (Panel_Einfuehrung).
.2
Erstellen des HyperMake Quelltextes
.in ressource connection
Im HyperMake Quelltext werden zwei neue Punktbefehle verwendet: íRessource Connectioní
.snb
.RC ID_window, ID_button_or_Menu_Item
.sn
bedeutet, da▀ wenn der Knopf "ID_button_or_Menu_Item", der sich im Kindfenster "ID_Window" befindet, zusammen mit F1 gedrⁿckt wird, das Kapitel aufgerufen wird, wo der RC-Befehl plaziert ist.
.sab
~ID_window~ ist die Konstante, die hinter íMENUí oder íDIALOGí in der RC-Datei steht.
íAchtung:í ~ID_window~ ist ⌐nicht⌐ die Konstante, die hinter íDLGTEMPLATEí steht.[Wenn Sie hinter DLGTEMPLATE und DIALOG die gleiche Konstante verwenden, ist das schon in Ordnung.]
Und mit íPanel IDí
.snb
.ID Kapitel_Name
.sn
wird dem Kapitel, wo dieser Punktbefehl steht, die Kurzbezeichnung "Kapitel_Name" gegeben. Mit dem Aufruf von DisplayHelpPanel(Kapitel_Name) im Programm-Quelltext kann dieses Kapitel direkt aufgerufen werden.
Pascal-Programmierer aufgepa▀t! Bei der Kurzbezeichnung hinter dem ID-Befehl wird íGro▀- und Kleinschreibung unterschieden!í
Sie k÷nnen diese Punktbefehle irgendwo innerhalb des Kapitels verwenden, zu dem die Verbindung hergestellt werden soll. Ich empfehle jedoch, diese Befehle m÷glichst nah an die Stelle des Kapitels zu setzen, wo der entsprechende Knopf bzw. Menⁿpunkt erklΣrt wird. Das hat den Vorteil, da▀ wenn Sie spΣter das Kapitel in mehrere Unterkapitel aufteilen, automatisch die Verbindung zum neuen Unterkapitel hergestellt wird - ohne da▀ die RC- und IC-Punktbefehle an eine andere Stelle gesetzt werden mⁿssen.
Wenn Sie den RC-Punktbefehl verwenden, mⁿssen Sie normalerweise zwei ID's eingeben: Die erste fⁿr das Programmfenster, in dem sich der Knopf/Menⁿpunkt befindet[zu verwenden ist der Konstanten-Name, der in der RC-Datei hinter MENU oder DIALOG steht], und die zweite fⁿr die ID des Knopfes, Menⁿpunktes, Eingabefelds usw. (engl. item).
Wenn viele Items aus dem gleichen Programmfenster angegeben werden, mu▀ man nicht die letzte Window ID wiederholen:
.snb
.RC , ID_button_or_Menu_Item
.sn
Vor dem Komma wird die letzte Window ID eingesetzt.
Die HLP-spezifischen RC- und ID-Befehle haben nur Auswirkung auf die Helptable- und Panel-ID-Datei, die IPF-Datei wird dadurch nicht beeinflu▀t. Das bedeutet, Sie k÷nnen bedenkenlos aus solch einer IPF-Datei eine INF-Datei statt einer HLP-Datei erstellen.
Fⁿr jede Window ID sollten Sie den RC-Befehl ohne Angabe eines Items, also mit nur einem Parameter, verwenden. Alle Items eines solchen Windows, die keinen eigenen RC-Befehl haben, erhalten die Verbindung, die im RC-Befehl mit nur einem Parameter festgelegt ist. Wenn Sie den RC-Befehl allein mit zwei Parametern verwenden, gibt HyperMake eine Warnung aus.
.in Helptable-Datei
Der folgende HyperMake Quelltext enthΣlt die zwei neuen Punktbefehle íRessource connectioní und íPanel ID:í
.snz
.1
Einfⁿhrung
.RC ID_Kindfenster
.ID PANEL_Einfuehrung
Das ist die Dokumentation von meinem Programm.
.1
Verwendung des OK-Knopfes
.RC ID_Kindfenster, ID_OK
.ID PANEL_OK_Benutzung
Mit dem OK-Knopf - stellen Sie sich nur vor - k÷nnen Sie OK drⁿcken.
.1
Verwendung des Cancel-Knopfes
.RC ID_Kindfenster, ID_Cancel
Mit dem Cancel-Knopf k÷nnen Sie den Befehl abbrechen.
.sn
.2
Einbindung in den C Programm-Quelltext
HyperMake erstellt automatisch eine Datei íHLPTABLE.RCí:
HELPSUBITEM ID_Cancel, 3 // Verwendung des Cancel-Knopfes
}
.sn
HyperMake erstellt au▀erdem eine Datei íPANELID.Hí:
.snb
/*****Panel ID's created by HyperMake*****/
#define PANEL_Einfuehrung 1
#define PANEL_OK_Benutzung 2
.sn
Die Nummern 1, 2 und 3 sind die IPF-internen Kapitel-ID's, die fⁿr den HyperMake-Benutzer ohne Belang sind. In der Helptable-Datei werden deshalb noch als Kommentar die Kapitelⁿberschriften eingetragen, so da▀ sich die Helptable-Datei fⁿr die Fehlersuche leichter lesen lΣ▀t. (Normalerweise dⁿrften Sie kein Interesse haben, die Helptable und Panel ID -Datei zu lesen.)
Den Startwert fⁿr die in der Helptable-Datei verwendeten Subtable ID's k÷nnen Sie in der Ini-Datei unter der Einstellung ~Help Subtable Start ID~ Σndern, au▀erdem k÷nnen Sie auch die Dateinamen der zwei erstellten Dateien Σndern.
Die Helptable-Datei und Panel ID -Datei wird einfach in den Programm-Quelltext eingebunden:
.snb
#include "HLPTABLE.RC"
.sn
etwa nach einem MENU oder DLGTEMPLATE-Block in der RC-Datei und
.snb
#include "PANELID.H"
.sn
zu Beginn des Programmtextes (eine C- oder CPP-Datei).
In der eigentlichen header-Datei progname.h mⁿssen Sie eine Konstante íHELP_TABLEí mit irgendeinem unbenutzten Wert definieren, z. B.
~#define HELP_TABLE 7000~
Diese Konstante mu▀ in der RC- und in der C bzw. CPP-Datei gⁿltig sein.
Im C Quelltext ben÷tigt man mindestens zwei Funktionen:
.snb
void InitHelp (hwnd) /*initialisiert den Help-Proze▀*/
void DestroyHelp () /*deaktiviert ihn*/
.sn
diese verwenden die Konstante HELP_TABLE.
Der Funktion InitHelp mu▀ der window handle des Programms ⁿbergeben werden. Dieser mu▀ natⁿrlich schon definiert worden sein. Wenn Sie kein Standardwindow sondern nur eine Dialogbox als Programm haben, k÷nnen Sie íInitHelpí unter WM_INITDLG und íDestroyHelpí unter WM_CLOSE aufrufen. Sonst rufen Sie die beiden Funktionen im Hauptprogramm vor und nach der Window-Message-Schleife ~while WinGetMsg...~ auf.
Eine dritte Funktion
.snb
void DisplayHelpPanel (PanelID)
.sn
wird ben÷tigt, um eine direkte Verbindung zwischen dem Programm und einem Hypertext-Kapitel herzustellen. Es ist die Programm-Seite des Panel ID Punktbefehls, den Sie im HyperMake Quelltext verwenden.
Ich habe eine kompakte Version dieser drei Funktionen geschrieben. Um sie kompilieren zu k÷nnen, mⁿssen Sie am Anfang folgendes eintragen:[Das kann Compiler-spezifisch sein; ich benutze Borland C]
.snb
#define INCL_HELP
.sn
.3
C Quelltext fⁿr die drei Hilfe-functions
.snb
.in function InitHelp
.in function DestroyHelp
.in function DisplayHelpPanel
#define HelpFilename "FILENAME.HLP"
#define HelpWindowTitle "▄berschrift des Hypertext-Fensters"
HELPSUBITEM ID_OK, 2 /* Verwendung des OK-Knopfes */
HELPSUBITEM ID_Cancel, 3 /* Verwendung des Cancel-Knopfes */
END
.sn
HyperMake erstellt au▀erdem eine Datei íPANELID.Hí:
.snb
{ Panel ID's created by HyperMake }
const
PANEL_Einfuehrung = 1;
PANEL_OK_Benutzung = 2;
.sn
Die Nummern 1, 2 und 3 sind die IPF-internen Kapitel-ID's, die fⁿr den HyperMake-Benutzer ohne Belang sind. In der Helptable-Datei werden deshalb noch als Kommentar die Kapitelⁿberschriften eingetragen, so da▀ sich die Helptable-Datei fⁿr die Fehlersuche leichter lesen lΣ▀t. (Normalerweise dⁿrften Sie kein Interesse haben, die Helptable und Panel ID -Datei zu lesen.)
Den Startwert fⁿr die in der Helptable-Datei verwendeten Subtable ID's k÷nnen Sie in der Ini-Datei unter der Einstellung ~Help Subtable Start ID~ Σndern, au▀erdem k÷nnen Sie auch die Dateinamen der zwei erstellten Dateien Σndern.
Die Helptable-Datei und Panel ID -Datei wird einfach in den Programm-Quelltext eingebunden:
.snb
{$I HLPTABLE.RC}
.sn
etwa nach einem MENU oder DLGTEMPLATE-Block in der RC-Datei und
.snb
{$I PANELID.INC}
.sn
zu Beginn des Programmtextes (eine PAS-Datei).
Es gibt nun erst einmal zwei Funktionen, mit denen Sie die HLP-Datei aufrufen k÷nnen.
.snb
DisplayHelpPanel (PanelID)
.sn
wird ben÷tigt, um eine direkte Verbindung zwischen dem Programm und einem Hypertext-Kapitel herzustellen. Es ist die Programm-Seite des Panel ID Punktbefehls, den Sie im HyperMake Quelltext verwenden.
.snb
SendHelpMessage (HM_HELP_CONTENTS)
.sn
ruft direkt das Inhaltsverzeichnis auf. Es gibt noch weitere HM_*-Konstanten, die bei SpeedPascal in der Unit PMHELP.PAS definiert sind.
Die weitere Einbindung in den Programmtext hΣngt davon ab, ob Sie die SpeedPascal 1.5 OPML verwenden oder nicht.
.3
Einbindung der Hilfefunktion bei Benutzung der OPML
Einbindung der Hilfefunktion auf konventionelle Weise
Zum Aktivieren und Deaktivieren der Hilfe-Funktion ben÷tigen Sie zwei Funktionen:
.snb
uses PMHELP;
InitHelp (hwnd); {initialisiert den Help-Proze▀}
DestroyHelp; {deaktiviert ihn}
.sn
Diese beiden Prozeduren sind ab SpeedPascal 1.5 in der Unit PMHELP definiert.
Der Prozedur InitHelp mu▀ der window handle des Programms ⁿbergeben werden. Dieser mu▀ natⁿrlich schon definiert worden sein. Wenn Sie kein Standardwindow sondern nur eine Dialogbox als Programm haben, k÷nnen Sie íInitHelpí unter WM_INITDLG und íDestroyHelpí unter WM_CLOSE aufrufen. Sonst rufen Sie die beiden Funktionen im Hauptprogramm vor und nach der Window-Message-Schleife ~while WinGetMsg...~ auf.
Unmittelbar vor der Prozedur "InitHelp" mu▀ noch Variablen gesetzt werden:
.snb
HelpFilename := 'MYPROG.HLP';
HelpWindowTitle := '▄berschrift des Hypertext-Fensters';
HELP_TABLE := 1000;
.sn
Die Zahl 1000 kommt ebenfalls im HyperMake erstellten Helptable vor.
Falls Sie kein SpeedPascal 1.5 (oder spΣter) benutzen, habe ich die relevanten Variablen und Prozeduren zusammengestellt.
if ((hwndHelpInstance = 0 )OR(hini.ulReturnCode<>0)) THEN
BEGIN
InfoBox('Failed to load help manager.');
exit;
END;
{ Associate help instance with main frame }
if not WinAssociateHelpInstance(hwndHelpInstance, hwndClientFrame) THEN
BEGIN
InfoBox('Failed to load help manager.');
exit;
END;
{ Help manager is successfully initialized so set flag to TRUE }
fHelpEnabled := TRUE;
END;
{wird hinter die Hauptprogramm-Message-Schleife gesetzt}
PROCEDURE DestroyHelp;
BEGIN
IF hwndHelpInstance <> 0 THEN WinDestroyHelpInstance(hwndHelpInstance);
END;
{
einige m÷gliche Parameter fⁿr SendHelpMessage
HM_HELP_INDEX zeigt Index
HM_HELP_CONTENTS, zeigt Inhalt
HM_DISPLAY_HELP zeigt Hilfe fⁿr Hilfefunktion (help for help)
}
PROCEDURE SendHelpMessage (HelpMessage:LONG);
BEGIN
if fHelpEnabled THEN
if WinSendMsg(hwndHelpInstance, HelpMessage, 0, 0)<>0
then InfoBox ('Failed to display help panel.');
END;
{
Parameter sind die Panel ID's, definiert ⁿber die ID Punktbefehle
im HyperMake Quelltext
}
PROCEDURE DisplayHelpPanel (PanelID:LONG);
BEGIN
if fHelpEnabled then
if WinSendMsg(hwndHelpInstance, HM_DISPLAY_HELP,
MPFROMLONG(MAKELONG(PanelID, 0)),
MPFROMSHORT(HM_RESOURCEID))<>0
then InfoBox ('Failed to display help panel.');
END;
.sn
.2
Mehrere verschiedensprachige HLP-Dateien
Falls Sie mehrere verschiedensprachige HLP-Dateien und nur eine EXE-Datei erstellen, reicht es aus, wenn Sie die ID- und RC-Punktbefehle in nur einem HyperMake-Quelltext eintragen. Wenn Sie dann im anderssprachigen HyperMake-Quelltext íexaktí die gleiche Gliederungsstruktur haben, gibt es keine Probleme. HyperMake numeriert nΣmlich die Kapitelⁿberschriften einfach fortlaufend durch.
.ELSE
Das IBM IPF-Format wird ben÷tigt, um kontextsenitive Programmdokumentationen (Erweiterung HLP) unter dem Betriebssystem OS/2 zu erstellen. HyperMake stellt hier fⁿr die Verbindung Hypertext - EXE-Programm einige Funktionen zur Verfⁿgung. Die Dokumentation darⁿber ist aber nur vorhanden, wenn der Hilfetext mit der Bedingung #HLPDOC erzeugt wurde.
Fⁿr die von Microsoft geplante Windows HTML Programmhilfe werde ich in einer kⁿnftigen HyperMake Version vergleichbare Funktionen anbieten.
.END HLPDOC
.FA verti 40
.1
Verzeichnis aller Punktbefehle
Hier finden Sie eine kurze Beschreibung aller HyperMake Punktbefehle. Die gleiche Kapitelstruktur finden Sie in Erstellen eines HyperMake Quelltextes.
.in Verzeichnis aller Punktbefehle
Einige Punktbefehle sind speziell deutsch und haben englische oder auch WordStar-Synonyme; diese zweite m÷gliche Schreibweise von Punktbefehlen ist in Klammern gesetzt und kann genauso verwendet werden.
.2
Grundlagen
.sab
~..Kommentar~
"Kommentar" wird nicht interpretiert.
.IF IPFDOC
.snb
.:ipf-Kommando.
.:ipf-Kommando. Ausdruck
.sn
Ein IPF-Kommando kann auch direkt eingegeben werden.
.END
.IF HTMLDOC
.snb
.HTML
<HTML-Kommandos> Flie▀text usw.
.HYPERMAKE
.sn
Direkte Eingabe von HTML Text.
.END HTMLDOC
.2
Textanfang
~.TI Hypertext-Titel~
setzt den Titel des Hypertexts.
.IF IPFDOC
~.<>~
stellt HLP-Dateien die Hypertext-Benutzerkn÷pfe "Inhalt", "Zurⁿck" und "VorwΣrts" zur Verfⁿgung, die es sonst nur bei INF-Dateien gibt.
.END
.2
Kapitel
~.1~ bis ~.6~ definiert eine Gliederungsebene
~.1~
~Hauptⁿberschrift~
Die Kapitelⁿberschrift des ersten Punktes der ersten Gliederungsebene hei▀t "Hauptⁿberschrift".
~.FA~ (~.WA~)
~.FA hori 30~
~.FA hori 30 verti 40 III~
Mit Fensteranordnung k÷nnen mehrere Fenster verschiedener Gliederungsebenen gleichzeitig angezeigt werden. Der Punktbefehl mu▀ vor dem ersten Gliederungsebenen-Punktbefehl geschrieben werden, der nur noch einen Teil des Bildschirms einnehmen soll.
.2
Schriften
~.SNX~ (~.SFX~)
~.SAX~ (~.AFX~)
Schrift Normal und Schrift Alternativ stellt die Schrift X ein. X steht fⁿr einen Buchstaben von A bis Z und von a bis z; es wird also Gro▀- und Kleinschreibung unterschieden. Die Bedeutung der Schriftbuchstaben werden in der Ini-Datei unter Fonts festgelegt.
Schrift Alternativ gilt zwischen zwei Alternativ Umschaltzeichen, diese werden ebenfalls in der Ini-Datei festgelegt.
.2
Listen
~.SL~ (~.OL~)
macht aus den nΣchsten Auflistungen eine sortierte Liste
~.UL~
stellt wieder auf unsortierte Listen (Standardeinstellung).
.2
Einbindung von Grafiken
~.BM Dateiname~
gibt eine Grafik dateiname.bmp (IPF) bzw. dateiname.gif (HTML) zentriert aus.
~.BTX Dateiname~
schreibt im Flie▀text statt dem Buchstaben X die Grafik dateiname.bmp.
.2
Querverweise und Index
~.IZX~ (~.ICX~)
wΣhlt das beliebige Zeichen X als Indexzeichen.
~.IN Ausdruck~
nimmt "Ausdruck" im Index auf; alle Vorkommnisse von "Ausdruck" im gesamten Hypertext erhalten einen Querverweis zu dem Kapitel, in dem der í.INí Punktbefehl steht.
~.IV Ausdruck~
Index Vertauscht: wie í.INí, verwendet aber das letzte Wort des Ausdrucks als fⁿhrendes Wort.
.IF IPFDOC
⌐Externe Querverweise (IPF)⌐
~.EX extern.inf~
~.ID Kapitel_Einleitung~
~.IN Ausdruck~
~.EX~
Alle Vorkommnisse von "Ausdruck" erhalten einen externen Querverweis zu dem Kapitel in der Datei extern.inf, das mit
~.ID Kapitel_Einleitung~
markiert wurde.
.END IPFDOC
.IF HTMLDOC
⌐Externe Querverweise (HTML)⌐
~.URL URL~
~.IN Ausdruck~
~.LOCAL~
Alle Vorkommnisse von "Ausdruck" erhalten einen externen Querverweis zu der URL "URL".
.END HTMLDOC
.IF IPFDOC
⌐Programme starten (IPF)⌐
~.EX Programmname.exe Parameter~
~.IN Ausdruck~
~.EX~
Alle Vorkommnisse von "Ausdruck" werden zu einem Querverweis, bei dem das Programm "Programmname" mit dem Parameter "Parameter" gestartet wird.
.END
.2
Duplizierung von Kapitelⁿberschriften
~.dp34C~
Die Kapitelⁿberschrift wird in Gliederungsebene 3 und 4 am Anfang des Flie▀textes mit Schrift C dupliziert.
~.dp##C~
In allen Gliederungsebenen wird die ▄berschrift mit Schrift C im Flie▀text dupliziert, als Querverweis-Ziel verwendet (erster #) und in den Index aufgenommen (zweiter #).
~.dp-34~
schaltet die Duplizierung in Gliederungsebene 3 und 4 wieder aus.
.2
Linienziehen
.snb
..LI▄▌
.LIXYZ
X Y X +---+---+
| | |
Y Ergebnis: +---+---+
| | |
X X +---+---+
.LI
..li
.sn
Im Linienziehen Punktbefehl steht das beliebige Zeichen X fⁿr die Ecken und Y fⁿr Unterteilungen des Rechtecks. Ein Zeichen Z vor X oder Y macht Doppelstriche (nur IPF).
.2
Fu▀noten
~.FU{}~
~.FU{}snX~
definiert die Zeichen, mit denen der Inhalt von Fu▀noten eingeklammert wird; definiert zusΣtzlich noch eine Schrift X fⁿr das Fu▀notenfenster. Die Eingabe
.snb
und Sie erhalten {Inhalt der Fu▀note}.
.sn
fⁿhrt zu:
und Sie erhalten [Inhalt der Fu▀note].
.IF HTMLDOC
~.FS 30~
Fu▀noten Size: Σndert den Standardwert der Aufteilung HTML-Textfenster / Fu▀notenfenster von 85 zu 15 auf 70 zu 30.
.END
~.FT XXX~
Fu▀noten-Text: schreibt "XXX" statt dem standardmΣ▀igen "*". Grafik statt Text ist erlaubt (Verwendung von Bitmap Text).
.2
RΣnder und Formatierung
~.LM 10~
setzt den linken Rand (left margin) vom Standardwert 1 nach 10.
.IF IPFDOC
~.FM aus~ (~.FM off~)
~.FM an~ (~.FM on~)
(nur IPF) Mit dem Punktbefehl Formatieren wird die Formatierung aus- und eingeschaltet. Standard ist íaní.
.END
~.OC an~ (~.OC on~)
~.OC aus~ (~.OC off~)
schaltet zentrierten Text (Output Centered) an und aus.
~.AM aus~ (~.AM off~)
~.AM an~ (~.AM on~)
verstellt den linken Rand dadurch, da▀ ein Absatz mit entsprechenden Leerzeichen beginnt. Standard ist íaní.
.IF HTMLDOC
In HTML-Dateien wird der Rand nur in Fⁿnfer-Schritten verstellt.
.END
.2
If-Bedingungen
.snb
.IF BEDINGUNG
.ELSE
.END
.sn
ⁿbertrΣgt nur bestimmte Teile des Quelltextes ins IPF-Format. Die If-Bedingungen werden ⁿber die Kommandozeile gesetzt (Gro▀- oder Kleinschreibung egal)
.snp
.fu
[C:\myProject] HMAKE MeinDoku.txt #BEDINGUNG
.fu[]
.sn
.2
Erstellung von Helptables
(nur IPF, zur Erstellung von IBM HLP-Dateien)
.snb
.RC ID_window
.RC ID_window, ID_button_or_Menu_Item
.RC , ID_button_or_Menu_Item
.ID PanelID
.sn
RC Punktbefehle erzeugen einen Helptable mit dem Dateinamen HELPTABLE.RC, ID Punktbefehle eine Datei mit Panel ID's unter dem Dateinamen PANELID.H.
.FA hori 40
.1
Ini-Datei
.in Ini-Datei
In der Ini-Datei k÷nnen Sie einige dokumenten- und sprachspezifische Einstellungen vornehmen. Es empfiehlt sich, fⁿr jedes Projekt eine eigene Ini-Datei anzulegen. Die Ini-Datei k÷nnen Sie mit einem ASCII-Editor verΣndern. Die erste Zeile wird nicht interpretiert.
Wie in C++ sind Zeilen, die mit zwei SchrΣgstrichen // beginnen, auch Kommentarzeilen. Windows-konform k÷nnen Kommentarzeilen auch mit ; beginnen. Die Reihenfolge der Schalter darf geΣndert werden, aber es mu▀ jeder Schalter einmal vorkommen. Mit wenigen Ausnahmen wird in der Ini-Datei Gro▀- und Kleinschreibung nicht unterschieden.
Der Text links vom Istgleich-Zeichen = ist der Name des Schalters; dieser darf nicht geΣndert werden. Rechts davon dⁿrfen Einstellungen geΣndert werden.
.2
general settings (Allg. Einstellungen)
⌐Registration key (Registrierungsschlⁿssel)⌐
.in Registration key
.in Registrierungsschlⁿssel
.snb
Registration key = 0
.sn
Hier tragen Sie Ihren Registrierungs-Code ein, um Quelltexte von mehr als 20 kB verarbeiten zu k÷nnen. Siehe auch Registrierung.
⌐Language (Sprache)⌐
.snb
//possible settings: ENGLISH, GERMAN, C, PASCAL
Language = GERMAN C
.sn
⌐Landessprache:⌐ HyperMake kann entweder auf englisch oder auf deutsch Fehlermeldungen ausgeben; auf die erstellte HTML-Datei oder IPF-Datei hat dieser Schalter keine Wirkung.
Diesen Hypertext gibt es auch auf englisch. Einige Punktbefehle weichen in der englischen Anleitung von den deutschen Befehlen ab; sie werden gleicherma▀en interpretiert.
⌐Programmiersprache (nur IPF):⌐ Wenn Sie von HyperMake Panel ID und Helptable Dateien erstellen lassen, k÷nnen Sie zwischen C und ╡Pascal wΣhlen.
⌐beep (Pieps)⌐
.snb
//beep when finishing compiling - possible settings: YES, NO
beep = YES
.sn
Wenn HyperMake eine IPF-Datei oder mehrere HTML-Dateien erfolgreich erstellt hat, h÷ren Sie einen Pieps. Sie k÷nnen diesen Ton hier abstellen, indem Sie ~NO~ statt ~YES~ eingeben.
.2
format settings (Format-Einstellungen)
⌐Target (Zielformat)⌐
.in Zielformat
.snb
//possible settings: IPF, HTML
Target = HTML
.sn
Die Standardeinstellung kann durch die Kommandozeilenparameter IPF und HTML temporΣr ⁿberschrieben werden.
Sie haben drei verschiedene Quelltext-Formate zur Auswahl. Siehe Bedeutung von Returns.
⌐Source Codepage (Quelltext-Zeichensatztabelle)⌐
.snb
//possible Settings: ISO, IBM
source codepage = IBM
.sn
Zwei verschiedene Codepages (Zeichensatztabellen) k÷nnen Sie fⁿr Ihre Quelltexte auswΣhlen: ISO (ISO 8859-1), auch Latin1 genannt, oder IBM 850 bzw. 437. ISO ist fⁿr Windows und Unix ⁿblich, IBM fⁿr DOS und fⁿr OS/2. Wenn Sie diese Einstellung falsch wΣhlen, so werden Umlaute falsch angezeigt bzw. interpretiert. Wenn Sie diese Einstellung verΣndern, mⁿssen Sie auch die Umlaute in der Ini-Datei, etwa unter extended letters, entsprechend anpassen.
.2
specific characters (besondere Zeichen)
⌐List chars (Auflistungszeichen)⌐
.snb
//only ASCII source
List chars = =-
.sn
Auflistungszeichen werden fⁿr unsortierte Listen und sortierte Listen ben÷tigt, wenn Sie Auflistungen mit einem ASCII-Editor erstellen wollen.
⌐Index char (Indexzeichen)⌐
.snb
Index char = #
.sn
Siehe Erstellung von Querverweisen, Index und Indexzeichen. Mit dem Punktbefehl ~.IZX~ wird die hier festgelegte Standardeinstellung mit dem Zeichen X ⁿberschrieben.
⌐toggles (Umschalter)⌐
.snb
//highlighted char toggles
//both HTML and IPF: 1 alternate 2 italic 3 bold 4 underlined
//only IPF: 5 red 6 cyan 7 blue
//only HTML: 8 strike 9 big 10 small 11 sub 12 sup
// 123456789012
toggles = ************
.sn
Hier lassen sich die Umschaltzeichen festlegen. Sie mⁿssen immer alle zw÷lf Zeichen eingeben, auch wenn Sie IPF oder HTML nicht benutzen.
.IF WORDSTARDOC
Bei der Verwendung von WordStar-Steuerzeichen mⁿssen Sie die Zeichen eingeben, die dem ASCII-Code entsprechen. [Also etwa fⁿr ^PA Alt-1, fⁿr ^PB Alt-2, fⁿr ^PS Alt-19 usw.]
.END
⌐Index Filter⌐
.in index filter
.snb
//characters not shown in index and duplicated heading
index filter = ().
.sn
Es k÷nnen bestimmte Zeichen im Stichwortverzeichnis und bei der Duplizierung von Kapitelⁿberschriften unterdrⁿckt werden.
//language specific letters besides A...Z, a...z, 0...9
//english '-
//german Σ÷ⁿ▀─╓▄-
extended letters = Σ÷ⁿ▀─╓▄-
.sn
Sie mⁿssen HyperMake die deutschen Umlaute mitteilen, die er als normale Buchstaben behandeln soll. Wenn Sie dies nicht tun, interpretiert HyperMake die Buchstaben links und rechts vom Umlaut als seperate W÷rter. Die normale Markierung des Wortes "KindergΣrten" hΣtte dann einen Indexeintrag "Kinderg" zur Folge.
Damit eine Bezeichnung wie "CONFIG.SYS" oder "Eule (Film)" einen Querverweis bekommt, mⁿssen Punkt bzw. Klammern in der Ini-Datei unter extended letters aufgefⁿhrt sein. Gleichzeitig mⁿssen Sie aber dann aufpassen, wenn Sie etwa eine Markierung machen wie (#Wort). Dann wird nicht "Wort" markiert, sondern "Wort)." - Mit dem Effekt, da▀ die meisten gewⁿnschten Querverweise nicht gezogen werden. Richtig ist dann die Markierung (#:Wort:).
Sie sollten sich genau ⁿberlegen, ob Sie den Bindestrich "-" auch in dieser Liste aufnehmen. Ist der Bindestrich ein "extended letter", wird er also als Buchstabe behandelt, k÷nnen Ausdrⁿcke wie "Ini-Datei" einfach mit dem Indexzeichen markiert werden, ohne Doppelpunkt-Klammern; dafⁿr wird aber beim Wort Datei, wenn es an anderer Stelle markiert wurde, kein Querverweis erstellt. Im anderen Fall wird mit Ini-Datei wie mit "Ini Datei" verfahren.
.2
Font characters (Schrift-Buchstaben)
.snb
//Font chars from A to Z and from a to z (case-sensitive!)
//both HTML and IPF: size Linestandard OmitLinks PRE center
Font b = Courier 12 CODE black 437 Linestandard OmitLinks
Font B = 30 Helv neutral
Font Z = GREEN 30 Helv yellow
Font G = 15 Helv black
Font T = 18 Tms_Rmn
Font C = black
Font o = OmitLinks
.sn
Hier lassen sich Schriftbuchstaben fⁿr Schriften definieren, und zwar von A bis Z und von a bis z. Beachten Sie, da▀ zwischen Gro▀- und Kleinschreibung unterschieden wird. Die Reihenfolge der Einstellungen hinter dem = Zeichen ist egal.
Kennzeichen der einzelnen Parameter hinter dem = sind:
╢ ⌐Schriftgr÷▀e:⌐ alle Zahlen, die kleiner als 200 sind
╢ ⌐Codepage:⌐ (nur IPF) alle Zahlen gr÷▀er/gleich 200
╢ ⌐Schrift-Typ:⌐ (nur IPF) Alle Eingaben, die nicht den bisherigen Kriterien entsprechen. Beachten Sie, da▀ statt Leerzeichen wie bei "Tms Rmn" íunbedingt ein Unterstrichí "_" geschrieben werden mu▀.
Sie mⁿssen nur diejenigen Parameter eintragen, die vom Standardwert abweichen.
.IF IPFDOC
Die standardmΣ▀ig verwendete Codepage hΣngt bei IPF von Einstellungen im OS/2-Betriebssystem bzw. vom Parameter hinter IPFC ab.
.END
Beachten Sie bitte, da▀ Sie IPF- und HTML-Kommandos hier mischen k÷nnen, so da▀ ein Schrift-Buchstabe sowohl das Outfit im IPF als auch im HTML-Format festlegen kann.
vgl. Schrift-Beispiele und Farb-Beispiele
.2
link specific settings (Einst. bzgl. Querverweise)
⌐endings of words (Endungen von W÷rtern)⌐
.in endings of words
.snb
//endings in german words: e n en s es
//endings in english words: s es 's ion ions ing ings
ending of words = e n en s es
.sn
Siehe Querverweise, íVerfahrensweise bei Wortendungení.
Wenn Sie einen deutschen Text mit vielen englischen Ausdrⁿcken verwenden, werfen Sie am besten die empfohlenen Endungen beider Sprachen zusammen:
.snb
ending of words = e s es n en 's
.sn
⌐Text for link to (Text fⁿr Querverweise zu ...)⌐
.snb
Text for link to subchapters = @Unterkapitel:@
Text for link to next chapter = @nΣchstes Hauptkapitel:@
//only HTML frames
text for link to main chapter = zum Hauptkapitel
.sn
.IF HTMLDOC
Werden HTML Frames erstellt, so werden zwei Gliederungsebenen gleichzeitig angezeigt. Im Fenster mit dem Unterkapitel wird zu Beginn ein Querverweis auf das Hauptkapitel gezogen; andere Querverweise wie "Inhalt" werden in solchen Fenstern nicht gezogen, da diese schon im Hauptkapitel-Fenster vorhanden sind. Der Querverweis zum Hauptkapitel ist erforderlich, um bei einem direkten Aufruf des Unterkapitels zum restlichen Dokument zu gelangen und kann nicht abgeschaltet werden.
.END
.in Querverweise zu Unterkapitel
.in link to subchapters
.sao
HyperMake zieht automatisch ~Querverweise~ am Ende eines Kapitel-Fensters zu allen Unterkapiteln dieses Kapitels sowie zum nachfolgenden Kapitel gleicher Gliederungsebene bzw. h÷herer Gliederungsebene. Hier k÷nnen Sie eintragen, was HyperMake ⁿber solche automatischen ~Querverweise~ schreiben soll. Sie dⁿrfen nicht nur Buchstaben, sondern auch Umschalter oder Grafikzeichen verwenden.
Wenn Sie ein NO in Gro▀buchstaben eingeben, zieht HyperMake keine solchen Kapitel-Querverweise:
.snb
Text for link to subchapters = NO
Text for link to next chapter = NO
.sn
⌐no more links in (keine weiteren Querverweise in ...)⌐
.in no more links in
.snb
//possible Settings: PARAGRAPH, WINDOW
no more links in = PARAGRAPH
.sn
Zweite und dritte Querverweise k÷nnen in einem Absatz (paragraph) oder innerhalb eines gesamten Kapitels (window) unterdrⁿckt werden.
siehe Querverweise, íUnterdrⁿcken von Querverweisení.
.2
HTML specific settings (HTML-spezifische Einst.)
⌐title in every file⌐ (Titel in jeder Datei)
StandardmΣ▀ig wird der Titel am Anfang jeder Datei wiederholt, dies kann mit
.snb
title in every file = NO
.sn
abgeschaltet werden.
⌐First and last line (erste und letzte Zeile)⌐
.snb
//only HTML: first and last line in file
title in every file = YES
function for first line = BACK FORWARD CONTENT INDEX
text for first line = zurⁿck vorwΣrts Inhalt Stichw÷rter
function for last line = FORWARD CONTENT INDEX
text for last line = vorwΣrts Inhalt Stichw÷rter
.sn
HyperMake erzeugt zahlreiche HTML-Dateien. Der Benutzer sollte am Textende zur nachfolgenden Datei springen k÷nnen (FORWARD) und am Anfang zur vorherigen Datei (BACK). Au▀erdem sollte aus jeder Datei heraus das Inhaltsverzeichnis (CONTENT) und Stichwortverzeichnis (INDEX) erreichbar sein. Ob alle derartigen Funktionen sowohl in der ersten Zeile (first line) als auch in der letzten Zeile (last line) zur Verfⁿgung stehen sollen, kann hier eingestellt werden, auch die Reihenfolge der Funktionen sowie die W÷rter, die den Querverweis darstellen (text for...).
⌐Buttons (Druckkn÷pfe)⌐
.snb
//you can use buttons BACK.GIF FORWARD.GIF CONTENT.GIF INDEX.GIF instead of text
buttons = YES
.sn
Fⁿr die erste und letzte Zeile k÷nnen die Querverweise "zurⁿck vorwΣrts Inhalt Stichw÷rter" sowohl als Text als auch als Grafik-Buttons dargestellt werden. Die Namen der GIF-Dateien sind fix.
Wenn sich die GIF-Dateien nicht in dem Verzeichnis befinden, das auch die HTML-Dateien enthΣlt, dann erscheint statt den Buttons der Text, den Sie unter "text for first/last line" definiert haben. Wenn die Dateien sich auf einem Unix-Server befinden, wird Gro▀- und Kleinschreibung unterschieden! Schreiben Sie deshalb alle diese Dateinamen GROSS !
⌐body tags ("body" EintrΣge)⌐
.snb
//enter tags or NO
body tags = NO
.sn
Es k÷nnen diverse HTML body tags eingetragen werden, etwa
.snb
body tags = background="backgr.gif" TEXT="#00FFFF"
.sn
.IN Farbe Hintergrund
.IN Farbe Text Standard
Gehen Sie behutsam mit body tags um! Wenn Sie etwa einen blauen Hintergrund wΣhlen, sind die Querverweise nicht mehr sichtbar. Beachten Sie dabei, da▀ manche Benutzer andere Standardfarben gewΣhlt haben wie Sie! Nur wenn Sie einen ⁿberwiegend wei▀en oder grauen Hintergrund wΣhlen, gehen Sie kein Risiko ein.
⌐extended index (Gro▀es Stichwortverzeichnis)⌐
.in extended index
.snb
entries for extended index = 30
.sn
Hier k÷nnen Sie einstellen, ab welcher Zahl von IndexeintrΣgen das gro▀e Stichwortverzeichnis statt dem kleinen erzeugt werden soll.
⌐new file level (Gliederungsebene der Unterteilung in Dateien)⌐
.snb
//HTML text file is divided in several files.
//Enter heading level where new file begins (0 means only one HTML text file)
new file level = 3
.sn
HyperMake erzeugt aus einer Quelldatei viele HTML-Dateien. Dies verbessert die Geschwindigkeit der Browser ganz erheblich. Mit dieser Einstellung k÷nnen Sie beeinflu▀en, wieviel Dateien erstellt werden sollen. "3" bedeutet, da▀ fⁿr die Kapitel der Gliederungsebenen 1, 2 und 3 grundsΣtzlich neue HTML-Dateien begonnen werden.
In Bereichen, in denen die Fensteranordnung (Frames) aktiv ist, erzeugt HyperMake jedoch fⁿr alle Kapitel grundsΣtzlich eigene Dateien.
Wenn 0 eingegeben wird, so wird nur eine HTML-Datei (plus Stichwortverzeichnis und Inhaltsverzeichnis) erstellt (falls keine Fensteranordnung verwendet wird).
⌐horizontal rule level (Gliederungsebene der Trennung durch horizontale Striche)⌐
.snb
//Enter heading level up to which has to be divided by horizontal rules
// (0 means no rules)
horizontal rule level = 4
.sn
HTML lΣ▀t horizontale Striche ⁿber das ganze Fenster hinweg zu. Diese k÷nnen dazu genutzt werden, einzelne Kapitel voneinander zu unterteilen, falls sie ohnehin nicht in unterschiedlichen HTML-Dateien liegen. Der Wert fⁿr "horizontal rule level" mu▀ deshalb h÷her sein als der fⁿr "new file level". "4" bedeutet, da▀ die Kapitel 1., 2., 3. und 4. Ordnung mit einem Strich getrennt werden, falls sie in derselben Datei abgelegt werden.
⌐pre filename (Beginn der Dateinamen)⌐
.snb
//pre filename = XYZ* let all HTML files begin with XYZ
pre filename = *
.sn
(Registrierung erforderlich) HyperMake erstellt aus einem Quelltext eine gro▀e Zahl von Dateien. Diese Dateien haben Namen, die HyperMake festlegt. So werden einfach Nummern fⁿr Dateinamen vergeben: N000.HTML, N001.HTML usw. Um in nur einem Pfad mehrere unterschiedliche HyperMake-Texte haben zu k÷nnen, lΣ▀t sich ein String eingeben, der all den Dateinamen incl. INDEX.HTML vorangestellt wird. Beispielsweise fⁿhrt die Eingabe von ~XYZ*~ dazu, da▀ die Dateinamen dann XYZN000.HTML, XYZN001.HTML usw. hei▀en. Achten Sie bei alten FAT-Laufwerken bitte selbst darauf, da▀ die 8-Buchstaben-Begrenzung eingehalten wird. (Das bedeutet, der pre filename darf nicht mehr als 3 Buchstaben haben.)
.2
IPF specific settings (IPF-spezifische Einst., nicht HTML)
⌐Help Subtable Start ID (Startwert fⁿr ID-Konstanten)⌐
.snb
Help Subtable Start ID = 7000
.sn
Mit der Help Subtable Start ID k÷nnen Sie einen Startwert fⁿr die ID's angeben, die die Subtables definieren. Das brauchen Sie nicht zu Σndern, au▀er Sie definieren in Ihrem Programm-Quelltext selber auch schon Konstanten mit Werten von 7001, 7002 usw.
⌐Filenames (Dateinamen)⌐
.in Filenames
.snb
//files will be overwritten without warning
Helptable filename = HLPTABLE.RC
Panel ID filename = PANELID.H
.sn
Hier k÷nnen Sie die Dateinamen der Helptable- und Panel-ID-Datei Σndern, die automatisch von HyperMake generiert werden. Wenn Sie als Dateiname *.XYZ eingeben, wird als Dateiname der Quell-Dateiname mit der entsprechenden Erweiterung gewΣhlt.
⌐Achtung!⌐ Die beiden Dateien werden ohne Vorwarnung ⁿberschrieben.
.1
Starten des HyperMake Compilers
Das HyperMake-Programm ist ein Compiler, der von der Kommandozeile gestartet wird, Σhnlich IPFC.
.in Installation
.in kompilieren
.in compiling
.in Kommandozeilenparameter
Bevor Sie HyperMake benutzen k÷nnen, mⁿssen Sie HMAKE.EXE in einen Pfad kopieren, der in der Datei CONFIG.SYS unter íPATHí vorkommt; die Datei KBDVIO32.DLL mu▀ in einem Pfad sein, der unter íLIBPATHí vorkommt. Findet die EXE-Datei die DLL nicht, so erscheint die Fehlermeldung "╡:runtime error 217:".
Sie mⁿssen ein oder zwei Parameter ⁿbergeben:
.snp
.fu
[C:\myProject] HMAKE MeinDoku.txt Meine.ini
.sn
.fu[]
Die Reihenfolge der Parameter ist egal. Die Dateinamen-Erweiterungen mⁿssen Sie aber auf jeden Fall angeben. Die Ini-Datei mu▀ immer mit ".INI" enden, die Erweiterung des HyperMake Quelltextes ist beliebig.
Wenn Sie ohne Erweiterung den gleichen Dateinamen fⁿr Text- und Ini-Datei verwenden wie etwa íMeinDoku.txtí und íMeinDoku.ini,í so reicht es aus, nur den Namen des HyperMake Quelltextes anzugeben - HyperMake sucht dann nach der entsprechenden Ini-Datei:
.fu
.snp
[C:\myProject] HMAKE MeinDoku.txt
.sn
.snL
Mehrere Quelltexte
.sn
Sie k÷nnen Ihren Quelltext auf mehrere Dateien verteilen. HyperMake kopiert die Dateien dann zusammen, bevor es mit der eigentlichen Arbeit beginnt. Dabei gilt die Reihenfolge der ▄bergabeparameter. Wenn nicht explizit eine Ini-Datei angegeben wird, so wird der Name der Ini-Datei vom ersten Quelldateinamen abgeleitet.
.snL
HTML- oder IPF-Dateien erzeugen
.sn
Mit den Kommandozeilenparametern ~HTML~ und ~IPF~ kann die Standardeinstellung "target file" in der Ini-Datei temporΣr ⁿberschrieben werden.
.fu[]
.snL
Wie HyperMake vorgeht
.sn
Nachdem HyperMake aufgerufen wurde, geht das Programm wie folgt vor:
.sao
╢ ⌐Einlesen der Ini-Datei⌐
╢ ⌐Einlesen des Quelltextes⌐
Der Quelltext wird mit einem Schlag in den Heap geladen
╢ ⌐Indizieren der Kapitelⁿberschriften⌐
Alle Kapitelⁿberschriften bzw. Kapitel erhalten eine Identifizierungsnummer.
╢ ⌐Indizieren der Querverweise⌐
Alle W÷rter oder Ausdrⁿcke, die mit dem Indexzeichen oder mit den entsprechenden Punktbefehlen markiert sind, werden im Heap abgelegt.
╢ ⌐Schreiben der IPF-Datei oder der HTML-Dateien⌐
Zuletzt wird die IPF-Datei bzw. werden die HTML-Dateien erstellt, was die Hauptarbeit ist. Jedes Wort des Hypertextes mu▀ mit den indizierten W÷rtern aus dem Heap verglichen werden, um ggf. Querverweise zu ziehen. Hier werden auch die meisten Punktbefehle und Umschalter ausgewertet sowie Helptables im Heap erstellt. HTML-Dateien werden in einen ggf. neu anzulegenden Pfad gespielt.
.IF HLPDOC
╢ ⌐Schreiben der Helptable-Datei⌐
Bei der Verwendung von RC-Punktbefehlen im HyperMake Quelltext wird die im Heap angesammelte Information ⁿber den Helptable in der Helptable-Datei abgespeichert.
.END
Beim Indizieren von Kapitelⁿberschriften, Indizieren von Querverweisen und dem Schreiben der IPF-Datei erscheint fⁿr jedes bearbeitete Kapitel (Fenster) ein Punkt am Bildschirm.
Ert÷nt ein tiefer ╡Piepston, so hat HyperMake einen so schweren Fehler gefunden, da▀ die IPF-Datei bzw. die HTML-Dateien nicht erstellt werden konnten.
.IF HTMLDOC
Als Dateinamen-Erweiterung fⁿr HTML-Dateien wird ".HTML" gewΣhlt. Nur auf FAT-Laufwerken wird ".HTM" verwendet.
.END
.snL
Schreiben von Batch-Dateien
.sn
.IF IPFDOC
Weil das IPF-Format nicht mehr von Interesse ist, kann man HyperMake und IPFC ⁿber eine ╡:Batch-Datei: (mit der Endung ".CMD") aufrufen. Eine vernⁿnftige Batch-Datei zum Abarbeiten im Hintergrund ist die folgende:
.snb
@echo off
rem Erstellung eines Hypertextes mit HyperMake und IPFC
Die letzte Zeile enthΣlt zwei Zeichen Alt-7, das ergibt zwei Piepser.
Wenn Sie eine fehlerhafte INF- bzw. HLP-Datei erhalten, k÷nnen Sie die ASCII-Dateien íHyperMake_errorsí und íipfc_errorsí lesen (bzw. beim FAT-Dateisystem kⁿrzere Dateinamen).
Wenn Sie hinter íipfcí nicht /inf schreiben, so wird eine HLP-Datei statt einer INF-Datei erzeugt. Die von HyperMake erzeugte IPF-Datei kann immer fⁿr beides verwendet werden, selbst wenn Sie HLP-spezifische ressource connection und Panel ID Punktbefehle verwendet haben.
Wenn Sie mit Batchdateien nicht vertraut sind, so k÷nnen Sie darⁿber unter "OS/2-Befehle (nach Funktion sortiert), Stapeldatei- und Befehlsverarbeitung" im OS/2-Referenzhandbuch nachlesen.
.END IPFDOC
Denken Sie beim Sichern Ihrer Festplatte daran, da▀ Sie HTML-Dateien bzw. IPF-Dateien nicht sichern mⁿssen, weil Sie sie jederzeit aus dem HyperMake Quelltext reproduzieren k÷nnen.
.IF HTMLDOC
Bei der Erstellung von HTML-Dateien lΣ▀t sich eine Batchdatei schreiben, die zuerst die alten HTML-Dateien l÷scht und dann HyperMake aufruft:
.snb
del %1\*.html
HMAKE %1.txt #Bedingung >HyperMake_errors
edit HyperMake_errors
.sn
.END HTMLDOC
.1
RⁿckwΣrts-Konvertierung von IPF nach HyperMake
Wenn Sie einen Text schon im IPF-Format vorliegen haben, hilft Ihnen HyperMake bei der Rⁿck-▄bersetzung ins HyperMake Quelltext-Format. Es gibt noch keinen v÷llig perfekten Quelltext, aber die wichtigsten Funktionen werden korrekt ⁿbersetzt.
Die ╡RⁿckwΣrts-Konvertierung ist zu folgendem in der Lage:
╢ Umschalter (toggles)
╢ Kapitel
╢ unsortierte Listen, sortierte Listen
╢ die wichtigsten Formatierbefehle (paragraph, break, Formatieren ein/aus)
╢ IndexeintrΣge (nur i1 Ebene), sie werden auch gleich zum Querverweis-Ziel
╢ Grafiken.
Nicht funktioniert das folgende:
╢ Schriften
╢ Fensteranordnung
╢ RΣnder
╢ Fu▀noten
╢ definition list
╢ Panel ID's, die Verbindung zu einem EXE Programm.
Bei der RⁿckwΣrts-Konvertierung wird auch die Ini-Datei gelesen. Werfen Sie vorher schon einen Blick auf die Einstellungen "list char", "toggle char" and "Source format". Achten Sie vor allem darauf, da▀ genⁿgend "list char" definiert sind, also etwa vier Stⁿck wenn im IPF-Text Listen mit bis zu vier Ebenen vorkommen.
.sab
Um die RⁿckwΣrts-Konvertierung zu starten, geben Sie neben der Ini-Datei noch eine Datei mit der Erweiterung ~IPF~ ein.
.snp
.fu
[C:\myProject] HMAKE meineDok.ipf meineDok.ini
.sn
.fu[]
Es wird ígrundsΣtzlichí eine HyperMake Quelldatei mit dem Namen HMSOURCE.TXT erstellt.
.FA verti 25
.1
▄ber HyperMake
.in HyperMake
.2
Registrierung
.saL
.inRegistrierung
.in Preis
Dieses Programm ist ~Shareware~ wenn Sie gr÷▀ere Quelltexte als 20 kB bearbeiten lassen m÷chten. Dafⁿr mⁿssen Sie einen Registrierungsschlⁿssel anfordern. Kleinere Quelltexte als 20 kB lassen sich auch ohne Registrierungsschlⁿssel compilieren, in diesem Fall ist es ~Freeware.~
Warum gerade 20 kB? Ich bin der Meinung, da▀ fⁿr die Erstellung kurzer HTML-Texte und INF- und HLP-Dateien fⁿr einfache Freeware-Programme die Benutzung von HyperMake kostenlos sein sollte. Wenn Sie also Fehler finden und nicht registriert sind, dⁿrfen Sie mir gerne trotzdem eine Mail schicken.
Die Registrierungsgebⁿhr betrΣgt ~60 Deutsche Mark~ oder ~40 Dollar~.
Beim Erwerb von mehreren Lizenzen erhalten Sie 30% Rabatt fⁿr jede zusΣtzliche Lizenz.
Wenn Sie Zugang zu Compuserve haben, k÷nnen Sie diese Software ⁿber Compuserve registrieren lassen. Go ~SWREG~. Die Nummer (Registration ID) lautet ~9988~.
Meine Kontoverbindung lautet:
Dresdner Bank Ottobrunn (Deutschland), BLZ 700 800 00, Nr. 075 64 62 400
⌐Bitte senden Sie mir keine FremdwΣhrung!⌐ Ich mⁿ▀te 15 DM Umrechnungsgebⁿhr an meine Bank zahlen! Schicken Sie mir dann lieber DM (oder zur Not Banknoten Ihrer WΣhrung) einfach per Post in einem Briefkuvert.
Wenn Sie sich nicht ⁿber Compuserve registrieren lassen, erhalten Sie eine Rechnung ⁿber den entsprechenden Betrag und ihren Registrierungsschlⁿssel auf dem Postweg. Den Registrierungsschlⁿssel tragen Sie in Ihren HyperMake Ini-Dateien unter "registration key" ein.
.2
Haftungsausschlu▀
Der Autor ⁿbernimmt keinerlei Haftung fⁿr SchΣden, sei es durch fehlerhafte Bedienung oder durch Fehler im Programm. Es wird auch keine Garantie ⁿber die Registrierungsgebⁿhr hinaus gegeben.
.2
Autor
..in Ich
.in Autorenadresse
Martin Vieregg, 30. Ich habe Betriebswirtschaft mit Schwerpunkt Verkehrswirtschaft studiert. Ich arbeite in einer Zwei-Mann-Beratungsgesellschaft. Unser Spezialgebiet ist der ╓ffentliche Verkehr, speziell Eisenbahn. Das Thema meiner Doktorarbeit lautet "Effizienzsteigerung im Schienenpersonenfernverkehr" (ISBN 3-929115-51-4).
.sno
Meine Mailadresse ist:
.sn
Martin Vieregg Compuserve 100661,626
vom Internet aus:
Martin Vieregg 100661.626@COMPUSERVE.COM
Meine Postanschrift lautet:
Dr. Martin Vieregg
Hubertusstr. 26
D-85521 Ottobrunn
.2
Versionen
.snL
Gefundene Fehler und Verbesserungen MakeIPF Beta 0.91 nach 1.0
.sn
╢ Absturz "access denied" kommt nicht mehr vor; geringerer Speicherbedarf
╢ jetzt mit dem endgⁿltigen (Nicht-Beta) SpeedPascal Compiler erstellt. (Datenumleitung jetzt o.k.)
╢ automatischer Rand .AM
╢ If-Bedingungen
╢ Verbesserung der automatischen Querverweise, insbes. Wortendungen
╢ diverse Fehler beseitigt
.snL
Bereinigte Fehler in MakeIPF 2.0
.sn
.in neue Version
╢ Fehler beim Ausdrucken von INF/HLP-Texten (feste Schrift "tritt auf der Stelle")
╢ Fehlerhafte Anzahl von Returns bei "Formatieren aus"
Darⁿber hinaus wurden zahlreiche kleinere Fehler beseitigt.
.snL
Neue Funktionen in MakeIPF 2.0
.sn
╢ externe Querverweise (external links) zu separaten HLP- und INF-Dateien hin
╢ Programme starten mittels Querverweise
╢ automatische Duplizierung von Kapitelⁿberschriften im Flie▀text, Kapitelⁿberschrift als Querverweis-Sprungziel, Aufnahme von Kapitelⁿberschriften in den Index
╢ zahlreiche neue Fehlermeldungen, die sonst erst beim IPFC-Compiler kommen
╢ Tabs werden automatisch in die entsprechende Anzahl Leerzeichen verwandelt (nur bei Schrift mit festen Schritten sinnvoll)
╢ verbesserte Fensteranordnung (siehe letzten Absatz im besagten Kapitel)
╢ Registrierung ⁿber Compuserve
.snL
Bereinigte Fehler in (neuer Name) HyperMake 2.9
.sn
╢ "link to subchapters = NO" fⁿhrte zu Programmabsturz
╢ Bei Verwendung der IPFC Version 2.1 von 1993 und der Einstellung "ASCIIHARDRET" fehlte in lΣngeren AbsΣtzen nach ca. 200 Buchstaben ein Leerzeichen.
╢ Bei der Einstellung "ASCIIHARDRET" traten Probleme mit unsortieren Listen auf.
.snL
Neue Funktionen in HyperMake 2.9
.sn
╢ zusΣtzlich HTML als Zielformat
╢ RⁿckwΣrts-Konvertierung von IPF nach HyperMake
╢ index filter
╢ mehrere Quelltexte (siehe Kommandozeilenparameter)
╢ (2.91) erste Version auch als Win32-Programm verfⁿgbar
╢ (2.91) Fu▀noten auch fⁿr HTML.
.snL
Neue Funktionen in HyperMake 3.0 (in Planung)
.sn
╢ Tables (Tabellen-Funktion) sowohl fⁿr IPF als auch fⁿr HTML
╢ direkte Eingabe von URLs in den Flie▀text, etwa fⁿr {HTTP://...} erscheint ein Globus-Icon
╢ Benutzer-Buttons in ErgΣnzung zu back, forward, content, index, sie zeigen dann auf bestimmte Kapitel
╢ Benutzer head tags, die in jede HTML-Datei kopiert werden
╢ andere ErgΣnzungen im Detail, die Ihnen abgehen! Kommentare erwⁿnscht.
Kⁿnftige HyperMake-Versionen wird es unter verschiedenen Betriebssystemen geben.
Fⁿr die Win32-Version plane ich, Microsofts neues kontextsensitives HTML zu unterstⁿtzen. Da es die alte Windows Hilfe denmnΣchst ersetzen soll, wird sich die Unterstⁿtzung des WinHelp Formates kaum mehr lohnen. Dafⁿr werde ich aber wahrscheinlich eine RⁿckwΣrts-Konvertierung nicht nur von IPF, sondern auch von RTF[Rich text format, bisheriges Eingabeformat der Windows-Hilfe] nach HyperMake anbieten.
Ich stelle mir vor, mit 3.0 im Februar 1997 fertig zu werden.
.2
Wo Updates?
.snL
Wo Sie HyperMake finden
.sn
Sie finden die neueste HyperMake OS/2 Version in Compuserve OS2UGER und OS2BVEN. Im Internet sind es die ⁿblichen OS/2-Adressen ftp-os2.nmsu.edu, ftp.cdrom.com/pub/os2 und auf dem Mⁿnchner ftp.leo.org/pub/comp/os/os2.
Die Win32-Version gibt es auf ftp.leo.org/pub/comp/os/win95 und im Compuserve in WINGER und GERWIN.
Die OS/2-Version finden Sie unter Hmakeo*.ZIP.
Die Win32-Version finden Sie unter HmakeW*.ZIP.
Haben Sie Ideen zu neuen Funktionen fⁿr HyperMake? Ich freue mich ⁿber jeden Kommentar oder Verbesserungsvorschlag.
.2
Warenzeichen
IBM und OS/2 sind eingetragene Warenzeichen der International Business Machines Corp.
WordStar ist eingetragenes Warenzeichen von MicroPro.
SpeedPascal ist ein Warenzeichen von SpeedSoft GmbH.
TurboPascal ist eingetragenes Warenzeichen von Borland Corp.
Windows ist eingetragenes Warenzeichen von Microsoft.
.2
Betriebssysteme
.iv verschiedene Betriebssysteme
Sie waren bestimmt von der Verarbeitungsgeschwindigkeit sehr angetan. Dabei gibt es eine kleine ▄berraschung: Ich habe das Programm nicht in C geschrieben, sondern mit Speed-Pascal[SpeedSoft, Chemnitz], einem TurboPascal-kompatiblen OS/2-Compiler mit IDE. Er erzeugt sowohl OS/2- als auch Win32-Programme. Fⁿr die Zukunft ist noch Powermac, Linux und AIX geplant, so da▀ es auch fⁿr diese Plattformen HyperMake geben wird.
.2
Andere Progs
Ich habe noch einige kleine Programme programmiert, es ist meist Freeware. Au▀er Textbuch sind es nur OS/2-Programme (bis jetzt...), alle Programme haben auch deutsche Dokumentation.
╢ ⌐PMCALC20⌐ PmCalc 2.0, ein PM Taschenrechner mit automatischer Zwischenablagenunterstⁿtzung, hex und wissenschaftlichen Funktionen (auch in deutsch, Shareware)
╢ ⌐TINYALRM⌐ TinyAlarm 2.1, Uhr mit Eieruhr als Schieber von 1 bis 60 and einem Wecker, bei dem man eine Weckzeit einstellen kann
╢ ⌐ZIPSHELL⌐ Simple Zipshell, eine Handvoll kleiner Batch-Dateien, um mit ZIP- und ARJ-Dateien elegant ⁿber die WPS umgehen zu k÷nnen (auch in Deutsch)
╢ ⌐CD_SHORT⌐ CD Shortcut 2.0, Abkⁿrzung fⁿr den CD-Befehl. Statt vollstΣndiger Verzeichnisnamen gibt man nur Wortteile ein (Anleitung auch in Deutsch)
╢ ⌐CLEAR10G⌐ Clear 1.0, erzeugt Dateilisten zum zippen auf Disketten und zum L÷schen, mit komplexen Auswahlkriterien
╢ ⌐TEXTBUCH⌐ 1.0 (auch DOS, nur deutsch).
Doppelte Buchfⁿhrung fⁿr SelbstΣndige und kleine bis mittlere GmbH's. Arbeitet wie ein Compiler. Input und Output sind Textdateien. Umfangreiche INF-Datei (OS/2-Version), Textdatei (DOS-Version), HTML-Datei (Win32-Version). Shareware bei > 350 BuchungssΣtze pro Jahr.
Sie finden die OS/2-Programme in Compuserve OS2UGER 7 und im Internet unter ftp.leo.org/pub/comp/os/os2.
