Profiling-Informationen einfügen

(Auszug aus "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" von Thomas Schraitle)

Um Profiling zu nutzen, müssen Sie nicht die DocBook-Stylesheets anpassen. Sie integrieren lediglich Profiling-Attribute in das jeweilige Element. Diese Attribute sind in nachfolgender Tabelle aufgeführt.

Die Profiling-Attribute werden von einem Profiling-Stylesheet ausgewertet, das für jedes Attribut einen Parameter bereitstellt (siehe zweite Spalte Profiling-Name). Standardmäßig sind alle Parameter leer, lassen sich jedoch mit Ihren Werten überschreiben.

Tabelle: Attribute für Profiling

Attribut-Name Profiling-Name Beschreibung
arch profile.arch Prozessorarchitektur, wie i386, ppc, sparc
audience profile.audience legt die Zielgruppe fest
condition profile.condition allgemeines Standardattribut ohne spezielle Semantik
conformance profile.conformance kennzeichnet einen Standard
lang, xml:langa profile.lang kennzeichnet eine natürliche Sprache, wie de, en, es
os profile.os Betriebssysteme wie linux, mac, win und andere
revision profile.revision kennzeichnet die Revision, wie v1.5
revisionflag profile.revisionflag kennzeichnet den Status eines Elements, wie changed
role profile.role allgemeines Attribut; möglichst für Profiling vermeiden!b
security profile.security Sicherheitsgrad
userlevel profile.userlevel kennzeichnet die Erfahrung eines Benutzer zu einem Thema, wie beginner, professional oder expert
vendor profile.vendor Name eines Produkts oder Herstellers wie Samba, DocBook usw.
wordsize profile.wordsize Wortgröße (Breite in Bits) der Computerarchitektur

a   Nur für DocBook 5.
b   Das Attribut role ist bereits durch einige Elemente belegt (wie in emphasis für Fettdruck). Dadurch ergeben sich unerwünschte Nebeneffekte, wenn Sie role verwenden.  

Sie verwenden die Profiling-Attribute so, dass Sie als Wert eine Variante Ihres Dokuments eintragen. Zum Beispiel:

<section os="linux">
    <title>Installation unter Linux</title>
    ...
</section>
<section os="win">
    <title>Installation unter Windows</title>
    ...
</section>
<section os="macos">
    <title>Installation unter MacOS</title>
    ...
</section>

Das Beispiel enthält drei parallele Abschnitte, welche die Installation eines Programms beschreiben, jedoch für unterschiedliche Betriebssysteme. Die Bedingung gilt für das Element, welches das Profiling-Attribut enthält samt seiner Kindelemente.

Für gewöhnlich soll in der Ausgabe eine angepasste Anleitung nur für eines der Betriebssysteme erstellt werden, beispielsweise für Linux. In diesem Fall wählen Sie im Profilingschritt die Bedingung os="linux". Hierdurch werden alle Elemente ausgeblendet, die im os-Attribut einen anderen Wert als linux enthalten. Elemente, die das Attribut os nicht enthalten, werden unverändert übernommen.

  

<< zurück vor >>
Tipp der data2type-Redaktion:
Zum Thema DocBook bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

Copyright © 2009 Millin Verlag
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.

Millin Verlag, Siebengebirgsring 36, 53797 Lohmar, info(at)millin.de