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 >> |
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