Eiffelturm

Zur Generierung einer Windows-Hilfe gibt es inzwischen bessere Werkzeuge — die aber auch ein deutlich großes Preisschild haben. Während wir die Transcom Tools inzwischen zur Hilfegenerierung nicht mehr einsetzen, können sie für ein kleines Software-Projekt vielleicht noch nützlich sein. Die Transcom Tools folgen der Methode Transcom: Eine Quelle, verschiedene Publikationsformate. Darum erlauben die Transcom Tools, dass in WinWord fast so gearbeitet wird, als würde ein ganz normales, druckbares Buch erstellt (mit Kopf-/Fußzeilen, Inhaltsverzeichnis, Bildern, Kapiteln und Abschnitten etc. pp. — dass dann auch tatsächlich als Handbuch gedruckt werden kann). Aus der so erstellten Datei wird von den Transcom Tools die RTF-Quelldatei für den Help Compiler generiert. Generiert wird allerdings nur der Code für den Microsoft Help Compiler 4, der wiederum nur die seit Windows 3.x bekannten WinHelp-Dateien produziert, keine HTML-Help.

Zu den Transcom Tools gehört außerdem eine Funktion, die WinWord um bedingten Text erweitert. Damit kann z.B. Text ein-/ausgeblendet werden, der nur im Handbuch oder nur in der Hilfe erscheinen soll. Auch können damit Varianten verwaltet werden (wenn beispielsweise bestimmte Passagen nur für Produkt A, andere nur für Produkt B gelten).

Schließlich nutzen wir die Transcom Tools noch immer gelegentlich, um alle Überschriften einer Datei automatisch mit manuell gesetzten Textmarken zu versehen. Diese werden für Querverweise benötigt: Werden Querverweise einfach auf eine Überschrift gesetzt, erstellt WinWord interne Textmarken, die es auch ganz gerne mal vergisst. Werden Querverweise hingegen auf manuelle Textmarken gesetzt, bleiben diese erhalten — selbst wenn die Datei mal auseinander gerissen und später wieder zusammengesetzt wurde. Die Funktion zum automatischen Setzen manueller Textmarken kann beliebig oft angewendet werden: Einmal berücksichtigte Überschriften werden nicht erneut markiert. (Hinweis vom Februar 2005: Wer die Transcom Tools nur wegen dieser Funktion nutzt, ist mit dem PDF-T-Maker besser bedient, in den diese Funktion ebenfalls integriert wurde.)

Eine kleine Erleichterung sind die Transcom Tools noch bei der Zuweisung von Indexeinträgen und dem manuellen Setzen von Textmarken: Schaltflächen in einer Symbolleiste reduzieren die Zahl der jeweils notwendigen Mausklicks. (Hinweis vom Februar 2005: Wer die Transcom Tools nur wegen dieser Funktion nutzt, ist mit dem PDF-T-Maker besser bedient, in den diese Funktion in verbesserter Form ebenfalls integriert wurde.)

Zu den Transcom Tools gehört nebenbei noch ein umfängliches Handbuch, das auch Grundlagen der sauberen Arbeit in WinWord (bzw. mit Textverarbeitungsprogrammen allgemein) und der WinHelp vermittelt.

Die Transcom Tools unterstehen ab sofort der GNU General Public Licence (GPL). Sie funktionieren unter Microsoft Word 97 und 2000 (getestet), sollten aber auch unter jeder höheren Version problemlos arbeiten. Eine Weiterentwicklung ist nicht mehr geplant.
Klicken Sie hier zum Download der Transcom Tools.

Für die Kompilierung der Hilfe wird zusätzlich der Microsoft Help Compiler HCW benötigt.

Methode Transcom

Methode Transcom: Eine Quelle, viele Publikationsformate

Wer mit einem Produkt jährlich Umsätze von zig Millionen macht, kann in eine hochwertige Online-Hilfe investieren, die komplett medienspezifisch aufbereitet ist. Für die Mehrheit der Software-Produkte wäre eine solche Online-Hilfe jedoch der Produktkiller auf dem Markt: Niemand würde dies bezahlen. Also gehen wir davon aus, dass Handbücher und sonstige technische Dokumentation so erstellt wird, dass sie mit geringstem Aufwand in verschiedene Publikationsformate konvertiert werden kann, die den Bedingungen des jeweiligen Formats so gut wie möglich angepasst sind. Angepasst wird dabei vor allem das Layout, die Inhalte sind in allen Medien weitgehend identisch. Voraussetzung dazu ist die Trennung von Layout und Inhalt (so wie wir es auch bei dieser Website machen, siehe phpCMS — zur Technik dieser Website. Und natürlich wird der Zugriff dem jeweiligen Medium angepasst: Das Stichwortverzeichnis im Buch wird zum Index der Hilfe, für den kontextsensitiven Zugriff auf die Online-Hilfe aus dem Programm heraus werden schon während der Erarbeitung der Quelle alle notwendigen Informationen eingefügt.

---

InvitationWare

• Invitation (Englisch): Einladung
• Invitation for tender: Ausschreibung

Die Informationen auf www.transcom.de sind InvitationWare: Einerseits sind Sie eingeladen, sie zu nutzen. Andererseits, wenn die Informationen auf diesen Seiten Ihnen geholfen haben oder die Tipps und Programme für Sie nützlich sind, dann erinnern Sie sich doch an Transcom, wenn Sie mal wieder einen Auftrag in einem unserer Fachgebiete zu vergeben haben — und senden uns eine Einladung zum Angebot. Rufen Sie uns an oder senden uns eine E-Mail.