Einfügen eines Logos

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

Dieser Abschnitt zeigt Ihnen, wie Sie ein Logo für einen Artikel einfügen und es nach HTML umwandeln. Gehen Sie wie folgt vor:

  1. Anpassen Ihres Dokuments
    Fügen Sie in Ihrem Artikel innerhalb von articleinfo bzw. info eine Grafik mittels mediaobject ein. Soll Ihr Logo eine bestimmte Ausrichtung oder Größe besitzen, fügen Sie ggf. weitere Attribute in imagedata ein (vgl. Grafiken). Falls erforderlich, ersetzen Sie den Dateinamen und Pfad zum Logo:
  • Für DocBook 4-Dokumente:
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.docbook.org/xml/4.5/docbookx.dtd"> 
<article> 
    <articleinfo> 
        <mediaobject> 
            <imageobject role="html"> 
                <imagedata fileref="logo.png"/> 
            </imageobject> 
            <imageobject role="fo"> 
                <imagedata fileref="logo.png"/> 
            </imageobject> 
        </mediaobject> 
    </articleinfo> 
    <!-- Inhalt des Artikels --> 
</article>
  • Für DocBook 5-Dokumente:
<article xmlns="http://docbook.org/ns/docbook" version="5.0" xml:lang="de"> 
  <info> 
    <mediaobject> 
      <imageobject role="html"> 
        <imagedata fileref="logo.png"/> 
      </imageobject> 
      <imageobject role="fo"> 
        <imagedata fileref="logo.png"/> 
      </imageobject> 
     </mediaobject> 
  </info> 
  <!-- Inhalt des Artikels --> 
</article>
  1. Wo soll das Logo erscheinen?
    Entscheiden Sie sich, an welcher Stelle das Logo erscheinen soll. Soll es vor, nach oder "zwischen" einer Titelseite erscheinen? Für dieses Beispiel soll es vor der Titelseite erscheinen, in diesem Fall müssen Sie das Template article.titlepage.before.recto anpassen.
  2. Erstellen Sie eine Anpassungsdatei
    Erstellen Sie eine Anpassungsdatei wie in Anlegen einer Anpassungsdatei gezeigt.
  3. Einfügen von Templates in Ihre Anpassungsdatei
    Fügen Sie nachfolgendes Template ein. Wählen Sie die Anpassungsdatei in Bezug auf Ihre DocBook-Version aus, die Sie anpassen möchten:
  • Für DocBook 4-Dokumente fügen Sie ein:
<xsl:template name="article.titlepage.before.recto"> 
    <xsl:if test="articleinfo/mediaobject"> 
        <div class="logo"> 
            <xsl:apply-templates select="articleinfo/mediaobject"/> 
        </div> 
    </xsl:if> 
</xsl:template>
  • Für DocBook 5-Dokumente fügen Sie ein:
<xsl:template name="article.titlepage.before.recto"> 
    <xsl:if test="d:info/d:mediaobject"> 
        <div class="logo"> 
            <xsl:apply-templates select="d:info/d:mediaobject"/> 
        </div> 
    </xsl:if> 
</xsl:template>
  1. Transformieren
    Transformieren Sie Ihr Dokument mit Hilfe der Anpassungsdatei:
xsltproc --output artikel.html XSLT-Stylesheet artikel.xml

Obige Schritte sind ebenso für XSL-FO möglich. Sie müssen lediglich das div-Element von (X)HTML durch fo:block von XSL-FO ersetzen und das p-Element löschen.

Falls Sie mehrere Grafiken innerhalb von articleinfo bzw. info eingefügt haben, werden diese berücksichtigt. Ob dies sinnvoll ist, ist von Ihrem Dokument und Ihren Vorstellungen abhängig. Bei Dokumenten, die immer mit dem selben Logo versehen werden sollen, ist die obige Methode zu flexibel. Hier bietet es sich an, innerhalb von article.titlepage.before.recto direkt das Logo einzubinden. Fügen Sie in diesem Fall für (X)HTML ein img-Element ein und verweisen Sie auf das Logo. Entsprechendes gilt für XSL-FO, verwenden Sie stattdessen fo:external-graphic oder fo:instream-foreign-object.

  

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