23. Juni 2023 | Regionalgruppe Süd-Niedersachsen

Modulare Dokumentation mit FrameMaker und DITA

Veranstaltungsinformationen | Anmeldung

Adobe FrameMaker ist allgemein als gutes DTP-Programm bekannt. Und es ist ein hervorragender XML-Editor. 
Es ist möglich, im Programm XML-Daten wie in einem simplen XML-Editor auf Textbasis zu erstellen, gleichzeitig diese XML-basierten Inhalte mit den DTP-Eigenschaften des Programms zu kombinieren und im Seitenlayout formatiert darzustellen.

Damit eine konkrete XML-Struktur im Seitenlayout dargestellt werden kann, wird eine sogenannte "FrameMaker-XML-Anwendung" benötigt.
Mit der Standard-Installation des Programms wird eine umfangreiche Auswahl an XML-Anwendungen zur Verfügung gestellt, die direkt genutzt werden können. 
Zusätzlich können XML-Anwendungen auch für eigene XML-Struktur-Definitionen (DTD) erstellt werden. 
Mit mehreren Versionen von DITA-Strukturen stehen einige Standardanwendungen zum sofortigen Einsatz zur Verfügung.

Die Auswahl einer XML-Struktur ist allerdings nur eine Hälfte bei der Umsetzung von modularer Dokumentation. Die zweite Hälfte wird maßgeblich durch eine geeignete Ablagestruktur bestimmt, durch die Festlegung von Metadaten und Dateinamenskonventionen, damit die Daten nicht in einem Redaktionssystem, sondern im Dateisystem abgelegt werden.

Folgende Meilensteine werden wir anhand von Beispieldaten erreichen:

1. Kurze Einführung in FrameMaker als XML-Editor und Vorstellung des genutzten Layouts
2. Best Practice beim Aufbau einer Ablagestruktur im Ordnersystem, die sich für einen mehrsprachigen, modularen Aufbau bewährt hat
3. Metadaten und Dateinamenskonventionen - warum Fleißarbeit Zeit und Nerven spart sowie Fehler reduziert
4. Ein Beispiel-Handbuch-Dokument in Module aufteilen und in FM+DITA strukturiert erfassen
5. Die Module zu DITA-maps zusammenfügen und als PDF ausgeben 
6. Ausblick, wie der Übersetzungsprozess funktioniert 
7. Fragen, die noch nicht beantwortet wurden

Im Workshop wird abwechselnd Wissen vermittelt, werden Lösungen konzipiert und direkt umgesetzt. Fragen sind jederzeit erwünscht.
Sie erhalten zu Beginn ein Paket mit benötigten Dateien. 

In der Hochschule stehen uns Rechner mit Adobe FrameMaker (2019) zur Verfügung. Wenn Sie einen eigenen Laptop mitbringen wollen, sollte auf diesm FM 2019 (oder neuere Versionen) installiert sein.

Die Anzahl der Teilnehmenden ist begrenzt.