************************************************************************** * Programmbeschreibung: * * * * INDEX PLUS * * * * Version 1.09 vom 19.10.1987 * * * * Autor: Clemens Weller * * Lerchenweg 7, 7165 Fichtenberg * * Tel. (07971) 6807 * * * ************************************************************************** Erstellung eines Seitenindex von einem 1st Word (Plus)-Dokument --------------------------------------------------------------- Die Hauptaufgabe des Programmes INDEX PLUS ist es, ein Seitenindex eines 1st Word (Plus)-Dokumentes zu erstellen und in eine Datei zu schreiben. Ein Seitenindex ist eine alphabetisch sortierte Liste von im Dokument vorkommenden W”rtern mit jeweils dem Verzeichnis, auf welchen Seiten dieses Wort vorkommt. In Bchern wird diese meist am Ende als "Stichwortverzeichnis" aufgefhrt. Beispiel: Ausschnitt aus einem Seitenindex ... Aufbau 2,4,9f,12-15,19 Aufmerksamkeit 13 Aufruf 1-3,12f Aufwand 16 Ausbaustufe 3,10 ... Aužer dem Seitenindex erstellt INDEX PLUS auch eine Liste aller im Dokument vorkommender Zeilenlineale und Grafiken (deshalb "PLUS"), und gibt die Seitenparameter sowie Dateil„nge an (siehe Beispiel weiter unten). Alle Daten werden in eine Textdatei geschrieben. Diese Datei kann anschliežend mit der Textverarbeitung "von Hand" nachgearbeitet und an das dazugeh”rige Dokument angeh„ngt oder eingefgt werden. Erstellung eines Lexikons ------------------------- Alternativ zum Seitenindex kann von INDEX PLUS ein Lexikon aller im Dokument vorkommender W”rter erstellt werden. Ein Lexikon ist eine Liste von W”rtern, die im Dokument vorkommen. Die Erstellung eines Lexikons ist auch bei Dokumenten m”glich, die nicht mit 1st Word (Plus) erstellt wurden. Damit k”nnen auch Tippfehler in einem Quellcode eines Programmes leicht gefunden werden. Eine weitere sinnvolle Anwendung des Lexikons ist die Untersttzung bei der halbautomatischen Rechtschreibkorrektur. Bekanntlich macht die Version 1.89 von 1st Word Plus Fehler bei "flexibel" getrennten W”rtern, die dadurch als zwei getrennte W”rter angesehen werden. Im Lexikon (und im Seitenindex) werden alle W”rter, die "flexibel" getrennt wurden, wieder zusammengefgt! Wird die Rechtschreibkorrektur von 1st Word Plus ber das Lexikon gefhrt, werden auch Fehler in flexibel getrennten W”rtern gefunden. INDEX PLUS eignet sich besonders fr: ------------------------------------- - alle, die umfangreiche Dokumente erstellen (Diplom-Arbeiten, Vereins- zeitungen, Bedienungsanleitungen ...) - alle, die umfangreiche Programme erstellen (Quellcode-Analyse ...) Die Filter: ----------- Sinnvollerweise soll nicht jedes Wort in den Seitenindex bzw. das Lexikon bernommen werden (z.B. der, die, das, ein ...). Deshalb muž jedes im Dokument vorkommende Wort eine Reihe von Filtern passieren. Diese sind: - Menge der zul„ssigen Zeichen: Hier kann eingestellt werden, ob beispielsweise Ziffern als Teile von W”rtern zul„ssig sind. - Menge der Anfangsbuchstaben: Meistens sind nur Substantive fr den Seitenindex interessant. Dann stellt man diesen Filter auf "nur grože Anfangsbuchstaben" ein. - Wortl„nge: Wird die minimale Wortl„nge auf "vier" gestellt, dann fallen u.a. die l„stigen "der", "die", "das" weg. - Attribute (geplant): Damit k”nnen beispielsweise nur unterstrichene W”rter in den Seiten- index aufgenommen werden. - Ausnahmelexikon (geplant): Trotz der hier aufgefhrten Filter muž der Seitenindex nachtr„glich noch von Hand bearbeitet werden, da immer noch W”rter brigbleiben, die nicht in den Seitenindex aufgenommen werden sollen, z.B. "Absender". Im Ausnahmelexikon k”nnen solche W”rter zusammengefažt werden und werden dann nicht in den Seitenindex bernommen. Die Standardeinstellungen der Filter sind: Menge der Zeichen: Alle Buchstaben inkl. deutsche Sonderzeichen sowie der Bindestrich "-". Menge der Anfangsbuchstaben: Nur grože Buchstaben Wortl„nge: Mindestens 3, maximal 99 Zeichen Weitere M”glichkeiten (geplant): -------------------------------- Zeilenindex (geplant): Der Zeilenindex ist im Prinzip das gleiche wie ein Seitenindex, mit dem Unterschied, daž hier eine Liste erstellt wird, in welcher Zeile das jeweilige Wort vorkommt. Der Zeilenindex l„žt sich auch von ASCII-Dateien erstellen. Damit erh„lt man eine hervorragende Unter- sttzung bei der Programm-Entwicklung: Im Zeilenindex eines Quellco- des lassen sich Tippfehler bei Variablennamen schnell aufspren. Inhaltsverzeichnis (geplant): Bei dieser Option wird ein nach Seitenzahlen sortiertes Inhaltsver- zeichnis angelegt. Die einzelnen Kapitel werden automatisch daran erkannt, daž deren šberschriften dezimal gegliedert sind. Mehrspaltiger Ausdruck und Microprint (geplant): 1st Word (Plus) kann leider nicht ohne weiteres Mehrspaltendruck durchfhren, geschweige denn die Seitenzahlen dann noch richtig verarbeiten. Deshalb ist ein Mehrspaltendruck direkt aus INDEX PLUS fr Seitenindex oder Lexikon vorgesehen. Zur Platzeinsparung kann der Ausdruck fr Epson- und kompatible Drucker (ESC-P Code) in Kleinschrift erfolgen. Die Bedienung von INDEX PLUS: ----------------------------- INDEX PLUS ist in eine grafische Benutzeroberfl„che eingebunden. Die Bedienung erfolgt mit der Maus ber "Drop Down"-Mens und "Alert"-Boxen. Das Programm verlangt mindestens die Angaben: - Datei, die analysiert werden soll (ber Fileselector-Box) - Betriebsart: Seitenindex oder Lexikon (ber Pull Down-Men) - Datei, in welche Seitenindex oder Lexikon geschrieben werden soll (ber Fileselector-Box) Danach kann die Analyse mit "Start" (ber Pull Down-Men) gestartet werden. Ein Abbruch ist durch gleichzeitiges Bet„tigen der Tasten Control, Shift und Alternate m”glich. Die bis dahin eingelesenen W”rter werden allerdings noch fertig bearbeitet. Widersprchliche Anweisungen werden erkannt, z.B. wenn von einer ASCII- Datei ein Seiten-Index erstellt werden soll. Die Filterparameter k”nnen w„hrend der Analyse eines Dokumentes ver„ndert werden, was normalerweise aber keinen Sinn ergibt. Alle Meldungen von INDEX PLUS werden deutschem Klartext ber ein Info- Fenster sowie ber "Alert"-Boxen angezeigt und teilweise akustisch hervor- gehoben. Systemmeldungen geben verfgbaren Speicherplatz im Speicher des Rech- ners sowie auf der Diskette an. Anmerkung: Mit der Bedienungsfreundlichkeit der aktuellen Version 1.09 bin ich nicht ganz zufrieden. Die Einstellung der Parameter ber Drop Down- Mens ist umst„ndlich; einfacher ginge es durch direktes Anklicken auf dem Bildschirm. Bei Gelegenheit werde ich die Benutzeroberfl„che zuknftige Versionen berarbeiten. Kapazit„t: ---------- Datei: Gr”že nur durch Speicherplatz des Rechners begrenzt. W”rter: Maximal 20000 W”rter nach der Filterung. Dies reicht normalerweise fr Dateien mit ber 200 kB L„nge. Zeilenlineale: Maximal 1000 Grafiken: Maximal 100 Seitenzahlen: Unbegrenzt. Ein Wort darf allerdings nur auf maximal 500 verschiedenen Seiten gleichzeitig vorkommen. Diese Kapazit„t drfte fr die Praxis ausreichen. Geschwindigkeit: ---------------- Der Algorithmus des Programmes wurde auf maximale Geschwindigkeit opti- miert (schnelle Sortierroutinen, z.T. Verzicht auf Schleifenstrukturen, ...). Die Compilierung erfolgte in GFA-Basic V.2.0. Die Erstellung eines Seitenindex eines umfangreichen Dokumentes mit 65 kByte Dateil„nge und etwa 6000 verschiedenen W”rtern, die in den Seitenindex aufgenommen werden, dauert etwa 5 Minuten. Fehler, Einschr„nkungen: ------------------------ Accessories k”nnen zwar aufgerufen werden, allerdings wird der Bild- schirm anschliežend nicht wieder restauriert (die Fenster im Programm sind keine GEM-Fenster). Die Sortierroutine arbeitet auf der Grundlage des Atari-Zeichensatzes. Die deutschen Umlaute werden also nicht entsprechend der Norm (wie z.B. im Telefonbuch) sortiert. 1st Word (Plus) macht diesen Fehler brigens auch. Das Programm mžte auf allen ST-Rechnern und allen Monitoren lauff„hig sein. Entwickelt wurde es auf einem 1040 STF mit SM124. Wer weitere Fehler oder Unstimmigkeiten feststellt, sollte diese mir beschreiben. Copyright, Quellcode und Updates: --------------------------------- INDEX PLUS V. 1.09 ist frei kopierbar. Dabei drfen keine Žnderungen an den zwei Dateien INDEX_PL.PRG und READ_ME.TXT vorgenommen werden und diese nur mit dem Ordner INDEX__PLUS kopiert werden. Ein Vertrieb oder die Anwendung von INDEX PLUS zum Zweck der Gewinner- zielung ist untersagt. Die Aufnahme in Public Domain-Sammlungen, die als solche gekennzeichnet sind, ist erlaubt und erwnscht. Die Freigabe bezieht sich nicht auf den Quellcode des Programmes. Wer daran ernsthaft interessiert ist, m”ge sich mit mir in Verbindung setzen. Selbstverst„ndlich darf jeder, dem von INDEX PLUS eine Menge Arbeit abgenommen wurde, mir ein finanzielles Dankesch”n zukommen lassen: Kto. Nr. 1820 001 bei der Raiffeisenbank Rot Kocher eG, Blz 600 694 70. Stichwort: INDEX PLUS Version 1.09. Bei Spenden ab 20.- DM wird automa- tisch ein Update zugesandt, deshalb Absender leserlich (!) schreiben. Beispiel: Ausschnitte aus einem Seitenindex: -------------------------------------------- Seitenindex fr Datei: \BROSCHUE.RE\COMP_OV4.DOC Format: WP Dateil„nge: 67749 Byte Seitenformat: Papierl„nge: 72 Seitenl„nge: 60 Oberer Rand: 5 Rand Kopfzeile: 2 Rand Fužzeile: 2 Unterer Rand: 3 Kopf L: Kopf M: Kopf R: Fuž L: Fuž M: Fuž R: Seite # Abbildung 7f,10,12-17,23 Abgesehen 3 Absatz 17 Absender 5,44 Abstand 28 ... Zusagen 4 Zuschuž 40 Zeilenlineale: 45 1 PICA : [.......................................] 2 BREIT :[..............................] 2 PICA :[............................................................] ... 44 PICA :[...................................................] 44 PICA : [................................................] Bilder: 5 4 CLE2.IMG 20 ATTRIBU2.IMG 30 SPD_OVZ1.IMG 30 VIDEO_DI.GIT\BW3.IMG 31 SPD_ROSE.IMG __________________________________________________________________________ Antwortschein (ausdrucken, ausfllen und einsenden): ---------------------------------------------------- An Clemens Weller Lerchenweg 7 7165 Fichtenberg Absender Name ........................................................... Straže, Nr. ........................................................... Plz, Ort ........................................................... Telefon ........................................................... Datum: .............. O Ich m”chte informiert werden, wenn eine neue Version, die in wesentlichen Punkten zur Version 1.09 erweitert wurde, erscheint. 1.- DM in Briefmarken (bitte 2 x 0.50.- DM) habe ich beigelegt. O Ich bin am Quellcode in GFA-Basic interessiert und bitte um Kontaktaufnahme. Meine Telefonnummer habe ich oben angegeben. O Vorschl„ge, Kritik, Meinungen, Fehler zu INDEX PLUS V.1.09 ............................................................ ............................................................ ............................................................ ............................................................ ............................................................ ............................................................ ............................................................ ............................................................ ............................................................ ............................................................ ............................................................ ............................................................ ............................................................ ............................................................ ............................................................