Linking-Management in DITA tekom 2015, Stuttgart Magda Caloian @thinkdita magda.caloian@pantopix.de PANTOPIX GmbH&Co. KG
Magda Caloian Information Architect Beraterin DITA Trainerin Technische Redakteurin (tekom) Projektmanagement (MSc) think-dita.com @thinkdita Magda Caloian, tekom 2015, Stuttgart 2
PANTOPIX Semantische Datenmodelle Taxonomie Auswahl & Implementierung von Informationssystemen Schulungen & Coaching www.pantopix.de magda.caloian@pantopix.de Magda Caloian, tekom 2015, Stuttgart 3
Fahrplan Warum Infos verlinken? Link-Mechanismen in DITA Magda Caloian, tekom 2015, Stuttgart 4
Technische Doku Prozess Magda Caloian, tekom 2015, Stuttgart 5
Technische Doku Prozess - verbessert Magda Caloian, tekom 2015, Stuttgart 6
Führen Sie die Anwender, in Zeiten der Vernetzung der Welt Magda Caloian, tekom 2015, Stuttgart 7
Benutzerorientierte, strukturierte Topics fokussieren auf reale Nutzer-Ziele enthalten nur die notwendigen Daten konzentrieren sich auf einen Info-Typ können allein stehen werden wiederverwendet, abgerufen und verlinkt Magda Caloian, tekom 2015, Stuttgart 8
Topics: Die Bausteine zum Wiederverwenden DITA = Darwin Information Typing Architecture Magda Caloian, tekom 2015, Stuttgart 9
Informationen finden: - organisiert - abrufbar - visuell effektiv Informationen verstehen: - klar - konkret - schreibstilgerecht Informationen anwenden: - aufgabenorientiert - korrekt - komplett Qualitätskriterien der technischen Dokumentation Magda Caloian, tekom 2015, Stuttgart 10
Ditamaps XML-Dateien, die DITA-Topics organisieren: Die Bausteine des Info-Sets bestimmen Die Informationsarchitektur Die Verlinkungen zwischen den Inhalten (die Hierarchie, Gruppen, Reltables) Magda Caloian, tekom 2015, Stuttgart 11
Hierarchische Links Durch Schachtelung der Topics Magda Caloian, tekom 2015, Stuttgart 12
Tipps Szenario-Parameter, um die Verlinkungen in den Publikationen zu steuern: args.hide.parentlink args.rellinks args.chapter.layout Magda Caloian, tekom 2015, Stuttgart 13
Topic-Kollektionen Choice-unordered (Aufzählung) Family (Verwandte) Sequence (Nummerierung) Required (erforderliche Aufgabe) Parameter: args.rellinks Magda Caloian, tekom 2015, Stuttgart 14
Choice (Aufzählung) Magda Caloian, tekom 2015, Stuttgart 15
Family (Verwandte) Magda Caloian, tekom 2015, Stuttgart 16
Attribut collection-type Magda Caloian, tekom 2015, Stuttgart 17
Sequence (Nummerierung) required Magda Caloian, tekom 2015, Stuttgart 18
Sequence Magda Caloian, tekom 2015, Stuttgart 19
Reltable (Verwandschaftstabellen) Zweispaltig, bidirektional Richtung der Links (@linking ) Kollektionen Magda Caloian, tekom 2015, Stuttgart 20
Magda Caloian, tekom 2015, Stuttgart 21
Magda Caloian, tekom 2015, Stuttgart 22
Tipps Konfiguration des OT-Plugins für Layout Einstellen der Sprachvariablen in OT Anwendung von Keys in Reltable Metadaten in Maps anpassen, @locktitle Non-DITA Inhalte mit @format und @scope eintragen Anpassen von Szenario-Parameter, z.b. für Kollektionen Magda Caloian, tekom 2015, Stuttgart 23
Verlinkung auf Element-Ebene Nicht zu empfehlen, aber auch in DITA machbar. Verweisen auf: Grafiken Tabellen Schritte Verweisen auf externe Daten: html pdf code email Magda Caloian, tekom 2015, Stuttgart 24
Auf Grafiken verweisen Publikation: Quelle: oder mit Key: Magda Caloian, tekom 2015, Stuttgart 25
Auf Tabellen verweisen Publikation: Quelle: Magda Caloian, tekom 2015, Stuttgart 26
Auf Schritte verweisen Publikation: Quelle: Magda Caloian, tekom 2015, Stuttgart 27
Auf externen HTML-Seiten verweisen Publikation: Topic-Quelle: Key-Definition: Magda Caloian, tekom 2015, Stuttgart 28
Auf E-Mail-Addressen verweisen Publikation: Topic-Quelle: Key-Definition: Magda Caloian, tekom 2015, Stuttgart 29
Tipps Wenige in-line Links Keine <related-links> in Topics Keys anwenden Namenskonventionen Parameter in Szenarien args.figurelink.style args.tabellink.style OT-Plugin Spezifikationen OT-Sprachvariablen lokalisieren Magda Caloian, tekom 2015, Stuttgart 30
Dynamic Delivery Portal Fluid Topics Magda Caloian, tekom 2015, Stuttgart 31
Dynamic Delivery Portal - Titania Magda Caloian, tekom 2015, Stuttgart 32
Subject-Scheme-Maps Voraussetzungen: Taxonomie Klassifizierungsmaps Skript Anwendung: Dynamic Delivery Faceted Search Conditional Profiling Magda Caloian, tekom 2015, Stuttgart 33
Classification Map Magda Caloian, tekom 2015, Stuttgart 34
Ihre Meinung ist uns wichtig! Sagen Sie uns bitte, wie Ihnen der Vortrag gefallen hat. Wir freuen uns auf Ihr Feedback per Smartphone oder Tablet unter http://in37.honestly.de oder scannen Sie den QR-Code Das Bewertungstool steht Ihnen auch noch nach der Tagung zur Verfügung! Magda Caloian @thinkdita magda.caloian@pantopix.de PANTOPIX GmbH&Co. KG