Profilieren von DocBook: Teil II
Dokumentationen mit DocBook-XML
An dieser Stelle sollen die Dokumente, deren Elementen wir bereits Profilierungsinformationen gegeben haben, so gefiltert werden, dass nur die für ein bestimmtes Publikum gedachten Inhalte im Zieldokument erscheinen. Dazu werden dem XSLT-Prozessor entsprechend den verwendeten Profiling-Attributen Parameter übergeben.
Wenn man die normalen DocBook-XSL-Stylesheets verwendet, so muss man dem XSLT-Prozessor eine andere XSL-Datei als Stylesheet angeben, damit die weiteren Parameter ausgewertet werden. Dies gilt natürlich auch dann, wenn man eigene Erweiterungen zu den Stylesheets hinzugefügt hat, also muss man dort andere Dateien importieren.
Tabelle 3.1. Stylesheet-Dateien
| Format | Normale Ausgabe | Profilierte Ausgabe |
|---|---|---|
| xsl:fo | fo/docbook.xsl | fo/profile-docbook.xsl |
| html (einzelne Datei) | html/docbook.xsl | html/profile-docbook.xsl |
| html (mehere Dateien) | html/chunk.xsl | html/profile-chunk.xsl |
| xhtml (einzelne Datei) | xhtml/docbook.xsl | xhtml/profile-docbook.xsl |
| xhtml (mehere Dateien) | xhtml/chunk.xsl | xhtml/profile-chunk.xsl |
Beispiel 3.11. Profilierung vom Saxon
Der XSLT-Prozessor Saxon akzeptiert die Übergabe in folgender Art und Weise (z.B. bei der Erstellung eines einzelnen HTML-Dokuments)
lars@notebook doctutorial $ java -jar /opt/saxon/saxon.jar vortrag.xml \
/opt/docboook-xsl/html/profile-docbook.xsl "profile.os=windows" > vortrag.html
Writing ld-d0e4785.html for imagedata
lars@notebook doctutorial $Folgende Parameter sind für die Profilierung interessant:
- profile.arch
Nach Hardware-Architektur filtern.
- profile.attribute
Nach einem beliebigen Attributinhalt filtern. Tritt nur zusammen mit profile.value auf. Der Wert des Parameters gibt den Namen des Attributs an.
- profile.condition
Nach Bedingung, die im Attribut condition angegeben ist, filtern.
- profile.conformance
Nach Bedingung, die im Attribut conformance angegeben ist, filtern.
- profile.lang
Nach Sprache filtern. Das kann zu Problemen bei Verwendung von foreignphrase führen.
- profile.os
Nach dem Betriebssystem filtern.
- profile.revison
Nach einer bestimmten Version filtern.
- profile.revisionflag
Nach einer bestimmten Änderungsmeldung filtern.
- profile.role
Nach dem Wert des Attributs role filtern.
- profile.security
Filterung nach Sicherheitsebene.
- profile.separator
Wenn für einen Profilierungsparameter mehr als ein Wert angegeben wird, so ist der Wert des Attributs profile.separator das Trennzeichen zwischen zwei Werten.
- profile.userlevel
Nach Benutzererfahrung filtern.
- profile.value
Dieses Attribut tritt immer in Verbindung mit profile.attribute auf. Es gibt den gewünschten Wert an, den Attribute haben sollen, nach denen gefiltert werden soll.
- profile.vendor
Wenn ein Dokument für verschiedene Vertreiber erstellt werden soll, wird dieser Parameter genutzt, um zu filtern.
Ihre Unterstützung
Der Autor dieses Dokuments ist Autor des Buches the book DocBook-XML. Durch den Kauf über diesen Link können Sie den Autor unterstützen.
Copyright © 2002, Lars Trieloff