Publishing bezeichnet die Erstellung der Ausgaben aus den Projektquellen. Dabei führt Help+Manual die Topics, eingebundenen Snippets, Variablen und weiteren Bestandteile zusammen und erzeugt daraus das gewählte Ausgabeformat. Dieselben Quellen lassen sich so für unterschiedliche Formen der Bereitstellung verwenden.
Für die MAS-Umgebung sind insbesondere WebHelp und PDF von Bedeutung. WebHelp ermöglicht das Lesen im Browser und erschliesst die Inhalte über Navigation, Suche und Verlinkungen. PDF bietet eine zusammenhängende Dokumentfassung mit festem Seitenlayout, die heruntergeladen, weitergegeben und gedruckt werden kann.
Die Veröffentlichung wird über den Dialog Publish vorbereitet. Dort werden das Ausgabeformat, der Ausgabeort und die passende Vorlage ausgewählt. Bei WebHelp steuert ein Skin das Erscheinungsbild und die Bedienoberfläche. Für PDF bestimmt eine Druckvorlage unter anderem das Titelblatt, die Seitenaufteilung sowie Kopf- und Fusszeilen. Damit können die Inhalte unabhängig von der Gestaltung der jeweiligen Ausgabe gepflegt werden.
Abbildung 32: Ausgabeformate von Help+Manual.
Quelle: Eigener Screenshot.
Der praktische Ablauf umfasst folgende Schritte:
1.Projekt vorbereiten: Änderungen speichern und kontrollieren, ob die vorgesehenen Inhalte, Verweise und Projektangaben vollständig sind.
2.Ausgabe erzeugen: Ausgabeformat, Vorlage und Zielverzeichnis festlegen und die Erstellung starten. Meldungen des Autorensystems prüfen.
3.Ergebnis kontrollieren: Die erzeugte Ausgabe öffnen und insbesondere Inhaltsverzeichnis, Abbildungen, Tabellen, Quellenverweise und interne Links prüfen. Bei WebHelp kommen Navigation und Suche hinzu, bei PDF Seitenumbrüche und Seitenzahlen.
4.Ausgabe bereitstellen: Die erzeugten WebHelp-Dateien auf den Webserver übertragen beziehungsweise die geprüfte PDF-Datei zum Download anbieten. Anschliessend den Zugriff über die öffentliche Adresse (URL) kontrollieren.
Korrekturen an den Inhalten erfolgen in den Projektquellen. Danach werden die betroffenen Ausgaben erneut erzeugt und geprüft. Direkte Änderungen an den veröffentlichten Dateien würden bei der nächsten Erstellung überschrieben und sollten deshalb vermieden werden.
Single-Source-Publishing reduziert damit die mehrfache Pflege derselben Inhalte. Die Prüfung der einzelnen Ausgaben bleibt erforderlich, da sich Seitenlayout, Navigation und Darstellung je nach Format unterscheiden.
Hinweis: Auf dem Webportal der Masterarbeit https://e2020.esciotools.ch stehen die Arbeiten zum Online-Lesen sowie in verschiedenen Formaten zum Download zur Verfügung. Dort finden sich auch Hinweise zu den Formaten und den benötigten Leseprogrammen.
