Single-Source-Publishing (SSP): Dies können Sie auf verschiedene Weise erreichen:
(A) OFFIZIELLES SSP - ein Content Management System (CMS)
(B) SSP-Ansatz – mit z.B. All-In-One-Dokumenten und Illustrationen
(A) OFFIZIELLES SSP - ein Content Management System (CMS)
(A1) Das Prinzip der SSP
Content Management: Es geht darum, den Überblick über riesige Informationsmengen zu behalten.
Hier ist Single-Source Publishing (SSP) unerlässlich:
Single-Source-Publishing: Jedes THEMA (z. B. Bild, Absatz im Dokument, Tabelle) an einem Ort gespeichert)
Die Vorteile liegen auf der Hand, es gibt jedoch auch Herausforderungen:
Sie können MS Word nicht verwenden, sondern müssen für alle, die Dokumentationen verarbeiten müssen, in SSP-Software investieren.
Die thematische Unterteilung des gesamten Quellenmaterials ist schwierig:
Kein Problem mit Kapitel 1: Allgemeine Sicherheit. Sie können es in allen Anleitungen wiederverwenden.
Wenn Sie beispielsweise drei Produktvarianten haben, können Sie in Kapitel 2: Produktbeschreibung oft vieles wiederverwenden. Für die Funktionen, die nicht in allen drei Varianten zu finden sind, generieren Sie jedoch produktspezifische Themen.
(A2) Lizenzbasierte SSP-Software
Drei der bekanntesten sind:
1. Adobe FrameMaker, DESKTOP-basiert, eingeführt 1986
2. Madcap Flare: Sowohl DESKTOP als auch CLOUD möglich
3. Paligo: CLOUD-basiertes Komponenten-CMS (CCMS)
(A3) Adobe FrameMaker: Desktop – Strukturiert (XML)/ Unstrukturiert
Structured FrameMaker (die XML-basierte Version) eignet sich besonders gut für Single Source Publishing (SSP), da es darauf ausgelegt ist, Inhalte (Quellthemen) von der Präsentation (Publikationen) zu trennen und die Wiederverwendung zu unterstützen. Die Aufteilung in Themen folgt dem DITA-Standard.
DITA steht für Darwin Information Typing Architecture und ist ein offener Standard (entwickelt von OASIS) für strukturierte, themenbasierte technische Dokumentation.
Unstructured FrameMaker kann zwar weiterhin für technische Dokumente verwendet werden, verfügt aber nicht über die integrierte SSP-Logik mit Wiederverwendung und automatischer Mehrkanalveröffentlichung.
Weitere Informationen zu FrameMaker finden Sie auf der Website von Adobe.
(A4) Madcap Flare: XML - DESKTOP- oder CLOUD-basiert
MadCap Flare-Benutzer ein eigenes XML-basiertes Inhaltsformat anstelle von DITA.
Die wichtigsten Elemente sind:
Flare-Themen (.htm) – jedes Thema ist eine eigenständige XML/HTML-Datei mit Metadaten und eingebetteten Variablen/Bedingungen.
Snippets (.flsnp) – kleine wiederverwendbare Textstücke, die in mehrere Themen eingefügt werden können.
Variablen und Bedingungen – verwaltet Produktvarianten, Sprachen und Versionsunterschiede.
Projektdatei (.flprj) – behält den Überblick über die Struktur, Vorlagen, Skins und Ausgabeziele des gesamten Projekts.
Masterseiten und Stylesheets (CSS) – trennt Layout/Präsentation vom Inhalt.
MadCap Flare ist verfügbar als DesktopSoftware, sondern auch in einem Hybrid/Cloud-Ausführung: „Flare Online“. MadCap Software+3MadCap Software+3MadCap Software+3
Klassischer Schlag ist desktopbasiert und wird lokal auf dem Computer zum Erstellen, Veröffentlichen usw. verwendet. MadCap Software+1
Flackern Sie online: CCloud-Komponente/Plattform ermöglicht Zusammenarbeit, Versionierung, Hosting usw. in der Cloud.
MadCap Software+2MadCap Software+2
Flare + Flare Online Offline-Fähigkeiten mit Cloud-Funktionalitäten: Sie können sowohl online als auch lokal arbeiten. MadCap Software+1
(A5) Paligo: CLOUD-basiertes Component Content Management System (CCMS)
Paligo ist in erster Linie ein Cloud-basiertes CCMS (siehe unten). Paligo+2Paligo+2
Das heißt:
Ihre Inhalte werden über die Cloud gehostet und verwaltet und die Benutzer melden sich über einen Webbrowser an. Paligo+2TechWhirl+22.
Es ist für die Zusammenarbeit, Versionierung, den Workflow usw. direkt online konzipiert. Paligo+2TechWhirl+2
(A6) Komponenten-Content-Management-System (CCMS)
Dies ermöglicht eine feinere Unterteilung in Themen (kleine Komponenten):
Sie können die einzelnen Komponenten Repositories und Versionskontrolle.
Starker Fokus auf Single-SourceVeröffentlichung, Versionierung, Übersetzung.
(B) SSP-Ansatz – mit z.B. All-In-One-Dokumenten und Illustrationen
(B1) Mikrofon-Kalibrierungssystem:
All-In-One-Dokument: Broschüre, Datenblatt, Anleitung
(B2) Seite 1 ist ein Datenblatt/eine Broschüre:
Erste Seite: Broschüre - die anderen Seiten sind Anleitungen
(B3) Prozessdiagramm – wie es während der Softwareinstallation zu sehen ist
Ich gehe hier das gesamte Datenblatt durch. Die folgende Abbildung ist die einzige, die für Single-Source Publishing (SSP) NICHT relevant ist:
Prozessdiagramm: IInspiriert von der Softwareinstallation:, bei der Sie ebenfalls vier Schritte durchlaufen:
1. Willkommen → 2. Lizenz → 3. Installation → 4. Fertig
(B4) Zwei All-In-One-Illustrationen: Mit vier „Rollen“
All-in-One-Illustration Nr. 1: Dient als: 1. Teileliste (außer Kabel), 2. Funktionsdiagramm (Ablaufdiagramm), 3. Installationsanleitung, 4. Einrichtung für Steuerung/Test
(B5) Letzter Schritt im Prozess
All-In-One-Abbildung Nr. 2 – vollständig parallel zur vorherigen Abbildung
