OS/2 Shareware BBS: 10 Tools/10-Tools.zip/hmakeos2.zip/German/hymake.hlp

OS/2 Help File | 2002-04-20 | 272KB | 7,256 lines

═══ 1. EinfБhrung ═══


Hypermake (bis Version 2.0 MakeIPF) dient der einfachen Erstellung von
HTML-Seiten, Winhelp, Microsoft HTML-Help (mit der Dateiendung CHM), IBM Hilfe
(INF- und HLP-Dateien des Betriebssystems OS/2) sowie RTF (Rich text format)
zum Einlesen in Textverarbeitungsprogramme. Statt direkt HTML-, RTF- oder
IPF-Dateien zu editieren, wird ein ASCII-Rohtext erstellt, der weitaus weniger
Kommandos enthДlt und das gleichzeitige Schreiben aller genannten Zielformate
ermФglicht. Querverweise werden automatisch gezogen, mit nur einem Befehl
werden Fenster verschiedener Gliederungsebenen gleichzeitig angezeigt, am Ende
eines Kapitels wird automatisch auf Unterkapitel verwiesen und vieles mehr.

Hypermake existiert derzeit als Win32 (Windows 95, 98, ME, NT, 2000, XP), als
OS/2- und, nur in der Kommandozeilenversion, als DOS Version. Wenn Nachfrage
nach einer Linux-Version besteht, werde ich dies auch unterstБtzen.

Das Hypermake-Programm gibt es jeweils in zwei Varianten: HMAKE.EXE ist ein
Kommandozeilenprogramm ohne BenutzeroberflДche und ist fБr Experten gedacht,
die das Programm in eigene Umgebungen einbinden wollen. HYMAKE.EXE ist das
Programm mit BenutzeroberflДche: integrierter Editor, Einstellungen-Buch und
weitere Dialogfenster. Technisch sind die beiden Programme voneinander
unabhДngig, funktional aber vФllig identisch. Diese Dokumentation beschreibt
beide Programmvarianten.

Sie kФnnen zwar Hypermake dafБr nutzen, nur eine kleine Homepage zu schreiben
(fБr kleine Textmengen ist Hypermake sogar kostenlos), aber dafБr ist Hypermake
eigentlich nicht gedacht. Seine StДrke liegt in der Erstellung grФсerer
Dokumente wie komplexer Homepages, wissenschaftlicher Arbeiten oder
Programmdokumentationen mit Inhaltsverzeichnis und Stichwortverzeichnis
(Index). Der Schwerpunkt liegt auf Verarbeitung von strukturiertem Text, nicht
auf Grafiken - auch wenn Hypermake das Einbinden von Grafiken auf
verschiedenerlei Weise erlaubt.

Wenn Sie Hypermake verwenden, mБssen Sie lediglich das vergleichsweise einfache
Hypermake-Format erlernen. Sie kФnnen Hypermake Quelltexte mit dem integrierten
ASCII-Editor oder mit einem externen Editor (ISO oder IBM Zeichensatz, mit oder
ohne Zeilenumbruch) benutzen. Den integrierten Hypermake Editor gibt es
Бbrigens auch als separates Freewareprogramm WSedit.

Um ihre Texte ins Hypermake Format zu bekommen, bietet Hypermake eine
RБckwДrts-Konvertierung von den Formaten RTF und IPF nach Hypermake-Quelltext.

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 erzeugt Querverweise (engl. links) von allen
      gleichlautenden AusdrБcken im Text zur markierten Textstelle hin sowie
      einen entsprechenden Eintrag im Index (Stichwortverzeichnis). Es werden
      auf verschiedene Weise auch externe Querverweise unterstБtzt, so z.B. von
      OS/2-Hilfe- und Winhelp4-Dateien ins WWW.

     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. Es werden entsprechende Navigationsbuttons
      angelegt.

     Automatische Erstellung von Inhaltsverzeichnissen
      Der Hypertext erhДlt eine Seite mit Links zu allen Kapiteln. In HTML kann
      zwischen einer Darstellung als unsortiere Liste und einer Javascript
      Baumansicht gewДhlt werden, bei der Unterkapitel auf- und zuklappbar
      sind.

     Automatische Erstellung von Helptables bzw. Konstanten
      FБr OS/2- und Windows-Hilfedateien 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-, C- oder PAS-Datei eingebunden werden kann.

     Automatische Erstellung von Querverweisen zu Unterkapiteln
      Am Ende eines Hauptkapitels, vor dem ersten Unterkapitel, werden
      Querverweise zu allen Unterkapiteln und zum nДchsten Hauptkapitel
      erstellt.

     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 (IPF drei) Fenster
      verschiedener Gliederungsebenen, also Kapitel, Unterkapitel,
      Unterunterkapitel, erscheinen so gleichzeitig, vgl. Beispiel
      Fensteranordnung. (Diese Funktion steht fБr Winhelp3 nicht zur VerfБgung
      und wird von den anderen Hypertextformaten unterschiedlich umgesetzt.)

     Einfache Erstellung von Fuсnoten
      Bei HTML werden Fuсnoten Бber Frames realisiert, bei OS/2-Hilfe,
      Windows-Hilfe und Windows-98-Hilfe Фffnet sich pro Fuсnote ein kleines
      Fuсnotenfenster.

     Tables (Tabellen)
      Tabellen werden wie bei einer ASCII-Datei mit festen Schritten
      eingegeben. Hypermake setzt dies in HTML-, RTF- bzw. IPF-Kommandos um.

     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.)

 Unterkapitel:
 Die unterstБtzten Hypertext-Formate
 Wie Hypermake Hypertexte erstellt

 nДchstes Hauptkapitel:
 Graphische Version HYMAKE.EXE


═══ 1.1. Die unterstБtzten Hypertext-Formate ═══


Unterkapitel:
HTML
IPF (IBM-Hilfe)
Winhelp
RTF Rich text format
MS HTML-Help

nДchstes Hauptkapitel:
Wie Hypermake Hypertexte erstellt


ΓòÉΓòÉΓòÉ 1.1.1. HTML ΓòÉΓòÉΓòÉ

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.

Das Zielformat HTML ist das einzige von Hypermake unterstБtzte Zielformat,
dessen Dateien direkt gelesen werden kФnnen, ohne einen weiteren Compiler zu
benФtigen.

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 von Hypermake unterstБtzte Entwicklungsstand von HTML ist 3.2. Die
wichtigste Neuerung von 3.2 sind Frames (Fensteranordnung). Mit Hypermake
erzeugte HTML-Dateien, die Frames enthalten, kФnnen auch mit Дlteren Browsern
betrachtet werden, dann natБrlich ohne Frames.

Der aktuelle Stand von HTML ist 4.0. Hypermake wird in der Zukunft an neue
EntwicklungsstДnde von HTML angepaсt. Stylesheets werden derzeit noch nicht
unterstБtzt, dies ist aber fБr kБnftige Programmversionen geplant.

Bei der Entwicklung von Hypermake wurde und wird weiterhin streng darauf
geachtet, daс keine proprietДren HTML-Dialekte erzeugt werden, die dann nur vom
Netscape- oder nur vom Microsoft-Browser dargestellt werden kФnnen.

Das W3C Konsortium fБhrt die Standardisierungen von HTML durch. Informationen
zum offiziellen HTML-Standard finden Sie auf dem W3C-Server:
http://www.w3.org/pub/WWW/TR

Es gibt auch eine deutsche Vertretung:
http://www.gmd.de


ΓòÉΓòÉΓòÉ 1.1.2. IPF (IBM-Hilfe) ΓòÉΓòÉΓòÉ

IPF-Dateien (Information Presentation Facility) sind das Ausgangsformat fБr die
IBM Hilfe. Es hat deutliche Оhnlichkeiten mit HTML, gehФren doch beide Formate
der Sprachfamilie SGML an. Von beiden Sprachen ist HTML jedoch die sauberer
definierte. IPF hat einige unlogische Eigenheiten und ist dadurch besonders
mБhsam direkt zu editieren.

Die IBM-Hilfe ist das Hilfeformat fБr die IBM-Produkte OS/2 und PC-DOS 7. Es
wird auch auf Windows-Plattformen verwendet, wenn Programme mit
plattformБbergreifenden IBM Entwicklungssystemen geschrieben werden. Es ist von
allen Hypertextformaten das funktionalste, schnellste und ausgereifteste.

IBM-Hilfedateien gibt es als INF- und HLP-Dateien. INF-Dateien werden einzeln
betrachtet, HLP-Dateien werden immer nur zusammen mit ausfБhrbaren Programmen
verwendet. Vom Anwendungsprogramm aus kФnnen Seiten der HLP-Datei aufgerufen
werden.

Die von Hypermake generierten IPF Dateien sind das Ausgangsmaterial fБr den
IBM-Compiler IPFC , der daraus dann eine INF- oder HLP-Datei erzeugt.

IBM INF und HLP Dateien sind kompakte BinДrdateien. IBM INF Viewer gibt es fБr
OS/2 (das Format aller OS/2-Programmdokumentationen), fБr Win16 und fБr DOS.
Der Windows IBM INF Viewer ist im Internet auf ftp://ftp.leo.org unter dem
Dateinamen win_inf.zip verfБgbar (225 kB). Der DOS Viewer ist in IBM DOS 7
enthalten und es gibt auch ein Freewareprogramm (VIEW01.ZIP Compuserve OS2DF1).

Wenn Sie Windows benutzen und sich fБr dieses Hypertext-Format interessieren,
so kФnnen Sie sich den Windows IBM INF Viewer herunterladen. Wenn Sie dann noch
mit Hypermake erzeugte IBM INF-Dateien zum Testen benФtigen, laden Sie doch
beispielsweise mein Sharewareprogramm pmCalc in der OS/2-Version von meiner
Homepage.

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, Grafiken usw. sind alle auch
 im IBM INF-Format enthalten.

 Hypermake bietet eine RБckwДrts-Konvertierung von IPF ins Hypermake
 Quelltextformat.


ΓòÉΓòÉΓòÉ 1.1.3. Winhelp ΓòÉΓòÉΓòÉ

Das Winhelp-Format ist ein binДres Hypertextformat. Das Ausgangsformat zur
Erstellung von Winhelp-Dateien ist ein spezielles RTF-Format (Rich Text
Format). Es ist das kryptischte von allen Hypertext-Ausgangsformaten und das
einzige, das praktisch gar nicht von Hand erstellt werden kann. Mit Windows 98
und Windows 2000 wird dieses Format nach und nach durch MS HTML-Help abgelФst.
Doch Winhelp wird weiterhin gerne benutzt, da es kompakter und schneller ist
und auch auf Дlteren Windows-Versionen lesbar ist.

Winhelp-Dateien kФnnen aus einem Windows-Programm heraus oder als separate
Dateien gestartet werden.

Von Winhelp gibt es zwei Versionen: Winhelp Version 3 und Winhelp Version 4 (im
folgenden einfach Winhelp3 und Winhelp4 genannt). Die Version 3 ist das
Hypertextformat von Windows 3.1, wДhrend Version 4 das Hypertextformat der
32-bit-Versionen Windows 95 und Windows NT und spДter ist. Winhelp4 Hilfetexte
kФnnen nur dann von Windows 3.1 gelesen werden, wenn Win32s in der Version 1.30
oder spДter installiert ist.

Die Winhelp-Viewer von Windows 95 und Windows NT sowie spДterer
Windows-Versionen kФnnen Winhelp3-Dateien lesen, umgekehrt kФnnen die
16-bit-Windows-Versionen das Winhelp4-Format aber nicht lesen.

Winhelp4 hat, im Zusammenhang mit Hypermake gesehen, folgende Vorteile:

     Es gibt ein Inhaltsverzeichnis (CNT-Datei) mit aufklappbaren
      Gliederungsebenen. (Die CNT-Datei muс der HLP-Datei beigelegt werden.)
     Was bei HTML mit Frames mФglich ist, kann bei Winhelp4 Бber zwei Fenster
      erzeugt werden: Im einen Fenster das Бbergeordnete Kapitel, im anderen
      das jeweilige Unterkapitel.
     Es ist mФglich, aus Winhelp4-Dateien heraus HTML-Seiten, auch im WWW,
      aufzurufen. Dabei wird der Browser gestartet, der die
      Standard-VerknБpfung mit der Endung HTM bzw. HTML hДlt.


 Um aus den von Hypermake erzeugten RTF-Dateien Winhelp-Dateien zu erzeugen,
 benФtigen Sie den Microsoft Winhelp-Compiler. Die Steuerdatei, Бber die der
 Winhelp-Compiler aufgerufen wird, hat die Endung HPJ (Help Project).

 Die Winhelp3-Version heiсt hc31.exe oder hcp.exe und ist ein
 DOS-Kommandozeilenprogramm. Eine besonders kompakte Zip-Datei (100k) kann Бber
 die Hypermake Homepage heruntergeladen werden. Der Compiler ist ein
 DOS-Kommandozeilenprogramm, welches unter DOS, Windows 3.1 und OS/2 arbeitet.
 FБr die Verwendung unter OS/2 empfiehlt sich der hc31.exe, der im Archiv auf
 meiner Homepage enthalten ist.

 Die Version 4 lДuft unter Windows95 sowie NT und verfБgt Бber eine graphische
 OberflДche, kann aber auch Бber die Kommandozeile benutzt werden (hcrtf.exe).
 http://support.microsoft.com/download/support/mslfiles/HCWSETUP.EXE (1,6 MB)

 Hypermake bietet eine RБckwДrts-Konvertierung von RTF ins Hypermake
 Quelltextformat.

 Unterkapitel:
 Fehlermeldungen beim Winhelp-Compiler

 nДchstes Hauptkapitel:
 RTF Rich text format


ΓòÉΓòÉΓòÉ 1.1.3.1. Fehlermeldungen beim Winhelp-Compiler ΓòÉΓòÉΓòÉ

Die Winhelp-Compiler haben einige lДstige BeschrДnkungen und sind in der
Interpretation der RTF-Befehle sehr "pingelig". In den entscheidenen Punkten
hat sich bei Winhelp4 nichts gegenБber Winhelp3 geДndert. Die Fehlermeldungen
lassen oft kaum RБckschlБsse auf die wahre Fehlerursache zu.

So gibt es etwa bei hДufiger Verwendung von Tables Probleme ("32 columns
limit") - der einzige Rat ist, einige Tabellen durch normalen Text in fester
Schrift zu ersetzen.

Wenn ein Fehler "error at offset..." kommt, ist die dann ausgegebene Position
in der Datei hДufig das Dateiende. Es sind dann mehr { "Auf" als } "Zu"
Klammern enthalten. Das lДсt dann jedoch auf einen Fehler in Hypermake
schlieсen. Senden Sie mir in diesem Fall bitte Quelltext und Ini-Datei.

Manchmal kommt auch eine Fehlermeldung "error in topic...". Hypermake schreibt
in die RTF-Datei Kommentare in Form von "ThisIsTopic...". Daran kФnnen Sie sich
orientieren, um wenigstens das Kapitel (entspricht "topic") zu finden, in dem
der Fehler aufgetreten ist.

RegelmДсig kommt die Warnung "using old phrase table". In der Datei
Projektname.ph speichert der Winhelp Compiler Zwischenergebnisse ab. Diese
Datei kФnnen Sie von Zeit zu Zeit lФschen.


ΓòÉΓòÉΓòÉ 1.1.4. RTF Rich text format ΓòÉΓòÉΓòÉ

Seit Hypermake 4.0 kann neben den Hypertext-Zielformaten auch noch reiner
RTF-Text (Rich text format) als Zielformat erzeugt werden. Ъbersetzt heiсt dies
soviel wie "(an Formatieranweisungen) reiches Textformat". RTF dient als
programm-Бbergreifendes Austauschformat von Texten. Das RTF-Format wird von den
meisten Textverarbeitungsprogrammen eingelesen, so daс Бber diesen Weg etwa fБr
eine Programmdokumentation neben der Hypertext-Form auch eine gedruckte Form
erzeugt werden kann.

Da das RTF-Format auch fБr die Erzeugung von Windows Hilfe (Winhelp) genutzt
wird, sind die von Hypermake erzeugten reinen RTF-Dateien den speziellen
Winhelp-RTF-Dateien Дhnlich. Im wesentlichen werden bestimmte
Winhelp-spezifische Kommandos weggelassen oder in einer fБr
Textverarbeitungsprogramme gut verwertbaren Form dargestellt, z. B. Fuсnoten
nicht als Popup-Fenster, sondern als klassische Fuсnoten am unteren Seitenrand
des Papiers.


ΓòÉΓòÉΓòÉ 1.1.5. MS HTML-Help ΓòÉΓòÉΓòÉ

Microsoft HTML-Help hat in Windows 98, Windows 2000 und spДter die bisherige
Windows-Hilfe ersetzt, doch wird Winhelp auf lange Zeit weiter unterstБtzt.
Microsoft HTML-Help Es basiert auf HTML: HTML-Dateien, die zum Teil
Microsoft-eigene Erweiterungen enthalten (die nicht vom W3C Konsortium
standardisiert wurden), sind das Rohmaterial, aus dem der HTML-Help-Compiler
dann eine binДre Datei mit der Endung CHM (compiled HTML) erzeugt. Wesentliche
Neuerung sind ein aufklappbares Inhaltsverzeichnis (HHC-Dateien) sowie ein
Index, also ein Stichwortverzeichnis (HHK-Dateien).

Die Steuerdatei, Бber die der HTML-Help-Compiler aufgerufen wird, hat die
Endung HHP (HTML-Help Project).

Aufgrund der erforderlichen AbwДrtskompatibilitДt werden
Microsoft-Betriebssysteme in den nДchsten Jahren auch noch die alte
Windows-Hilfe unterstБtzen.

Den MS HTML-Help-Compiler erhalten Sie Бber das Internet:
http://www.microsoft.com
dann bei search HTML-HELP eingeben

Bei Windows 95 und NT 4.0 ist der erforderliche Viewer (HH.EXE) nicht
vorhanden. Dieses Programm ist erst in Windows 98 und NT 4.0 SP4 und natБrlich
Windows 2000 enthalten. Wenn fБr eine Win32-Applikation nicht ohnehin
alternativ auch eine Winhelp-Datei ausgeliefert wird (was mit Hypermake nicht
schwerfДllt), so muс zumindest fБr die nДchste Zeit der HTML-Help-Viewer HH.EXE
mitgeliefert werden. Diese Datei ist Bestandteil des HTML-Help Workshops und
befindet sich gewФhnlich im Windows Verzeichnis.

Seit MS HTML-Help 1.1 gibt es auch die MФglichkeit, die HTML-Hilfe so zu
erzeugen, daс auf Rechnern mit Windows 95 keine zusДtzliche Software
eingespielt werden muс. Allerdings fБhrt dies zwangslДufig trotzdem zu grФсeren
Datenmengen.


ΓòÉΓòÉΓòÉ 1.2. Wie Hypermake Hypertexte erstellt ΓòÉΓòÉΓòÉ

Hypermake erzeugt einen Hypertext aus einem Quelltext, den Sie zuerst erstellen
mБssen. Das Erstellen eines Hypertextes geschieht in folgenden Schritten:

     Sie schreiben einen ASCII Text in der Hypermake Schreibweise. HierfБr
      kФnnen Sie entweder den internen Hypermake-Editor oder auch einen
      externen beliebigen Editor verwenden. Das Hauptkapitel Erstellen eines
      Hypermake Quelltextes erlДutert die Logik und Schreibweise eines solchen
      Quelltextes.

     In den Projekt-Einstellungen kФnnen Sie zahlreiche Einstellungen
      verДndern und so das Aussehen des spДteren Hypertextes beeinfluсen. Hier
      stellen Sie auch ein, welches Hypertext-Format sie Бberhaupt erstellt
      haben mФchten.

     Ein Doppelklick in das obere Meldungsfenster mit der blauen Schrift (wenn
      Sie die graphische Version von Hypermake verwenden) bzw. das Aufrufen der
      Kommandozeilenversion startet das Verarbeiten: anhand der festgelegten
      Einstellungen Бbersetzt Hypermake den Quelltext in das vorher ausgewДhlte
      Hypertext-Zielformat. Das Verarbeiten geschieht "in einem Rutsch" und
      kann nicht abschnittsweise ausgefБhrt werden.

     Nur HTML kann sofort mit einem Browser angesehen werden. Alle anderen
      Formate erfordern noch einen "zweiten Compiler". In diesen FДllen erzeugt
      Hypermake nicht die endgБltige Hypertext-Datei, sondern nur ein
      Rohformat, das mit dem "zweiten Compiler" dann zum endgБltigen Hypertext
      verarbeitet wird. Dieser "zweite Compiler" ist fБr Winhelp der
      Winhelp-Compiler, fБr IBM Hilfe der IPF-Compiler von IBM und fБr
      HTML-Help der Microsoft HTML-Help Compiler. Sie kФnnen Hypermake so
      konfigurieren, daс Hypermake selbst den zweiten Compiler startet, so daс
      es quasi aussieht, als ob Hypermake gleich den endgБltigen Hypertext
      erzeugt.


 Alle Einstellungen in den Projekt-Einstellungen der graphischen Version von
 Hypermake werden in der Ini-Datei gespeichert. Das ist eine ASCII-Datei, die
 Sie prinzipiell auch mit einem ASCII-Editor editiern kФnnen. Dann gibt es noch
 eine HMP-Datei (Hypermake Projekt-Datei, ebenfalls ASCII), in der die
 Einstellungen der "main" Seite der Projekt-Einstellungen gehalten werden. Die
 HMP-Datei enthДlt insbesondere den Namen des Quelltextes und den Namen der
 Ini-Datei.

 Nachdem Hypermake aufgerufen wurde, geht das Programm wie folgt vor:

     Einlesen der Ini-Datei
     Einlesen des Quelltextes
      Der Quelltext wird mit einem Schlag in den Speicher geladen (nicht bei
      der DOS-Version)
     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 Speicher abgelegt.
     Schreiben der IPF/RTF-Datei oder der HTML-Dateien
      Zuletzt wird die IPF/RTF-Datei bzw. werden die HTML-Dateien erstellt, was
      die Hauptarbeit ist. Jedes Wort des Hypertextes muс mit den indizierten
      WФrtern aus dem Speicher verglichen werden, um ggfs. Querverweise zu
      ziehen. Hier werden auch die meisten Punktbefehle und Umschalter
      ausgewertet sowie Helptables erstellt. HTML-Dateien werden in ein ggfs.
      neu anzulegendes Verzeichnis gespielt.


 Beim Indizieren von KapitelБberschriften, Indizieren von Querverweisen und dem
 Schreiben der Zieldatei wird fБr jedes bearbeitete Kapitel (Fenster) der
 ZДhler am Bildschirm um eins erhФht.

 In der graphischen Version wird beim Indizieren von Ъberschriften und von
 Querverweisen nur das rote Display hochgezДhlt, nicht aber der grБne
 Fortschrittsbalken, dieser wird nur beim Schreiben der Zieldatei aktiv.

 ErtФnt ein tiefer Piepston, so hat Hypermake einen so schweren Fehler
 gefunden, daс die IPF-/RTF-Datei bzw. die HTML-Dateien nicht erstellt werden
 konnten.

 In der graphischen Versiion erscheinen Fehler im mittleren Meldungsfenster in
 roter Farbe.

 Wird nur ein kleiner Fehler gefunden, so wird zwar das Schreiben des
 Zielformates beendet, der zweite Compiler aber nicht gestartet.

 Welche Dateien erzeugt Hypermake?

 Bei HTML wird ein neues Verzeichnis mit dem Projektnamen angelegt, das die
 HTML-Dateien enthДlt. Als Dateinamen-Erweiterung fБr HTML-Dateien wird ".HTML"
 oder ".HTM" gewДhlt, abhДngig von Betriebssystem und Einstellungen in der
 Ini-Datei. ZusДtzlich wird noch eine HTML-Datei mit dem Projektnamen erzeugt
 (sog. Info-Datei), die als Einstieg in die HTML-Dateien gedacht ist und fБr
 Sie interessante Infos Бber das Projekt enthДlt.

 Wenn IBM Hilfe gewДhlt wurde, so erzeugt Hypermake eine IPF-Datei, die der
 Input fБr den IBM IPFC Compiler ist.

 Wenn Winhelp erzeugt wird, so legt Hypermake eine einzelne RTF-Datei an.
 AbhДngig vom Schalter contents creation in der Ini-Datei bzw. in den
 Projekt-Einstellungen auf der Seite "Winhelp" wird eine
 CNT-Inhaltsverzeichnisdatei angelegt oder nicht. CNT-Dateien kФnnen nicht mit
 Windows 3.1 angeschaut werden. Auf jeden Fall wird eine HPJ-Steuerdatei
 angelegt. Ein Doppelklick auf die HPJ-Datei ruft den Winhelp-Compiler auf. Bei
 der Benutzung der Kommandozeile wird die PRJ-Datei als Parameter dem Programm
 HC, HCW oder HCRTF Бbergeben.

 FБr RTF Text wird wie bei Winhelp eine einzelne RTF-Datei erzeugt. In das
 selbe Verzeichnis werden ggfs. Grafikdateien kopiert, die Bestandteil des
 Dokuments sind. Die RTF-Datei beginnt mit einem Inhaltsverzeichnis, aber ohne
 Seitennummern, weil diese abhДngig von der Formatierung im
 Textverarbeitungsprogramm sind.

 Wenn MS HTML-Help erzeugt wird, so wird wie bei normalem HTML ein neues
 Verzeichnis mit dem Projektnamen angelegt, das die HTML-Dateien enthДlt. Das
 Inhaltsverzeichnis- und Stichwortverzeichnis ist anders als bei normalem HTML
 und hat die Endung HHC und HHK. Die MS HTML-Help Steuerdatei befindet sich im
 neuen Verzeichnis und hat die Endung HHP. Ein Doppelklick auf die HHP-Datei
 startet den MS HTML-Help Compiler.

 Denken Sie daran, daс Sie keine Sicherungskopien der Dateien erzeugen mБssen,
 die Hypermake generiert, da Sie sie jederzeit aus dem Quelltext neu erstellen
 kФnnen.

 Zielverzeichnis und Grafikdateien

 Bei jedem Zielformat kopiert Hypermake die Grafiken aus den Verzeichnissen,
 die unter graphic path in der HMP-Datei ("Grafik-Dateien" in den
 Projekt-Einstellungen auf Seite "Main") oder Ini-Datei angegeben wurden, in
 das Zielverzeichnis. Das Zielverzeichnis, in das Hypermake die Grafiken und
 (weitgehend) den Text-Output spielt, hДngt vom gewДhlten Zielformat ab: Bei
 HTML und HTMLHELP ist das der neu erzeugte Ordner, in den auch die
 HTML-Dateien gespielt werden und bei den anderen Formaten der gleiche Ordner,
 in dem sich auch der Quelltext befindet.


ΓòÉΓòÉΓòÉ 2. Graphische Version HYMAKE.EXE ΓòÉΓòÉΓòÉ


Unterkapitel:
Ъberblick
Hypermake Hauptfenster
Editor
Inhaltsverzeichnis- und Stichwortverzeichnis-Fenster
Programm-Einstellungen Buch

nДchstes Hauptkapitel:
Kommandozeilenversion HMAKE.EXE


═══ 2.1. Ъberblick ═══


Die graphische Version HYMAKE.EXE besteht aus:

     dem Hypertext-Compiler
     dem integrierten Editor fБr den Quelltext
     dem Projekt-Einstellungen Buch.


 Die Kommandozeilenversion HMAKE.EXE ist fБr Experten gedacht und stellt allein
 den Compiler, also die reine Verarbeitungsfunktion, als eigenstДndiges
 Programm zur VerfБgung. Vor Hypermake 4.0 gab es nur die
 Kommandozeilenversion.

 Einen Hypertext mit Hypermake zu erstellen, dauert nur wenige Sekunden - auch
 bei grФсeren Projekten. Den Quelltext einzugeben und die Projekt-Einstellungen
 auszuwДhlen ist dagegen zeitaufwendig. Der integrierte Editor der graphischen
 Version HYMAKE.EXE verfБgt Бber einige spezielle Eigenschaften:

     Syntax-Highlightning: farbliche Hervorhebung von Hypermake-Befehlen im
      Quelltext (Umschalter, Punktbefehle)
     kontext-sensitive Sprechblasen-Hilfe erlДutert Ihnen die schon im Editor
      eingetippten Hypermake-Kommandos
     mit dem "Funktions-Dialog" kФnnen Sie dialoggesteuert die
      Hypermake-Kommandos einfБgen, die Sie auch direkt in den Editor tippen
      kФnnen
     das Popup-MenБ im Editor (drБcken Sie an beliebiger Stelle im Editor die
      rechte Maustaste) enthДlt Hypermake-spezifische Kommandos (z.B.
      "Verarbeiten"), aber auch die Бblichen Kommandos eines Editors.


 Das Projekt-Einstellungen Buch enthДlt alle Einstellungen, die eine Auswirkung
 auf die FunktionalitДt und das Aussehen des spДteren Hypertextes haben, der
 vom Quelltext erzeugt wird. Diese Einstellungen werden in der HMP-Datei (Seite
 "Main") sowie in der Ini-Datei (alle anderen Seiten) gespeichert.

 Die graphische Version hat dann noch weitere Dialogfenster:

     ein Programm-Einstellungen Buch, das von Hypertext-Projekten unabhДngige
      Benutzer-Einstellungen enthДlt
     ein Inhaltsverzeichnis-Fenster und ein Stichwortverzeichnis-Fenster, das
      Auffinden von Stellen im Quelltext erleichtert.


 Alle diese Fenster kФnnen Sie Бber das MenБ des Hypermake-Hauptfensters
 (Ansicht) erreichen.

 Das Projekt-Einstellungen Buch ist sehr umfangreich und wird eigens
 beschrieben.


ΓòÉΓòÉΓòÉ 2.2. Hypermake Hauptfenster ΓòÉΓòÉΓòÉ

Das Hypermake Hauptfenster erscheint als erstes, wenn Hypermake per Doppelklick
auf eine HMP-Datei oder direkt (HYMAKE.EXE) gestartet wird. Wenn ein anderes
Fenster Бber dem Hauptfenster liegt, kann es mit F6 wieder hergeholt werden.

MenБ des Hauptfensters

     Projekt
        -  Neu: Damit kФnnen Sie ein neues Hypermake Projekt beginnen. Sie
           werden nach einem Namen fБr die HMP-Datei (Hypermake Projektdatei),
           nach einer Ini-Datei, von der Sie die Projekt-Einstellungen
           Бbernehmen wollen (z. B. BEISPIEL.INI aus der Hypermake
           Archivdatei), einen Dateinamen fБr die neue anzulegende Ini-Datei
           und einen Dateinamen fБr den Quelltext.
        -  Щffnen: Фffnet ein schon bestehendes Hypermake-Projekt (HMP-Datei)
        -  Sichern: speichert das Projekt, und zwar sowohl HMP-Datei als auch
           Ini-Datei sowie Quelltext.
        -  Sichern unter: speichert das aktuelle Projekt unter einem anderen
           Namen. Wenn Sie auch die Ini-Datei und/oder den Quelltext umbenennen
           mФchten, mБsssen Sie dies selbst auf der "Main" Seite in den
           Projekt-Einstellungen tun.
        -  Verarbeiten zu: startet das Verarbeiten (Compilieren). Es wird das
           Zielformat erzeugt, das sie hier auswДhlen. Die Auswahl hier
           Бberschreibt die aktuelle Einstellung auf der Seite Main in den
           Projekt-Einstellungen. Siehe auch Verarbeitung. Sie kФnnen aber auch
           F9 drБcken oder in das Fortschrittsfenster (mit der blauen Schrift)
           doppelklicken, dies startet ebenfalls die Verarbeitung, dann mit dem
           in den Projekt-Einstellungen voreingestellten Zielformat.
        -  2ter Compiler: startet den zweiten Compiler eigens. Der zweite
           Compiler ist fБr alle Formate auсer HTML erforderlich. Beachten Sie,
           daс Оnderungen am Quelltext erst mit dem Verarbeiten ("erster
           Compiler") und zugleich dem zweiten Compiler zu einer Aktualisierung
           des endgБltigen Hypertextes fБhrt. Hypermake kann auch automatisch
           den zweiten Compiler starten (Seite "Main" in den
           Projekt-Einstellungen). Siehe Verarbeitung.
        -  Textdatei Фffnen: Der Hypermake-Editor ist sehr mДchtig. Vielleicht
           mФchten Sie ihn auch anderweitig nutzen. Mit "Textdatei Фffnen"
           kФnnen Sie eine beliebige Textdatei Фffnen. Je nach aktuellem
           Hypermake-Projekt wird die Textdatei mit ISO oder mit IBM
           Zeichensatz geladen. Syntax-Highlightning ist grundsДtzlich
           ausgeschaltet. Den Hypermake-Editor gibt es Бbrigens auch als
           separates Freeware-Programm namens WSedit.
        -  RTF/IPF importieren: siehe RБckwДrts-Konvertierung
        -  HTML-Verz. vergleichen startet den Dateienvergleich, mit dem Sie die
           Ъbersicht behalten, welche HTML-Dateien seit dem letzten Hochladen
           verДndert worden sind.
        -  Beenden: beendet das Hypermake-Programm.
     Ansicht (Фffnet verschiedene Hypermake-Programmfenster)
        -  Projekt-Einstellungen: Фffnet das Projekt-Einstellungen Buch, das
           die FunktionalitДt und das Aussehen des zu erzeugenden Hypertextes
           beeinfluсt (gespeichert in der HMP-Datei und der Ini-Datei)
        -  Quelltext: Фffnet den Editor mit dem Quelltext des aktuellen
           Projektes. Ein Projekt kann mehrere Quelltexte enthalten, die
           hintereinander verarbeitet werden. Um die Textdatei zu Фffnen,
           kФnnen Sie auch auf das Dropdownfeld im Hypermake-Hauptfenster
           doppelklicken.
        -  Inhaltsverzeichnis: zeigt das Inhaltsverzeichnis des aktuellen
           Projekt-Quelltextes in einer Baumansicht. Es ermФglicht Ihnen,
           bestimte Stellen im Quelltext gezielt anzuspringen.
        -  Stichwortverzeichnis: Auch das Stichwortverzeichnis-Fenster hilft
           Ihnen Stellen im Quelltext anzuspringen. Alle markierte AusdrБcke
           werden hier alphabetisch aufgefБhrt.
        -  Programm-Einstellungen: Das Projekt-Einstellungen Fenster enthДlt
           alle Schalter, die sich nicht auf ein bestimmtes Projekt beziehen,
           z.B. den Dateinamen des Internet-Browsers zum Anzeigen der erzeugten
           HTML-Dateien.
        -  Funktions-Baumansicht: zeigt den Funktions-Dialog, mit dem Hypermake
           Quelltext-Kommandos an die aktuelle Cursorposition im Editor kopiert
           (kann auch Бber das Editor Popup-MenБ Funktion - Baumansicht
           aktiviert werden).
        -  Endergebnis: ruft den erzeugten Hypertext mit dem vorgesehenen
           Programm auf: den Internet-Browser fБr HTML-Dateien bzw. den
           entsprechenden Hilfebetrachter.
     Editieren entspricht weitgehend dem Popup-MenБ im Editor (rechte
      Maustaste im Textbereich drБcken). Darin sind sowohl die Бblichen
      Editor-Befehle als auch Hypermake-spezifische Befehle enthalten.

     Hilfe
        -  Information: zeigt die Versionsnummer an.

 Weitere Elemente im Hauptfenster

 (von links nach rechts)

 GrБne LED: leuchtet wДhrend der Verarbeitung. Alle Aufgaben, fБr die mehr Zeit
 als nur ein paar Millisekunden benФtigt werden, laufen in einem eigenen sog.
 Thread. Das bedeutet, wДhrend Hypermake innerhalb eines Threads arbeitet,
 kФnnen Sie z. B. im Quelltext tippen oder die Projekt-Einstellungen verДndern,
 wДhrend der Thread lДuft. Aber Sie kФnnen nicht eine weitere Aufgabe starten,
 wДhrend noch ein Thread lДuft und somit die grБne LED noch leuchtet.

 Stop: stoppt den laufenden Thread ("Benutzerabbruch"). Bestimmte Jobs wie der
 zweite Compiler kФnnen nicht unterbrochen werden.

 Dropdown-Editierfeld: enthДlt alle Quelltextdateien des aktuellen Projektes.
 Auswahl oder Doppelklick startet den Editor mit dem entsprechenden Quelltext.
 Der Name des Quelltextes wird auf der Seite "Main" der Projekt-Einstellungen
 festgelegt.

 Rote ZДhleranzeige: zДhlt die verarbeiteten Kapitel hoch. Meist kann man nur
 dem "langsameren" dritten Verarbeitungsgang (siehe Verarbeitung) folgen, die
 ersten beiden VerarbeitungsgДnge laufen sehr schnell ab.

 GrБner Fortschrittsbalken: zeigt beim dritten ("langsamen") Verarbeitungsgang
 den prozentualen Verarbeitungsfortschritt an. Er gibt auсerdem das derzeit
 gewДhlte Zielformat an, das auf der Seite "Main" des Einstellungen-Buches
 gewДhlt ist.

 Fortschrittsfenster: (blauer Text) WДhrend des Verarbeitens teilt Ihnen
 Hypermake mit, was es gerade macht. Ein Doppelklick in das Fortschrittsfenster
 hinein startet das Verarbeiten.
 Das Drag and Drop (ziehen und fallenlassen) von HMP-Dateien fБhrt zur selben
 Funktion wie "Projekt Ф ffnen". Auсerdem dБrfen Sie hier noch
 Verzeichnis-Symbole fallenlassen, dies aktiviert den Dateienvergleich, mit dem
 Sie die Ъbersicht behalten, welche HTML-Dateien seit dem letzten Hochladen
 verДndert worden sind.

 Allgemeines Fehlerfenster: (roter Text) WДhrend des Verarbeitens erscheinen
 hier Fehler und Warnungen.

 Quelltext-Fehlerfenster: (weiс) Hypermake listet hier Fehler und Warnungen
 auf, die sich auf eine bestimmte Zeile im Quelltext beziehen. Mit Doppelklick
 auf die entsprechende Zeile gelangt man zum Editor an die Stelle, wo der
 Fehler auftrat.


ΓòÉΓòÉΓòÉ 2.3. Editor ΓòÉΓòÉΓòÉ

Der in der graphischen Programmversion HYMAKE.EXE integrierte Editor ist sehr
leistungsfДhig und verarbeitet Textdateien bis zu einer DateilДnge von 15 MB.
Das einzige, was Sie wirklich wissen mБssen, ist daс er statt einem normalen
MenБ direkt unterhalb der Titelzeile ein sog. Popup-MenБ hat. Dieses wird
aktiviert, indem Sie innerhalb des editierbaren Fensterbereichs die rechte
Maustaste drБcken. Darin finden Sie sowohl die von jedem Editor her bekannten
Befehle als auch einige Hypermake-spezifische Befehle. Sie kФnnen aber statt
dem Popup-MenБ auch den MenБpunkt "Editieren" im Hypermake-Hauptfenster
aufrufen, die Befehle beziehen sich dann auf das oberste Editor-Fenster.

Wenn Sie den Mauszeiger Бber ein Hypermake-spezifisches Kommando (Punktbefehle
und Umschalter) innerhalb des Textes bewegen, so erscheint eine
Sprechblasen-Hilfe, die die Wirkung des entsprechenden Befehls erlДutert. Sie
kФnnen dieses Feature im Programm-Einstellungen Buch auf Seite "Prog"
ausschalten.

Wenn Sie den integrierten Editor mФgen, kФnnen Sie gerne auf meiner Homepage
das WSedit Programm herunterladen. Dieses Freewareprogramm entspricht dem
Hypermake Editor in der "Wordstar" Tastenbelegung und verfБgt Бber eine
detaillierte Beschreibung der Control-(Strng-)Tastenkommandos. WSedit verfБgt
Бber ein Dialogfenster, in dem alle Control-Befehle in einer Baumstruktur
aufgelistet sind und einige weitere Features.

Unterkapitel:
Titelzeile
Editor-MenБ
Farbmarkierungen der rechten Spalte
Tastenbelegung
Besondere FДhigkeiten des Editors
WortprБfung
Ъbersetzung

nДchstes Hauptkapitel:
Inhaltsverzeichnis- und Stichwortverzeichnis-Fenster


ΓòÉΓòÉΓòÉ 2.3.1. Titelzeile ΓòÉΓòÉΓòÉ


Die Titelzeile des Editor-Fensters zeigt eine ganze Reihe von Informationen an.

(4,226*) bedeutet Spalte 4, Zeile 226, der Stern * zeigt an, daс die Datei
gegenБber dem Zustand auf der Festplatte verДndert ist.

Die Nummer hinter "Abs" zДhlt die harten Returns, also die Anzahl der AbsДtze,
wobei die Punktbefehle auch mitgezДhlt werden. Da die Anzahl von Zeilen davon
abhДngig ist, wie breit gerade das Fenster ist, ist die "Abs" ZДhlung die
einzig zuverlДssige Zahl, eine bestimmte Textstelle wiederzufinden!

Darauf wird der Dateiname angezeigt.

Wenn der Spaltenblock aktiviert ist (Wordstar ^KN), erscheint "SPALTE". Wenn
die Datei nur lesbar ist (read only), so erscheint "NUR LESEN".


═══ 2.3.2. Editor-MenБ ═══


Sie kФnnen auf zweierlei Weise auf das Editor-MenБ zugreifen: Sie finden es
unter dem "Editieren" MenБpunkt im Hypermake-Hauptfenster, oder Sie drБcken an
beliebiger Stelle des Editorfensters die rechte Maustaste.

Im Editor-MenБ stehen auch die Tastenkombinationen des jeweiligen Befehls.
Diese Tastenkombinationen sind abhДngig von der Einstellung Optionen -
Tastenbelegung. Die Einstellung "Wordstar" ist die mДchtigste, weil es damit
fБr praktisch alle MenБ-Befehle auch Tastenbefehle gibt. Die Wordstar-Befehle
sind meist Kombinationen aus zwei Tasten sowie der Control-Taste (Strng),
beispielsweise Strng-K-R fБr "lese Block aus Datei".

In der folgenden Beschreibung werden nur besondere Befehle, die nicht zum
Standard-Befehlssatz eines Editors gehФren, genauer erlДutert.

UntermenБ Datei

Importiere TXT kopiert den Inhalt einer Datei an die aktuelle Cursorposition
und Exportiere TXT schreibt einen vorher ausgewДhlten Block in eine Datei.
Dabei gibt es keine Konvertierungs-FunktionalitДt.

Statt "Importiere TXT" kФnnen Sie auch ein Textdatei-Symbol in das Editorfeld
ziehen an eine gewБnschte Textstelle ziehen und fallenlassen.

UntermenБ Editieren

"Editieren" umfaсt eine Reihe bekannter Standard-Befehle eines jeden Editors,
aber auch einige interessante Zusatzfunktionen.

Widerrufen (undo) und Widerrufen rБckgДngig findet sich in manchen
komfortableren Editoren. Der Hypermake Editor verfБgt aber Бber eine besonders
leistungsfДhige Undo-FunktionalitДt: es gibt einen Undo Schieber, mit dem Sie
sehr bequem hunderte alter Eingaben rБckgДngig machen und das RБckgДngigmachen
auch wieder rБckgДngig machen kФnnen. In den Programm-Einstellungen kФnnen Sie
auf der Seite "Edit2" einstellen, wieviel Undo-Schritte Hypermake sich merken
soll.

Um zur zuletzt editierten Textstelle zu gelangen, kФnnen Sie einmal Widerrufen
(Alt-RБcktaste) drБcken.

ZusДtzlich zum normalen Suchen Befehl, der ein Dialogfenster Фffnet, gibt es
auch das inkrementelle Suchen ohne Dialog-Fenster. Achten Sie dabei auf die
Titelzeile, wДhrend Sie die einzelnen Buchstaben des zu suchenden Ausdrucks
eintippen.

UntermenБ Sonstiges

Hier finden Sie einige weitere Editor-Funktionen.

Alles neu formatieren formatiert den gesamten Text am Bildschirm neu, und zwar
genauso wie dies beim Verstellen der Fensterbreite ebenfalls geschieht.
StandardmДсig wird der Text am Bildschirm immer sofort beim Tippen schon
umgebrochen. Dies kann aber in den Programm-Einstellungen auf Seite "Edit2"
verДndert werden.

Cursor folgt Text macht z. B. bei Tabellen einen Unterschied: Wenn "Cursor
folgt Text" aktiviert ist, genauer gesagt die rechte bzw. linke Cursortaste dem
Text folgt, so kann eine noch nicht editierte Stelle im Editor-Fenster nur
durch das Eingeben von Leertasten erreicht werden. Wenn der Cursor nicht dem
Text folgt, so kann mit der rechten Cursortaste auch der Textbereich erreicht
werden, bei dem sich noch keine Zeichen befinden. Die Standardeinstellung
dieses Schalters kann auf der Seite "Edit2" der Programm-Einstellungen
festgelegt werden.

Hypermake und WSedit unterstБtzen zwei Arten von Ъbersetzung zwischen zwei
Sprachen: Sprechblasen-Ъbersetzung und Dialog-Ъbersetzung. Die
Sprechblasen-Ъbersetzung wird verwendet, um einen Text in einer Fremdsprache zu
lesen und die Dialog-Ъbersetzung fБr den umgekehrten Wege, wenn Sie in einer
Fremdsprache einen Text verfassen wollen.

Um die Ъbersetzungs-FunktionalitДt nutzen zu kФnnen, mБssen Sie zuerst die
entsprechenden Ъbersetzungs-Dateien aus dem Internet herunterladen. Sie finden
auf der WSedit Seite von meiner Homepage einen entsprechenden Verweis. Bislang
gibt es nur deutsch-englisch und englisch-deutsch. Geben Sie anschlieсend auf
der Seite "Edit1" der Programm-Einstellungen die Dateinamen an.

Sprechblasen-Ъbersetzung: das Wort bzw. der Ausdruck an der Cursorposition wird
Бbersetzt und die Ъbersetzung erscheint als gelbes Sprechblasen-Fenster beim
Mauszeiger.

Dialog-Ъbersetzung: aktiviert einen Dialog, in dem Sie den gewБnschten Ausdruck
in das Eingabefeld eintippen kФnnen und darunter mehrere ЪbersetzungsvorschlДge
in einer Listbox aufgelistet bekommen. Ist die Sprechblasen-Ъbersetzung
ebenfalls aktiviert, so werden die einzelnen ЪbersetzungsvorschlДge wieder
zurБckБbersetzt in die ursprБngliche Sprache, so daс Sie besser den passenden
Fremdsprachen-Ausdruck auswДhlen kФnnen.

Diese RБck-Ъbersetzung hat zugleich den Effekt eines Thesaurus: wenn ein
Ausdruck in eine andere Sprache Бbersetzt und darauf wieder zurБckБbersetzt
wird, erhalten Sie eine ganze Reihe Дhnlicher AusdrБcke.

Wenn Sie auf einen Listbox-Eintrag doppelklicken oder per Einfach-Klick einen
Ъbersetzungsvorschlag auswДhlen und danach OK drБcken, wird der Ausdruck im
MБlleimer abgelegt. Den MБlleimer kФnnen Sie an der Cursorposition mit Strng-U
ausleeren.

UntermenБ Funktion

Dieses UntermenБ bezieht sich auf Hypermake-spezifische Funktionen, die Sie in
den Hypermake-Quelltext einfБgen kФnnen. Wenn Sie die Hypermake Punktbefehle
nicht auswendig wissen, kФnnen Sie hier menБgesteuert entsprechende Befehle an
die aktuelle Cursorposition einfБgen. Baumansicht aktiviert ein Dialogfenster,
in dem die Hypermake Punktbefehle in einer Baumansicht aufgelistet sind und per
Doppelklick an die Cursorposition kopiert werden kФnnen. Die anderen Befehle im
UntermenБ "Funktion" sind die wichtigsten Befehle, die aber auch in der
ausfБhrlicheren Baumansicht enthalten sind.

UntermenБ Umschalter

Umschalter (toggles) werden paarweise verwendet. Zwischen zwei
Umschalter-Sonderzeichen gilt eine bestimmte Text-Funktion, z.B. Fett oder
Unterstreichung. Umschalter-Zeichen sind Zeichen, die sonst nicht im Text
verwendet werden, und oft sind sie gar nicht auf der Tastatur verfБgbar. Sie
kФnnen diese MenБpunkte verwenden, um die entsprechenden Umschalter-Zeichen an
der aktuellen Cursorposition einzufБgen.

Es gibt verschiedene Tastenkombinationen fБr denselben Umschalter. Z. B.
Umsch-F2 fБgt einen einzelnes Umschaltzeichen "kursiv" an der Cursorposition
ein, wДhrend Strng-F2 das Wort an der Cursorposition auf kursiv stellt und
somit gleich zwei Umschaltzeichen erzeugt. Alt-F2 fБgt am die Umschaltzeichen
am Zeilenanfang und Zeilenende ein, so daс eine ganze Zeile kursiv wird.

UntermenБ Programm

Dieses UntermenБ ist nur im Popup-MenБ verfБgbar, nicht im Editieren MenБpunkt
des Hypermake-Hauptfensters. Es enthДlt die wichtigsten MenБpunkte, die im
Hypermake-Hauptfenster unter "Projekt" und "Ansicht" zu finden sind. So haben
Sie Zugriff auf die wichtigsten Hypermake-Fenster und -Funktionen, ohne den
Editor verlassen zu mБssen.

UntermenБ Optionen

Das "Optionen" UntermenБ hДlt einige benutzerdefinierte Einstellungen. Einige
besonders spezielle Editor Einstellungen sind in das
Programm-Einstellungen-Buch ausgelagert. Die weniger speziellen Einstellungen
sind dagegen direkt im Optionen MenБ zu finden.

Sprechblasenhilfe ein/aus kann auch im Programm-Einstellungen Buch auf der
Seite "Prog" eingestellt werden.

Andere Farbdarstellung wechselt zwischen zwei grundverschiedenen
Farbdarstellungen im Editor hin und her.

Hypermake merkt sich die ausgewДhlte Schrift und die Farbe wie auch die letzte
Fensterposition und -grФсe fБr jede Datei separat.

Die Tastenbelegung ist eine sehr wichtige Einstellung, da Sie die
Tastenkombinationen festlegt, mit der die Editorfunktionen statt dem MenБ
erreichbar sind. "Wordstar" ist die einzige Einstellung, mit der alle
MenБfunktionen auch Бber Tasten erreichbar sind. "Wordstar" ist auch die
einzige Tastenbelegung des WSedit Freewareprogramms.


ΓòÉΓòÉΓòÉ 2.3.3. Farbmarkierungen der rechten Spalte ΓòÉΓòÉΓòÉ


Die rechteste Spalte des Editors zeigt flДchig (als Hintergrundfarbe)
verschiedene Farben an:

     Zeilen, die mit zwei Punkten beginnen (Kommentarzeilen)
     Zeilen, die mit einem Punkt beginnen (Punktbefehle)
     Zeilen mit einem harten Return am Ende
     Zeilen mit einem weichen Return am Ende.


 Eine Zeile endet mit einem harten Return, wenn Sie die WagenrБcklauf-Taste
 (Eingabetaste oder Returntaste) gedrБckt haben. Egal wie der Text am
 Bildschirm formatiert wird, an der Stelle des harten Returns endet die Zeile.

 Ein weichter Return (Softreturn) verschwindet, wenn die Formatierung des
 Textes sich Дndert. Wenn die Breite des Editorfensters geДndert wird und Sie
 eine unformatierte Datei editieren, verschwinden die weichen Returns wieder
 und es entstehen an anderer Stelle neue.

 In einem Hypertext ist die Unterscheidung zwischen weichen und hartem Return
 besonders wichtig, weil Ihnen als Autor nicht bekannt ist, mit welcher Breite
 der Text vom Benutzer gelesen wird. Sie kФnnen Бbrigens im Popup-MenБ unter
 sonstiges eine Zeile zwischen Softreturn und Hardreturn wechseln.


ΓòÉΓòÉΓòÉ 2.3.4. Tastenbelegung ΓòÉΓòÉΓòÉ


Sie kФnnen zwischen drei verschiedenen Tastenbelegungen des Editors auswДhlen
(Popup-MenБ - Optionen - Tastenbelegung).

Wennn eine Funktion des Popup-MenБs auch Бber die Tastatur erreicht werden
kann, sind die entsprechenden Befehle im Popup-MenБ notiert.

     CUA: Common User Interface, das sind die Tastenbelegungen von allen
      modernen Programmen mit graphischer OberflДche. Z. B. Strng-Einfg kopiert
      den ausgewДhlten Text in die Zwischenablage.

     gemischt: eine Mischung aus CUA und Wordstar

     Wordstar: unterstБtzt fast vollstДndig die Control-Kommandos
      (Strng-Kommandos) des alten DOS Wordstar. Diese sehr alten
      Tastenbelegungen werden von einigen modernen Editoren, z. B. den Borland
      C und Pascal Programmier-Editoren unterstБtzt. ZusДtzlich werden alle
      Befehle, die nicht aus "Strng-Buchstabe" bestehen, genauso wie bei CUA
      unterstБtzt.


 CUA Tastenbelegung

 Manche der folgenden Strng-Befehle (Strng muс gedrБckt gehalten werden) sind
 nicht im Popup-MenБ aufgelistet.

 Strng-E: inkrementelles Suchen (ohne Dialogfenster, achten Sie auf die
 Titelzeile!)
 Strng-F: Such-Dialogfenster
 Strng-G: Suchen/Austauschen Dialogfenster
 Strng-N: letztes Suchen/Austauschen wiederholen

 (Bei CUA unterstБtzte Wordstar Tastaturbefehle)
 Strng-K0 (bis 9) Bookmark 0 setzen
 Strng-Q9 (bis 9) ("quick") springe zu Bookmark 0
 Strng-T: Wort rechts vom Cursor lФschen
 Strng-U: MБlleimer an der Cursorposition auskippen
 Strng-Y: Zeile lФschen.

 Wordstar Befehle

 Die Wordstar Tastenbelegung ist die einzige, bei der praktisch alle EintrДge
 im Popup-MenБ auch Бber die Tastatur erreichbar sind. Wordstar-Befehle
 bestehen zum Teil auch aus zwei Buchstaben, z.B. Strng-K-B fБr "Beginn
 Blockmarkierung". ZusДtzlich werden aber auche die CUA-Бblichen Befehle, die
 nicht aus "Strng-Buchstabe" bestehen, unterstБtzt.

 Wenn Ihnen der in Hypermake integrierte Editor gefДllt, dБrfen Sie gerne von
 meiner Homepage den Freeware Editor WSedit herunterladen. Dieser Editor ist im
 wesentlichen mit dem Hypermake-Editor in der "Wordstar" Tastenbelegung
 identisch und hat eine ausfБhrlichere ErlДuterung der Wordstar-Befehle. WSedit
 verfБgt Бber ein Dialogfenster, in dem alle Strng-Kommandos Бber eine
 Baumstruktur Бbersichtlich angeordnet sind, auсerdem gibt es noch eine etwas
 erweiterte FunktionalitДt, so etwa einen Makro-Recorder, Бber den
 Funktionstasten beliebig belegt werden kФnnen.

 Wenn Sie an der vollstДndigen Dokumentation der Wordstar-Tastenbefehle
 interessiert sind, ziehen Sie bitte das WSedit Programm zu Rate. Im
 Strng-Befehlsfenster von WSedit sind die wenigen Tastenkombinationen, die
 nicht auch vom Hypermake Editor unterstБtzt werden, mit einem Sternchen
 markiert.


═══ 2.3.5. Besondere FДhigkeiten des Editors ═══

Der "MБlleimer"

Wenn Sie Strng-T (Wort rechts vom Cursor lФschen) oder Strng-Y (Zeile lФschen)
verwenden, verbleibt der gelФschte Text in einem internen Pufferspeicher, dem
"MБlleimer", die nicht der Zwischenablage entspricht. Mit Strng-U kФnnen Sie
den aktuellen Inhalt des "MБlleimers" an der aktuellen Cursorposition ausgeben.

Drag and Drop (Ziehen und Fallenlassen)

Sie kФnnen einen markierten Block zu einer anderen Cursorposition oder in ein
anderes Hypermake Editor-Fenster oder WSedit Fenster verschieben. Um Drag and
Drop zu verwenden, mБssen Sie die rechte Maustaste benutzen. Die
Standardeinstellung ist verschieben. Wenn Sie beim Fallenlassen STRNG gedrБckt
halten, so wird der Block kopiert. Sie kФnnen auch das Dateisymbol einer
Textdatei in den Editor-Bereich ziehen und fallenlassen (entspricht Wordstar
Strng-KR).

Undo (Widerrufen)

Der Hypermake Editor verfБgt Бber eine sehr leistungsfДhige
Undo-FunktionalitДt. Sie finden Sie im Popup-MenБ unter editieren.

Mit Alt-RБcktaste wird wird die letzte Eingabe bzw. der letzte Befehl
rБckgДngig gemacht und mit Umsch-Alt-RБcktaste wird ein Redo, also das
RБckgДngigmachen des Widerrufens, durchgefБhrt. GrФсere Mengen an Befehlen
kФnnen bequem mit dem Undo-Schieber rБckgДngig gemacht werden.

Die Anzahl der mФglichen Undo-Schritte kann auf der Seite "Edit2" der
Programm-Einstellungen festgelegt werden. Sinnvoll sind Werte von 100 bis
10000.


═══ 2.3.6. WortprБfung ═══

Der Hypermake-Editor enthДlt eine einfache, aber sehr wirkungsvolle
WortprБfung.

Unterkapitel:
Wie Sie ein WФrterbuch erhalten
Mit der WortprБfung arbeiten

nДchstes Hauptkapitel:
Ъbersetzung


═══ 2.3.6.1. Wie Sie ein WФrterbuch erhalten ═══


Bevor Sie die WortprБfung benutzen kФnnen, mБssen Sie entweder selbst ein
WФrterbuch erzeugen oder ein WФrterbuch von der WSedit Seite meiner Homepage
http://www.hypermake.de herunterladen, das von anderen Hypermake-Benutzern oder
WSedit Benutzern zusammengetragen wurde.

Die gesamte WortprБfungs-FunktionalitДt ist Бber das Popup-MenБ erreichbar,
MenБpunkt WortprБfung.

Den Dateinamen fБr das WФrterbuch geben Sie in den Programm-Einstellungen auf
der Seite "Edit1" an.

Wenn Sie Ihr eigenes WФrterbuch anlegen mФchten, benФtigen Sie Textdateien, von
denen Sie sicher sind, daс Sie keine Fehler mehr enthalten. Laden Sie eine
solche Datei in den Editor und wДhlen WortprБfung - aktuelle Datei in
WФrterbuch aufnehmen.

FБr den Fall daс Sie ein WФrterbuch von einem Freund oder aus dem Internet
erhalten haben und dieses mit ihrem mischen wollen, verwenden Sie externes
WФrterbuch importieren.

Die Vorgehensweise bei der WortprБfung ist recht einfach: Wenn ein Wort im
WФrterbuch aufgenommen werden soll, so werden die Wortendungen, die auf der
Seite "Link" in den Projekt-Einstellungen stehen, in der Regel

(deutsch) e s es n en 's

abgeschnitten und der erste Buchstabe wird auf Kleinschreibung gestellt. Darauf
wird ein Vergleich mit dem Inhalt des WФrterbuches durchgefБhrt. Wenn kein
gleichlautender Eintrag gefunden wird, wird das Wort im WФrterbuch neu
aufgenommen.

Die WФrterbuch-Datei ist eine normale ASCII-Datei in IBM Zeichensatz. Die
WФrter sind nicht nach dem Alphabet, sondern nach einem internen Algorithmus
sortiert. Sie kФnnen an beliebiger Stelle auch selbst WФrter einfБgen.


═══ 2.3.6.2. Mit der WortprБfung arbeiten ═══


Sie kФnnen die WortprБfung ein- und ausschalten mit Strng-QL (Wordstar
Tastenbelegung) oder im Popup-MenБ WortprБfung - WortprБfung ein/aus. Der
Hintergrund von unbekannten WФrtern wird rosa. Es gibt keine Benutzerdialoge.

WortprБfung - bis Cursor in WФrterbuch aufnehmen lernt alle WФrter vom
Textanfang bis zur aktuellen Cursorposition. In diesem Augenblick verschwinden
in der Regel einige rosa Markierungen von soeben gelernten WФrtern unterhalb
der Cursorposition.

Wenn Sie ein falsch geschriebenes Wort entdecken, das fДlschlicherweise als
korrekt durchgegangen ist, kФnnen Sie dies korrigieren, indem Sie den
Mauszeiger Бber das fragliche Wort setzen und dann im Popup-MenБ einzelnes Wort
aus WФrterbuch streichen auswДhlen.


═══ 2.3.7. Ъbersetzung ═══

Der Hypermake Editor verfБgt Бber zwei Arten von Ъbersetzungs-Hilfe zwischen
zwei Sprachen: Sprechblasen-Ъbersetzung und Dialog-Ъbersetzung. Ъblicherweise
verwenden Sie die Sprechblasen-Ъbersetzung, um einen Fremdsprachentext zu lesen
und die Dialog-Ъbersetzung, um selbst einen Text in fremder Sprache zu
verfassen. Beide Funktionen finden Sie im Popup-MenБ unter sonstiges.

Damit die ЪbersetzungsfunktionalitДt vorhanden ist, mБssen Sie zuerst die
entsprechenden Ъbersetzungs-Dateien von der WSedit Seite meiner Homepage
http://www.hypermake.de laden. Derzeit gibt es nur Deutsch-Englisch und
Englisch-Deutsch. Darauf mБssen Sie die Dateinamen in den
Programm-Einstellungen auf der Seite "Edit1" eingeben.

Ist die Sprechblasen-Ъbersetzung aktiv, so wird das Wort unter dem Mauszeiger
Бbersetzt und das Ъbersetzungsergebnis wird in einem gelben Sprechblasenfenster
angezeigt, etwa "result = Resultat/Ergebnis/resultieren".

Bei der Dialog-Ъbersetzung erscheint ein Dialogfenster, in dem Sie einen
Begriff in ein Eingabefeld tippen kФnnen und sofort darunter in einer Listbox
verschiedene ЪbersetzungsvorschlДge erhalten. Ist die Sprechblasen-Ъbersetzung
ebenfalls aktiviert worden, werden die verschiedenen Ъbersetzungs-VorschlДge
wieder zurБckБbersetzt und diese RБck-Ъbersetzungen in Klammern angegeben. So
ist es leichter, das passende Wort in der Fremdsprache auszusuchen.

Diese RБck-Ъbersetzung ist letztlich ein Thesaurus, denn wenn ein bestimmter
deutscher Ausdruck ins Englische Бbersetzt wird und darauf wieder zurБck ins
Deutsche, erhalten Sie gleich eine ganze Reihe mФglicher deutscher AusdrБcke
dafБr.

Ein Doppelklick auf einen entsprechenden Listbox-Eintrag oder ein einfacher
Klick und ein anschlieсendes DrБcken auf OK kopiert die ausgewДhlte Ъbersetzung
in den MБlleimer, der an der aktuellen Cursorposition mit Strng-U "ausgekippt"
werden kann.


ΓòÉΓòÉΓòÉ 2.4. Inhaltsverzeichnis- und Stichwortverzeichnis-Fenster ΓòÉΓòÉΓòÉ

Das Inhaltsverzeichnis- und Stichwortverzeichnis-Fenster finden Sie im
MenБpunkt Ansicht des Hypermake-Hauptfensters oder im Programm MenБpunkt des
Editor Popup-MenБs, oder Sie drБcken F3 (Inhaltsverzeichnis) bzw. F4
(Stichwortverzeichnis).

In erster Linie sind die zwei Dialogfenster dafБr gedacht, Ihnen das Aufsuchen
von Textstellen im Quelltext zu erleichtern. Das Inhaltsverzeichnis-Fenster
zeigt die KapitelБberschriften in einer auf- und zuklappbaren Baumstruktur an
und das Stichwortverzeichnis-Fenster zeigt alle markierten AusdrБcke
alphabetisch an, wobei Sie mit den KnФpfen A bis Z an die entsprechende Stelle
innerhalb der Liste springen kФnnen.

Das Inhaltsverzeichnis- und Stichwortverzeichnis-Fenster haben die folgenden
KnФpfe:

Quelltext zeigt die vorher mit einfachem Mausklick ausgewДhlte Ъberschrift im
Quelltext an. Hierbei wird der interne Editor aktiviert und der Cursor an den
Beginn der gewДhlten Ъberschrift gesetzt.

Browser hat nur eine Wirkung, wenn der Quelltext schon einmal in das
HTML-Format Бbersetzt wurde. Es wird der Browser mit der entsprechenden
HTML-Datei gestartet, wobei der Dateiname des Browsers in den
Programm-Einstellungen auf der Seite "Viewer" eingegeben worden sein muс.

HTML Ascii (nur Inhaltsverzeichnis-Fenster) startet den internen Editor mit der
zugehФrigen HTML-Datei, wobei die HTML-Dateien von Hypermake schon einmal
erzeugt worden sein mБssen. Da die Erweiterung HTML oder HTM ist, wird im
Editor automatisch das Syntax-Highlightning (farbliche Hervorhebung) der
HTML-Kommandos aktiviert. Editieren Sie diesen Text nicht, denn die Оnderungen
wБrden mit dem nДchsten Verarbeiten wieder Бberschrieben.

Kopiere (nur Stichwortverzeichnis-Fenster) kopiert den vorher mit einfachem
Mausklick ausgewДhlten Ausdruck in den zuletzt aktiven Editor an dessen
aktuelle Cursorposition. So kФnnen Sie verhindern, daс durch eine falsche
Abwandlung des Ausdrucks der gewБnschte Link von Hypermake nicht gezogen wird.

Aktualis. (aktualisieren) speichert ggfs. den im internen Hypermake-Editor
geФffneten Quelltext und startet das Verarbeiten in den zwei ersten
Verarbeitungsstufen "Indizierung der Ъberschriften" und "Indizierung der
Querverweise". Darauf wird das Dialogfenster aktualisiert. Wenn Hypermake an
eine falsche Editorposition beim Anspringen aus dem Inhaltsverzeichnis- bzw.
Stichwortverzeichnis-Fenster anspringt, dann haben Sie vor die anzuspringende
Stelle neuen Text eingefБgt. Hypermake merkt sich einfach die Textposition als
Absatz-Nummer.

Schlieсen schlieсt das Dialogfenster.


ΓòÉΓòÉΓòÉ 2.5. Programm-Einstellungen Buch ΓòÉΓòÉΓòÉ


Das Programm-Einstellungen Buch enthДlt alle Einstellungen, die sich nicht auf
ein spezifisches Hypertext-Projekt beziehen. Um das Programm-Einstellungen Buch
zu Фffnen, wДhlen Sie Ansicht - Programm-Einstellungen im
Hypermake-Hauptfenster oder durch DrБcken von F8.

Unterkapitel:
Seite "Prog"
Seite "help"
Seite "2nd Comp"
Seite "View"
Seite "Edit1"
Seite "Edit2"

nДchstes Hauptkapitel:
Kommandozeilenversion HMAKE.EXE


ΓòÉΓòÉΓòÉ 2.5.1. Seite "Prog" ΓòÉΓòÉΓòÉ

Die Sprechblasenhilfe ist fБr fast alle Dialogfenster-Elemente sowie als
kontext-sensitive Hilfe innerhalb des integrierten Editors zum ErklДren der
Hypermake-spezifischen Textkommandos (Punktbefehle, Umschalter) verfБgbar.

In der Regel werden Sie die VerarbeitungsprioritДt nicht verДndern wollen.
Genau gesagt stellen Sie mit dem Schieber die PrioritДt des
Verarbeitungs-Threads ein. Wenn das Hypermake-Programm wДhrend des Verarbeitens
nur widerwillig Benutzereingaben verarbeitet, mБssen Sie den Schieber nach
links bewegen; kommt es zu Stockungen wДhrend der Verarbeitung, muс der Regler
nach rechts geschoben werden.

Wenn Sie den internen Editor nicht mФgen und stattdessen Ihren Lieblings-Editor
als externen Editor verwenden mФchten, kФnnen Sie hier den Dateinamen Ihres
Editors eingeben. Das bequeme Springen an eine konkrete Textstelle wird dann
aber nicht mehr unterstБtzt. Wenn Sie einen korrekten Dateinamen eingegeben
haben, so wird der Hintergrund des Eingabefelds grБn; ist der Dateiname falsch,
wird der Hintergrund rot. Mit dem Taschenlampen-Symbol kФnnen Sie Бber einen
Datei-Dialogfenster den Dateinamen auswДhlen.

Beim Щffnen eines HMP-Projektes Editoren autom. Фffnen Фffnet den Editor mit
der Quelltextdatei automatisch wenn Projekt - Щffnen im Hypermake-Hauptfenster
gewДhlt wird oder Hypermake per Doppelklick auf eine HMP-Datei gestartet wird.


ΓòÉΓòÉΓòÉ 2.5.2. Seite "help" ΓòÉΓòÉΓòÉ

Die Funktion Sprechblasen-Hilfe auf der help Seite der Programm-Einstellungen
zeigt kleine gelbe Fenster mit kurzem Text an, die immer dann erscheinen, wenn
der Mauszeiger Бber einem Dialogelement ruht. Im Prinzip gibt es fБr jedes
Dialogelement des Hypermake Programms einen entsprechenden Sprechblasen-Text.

Mit den Radiotasten auf der Seite help kФnnen Sie zwischen verschiedenen
Formaten fБr den integrierten Hilfetext wДhlen:

Eine OS/2-Hilfedatei liegt dem Hypermake Archiv als fertig kompilierte Datei
vor (GERMAN\HYMAKE.HLP). Im Prinzip kФnnen Sie diese Datei auch selbst erzeugen
(GERMAN\HELPDOKU.HMP compilieren und den IPFC-Compiler anschlieсend laufen
lassen). Die vorkompilierte Hilfedatei wurde nicht hДndisch nachbearbeitet.

Wenn Sie das HTML-Format fБr die kontext-sensitive Hilfe auswДhlen, wird die
Hilfe bei erstmaliger Verwendung der Hilfefunktion per AusfБhrung von
GERMAN\HTMLDOKU.HMP erzeugt. Hierbei kФnnen Sie in  einem eigenen Dialogfenster
Themen deaktivieren, die Sie nicht interessieren.

WДhrend Hypermake lДuft, kФnnen Sie diese Einstellung Дndern und so die
kontext-sensitive Hilfe eines anderen Formates aufrufen.


ΓòÉΓòÉΓòÉ 2.5.3. Seite "2nd Comp" ΓòÉΓòÉΓòÉ

Wenn auf der Main Seite der Projekt-Einstellungen die Checkbox auch 2. Compiler
starten aktiviert ist, ruft Hypermake den entsprechenden Compiler auf, dessen
Dateiname Sie hier angeben kФnnen. Wenn Sie einen korrekten Dateinamen
eingegeben haben, so wird der Hintergrund des Eingabefelds grБn; ist der
Dateiname falsch, wird der Hintergrund rot.

Die Eingabe eines Kommandozeilenprozessors ist nur dann nФtig, wenn ein
Compilerprogramm im Kommandozeilenfenster lДuft und das Betriebssystem nur den
indirekten Aufruf Бber das Kommandozeilen-Programm erlaubt (IPFC mit OS/2
funktioniert, so DOS-Programme unter UmstДnden auch).

Um mehr Бber diese Compiler zu lernen, kФnnen Sie im Kapitel der unterstБtzten
Hypertext-Formate nachschlagen.


ΓòÉΓòÉΓòÉ 2.5.4. Seite "View" ΓòÉΓòÉΓòÉ

Auf der Seite "View" legen Sie die Dateinamen der verschiedenen
Hypertext-Betrachter (Viewer) fest.

Der "HTML Browser" ist in der Regel entweder der von Netscape oder von
Microsoft. Der Netscape Browser hat etwa folgenden Dateinamen:
netscape4\program\netscape.exe; der Microsoft Internet Explorer IEXPLORE.EXE
ist meist im "Programme" Verzeichnis des Laufwerks, auf dem sich Windows
befindet.

Wenn das Eingabefeld grБn wird, ist die eingegebene Datei tatsДchlich
vorhanden, rot zeigt eine nicht vorhandene Datei an.

Verwende "hd" Seitenmarkierung sollte in Verbindung mit Netscape eingeschaltet
werden, der Microsoft Browser unterstБtzt diese Funktion nicht. Dem Netscape
Browser kann nicht nur ein Dateiname bzw. eine URL als Parameter Бbergeben
werden, sondern es kann zusДtzlich noch eine "#hd" Positionsmarkierung
Бbergeben werden. So wird mit Aufrufen des Browsers nicht nur die entsprechende
HTML-Datei geladen, sondern gleich noch die richtige Position innerhalb der
HTML-Datei angesprungen (meist eine ZwischenБberschrift).

Um mehr Бber die verschiedenen Zielformate und seine Viewer (Betrachter) zu
lernen, lesen Sie bitte das Kapitel Бber die unterstБtzten Hypertext-Formate.


ΓòÉΓòÉΓòÉ 2.5.5. Seite "Edit1" ΓòÉΓòÉΓòÉ

Die zwei "Edit" Seiten des Programm-Einstellungen Buches beziehen sich auf den
integrierten Editor.

Um die WortprБfung nutzen zu kФnnen, mБssen Sie hier erst den Namen der
WortprБfungs-Datei angeben. Da Sie auch ihr eigenes WФrterbuch anlegen kФnnen,
dБrfen Sie hier prinzipiell einen beliebigen Dateinamen eingeben (mit
vollstДndiger Angabe von Laufwerk und Verzeichnis).

Die Namen fБr die Ъbersetzungs-Dateien beziehen sich auf die
Ъbersetzungs-FunktionalitДt. Vorher mБssen Sie von der WSedit Seite meiner
Homepage die entsprechenden Dateien herunterladen (bislang nur deutsch-englisch
und englisch-deutsch).


ΓòÉΓòÉΓòÉ 2.5.6. Seite "Edit2" ΓòÉΓòÉΓòÉ

Hier kФnnen Sie das Verhalten des Editors bzgl. Zeilenumbruch festlegen.

     zeitverzФgert ziehe ich persФnlich den anderen Einstellungen vor. Wenn
      "zeitverzФgert" gewДhlt ist, kФnnen Sie daneben noch eine
      VerzФgerungszeit eingeben, wobei ich 0 Viertelsekunden vorziehe.

     nach jeder Taste ist das Verhalten der meisten Editoren mit
      Zeilenumbruch. Weil aber nach jedem neuen Buchstaben der aktuelle Absatz
      neu umgebrochen werden muс, kann dies bei langsamen Computern und
      zugleich schnellem Tippen zu einer nennenswerten Auslastung des
      Computerprozessors fБhren, was nicht zu empfehlen ist.

     nur manuell (Strng-B) ist das klassische Verhalten der ersten DOS
      Wordstar Editoren. Manche Leute mФgen es nicht, wenn Text umgebrochen
      wird, wДhrend sie tippen. Strng-B fБhrt

     gar nicht schaltet jeden Zeilenumbruch vФllig ab, auch Strng-B zeigt
      keine Wirkung. Einen praktischen Unterschied zwischen weichen und harten
      Returns gibt es dann nicht mehr.


 HTML Highlightning aktiviert das HTML Syntax Highlightning (farbliche
 Hervorhebung von HTML-Kommandos) innerhalb des Hypermake-Flieсtexts. Beim
 Eingeben von HTML-Befehlen innerhalb des Hypermake-Quelltextes erhalten Sie so
 entsprechende farbliche Markierungen. Wenn Sie dagegen eine HTML-Datei im
 internen Editor Фffnen (Projekt - Textdatei Фffnen), so wird dass HTML
 Highlightning grundsДtzlich aktiviert.

 Cursor links/rechts folgt dem Text beeinfluсt die Wirkung der Cursortasten.
 Ausgeschaltet verhДlt sich der Editor wie ein Editor fБr Programmierer: jede
 Stelle des Editorfensters kann Бber die Cursortasten direkt angesteuert
 werden. Eingeschaltet folgt der Cursor dem Text und springt von selbst in die
 neue Zeile. Bereiche im Editor, die noch keinen Text enthalten, kФnnen nur
 durch das Eingeben von Leerzeichen erreicht werden. Dieser Schalter kann auch
 direkt im Editor mit der Tastenkombination Strng-OX (nur Wordstar
 Tastaturbelegung) hin- und hergeschaltet werden.

 Wort rechts von Cursorpos. lФschen (Strng-T) legt das Detailverhalten des
 Strng-T Befehls fest. Die mittlere Einstellung entspricht der des DOS
 Wordstar, mit Leerzeichen-Korrektur ist eine Erweiterung, bei der auch bei
 Satzzeichen die Reihenfolge von zwei WФrtern vertauscht werden kann, ohne sich
 um Leerzeichen eigens kБmmern zu mБssen.

 max. Schritte fБr Undo: Der Undo-Schieber (Widerrufen) funktioniert besser,
 wenn der Editor nicht zu oft einen Absatz wДhrend des Tippens umbricht: wenn
 der Text unentwegt wДhrend des Tippens umgebrochen wird, gibt es sehr schnell
 viele ZustДnde, die fБr die Undo-FunktionalitДt gemerkt werden mБssen: jede
 Zeile des Absatzes und das fБr jeden neuen Umbruch. Sie kФnnen dies durch Wahl
 von "ZeitverzФgerung" beim Zeilenumbruch und einen hФheren Wert der
 VerzФgerungszeit beeinfluсen. Sinnvolle Werte sind von 100 bis 10000.


ΓòÉΓòÉΓòÉ 3. Kommandozeilenversion HMAKE.EXE ΓòÉΓòÉΓòÉ

Die Kommandozeilenversion von Hypermake (HMAKE.EXE) ist ein reiner Compiler,
der wДhrend der Laufzeit keine Benutzereingaben erwartet. Die meisten Benutzer
werden die Programmversion HYMAKE.EXE mit BenutzeroberflДche (integrierter
Editor, Einstellungen-Buch usw.) der Kommandozeilenversion vorziehen. In diesem
Kapitel wird die Benutzung speziell der Kommandozeilenversion erlДutert.

Die Kommandozeilenversion kann auf zweierlei Weise benutzt werden: indem als
Parameter im wesentlichen nur eine sog. HMP-Datei Бbergeben wird - ggfs. auch
Бber die graphische BenutzeroberflДche. Die HMP-Datei enthДlt dann die weiteren
grundlegenden Steueranweisungen. Oder diese Anweisungen (insbesondere Name des
Quelltextes und der Ini-Datei) werden Бber diverse Parameter HMAKE.EXE
Бbergeben.

Unterkapitel:
Starten mit Hilfe von HMP-Dateien
Starten Бber die Kommandozeile
Spezielle Programmparameter
Returncodes
Schreiben von Batch-Dateien
Debug-Modus

nДchstes Hauptkapitel:
RБckwДrts-Konvertierung von IPF und RTF nach Hypermake


ΓòÉΓòÉΓòÉ 3.1. Starten mit Hilfe von HMP-Dateien ΓòÉΓòÉΓòÉ

HMP-Dateien sind sind mit Hypermake 3.5 neu eingefБhrt und kФnnen auch als
"Mausersatz" fБr die Kommandozeile dienen.

Nach dem Starten des Programms HMINSTAL sind HMP-Dateien mit drei Programmen
gleichzeitig verknБpft: die StandardverknБpfung (Doppelklick) ist das
graphische Programm HYMAKE.EXE (Фffne Projekt), des weiteren gibt es noch eine
VerknБpfung mit einem Editor (editiere Projektdatei) und dem HMAKE.EXE Compiler
(kompiliere Projekt).

Um die Zuordnungen zu sehen, holen Sie sich mit der rechten Maustaste das
KontextmenБ einer HMP-Datei her und wДhlen Щffnen.

Wenn Sie "editiere Projektdatei" wДhlen, sehen Sie in der HMP-Datei pro Zeile
einen "Schalter", rechts vom = Zeichen dБrfen Sie editieren. Wenn Sie eine
Zeile mit ; oder // beginnen, werden sie als Kommentarzeile nicht
interpretiert.

Die folgenden Zeilen sollten in jeder Hypermake Projektdatei stehen:


;Hypermake Project file

source files = meintext.txt
ini file = meintext.ini

Sie mБssen wenigstens den Dateinamen des Quelltextes sowie den Dateinamen der
Ini-Datei angeben, die anderen Zeilen sind freiwillig.

Sie kФnnen auch mehrere Quelltext-Dateien, durch Leerzeichen getrennt, angeben.
Sie werden dann im Speicher in der Reihenfolge zusammenkopiert, in der sie hier
aufgefБhrt werden.

 target = HTML

Hypermake erzeugt die Formate IPF, WINHELP3, WINHELP4, HTML, HTMLHELP . In der
Ini-Datei gibt es auch eine target=  Angabe. Diese gilt nur, wenn Sie in der
HMP-Datei keine Angabe dazu machen. target=  in der HMP-Datei macht dann Sinn,
wenn Sie aus einem Quelltext und einer Ini-Datei mehrere Formate erzeugen
wollen.

 parameter = noframes noid bigfont

Es gibt einige Programmparameter, die eine bestimmte Wirkung auf den erzeugten
Hypertext haben und nur in bestimmten FДllen gewБnscht werden.

 conditions = DIES DAS

Sie dБrfen im Quelltext sogenannte IF-Bedingungen setzen. Damit kФnnen Sie Text
quasi einklammern und er wird nur dann in den Hypertext Бbersetzt, wenn Sie die
Bedingung hier gesetzt haben.

Automatisches Starten des zweiten Compilers und des Hypertext-Betrachters

Mit Hypermake erzeugte HTML-Dateien kann man sofort mit einem Browser-Programm
betrachten. Bei all den anderen unterstБtzten Hypertextformaten benФtigt man
erst noch einen zweiten Compiler. Der zweite Compiler nimmt die von Hypermake
erzeugten Dateien als Input und erzeugt daraus eine binДre Hypertextdatei, die
man dann mit dem entsprechenden Programm anschauen kann. Es ist daher sinnvoll,
daс der zweite Compiler automatisch seine Arbeit aufnimmt, wenn Hypermake seine
Arbeit ohne Fehlermeldungen beendet hat.


compile = YES
view = YES

Hypermake kann den zweiten Compiler sowie den Viewer (das Betrachter-Programm)
automatisch starten. HierfБr benФtigt es aber den vollen Dateinamen des zweiten
Compilers:


ipf compiler = C:\IPFC\IPFC.EXE /inf
winhelp3 compiler = C:\WINHELP\HC.EXE
winhelp4 compiler = C:\HELPWORKSHOP\PROGRAM\HCRTF.EXE /x
htmlhelp compiler = C:\HTMLHELP\HHC.EXE

Hier mБssen Sie die richtigen Pfadnamen angeben, falls sich das Programm nicht
in einem Verzeichnis befindet, das im PATH Befehl eingetragen ist. Sie kФnnen
hinter den Dateinamen des Compilers durch Leerzeichen getrennt noch
Kommandozeilenparameter eingeben.


ipf viewer = VIEW.EXE
winhelp3 viewer = WINHELP.EXE
winhelp4 viewer = WINHELP32.EXE
htmlhelp viewer = HH.EXE

Auch hier mБssen Sie die richtigen Pfadnamen angeben, falls sich der Viewer
nicht in einem Verzeichnis befindet, das im PATH Befehl eingetragen ist. In der
Regel befinden sich die Viewer aber in solchen Verzeichnissen.

 command lines = 50

Manche der zweiten Compiler erzeugen eine Menge von Meldungen, so daс die
ersten Meldungen aus dem zu kleinen Standard-Bildschirm von 25 Zeilen
herausrutscht. Hier kФnnen Sie nun die Anzahl der Zeilen angeben, die das
Textausgabefenster fБr den zweiten Compiler erhalten soll. Zum Austesten,
welche Werte Ihr Rechner akzeptiert, starten Sie ein Kommandozeilenfenster und
geben MODE 80,50 bzw. fБr 50 einen anderen Wert ein. Manche Systeme akzeptieren
Stufenlos Werte bis 1000, andere nur feste Werte wie 50. Das hДngt vom
Betriebssystem und der verwendeten Grafikhard- und software ab.

 processor = C:\OS2\CMD.EXE

Um den zweiten Compiler und/oder den Viewer starten zu kФnnen, wird kurzzeitig
eine Batch-Datei HMTEMP.CMD angelegt. OS/2 kann eine solche Batch-Datei nur
Бber den Kommandozeilen-Prozessor starten. Wenn dieser nicht wie hier angegeben
lautet, kФnnen Sie hier einen anderen angeben.

Grafik-Dateien automatisch kopieren

 graphic path = VollePfadangabe;VollePfadangabe;VollePfadangabe

Hypermake nimmt Ihnen die Arbeit des Kopierens von Grafikdateien ab. Hier
kФnnen Sie alle die Verzeichnisse mit vollem Namen Laufwerk:\Pfad\Unterpfad und
durch Strichpunkt getrennt (ohne Leerzeichen) auflisten.

Den Schalter graphic path dБrfen Sie auch in der Ini-Datei verwenden.


═══ 3.2. Starten Бber die Kommandozeile ═══

Sie mБssen, bevor Sie Hypermake Бber die Kommandozeile benutzen kФnnen,
HMAKE.EXE in einen Pfad kopieren, der in der Datei CONFIG.SYS unter PATH
vorkommt; die Datei KBDVIO32.DLL muс entweder in einem Pfad sein, der unter
LIBPATH vorkommt oder im gleichen Pfad wie die ausgefБhrte Datei HMAKE.EXE.
Findet die EXE-Datei die DLL nicht, so erscheint die OS/2-Fehlermeldung "0005"
oder "SYS3175".

Sie mБssen ein oder zwei Parameter Бbergeben:

[C:\myProject] HMAKE MeinDoku.txt Meine.ini

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:

[C:\myProject] HMAKE MeinDoku.txt

Wenn Hypermake keine derartigen Ini-Dateien findet, sucht er im aktuellen
Verzeichnis noch nach HMAKE.INI. Wenn diese auch nicht vorhanden ist, bricht
das Programm ab.

FБr Ihre eigene Ini-Datei benutzen Sie als besser eine Kopie von BEISPIEL.INI
als von DOKU.INI. In letzterer sind recht ausgefallene ASCII-Werte fБr die
Toggles gewДhlt.

Mehrere Quelltexte

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.

Zielformat Дndern

Mit den Kommandozeilenparametern HTML IPF WINHELP3 WINHELP4 HTMLHELP RTFTEXT
kann die Standardeinstellung "target file" in der Ini-Datei temporДr
Бberschrieben werden. RTFTEXTCC setzt zusДtzlich zum Zielformat RTF-Text noch
den Schalter "color correction" auf ein. Diese Parameter kФnnen auch mit einem
SchrДgstrich davor versehen werden: /HTML

Bedingungen setzen

Sie dБrfen im Quelltext sogenannte If-Bedingungen setzen. Damit kФnnen Sie Text
quasi einklammern und er wird nur dann in den Hypertext Бbersetzt, wenn Sie
hier die Bedingung hier gesetzt haben. Die Bedingungen setzen Sie Бber die
Kommandozeile beginnend mit einem #-Zeichen.

[C:\myProject] HMAKE MeinDoku.txt #BED1 #BED2


ΓòÉΓòÉΓòÉ 3.3. Spezielle Programmparameter ΓòÉΓòÉΓòÉ


Programmparameter werden entweder in der HMP-Datei in der Zeile parameters =
oder in der Kommandozeile, beginnend mit / eingegeben. Sie werden eher selten
gebraucht, meist nur wenn Sie mehrere Zielformate erzeugen wollen, ohne
verschiedene Ini-Dateien zu verwenden. Der Parameter mit dem Namen NOFRAMES
wird also entweder in der Kommandozeile als /NOFRAMES angegeben oder hinter
parameters = in der HMP-Datei als einer von mehreren Parametern, ohne den
SchrДgstrich. Die Groс- und Kleinschreibung spielt jeweils keine Rolle.

Die meisten Parameter werden auch von der graphischen Version HYMAKE.EXE
unterstБtzt, sie werden dort auf der Seite "Main" in den Projekt-Einstellungen
mit Hakerl markiert und sind im Kapitel Programmparameter beschrieben. Speziell
fБr die Kommandozeilenversion gibt es noch weitere Parameter:

Fortschrittsanzeige mit Punkten

/dots erzeugt einen Punkt fБr jedes bearbeitetes Kapitel statt der sonst
Бblichen Fortschrittsanzeige mit dem drehenden Eck-Symbol.

UnterdrБcken von Ausgaben und Benutzeraufforderungen

/quit unterdrБckt die Aufforderung "beliebige Taste drБcken", die immer am Ende
der ProgrammausfБhrung erscheint, wenn HMAKE eine HMP-Datei Бbergeben wurde.

Ausgabe von Meldungen in eine Textdatei

ZusДtzlich zu den normalen Ausgaben am Bildschirm kФnnen Sie sowohl alle
Meldungen als auch speziell nur Fehlermeldungen in eine Textdatei umleiten. Das
macht z. B. Sinn, wenn Sie aus einer Batch-Datei heraus Hypermake aufrufen und
dann einen Editor mit der Fehlerliste aufrufen wollen.


/MESSAGES:dateiname
/ERRORS:dateiname

Der allgemein Бbliche Betriebssystem-Befehl >NUL am Ende der Eingabezeile
leitet alle Programmausgaben nach NUL um und verschluckt somit alle
Programmausgaben.


ΓòÉΓòÉΓòÉ 3.4. Returncodes ΓòÉΓòÉΓòÉ

HMAKE beendet die AusfБhrung seit 3.97 mit fest definierten Returncodes, die
von einem anderen Programm, das HMAKE aufgerufen hat, weiterverwendet werden
kann. Hypermake erzeugt unzДhlige verschiedene Fehler, die meisten sind von der
unten genannten Kategorie 31 "source file syntax error".


 0: no termination error (but no information about warnings)
 1: internal (should not occur)
 2: external program not found
11: file not found/file empty/parameter not existing
12: error writing output file
13: error writing messagefile/errorfile
14: registration required
21: error in ini file
22: error in hmp file
31: source file syntax error
32: source file syntax error, please contact hmake author
33: bug in Hypermake, please contact autor
98: user break
99: other errors


ΓòÉΓòÉΓòÉ 3.5. Schreiben von Batch-Dateien ΓòÉΓòÉΓòÉ

Batch-Dateien dienen der automatischen Abarbeitung von Kommandozeilen-Eingaben,
enden auf BAT (DOS, Win95, NT) oder CMD (OS/2, NT) und kФnnen mit jedem
normalen Editor bearbeitet werden.

Im Prinzip benФtigen Sie bei Verwendung von HMP-Dateien keine Batch-Dateien.
Wenn Ihnen diese Art der Bearbeitung aber liegt, kФnnen Sie sie natБrlich
verwenden.

Eine vernБnftige Batch-Datei zum Abarbeiten im Hintergrund ist die folgende:


rem Erstellung eines Hypertextes mit Hypermake und IPFC
HMAKE mein.txt /errors:HyperMake_errors
start /f e HyperMake_errors
ipfc /inf mein.ipf /country=049 /language=deu >ipfc_errors
start /f e ipfc_errors
echo **

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 Batch-Dateien nicht vertraut sind, so kФnnen Sie darБber unter
"OS/2-Befehle (nach Funktion sortiert), Stapeldatei- und Befehlsverarbeitung"
im OS/2-Referenzhandbuch nachlesen.

In der letzten Zeile kФnnen Sie hinter "echo" zwei Zeichen Alt-7 schreiben, das
ergibt zwei Piepser.

Das > Zeichen leitet die Bildschirmmeldungen in eine Datei um, die dann mit
einem Editor nachtrДglich angesehen werden kann (start Editorname Dateiname).
Das > Zeichen funktioniert bei Hypermake nur einwandfrei in der OS/2-Version
von Hypermake, verwenden Sie besser grundsДtzlich die Parameter
/MESSAGES:dateiname  und /ERRORS:dateiname .

Weitere nБtzliche Befehle in Batch-Dateien

 PAUSE stoppt den Programmablauf und fordert den Benutzer auf, eine beliebige
Taste zu drБcken.

FБr die Zeichenfolge %1 wird der erste an die Batchdatei Бbergebene Parameter
verwendet.

Drag and Drop funktioniert jedoch nicht, weil bei Verwendung von einer
Erweiterung hinter %1 , also etwa %1.IPF oder %1.HPJ dann zwei Erweiterungen
hintereinander kopiert werden.


ΓòÉΓòÉΓòÉ 3.6. Debug-Modus ΓòÉΓòÉΓòÉ

Es kann in seltenen FДllen vorkommen, daс HMAKE bei der Arbeit abstБrzt, weil
eine bislang unbedachte Situation eintritt. Um zu lokalisieren, wo genau der
Absturz erfolgt, kann man mit Hilfe des Programmparameters /count  die
aktuellen Zeilennummern ausgeben und anschlieсend mit Hilfe von /debug dann
kurz vor der Absturz-Stelle die entsprechende Textstelle im Quelltext ausgeben
lassen.

Mit /debugmain statt /debug wird der Text nur wДhrend des Schreibens der
IPF/RTF/HTML-Dateien ausgegeben.

Ich bitte um Benachrichtigung bei derartigen AbstБrzen. Bitte schicken Sie mir
den Quelltext mit Ini-Datei, so daс ich den Absturz reproduzieren und dann
einkreisen kann, damit bei der nДchsten Version dann eine saubere Fehlermeldung
erscheint.


═══ 4. RБckwДrts-Konvertierung von IPF und RTF nach Hypermake ═══


Unterkapitel:
EinfБhrung
IPF RБckwДrts-Konvertierung
RTF RБckwДrts-Konvertierung
Konvertierung starten (Graphische Version)
Konvertierung starten (Kommandozeilenversion)

nДchstes Hauptkapitel:
Erstellen eines Hypermake Quelltextes


═══ 4.1. EinfБhrung ═══


Hypermake bietet Ihnen eine rudimentДre RБckwДrts-Konvertierung vorhandener
Texte im IPF- bzw. RTF-Format ins Hypermake Quelltext-Format.

Das RTF-Format (Rich Text Format) ist nicht nur das Ausgangsformat fБr die
Windows-Hilfe, sondern wird auch von vielen Textverarbeitungsprogrammen wie
etwa Winword exportiert.

Die RБckwДrts-Konvertierung verfБgt Бber die wichtigsten Funktionen und nimmt
Ihnen 90 bis 95%, aber nicht 100% der Arbeit ab. HierfБr sind die Formate
einfach konzeptionell zu unterschiedlich. Deshalb sollten Sie die
RБckwДrts-Konvertierung als einmalige Aktion ansehen und dann nur noch den
Hypermake Quelltext weiter bearbeiten.

Bei der RБckwДrts-Konvertierung wird auch die Ini-Datei bzw. das
Einstellungen-Buch gelesen. Werfen Sie vorher schon einen Blick auf die
Einstellungen "list char" (unsortierte Listen), "toggle char" und "Source
format" (Quelltextformat), in den Projekt-Einstellungen sind das die Seiten
"format" und "spec. chars". Achten Sie bei IPF-Konvertierung vor allem darauf,
daс genБgend "list char" (Listenzeichen) definiert sind, also etwa vier StБck
wenn im IPF-Text Listen mit bis zu vier Ebenen vorkommen.


═══ 4.2. IPF RБckwДrts-Konvertierung ═══


Die IPF RБckwДrts-Konvertierung ist zu folgendem in der Lage:

     Umschalter (toggles)
     Kapitel
     unsortierte Listen, sortierte Listen
     die wichtigsten Formatierbefehle (paragraph, break, Formatierung ein/aus)
     IndexeintrДge (nur i1 Ebene), sie werden auch gleich zum Querverweis-Ziel
     Grafiken, jedoch nicht Grafiken in Text.


 Nicht funktioniert das folgende:

     Schriften
     Fensteranordnung
     Formatierung bzgl. RДnder
     Fuсnoten
     definition list
     tables
     Panel ID's, die Verbindung zu einem EXE Programm.


═══ 4.3. RTF RБckwДrts-Konvertierung ═══


Bei der RTF RБckwДrts-Konvertierung werden zwei grundsДtzliche RTF-Formate
unterschieden:

     Quelltexte von Windows-Hilfe
     Aus Textverarbeitungsprogrammen exportierte RTF-Texte (z. B. aus
      Winword), die keine Windows-Hilfe sind.


 Wenn Sie letzteres Format konvertieren wollen, mБssen Sie dies extra mit dem
 Kommandozeilenparameter  /ISTEXT angeben, der Parameter fБr Windows-Hilfe
 lautet /ISPROG .

     Umschalter (toggles)
     Kapitel
     die wichtigsten Formatierbefehle (paragraph, break, Formatierung ein/aus)
     IndexeintrДge, sie werden auch gleich zum Querverweis-Ziel
     RДnder
     Fuсnoten
     Grafiken, auch Grafiken in Text.


 Nicht funktioniert das folgende:

     Schriften
     Fensteranordnung
     definition list
     Panel ID's (die Verbindung zu einem EXE Programm)
     tables
     unsortierte Listen, sortierte Listen.


 Der Text der Tables (Tabellen) geht zwar nicht verloren, jedoch die
 Formatierung. Am sinnvollsten ist es, aus der Windows-Hilfe einfach die
 Tabelle Бber die Zwischenablage in den Hypermake Quelltext zwischen die zwei
 .TA Punktbefehle zu kopieren.

 Sortierte Listen und unsortierte Listen kennt RTF bzw. Winhelp nicht, deshalb
 kann es auch keine RБckwДrts-Konvertierung geben. (Umgekehrt ist aber
 Hypermake in der Lage, unsortierte und sortierte Listen Бber andere
 RTF-Befehle zu emulieren.)

 Manche Textprogramme wie Winword exportieren standardmДсig nicht die
 Gliederungsstruktur ins RTF-Format. Gerade dies ist aber fБr Hypermake sehr
 wichtig, denn ohne Kapitel geht bei Hypermake "gar nichts". Vor dem Export ins
 RTF-Format sollten Sie deshalb eine Formatvorlage wДhlen, die die
 Gliederungsstrukturen unterstБtzt, so etwa "Ъberschrift1" statt "Standard".
 Damit Hypermake die Ъberschriften richtig umsetzen kann, mБssen Sie eine
 Vorlage mit Dezimalklassifikation wДhlen, also "1 - 1.1 - 1.1.1" usw.


ΓòÉΓòÉΓòÉ 4.4. Konvertierung starten (Graphische Version) ΓòÉΓòÉΓòÉ


Die RБckwДrts-Konvertierung wДhlen Sie aus mit Projekt - RTF/IPF importieren.
Sie werden dann aufgefordert, eine Reihe von Dateinamen auszuwДhlen:

     einen Namen fБr die neue Projektdatei (HMP-Datei)
     einen Namen fБr den von Hypermake anzulegenden Hypermake-Quelltext (Die
      Datei darf noch nicht vorhanden sein, sie wБrde sonst Бberschrieben.)
     den Dateinamen der zu konvertierenden IPF- bzw. RTF-Datei. Benutzen Sie
      ohne die Erweiterung nicht denselben Namen wie Ihre IPF- bzw. RTF-Datei,
      da Hypermake beim spДteren Verarbeiten fБr das Zielformat den Namen
      Quelltextname.IPF bzw. Quelltextname.RTF verwendet, was Ihre
      Ausgangsdatei dann ohne Warnung Бberschreiben wБrde.
     eine vorhandene Ini-Datei, deren Einstellungen denen des kБnftigen
      Projektes mФglichst nahe kommt (Beispiel.ini aus diesem Archiv, wenn Sie
      nicht schon selbst welche angelegt haben)
     den Namen der neu anzulegenden Ini-Datei, die den Inhalt der eben
      angegebenen Ini-Datei erhДlt.


 Darauf wird das Einstellungen-Buch geФffnet und Sie haben noch die
 MФglichkeit, Modifikationen vorzunehmen. Einige den Quelltext betreffende
 Einstellungen, wie die Auswahl der Umschalter (Toggles), haben Auswirkung auf
 die RБckwДrts-Konvertierung, und zwar vor allem die Seiten "format" und "spec.
 chars". Nachdem Sie das Einstellungen-Buch schlieсen, startet Hypermake die
 RБckwДrts-Konvertierung.


ΓòÉΓòÉΓòÉ 4.5. Konvertierung starten (Kommandozeilenversion) ΓòÉΓòÉΓòÉ

WДhrend in der Hauptrichtung Hypermake sowohl Бber HMP-Dateien als auch Бber
die Kommandozeile aufgerufen werden kann, mБssen Sie bei der einmalig zu
verwendenden RБckwДrts-Konvertierung mit der Kommandozeile ("OS/2-Fenster",
"(MS-DOS-Eingabeaufforderung)" vorlieb nehmen.

Um die RБckwДrts-Konvertierung zu starten, geben Sie die Ini-Datei an, die Sie
spДter verwenden wollen (z. B. eine Kopie von BEISPIEL.INI) und dann noch die
Datei mit der Erweiterung .IPF  bzw. .RTF . Mehrere Quelltexte werden nicht
unterstБtzt. FБr RTF-Texte, die keine Windows-Hilfe Quellen sind, geben Sie
zusДtzlich den Parameter /ISTEXT an.

[C:\myProject] HMAKE meineDok.ipf meineDok.ini

Es wird grundsДtzlich eine Hypermake Quelldatei mit dem Namen HMSOURCE.TXT
erstellt.


ΓòÉΓòÉΓòÉ 5. Erstellen eines Hypermake Quelltextes ΓòÉΓòÉΓòÉ


Unterkapitel:
Grundlagen
Textanfang
Kapitel
Schriften
Unsortierte und sortierte Listen
Einbindung von Grafiken
Querverweise und Index
Duplizierung von KapitelБberschriften
Tabellen (Tables)
Linienziehen
Fuсnoten
RДnder und Formatierung
If-Bedingungen

nДchstes Hauptkapitel:
HTML-spezifische Funktionen


ΓòÉΓòÉΓòÉ 5.1. Grundlagen ΓòÉΓòÉΓòÉ


Unterkapitel:
Punktbefehle
IPF-Befehle
HTML-Befehle
Umschaltzeichen
Bedeutung von Returns

nДchstes Hauptkapitel:
Textanfang


ΓòÉΓòÉΓòÉ 5.1.1. Punktbefehle ΓòÉΓòÉΓòÉ


Das Hypermake-Format verwendet Punktbefehle wie der gute alte DOS WordStar. Ein
Punktbefehl benФtigt eine eigene Zeile und beginnt mit einem Punkt, zum
Beispiel


 .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.


 .LM10

verstellt den linken Rand auf 10. Dabei darf auch ein Leerzeichen zwischen
Punktbefehl und Parameter stehen.

Die Zeile


 ..Kommentar

wird ignoriert.

Wenn Punktbefehle aus mehr als zwei Buchstaben bestehen, dient das der besseren
Lesbarkeit. Sie mБssen aber 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.


ΓòÉΓòÉΓòÉ 5.1.2. IPF-Befehle ΓòÉΓòÉΓòÉ


 .:IPFbefehl.
 .:IPFbefehl. Ausdruck

Sie kФnnen IPF-Befehle direkt eingeben (was jedoch eher die Ausnahme ist, da
alle wichtigen Kommandos Bestandteil des einfacheren Hypermake Formates sind.)


ΓòÉΓòÉΓòÉ 5.1.3. HTML-Befehle ΓòÉΓòÉΓòÉ

Es gibt drei Arten, HTML-Befehle direkt in den Hypermake-Quelltext einzubinden.
Dies ist fБr Sie sinnvoll, wenn Sie mit HTML-Befehlen vertraut sind und fБr
einzelne Teilaufgaben diese den Hypermake-Befehlen vorziehen oder ganze Java-
oder Javascript-Programme schreiben mФchten. Werden andere Formate als HTML
erzeugt, so werden die Befehle natБrlich unterdrБckt.

Hypermake bietet die direkte Verwendung von <HTML-Befehlen> in spitzen Klammern
direkt im Flieсtext: Mit dem Punktbefehl HTML Command


 .HC an  (on)
 .HC aus  (off)

kФnnen im Flieсtext HTML-Kommandos in den HTML-Бblichen spitzen Klammern
<Kommando> eingegeben werden. Innerhalb der spitzen Klammern werden die Zeichen
so ausgegeben, wie sie im Quelltext stehen. StandardmДсig ist .HC
ausgeschaltet, d.h. die spitzen Klammern stellen normale Zeichen dar, die in
der HTML-Datei ausgedruckt werden. Wenn Sie mit HTML vertraut sind, kФnnen Sie
.HC an einmal aktivieren und eingeschaltet lassen, so lange Sie im Flieсtext
keine spitzen Klammern verwenden mФchten.

Sie kФnnen auch direkt HTML-Text und -Kommandos schreiben - z. B. fБr
Javascript Programme, er wird ohne Оnderung Бbernommen.


 .HTML

 <HTML-Kommandos> Flieсtext usw.

 .HYPERMAKE

FБr grФсere EinschБbe in HTML bietet es sich an, diese aus dem Hypermake
Quelltext ganz auszulagern. Mit dem Punktbefehl


 .HF Dateiname

(HTML File) wird an die Stelle des Punktbefehls der Dateiinhalt der Datei
"Dateiname" kopiert. Das ist besonders bei Javascript Programmen sinnvoll.


ΓòÉΓòÉΓòÉ 5.1.4. Umschaltzeichen ΓòÉΓòÉΓòÉ

In den Projekt-Einstellungen auf der Seite "spec. chars" bzw. in der Ini-Datei
kФnnen Sie einige Umschaltzeichen (engl. toggle char) 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:


Dieser *Teil des Satzes* ist besonders wichtig.

Sie erhalten dann:

Dieser Teil des Satzes ist besonders wichtig.

Sie kФnnen Umschaltzeichen auch Бberlagert verwenden:


Das ist *fett und @gleichzeitig italic* und nur italic@.

Das ist fett und gleichzeitig italic und nur italic.

Im integrierten Hypermake-Editor kФnnen Sie Umschaltzeichen Бber PopupmenБ -
Umschaltzeichen eingeben.

Sinnvoll sind bei der Verwendung der IBM Codepage die Steuerzeichen unter ASCII
dezimal 32, wenn der verwendete Editor diese unterstБtzt, und bei HTML die
Zeichen oberhalb von ASCII dezimal 127.

Eine weitere EingabemФglichkeit der ASCII-Zeichen unter 26, wenn Sie im
integrierten Hypermake-Editor die Tastenbelegung Wordstar oder Gemischt gewДhlt
haben: geben Sie Strng fБr "Printer" ein und darauf den Buchstaben, der der
Position in der ASCII-Tabelle entspricht: fБr ASCII 19 etwa S, weil S an 19-ter
Stelle im Alphabet steht.

Umschaltzeichen sollten nur selten anderweitig im Text verwendet werden.

Wenn Sie ein Umschaltzeichen ausdrucken und nicht interpretiert haben wollen,
mБssen Sie es zweimal hintereinander schreiben:


@Meine E-Mail Adresse:@

Martin@@vr-transport.de


ΓòÉΓòÉΓòÉ 5.1.5. Bedeutung von Returns ΓòÉΓòÉΓòÉ

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
(Seite "format" in den Projekt-Einstellungen), 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. Die meisten Editoren
unterstБtzen dies (meist: "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.


ΓòÉΓòÉΓòÉ 5.2. Textanfang ΓòÉΓòÉΓòÉ

Jedes Dokument hat einen Titel. Dieser erscheint als Titel des Hauptfensters
und auch in der Fensterliste.


 .TI
 Dokumentation von meinem Programm

legt den Titel der HTML-Dateien bzw. INF- oder HLP-Datei fest. Jeder
Hypermake-Quelltext muс immer mit einem solchen Titel beginnen, noch vor der
ersten KapitelБberschrift.

Hypermake erzeugt aus nur einer Quelldatei mehrere HTML-Dateien. Wie der Titel
fБr jede kapitel-bezogene Einzeldatei lauten soll, lДсt sich in der Ini-Datei
unter file title (Projekt-Einstellungen Seite "HTML-2") einheitlich festlegen.

Bei OS/2 HLP-Dateien wird der Titel Бber den Programm-Quelltext festgelegt
(siehe function InitHelp). Der Titel-Punktbefehl im Hypermake-Quelltext wird
ignoriert. In OS/2 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:


 .<>

Winhelp-HLP-Dateien haben standardmДсig keine Vor/ZurБck-KnФpfe (Symbole << und
>>), um die Seiten der Reihe nach durchzublДttern. Diese sind aber sehr
sinnvoll. Deshalb ist es zweckmДсig, grundsДtzlich mit dem folgenden
Punktbefehl diese einzuschalten:


 .<>


ΓòÉΓòÉΓòÉ 5.3. Kapitel ΓòÉΓòÉΓòÉ

Die mit Hypermake erzeugten Hypertexte sind grundsДtzlich in Kapitel
gegliedert. Jedes Kapitel beginnt mit einer Ъberschrift. Die Hypertexte
verfБgen Бber ein Inhaltsverzeichnis, das alle KapitelБberschriften auflistet
und Бber das man zu allen Seiten des Hypertextes gelangen kann.

Wenn man eine OS/2 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.

Jedes Kapitel erhДlt bei Winhelp eine eigene Seite.

Erzeugt Hypermake HTML-Dateien, dann erhДlt man unter dem Dateinamen INDEX.HTML
ein Inhaltsverzeichnis. FБr jedes Kapitel beginnt Hypermake in der Regel mit
einer neuen HTML-Seite. Auf der Seite HTML-0 im Einstellungen-Buch kФnnen Sie
das Erstellen einer Inhaltsverzeichnis-Seite ganz unterdrБcken, beispielsweise
beim Bearbeiten einer kleinen Homepage mit vielleicht nur einem "Kapitel", also
nur einer HTML-Seite.

Es lassen sich Kapitel und Unterkapitel wie in einer wissenschaftlichen Arbeit
gliedern:

HauptБberschrift
    Erste UnterБberschrift
    Zweite UnterБberschrift
         Erste UnterunterБberschrift
         Zweite UnterunterБberschrift
    Dritte UnterБberschrift

 Im Hypermake Quelltext schreiben Sie KapitelБberschriften wie folgt:


   .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

 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

 Bei IPF ist der Ъberschrifts-Text nach dem Gliederungsebenen-Punktbefehl auf
 etwa 200 Buchstaben begrenzt , aber man sieht im Fenstertitel nur etwa 70 bis
 120 Buchstaben, abhДngig von der Breite des Fensters auf dem Bildschirm.

 Zu Beginn des Hypermake-Quelltextes kann normaler Text erst nach der ersten
 KapitelБberschrift eingegeben werden.

 Es dБrfen bis zu 6 Gliederungsebenen verwendet werden.

 Unterkapitel:
 Besonderheiten bei HTML
 Besonderheiten bei Winhelp
 Querverweise zu Unterkapitel
 Gleichzeitiges Anzeigen mehrerer Fenster

 nДchstes Hauptkapitel:
 Schriften


ΓòÉΓòÉΓòÉ 5.3.1. Besonderheiten bei HTML ΓòÉΓòÉΓòÉ

Mit dem Schalter content level in der Ini-Datei (Projekt-Einstellungen Seite
"HTML-1", "erscheint in Inh.verz.") kФnnen Sie angeben, wieviele
Gliederungsebenen im Inhaltsverzeichnis erscheinen sollen.

Die meisten HTML-Browser zeigen Ъberschriften hoher Ordnung (5. und 6. Ebene)
mit einer kleineren Schrift als der Flieсtext. Das ist natБrlich nicht
akzeptabel. Wenn Sie HTML-Dateien mit 5. und 6. Gliederungsebene erstellen
mФchten, sollten Sie den Ъberschriften der Ebenen 4 bis 6 oder zumindest 5 und
6 grФсere Schriften zuweisen.

 .HS 123234

oder etwa

 .HS 112233

ordnet Ъberschriften einer bestimmten Ordnung eine andere GrФсe der Ъberschrift
zu.

Standardwert ist

 .HS 123456

Beachten Sie bitte die Javascript Baumansicht des Inhaltsverzeichnisses seit
Hypermake 3.6.


ΓòÉΓòÉΓòÉ 5.3.2. Besonderheiten bei Winhelp ΓòÉΓòÉΓòÉ


Mit dem Schalter heading fonts in der Ini-Datei ("Ъberschrifts-Listen" in den
Projekt-Einstellungen auf Seite "Winhelp") kann man Schrift-Buchstaben fБr die
Ъberschriften der verschiedenen Gliederungsebenen festlegen. Diese
Schrift-Buchstaben mБssen in der Ini-Datei unter Font definiert sein (Font).

Winhelp erlaubt es, die Ъberschrift eines Kapitels zu fixieren ("keep"), so daс
sie nicht mitgescrollt wird. Dies kann in der Ini-Datei mit keep heading (Seite
"Winhelp", "Ъberschriften nicht scrollen") ein- und ausgeschaltet werden.

CNT-Dateien

BezБglich des Inhaltsverzeichnisses unterscheiden sich die zwei Winhelp-Formate
WINHELP3 und WINHELP4: WINHELP3 hat gar kein Inhaltsverzeichnis "eingebaut", es
muс also von Hypermake auf der ersten Seite des Hypertextes generiert werden.
WINHELP4 bietet die sog. CNT-Dateien an. Das sind Textdateien, die mit der
Hilfedatei ausgeliefert werden mБssen und dann auf alle Seiten der Hilfedatei
verweisen. Sie haben eine ein- und ausklappbare baumartige Darstellung der
KapitelБberschriften.

CNT-Dateien kФnnen unter Windows 3.1 nicht gelesen werden. Hypermake erlaubt
Ihnen mit dem Schalter contents creation in der Ini-Datei (die zwei Checkboxen
bzgl. Inhaltsverzeichnis in den Projekt-Einstellungen Seite "Winhelp")
unabhДngig von der Einstellung WINHELP3/WINHELP4 die Art des
Inhaltsverzeichnisses zu wДhlen. Bei INTERNAL wird in der HLP-Datei am Anfang
ein Inhaltsverzeichnis generiert, wobei der Schalter contents level
("erscheint in Inh.verz." auf Seite "HTML-1"), der auch fБr HTML gilt,
interpretiert wird. Es kann also ein Inhaltsverzeichnis angelegt werden, das
nur z. B. 2 Ebenen tief ist. (Kommandozeilenversion) Es kann auch ein
Programmparameter /internal Бbergeben werden, ohne die Ini-Datei Дndern zu
mБssen.

Das WINHELP4 Format hat eine eigene Inhaltsverzeichnis-Datei mit der Endung CNT
(contents), die nicht von Windows 3.1 gelesen werden kann. Mit der Einstellung
contents creation = BOTH (beide Checkboxen auf der Seite "Winhelp" markiert)
legt Hypermake sowohl ein internes Inhaltsverzeichnis als auch die externe
CNT-Datei an. Wenn nun ein Winhelp3 Hypertext erzeugt wird, kann dieser unter
allen Windows-Versionen mit dem versions-spezifischen Inhaltsverzeichnis
betrachtet werden.

CNT-Dateien haben einen schweren Designfehler: Ein Hauptkapitel, das Text
enthДlt, ist nicht vorgesehen. Das ist aber die Regel: Bevor eine
UnterБberschrift kommt, ist meist erklДrender Text vorhanden. FБr den Text, der
eigentlich zum Hauptkapitel gehФrt, erzeugt Hypermake eine Zeile mit dem Text
"Allgemein", dieser kann in der Ini-Datei, Zeile contents general text  (CNT
'Allgemein' Text auf der Seite "Winhelp") verДndert werden.


ΓòÉΓòÉΓòÉ 5.3.3. Querverweise zu Unterkapitel ΓòÉΓòÉΓòÉ

Wenn ein Kapitel Unterkapitel hat, werden automatisch Verweise zu Unterkapiteln
und ein Verweis auf das nДchste Hauptkapitel generiert. In der Ini-Datei kФnnen
mit text for link to... (Projekt-Einstellungen "Text fБr Querverweise zu..."
auf der Seite "Link") die ErklДrungstexte "nДchstes Hauptkapitel" usw.
verДndert werden.

Ъblicherweise werden die Ъberschrifts-Texte der Unterkapitel einfach
untereinandergeschrieben. Etwa in einer Homepage kann es sinnvoll sein,
vertikal Platz zu sparen und stattdessen die Unterkapitel nebeneinander zu
schreiben.

Mit dem Punktbefehl .SC (Subchapter seperation characters) kФnnen Sie die
Darstellung der automatischen Querverweise zu Unterkapiteln verДndern.

Mit

 .sc trenntext

wird dann die Zeichenfolge "trenntext" zwischen die einzelnen
Unterkapitel-Ъberschriften geschrieben statt ein RETURN. Mit

 .sc RETURN

wird wieder das normale RETURN-Zeichen als Trennung zwischen
Unterkapitel-Ъberschriften verwendet.

Hiermit kФnnen Sie auch Grafiken zwischen den Ъberschriften verwenden:


 .btx blackdot
 .sc  x
 .2
 Erste UnterkapitelБberschrift

 .sc RETURN

(x steht fБr ein beliebiges unbenФtigtes Sonderzeichen)
Die Unterkapitel werden nebeneinander geschrieben, optisch getrennt durch
BLACKDOT.GIF.


 .sc RETURN RETURN
 .sc PARAGRAPH

sind zwei mФgliche Schreibweisen zur EinfБgung einer Leerzeile.


 .sc LIST

schreibt die Unterkapitel in der Listen-Schreibweise (unsortierte Liste).


ΓòÉΓòÉΓòÉ 5.3.4. Gleichzeitiges Anzeigen mehrerer Fenster ΓòÉΓòÉΓòÉ

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.

Gleichzeitiges Anzeigen zweier Gliederungsebenen

Wenn Sie den Punktbefehl Fensteranordnung


 .FA verti 30

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.


 .FA hori 40

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.

Mit dem Kommandozeilenparameter /NOFRAMES wird dieser Punktbefehl unterdrБckt.

FБr ein Beispiel zur zweiteiligen Fensteranordnung siehe Verzeichnis aller
Punktbefehle und Ini-Datei.

Winhelp verfБgt leider nicht Бber "Frames". Hypermake setzt diesen Befehl nun
anders um, und zwar werden zwei Hilfe-Fenster aufgemacht, allerdings nur bei
WINHELP4. Es wird links vom Hauptfenster ("main") noch ein kleineres
Steuerfenster angelegt ("navi"). Die Verti/Hori Prozentwerte des .FA Befehls
werden nicht interpretiert. Das ganze ist nun so gedacht, daс im kleinen
"Navi"-Fenster die Querverweise zu Unterkapitel stehen, wobei sich allerdings
sinnvollerweise nicht zu langer Flieсtext im Hauptkapitel empfiehlt. Im groсen
Hilfefenster erscheint dann das Unterkapitel.

FБr das Zielformat HTMLHELP werden Fenster automatisch immer nur "hori"
angeordnet und nicht "verti". Das HTML-Help Fenster wird nДmlich ohnehin schon
vertikal unterteilt (links das Inhaltsverzeichnis im Baumansicht und rechts der
eigentliche Text), so daс eine weitere horizontale Unterteilung ein
inakzeptabel schmales Fenster erzeugen wБrde.

Gleichzeitiges Anzeigen dreier Gliederungsebenen

Diese Funktion steht bislang nur bei der Erstellung von IPF-Dateien zur
VerfБgung.

In gleicher Art und Weise kФnnen Sie bei IPF auch drei Gliederungsebenen
gleichzeitig anzeigen lassen. Dabei mБssen Sie eine Angabe zu hori und zu verti
machen:


 .FA hori 40 verti 30 III

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:



            verti hori           hori verti

        ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
        Γöé     Γöé   II     Γöé   Γöé       I        Γöé
  I     Γöé  I  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
        Γöé     Γöé   III    Γöé   Γöé II  Γöé   III    Γöé
        Γöé     Γöé          Γöé   Γöé     Γöé          Γöé
        ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ

        ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ   ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
        Γöé  I  Γöé          Γöé   Γöé  I  Γöé   II     Γöé
        Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ          Γöé   Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
 III    Γöé     Γöé   III    Γöé   Γöé                Γöé
        Γöé II  Γöé          Γöé   Γöé      III       Γöé
        Γöé     Γöé          Γöé   Γöé                Γöé
        ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ   ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ

 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.

Unterkapitel:
Beispiel Fensteranordnung - Quelltext
Beispiel Fensteranordnung - Ergebnis

nДchstes Hauptkapitel:
Schriften


ΓòÉΓòÉΓòÉ 5.3.4.1. Beispiel Fensteranordnung - Quelltext ΓòÉΓòÉΓòÉ

.FA verti 50 hori 40 I
.4
Beispiel Fensteranordnung - Ergebnis

Das Hauptkapitel mit Querverweisen zu Unterkapiteln.

.5
Erstes Unterkapitel

Das erste Unterkapitel.

3-fach-Unterteilung wird nur fБr IPF 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.


ΓòÉΓòÉΓòÉ 5.3.4.2. Beispiel Fensteranordnung - Ergebnis ΓòÉΓòÉΓòÉ

Das Hauptkapitel mit Querverweisen zu Unterkapiteln.

Unterkapitel:
Erstes Unterkapitel
Zweites Unterkapitel

nДchstes Hauptkapitel:
Schriften


ΓòÉΓòÉΓòÉ 5.3.4.2.1. Erstes Unterkapitel ΓòÉΓòÉΓòÉ


Das erste Unterkapitel.
3-fach-Unterteilung wird nur fБr IPF unterstБtzt.

Unterkapitel:
Erstes Unterunterkapitel
Zweites Unterunterkapitel

nДchstes Hauptkapitel:
Zweites Unterkapitel


ΓòÉΓòÉΓòÉ 5.3.4.2.1.1. Erstes Unterunterkapitel ΓòÉΓòÉΓòÉ


Das erste Unterunterkapitel vom ersten Unterkapitel.


ΓòÉΓòÉΓòÉ 5.3.4.2.1.2. Zweites Unterunterkapitel ΓòÉΓòÉΓòÉ


Das zweite Unterunterkapitel vom ersten Unterkapitel.


ΓòÉΓòÉΓòÉ 5.3.4.2.2. Zweites Unterkapitel ΓòÉΓòÉΓòÉ


Das zweite Unterkapitel.

Unterkapitel:
Erstes Unterunterkapitel
Zweites Unterunterkapitel

nДchstes Hauptkapitel:
Schriften


ΓòÉΓòÉΓòÉ 5.3.4.2.2.1. Erstes Unterunterkapitel ΓòÉΓòÉΓòÉ


Das erste Unterunterkapitel vom zweiten Unterkapitel.


ΓòÉΓòÉΓòÉ 5.3.4.2.2.2. Zweites Unterunterkapitel ΓòÉΓòÉΓòÉ


Das zweite Unterunterkapitel vom zweiten Unterkapitel.


ΓòÉΓòÉΓòÉ 5.4. Schriften ΓòÉΓòÉΓòÉ


Unterkapitel:
Verwendung von Schriften
HTML Phrase element Beispiele
Farb-Beispiele

nДchstes Hauptkapitel:
Unsortierte und sortierte Listen


ΓòÉΓòÉΓòÉ 5.4.1. Verwendung von Schriften ΓòÉΓòÉΓòÉ


Hypermake erlaubt Ihnen, in der Ini-Datei (bzw. Projekt-Einstellungen Seite
"Font") verschiedene Schriften zu definieren. Eine Schrift hat eine bestimmte
GrФсe, evtl. eine bestimmte Farbe, einen bestimmten Schrifttyp (wie
"Helvetica") und evtl. noch weitere Eigenschaften. Einige Eigenschaften sind
nur auf ein bestimmtes Zielformat bezogen.

Eine solche in der Ini-Datei definierte Schrift wird mit einem Buchstabem
abgekБrzt, dem sog. Schrift-Buchstaben. Groс- und Kleinschreibung wird
unterschieden, somit kФnnen Sie jedem der 2 x 26 Schrift-Buchstaben in der
Ini-Datei verschiedene Schriften, GrФсen und Farben zuordnen. Der
Schrift-Buchstabe steht dann fБr alle Eigenschaften der Schrift, die Sie ihm in
der Ini-Datei zugeordnet haben. In der Regel werden Sie nicht mehr als 3 oder 4
solcher Schrift-Buchstaben definieren. Auсerdem mФchte ich Ihnen nahelegen, den
Standardwert (nДmlich keine Eigenschaften) 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. "Bevormunden" SIe also
nicht den kБnftigen Betrachter des Hypertextes, indem Sie ihm eine Schrift
vorsetzen, die Ihnen, aber nicht ihm gefДllt!

Schrift Normal

Mit dem Punktbefehl Schrift Normal

 .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!

Um Schrift Normal auf den Standardwert (default) zu setzen, schreiben Sie
einfach den Punktbefehl ohne weitere Parameter:

 .SN

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 (Projekt-Einstellungen Seite
"spec. chars") gesetzt.

So lassen sich Schrift und Farbe innerhalb des Flieсtextes umschalten:

Das schaut ziemlich d Д m l i c h aus.

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.

Schrift-Eigenschaften

Die Schrift-Eigenschaften werden fБr jeden Schrift-Buchstaben in der Ini-Datei
bzw. auf der Seite "Font" in den Projekt-Einstellungen definiert, und zwar pro
Zeile ein Schrift-Buchstabe. Rechts vom Ausdruck


font X =

dБrfen in beliebiger Reihenfolge Eigenschaften, durch Leerzeichen getrennt,
aufgelistet werden. Innerhalb der Eigenschaften dБrfen keine Leerzeichen
vorkommen.

Schrifttyp

Beim OS/2 Hilfetext stehen die Standardschriften von OS/2 zur VerfБgung, die
nach einer Standard-Installation von OS/2 unter "Schriftartpalette" im Ordner
Systemkonfiguration vorhanden sind: Courier Helv Helvetica Roman
System_monospaced System_proportional System_VIO Times_New_Roman Tms_Rmn und
seit Warp 3 Swiss Warp_Sans. Leerzeichen mБssen als Unterstrich _ geschrieben
werden.

FБr Winhelp muс bei Schrifttypen immer mit Doppelpunkt die sog. Schriftfamilie
davor angegeben werden, also etwa fswiss:Helvetica. Es gibt drei
Schriftfamilien:

     fmodern: feste Schritte, d.h. i nimmt den gleichen Platz wie m ein (z. B.
      Courier)
     froman: Proportionalschrift mit Serifen (z. B. Roman)
     fswiss: Proportionalschrift ohne Serifen (z. B. Helvetica)


 FБr HTML kФnnen wahlweise Schriften oder sog. Phrase Elements eingegeben
 werden. Da HTML unter verschiedenen Betriebssystemen und Browsern gelesen
 werden kФnnen soll, mБssen Sie bei der direkten Eingabe von Schrifttypen
 grundsДtzlich mehrere (mindestens zwei) Schriften angegeben, durch Komma und
 ohne Leerzeichen getrennt, also z. B. Arial,Helv,Helvetica,Univers . Wenn Sie
 einen Schrifttyp eingeben wollen, die wie "Tms Rmn" ein Leerzeichen enthДlt,
 mБssen Sie statt dem Leerzeichen einen Unterstrich _ eingeben.

 Ich persФnlich mФchte Ihnen raten, von der direkten Eingabe von Schriften
 keinen Gebrauch zu machen, da Sie nicht mit Sicherheit wissen, Бber welche
 FДhigkeiten der Browser und das Betriebssystem verfБgt. Auсerdem ist es eine
 gewisse Bevormundung des Benutzers, ihm seine "Lieblingsschrift" zu verwehren.

 HTML Phrase Elements

 Als plattformБbergreifendes Format bietet HTML das Konzept der "Phrase
 elements" an, das zweckmДсiger ist als die direkte Angabe von Schriften. Sie
 geben nicht direkt die Schriftart "Courier", "Helvetica" usw. ein, 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


 FБr IPF lДсt sich mit PRE die automatische Formatierung abstellen,
 beispielsweise fБr Quelltexte. Der entsprechende Punktbefehl Formatierung ist
 in diesem Fall nicht mehr nФtig.

 SchriftgrФсe

 Von allen Zielformaten werden SchriftgrФсen interpretiert, wobei 10 bis 12
 (Point) eine normale GrФсe darstellt. Es kann vorkommen, daс bei bestimmten
 Zielformaten alle mit solchen GrФсenangaben ausgestatteten Schriften im Viewer
 zu groс oder zu klein erscheinen. Sie kФnnen dann mit dem Programmparameter
 /bigfont bzw. /smallfont alle diese SchriftgrФсen-Angaben global um 30%
 vergrФсern oder verkleinern.

 Speziell bei HTML werden auch noch relative GrФсenangaben mit Minus- oder
 Pluszeichen davor oder eine Null interpretiert, also etwa -1 0 +2 diese
 Angaben haben auf andere Zielformate keine Wirkung. Stehen in der Ini-Datei
 sowohl eine relative als auch eine absolute GrФсenangabe, so wird bei HTML die
 relative GrФсenangabe verwendet. Ausnahmsweise spielt hier doch die
 Reihenfolge eine Rolle: die relative GrФсenangabe muс vor der absoluten
 stehen.

 Der IPFC Compiler erlaubt nicht mehr als 14 Schriften bestimmter SchriftgrФсe
 in einer Datei.

 Zeichensatz

 FБr IPF kФnnen Sie eine dreistellige Zahl als Zeichensatz (Codepage) eingeben,
 also  437 oder 850 .

 Farben

 Bei allen Hypertextformaten werden Farben unterstБtzt. Mittels Groс- und
 Kleinschreibung werden die Farben fБr die verschiedenen Zielformate
 auseinandergehalten.

 Bei HTML und Winhelp beginnen Farben mit einem Groсbuchstaben und und werden
 dann weiter klein geschrieben. Die folgenden 16 Farben stehen zur VerfБgung,
 siehe auch Farb-Beispiele:

  Black Silver Gray White Maroon Red Purple Fuchsia Green Lime Olive Yellow
 Navy Blue Teal Aqua

 Bei IPF stehen die folgenden Farben zur Auswahl:
  default blue cyan green neutral red yellow black
 Werden die Farben vollstДndig klein geschrieben, so wird die Vordergrundfarbe
 (die Farbe der Buchstaben) angegeben, bei vollstДndiger Groсschreibung die
 Hintergrundfarbe. IPF ist das einzige Format, das die Angabe einer
 Hintergrundfarbe Бber die Schrift-Buchstaben erlaubt.

 Sonstige Eigenschaften

 Mit dem center Attribut wird eine Schrift immer zentriert ausgegeben. Der
 Punktbefehl Output Centered lДсt sich so sparen. Es gibt noch zwei andere
 Schrift-Einstellungen: OmitLinks  ist beschrieben in Querverweise,
 UnterdrБcken von Querverweisen, LineStandard in Linienziehen.


ΓòÉΓòÉΓòÉ 5.4.2. HTML Phrase element Beispiele ΓòÉΓòÉΓòÉ


Phrase element Befehle werden von Browser zu Browser unterschiedlich
dargestellt.

In diesem Hypertextformat lassen sich HTML Phrase Elements nicht darstellen.


ΓòÉΓòÉΓòÉ 5.4.3. Farb-Beispiele ΓòÉΓòÉΓòÉ

Farben bei IPF:

Vordergrund

default
blue
cyan
green
neutral
red
yellow
black

Hintergrund

DEFAULT
BLUE
CYAN
GREEN
NEUTRAL
RED
YELLOW
BLACK


ΓòÉΓòÉΓòÉ 5.5. Unsortierte und sortierte Listen ΓòÉΓòÉΓòÉ

Das folgende Beispiel ist eine unsortiere Liste:

     Schriftstil
        -  Schrift (default, Tms_Rmn, Helv, Courier, System_VIO)
        -  SchriftgrФсe
     Schriftfarbe
        -  Vordergrundfarbe (default, blue, cyan, green, neutral, red, yellow,
           black)
        -  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 bei IPF und HTML sichtbaren Auflistungszeichen kФnnen nicht beeinfluсt
 werden, da sie im Viewer bzw. Browser festgelegt sind.

 Winhelp verfБgt eigentlich nicht Бber eine Listen-FunktionalitДt, sie wird von
 Hypermake simuliert. Deshalb kФnnen Sie nur bei Winhelp das Aussehen von
 Listen selbst beeinflussen, und zwar auf zweierlei Weise:

     Der Schalter List indention in der Ini-Datei (Projekt-Einstellungen Seite
      "Winhelp", Checkbox "EinrБckung bei Listen") beeinfluсt die GrФсe des
      linken Randes beim Befehl .LM (linker Rand) und auch die StДrke der
      EinrБckung von Listen.

     Mit dem Schalter printed listchars in der Ini-Datei ("Zeichen fБr
      Listen-KnФdel", Projekt-Einstellungen Seite "Winhelp") lДсt sich fБr jede
      Listen-EinrБckungsebene ein anderes Zeichen als vorangestellter "KnФdel"
      aussuchen. Sinnvoll sind etwa ein groсes O oder ein kleines o. Sie kФnnen
      aber auch ein Sonderzeichen verwenden, das ein Bitmap reprДsentiert
      (Befehl .BT Bitmap text). Gut sieht das Bitmap BLACKDOT.BMP aus dem
      Hypermake-Ordner BUTTONS\WINBMP aus.


 Die HTML- und IPF-Funktion Definition List wird nicht unterstБtzt; sie kФnnen
 es aber mit Hilfe des Befehls automatischer Rand simulieren.

 In der Ini-Datei kФnnen Sie Auflistungszeichen definieren
 (Projekt-Einstellungen Seite "spec. chars"). 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:


  * Schriftstil
  = Schrift (default, Tms_Rmn, Helv, Courier, System_VIO)
  = SchriftgrФсe
  * Schriftfarbe
  = Vordergrundfarbe (default, blue, cyan, green, neutral, red, yellow, black)
  = Hintergrundfarbe (gleiche Farben wie bei Vordergrundfarben).

 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:


   *  Schriftstil
     =  Schrift (default, Tms_Rmn, Helv, Courier, System_VIO)
     =  SchriftgrФсe

 Unterkapitel:
 Sortierte Listen

 nДchstes Hauptkapitel:
 Einbindung von Grafiken


ΓòÉΓòÉΓòÉ 5.5.1. Sortierte Listen ΓòÉΓòÉΓòÉ

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


 .SL
 .UL

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.


ΓòÉΓòÉΓòÉ 5.6. Einbindung von Grafiken ΓòÉΓòÉΓòÉ

Um eine Grafik (Bitmap) zentriert erscheinen zu lassen, verwenden Sie den
Punktbefehl bitmap


 .BM Dateiname

Wenn der Dateiname ohne Erweiterung geschrieben wird, wird bei IPF automatisch
".BMP" angehДngt. IPFC unterstБtzt auсerdem OS/2-MET-Dateien.

Wenn der Dateiname ohne Erweiterung geschrieben wird, wird bei Winhelp
automatisch ".BMP" angehДngt.

Beachten Sie bitte, daс IPF OS/2-Bitmaps und Winhelp Windows-Bitmaps verlangen.
Diese sind zueinander nicht kompatibel. Verwenden Sie deshalb am besten fБr
beide Formate unterschiedliche graphic path Verzeichnisse.

Bei der Erstellung von HTML-Dateien wird automatisch ".GIF" angehДngt, wenn der
Grafikdateiname ohne Erweiterung angegeben wird.

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


 .BM RECHTS
 .BM Dateiname

Bei HTML fБhrt CENTER zu einem linksbБndigen Bild, das nicht von Text umflossen
wird.

Mit einem zweiten Punktbefehl bitmap text lassen sich Grafiken in den Flieсtext
integrieren:


 .BTX Dateiname

 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:


 .BTX

ohne Dateiname.

(Neu ab Hypermake 3.65) Wenn sich die Grafikdateien nicht im angemeldeten
Verzeichnis befinden sollen, kФnnen Sie mit


 .BD Verzeichnis/

bitmap directory eine Zeichenfolge eingeben, die allen Dateinamen bei den
folgenden .BM und .BT Befehlen vorangestellt wird. Hierbei dБrfen Sie den
Backslash \ bzw. Slash / nicht vergessen. Dieser Befehl hat keine Auswirkung
auf die Navigations-KnФpfe von HTML-Seiten. Das automatische Kopieren von
Grafikdateien wird bei Verwendung von  .BD deaktiviert.


ΓòÉΓòÉΓòÉ 5.7. Querverweise und Index ΓòÉΓòÉΓòÉ


Unterkapitel:
Automatische Erstellung von Querverweisen und IndexeintrДgen
Markieren eines einzelnen Wortes, Оndern des Indexzeichens
Markieren eines Ausdrucks
Markieren eines Ausdruckes auсerhalb des Flieсtextes
Querverweise bei leicht abweichenden WФrtern
Mehrmalige Markierung eines Wortes
UnterdrБcken von Querverweisen
Externe Querverweise bei IPF/Winhelp4 (external links)
Externe Querverweise ins WWW (external links)
Programme per Querverweis starten (launching programs)

nДchstes Hauptkapitel:
Duplizierung von KapitelБberschriften


═══ 5.7.1. Automatische Erstellung von Querverweisen und IndexeintrДgen ═══


Die Erstellung von Querverweisen ist die mДchtigste Funktion von Hypermake.
Wenn man eine HTML, RTF- 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.

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 (Projekt-Einstellungen Seite
"html-1", "Minimale Wortzahl fБr groсes Stichwortverz.").

Auf der Seite HTML-0 im Einstellungen-Buch kФnnen Sie beim Erstellen von
HTML-Seiten die Erzeugung einer Stichwortverzeichnis-Seite ganz unterdrБcken.
Das kann dann sinnvoll sein, wenn Sie nur eine kleine Webpage erzeugen und nur
zwei oder drei AusdrБcke erscheinen wБrden.


═══ 5.7.2. Markieren eines einzelnen Wortes, Оndern des Indexzeichens ═══

Markieren eines einzelnen Wortes

Um ein einzelnes Wort fБr die Querverweis- und Index-Erstellung zu markieren,
wird das Indexzeichen vorangestellt:


Eine #Workgroup ist eine Gruppe von Personen, die...

Achtung: verwenden Sie Indexzeichen nicht in KapitelБberschriften, benutzen Sie
hierfБr die Duplizierung von KapitelБberschriften.

Оndern des Indexzeichens

Mit dem Punktbefehl Indexzeichen


 .IZ@

wird die aktuelle Einstellung fБr das Indexzeichen aus der Ini-Datei
(Projekt-Einstellungen Seite "spec. chars") , z. B. # , in @ geДndert.


ΓòÉΓòÉΓòÉ 5.7.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 (Projekt-Einstellungen Seite "spec.
chars").

Um einen Ausdruck mehrerer WФrter zu markieren, werden zusДtzlich zum
Indexzeichen Doppelpunkte wie Klammern verwendet:


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...

Im Index wird folgendes erscheinen:

Sicherheit
    von Computern
    von Groсrechnern
 Computern, Benutzerfreundlichkeit von

 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

 Computern
    Benutzerfreundlichkeit von

 schreibt Hypermake im Index

 Computern, Benutzerfreundlichkeit von

 Ihnen wird schon aufgefallen sein, daс die Endung "Computern" nicht sehr schФn
 ausschaut. Solche unschФnen Endungen dБrfen Sie ausklammern:


  DafБr hat die #:Benutzerfreundlichkeit von Computer;n doch...
   ...
  hat gezeigt, daс bei #:Computer:n


═══ 5.7.4. Markieren eines Ausdruckes auсerhalb des Flieсtextes ═══

Mit dem Punktbefehl INdex


 .IN Ausdruck

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.

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.


 .IV Benutzerfreundlichkeit von Computer

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.


═══ 5.7.5. Querverweise bei leicht abweichenden WФrtern ═══

Verfahrensweise bei Wortendungen

Was macht Hypermake, wenn das Wort "Maschinen" 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 (Projekt-Einstellungen Seite "Link"). Dieser
Eintrag ist sprachspezifisch.

Wenn umgekehrt "Maschinen" 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 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.

Groс- und Kleinschreibung

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:

 .IN Wort

Querverweise werden erstellt nach Wort , wort , aber nicht nach WORT .

(Neu ab Hypermake 3.65) Mit dem Punktbefehl


 .IU

(ignore uppercase) zu Beginn des Hypermake Quelltextes wird zwischen Groс- und
Kleinschreibung grundsДtzlich gar nicht unterschieden.


ΓòÉΓòÉΓòÉ 5.7.6. 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.


═══ 5.7.7. 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 ("keine weiteren Querverweise im...", Projekt-Einstellungen Seite
"Link"). Mit "immer" (ALWAYS) kФnnen Sie das UnterdrБcken von Querverweisen
abschalten. Auch wenn der selbe Ausdruck mehrfach hintereinander kommt, wird
immer wieder ein Link gezogen.

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 bzw. im
Schrift-Dialog der Projekt-Einstellungen, Seite "Font".

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.


ΓòÉΓòÉΓòÉ 5.7.8. Externe Querverweise bei IPF/Winhelp4 (external links) ΓòÉΓòÉΓòÉ

Externe Querverweise sind Querverweise, die zu einem Kapitel eines anderen INF-
oder HLP-Dokuments hin oder ins WWW zeigen. Externe Querverweise zu anderen
Hilfedateien kФnnen Sie nur nutzen, wenn Sie die "fremde" Hilfedatei ebenfalls
selbst erstellen oder die ID's der Seiten kennen.

Externe Querverweise funktionieren grundsДtzlich nicht bei Winhelp3.

WДhrend bei Winhelp keine Panel ID Dateien benФtigt werden, holt sich Hypermake
bei IPF die Daten zum Sprungziel aus der Panel ID Datei der fremden Hilfedatei.
Die restlichen Schritte sind bei beiden Zielformaten wiederum identisch.

Um solche externen Querverweise (external links) zu erzeugen, sind

     (nur IPF) die Ini-Datei bzw. die Projekt-Einstellungen, Seite Help
     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 fБr IPF die Hypermake Funktion der Erstellung von
 Panel ID's. Das Kapitel Бber Panel ID's mБssen Sie aber nicht extra lesen.

 Ini-Datei

 In der Ini-Datei muс unter "Panel ID filename =" eine Bezeichnung beginnend
 mit *. eingetragen werden (Projekt-Einstellungen Seite "Helpfile") , also etwa


  Panel ID filename = *.PAN

 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.

 Sprungziel-Datei

 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


   .ID Kapitel_Einleitung

 in der Sprungziel-Datei erhДlt das Kapitel, wo der Punktbefehl steht, die
 Kurzbezeichnung "Kapitel_Einleitung", vgl. Datei BEISPIEL.

 Bei IPF speichert Hypermake alle durch den ID-Punktbefehl deklarierten
 Kurzbezeichnungen in der Datei Quelldateiname.PAN oder einer anderen
 Erweiterung, je nach Eintrag in der Ini-Datei, ab. Auf diese Datei greift
 Hypermake bei IPF dann zu, wenn die Sprungstart-Datei kompiliert wird.

 Sprungstart-Datei

 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.


   .EX Dateiname.hlp
   .ID Kapitel_Einleitung
   .IN Ausdruck
   .EX

 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 bzw.
 Dateiname.hlp, das mit dem ID Punktbefehl ".ID P_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


   .EX Dateiname.hlp

 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 (nur
 wenn dieses Dokument eine Win95- oder OS/2-Hilfedatei ist). Beim Erstellen
 dieses Hypertextes (also der Sprungstart-Datei) habe ich an einer beliebigen
 Stelle den folgenden Befehlsblock geschrieben:


   .EX beispiel.hlp
   .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.


ΓòÉΓòÉΓòÉ 5.7.9. Externe Querverweise ins WWW (external links) ΓòÉΓòÉΓòÉ

Diese Funktion steht auсer Winhelp3 fБr alle Zielplattformen zur VerfБgung. Aus
Hilfedateien heraus wird dann der Browser gestartet.

Bei OS/2-Hilfedateien wird davon ausgegangen, daс der Browser NETSCAPE.EXE
heiсt und in einem Verzeichnis steht, das unter PATH in der Datei CONFIG.SYS
steht.
Bei Windows wird von der Hilfedatei aus der Browser gestartet, der die
StandardverknБpfung mit HTML-Dateien hat.

Externe mailto: Querverweise, also das Starten des Browser E-Mail-Programms,
wird weder bei Winhelp3 noch bei Winhelp4 unterstБtzt.

Manuelle externe Querverweise

Wenn Hypermake einen Ausdruck findet, der mit einem
Transferprotokoll-Bezeichner gefolgt von einem Doppelpunkt beginnt wie
ftp://ftp.leo.org, so wird der Ausdruck automatisch zu einem Link. FБr das Ende
der URL-Adresse interpretiert Hypermake die folgenden Zeichen: LEER oder RETURN
oder , oder ) oder ;. Diese FunktionalitДt ist stДndig eingeschaltet, Sie
kФnnen es aber mit Hilfe einer Schrift, bei der OmitLinks aktiviert ist,
unterdrБcken.

Transferprotokoll-Bezeichner sind:
http://
ftp://
gopher://
wais://
news://
file://
javascript:
mailto:

Automatische externe Querverweise

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:


 .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.

Externe Querverweise als solche markieren

Mit dem Schalter URL graphics file in der Ini-Datei ("URL Grafikdatei"
Projekt-Einstellungen Seite "Link") wird Hypermake angewiesen, eine bestimmte
Grafik direkt vor jeden externen Link zu setzen. So kann der Leser des Textes
sehen, bei welchen Links er online sein muс (bzw. ein Browser erst gestartet
wird) und bei welchen nicht. Wenn Sie einen HTML-Text fБr das WWW erstellen,
sollten Sie mit NO diese graphische Markierung unterdrБcken; schlieсlich sind
hier externe Links der Normalfall.

In der Hypermake Button-Bibliothek (Verzeichnis BUTTONS) finden Sie die GIF-
bzw. BMP-Dateien WORLD und WORLD2, die speziell hierfБr bestimmt sind.


ΓòÉΓòÉΓòÉ 5.7.10. Programme per Querverweis starten (launching programs) ΓòÉΓòÉΓòÉ

Оhnlich wie externe Querverweise kann von Hilfedateien auf externe Programme
verwiesen werden, kФnnen also externe Programme gestartet werden.

Diese FunktionalitДt steht bei Winhelp4 und IPF, nicht aber bei Winhelp3 oder
HTML zur VerfБgung.


 .EX NOTEPAD.EXE BEISPIEL.TXT
 .IN Datei BEISPIEL bei Windows
 .EX E.EXE BEISPIEL.TXT
 .IN Datei BEISPIEL bei OS/2
 .EX

Hier sehen Sie den Querverweis zur Datei BEISPIEL bei Windows bzw. Datei
BEISPIEL bei OS/2, bei dem der Systemeditor gestartet wird.

DrБckt der Benutzer auf "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
Batch-Dateien mit der Endung .CMD oder DOS-Dateien mit der Endung .BAT oder
.COM gestartet 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.

Winhelp3 hat Probleme beim Aufrufen eines Programmes mit Programmparameter,
hier BEISPIEL.TXT. Es verwendet als angemeldetes Verzeichnis das Verzeichnis,
in dem sich das Programm befindet, statt sich an dem Verzeichnis zu
orientieren, in dem sich die Hilfedatei befindet - Winhelp4 und IPF haben hier
keine Probleme. Verwenden Sie in diesem Fall Umgebungsvariablen.

Damit eine Bezeichnung wie "CONFIG.SYS" oder "Eule (Film)" einen Querverweis
bekommt, mБssen Punkt bzw. Klammern in der Ini-Datei unter extended letters
(Projekt-Einstellungen Seite "spec. chars") aufgefБhrt sein.

Wenn Daten nicht bei jedem Benutzer in einem bestimmten Pfad, z. B.
C:\MMOS2\MOVIES, zu finden sind, mБssen Umgebungsvariablen verwendet werden.

Unterkapitel:
Umgebungsvariablen

nДchstes Hauptkapitel:
Duplizierung von KapitelБberschriften


ΓòÉΓòÉΓòÉ 5.7.10.1. Umgebungsvariablen ΓòÉΓòÉΓòÉ

Bei externen Querverweisen und beim Starten von Programmen kФnnen
Umgebungsvariablen sehr ratsam sein.

Beim Verwenden einer Hilfedatei 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
(OS/2), AUTOEXEC.BAT (DOS, Win95) bzw. in der Registry (NT) z. B. folgenden
Eintrag haben:


SET MMVIDEO=C:\MMOS2\MOVIES

Im Hypermake-Quelltext schreiben Sie dann:


 .EX mppm.exe %MMVIDEO%\macaw.avi
 .IN Papagei
 .EX

Das Betriebssystem ersetzt dann den Ausdruck %MMVIDEO% gegen den bei SET
angegebenen Laufwerks- und Pfadnamen.

Genauso kФnnen Sie bei externen Querverweisen verfahren.

In den FДllen, wo die Pfadbezeichnung mit einem Strichpunkt endet, etwa


SET MMBASE=C:\MMOS2;

funktioniert zumindest bei OS/2 die Umgebungsvariable nicht mehr und der
Querverweis wird nicht gezogen.


═══ 5.8. Duplizierung von KapitelБberschriften ═══

Wie und ob KapitelБberschriften angezeigt werden, ist bei den verschiedenen
Zielformaten sehr unterschiedlich: Die IBM Hilfe zeigt die KapitelБberschrift
in der Titelleiste, aber standardmДсig nicht im Textbereich an, wДhrend bei
HTML die Ъberschrift im Textbereich steht. Winhelp schreibt die Ъberschrift
standardmДсig weder in die Titelleiste noch in den Textbereich - hier muс
Hypermake also auf alle FДlle "eingreifen".

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:


 .3
 KapitelБberschrift

 .IN KapitelБberschrift
 .snX
 KapitelБberschrift
 .sn

Diese Tipparbeit kann man sich sparen. Mit dem Punktbefehl DuPliziere


 .dpX

wird die KapitelБberschrift zu Beginn des Flieсtextes in Schrift C dupliziert,
d.h. wiederholt, und zwar in allen Gliederungsebenen.
Besonders vorteilhaft ist dies fБr IPF bei sehr langen Ъberschriftstexten, da
bei INF-Dateien in der Fensterleiste meist nur die ersten 70 Buchstaben Platz
finden.
Bei Winhelp ist die Duplizierung von KapitelБberschriften immer aktiviert,
sonst wБrde nДmlich die KapitelБberschrift gar nicht erscheinen - sie wБrde
sonst nur bei "Suchergebnis" auftauchen. Mit dem Schalter heading fonts in der
Ini-Datei ("Ъberschrifts-Schriften" Projekt-Einstellungen Seite "Winhelp") kann
man Schrift-Buchstaben fБr die Ъberschriften der verschiedenen Kapitelebenen
festlegen. Diese Schrift-Buchstaben mБssen natБrlich in der Ini-Datei bzw. in
den Projekt-Einstellungen unter Font auch wirklich definiert sein (Font).
ZusДtzlich kann mit dem Schalter keep heading  ("Ъberschriften nicht scrollen",
Seite "Winhelp") verhindert werden, daс die Ъberschriften mitgescrollt werden.

Mit Hilfe der Einstellung Index Filter in der Ini-Datei (Projekt-Einstellungen
Seite "spec. chars") kФnnen bestimmte Zeichen im Stichwortverzeichnis und bei
der Duplizierung von KapitelБberschriften unterdrБckt werden.


 .dp34X

fБhrt die Duplizierung nur fБr Gliederungshierarchie 3 und 4 aus.


 .dp-

deaktiviert die Duplizierungs-Funktion Бber alle Gliederungsebenen.


 .dp-234

deaktiviert die Duplizierungs-Funktion in den Gliederungsebenen 2, 3 und 4.


 .dp#

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 bzw. den Projekt-Einstellungen
verwenden.


 .dp##

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.
Ъbrigens kann bei IPF ein groсer Index eine INF-Datei bei der Benutzung des
Index sehr langsam machen.


 .dp3##X,
 .3
 Meier, Fritz

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.

Unterkapitel:
Beispiel Duplizierung KapitelБberschriften - Quelltext
Beispiel Duplizierung KapitelБberschriften - Ergebnis

nДchstes Hauptkapitel:
Tabellen (Tables)


═══ 5.8.1. Beispiel Duplizierung KapitelБberschriften - Quelltext ═══

.fa verti 40
.dp4E#,
.3
Beispiel Duplizierung KapitelБberschriften - Ergebnis

Bundeskanzler seit 1949

(CDU, SPD und Kanzler sind externe Querverweise. Schrift E 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

Kanzler der CDU von 1982 bis 1998. Nachfolger von Helmut Schmidt.

.4
SchrФder, Gerhard

amtierender Kanzler der SPD seit 1998. Nachfolger von Helmut Kohl.


═══ 5.8.2. Beispiel Duplizierung KapitelБberschriften - Ergebnis ═══

Bundeskanzler seit 1949

(CDU, SPD und Kanzler sind externe Querverweise. Schrift R ist in Ini-Datei
definiert.)

Unterkapitel:
Adenauer, Konrad
Erhard, Ludwig
Kiesinger, Kurt Georg
Brandt, Willy
Schmidt, Helmut
Kohl, Helmut
SchrФder, Gerhard

nДchstes Hauptkapitel:
Tabellen (Tables)


ΓòÉΓòÉΓòÉ 5.8.2.1. Adenauer, Konrad ΓòÉΓòÉΓòÉ


 Konrad Adenauer

1949-1963, CDU, war der erste Kanzler nach dem zweiten Weltkrieg. Ihm folgte
Ludwig Erhard.


ΓòÉΓòÉΓòÉ 5.8.2.2. Erhard, Ludwig ΓòÉΓòÉΓòÉ


 Ludwig Erhard

1963-1966, CDU, Nachfolger von Konrad Adenauer. Zweiter Kanzler der
Bundesrepublik. Ihm folgte Kurt Georg Kiesinger.


ΓòÉΓòÉΓòÉ 5.8.2.3. Kiesinger, Kurt Georg ΓòÉΓòÉΓòÉ


 Kurt Georg Kiesinger

1963-1966, dritter Kanzler der CDU, leitete die groсe Koalition von CDU und
SPD. Nachfolger von Ludwig Erhard.


ΓòÉΓòÉΓòÉ 5.8.2.4. Brandt, Willy ΓòÉΓòÉΓòÉ


 Willy Brandt

1969-1974, erster Kanzler der SPD.


ΓòÉΓòÉΓòÉ 5.8.2.5. Schmidt, Helmut ΓòÉΓòÉΓòÉ


 Helmut Schmidt

1974-1982, Kanzler der SPD aus den Siebzigern. Nachfolger von Willy Brandt.


ΓòÉΓòÉΓòÉ 5.8.2.6. Kohl, Helmut ΓòÉΓòÉΓòÉ


 Helmut Kohl

Kanzler der CDU von 1982 bis 1998. Nachfolger von Helmut Schmidt.


═══ 5.8.2.7. SchrФder, Gerhard ═══


 Gerhard SchrФder

amtierender Kanzler der SPD seit 1998. Nachfolger von Helmut Kohl.


ΓòÉΓòÉΓòÉ 5.9. Tabellen (Tables) ΓòÉΓòÉΓòÉ

Hypermake 3.0 ermФglicht die einfache Eingabe von Tabellen in der Form, wie sie
als ASCII-Text mit festen Schritten dargestellt wird:


 .TA Beispiel
 erste Zelle  Zahlen   -----dritte und vierte----
 erste Zelle   97,96  dritte Zelle  vierte Zelle+
 erste Zelle  1.324,90  dritte Zelle  zweite Zeile
 erste Zelle    0,00  dritte Zelle  Binde-
 erste Zelle  -123,45  "       strich
 .TA

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
Γöéerste Zelle ΓöéZahlen    Γöédritte und   Γöé            Γöé
Γöé            Γöé          Γöévierte       Γöé            Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöéerste Zelle Γöé97,96     Γöédritte Zelle Γöévierte ZelleΓöé
Γöé            Γöé          Γöé             Γöézweite ZeileΓöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöéerste Zelle Γöé1.324,90  Γöédritte Zelle Γöé            Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöéerste Zelle Γöé0,00      Γöédritte Zelle ΓöéBinde-      Γöé
Γöé            Γöé          Γöé             Γöéstrich      Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöéerste Zelle Γöé-123,45   Γöé             Γöé            Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ

Die FДhigkeiten von IPF-Tabellen sind lange nicht so groс wie bei HTML. FБr
IPF-Tabellen benutzen Sie besser keine " und + Zeichen. Hypermake versucht zwar
das beste daraus zu machen, doch ist das Ergebnis oft wenig befriedigend. IPFC
erzeugt Бbrigens Tabellen grundsДtzlich nur mit fester Schrift.

Bei RTF werden fБr Tabellen keine Linien gezogen. Das " Zeichen macht hier
nicht viel Sinn. Das + Zeichen wird zwar unterstБtzt, schaut aber nicht gut
aus.

Eine Tabelle (Table) beginnt mit einem .TA Punkbefehl, gefolgt von einem Titel.
Soll die Tabelle keinen Titel erhalten, muс .TA NO geschrieben werden. .TA
gefolgt von einem Return, also ohne weitere Angaben, beendet die Tabelle.

Winhelp und IPF kennen keinen Table-Titel. Wenn Sie diese Formate auch abdecken
mФchten, sollten Sie besser den Titel auсerhalb der Tabelle schreiben und dann
.TA NO fБr den Beginn der Tabelle verwenden.

Tables kФnnen weitestgehend so eingegeben werden, wie man sie in einem Editor
mit mit festem Zeichenabstand darstellt. Es gelten folgende Regeln:

     Zwischen zwei Zellen mБssen zwei Leerzeichen sein. Dies ist das Kriterium
      fБr die Trennung zwischen den Zellen. Die zwei Leerzeichen mБssen nicht
      immer untereinanderstehen, zumindest eine Spalte sollte aber schon Бber
      alle gewБnschten Zeilen nur Leerzeichen enthalten. LinksbБndigkeit bzw.
      RechtsbБndigkeit spielt keine Rolle.
     Soll eine Zelle Бber zwei Zellen-Zeilen gehen, so wird sie nach unten mit
      einem GДnsefБсchen verlДngert.
     Soll eine Zelle grФсer sein als deren Textinhalt, so darf der Text am
      Anfang und Ende mit Bindestrichen aufgefБllt werden. Diese werden wieder
      gelФscht, wenn sie nicht einzeln vorkommen wie beim Beispiel -123,45.
     mehrere Zeilen kФnnen zu einer Zelle zusammengefaсt werden: Entweder mit
      einem Plus-Zeichen am Ende der Zeile, dieses wird nicht dargestellt; oder
      ein einzelner Bindestrich.


 Falls das + Zeichen schon anderweitig verwendet wird, kann jederzeit mit dem
 Befehl

  .tc X

 (table character) stattdessen ein beliebiger Buchstabe X eingestellt werden.

 Mit dem Punktbefehl

  .TT

 (Table Tags) kФnnen HTML Table Tags verДndert werden. Standard ist

  .TT BORDER CELLPADDING=5

  .TT BORDER CELLPADDING=5 BGCOLOR="#D0D0D0"

 verwendet fБr die Tables einen grauen, einfarbigen Hintergrund. Das kann
 vonnФten sein, wenn Sie ein Hintergrundbild verwenden (siehe Ini-Datei,
 Schalter body tags, Projekt-Einstellungen Seite html-1), in dem Linien
 enthalten sind. Das kann dann in Kombination mit den Table-Linien
 unБbersichtlich aussehen.

 Seit Hypermake 3.6 gibt es nun noch einige zusДtzliche Befehle fБr HTML
 Tables. Es lДсt sich nach einem .TA Befehl noch der Befehl .TP Table position
 einfБgen:


   .TA Dies ist eine Tabelle
   .TP links

 Es gibt die WahlmФglichkeiten links  rechts und zentriert . Hypermake versucht
 dann nicht mehr zu "erraten", wie der Text in jeder Zelle ausgerichtet werden
 soll. StandardmДсig werden nДmlich beim Zielformat HTML Zellen, die
 Бberwiegend Ziffern enthalten, rechtsbБndig geschrieben und Zellen, die
 Бberwiegend Buchstaben enthalten, linksbБndig; Zellen, die Бber zwei oder mehr
 Zellen-Spalten sich erstrecken, erhalten zentrierten Text.

 Es gibt noch einen weiteren Befehl .TE (Table empty), der ebenfalls nach dem
 ersten  .TA Befehl geschrieben wird.

  ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
  Γöéerste Zelle ΓöéZahlen    Γöédritte und   Γöé            Γöé
  Γöé            Γöé          Γöévierte       Γöé            Γöé
  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  Γöéerste Zelle Γöé97,96     Γöédritte Zelle Γöévierte ZelleΓöé
  Γöé            Γöé          Γöé             Γöézweite ZeileΓöé
  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  Γöéerste Zelle Γöé1.324,90  Γöédritte Zelle Γöé            Γöé
  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  Γöéerste Zelle Γöé0,00      Γöédritte Zelle ΓöéBinde-      Γöé
  Γöé            Γöé          Γöé             Γöéstrich      Γöé
  Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
  Γöéerste Zelle Γöé-123,45   Γöé             Γöé            Γöé
  ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ

 Vergleichen Sie die letzte Spalte mit der der vorigen Tabelle. Ist .TE
 aktiviert, so erstrecken sich keine Zellen mehr Бber die HФhe von zwei oder
 mehr benachbarten Zellen. Es heiсt deshalb "empty" (leer), weil Sie
 stattdessen eine leere Zelle erhalten bzw. nur mit dieser Einstellung Tabellen
 schreiben kФnnen, in denen viele Zellen ganz leer sein dБrfen.

 Ich empfehle Ihnen einfach, den .TE Befehl zu verwenden, falls Hypermake Ihre
 Tabelle "vermurkst" hat.

 Sowhl die Einstellung von .TP als auch von .TE gilt fБr eine Tabelle, fБr die
 darauffolgende gelten dann wieder die Standardwerte.

 Noch ein kleiner Tip. Wenn Sie folgende Darstellung haben:


  maximale Durchschnitts-
  geschwindigkeit in km/h   180     240

 dann sollten Sie die Zahlen eine Zeile hФher rБcken, also an das obere Ende
 der Zelle, die Бber zwei Zeilen geht. Andernfalls wБrden Sie zwei
 eigenstДndige Zell-Zeilen erhalten.

 Mit dem bei Hmake 3.65 neuen .TW Table word wrap (Tabellen Wortumbruch, nur
 HTML) Punktbefehl fБllt eine Tabelle immer das gesamte Browserfenster aus und
 die festen ZeilenvorschБbe innerhalb einer Zelle verschwinden, so daс Sie eine
 neue Formatierung innerhalb der Zelle erhalten. Wie bei .TE muс .TW fБr jede
 Tabelle am Anfang nach .TA geschrieben werden.


ΓòÉΓòÉΓòÉ 5.10. Linienziehen ΓòÉΓòÉΓòÉ

Linienziehen wird vor allem von IPF gut umgesetzt. Bei HTML und Winhelp mangelt
es dem dort Бblichen Ansi-Zeichensatz an den Linien-Grafikzeichen, so daс hier
das Ergebnis nicht besonders gut aussieht.

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:


 .LIXY

   X              X

      Operating systems

   Y         Y         X       X
      Novell     IBM        Hardware
   Y    Y              X       X
     DOS  Netware   OS/2
   X              X
 .LI

Und Sie erhalten:


      ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
      Γöé                           Γöé
      Γöé     Operating systems     Γöé
      Γöé                           Γöé
      Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ      ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
      Γöé      Novell     Γöé  IBM    Γöé      Γöé  Hardware  Γöé
      Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ      ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ
      Γöé  DOS  Γöé Netware Γöé  OS/2   Γöé
      ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ

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 (Schrift-Dialog der Projekt-Einstellungen Seite "Font").

Bei IPF werden kombinierte Einfach/Doppel-Striche nur mit Codepage 437
unterstБtzt. Falls Sie andere Codepages verwenden mБssen, verwenden Sie bitte
keine Doppelstriche.


═══ 5.11. Fuсnoten ═══

Die Hilfeformate IPF, Winhelp und HTMLHELP kennen Fuсnoten als Popup-Fenster.
Bei HTML realisiert Hypermake die Fuсnoten-FunktionalitДt Бber Frames.

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 oder ein
Grafikzeichen , auf das Sie mit der Maus drБcken kФnnen.

Andere brauchbare Fuсnotenzeichen sind [ ], < > oder ▄ (Alt-220) ▀ (Alt-223) -
sozusagen fette GДnsefБсchen (nur bei IBM Zeichensatz).

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.

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:


 .BT& Dateiname
 .FT&

(siehe Grafiken)

Beim Erzeugen von HTML kФnnen Sie mit dem Schalter footnotes in der Ini-Datei
(Projekt-Einstellungen Seite "html-2") die Art der Fuсnoten beeinfluсen. Es
gibt drei WahlmФglichkeiten:  frames , noframes und activex . activex erzeugt
Popup-Fuсnotenfenster, was bei der Erstellung von HTML-Help sinnvoll ist. Mit
der Schalterstellung activex erzeugte HTML-Fuсnoten kФnnen nur mit
Microsoft-Browsern angesehen werden, verwenden Sie solche Seiten also nicht zur
VerФffentlichung im Internet!

Wenn Sie bei HTML Fuсnoten nicht als Frames dargestellt haben mФchten, sondern
als separate Datei, kФnnen Sie dies auch mit dem Programmparameter  NOFRAMES
(Projekt-Einstellungen Seite "Main", Sektion Parameter) erreichen.


═══ 5.12. RДnder und Formatierung ═══


Unterkapitel:
Linken Rand verstellen
Formatierung aus- und einschalten
Zentrierter Text
Automatischer Rand (auto margin)

nДchstes Hauptkapitel:
If-Bedingungen


ΓòÉΓòÉΓòÉ 5.12.1. Linken Rand verstellen ΓòÉΓòÉΓòÉ


Das ist ein Beispielstext mit linkem Rand 1.

          Dies ist ein Beispielstext mit linkem Rand 10; beachten Sie, daс die
          EinrБckung auch in den folgenden Zeilen korrekt ist.

                    Dies ist ein Beispielstext mit linkem Rand 20; beachten
                    Sie, daс die EinrБckung auch in den folgenden Zeilen
                    korrekt ist.

 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.

 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.

 Der Schalter List indention in der Ini-Datei (Projekt-Einstellungen Seite
 "Winhelp") beeinfluсt speziell bei Winhelp die GrФсe des linken Randes beim
 Befehl .LM (linker Rand) und auch die StДrke der EinrБckung von Listen.


ΓòÉΓòÉΓòÉ 5.12.2. Formatierung aus- und einschalten ΓòÉΓòÉΓòÉ

Bei Erstellung von IPF-Dateien lДсt sich mit den Punktbefehlen Formatierung aus
und Formatierung an


 .FM aus

 .FM an

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.
Klammern Sie in diesem Fall Index-Punktbefehle zwischen zwei
Formatierungsbefehle ein:


 .fm an
 .in Wort1
 .in Wort2
 .fm aus

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.

Bei IPF kФnnen Sie bei Festlegung der Schrift PRE in der Ini-Datei
(Schrift-Dialog bei den Projekt-Einstellungen Seite "Fonts") deklarieren, Sie
kФnnen sich die eigenen Punktbefehle dann sparen.


ΓòÉΓòÉΓòÉ 5.12.3. Zentrierter Text ΓòÉΓòÉΓòÉ

Bei zentriertem Text ist die Formatierung immer ausgeschaltet. Zentrierten Text
kann man ein- und ausschalten mit dem Punktbefehl Output Centered


 .OC an
 .OC aus

Sie kФnnen aber auch bei Festlegung der Schrift in der Ini-Datei  center (bzw.
im Schrift-Dialog) schreiben, die eigenen Punktbefehle kФnnen Sie dann sparen.


ΓòÉΓòÉΓòÉ 5.12.4. Automatischer Rand (auto margin) ΓòÉΓòÉΓòÉ

Sie kФnnen (z. B. fБr Definitions-Listen) den linken Rand zwischendurch mit
Hilfe von Leerzeichen verДndern.


*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.

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:


     .AM aus
     .AM an

  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.


ΓòÉΓòÉΓòÉ 5.13. If-Bedingungen ΓòÉΓòÉΓòÉ

Mit Hilfe von If-Bedingungen lassen sich fБr z. B. Дhnliche Programmversionen
leicht unterschiedliche IPF, RTF- bzw. HTML-Dateien aus dem selben Quelltext
erstellen. Der Quelltext der Hypermake Dokumentation etwa ist voller solcher
If-Bedingungen, dafБr gibt es fБr alle Hypermake-Versionen den selben
Quelltext. Das vereinfacht die Pflege der Dokumentation sehr.

FБr die If-Bedingungen gibt es drei Punktbefehle:


 .IF BEDINGUNG
 .ELSE
 .END

IF bedeutet "wenn", ELSE bedeutet "andernfalls". Mit END endet die
If-Bedingung. Die Groс- oder Kleinschreibung der Bedingungen ist dabei egal.
Der ELSE-Befehl ist natБrlich optional.

Es wird also der Text zwischen den IF, ELSE und END Befehlen nur im Zielformat
erscheinen, wenn die Bedingung gesetzt wurde.

Hypermake unterstБtzt zumindest eingeschrДnkt logische VerknБpfungen folgender
Art:


 .IF NOT BED
 .IF BED1 AND BED2
 .IF BED1 OR BED2

AND bedeutet "und zugleich", or bedeutet "oder". Aufwendigere Verschachtelungen
und Klammersetzung wird nicht unterstБtzt.

Die Bedingungen werden in der HMP-Datei unter conditions  eingegeben.

Zum Kompilieren des Quelltextes Бber die Kommandozeile wird z. B. eingegeben:

[C:\myProject] HMAKE MeinDoku.txt #BEDINGUNG

Es kФnnen auch mehrere Bedingungen in die Kommandozeile eingegeben werden.
Entscheidend ist das # Zeichen, nicht die Reihenfolge.

Mehrere Bedingungen in der If-Bedingung (verknБpft mit AND oder OR) werden
nicht unterstБtzt.

AbhДngig von der Wahl des Zielformats werden die Bedingungen HTML IPF WINHELP
WINHELP3 WINHELP4 HTML HTMLHELP von Hypermake automatisch gesetzt. WINHELP ist
dabei der Ъberbegriff von WINHELP3 und WINHELP4. Wenn das Zielformat HTMLHELP
gewДhlt wurde, ist automatisch auch HTML gesetzt.

Die drei verschiedenen Hypermake-Versionen fБr OS/2, Win95/NT und DOS setzen
selbst die Bedingungen OS2, WIN95 und DOS.


ΓòÉΓòÉΓòÉ 6. HTML-spezifische Funktionen ΓòÉΓòÉΓòÉ

Hypermake bietet einige spezielle Funktionen fБr Problemstellungen, die
speziell bei HTML und dem VerФffentlichen im WWW entstehen. Die meisten hier
aufgefБhrten Funktionen werden nicht Бber Befehle im Quelltext, sondern Бber
das Einstellungen-Buch (Seiten HTML-0, HTML-1, HTML-2) bzw. die Ini-Datei sowie
Бber Programmparameter (Einstellungen-Buch Seite Main) aktiviert.

Bei den Zielformaten HTML und HTMLHELP wird eine HTML Info-Datei angelegt, mit
nБtzlichen Informationen zum konkreten Projekt (TextlДnge, Anzahl der Links,
Fehlermeldungen...). Diese Datei heiсt so wie der Projektname und befindet sich
im angemeldeten Verzeichnis, in der Regel also eine Ebene unter dem Ausgabepfad
mit den erzeugten HTML-Dateien. Sie kann auch als bequemer Einstieg in das
Dokument dienen.

Wenn Sie Hypermake-Texte im WWW verФffentlichen wollen, sollten Sie dieses
Kapitel durchlesen, auf alle FДlle aber das Unterkapitel zu HTML-Dateinamen!

Unterkapitel:
Buttons (Navigations-KnФpfe)
HTML-Dateinamen
Titel und Meta-Anweisungen
Statuszeilen-Text
Javascript Baumansicht des Inhaltsverzeichnisses
Dateienvergleich

nДchstes Hauptkapitel:
Kopieren von Grafikdateien


═══ 6.1. Buttons (Navigations-KnФpfe) ═══

Allgemeine Navigation-Buttons

Beachten Sie bitte die Button-Bibliothek von Hypermake im Verzeichnis BUTTONS.

In HTML-Texten ermФglichen Бblicherweise Buttons (Navigations-KnФpfe) am Anfang
und am Ende jeder einzelnen HTML-Seite, den Benutzer von einer zur anderen
Seite zu leiten. Sie kФnnen in der Ini-Datei bzw. den Projekt-Einstellungen
entsprechende Funktionen angeben.

Die Einstellungen bzgl. Navigations-Buttons kФnnen Sie in den
Projekt-Einstellungen auf der Seite HTML-1 vornehmen (Erste Zeile, Letzte
Zeile) oder in der Ini-Datei:


function for first line = BACK FORWARD CONTENT INDEX HOMEF MAX
text for first line =   zurБck vorwДrts Inhalt StichwФrter Home Max

Die sechs Funktionen BACK FORWARD CONTENT INDEX HOMEF MAX haben ihre feste
Bedeutung:

     BACK geht zur Seite, die sich in der logischen Reihenfolge (entsprechend
      dem Quelltext) vor der aktuellen Seite befindet
     FORWARD geht zur in der logischen Reihenfolge nДchsten Seite
     CONTENT springt zum Inhaltsverzeichnis
     INDEX springt zum Stichwortverzeichnis
     HOMEF und MAX wird nur in Verbindung mit dem "Hypermake 4.0-Design
      (Einstellungen-Buch Seite HTML-0) verwendet.


 Analog zu den Funktions-Bezeichnern BACK FORWARD usw. mБssen die Dateinamen
 der Buttons BACK.GIF, FORWARD.GIF usw. lauten.

 Die CONTENT und INDEX KnФpfe erscheinen bei HTML-Help grundsДtzlich nicht, da
 diese FunktionalitДt ohnehin schon vom HTML-Help Betrachter Бbernommen wird.

 Zu HOMEF und MAX: Beim Hypermake 4.0-Design wird normaler Text in Frames
 gezeigt: im linken Fenster erscheint der Inhaltsverzeichnis-Baum, im rechten
 Fenster der normale Text. Ruft der Benutzer eine Textseite direkt auf, so
 fБllt sie den gesamten Bildschirm. (Nur das Aufrufen der Homeframe-Datei
 INDXF.HTML zeigt die Darstellung in Frames.) Mit der HOMEF Funktion gelangt er
 wieder zur geteilten Fensterdarstellung. MAX hat die genau umgekehrte Wirkung:
 der Text springt aus dem Rahmen heraus und nimmt das gesamte Browserfenster
 ein. MAX entspricht somit im Prinzip der "Maximieren" Funktion rechts oben
 eines jeden Fensters der graphischen BenutzeroberflДche. MAX wird
 standardmДсig im vorgefertigen Hypermake 4.0 Design nicht verwendet.

 Zu jeder Funktion gibt es auch einen Text. Wenn im HTML-Browser das
 automatische Laden von Bildern deaktiviert wird, erscheint statt dem
 graphischen Button ein entsprechender Text. Sie kФnnen aber auch in der
 Ini-Datei mit buttons = TEXT ("Art der KnФpfe: Text" in den
 Projekt-Einstellungen Seite "html-1") die graphischen Buttons ganz ausschalten
 und erhalten dann von vornherein nur den Text als Querverweis statt dem
 Navigations-Button.

 Mit der Einstellung buttons = JAVASCRIPT werden mit Hilfe der Javascript
 Programmiersprache KnФpfe erzeugt. Dieses Programm ist Bestandteil der
 HTML-Seite, so daс die KnФpfe schneller geladen werden als separate
 GIF-Dateien. Java-KnФpfe haben aber den Nachteil, daс sehr alte Browser ohne
 Java-UnterstБtztung (vor Netscape 2) diese KnФpfe nicht anzeigen kФnnen und
 abhДngig von der LДnge des Text-Ausdrucks die Breite der KnФpfe
 unterschiedlich ist. Allerdings kФnnen Sie etwas Abhilfe schaffen, indem Sie
 bei Erste Zeile/Letzte Zeile Text GДnsefБсchen und Leerzeichen verwenden:


  zurБck vorwДrts Inhalt " Home " "  Max  " StichwФrter

 Wenn Sie bestimmte KnФpfe nicht haben wollen, lФschen Sie die entsprechenden
 Anweisungen in den Zeilen "Erste Zeile" und "Letzte Zeile", und zwar immer
 Funktion und Text gleichzeitig. Ъberlegen Sie sich Funktionen fБr die erste
 und letzte Zeile getrennt. So kann es sinnvoll sein, bei der "letzten Zeile"
 auf Funktionen wie "zurБck" zu verzichten.

 Benutzerdefinierte Navigations-Buttons

 Es ist nun mФglich, selbst Navigations-Buttons zu definieren, die auf ein
 beliebiges Kapitel verweisen. HierfБr ist sowohl ein Eintrag in der Ini-Datei
 bzw. in den Projekt-Einstellungen als auch ein Punktbefehl im Text
 erforderlich, der das Ziel-Kapitel kennzeichnet.

 In der Ini-Datei:


  function for first line = BACK FORWARD CONTENT INDEX LABEL_A LABEL_B ...
  text for first line =   zurБck vorwДrts Inhalt StichwФrter BezeichA BezeichB ...

 bzw. in den Projekt-Einstellungen auf Seite "html-1", "Erste und letzte
 Zeile".

 und im Quelltext in den gewБnschten Kapiteln:


   .ID LABEL_A
   .ID LABEL_B

 drБckt der Benutzer auf den Button LABEL_A.GIF, gelangt er zum Kapitel, das
 mit .ID LABEL_A markiert wurde. Groс- oder Kleinschreibung spielt keine Rolle.
 Es gibt keine Begrenzung der Anzahl von benutzerdefinierten Buttons.

 Bei Verwendung von .ID Punktbefehlen heiсt die HTML-Datei dann LABEL_A.HTML,
 wДhrend Hypermake sonst Dateinamen mit fortlaufender Nummer vergibt. Wenn Sie
 Navigations-KnФpfe verwenden wollen, aber ausdrБcklich keine festen
 Dateinamen, kФnnen Sie dies Бber einen Kommandozeilenparameter  /NOID
 erreichen:

 Beachten Sie bitte die Button-Bibliothek.

 Buttons als externe Querverweise

 Es ist zulДssig, einem Button eine URL zuzuweisen:


   .URL http://www.netscape.com
   .ID NETSCAPE
   .LOCAL

 Wird in der Ini-Datei NETSCAPE bei "function for..." (Einstellungen-Buch Seite
 "html-1", "Erste Zeile, Funktion") eingetragen, so erhДlt der
 Navigationsbutton NETSCAPE.GIF eine URL als Adresse.

 So kФnnen Sie z. B. eine Programmdokumentation in HTML schreiben und auf jeder
 Seite einen Button "Homepage" oder Ihr Firmenlogo erscheinen lassen, mit einer
 Verbindung zu ihrer persФnlichen Homepage.


ΓòÉΓòÉΓòÉ 6.2. HTML-Dateinamen ΓòÉΓòÉΓòÉ

Normalerweise nummeriert Hypermake die Kapitel einfach durch: N000.HTML,
N001.HTML usw. Hat die Seite einen Rahmen (Frame), so bekommt der Rahmen den
Dateinamen mit der Бblichen Nummer, z. B. N003.HTML. Der eigentliche Text
(linkes bzw. oberes Fenster) bekommt dann die Bezeichnung N003F.HTML, wДhrend
das Unterkapitel (unteres bzw. rechtes Fenster) mit N004.HTML einfach die
nДchste Nummer erhДlt. Wird der Frame fБr die Fuсnotendarstellung verwendet,
heiсt der Rahmen wie gewohnt N003.HTML, die obere Textseite lautet dann
N003T.HTML und die Fuсnotenseite N003N.HTML (N fБr "notes").

Es gibt verschiedene MФglichkeiten, Einfluс auf die automatische Wahl von
Dateinamen zu nehmen.

Unterkapitel:
Vorgabe eines festen Dateinamens
8.3 Dateinamen, lange Dateinamen, Groс- und Kleinschreibung
Interne Numerierung von Ъberschriften und Dateien beeinflussen

nДchstes Hauptkapitel:
Titel und Meta-Anweisungen


ΓòÉΓòÉΓòÉ 6.2.1. Vorgabe eines festen Dateinamens ΓòÉΓòÉΓòÉ


 .2
 Ъber den Autor

 .ID AUTOR
 Ich bin 31 Jahre alt, habe Betriebswirtschaft studiert...

Sie kФnnen eine bestimmte Textstelle mit einer ID (Identity, Identifizierung)
versehen. Auf eine solche Textstelle kФnnen benutzerdefinierte
Navigations-KnФpfe (Buttons) verweisen.

Wenn ein Kapitel mit .ID LABEL_A markiert wurde, wird statt dem
Nummern-Dateiname ein konkreter Dateiname LABEL_A.HTML verwendet. So wird
verhindert, daс Seiten, die von auсen angesprungen werden, bei einem Update auf
einmal ihren Namen Дndern. Das kann auch bei einer umfangreichen Homepage
sinnvoll sein: Mit ID markierte HTML-Seiten kФnnen auch separat aktualisiert
werden, ohne daс fБr jede Textaktualisierung sДmtliche Dateien erneut
hochgeladen werden mБssen.


═══ 6.2.2. 8.3 Dateinamen, lange Dateinamen, Groс- und Kleinschreibung ═══


Dateinamen gehorchen unter verschiedenen Betriebssystemen unterschiedlichen
Gesetzen. DOS kennt nur kurze Dateinamen der 8.3 Schreibweise. Die
PC-Betriebssysteme DOS, OS/2, Windows 95 und Windows NT unterscheiden nicht
zwischen Groс- und Kleinbuchstaben, wohl aber Unix-Systeme. Und Unix-Systeme
sind der Standard bei Internet-Servern. Es kann also vorkommen, daс die Links
(Querverweise) auf Ihrem Rechner einwandfrei funktionieren, im Internet nach
dem Hochladen auf den Server aber nicht mehr!

Um das zu verhindern, bietet Hypermake diverse Mechanismen: Einen Schalter in
der Ini-Datei bzw. in den Projekt-Einstellungen Seite "html-2", einen
Kommandozeilenparameter und eine automatische Erkennung von Laufwerken mit
kurzen DOS-Dateinamen.


//possible settings: sample.html SAMPLE.HTML Sample.html sample.htm SAMPLE.HTM Sample.htm
filename appearance = sample.html

In der Ini-Datei bzw. bei den Projekt-Einstellungen auf Seite "html-2",
"Schreibweise Dateinamen", kФnnen Sie einstellen, wie die Dateinamen aussehen
sollen.

Entscheidend ist das "schwДchste Glied" in der Kette von Kopier- und
Hochlade-VorgДngen. Erzeugen Sie beispielsweise HTML-Dateien unter OS/2,
benutzen aber dann ein DOS bzw. Windows 3.1-Programm zum Hochladen, dann
unterliegen alle Dateinamen der 8.3 BeschrДnkung und DOS wandelt alle
Kleinbuchstaben in Groсbuchstaben um. Die richtige Einstellung ist also
SAMPLE.HTM . Benutzen Sie durchweg Windows95-Programme, sollten Sie Sample.html
wДhlen.

WДhlen Sie hier eine zwangslДufig falsche Einstellung, etwa sample.html auf
einem DOS-Laufwerk, das der 8.3 BeschrДnkung unterliegt, korrigiert Hypermake
die Endung automatisch auf ".HTM" um, wobei die Querverweise ebenfalls richtig
gezogen werden.

Mit dem Programmparameter FAT (File Allocation Table, so heiсt das
DOS-Dateisystem) auf der Seite "Main" der Projekt-Einstellungen erreichen Sie
den selben Effekt wie mit der Einstellung SAMPLE.HTM in der Ini-Datei: Auch
wenn das Dateisystem lange Dateinamen unterstБtzt, hДlt sich Hypermake an die
DOS-Konventionen.

Vor allem beim VerФffentlichen im Web ist es sinnvoll, Hypermake das Kopieren
von Grafikdateien zu Бberlassen, da Hypermake dann die volle Kontrolle Бber die
richtige Groс- und Kleinschreibung der Dateinamen von GIF-Dateien hat.

Hypermake erzeugt zahlreiche Warnungen, wenn bei filename appearance die
Dateiendung auf drei Zeichen eingestellt wurde, es sich aber zum Teil um
Dateinamen handelt, die mehr als 8 Buchstaben haben. Mit dem Schalter filenames
= long in der Ini-Datei kФnnen diese Warnungen unterdrБckt werden
(Projekt-Einstellungen Checkbox "Warnung Dateiname nicht 8.3").


═══ 6.2.3. Interne Numerierung von Ъberschriften und Dateien beeinflussen ═══

(neu in Hypermake 3.65) Wenn Sie ein Hypermake Dokument im WWW ergДnzen, ergibt
sich ein Problem mit der internen Numerierung von Ъberschriften und Dateien,
das mit zwei neuen Punktbefehlen umgangen werden kann.

Hypermake numeriert die Ъberschriften des gesamten Dokumentes einfach durch:
#hd1, #hd2, #hd3. Genauso wird mit den Dateien verfahren: N000.HTML, N001.HTML
usw. Wenn nun in den schon im WWW verФffentlichten Text neue Gliederungspunkte
eingeschoben werden, Дndern sich die folgenden Nummern von Ъberschriften und
ggfs. sogar von Dateien. Das hat zur Folge, daс das gesamte Dokument erneut auf
den Server geladen werden muс. Aber auch Links von auсerhalb des Dokuments auf
Ihr Hypermake-Dokument greifen nun auf einmal auf die falsche Seite, da alle
Dateinamen-Nummern hinter dem Einschub um eins oder mehr verschoben sind.

Um dies zu verhindern, kФnnen Sie sowohl die interne Numerierung von
Ъberschriften als auch die der Dateien an von Ihnen festgelegten Stellen im
Text auf einen festen, hФheren Wert setzen. SpДtere EinschБbe von neuen
Kapiteln unmittelbar davor haben so keine Auswirkung mehr auf die nachfolgende
Numerierung. Allerdings muс dieser Wert hoch genug gesetzt werden, damit alle
kБnftigen Kapitel davor Platz finden. In der HTML Info-Datei kommentiert
Hypermake unter der Ъberschrift "Numerierung" die von Ihnen gewДhlten
Zahlenwerte und warnt Sie, wenn der von Ihnen geschaffene Freiraum "verbraucht"
ist.

Mit dem Punktbefehl .NR kФnnen Sie die Datei-Nummer und mit .HD die
Ъberschrifts-Nummer auf einen hФheren Wert setzen.


 .NR 10
 .HD 100
 .1
 Ъberschrift mit fixer interner Nummer

Wenn mehrere Kapitel sich in einer Datei befinden (Ini-Datei, HTML-Einstellung
new file level bzw. Projekt-Einstellungen Seite "html-1", "Teilung in
Dateien"), muс der Zahlenwert bei .HD grФсer als der Zahlenwert bei .NR sein.
Andernfalls reicht es aus, .NR zu verwenden.


ΓòÉΓòÉΓòÉ 6.3. Titel und Meta-Anweisungen ΓòÉΓòÉΓòÉ

Zu Beginn jeder HTML-Datei wird ein Titel festgelegt, der in der Titelzeile
(titlebar) des Browsers erscheint.

FБr dieses aktuelle Kapitel ist etwa

Hypermake 4.0 - Titel und Meta-Anweisungen

eine sinnvolle Bezeichnung. Welcher Text auf jeder HTML-Seite als Titel
erscheint, kФnnen Sie mit "file title" (Seite HTML-2 des Einstellungen-Buches)
beeinflussen:


//here you can define the text appearing in the browser titlebar
//enter DOCTITLE and/or HEADING and fixed text, e.g. a slash; NO means no text
file title = DOCTITLE - HEADING

Die Zeichen " und ' werden nicht umgesetzt.

DOCTITLE ist der Titel des gesamten Hypermake-Dokuments, den Sie hinter den
Punktbefehl .TI schreiben. HEADING ist der aktuelle Ъberschrifts-Text. Neben
diesen zwei SchlБsselwФrtern kФnnen Sie noch einen beliebigen Text schreiben,
etwa:


file title = Martin Vieregg: DOCTITLE, Kapitel HEADING

Bei den HTML-Seiten Inhaltsverzeichnis und Stichwortverzeichnis werden statt
HEADING die Texte aus "text for first/last line" verwendet. FБr die
Fuсnotendatei bzw. -dateien wird der Text aus dem Ini-Eintrag "notes text"
verwendet.

Informationen fБr Suchmaschinen

Informationen fБr Suchmaschinen (etwa Hotbot oder Yahoo) im WWW sollten in
keiner verФffentlichten HTML-Datei fehlen. Browser zeigen diesen Text nicht an.

Analog zum Titel kann mit "meta content" ein automatischer Meta-Eintrag
vorgenommen werden.


meta content = DOCTITLE - HEADING

An die entsprechende Stelle der HTML-Datei wird dann geschrieben:


<META NAME="description" CONTENT="Hypermake 4.0 - Titel und Meta-Anweisungen">

Auсerdem werden grundsДtzlich alle StichwФrter aufgefБhrt, die im
Hypermake-Quelltext auf dieser Seite markiert sind.


<META NAME="keywords" CONTENT="Stichwort1, Stichwort2">

Einbinden von benutzerdefinierten HEAD-Anweisungen

Es kФnnen entweder fБr einzelne oder fБr alle HTML-Dateien zusДtzliche
Anweisungen im HEAD-Block geschrieben werden. StandardmДсig schreibt Hypermake
in die HTML-Datei nur:


<HEAD>
<META NAME="generator" content="Hypermake 4.00">
<META NAME ="Author" CONTENT="Martin Vieregg">
<title>Hypermake 4.0 - Titel und Meta-Anweisungen</title>
</HEAD>

Vor der <title> Anweisung kФnnen auf Wunsch weitere Informationen erscheinen.
Diese werden in Dateien mit festgelegtem Dateinamen abgelegt. Sollen alle
HTML-Dateien die zusДtzlichen Informationen erhalten, muс die Datei mit den
zusДtzlichen HEAD-tags EVERY.HEAD heiсen. Soll nur eine bestimmte HTML-Datei
diese zusДtzlichen Informationen erhalten, wird sie mit dem bekannten .ID
USERLABEL markiert und dann eine Datei USERLABEL.HEAD  mit dem gewБnschten
Inhalt angelegt.

Entscheidend fБr das Einbinden von benutzerdefinierten HEAD-Anweisungen ist die
Existenz entsprechender *.HEAD-Dateien. Einen eigenen Schalter hierfБr gibt es
nicht.

Wenn ein "Pre filename" (siehe Ini-Datei bzw. Projekt-Einstellungen
Programmparameter PRE auf der Seite "Main") verwendet wird, mБssen die
Dateinamen der HEAD-Dateien mit dem Pre Filename beginnen.

Wird ein DOS-Laufwerk verwendet oder die "filename appearance" ist auf die
Erweiterung mit nur 3 Buchstaben gestellt, so muс die Endung der Dateinamen
nicht  .HEAD , sondern .HEA lauten.


ΓòÉΓòÉΓòÉ 6.4. Statuszeilen-Text ΓòÉΓòÉΓòÉ


(Einstellungen-Buch Seite HTML-2)


statusbar mouseover = zum Kapitel: HEADING (Datei FILENAME)
statusbar default = DOCTITLE - Besuchen Sie bitte regelmДсig die Homepage!

Der Statuszeilen-Text ist der Text, der im Textfenster am unteren Rand des
HTML-Browsers erscheint. Befindet sich der Mauszeiger Бber einem internen Link,
so kann mit dem Schalter statusbar mouseover bestimmt werden, welcher Text
erscheinen soll. Statt HEADING wird die Ъberschrift des Kapitels geschrieben,
das das Querverweis-Ziel ist. FILENAME ist der Dateiname des
Querverweis-Zieles. Unter statusbar default wird der Text definiert, der
erscheinen soll, wenn der Mauszeiger gerade nicht Бber einem Link steht.

Beachten Sie bitte, daс die Verwendung von statusbar mouseover bei vielen
internen Querverweisen die LДnge der HTML-Dateien spБrbar vergrФсern kann, da
nДmlich bei jedem Link nicht nur der "mouseover" Text, sondern zusДtzlich auch
der "default" Text enthalten sein muс, der dann aktiviert wird, wenn der
Mauszeiger den Link verlДсt. Beim VerФffentlichen im WWW muс deshalb der
Vorteil der besseren Information mit dem Nachteil der lДngeren Downloadzeit
abgewogen werden.

Die statusbar default Einstellung ist nicht so problematisch, da sie pro
HTML-Datei nur einmal vorkommt, solange statusbar mouseover mit NO deaktiviert
ist. Bei diesem Schalter ist die Verwendung von FILENAME recht nБtzlich, wenn
Sie viele Frames verwenden. So kann sich der Leser darБber informieren, welche
Dateien in den Kindfenstern angezeigt werden. Im URL-Eingabefeld des Browsers
wird nДmlich immer nur die Frames-Datei angezeigt, die gar keinen Text, sondern
nur die Verzweigungsinformationen zu den Kindfenstern enthДlt.

Die Zeichen " und ' werden nicht umgesetzt.


ΓòÉΓòÉΓòÉ 6.5. Javascript Baumansicht des Inhaltsverzeichnisses ΓòÉΓòÉΓòÉ

Seit Hypermake 3.6 kФnnen Sie mit dem Schalter contents tree in der Ini-Datei
(Projekt-Einstellungen Seite "html-1", "Javascript-Inhaltsverzeichnis") wДhlen,
ob die standardmДсige Darstellung des Inhaltsverzeichnisses als auf- und
zuklappbare Baumstruktur oder als immer aufgeklappte unsortierte Liste
erscheinen soll. Gleichzeitig legen Sie hierbei den Wortlaut von
ErklДrungstexten fest, die bei der auf- und zuklappbaren Baumstruktur
erscheinen soll. Hinter dem Auf- und Zuklapp-Mechanismus steckt ein
Javascript-Programm. Wird die auf- und zuklappbare Baumstruktur gewДhlt, so
wird trotzdem ein Inhaltsverzeichnis in konventioneller Form angelegt. Auf
nicht Javascript-fДhigen Browsern erscheint das Inhaltsverzeichnis nicht und
der Benutzer kann sich mit einem Link zur normalen Darstellung hinБberretten.

Was ist Javascript?

Javascript ist eine einfache Programmiersprache, deren Quelltext direkt in
HTML-Texte eingebunden werden kann und die von den meisten Browsern beherrscht
wird. Es gibt derzeit die Versionen 1.0, 1.1 und 1.2. Netscape Navigator 2 kann
Javascript 1.0 verarbeiten, Version 3 1.1 und Version 4 1.2. Die
Microsoft-Browser Internet Explorer 3 verarbeiten Javascript 1.1 und 4
ebenfalls wie Netscape 4 1.2.

Welche Browser unterstБtzen die Hypermake Javascript Baumansicht?

Der von Hypermake generierte Javascript Code ist (mit viel MБhe) so
geschrieben, daс er von allen Javascript unterstБtzenden Browsern korrekt
ausgefБhrt wird. Konkret ausgetestet ist Netscape Navigator 2.02, 3 und 4 sowie
Microsoft Internet Explorer 3 und 4.

Verwendete Grafik-Dateien

In der Button-Bibliothek im Verzeichnis BUTTONS\ICON befinden sich drei Dateien
namens TREECLOS.GIF, TREEOPEN.GIF und TREENO.GIF. DrБckt der Benutzer auf die
ersten beiden Grafiken, so wird der Baum in einer weiteren Ebene geФffnet bzw.
geschlossen. Die Datei TREENO.GIF hat keine derartige Funktion und zeigt nur
an, daс das entsprechende Kapitel Бber keine weiteren Unterkapitel verfБgt.

Die Namen dieser Dateien stehen fest. Wollen Sie andere Grafiken verwenden,
nennen Sie sie einfach entsprechend der genannten Dateinamen. Beachten Sie bei
der Namensgebung folgendes: TREECLOS.GIF stellt ein geschlossenes Buch oder
Дhnliches dar, die damit verknБpfte Aktion ist aber das Щffnen des Baumes;
TREEOPEN.GIF ist das Symbol fБr "geФffnet", ist aber mit der Aktion "Schlieсen"
verknБpft.

Seit Hypermake 4.0 gibt es noch eine weitere Datei TREEMPTY.GIF. Diese fungiert
als Platzhalter, ist genauso breit wie die anderen TREE*.GIF Grafiken und
vФllig durchsichtig, also unsichtbar.

Besonderheit ab Netscape / Internet Explorer 4

Mit Javascript 1.2 wurden neue Funktionen eingefБhrt, die es erlauben, im
Javascript-Programm die Position der Scrollbar (Schiebeleiste) zu verДndern.
Das von Hypermake erzeugte Javascript-Programm nutzt diese FunktionalitДt, um
die alte Position des vertikalen Scrollbars nach einem Auf- oder Zuklappen
wieder zu restaurieren. Browser vor Netscape 4 / Mircosoft IE 4 verlieren
leider die aktuelle Position des Scrollbars, was fБr den Benutzer bei langen
Inhaltsverzeichnissen recht lДstig ist.

Dateinamen

Wie schon beim normalen Inhaltsverzeichnis heiсt die Datei INDEX.HTML. Diese
Datei stellt den Rahmen fБr die zwei Kindfenster dar und enthДlt das
Javascript-Programm. Das obere kleine Fenster besteht aus der Datei INDXI.HTML
(I fБr Info-Fenster), wДhrend das normale (Ersatz-) Inhaltsverzeichnis
INDEXA.HTML heiсt (A fБr alt). Bevor das Javascript-Programm startet und den
Baum erzeugt, wird in das groсe untere Fenster die Datei EMPTY.HTML geladen.
Deshalb muс zum VerФffentlichen im Web die Datei EMPTY.HTML vorhanden sein!

Zwei Browser-Fenster

Es kann bei grФсeren Dokumenten hilfreich sein, wenn der Benutzer zwei Browser
Фffnen kann - einen fБr das Inhaltsverzeichnis und einen fБr den Text. Das lДсt
sich realisieren, indem fБr die Einstellung der Ini-Datei  default frame und
fБr content frame (Projekt-Einstellungen Seite "html-2", "Bezeichner fБr...")
unterschiedliche Bezeichner gewДhlt werden, etwa "haupt" und "inh".


ΓòÉΓòÉΓòÉ 6.6. Dateienvergleich ΓòÉΓòÉΓòÉ

FБr eine umfangreiche Publikation im Internet mБssen Sie 100 und mehr
HTML-Dateien ins Internet spielen. Bei einer Aktualisierung des Textes mБssen
dagegen nur eine Handvoll Dateien geДndert werden. Um herauszufinden, welche
Dateien sich seit dem letzten Upload tatsДchlich geДndert haben, bietet Ihnen
Hypermake (seit Version 3.99) den Dateienvergleich an. Dabei gehen Sie wie
folgt vor:

   1. Kopieren Sie das gesamte Verzeichnis, in das Hypermake die HTML-Dateien
      geschrieben hat (im folgenden "HTML-Verzeichnis"), und suchen Sie sich
      fБr die Kopie einen zweckmДсigen Namen aus, beispielsweise
      Projektname_Datum. Dies sollten Sie entweder nach dem Upload tun oder
      bevor Sie neue Оnderungen an dem Projekt vornehmen.
   2. Falls Sie Streichungen an Ihrem Projekt vornehmen, lФschen Sie das
      aktuelle HTML-Verzeichnis.
   3. Nachdem Sie die Оnderungen am Projekt vorgenommen und das Projekt neu
      erzeugt haben, fБhren Sie den Dateienvergleich durch. Dieser gibt Ihnen
      eine Liste der geДnderten Dateien aus.


 Den Dateienvergleich kФnnen Sie auf dreierlei Weise starten:

 In der graphischen Version muс das entsprechende Projekt angemeldet sein. Mit
 Projekt - HTML-Verz. vergleichen kФnnen Sie nun den Verzeichnisnamen des
 alten, kopierten HTML-Verzeichnnisses angeben oder Sie werfen einfach das
 Verzeichnis-Symbol in das Fortschrittsfenster mit der blauen Schrift. Sodann
 erhalten Sie im blauen Textfenster eine Liste der geДnderten Dateien, die sie
 ggfs. mit der Maus markieren und weiterverarbeiten kФnnen.

 Bei der Kommandozeilenversion schreiben Sie

 [C:\myProject] HMAKE /COMPARE Altesdir Neuesdir

 Der Dateienvergleich beschrДnkt sich nicht nur auf HTML-Dateien, sondern
 bezieht sich auf alle Dateien im HTML-Verzeichnis, also auch auf Grafiken. Im
 Unterschied zu Бblichen Dateivergleich-Tools, etwa "COMP" in der
 Kommandozeile, berБcksichtigt der Dateienvergleich von Hypermake die
 Eigenheit, daс Hypermake seine Versionsnummer an den Anfang einer jeden
 HTML-Datei schreibt:


  <META NAME="generator" content="Hypermake 4.00">

 Wenn sich in einer HTML-Datei nur die Versionsnummer geДndert hat, gelten die
 Dateien beim Dateienvergleich immer noch als unverДndert.


ΓòÉΓòÉΓòÉ 7. Kopieren von Grafikdateien ΓòÉΓòÉΓòÉ

Fast jeder Hypertext hat Grafik-Dateien; HTML-Texte benФtigen meist
Grafik-Dateien fБr graphische Buttons. Diese liegen hДufig auf der Festplatte
verstreut, mБssen sich aber im Zielverzeichnis befinden, bevor der HTML-Text
mit dem Browser betrachtet werden oder ein zweiter Compiler die Arbeit
aufnehmen kann.

Entweder in der HMP-Datei (Projekt-Einstellungen Seite "main") oder Ini-Datei
kФnnen Sie den folgenden Schalter setzen:


graphic path = D:\HMAKE\Testgrafiken;D:\HMAKE\Worldgrafiken;D:\HMAKE\Buttons;

Hier kФnnen Sie einstellen, in welchen Verzeichnissen sich die Grafikdateien
befinden. Findet Hypermake im Zielverzeichnis nicht eine benФtigte Grafik, so
wird die "graphic path" Liste durchgegangen. Wird die Grafik gefunden, so wird
sie gleich kopiert, wobei die Kopie den richtigen Namen bezБglich Groс- und
Kleinschreibung erhДlt (siehe Schalter filename appearance ). Anderenfalls wird
eine Warnung ausgegeben, daс die Grafik nicht gefunden werden konnte.

Diese Funktion erspart Ihnen lДstige Fehlermeldungen von fehlenden
Grafikdateien im OS/2- bzw. Windows-Hilfecompiler und stellt bei HTML sicher,
daс auch wirklich alle benФtigen Grafiken vorhanden sind.

HTML-Grafiken werden so eingebunden, daс wenn im Browser "auto load images" auf
off gestellt ist, statt der Grafik der Dateiname der Grafik mit Angabe zur
DateilДnge erscheint - allerdings nur beim Punktbefehl .BM, nicht bei .BT oder
bei Navigationsbuttons, denn in der Regel ist die GrФсe der mit .BT
eingebundenen Grafiken bzw. der Navigationsbuttons ohnehin nicht der Rede wert.

Seit Hypermake 3.99 wird eine Grafikdatei auch dann kopiert, wenn sie sich
schon im Zielverzeichnis befindet und die Grafikdatei aus dem Quellverzeichnis
neueren Datums ist. Es reicht also, die Grafik im unter "graphic path"
eingetragenen Verzeichnis zu aktualisieren.

Beachten Sie bitte, daс die Winhelp- und OS/2-Hilfe-Compiler zwar beide
BMP-Dateien als Grafik verarbeiten, die beiden BMP-Formate aber unterschiedlich
sind. Deshalb gibt es auch im Verzeichnis BUTTONS ein WINBMP und ein OS2BMP
Verzeichnis, die zwar die gleichen Grafiken, nicht aber die gleichen Dateien
enthalten. Wenn Sie nun beide Hilfeformate erzeugen wollen, mБssen Sie, bevor
Sie das andere Format compilieren, erst einmal die "falschen" BMP-Dateien aus
dem Zielverzeichnis lФschen, damit Hypermake wieder erneut die richtigen
BMP-Dateien kopiert.


ΓòÉΓòÉΓòÉ 8. Kontext-sensitive Programmhilfe ΓòÉΓòÉΓòÉ

Programme fБr die graphische OberflДche haben meist eine eingebaute sog.
kontext-sensitive Hilfe. DrБckt der Benutzer auf F1 oder auf eine "Hilfe"
Taste, so gelangt er automatisch auf die Seite des Hilfetextes, die der
Programmierer vorgesehen hat. Hypermake stellt hier Funktionen zur VerfБgung,
diese Arbeit zu automatisieren.

Wenn Sie nur eigenstДndige Hypertexte erstellen wollen und keine Programme
schreiben, benФtigen Sie diese FunktionalitДt nicht.

Unterkapitel:
Programmhilfe bei OS/2
Programmhilfe bei Windows
Mehrere verschiedensprachige Hypertexte

nДchstes Hauptkapitel:
Verzeichnis aller Punktbefehle


ΓòÉΓòÉΓòÉ 8.1. Programmhilfe bei OS/2 ΓòÉΓòÉΓòÉ

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 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).

 Unterkapitel:
 Erstellen des Hypermake Quelltextes
 Einbindung in den C Programm-Quelltext
 Einbindung in den Pascal Programm-Quelltext
 Einbindung der Hilfefunktion auf konventionelle Weise

 nДchstes Hauptkapitel:
 Programmhilfe bei Windows


ΓòÉΓòÉΓòÉ 8.1.1. Erstellen des Hypermake Quelltextes ΓòÉΓòÉΓòÉ

Im Hypermake Quelltext werden zwei neue Punktbefehle verwendet: Ressource
Connection


 .RC ID_window, ID_button_or_Menu_Item

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.

 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.

Und mit Panel ID


 .ID Kapitel_Name

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 , 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:


 .RC , ID_button_or_Menu_Item

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.

Der folgende Hypermake Quelltext enthДlt die zwei neuen Punktbefehle Ressource
connection und Panel ID:

.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.


ΓòÉΓòÉΓòÉ 8.1.2. Einbindung in den C Programm-Quelltext ΓòÉΓòÉΓòÉ


Hypermake erstellt automatisch eine Datei HLPTABLE.RC:


#define SUBTABLE_ID_Kindfenster 7001

HELPTABLE HELP_TABLE {
 HELPITEM ID_Kindfenster, SUBTABLE_ID_Kindfenster, 1 // EinfБhrung
}

HELPSUBTABLE SUBTABLE_ID_Kindfenster {
 HELPSUBITEM ID_OK, 2 // Verwendung des OK-Knopfes
 HELPSUBITEM ID_Cancel, 3 // Verwendung des Cancel-Knopfes
}

Hypermake erstellt auсerdem eine Datei PANELID.H:


/*****Panel ID's created by Hypermake*****/

#define PANEL_Einfuehrung  1
#define PANEL_OK_Benutzung  2

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
(Projekt-Einstellungen Seite "Helpfile") , 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:


#include "HLPTABLE.RC"

etwa nach einem MENU oder DLGTEMPLATE-Block in der RC-Datei und


#include "PANELID.H"

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:


 void InitHelp (hwnd) /*initialisiert den Help-Prozeс*/
 void DestroyHelp () /*deaktiviert ihn*/

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


 void DisplayHelpPanel (PanelID)

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:


#define INCL_HELP

Unterkapitel:
C Quelltext fБr die drei Hilfe-functions

nДchstes Hauptkapitel:
Einbindung in den Pascal Programm-Quelltext


═══ 8.1.2.1. C Quelltext fБr die drei Hilfe-functions ═══


 C Quelltext fБr die drei Hilfe-functions



#define HelpFilename "FILENAME.HLP"
#define HelpWindowTitle "Ъberschrift des Hypertext-Fensters"

BOOL fHelpEnabled;
static HWND hwndHelpInstance;

#define InfoBox(st) WinMessageBox (HWND_DESKTOP, HWND_DESKTOP, st, "", 0, MB_OK | MB_ERROR)

/*wird vor die Hauptprogramm-Message-Schleife (while WinGetMsg...) gesetzt*/
VOID InitHelp (HWND hwndClientFrame) {
  HELPINIT hini;
  /* If we return because of an error, Help will be disabled */
  fHelpEnabled = FALSE;
  /* Initialize help init structure */
  hini.cb = sizeof(HELPINIT);
  hini.ulReturnCode = 0;
  /* If tutorial added, add name here */
  hini.pszTutorialName = (PSZ)NULL;
  hini.phtHelpTable = (PHELPTABLE)MAKELONG(HELP_TABLE, 0xFFFF);
  hini.hmodHelpTableModule = 0; hini.hmodAccelActionBarModule = 0;
  hini.idAccelTable = 0; hini.idActionBar = 0;
  hini.pszHelpWindowTitle = HelpWindowTitle;
  hini.fShowPanelId = CMIC_HIDE_PANEL_ID;
  hini.pszHelpLibraryName = HelpFilename;
  /* Creating help instance */
  hwndHelpInstance = WinCreateHelpInstance(hab, &hini);
  if(hwndHelpInstance == 0L || hini.ulReturnCode) {
   InfoBox("Failed to load help manager."); return;
  }
  /* Associate help instance with main frame */
  if(!WinAssociateHelpInstance(hwndHelpInstance, hwndClientFrame)) {
   InfoBox("Failed to load help manager."); return;
  }
  /* Help manager is successfully initialized so set flag to TRUE */
  fHelpEnabled = TRUE;
  return;
}

/*wird hinter die Hauptprogramm-Message-Schleife gesetzt*/
VOID DestroyHelp () {
  if(hwndHelpInstance != 0L) WinDestroyHelpInstance(hwndHelpInstance);
  return;
}

/*
 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)
*/
VOID SendHelpMessage (LONG HelpMessage) {
  if(fHelpEnabled)
   if((LONG)WinSendMsg(hwndHelpInstance, HelpMessage, (MPARAM) 0, (MPARAM) 0))
  InfoBox ("Failed to display help panel.");
}

/*
 Parameter sind die Panel ID's, definiert Бber die ID Punktbefehle
 im Hypermake Quelltext
*/
VOID DisplayHelpPanel (LONG PanelID) {
  if(fHelpEnabled)
   if((LONG)WinSendMsg(hwndHelpInstance, HM_DISPLAY_HELP,
     MPFROMLONG(MAKELONG(PanelID, NULL)),
     MPFROMSHORT(HM_RESOURCEID))) InfoBox ("Failed to display help panel.");
}


ΓòÉΓòÉΓòÉ 8.1.3. Einbindung in den Pascal Programm-Quelltext ΓòÉΓòÉΓòÉ


In der Ini-Datei (Projekt-Einstellungen Seite "General") kФnnen Sie unter
languages wДhlen, ob Hypermake C- oder Pascal-Quelltext erzeugen soll.

Hypermake erstellt automatisch eine Datei HLPTABLE.RC:


CONST
 SUBTABLE_ID_Kindfenster = 7001

HELPTABLE 1000
BEGIN
 HELPITEM ID_Kindfenster, SUBTABLE_ID_Kindfenster, 1 /* EinfБhrung */
END

HELPSUBTABLE SUBTABLE_ID_Kindfenster
BEGIN
 HELPSUBITEM ID_OK, 2 /* Verwendung des OK-Knopfes */
 HELPSUBITEM ID_Cancel, 3 /* Verwendung des Cancel-Knopfes */
END

Hypermake erstellt auсerdem eine Datei PANELID.H:


{   Panel ID's created by Hypermake   }

const
 PANEL_Einfuehrung = 1;
 PANEL_OK_Benutzung = 2;

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 (Projekt-Einstellungen Seite "Helpfile") unter der
Einstellung Help Subtable Start ID Дndern, auсerdem kФnnen Sie auch die
Dateinamen der zwei erstellten Dateien Дndern.
Д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:


{$I HLPTABLE.RC}

etwa nach einem MENU oder DLGTEMPLATE-Block in der RC-Datei und


{$I PANELID.INC}

zu Beginn des Programmtextes (eine PAS-Datei).

Es gibt nun erst einmal zwei Funktionen, mit denen Sie die HLP-Datei aufrufen
kФnnen.


DisplayHelpPanel (PanelID)

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.


SendHelpMessage (HM_HELP_CONTENTS)

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.

Unterkapitel:
Einbindung der Hilfefunktion bei Benutzung der OPML

nДchstes Hauptkapitel:
Einbindung der Hilfefunktion auf konventionelle Weise


ΓòÉΓòÉΓòÉ 8.1.3.1. Einbindung der Hilfefunktion bei Benutzung der OPML ΓòÉΓòÉΓòÉ


 Einbindung der Hilfefunktion bei Benutzung der OPML

In der Methode


TApplication.InitMainWindow

mБssen Sie lediglich am Ende eine Zeile einfБgen:


MainWindow^.InitWindowHelp ('MYPROG.HLP', 'HilfeБberschrift');

Das war's auch schon.


ΓòÉΓòÉΓòÉ 8.1.4. Einbindung der Hilfefunktion auf konventionelle Weise ΓòÉΓòÉΓòÉ


Zum Aktivieren und Deaktivieren der Hilfe-Funktion benФtigen Sie zwei
Funktionen:


 uses PMHELP;

 InitHelp (hwnd); {initialisiert den Help-Prozeс}
 DestroyHelp; {deaktiviert ihn}

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:


 HelpFilename := 'MYPROG.HLP';
 HelpWindowTitle := 'Ъberschrift des Hypertext-Fensters';
 HELP_TABLE := 1000;

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.

Unterkapitel:
Pascal Hilfe-Quelltext

nДchstes Hauptkapitel:
Programmhilfe bei Windows


ΓòÉΓòÉΓòÉ 8.1.4.1. Pascal Hilfe-Quelltext ΓòÉΓòÉΓòÉ


 Pascal Hilfe-Quelltext


{Help manager helpers}

FUNCTION InfoBox(st:STRING):LONGINT;
BEGIN
 result:=WinMessageBox (HWND_DESKTOP, HWND_DESKTOP, st,'', 0, MB_OK | MB_ERROR);
END;

{wird vor die Hauptprogramm-Message-Schleife gesetzt}
PROCEDURE InitHelp (hwndClientFrame:HWND);
VAR
  hini:HELPINIT;
  { If we return because of an error, Help will be disabled }
BEGIN
   fHelpEnabled := FALSE;
   { Initialize help init structure }
   hini.cb := sizeof(HELPINIT);
   hini.ulReturnCode := 0;
   { If tutorial added, add name here }
   hini.pszTutorialName := NIL;
   hini.phtHelpTable := PHELPTABLE(MAKELONG(HELP_TABLE, $FFFF));
   hini.hmodHelpTableModule := 0;
   hini.hmodAccelActionBarModule := 0;
   hini.idAccelTable := 0;
   hini.idActionBar := 0;
   hini.pszHelpWindowTitle := @HelpWindowTitle;
   hini.fShowPanelId := CMIC_HIDE_PANEL_ID;
   hini.pszHelpLibraryName := @HelpFilename;
   { Creating help instance }
   hwndHelpInstance := WinCreateHelpInstance(AppHandle,hini);
   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;


ΓòÉΓòÉΓòÉ 8.2. Programmhilfe bei Windows ΓòÉΓòÉΓòÉ


Um kontext-sensitive Programmhilfe zu erstellen, muс eine Verbindung zwischen
dem EXE-Programm und dem Hypertext hergestellt werden. Das geschieht
folgendermaсen:

Vergabe von ID's im Hypermake-Quelltext

Im Hypermake-Quelltext kФnnen Sie einzelnen Kapiteln ID's Бbergeben. Das sind
Bezeichner von Konstanten.


 .1
 Mein Kapitel

 .ID ID_MEIN_KAPITEL
 Dies ist mein Kapitel.

Hypermake erzeugt dann eine Datei PANELID.H, oder ggfs. mit einem Namen, der in
der Ini-Datei (Projekt-Einstellungen Seite "Helpfile") unter Panel ID filename
festgelegt ist, die den Konstanten Zahlenwerte zuordnet.

In der Ini-Datei (Projekt-Einstellungen Seite "General") kФnnen Sie unter
languages wДhlen, ob Hypermake C- oder Pascal-Quelltext erzeugen soll.

Einbindung in C-Programme

Die erzeugte Panel ID-Datei sieht etwa so aus:


/*****Help Panel ID's created by Hypermake*****/

#define ID_MEIN_KAPITEL 27

Diese Datei wird in den Programm-Quelltext eingebunden:

 #include "panelid.h"

Einbindung in Pascal-Programme

Die Panel ID Datei sieht entsprechend der Pascal-Syntax etwas anders aus:


{   Panel ID's created by Hypermake   }

const
 ID_MEIN_KAPITEL = 27;

Die Panel ID Datei wird einfach in den Programm-Quelltext eingebunden:

 {$I PANELID.PAS}

Zugriff vom Programm-Quelltext auf die Hilfedatei

Ъber den Funktionsaufruf

 WinHelp (hwnd, "MEINPROG.HLP", HELP_CONTEXT, ID_MEIN_KAPITEL);

wird von der EXE-Datei auf den Hypertext zugegriffen.

Windows kennt noch die folgenden Aufrufe:

 WinHelp (hwnd, "MEINPROG.HLP", HELP_FINDER, 0);
ruft das Fenster mit den Seiten Inhalt, Index, Suchen auf (direkt kann man auf
diese Seiten nicht zugreifen)

 WinHelp (hwnd, "MEINPROG.HLP", HELP_HELPONHELP, 0);
ruft die Funktion "Hilfe fБr Hilfe" auf.

Hilfefunktion bei kontext-sensitivem HTML-Help

Im Prinzip wird genauso vorgegangen wie bei Winhelp. Hypermake ordnet den
Konstanten allerdings keine Zahlenwerte zu, sondern Strings, die einen mit URLs
vergleichbaren Inhalt haben. Diese Konstanten werden dann der neuen HTML-Help
Hilfefunktion Бbergeben.

Um HTML-Help in einem Windows-Programm zu verwenden, werden die Libraries
HHCTRL.LIB oder HTMLHELP.LIB eingebunden. Die neue Help-Funktion ist sehr
Дhnlich zum WinHelp-Aufruf:

 HtmlHelp (hwnd, "MEINPROG.CHM:://N000.HTML", HH_DISPLAY_TOPIC, 0);

Weil der Ъbergabeparameter ein HTML Dateinamen-String ist, ist eine Panel ID
Datei, die Integer-Werte den Kapiteln zuordnet, gar nicht erforderlich. Wenn
Sie ein Programm schreiben und beide Hilfeformate anbieten wollen, so sollten
Sie eine Funktion schreiben, die sowohl eine Panel ID Konstante als auch den
entsprechenden String Бbergibt.


ΓòÉΓòÉΓòÉ 8.3. Mehrere verschiedensprachige Hypertexte ΓòÉΓòÉΓòÉ


Falls Sie mehrere verschiedensprachige Hilfedateien und nur eine EXE-Datei
erstellen, reicht es aus, wenn Sie die ID- (und bei OS/2 auch die 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.


ΓòÉΓòÉΓòÉ 9. Verzeichnis aller Punktbefehle ΓòÉΓòÉΓòÉ


Unterkapitel:
Zu dieser Ъbersicht
Grundlagen
Textanfang
Kapitel
Schriften
Listen
Einbindung von Grafiken
Querverweise (Links) und Index
Duplizierung von KapitelБberschriften
Tabellen (Tables)
Linienziehen
Fuсnoten
RДnder und Formatierung
If-Bedingungen
HTML-spezifische Befehle

nДchstes Hauptkapitel:
Projekt-Einstellungen (Ini-Datei)


═══ 9.1. Zu dieser Ъbersicht ═══


Hier finden Sie eine kurze Beschreibung aller Hypermake Punktbefehle. Die
gleiche Kapitelstruktur finden Sie in Erstellen eines Hypermake Quelltextes .

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.


ΓòÉΓòÉΓòÉ 9.2. Grundlagen ΓòÉΓòÉΓòÉ

 ..Kommentar

"Kommentar" wird nicht interpretiert.


 .:ipf-Kommando.
 .:ipf-Kommando. Ausdruck

Ein IPF-Kommando kann auch direkt eingegeben werden.


 .HC an  (on)
 .HC aus  (off)

lДсt die Verwendung von <HTML-Tags> mit spitzen Klammern im Hypermake-Quelltext
zu. Standard ist aus.


 .HTML
 <HTML-Kommandos> Flieсtext usw.
 .HYPERMAKE

erlaubt die abschnittsweise direkte Eingabe von HTML Text.


 .HF Dateiname

kopiert an die Stelle des Punktbefehls der Dateiinhalt der Datei "Dateiname"
bei HTML.


ΓòÉΓòÉΓòÉ 9.3. Textanfang ΓòÉΓòÉΓòÉ


 .TI
 Hypertext-Titel

setzt den Titel des Hypertexts.

 .<>

stellt bei Winhelp und OS/2 HLP-Dateien die Hypertext-BenutzerknФpfe "ZurБck"
und "VorwДrts" und bei OS/2 noch "Inhalt" zur VerfБgung.


ΓòÉΓòÉΓòÉ 9.4. Kapitel ΓòÉΓòÉΓòÉ


 .1 bis .6 definiert eine Gliederungsebene

 .1
 HauptБberschrift

Die KapitelБberschrift des ersten Punktes der ersten Gliederungsebene heiсt
"HauptБberschrift".

(Heading size) Оnderung der GrФсe des Ъberschrifts-Textes bei HTML. Z. B. 4.
Ebene erhДlt die SchriftgrФсe der 2. Ebene.

 .HS 123234

Erscheinungsbild der Querverweise zu Unterkapitel


 .sc beliebiger trenntext
 .sc RETURN      (Standard)
 .sc PARAGRAPH
 .sc LIST

Fensteranordnung (Frames)

 .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.

Kapitel-ID

 .ID NAME

Das Kapitel, in dem der ID Punktbefehl steht, erhДlt die ID "NAME".

Der HTML Dateiname lautet dann statt einer fortlaufenden Nummer "NAME.HTML". In
der Ini-Datei kann unter "function for link for" ("Erste Zeile, Funktion" in
den Projekt-Einstellungen Seite "html1") das SchlБsselwort "NAME" eingetragen
werden. Es erhДlt dann einen Navigations-Knopf "NAME.GIF" am Anfang bzw. Ende
der HTML-Seite einen Querverweis zum mit .ID NAME markierten Kapitel. Sie
finden eine Button-Bibliothek im Verzeichnis BUTTONS.

Bei IPF wird auch verwendet, um kontext-sensitive Programmhilfe zu erzeugen.


ΓòÉΓòÉΓòÉ 9.5. 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 bzw. in den Projekt-Einstellungen unter Fonts festgelegt.

Schrift Alternativ gilt zwischen zwei Alternativ Umschaltzeichen, diese werden
ebenfalls in der Ini-Datei festgelegt (Projekt-Einstellungen Seite "spec.
chars").


ΓòÉΓòÉΓòÉ 9.6. Listen ΓòÉΓòÉΓòÉ


 .SL  ( .OL )

macht aus den nДchsten Auflistungen eine sortierte Liste

 .UL

stellt wieder auf unsortierte Listen (Standardeinstellung).


ΓòÉΓòÉΓòÉ 9.7. Einbindung von Grafiken ΓòÉΓòÉΓòÉ


 .BM Dateiname

gibt eine Grafik dateiname.bmp (IPF, Winhelp) bzw. dateiname.gif (HTML)
zentriert aus.

 .BTX Dateiname

schreibt im Flieсtext statt dem Buchstaben X die Grafik dateiname.bmp.

 .BD Verzeichnis/

bitmap directory stellt einen Verzeichnisnamen den Dateinamen bei allen
folgenden .BM und .BT Befehlen voran.


ΓòÉΓòÉΓòÉ 9.8. Querverweise (Links) und Index ΓòÉΓòÉΓòÉ


 .IZX  ( .ICX , .STX )

wДhlt das beliebige Zeichen X als Indexzeichen.

 .IN Ausdruck  ( .SW )

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  ( .SV , .IT )

Index Vertauscht: wie .IN, verwendet aber das letzte Wort des Ausdrucks als
fБhrendes Wort.

 .IU ignore uppercase

am Textanfang Groсschreibung ignorieren beim Ziehen von Querverweisen

Externe Querverweise (IPF)

 .EX extern.hlp
 .ID Kapitel_Einleitung
 .IN Ausdruck
 .EX

Alle Vorkommnisse von "Ausdruck" erhalten einen externen Querverweis zu dem
Kapitel in der Datei extern.hlp, das mit
 .ID Kapitel_Einleitung
markiert wurde.

Externe Querverweise (HTML)

 .URL internetadresse
 .IN Ausdruck
 .LOCAL

Alle Vorkommnisse von "Ausdruck" erhalten einen externen Querverweis zu der URL
"internetadresse". (Alle Formate auсer Winhelp3)

Programme starten (IPF, Winhelp)

 .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.


═══ 9.9. 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.

Bei Winhelp ist die Duplizierung von KapitelБberschriften immer aktiviert;
Schriften werden statt Бber den Punktbefehl Бber die Ini-Datei definiert
("Ъberschrifts-Schriften in den Projekt-Einstellungen Seite "Winhelp").


ΓòÉΓòÉΓòÉ 9.10. Tabellen (Tables) ΓòÉΓòÉΓòÉ


 .TA TabellenБberschrift
 Zelle eins   Zelle zwei   Zelle drei
 zweite Zeile  zweite Zeile  eine+
 dritte Zeile  "       groсe Zelle
 .TA

wird zu:

ΓöîΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÉ
ΓöéZelle eins   ΓöéZelle zwei   ΓöéZelle dreiΓöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
│zweite Zeile │zweite Zeile │eine groсe│
Γöé             Γöé             ΓöéZelle     Γöé
Γö£ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöñ
Γöédritte Zeile Γöé             Γöé          Γöé
ΓööΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÇΓöÿ

In Tabellen kФnnen Zell-Zeilen mit " und mit + zusammengefБgt werden (nur
HTML).

 .tc X

(table character) Дndert das ZusammenfБge-Zeichen + in einen beliebiegen
Buchstaben.

 .TT

(Table Tags) Standard ist
 .TT BORDER CELLPADDING=5

Grauer Hintergrund ohne Bild:
 .TT BORDER CELLPADDING=5 BGCOLOR="#D0D0D0"

 .TW
Table word wrap (nur HTML) Tabelle fБllt Fensterbreite aus, neuer Umbruch in
jeder Zelle


ΓòÉΓòÉΓòÉ 9.11. Linienziehen ΓòÉΓòÉΓòÉ


 .LIXYZ
X  Y  X        ΓöîΓöÇΓöÇΓöÇΓö¼ΓöÇΓöÇΓöÇΓöÉ
            Γöé  Γöé  Γöé
Y       Ergebnis:  Γö£ΓöÇΓöÇΓöÇΓö╝ΓöÇΓöÇΓöÇΓöñ
            Γöé  Γöé  Γöé
X    X        ΓööΓöÇΓöÇΓöÇΓö┤ΓöÇΓöÇΓöÇΓöÿ
 .LI

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).


═══ 9.12. 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


und Sie erhalten {Inhalt der Fuсnote}.

fБhrt zu:

und Sie erhalten .

 .FS 30

Fuсnoten-Size: Дndert den Standardwert der Aufteilung HTML-Textfenster /
Fuсnotenfenster von 85 zu 15 auf 70 zu 30.

 .FT XXX

Fuсnoten-Text: schreibt "XXX" statt dem standardmДсigen "*". Grafik statt Text
ist erlaubt (Verwendung von Bitmap Text).


═══ 9.13. RДnder und Formatierung ═══


 .LM 10

setzt den linken Rand (left margin) vom Standardwert 1 nach 10.

 .FM aus  ( .FM off )
 .FM an  ( .FM on )

(nur IPF und Winhelp) Mit dem Punktbefehl Formatieren wird die Formatierung
aus- und eingeschaltet. Standard ist an.

 .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.

In HTML-Dateien wird der Rand nur in FБnfer-Schritten verstellt.


ΓòÉΓòÉΓòÉ 9.14. If-Bedingungen ΓòÉΓòÉΓòÉ


 .IF BEDINGUNG
 .ELSE
 .END

БbertrДgt nur bestimmte Teile des Quelltextes ins Zielformat. Die
If-Bedingungen werden in der HMP-Datei oder Бber die Kommandozeile mit
#BEDINGUNG gesetzt (Groс- oder Kleinschreibung egal). Erlaubt sind auch:


 .IF not BEDINGUNG
 .IF BED1 and BED2
 .IF BED1 or BED2


ΓòÉΓòÉΓòÉ 9.15. HTML-spezifische Befehle ΓòÉΓòÉΓòÉ


 .ID LABEL

benennt die aktuelle HTML-Datei statt z.B. N001.HTML LABEL.HTML.


 .NR 10
 .HD 100
 .1
 Ъberschrift mit fixer interner Nummer

setzt den internen Ъberschrifts- und Dateinamen-ZДhler entsprechend hoch, so
daс zusДtzliche Kapitel unmittelbar davor nicht zu einer VerДnderung der
nachfolgenden Numerierung fБhrt.


ΓòÉΓòÉΓòÉ 10. Projekt-Einstellungen (Ini-Datei) ΓòÉΓòÉΓòÉ


Unterkapitel:
Einleitung
Main: HMP Einstellungen
General: Allg. Einstellungen
Format: Format-Einstellungen
Spec. Chars: Zeichen mit besonderer Bedeutung
Font: Schriften
link: Einstellungen bzgl. Querverweise
HTML-0: fertige HTML-Designs
HTML-1: HTML-spezifische Einstellungen, Seite 1
HTML-2: HTML-spezifische Einstellungen, Seite 2
Winhelp: Winhelp-spezifische Einstellungen
Rich text format spezifische Einstellungen
Help: Einstellungen bzgl. Hilfedateien (nicht HTML)

nДchstes Hauptkapitel:
Ъber Hypermake


ΓòÉΓòÉΓòÉ 10.1. Einleitung ΓòÉΓòÉΓòÉ


Das Projekt-Einstellungen Buch enthДlt die Einstellungen, die das Aussehen und
die FunktionalitДt der erzeugten Hypertexte beeinflussen. Die Einstellungen auf
der "Main" (Haupt-)Seite werden in der HMP-Datei (HyperMake Projekt Datei) und
alle anderen Seiten in der Ini-Datei gespeichert. Jedes Hypertext-Projekt hat
immer seine eigene HMP-Datei, es kФnnen aber mehrere Projekte die selbe
Ini-Datei benutzen, falls die Hypertexte dieser Projekte das selbe Aussehen und
die selbe FunktionalitДt haben sollen.

Sie kФnnen die HMP-Datei und die Ini-Datei mit einem ASCII-Editor verДndern,
insbesondere wenn Sie nicht das graphische Programm HYMAKE.EXE mit dem
Einstellungen-Buch, sondern den reinen Compiler HMAKE.EXE benutzen.

FБr Ihre eigene Ini-Datei benutzen Sie besser eine Kopie von BEISPIEL.INI als
von DOKU.INI. In letzterer sind recht ausgefallene ASCII-Werte fБr die Toggles
gewДhlt.

In den folgenden Unterkapiteln wird mit Schreibmaschinenschrift die jeweilige
Zeile der Ini-Datei angegeben. Wenn Sie ausschlieсlich das Einstellungen-Buch
verwenden, ist diese Zeile fБr Sie nicht weiter von Interesse.

Wenn Sie HMP- und Ini-Dateien mit einem Editor und nicht Бber das
Einstellungen-Buch verДndern wollen

Die erste Zeile wird nicht interpretiert. Wie in den Programmiersprachen C++
und Java wird aller Text, der rechts von zwei SchrДgstrichen // steht, nicht
interpretiert. So kФnnen mit // beginnend Kommentarzeilen eingefБgt werden.
Windows-konform kФnnen Kommentarzeilen auch mit ; beginnen, wobei der
Strichpunkt allerdings am Zeilenanfang stehen muс. Die Reihenfolge der Schalter
darf geДndert werden, aber es muс jeder Schalter genau einmal vorkommen. Mit
wenigen Ausnahmen wird in der Ini-Datei Groс- und Kleinschreibung nicht
unterschieden.

Die in eckigen Klammern stehenden Ъberschriften wie [general settings] dienen
im Unterschied zur Бblichen Verfahrensweise bei Windows-Ini-Dateien nur Ihrer
eigenen Ъbersicht und kФnnen auch weggelassen werden.

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.


ΓòÉΓòÉΓòÉ 10.2. Main: HMP Einstellungen ΓòÉΓòÉΓòÉ

Die Seite "Main" enthДlt die Einstellungen, die in der sog. HMP-Datei
(Hypermake Projekt-Datei) gespeichert werden, insbesondere den Dateinamen des
Quelltextes sowie den Namen der Ini-Datei, also der Datei, die die
Einstellungen aller folgender Seiten des Einstellungen-Buches enthДlt.

Hypermake speichert die "Main" Seite und die restlichen Seiten deshalb in zwei
unterschiedlichen Dateien ab, damit Sie fБr hinsichtlich der Darstellung
Дhnlichen Projekten nicht vФllig neue Ini-Dateien pflegen und verwalten mБssen.

Quelltextdateien

Sie kФnnen eine oder mehrere Quelltext-Dateien angeben. Wenn Sie mehrere
Quelltextdateien haben, so werden sie so verarbeitet, als ob sie hintereinander
in einer groсen Textdatei stБnden.

Es kann sinnvoll sein, bestimmte Teile des Quelltextes auszulagern, etwa eine
Datei, die nur externe Querverweise (insbes. fremde Internet-Adressen) enthДlt
und eigenstДndiger Pflege bedarf. Bei sehr groсen Texten (mehrere Megabyte)
kann es auch von Interesse sein, mehrere Einzeldateien anzumelden; allerdings
kann der integrierte Hypermake-Editor bis ca. 15 MB groсe Einzeldateien
verarbeiten. Wenn verschiedene Personen fБr bestimmte Kapitel zustДndig sind,
empfehlen sich ebenfalls Einzeldateien.

Wenn kein Laufwerk und kein Verzeichnis angegeben wird, so wird die
Quelltext-Datei im selben Verzeichnis gesucht, in dem sich auch die aktuelle
HMP-Datei befindet.

Ini-Datei

Die Daten aller der "Main"-Seite folgenden Seiten werden in der Ini-Datei
gehalten, die Sie hier angeben. FБr Дhnliche Projekte kФnnen Sie dieselbe
Ini-Datei verwenden.

Da es vФllig unsinnig wДre, bei einem neuen Projekt das dicke
Einstellungen-Buch von vorn bis hinten neu auszufБllen, werden Sie beim DrБcken
der Taste Neu aufgefordert, eine schon vorhandene Ini-Datei als Schablone
anzugeben (etwa die beiliegende BEISPIEL.INI). Hypermake legt dann erst einmal
eine exakte Kopie dieser schon vorhandenen Ini-Datei an. Sie kФnnen dann spДter
auf den anderen Seiten des Einstellungen-Buches die gewБnschten Оnderungen
vornehmen. Щffnen ordnet dem aktuellen Projekt eine schon vorhandene Ini-Datei
zu, d.h. Оnderungen am Einstellungen-Buch fБhren zu einem Ъberschreiben der
angegebenen Ini-Datei, was unter UmstДnden andere Projekte beeinfluсt, die
dieselbe Ini-Datei benutzen. Sichern als kФnnen Sie verwenden, um eine neue
Ini-Datei anzulegen, die dann parallel zur alten Datei existiert, die evtl.
weiterhin von einem anderen Projekt genutzt wird.

Grafikdateien

Mit dem Hakerl bei "Grafikdateien suchen" wird die darunterliegende
Verzeichnis-Liste aktiviert. In diesem Fall sucht Hypermake beim Verarbeiten in
den hier angegebenen Verzeichnissen nach Grafiken, die im aktuellen
Hypertext-Projekt benФtigt werden und mahnt ggfs. deren Fehlen an. Mehr dazu
siehe Kopieren von Grafikdateien.

Wenn Sie hier kein Hakerl setzen, mБssen Sie sich selbst um das
Zusammenkopieren der Grafikdateien kБmmern. Diese mБssen sich dann in dem
Verzeichnis befinden, das die HTML-Dateien enthДlt bzw. wo der Quelltext fБr
den zweiten Compiler (IPF- oder RTF-Datei) sich befindet.

ebenfalls Compiler und Betrachter starten

Nachdem das Verarbeiten gestartet wurde und Hypermake den Quelltext erfolgreich
in das gewДhlte Hypertextformat Бbersetzt hat, kann auf Wunsch noch der zweite
Compiler sowie der Betrachter (Viewer, Browser) gestartet werden. Dies setzt
aber voraus, daс Hypermake im Programm-Einstellungen Buch (Ansicht -
Programm-Einstellungen) auf der Seite "2nd Comp" und "View" die entsprechenden
Programme (z. B. die ausfБhrbare EXE-Datei des Netscape Browsers) mitgeteilt
wurden.

Mehr zum Programmablauf siehe Verarbeitung.

Zielformat

Hier kФnnen Sie zwischen den verschiedenen Hypertext-Formaten auswДhlen, die
aus ihrem Quelltext erzeugt werden sollen. Sie kФnnen aber auch unter Projekt -
Verarbeiten zu ein anderes Format erstellen, wobei diese Einstellung dann
entsprechend verДndert wird.

If-Bedingungen

Sie kФnnen sog. If-Bedingungen definieren. AbhДngig von dieser Definition
werden dann Textteile, die entsprechend markiert wurden, nicht oder schon mit
Бbersetzt. Mehr dazu siehe If-Bedingungen.

Unterkapitel:
Parameter

nДchstes Hauptkapitel:
General: Allg. Einstellungen


ΓòÉΓòÉΓòÉ 10.2.1. Parameter ΓòÉΓòÉΓòÉ

Unter "Parameter" auf der Seite "Main" in den Projekt-Einstellungen finden sich
eine Reihe von Checkboxen. Wenn Sie die Kommandozeilenversion von Hypermake
benutzen, ist fБr Sie die Bezeichnung des Parameters in Klammern relevant.

"No Frames": Frames-lose HTML-Dateien erzeugen (NOFRAMES)

(Nur HTML) Dieser Parameter erzeugt Frames-lose HTML-Seiten. Er hat zwei
Effekte: Zum einen werden alle .FA bzw. .WA (Fensteranordnung) Punktbefehle
nicht ausgefБhrt. Zum anderen werden alle Fuсnoten in eine einzige
Fuсnotendatei geschrieben und die Fuсnoten erhalten fortlaufende Nummern wie ,
auf die der Benutzer klicken kann.

"No ID": .ID-Punktbefehle ignorieren (NOID)

(nur HTML) Bei Verwendung von .ID Punktbefehlen heiсt die HTML-Datei so wie der
ID-Name, wДhrend Hypermake sonst Dateinamen mit fortlaufender Nummer vergibt.
Wenn Sie ausdrБcklich keine festen Dateinamen, sondern durchweg die
fortlaufende Numerierung haben wollen, kФnnen Sie dies Бber diesen Parameter
erreichen.

"Pre Filename": Mehrere Hypermake-Projekte in nur einem Verzeichnis (PRE)

(nur HTML) Der Schalter "pre filename" in der Ini-Datei (nur
Kommandozeilenversion) erlaubt es Ihnen, vor alle HTML-Dateinamen noch eine
bestimmte Zeichenfolge zu setzen, z. B. UserN000.HTML, UserN001.HTML. Dies
erfordert jedoch fБr jedes Projekt eine separate Ini-Datei. Mit diesem
Parameter kФnnen sie separate Ini-Dateien vermeiden.

Heiсt das Projekt MEIN, erzeugt Hypermake HTML-Dateien MEIN\MEIN*.HTML . Dies
kФnnen Sie dazu nutzen, mehrere Hypermake-Projekte in nur einem Verzeichnis zu
halten.

Bei DOS-Laufwerken darf der "pre filename" bzw. der Name der HMP-Datei nicht
lДnger als 3 Buchstaben sein!

"Alt Graphic File": Unterschiedliche Sprachen in einem Verzeichnis (_)
Unterstrich

(nur HTML) Wenn Sie etwa eine deutsch- und englischsprachige Homepage in ein
gemeinsames Verzeichnis kopieren mФchten, ergibt sich das Problem, daс sowohl
die deutschsprachigen Buttons FORWARD.GIF, BACK.GIF usw. als auch die
englischsprachigen Buttons identische Dateinamen haben.

Der Parameter hДngt an alle Verweise auf Buttongrafik-Dateinamen noch _
(Unterstrich) an: FORWARD_.GIF, BACK_.GIF, USER_.GIF. FБr eine der beiden
Sprachen mБssen Sie diese Funktion verwenden und die Button-Dateinamen
entsprechend umbenennen.

"Big Font": Schrift global vergrФсern (BIGFONT)
"Small Font": Schrift global verkleinern (SMALLFONT)

Mit diesen Parametern kann man bei allen Zielformaten alle
SchriftgrФсen-Angaben etwas vergrФсern (um ca. 30%) oder verkleinern. Mir ist
aufgefallen, daс bei der gleichen Ini-Datei zwischen den verschiedenen
Zielformaten, insbesondere zwischen IPF und Winhelp, merkwБrdige
GrФсenunterschiede bei den Schriften entstehen kФnnen. Um nicht zwei
Ini-Dateien zu benФtigen, kФnnen Sie diese Parameter verwenden.

"New IPFC": Hypermake an IPFC Compiler anpassen (NEWIPFC)

Die neueren IBM IPFC Compiler (Version 3) erzeugen in einigen Details andere
Hypertexte als Дltere Versionen (Version 1 und 2). Besonders die AnfДnge jeder
Seite unterscheiden sich hinsichtlich einer Leerzeile und EinrБckung am Anfang.
Mit dem Parameter /newipfc ergibt sich beim neuen Compiler ein gleiches
Aussehen, was den Anfang der Seiten betrifft, wie beim alten Compiler.

"FAT Filenames": DOS-Dateinamen erzwingen (FAT)

Mit diesem Parameter werden alle Dateien nach DOS-Konvention in der 8.3
Schreibweise erzeugt und entsprechend verkБrzt. Auf eventuelle Konflikte, etwa
wenn ein Kapitel "Grundsatzkapitel1.HTML" und ein anderes
"Grundsatzkapitel2.HTML" heiсt, so daс aus beiden Kapiteln "GRUNDSAT.HTM" wird,
mБssen Sie selbst achten.


ΓòÉΓòÉΓòÉ 10.3. General: Allg. Einstellungen ΓòÉΓòÉΓòÉ

RegistrierungsschlБssel


Registration code = 0

Hier tragen Sie Ihren Registrierungs-Code ein, um Quelltexte von mehr als 20 kB
verarbeiten zu kФnnen. Siehe auch Registrierung.

Sprache der Hymake BenutzeroberflДche


//possible settings: ENGLISH, GERMAN, C, PASCAL
Language = GERMAN C

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.

Ihre Programmiersprache (IPF, Winhelp, HTMLHELP)

Wenn Sie von Hypermake Panel ID und Helptable Dateien erstellen lassen, kФnnen
Sie zwischen C und Pascal wДhlen.

Tonsignal nach erfolgreichem Verarbeiten


//beep when finishing compiling - possible settings: YES, NO
beep = YES

Wenn Hypermake eine IPF/RTF-Datei oder mehrere HTML-Dateien erfolgreich
erstellt hat, hФren Sie einen Piepston (aufsteigende vier TФne). Sie kФnnen
diesen Ton hier ein oder ausstellen. Bei OS/2, DOS und Windows NT/2000 wird der
PC-Lautsprecher angesprochen, bei Win95/98 wird der Ton Бber die Soundkarte
ausgegeben.


ΓòÉΓòÉΓòÉ 10.4. Format: Format-Einstellungen ΓòÉΓòÉΓòÉ

Quelltext-Format


//possible Settings: ASCIIHARDRET, ASCIISOFTRET, WORDSTAR4
Source format = ASCIISOFTRET

Sie haben drei verschiedene Quelltext-Formate zur Auswahl. Siehe Bedeutung von
Returns.

Quelltext-Zeichensatztabelle


//possible Settings: ISO, IBM
source codepage = IBM

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.

Diese Einstellung wird auch vom integrierten Hymake Editor gelesen. Wenn Sie
"Projekt - sonstige Textdatei Фffnen" benutzen, so wird die
Zeichensatz-Einstellung des letzten Hypermake Projektes genutzt.

Target (Zielformat, wird in Hymake 4.0 nicht mehr geschrieben, jetzt in
HMP-Datei)


//possible settings: IPF, HTML, WINHELP3, WINHELP4, HTMLHELP
Target = HTML

Die Standardeinstellung kann durch die gleichlautenden Programmparameter in der
HMP-Datei oder der Kommandozeile temporДr Бberschrieben werden.

Ob WINHELP3 oder WINHELP4 gewДhlt wird, hДngt davon ab, ob HC.EXE bzw. HCP.EXE
einerseits oder HCW.EXE andererseits verwendet wird. Die Unterschiede sind
relativ gering.


ΓòÉΓòÉΓòÉ 10.5. Spec. Chars: Zeichen mit besonderer Bedeutung ΓòÉΓòÉΓòÉ

Auf Konflikte БberprБfen

wird nur intern in den Projekt-Einstellungen interpretiert. Es dient dazu,
Konflikte aufgrund einer Mehrfachverwendung der "specific chars" zu vermeiden.

Listenzeichen


//only ASCII source
List chars = =-

Auflistungszeichen werden fБr unsortierte Listen und sortierte Listen benФtigt.

Indexzeichen


Index char = #

Siehe Erstellung von Querverweisen, Index und Indexzeichen. Mit dem Punktbefehl
.IZX  wird die hier festgelegte Standardeinstellung mit dem Zeichen X
Бberschrieben.

Index Filter


//characters not shown in index and duplicated heading
index filter = ().

Es kФnnen bestimmte Zeichen im Stichwortverzeichnis und bei der Duplizierung
von KapitelБberschriften unterdrБckt werden.

Umschaltzeichen (Toggles)


//highlighted char toggles
//all formats:   1 alternate  2 italic 3 bold 4 underlined
//IPF:       5 red 6 cyan 7 blue
//HTML:      8 strike 9 big 10 small
//HTML, Winhelp:  11 sub 12 sup
//     123456789012
toggles = ************

Hier lassen sich die Umschaltzeichen festlegen. Sie mБssen immer alle zwФlf
Zeichen eingeben, auch wenn Sie IPF oder HTML nicht benutzen.

Im integrierten Hypermake-Editor kФnnen Sie Umschaltzeichen Бber PopupmenБ -
Umschaltzeichen eingeben.

Wenn Sie den IBM Zeichensatz verwenden, dБrfen Sie die ASCII-Zeichen unterhalb
von ASCII 26 benutzen. Um Buchstaben in das Einstellungen-Buch einzugeben, die
nicht auf Ihrer Tastatur sind, mБssen Sie die ALT-Taste gedrБckt halten und
dann im Ziffernblock die gewБnschte Nummer eingeben.

Extended Letters (sprachspez. Zeichen, insbes. Umlaute)


//language specific letters besides A...Z, a...z, 0...9
//english '-
//german ДФБсОЩЪ-
extended letters = ДФБсОЩЪ-

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.


ΓòÉΓòÉΓòÉ 10.6. Font: Schriften ΓòÉΓòÉΓòÉ


//Font chars from A to Z and from a to z (case-sensitive!)
//both HTML and IPF: size Linestandard OmitLinks PRE center
//only IPF: Fontname codepage foregroundcolor BACKGROUNDCOLOR
//only HTML: PHRASEELEMENT Color
Font A = 15 fmodern:Courier Courier CODE
Font b = fmodern:Courier Courier 12 CODE black 437 Linestandard OmitLinks
Font B = 30 Arial,Helvetica,Univers fswiss:Helvetica Helv neutral
Font Z = GREEN 30 Arial,Helvetica,Univers fswiss:Helvetica Helv yellow
Font G = 15 Arial,Helvetica,Univers fswiss:Helvetica Helv black
Font T = 18 froman:Roman Tms_Rmn
Font C = black
Font o = OmitLinks

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.

In den Projekt-Einstellungen auf Seite "Font" kФnnen Sie mit Doppelklick oder
"Оndern" den Schrift-Dialog aufrufen. Darin kФnnen Sie entweder die
Dialogelemente bedienen oder die Eingabezeile editieren. Die Eingabezeile
reprДsentiert die Summe der Dialogelemente. Die Оnderung der Eingabezeile hat
die Оnderung von Dialogelementen zur Folge und umgekehrt. Vom Beispielsfeld
("Beispiel") sollten Sie jedoch nicht allzu viel erwarten, denn jedes
Hypertextformat hat seine Eigenheiten - die Darstellung kann jeweils nur eine
grobe AnnДherung des tatsДchlichen Schriftbildes sein.

Kennzeichen der einzelnen Parameter in der Eingabezeile bzw. hinter dem = sind:

     SchriftgrФсe: alle Zahlen, die kleiner als 200 sind
     Codepage: (nur IPF) alle Zahlen grФсer/gleich 200
     Vordergrundfarbe: (vgl. Farb-Beispiele)
        -  IPF: alle Farben in Kleinbuchstaben:
           default, blue, cyan, green, neutral, red, yellow, black.
        -  HTML, Winhelp: beginnt mit Groсbuchstabe, dann folgen
           Kleinbuchstaben:
           Black, Silver, Gray, White, Maroon, Red, Purple, Fuchsia, Green,
           Lime, Olive, Yellow, Navy, Blue, Teal, Aqua.
     Hintergrundfarbe: (nur IPF) alle Farben in Groсbuchstaben: DEFAULT, BLUE,
      CYAN, GREEN, NEUTRAL, RED, YELLOW, BLACK.
     Phrase element: (nur HTML) ADDRESS, PRE, EM, STRONG, DFN, CODE, SAMP,
      KBD, VAR, CITE.
     IPF Schrift-Typ: Alle Eingaben, die nicht den bisherigen Kriterien
      entsprechen.
     HTML Schrift-Typ: mindestens 2 Schriftnamen, getrennt durch Komma ohne
      Leerzeichen
     Winhelp Schrift-Typ: mit Doppelpunkt getrennte
      Schriftfamilie:Schriftbezeichnung. Schriftfamilien sind fmodern, froman,
      fswiss.


 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.

 Die standardmДсig verwendete Codepage hДngt bei IPF von Einstellungen im
 OS/2-Betriebssystem bzw. vom Parameter hinter IPFC ab.

 Beachten Sie bitte, daс Sie IPF-, Winhelp- und HTML-Kommandos hier mischen
 kФnnen, so daс ein Schrift-Buchstabe ein unterschiedliches Outfit abhДngig vom
 Zielformat reprДsentieren kann.

 FБr weitere Informationen lesen Sie bitte das ausfБhrliche Kapitel Бber
 Schriften.


ΓòÉΓòÉΓòÉ 10.7. link: Einstellungen bzgl. Querverweise ΓòÉΓòÉΓòÉ

Endungen von WФrtern (endings of words)


//endings in german words: e n en s es
//endings in english words: s es ies 's ion ions ing ings
ending of words = e n en s es

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:


ending of words = e s es n en 's

Text fБr Querverweise zu...


Text for link to subchapters = @Unterkapitel:@
Text for link to next chapter = @nДchstes Hauptkapitel:@

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 das Eingabefeld leerlassen oder ein NO in Groсbuchstaben eingeben,
zieht Hypermake keine solchen Kapitel-Querverweise:


Text for link to subchapters = NO
Text for link to next chapter = NO

Text for link to main chapter = zum Hauptkapitel (Font Z)

Wird der Befehl Fensteranordnung .FA verwendet, so werden zwei
Gliederungsebenen gleichzeitig angezeigt. Im Fenster mit dem Unterkapitel wird
zu Beginn ein Querverweis auf das Hauptkapitel gezogen; andere Querverweise bei
HTML 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. Es kann mit NO zwar abgeschaltet werden, ist aber nicht
ratsam.

Bei IPF wird text for link to main chapter nicht verwendet.

Bei diesen Textangaben dБrfen Sie grundsДtzlich mit (Font X) am Ende der Zeile
eine Schrift festlegen. Sie dБrfen auch Umschaltzeichen verwenden.

keine weiteren Querverweise im...


//possible Settings: PARAGRAPH, WINDOW, ALWAYS
no more links in = PARAGRAPH

Zweite und dritte Querverweise kФnnen in einem Absatz (paragraph) oder
innerhalb eines gesamten Kapitels (window) unterdrБckt werden, oder die
UnterdrБckung ist abgeschaltet und es werden Querverweise immer gezogen
(always). Siehe Querverweise, UnterdrБcken von Querverweisen.

URL Grafikdatei (Markieren externer Links)


//graphics file for marking external URL links or NO for no graphics file
URL graphics file = World

Mit Ausnahme von Winhelp3 unterstБtzten alle Formate Querverweise ins WWW. Der
Leser sollte wissen, welche Querverweise extern und welche intern sind,
schlieсlich muс er bei den externen gerade online sein. Den automatischen
externen Querverweisen kann man mit diesem Schalter eine Grafik als Kennzeichen
voransetzen.


ΓòÉΓòÉΓòÉ 10.8. HTML-0: fertige HTML-Designs ΓòÉΓòÉΓòÉ

FБr HTML bietet Hypermake die umfangreichsten EinstellungsmФglichkeiten. Sie
kФnnen hier mit einem Knopfdruck verschiedene HTML-Designs einstellen, die
jeweils zu einer abgestimmten Auswahl von Schalter-Stellungen auf den Seiten
HTML-1 und HTML-2 fБhren. Die Designs sind von schlicht (fast ohne Javascript)
zu technisch aufwendig (mit viel Javascript) sortiert. FБr die Benutzer, die
bei Hypermake schon lДnger dabei sind: Die Nummer hinter "Hypermake" stellt die
Versionsnummer dar, bei der das Design als Standarddesign eingefБhrt wurde.

Die Sprache bezieht sich auf die sprachspezifischen Schalter und wird
abgefragt, wenn Sie ein fertiges HTML Design auswДhlen. Ich hoffe, daс ich von
Benutzern Einstellungen (Ini-Dateien) fБr weitere Sprachen erhalte.

Das Hypermake 4.0 Design benutzt verschiedene Frame-Namen (default frame,
content frame) fБr  das Inhaltsverzeichnis und fБr den normalen Text. Die
Startseite ist nicht mehr N000.HTML oder INDEX.HTML, sondern INDXF.HTML. Es
handelt sich um eine Rahmenseite, in der dann auf der linken Seite das
aufklappbare Inhaltsverzeichnis und auf der rechten Seite der Text erscheint.
Die Rahmenseite ist auch mit dem neuen Knopf "Home" in der ersten/letzten Zeile
der Textseiten erreichbar. Das Design ist dem Microsoft HTML-HELP Design
Дhnlich und sollte nicht zusammen mit HTMLHELP verwendet werden, weil dann zwei
Inhaltsverzeichnisse gleichzeitig sichtbar wДren.

Wenn Sie ein schФnes Design entwickelt haben, dann schicken Sie mir doch bitte
Ihre Ini-Datei. Fehlen Ihnen Ihr gewБnschtes Design weitere Funktionen in
Hypermake? Dann lassen Sie es mich bitte wissen.

Die Checkboxen weiter unten betreffen einige grundsДtzliche Einstellungen. Wenn
Sie z. B. nur eine kleine Бberrschaubare Homepage erstellen mФchten, kann eine
eigene Seite fБr Inhaltsverzeichnis und Stichwortverzeichnis - mit
mФglicherweise nur ein oder zwei EintrДgen - unpassend sein. Deaktivieren Sie
in diesen FДllen die Schalter Seite Inhaltsverzeichnis erzeugen oder Seite
Stichwortverzeichnis (Index) erzeugen. Ъblicherweise werden Sie diese Schalter
aber aktiviert lassen, schlieсlich ist es eine der Hauptfunktionen von
Hypermake, Inhalts- und Stichwortverzeichnis zu erzeugen.

Ъblicherweise schreibt Hypermake die Ъberschriften in sauberer HTML Syntax,
wobei dem Browser die Aufgabe zukommt, Ъberschriften verschiedener
Gliederungsebenen auf sinnvolle Weise darzustellen: eine Ъberschrift von Ebene
1 mit einer groсen Schrift, von Ebene 2 mit einer kleineren Schrift usw. Wenn
Winhelp (Windows Hilfe) erzeugt werden soll, muс der Nutzer selbst konkrete
Schriften pro Gliederungsebene festlegen, weil Winhelp keine eigenen Befehle
fБr Ъberschriften kennt. Wenn Sie die auf Seite Winhelp definierten
Ъbeschrifts-Schriften auch fБr HTML verwenden aktivieren, werden statt der
Бblichen Befehle fБr Ъberschriften konkrete Schriften benutzt. Sie kФnnen so z.
B. unterschiedliche Farben bei den Ъberschriften verschiedener Gliederungsebene
verwenden. Die empfohlene Einstellung ist aber die Nutzung der normalen
HTML-Befehle, also das Deaktivieren dieses Schalters.


ΓòÉΓòÉΓòÉ 10.9. HTML-1: HTML-spezifische Einstellungen, Seite 1 ΓòÉΓòÉΓòÉ

body tags ("body" EintrДge)

Es kФnnen diverse HTML body tags eingetragen werden, mit dem Sie allgemeine
Angaben zum Aussehen von Browser-Seiten machen kФnnen, insbesondere eine
Hintergrundgrafik oder Hintergrundfarbe auswДhlen und eine Textfarbe bestimmen:


//enter tags or NO
body tags = background="backgr.gif" TEXT="#00FFFF"
contents tags = BGCOLOR=#"CCFFCC"

Die "contents tags" Zeile ist optional.

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.

Wenn Sie in den Projekt-Einstellungen auf der Seite "html-1" bei "Body Tags"
neben das Eingabefeld auf die Taste drБcken, gelangen Sie zu einem
Dialogfenster, mit dem Sie Hintergrundfarbe oder Hintergrundgrafik (die in
einem sowie die Vordergrundfarbe (Schriftfarbe) fБr die Schriften auswДhlen
kФnnen, denen keine Farben zugeordnet sind. Die Grafikdatei muс sich in einem
der Grafikdatei-Verzeichnisse (siehe Seite Main) befinden.

Erste Zeile, Letzte Zeile

siehe Navigations-KnФpfe


//only HTML: first and last line in file
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

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...).

Im Rahmen des vorgefertigten Designs "Hypermake 4.0" (siehe Einstellungen-Buch
Seite HTML-0) gibt es noch die Funktionen HOMEF ("Homeframe") und MAX
(maximieren). Auсerdem kФnnen benutzerdefinierte Schalter eingerichtet werden,
die auf vom Benutzer festgelegte Seiten zeigen. Mehr dazu siehe
Navigations-KnФpfe.

Art der KnФpfe


//you can use buttons BACK.GIF FORWARD.GIF CONTENT.GIF INDEX.GIF
//instead of simple text or use Javascript buttons
//possible settings: TEXT GIF JAVASCRIPT (Font X)
buttons = GIF

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, nДmlich Funktionsname mit angehДngtem
".GIF".

Sie kФnnen den KnФpfen einen Schrifttyp zuordnen, wenn Sie Text oder Javascript
wДhlen. Bei Javascript schaut eine kleinere Schrift (mit der
Schrift-Eigenschaft "-1") gut aus.

Wenn sich die GIF-Dateien nicht in dem Verzeichnis befinden, das auch die
HTML-Dateien enthДlt, dann statt den Buttons der Text erscheinen, den Sie unter
"text for first/last line" definiert haben. Wenn die Dateien sich auf einem
Unix-Server befinden, wird Groс- und Kleinschreibung unterschieden! Achten Sie
deshalb auf die korrekte Schreibweise der Dateinamen.

Beachten Sie bitte die Button-Bibliothek von Hypermake im Verzeichnis BUTTONS.

Mit der Einstellung JAVASCRIPT werden mit Hilfe der Javascript
Programmiersprache KnФpfe erzeugt. Ein solches Javascript-Programm ist
Bestandteil der HTML-Seite, so daс die KnФpfe schneller geladen werden als
separate GIF-Dateien. Allerdings schauen Javascript-KnФpfe immer gleich aus,
von unterschiedlichen Schriften abgesehen. Mehr zu dieser Auswahl siehe
Navigations-KnФpfe.

Titel in jeder Datei


//enter YES (Font X) or NO
title in every file = NO

Es kann erwБnscht sein, auf jeder HTML-Seite den Titel des Textes (der mit .TI
am Textanfang angegeben wurde) erneut anzeigen zu lassen. Der Titel erscheint
dann noch vor der oberen Navigationszeile ("Erste Zeile"). Meist ist hier eine
kleinere Schrift angebracht.

Minimale Wortzahl fБr Groсes Stichwortverzeichnis


entries for extended index = 30

Hier kФnnen Sie einstellen, ab welcher Zahl von IndexeintrДgen das groсe
Stichwortverzeichnis statt dem kleinen erzeugt werden soll.

Teilung in Dateien


//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

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.

Teilung durch Strich


//Enter heading level up to which has to be divided by horizontal rules
//  (0 means no rules)
horizontal rule level = 4

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.

erscheint in Inhaltsverzeichnis


//Enter heading level up to which has to be shown in the HTML content file
//  (6 means all levels, 0 means no content)
content level = 6

Mit diesem Schalter kФnnen Sie einstellen, bis zu welcher Gliederungsebene die
Ъberschriften im Inhaltsverzeichnis erscheinen sollen. Wird 0 eingestellt,
werden weder die Inhaltsverzeichnis-Seite noch Querverweise dorthin erstellt.

Inhaltsverzeichnis in Baumansicht


//enter NO for non-Javascript or AlternateLinkText;OpenText;CloseText
contents tree = Link zur normalen Darstellung;aufklappen;zuklappen (Font X)

Mit dem Schalter contents tree in der Ini-Datei lassen sich Texte wДhlen, die
im Zusammenhang mit der Javascript Baumansicht erscheinen. "AltenateLinkText"
wird zum Link, der auf das normale immer aufgeklappte Inhaltsverzeichnis zeigt.
"OpenText" und "CloseText" erscheint bei neueren Browsern als Bubblehelp, wenn
der Mauszeiger sich Бber dem Grafikzeichen fБr Щffnen bzw. Schlieсen des Baumes
bewegt. Er wird auch angezeigt, wenn im Browser das Laden von Bildern
deaktiviert ist (HTML IMG ALT-Text). Sie kФnnen auсerdem eine Schrift fБr den
Inhaltsverzeichnis-Baum auswДhlen. Es ist sehr sinnvoll, eine Schrift mit der
Eigenschaft PRE zu wДhlen: es wird dann verhindert, daс innerhalb des Baums
einzelne Zeilen umgebrochen werden und so die saubere Formatierung des Baumes
beeintrДchtigt wird.


ΓòÉΓòÉΓòÉ 10.10. HTML-2: HTML-spezifische Einstellungen, Seite 2 ΓòÉΓòÉΓòÉ

HTML Dateinamen


//possible settings: sample.html SAMPLE.HTML Sample.html sample.htm SAMPLE.HTM Sample.htm
filename appearance = sample.html

Hier kФnnen Sie festlegen, wie von Hypermake erzeugte Dateinamen aussehen
sollen (Groс- oder Kleinschreibung, kurze oder lange Dateinamen). Wenn Sie
HTML-Dateien im WWW verФffentlichen wollen, sollten Sie das Kapitel Бber
Dateinamen lesen. Wenn diese Einstellung falsch ist, kann es vorkommen, daс auf
Ihrem Rechner die Links funktionieren, auf dem Server aber nicht mehr!

Warnung Dateiname nicht 8.3


//choose DOS or LONG - DOS means 8.3 filenames, LONG no limit
filenames = LONG

Normalerweise produziert Hypermake Warnungen, wenn beim vorigen Schalter als
Endung .HTM gewДhlt wurde und lДngere Dateinamen als mit 8 Buchstaben
geschrieben werden. Mit LONG kФnnen diese Warnungen unterdrБckt werden.

Beginn der Dateinamen (pre filename)

(nur Ini-Datei, in den Projekt-Einstellungen wird stattdessen "pre filename"
auf der Seite "Main" verwendet.)


//pre filename = XYZ* let all HTML files begin with XYZ
pre filename = *

(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.)

Bezeichner fБr Frame- bzw. Browser-Fenster


default frame = _top
contents frame = _top

Wenn Sie im Internet surfen, Фffnet sich gelegentlich ein zweites
Browser-Fenster. Dann hat der Autor der Seite, von der der Link wegfБhrt, nicht
die sonst Бbliche Bezeichnung "_top" als Bezeichner fБr das Ziel-Fenster
angegeben.

Wenn sДmtliche HTML-Seiten des Dokuments in einem Frame eines anderen Dokuments
erscheinen sollen, kann diese Einstellung geДndert werden. Die Оnderung dieses
Standardwertes erfordert fortgeschrittene Kenntnisse in HTML und ist im
Regelfall nicht erforderlich. Die Standardeinstellung lautet _top .

Es kann bei grФсeren Dokumenten hilfreich sein, wenn der Benutzer zwei Browser
Фffnen kann - einen fБr das Inhaltsverzeichnis und einen fБr den Text. Das lДсt
sich realisieren, indem fБr default frame und fБr content frame
unterschiedliche Bezeichner gewДhlt werden, etwa "haupt" und "inh".

Das vorgefertigte Design "Hypermake 4.0" (Seite HTML-0) benutzt hier zwei
verschiedene Bezeichner fБr Inhaltsverzeichnis und Text.

Erscheinungsbild der Fuсnoten


//choose between javascript popup footnotes (ACTIVEX) frame footnotes (FRAMES) or no frames (NOFRAMES)
footnotes = FRAMES

Hypermake kann Fuсnoten auf dreierlei Weise erzeugen: Бber Frames ( frames ),
ohne Frames ( noframes ) und als ActiveX-Fuсnoten ( activex ). Letzteres ist
ein spezieller Microsoft-Dialekt und ist vor allem fБr HTML-Help gedacht. Es
kann nur von Microsoft-Produkten gelesen werden und eignet sich somit nicht fБr
VerФffentlichungen im Internet!

Ъberschrift fБr Fuсnotenseite


notes text = Anmerkungen

Wenn ein Quelltext mit Fuсnoten mit der Einstellung bzw. dem Programmparameter
noframes  kompiliert wird, erzeugt Hypermake eine einzige groсe Datei mit allen
Fuсnoten-Inhalten. Diese trДgt dann die Ъberschrift, die sie unter notes text
festlegen. Sinnvolle Bezeichnungen sind Fuсnoten, Anmerkungen,
Quellennachweise, Querverweise, Literaturangaben. Diese Bezeichnung kann dann
auch in der Titelzeile der entsprechenden HTML-Seite erscheinen.

Text in Browser-Titelzeile, fБr Suchmaschinen und in der Browser-Statuszeile


//here you can define the text appearing in the browser titlebar
//enter DOCTITLE, HEADING, FILENAME and fixed text, e.g. a slash
//NO means no text
file title = DOCTITLE - HEADING
meta content = DOCTITLE - HEADING
statusbar mouseover = zum Kapitel: HEADING (Datei FILENAME)
statusbar default = DOCTITLE - Besuchen Sie bitte regelmДсig die Homepage!

Hier kФnnen Sie den Inhalt der Titelzeile des HTML-Browsers und
Meta-Anweisungen fБr Internet-Suchmaschinen festlegen. DOCTITLE entspricht dem
Text, den Sie hinter .TI geschrieben haben, HEADING ist der Ъberschrifts-Text
der aktuellen HTML-Seite.

Der Statuszeilen-Text ist der Text, der im grauen Textfenster am unteren Rand
des HTML-Browsers erscheint. Befindet sich der Mauszeiger Бber einem internen
Link, so kann mit dem Schalter statusbar mouseover bestimmt werden, welcher
Text erscheinen soll.

Die Zeichen " und ' werden bei den vier genannten Schaltern nicht umgesetzt.


ΓòÉΓòÉΓòÉ 10.11. Winhelp: Winhelp-spezifische Einstellungen ΓòÉΓòÉΓòÉ


Die Seite "Winhelp-spezifische Einstellungen" bezieht sich sowohl auf das
Zielformat Winhelp als auch auf RTF-Text.

Ъberschriften nicht scrollen


//omit scrolling of the heading, YES or NO
keep heading = YES

Winhelp erlaubt es, die Ъberschrift zu fixieren ("keep"), so daс sie nicht
mitgescrollt wird. Dies kann hier ein- und ausgeschaltet werden.

Ъberschrifts-Schriften


//heading level 123456
heading fonts = ddcooo

Hier kФnnen 6 Schrift-Buchstaben angegeben werden, eine pro Gliederungsebene.
Damit wird die Schrift festgelegt, die die Ъberschrift eines Kapitels einer
bestimmten Gliederungsebene erhДlt. Normalerweise werden Sie fБr die Kapitel in
der oberen Gliederungshierarchie (1, 2) eine grФсere Schrift wДhlen. NatБrlich
mБssen die verwendeten Schrift-Buchstaben auf der Seite "Font" bzw. in der
Ini-Datei unter  Font = definiert sein.

EinrБckung bei Listen


//influences the left margin command and the indention of lists
list indention = 4

Hier kann die StДrke der EinrБckung beim Linken Rand .LM  Punktbefehl sowie bei
sortierten Listen und unsortierten Listen vergrФсert und verkleinert werden.

Standard-SchriftgrФсe


//default value is 10
default font size = 10

Ъblicherweise nimmt Winhelp eine tendenziell eher kleine Schrift fБr den
normalen Flieсtext im Hilfefenster, nДmlich  10 . Insbesondere wenn Sie nur
wenig Text schreiben, kann es sinnvoll sein, eine grФсere Schrift zu wДhlen.
Sinnvoll sind noch 11 und 12 . Bei 11 sind die Schriften schon deutlich dicker,
jedoch kaum grФсer.

Erzeuge HLP-internes Inhaltsverzeichnis
Erzeuge externes CNT Inhaltsverzeichnis


//enter CNTFILE, INTERNAL, BOTH or NO
contents creation = BOTH

Dieser Schalter wird unabhДngig von der Einstellung WINHELP3/WINHELP4
interpretiert. Das HLP-interne Inhaltsverzeichnis erscheint auf der ersten
Seite in der HLP-Datei, wobei der bislang HTML-spezifische Befehl "erscheint in
Inh.verz." ("contents level") auf der Seite HTML-1 interpretiert wird. Es kann
also ein Inhaltsverzeichnis angelegt werden, das nur z. B. 2 Ebenen tief ist.

Das externe CNT-Inhaltsverzeichnis ist ein eigene Datei im ASCII-Format und ist
nur Bestandteil des Winhelp4 Formates. Die Endung des Dateinamens ist CNT
(contents).

Es kann sinnvoll sein, beide Arten von Inhaltsvereichnissen erzeugen zu lassen
(both), also ein HLP-internes Inhaltsverzeichnis als auch eine
Winhelp4-spezifische CNT-Datei. Das macht Sinn, wenn Sie Ihren Hilfetext fБr
das Zielformat WINHELP3 erstellen und Nutzern von Windows 95 und Windows NT
trotzdem die MФglichkeit eines aufklappbaren Inhaltsverzeichnisses anbieten
mФchten.

Denken Sie daran, daс Sie neben der HLP-Datei dann auch die CNT-Datei
ausliefern mБssen.

CNT "Allgemein" Text


//heading text for the subchapter containing the text
//of the main chapter in CNT files
contents general text = General

Das CNT-Format hat einen schweren Designfehler: Ein Hauptkapitel, das Text
enthДlt, ist nicht vorgesehen. Das ist aber die Regel: Bevor eine
UnterБberschrift kommt, ist meist erklДrender Text vorhanden. FБr den Text, der
eigentlich zum Hauptkapitel gehФrt, erzeugt Hypermake eine Zeile mit dem Text
"Allgemein", dieser kann hier verДndert werden.

Zeichen fБr Listen-"KnФdel"


//character which is the left fat dot in lists, in different list levels
printed listchars = oooo

Hier lДсt sich fБr jede EinrБckungsebene einer unsortierten Liste ein anderes
Zeichen als "KnФdel" aussuchen. Dieses Zeichen kann auch wiederum ein Bitmap
reprДsentieren (Befehl .BT Bitmap text).


ΓòÉΓòÉΓòÉ 10.12. Rich text format spezifische Einstellungen ΓòÉΓòÉΓòÉ

Wenn RTF text (rich text format) erzeugt wird, werden die meisten Einstellungen
auf der "Winhelp" Seite interpretiert.

Farbtabellen-Korrektur


//enter yes or no
Color correction = YES

Wenn RTF-Text erzeugt wird, um die Datei in ein Textverarbeitungsprogramm
einzulesen, so wird am Anfang der Datei eine Farbtabelle erzeugt, die festlegt,
welche Schrift welche Farbe bekommen soll. Das Problem ist nun, daс Winword als
einziges Textverarbeitungsprogramm diese Tabelle anders liest als andere
Programme. Wenn Sie die RTF-Datei in Winword einlesen mФchten, so schalten Sie
die Farbtabellen-Korrektur aus, andernfalls ein. (Selbst das Windows Wordpad
Programm interpretiert die Farbtabelle anders.) Falls die Farben der Schriften
des importierten Textes falsch sind, mБssen Sie diese Einstellung Дndern.

Automatische Ъberschrifts-Numerierung


//enter yes or no
automatic heading enumeration = YES

Wenn dieser Schalter aktiviert ist, erzeugt Hypermake statt dem Text fБr den
Gliederungspunkt, z. B. "7.2.3", einen RTF-Code, den das
Textverarbeitungsprogramm als Gliederungspunkt 3. Ordnung interpretiert. Die
meisten Programme kФnnen diesen Code interpretieren. Alternativ kann der
RTF-Text als ganz normaler Text geschrieben werden.

Zweck der automatischen Ъberschrifts-Numerierung ist insbesondere die FДhigkeit
von Textverarbeitungsprogrammen wie Winword, automatisch ein Inhaltsverzeichnis
mit Seitenangaben zu erzeugen.


ΓòÉΓòÉΓòÉ 10.13. Help: Einstellungen bzgl. Hilfedateien (nicht HTML) ΓòÉΓòÉΓòÉ

Startwert fБr ID-Konstanten (nur IPF)


Help Subtable Start ID = 7000

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.

Helptable-Dateiname (nur IPF)
Panel-ID-Dateiname


//files will be overwritten without warning
Helptable filename = HLPTABLE.RC
Panel ID filename  = PANELID.H

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.

Die Panel ID-Datei dient dazu, in ihrem Programm-Quelltext Бber Konstanten
bestimmte Seiten des Hilfetextes aufzurufen. Auf der Seite "Format" kФnnen Sie
wДhlen, ob die Panel-ID-Datei in C- oder in Pascal-Syntax angelegt wird.

Achtung! Die Helptable-Datei und die Panel-ID-Datei werden ohne Vorwarnung
Бberschrieben.


═══ 11. Ъber Hypermake ═══


Unterkapitel:
Registrierung
Haftungsausschluс
Autor
Versionen
Fehlerberichte
Wo Updates?
Warenzeichen
Betriebssysteme
Andere Progs


ΓòÉΓòÉΓòÉ 11.1. Registrierung ΓòÉΓòÉΓòÉ

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
erzeugen, 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. Wenn
Sie ein Freeware-Programm schreiben und Бber die 20kB-Grenze gelangen, erhalten
Sie diesen SchlБssel kostenlos.

Es gibt einen kleinen (bis 150 kB Quelltext) und einen groсen
RegistrierungsschlБssel (unbegrente QuelltextlДnge). Die RegistrierungsgebБhr
fБr den kleinen SchlБssel betrДgt 45 Euro oder 40 Dollar und fБr den groсen
SchlБssel 102 Euro oder 90 Dollar .

Beim Erwerb von mehreren Lizenzen erhalten Sie 30% Rabatt fБr jede zusДtzliche
Lizenz.

Meine Kontoverbindung lautet:

Dresdner Bank Ottobrunn (Deutschland), BLZ 700 800 00, Nr. 075 64 62 400

Auсerhalb des Euro-Raumes registrieren Sie bitte Бber Amerika (per E-Mail siehe
ENGLISH\BMTORDER.TXT oder per Web-Browser http://www.swreg.org, search
"Hypermake").

Den RegistrierungsschlБssel tragen Sie in Ihren Hypermake Ini-Dateien unter
"registration key" bzw. in den Projekt Einstellungen auf der Seite "General"
ein. Die SchlБssel passen fБr die Versionen aller Plattformen und auch fБr
kБnftige Versionen.


═══ 11.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.


ΓòÉΓòÉΓòÉ 11.3. Autor ΓòÉΓòÉΓòÉ

Martin Vieregg, 36. Ich habe Betriebswirtschaft mit Schwerpunkt
Verkehrswirtschaft studiert. Ich arbeite in einer
Zwei-Mann-Beratungsgesellschaft. Unser Spezialgebiet ist der Щffentliche
Verkehr, und zwar Eisenbahn sowie FlughДfen. Das Thema meiner Doktorarbeit
lautet "Effizienzsteigerung im Schienenpersonenfernverkehr" (ISBN
3-929115-51-4).

Meine E-Mail-Adresse: [e-mail]

Die Homepage meiner Freeware- und Shareware-Programme:

http://www.hypermake.de

Postanschrift:

Dr. Martin Vieregg
Emdenstr. 11
D-81735 MБnchen


ΓòÉΓòÉΓòÉ 11.4. Versionen ΓòÉΓòÉΓòÉ

Ideen fБr kБnftige Versionen

Haben Sie Ideen zu neuen Funktionen fБr Hypermake? Ich freue mich Бber jeden
Kommentar oder Verbesserungsvorschlag.

Eine Linux-Version ist mittelfristig geplant.

Ich mФchte bislang nicht das PDF Format als weiteres Zielformat realisieren
(Adobe portable document format), weil es eine Reihe guter RTF nach PDF
Konverter gibt. Wenn Sie aber eine bestimmte RTF-Text FunktionalitДt vermissen,
die fБr eine gute PDF-Konvertierung erforderlich ist, so schreiben Sie mir
bitte.

Hypermake 4.0

Bei der aufwendigen Entwicklung von der letzten Kommandozeilenversion 3.66 bis
zur graphischen Version Hypermake 4.0 stand nicht die FunktionalitДt, sondern
die BenutzeroberflДche im Vordergrund. Trotzdem wurden hinsichtlich
FunktionalitДt kleinere Arbeiten vorgenommen:

     Es wird nun ein fБnftes Zielformat RTF Text (rich text format)
      unterstБtzt, das dazu dient, Hypermake Dokumente in
      Textverarbeitungsprogramme zu Бbernehmen und ggfs. ausdrucken zu kФnnen.
      Das Format ist dem des Winhelp RTF Textes sehr Дhnlich, es werden die
      Einstellungen zu Winhelp interpretiert.

     (HTML) Optimierung der Javascript-Navigationsbuttons und der
      Frame-Darstellung, Schriftauswahl fБr Inhaltsverzeichnis und der
      Navigationszeilen (first line, last line). Diese Оnderungen mБnden in
      einer neuen Kombination von Einstellungen ("Hypermake 4.0 design",
      Projekt-Einstellungen Seite HTML-0)

     Wenn ein Projekt mit vielen HTML-Dateien neu erzeugt wurde, ist ein
      Dateienvergleich mФglich, der die tatsДchlich verДnderten Dateien
      anzeigt.

     einige neue Programmparameter fБr bzgl. Benutzerschnittstelle fБr die
      Kommandozeilenversion HMAKE.EXE, Returncodes

     kleinere, aber nicht schwerwiegende Bugfixe in der FunktionalitДt.


 Neue Funktionen in Hypermake 3.65/3.66

     Verbesserungen bei Tabellen, incl. eines neuen Punktbefehls .TW Table
      word wrap
     interne Numerierung von Ъberschriften und Dateien bei HTML beeinfluсbar
     Groсschreibung ignorieren bei StichwФrtern
     fБr Grafiken bei HTML Angabe eines Bitmap Directory


 Neue Funktionen in Hypermake 3.60

     Javascript Baumansicht des Inhaltsverzeichnisses fБr HTML, lauffДhig
      sowohl unter allen gДngigen Browsern
     Statuszeilen-Text bei internen Querverweisen
     neue Befehle fБr HTML Tabellen


 Neue Funktionen in Hypermake 3.5

     UnterstБtzung des Winhelp Formates
     RБckwДrts-Konvertierung von RTF nach Hypermake
     UnterstБtzung von Microsofts neuem kontextsensitiven HTML-Help
     HMP-Dateien als Ersatz fБr die Kommandozeile
     Hypermake auch als DOS Version verfБgbar
     Javascript Navigations-KnФpfe und ActiveX Fuсnoten
     automatisches Kopieren von Grafik-Dateien
     manuelle externe Querverweise und automatische externe Querverweise ins
      WWW fБr alle Zielformate auсer Winhelp3; Markierung von externen
      Querverweisen
     HTML Info-Datei
     verbesserte Einbindung von HTML-Befehlen


 DarБber hinaus wurden zahlreiche kleinere Fehler beseitigt.

 Neue Funktionen in Hypermake 3.0

     Tables (Tabellen-Funktion) sowohl fБr IPF als auch fБr HTML
     Benutzerdefinierte Navigations-KnФpfe (Buttons) in ErgДnzung zu back,
      forward, content, index, sie zeigen dann auf bestimmte Kapitel oder auf
      eine URL
     Benutzer head tags (insbes. Meta-Anweisungen), die in jede HTML-Datei
      kopiert werden
     genaue Steuerung der Groс/Kleinschreibung und 8.3 Schreibweise von
      Dateinamen
     benutzerdefinierte Einstellungen fБr die Titelzeile im HTML-Browser
     Kommandos zur Fehlersuche
     VerДnderung des Erscheinungsbildes von Querverweisen zu Unterkapitel
     flexiblere Anwendung der Umschaltzeichen (toggle chars)
     HTML Schriften (Fonts)
     Button-Bibliothek.


 Neue Funktionen in Hypermake 2.9

     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.


 Neue Funktionen in (alter Name) MakeIPF 2.0

     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
     Registrierung Бber Compuserve


ΓòÉΓòÉΓòÉ 11.5. Fehlerberichte ΓòÉΓòÉΓòÉ

     Alle Hypermake Versionen vor 3.94 stБrzen in Verbindung mit Windows NT 4
      ab Servicepack-Level 4 und Windows 2000 sofort ab.


 Weitere Fehler in 3.66 sind nicht dokumentiert, da sie nicht schwerwiegend
 sind. Die Fehler in der graphischen Beta-Version 3.9X sind dagegen so
 zahlreich gewesen, daс eine Dokumentation ebenfalls keinen Sinn macht. Ab 4.0
 wird wieder jeder gefundene Fehler dokumentiert.

 Die folgenden Fehler wurden in Hypermake 3.65 gefunden und in 3.66 beseitigt:

     3.65.01 (nur Win95/NT Version) Beim Doppelklick auf HMP-Dateien der
      Winhelp-Compiler nicht aufgerufen
     3.65.02 Bei Winhelp und .SL (sortierte Listen) wird bei einem
      hФherrangingen Listenpunkt der ZДhler fБr die niederrangingen
      Listenpunkte nicht zurБckgesetzt
     3.65.03 Bei Winhelp funktioniert die zentrierte Formatierung (.OC an/aus)
      nicht.


 Die folgenden Fehler wurden in Hypermake 3.60 gefunden und in 3.65 beseitigt:

     3.60.01: Wenn fБr Winhelp compiliert wird und der Text mit einer
      sortieren/unsortierten Liste endet, gibt es einen Fehler (mehr { als }
      Klammern).
     3.60.02: Fehler bei der Konvertierung von IPF nach Hypermake: Beim
      IPF-Befehl :h1. :h2. usw. mБssen mehr als zwei Zeichen dazwischen liegen.
      Wenn Sie nur zwei Zeichen haben (das ist eher selten), fuegen Sie noch
      ein Leerzeichen ein.
     3.60.04: mailto:emailadresse wird nicht zu einem Link.
     3.60.05. ASCIISOFTRET und Winhelp fБhrt zu fehlenden Leerzeichen im
      Flieсtext
     3.60.06. (ist gar kein Bug, sondern absichtlich wegen eines Fehlers im
      Winhelp-Compiler eingebaut) Endet eine CNT-Datei mit einem Hauptkapitel
      ohne Unterkapitel, wird fДlschlicherweise trotzdem ein "Allgemein"
      Kapitel eingefБgt.
     3.60.07. Bei Tabellen funktioniert das " Zeichen nicht in der ersten
      Tabellenspalte.


 FrБhere Fehler sind nicht dokumentiert.


ΓòÉΓòÉΓòÉ 11.6. Wo Updates? ΓòÉΓòÉΓòÉ

Wo Sie Hypermake finden

Am einfachsten ist es, sie schauen gelegentlich auf meine Homepage

http://www.hypermake.de

In Compuserve finden die Hypermake OS/2 Version in Compuserve IBMFORUM und die
Windows-Version im HYPERTEXT Forum.

Alle Versionen sind im Internet verfБgbar auf:
ftp://ftp.bmtmicro.com/bmtmicro

Namen der Archive:
OS/2-Version: hmakeos2.zip
Win95/98/ME/NT/2000/XP-Version: hmakewin.zip
DOS-Version: hmakedos.zip

Dateinamen mit Versionsnummern (z. B. hmake400.zip) beziehen sich meist auf die
Windows-Version.

Die DateigrФсen betragen derzeit bei der Windows-Version 1,75 MB, bei der
OS/2-Version 1,25 MB und bei der DOS-Version nur 300 kB, weil sie nur die
Kommandozeilenversion von Hypermake und keine vor-kompilierten Hilfetexte
enthДlt.


ΓòÉΓòÉΓòÉ 11.7. Warenzeichen ΓòÉΓòÉΓòÉ


IBM und OS/2 sind eingetragene Warenzeichen der International Business Machines
Corp.
WordStar ist eingetragenes Warenzeichen von The Learning Company.
SpeedPascal ist ein Warenzeichen von Speedsoft.
TurboPascal ist eingetragenes Warenzeichen von Borland Corp.
Windows ist eingetragenes Warenzeichen von Microsoft.


ΓòÉΓòÉΓòÉ 11.8. 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 von Speedsoft http://www.speedsoft-online.de Chemnitz,
einem TurboPascal/Delphi-kompatiblen OS/2-Compiler mit IDE. Er erzeugt sowohl
OS/2- als auch Win32-Programme. FБr die Zukunft ist noch Linux geplant, so daс
es auch fБr diese Plattformen Hypermake geben wird.

Die DOS-Version ist mit Turbo-Pascal erstellt und verwendet keinen erweiterten
Speicher. Dadurch ist der Quelltext, je nach Anzahl der Querverweise, auf 1 bis
4 MB beschrДnkt. Hypermake fБr DOS ist theoretisch sogar unter einem XT
lauffДhig. Deshalb sollte Hypermake unter Betriebssystemen, fБr die es einfache
DOS-Emulatoren gibt (z. B. Linux), einwandfrei lauffДhig sein. Der
Pentium-300-bug aller Turbo-Pascal Programme (Abbruch wegen zu hoher
Geschwindigkeit) ist nicht gefixt. Die graphische OberflДche wird es fБr DOS
nicht geben, dafБr wird die Kommandozeilenversion mit weiterentwickelt.


ΓòÉΓòÉΓòÉ 11.9. Andere Progs ΓòÉΓòÉΓòÉ


Ich habe noch einige kleinere Programme geschrieben. Alle Programme haben auch
deutsche Dokumentation. Alle Programme gibt es fБr OS/2 und
Win95/98/ME/NT/2000/XP. Linux-Versionen sind fБr die Zukunft geplant.

WSedit:
Der Hypermake-Editor als separates Freeware-Programm. Ein Wordstar-kompatibler
Editor, liest und schreibt Wordstar (DOS), ASCII IBM und ISO Zeichensatz.
UnterstБtzt neben gewФhnlichen CUA-Befehlen auch die Wordstar-Ctrl-Befehle.
Syntax-Highlightning, Ъbersetzung, WortprБfung, Funktionstasten als belegbare
Makrotasten und vieles mehr. Kann sehr lange Dateien lesen und schreiben.

pmCalc: ein graphischer Taschenrechner mit automatischer
ZwischenablagenunterstБtzung, Funktionen fБr Programmierer und
wissenschaftliche Funktionen, Regression. Es gibt ein separates Eingabe- und
Ausgabefeld, so daс eingetippte Formeln stehenbleiben (Shareware).

Textbuch:
Doppelte BuchfБhrung fБr SelbstДndige und kleine bis mittlere GmbH's. Mit
Inventarspiegel und integriertem Editor, ist von der BenutzerfБhrung her
Дhnlich wie Hypermake aufgebaut. Arbeitet wie ein Compiler. Input und Output
sind Textdateien. Umfangreiche Hypertext-Hilfedatei. Shareware bei > 350
BuchungssДtze.

cd-shortcut:
AbkБrzung fБr cd (change directory). statt vollstДndiger Verzeichnisnamen
werden Substrings eingegeben. Freeware.

TinyAlarm:
Kurzzeitwecker als 60-Minuten-Schieber oder Eingabe absoluter Weckzeit; Chime;
floatende Digitaluhr. Freeware.

Simple Zipshell:
ZIP-Dateien Бber die graphische OberflДche ein- und auspacken. Freeware.

Clear: (nur OS/2)
Datensicherungs- und  LФschprogramm. erstellt Textdatei- Dateilisten nach
diversen Kriterien arbeitet mit Info-Zip zusammen. Freeware

Auf meiner Homepage finden Sie Beschreibungen, Screenshots und Download-Links
der Programme.

http://www.hypermake.de

Ende des Hypertextes


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Das IPF Format (Information Presentation Facility) ist der Ausgangstext, um
INF- oder HLP-Dateien zu erstellen.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

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 Windows-Version ist
Bestandteil des IBM Visual Age C++ Entwicklungssystems. Der IPFC Compiler ist
nur ca. 200 kB groс.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

natБrlich ohne 0x0A, 0x0D, 0x1A (dezimal 10, 13, 26)


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Der IPFC Compiler wБrde eine Fehlermeldung erzeugen.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Laut c't 3/97 sollen 90% aller Surfer keine Scrollbars benutzen


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Um von GIF nach BMP zu konvertieren, bietet sich das Freeware-Tool GIF2BMP an
(Graham Welland, September 1989, OS/2 16 bit).


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Buchstaben a e i o u y


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Inhalt der Fuсnote


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Und zwar wegen einem Fehler im IPFC 2.0 Compiler. Die EintrДge im Index wБrden
ein ASCII-10-Zeichen am Ende erhalten.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Programmierer sollten RC-Dateien kennen; sonst kФnnen Sie dieses Kapitel
Бberspringen, da nur separate Hilfe-Dateien fБr Sie in Frage kommen.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Wenn Sie hinter DLGTEMPLATE und DIALOG die gleiche Konstante verwenden, ist das
schon in Ordnung.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

zu verwenden ist der Konstanten-Name, der in der RC-Datei hinter MENU oder
DIALOG steht


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Das kann Compiler-spezifisch sein; ich benutze Borland C


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Inhalt der Fuсnote


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

17


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Eine Ъbersicht von PDF Konvertern finden Sie im Heft c't 7/2002