═══ 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 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 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 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: Auсerdem werden grundsДtzlich alle StichwФrter aufgefБhrt, die im Hypermake-Quelltext auf dieser Seite markiert sind. 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: Hypermake 4.0 - Titel und Meta-Anweisungen Vor der 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: Martin@vr-transport.de 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