Single-Source-Publishing

Transkript

1 Sissi Closs Single-Source-Publishing Topicorientierte Strukturierung und DITA ntwickier.oress

2 Über die Autorin Vorwort 13 1 Ursprung und Hintergrund Markup-Sprachen: die bescheidenen Anfänge DTP: die erste Single-Source-Publishing-Welle 18 Die Gestaltung kostet viel 19 Ein Tool macht abhängig 20 Jedes Tool hat seine Grenzen Back to the Roots 20 Metasprache lässt Freiräume 21 Standardisierung gibt Sicherheit 23 Trennung von Inhalt und Darstellung macht flexibel 23 Formatierung ist nicht alles Die letzte Stufe: das Baukastenprinzip Irrungen und Wirrungen über Single-Source-Publishing Das Wichtigste aus Kapitel Einstieg in die topicorientierte Strukturierung Was ist ein Topic? Was sind Beziehungen zwischen Topics? Was ist ein Informationsgebilde? Welche Vorteile hat die topicorientierte Strukturierung? Weitere Beispiele Irrungen und Wirrungen über topicorientierte Strukturierung Das Wichtigste aus Kapitel Topics Was kennzeichnet ein Topic? Wie sind Topics entstanden? Darstellung von Topics 39 Darstellung von Topics bei der Konzeption 39 Darstellung von Topics bei der Erstellung 39 Darstellung von Topics bei der Nutzung Vorteile von Topics Irrungen und Wirrungen über Topics Das Wichtigste aus Kapitel 3 42 Single-Source-Publishing 5

3 4 Beziehungen Welche Beziehungen gibt es? 43 Aus der Papierwelt bekannte Beziehungen 43 Weitere Arten von Beziehungen in der elektronischen Welt Merkmale von Beziehungen 46 Kardinalität 46 Richtung Darstellung von Beziehungen 49 Darstellung von Beziehungen bei der Konzeption 49 Darstellung von Beziehungen bei der Erstellung 49 Darstellung von Beziehungen bei der Nutzung Links 50 Wie sind Links entstanden? 51 Darstellung von Links auf der Erstellungsseite 51 Darstellung von Links auf der Nutzungsseite 53 Bekannte Problempunkte Irrungen und Wirrungen über Beziehungen und Links Das Wichtigste aus Kapitel Informationsgebilde Was ist ein Informationsgebilde? Gedrucktes Dokument 62 Zusammengehörigkeit 62 Organisation 63 Orientierungs- und Zugangshilfen Hyperdokument 68 Hypermedia-Systeme 69 Wie entsteht ein Hyperdokument? 69 Wie wird ein Hyperdokument dargestellt? Was ist ein topicbasiertes Informationsgebilde? 76 Topic-Struktur wenig betont, aber vorhanden 76 Lopic-Struktur mehr betont, aber nicht immer vorhanden 77 Topic-Struktur für Single-Source-Umgebungen Besonderheiten von topicbasierten Informationsgebilden 80 Orientierungshilfen 80 Wiederverwendung 81 Schneller Zugang Darstellung von topicbasierten Informationsgebilden 85 Darstellung von topicbasierten Informationsgebilden bei der Konzeption 85 Darstellung von topicbasierten Informationsgebilden bei der Erstellung 87 Darstellung von topicbasierten Informationsgebilden bei der Nutzung Irrungen und Wirrungen über Informationsgebilde Das Wichtigste aus Kapitel 5 89 ntwickier

4 6 Modellieren und Standardisieren Modelle 91 Modelle für Informationsgebilde 91 Bisherige Modelle reichen nicht aus 92 Adäquate Modelle werden benötigt Das Beispiel vom Haushalt Standardisierung 95 Warum Standardisierung? 95 Welche Aufgaben fallen bei der Standardisierung an? 95 Worin besteht das Risiko? Klassifizierung 97 Was ist eine Klasse? 97 Wozu dienen Klassen? 98 Wie entsteht eine Klasse? Irrungen und Wirrungen über Modelle und Standards Das Wichtigste aus Kapitel Klassenkonzept Was ist die Klassenkonzept-Technik? 101 Minimalistischer Ansatz 101 Klassenbildung 102 Vorgehensmodell 103 Entstehung der Klassenkonzept-Technik Topic-Klasse 108 Darstellung einer Topic-Klasse 108 Standards für Topic-Klassen 109 Modularisierungstechnik 111 Entwicklung eines Klassenkonzepts für Topics Beziehungsklasse 120 Darstellung einer Beziehungsklasse 120 Standards für Beziehungsklassen 122 Grundregeln für die Festlegung von Beziehungen 124 Verfahren für die Ermittlung der Beziehungsklassen Informationsgebilde-Klasse 129 Darstellung einer Informationsgebilde-Klasse 129 Standards für Informationsgebilde-Klassen Vorteile des Klassenkonzepts 131 Vorteile für die Erstellungsseite 131 Vorteile für die Nutzungsseite 133 Keine Standardisierung um jeden Preis Irrungen und Wirrungen über das Klassenkonzept Das Wichtigste aus Kapitel Single-Source-Publishing 7

5 8 Topicorientiertes Single Sourcing einführen Mögliche Stolpersteine 137 Stolperstein Bereichsauswahl 137 Stolperstein Technik 138 Stolperstein Arbeitsorganisation Im vertrauten Umfeld starten 140 Strukturierung trainieren 140 Umsetzungsmöglichkeiten kennen lernen 145 Zusammenarbeit stärken Organisation vorbereiten Bereiche ausdehnen Passende technische Umsetzung wählen Irrungen und Wirrungen über die Einführung von topicorientiertem Single Sourcing Das Wichtigste aus Kapitel DITA Was ist DITA? Wie ist DITA entstanden? Was steht für DITA zur Verfügung? Was ist ein DITA-Topic? Topics kombinieren 157 Verschachtelung von Topics 157 Einbettung von Inhalten 158 DITA-Map Wie entsteht ein Informationsgebilde? DITA-Spezialisierung Warum lohnt es sich, auf DITA zu setzen? Irrungen und Wirrungen über DITA Das Wichtigste aus Kapitel DITA-Kurzreferenz Inhaltliche Zusammenstellung der DITA-Elemente 167 Allgemeine Topic-Elemente 167 Elemente für Konzept-Topics 168 Elemente für Referenz-Topics 168 Elemente für Aufgaben-Topics 169 Elemente für den Topic-Rumpf 170 Elemente für Tabellen 171 Elemente für typografische Auszeichnungen 171 Domänenspezifische Elemente 172 Elemente für Inhaltsergänzungen 175

6 Elemente für Metadaten 175 Elemente für Links auf verwandte Topics 177 Elemente für die Spezialisierung 177 Elemente für DITA-Maps Alphabetische Referenz 178 A Literaturverzeichnis 257 A.l Bücher und Zeitschriftenartikel 257 Standardwerke für Technische Dokumentation 257 Content-Management 259 Design und Modellierung 259 Metadaten 261 Strukturierung und Single Sourcing 261 XML ' 261 A.2 Internet-Quellen 262 A.3 Internet-Adressen für DITA 262 Stichwortverzeichnis 263 Single-Source-Publishing 9