Bedingtes Publizieren mit DITA

Heinz Wittenbrink

2018-03-17

Ziel heute:

Praktische Erfahrung mit grundlegenden DITA-Dokumenttypen und ihrem Zusammenspiel

Was wissen wir über DITA?

  • Topicbasiert
  • Vielfältiger Output
  • Vererbung und Spezialisierung
  • Conditional Publishing

Beispiel heute:

Using Framemaker 2015 and ditaval to publish maps for specific audience/Product/Platform -YouTube

Topics

Concepts

Tasks

References

Maps

ditaval

Bedingtes Verarbeiten

  • ditaval-Dateien enthalten Profile für die bedingte Verarbeitung
  • Filtern: bestimmen, welche Inhalte in eine Publikation aufgenommen werden
  • Flaggen/kennzeichnen: Bestimmte Elemente im Output hervorheben
  • ditaval-Dateien arbeiten mit Attributen der Inhalte

.ditaval file sample

<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<val>
  <prop att="audience" val="foo" action="include" />
  <prop att="audience" val="bar" action="exclude" />
</val>
</source>

Attribute

  • audience: bestimmt die Zielgruppe
  • platform: bestimmt die Software oder Harware-Plattform
  • importance: bestimmt die Wichtigkeit einer Information
  • product: bestimmt Produkt oder Produktversion

(Quelle: data2type GmbH: DITA | Topics von Inhalten erstellen)

Weitere Attribute

  • rev: bestimmt Änderungszustände
  • otherprops: für Sitituationen, in denen die vorhandenen Attribute nicht ausreichen.
  • status: bestimmt den Status eines Elements
  • props: generisches Attribut für die Spezialisierung

(Quelle: data2type GmbH: DITA | Topics von Inhalten erstellen)

content reference als Alternative

  • Bedingte Verarbeitung kann zu übergroßer Komplexität führen
  • content references (conref) wiederholen Inhalte in unterschiedlichen Kontexten

Siehe: Bellamy, Carey, and Schlotfeldt (2012)

Reflexion über XML

  • Semistrukturierte Daten
  • Content-Modellierung
  • Strukturiertes Authoring

Aufgabe

Literatur:

Bellamy, Laura, Michelle Carey, and Jenifer Schlotfeldt. 2012. DITA Best Practices: A Roadmap for Writing, Editing, and Architecting in DITA. Upper Saddle River, NJ: IBM Press : Pearson.