FAQ-Plugin einbinden (Teil 3)

Anleitung: So machen Sie die Layoutänderungen des FAQ-Plugins wieder rückgängig.

Leider nimmt das FAQ-Plugin gravierende Eingriffe in das Topic-Body-Template vor. So verschwanden in meinem Online-Output sämtliche Abstract-Absätze. Auch gefällt mir die Linie unterhalb des Seitentitels, der nun in jedem! Topic erscheint, nicht.

  1. Öffnen Sie die Datei faq2html_shellImpl.xsl und setzen Sie die Variable link-top-section auf no:
    <xsl:variable name="link-top-section">no</xsl:variable>

    Sie funktioniert leider nicht. Jedoch an unpassender Stelle in jedem Task-Topic!

  2. Öffnen Sie die Datei DITA-OT/xsl/xslhtml/dita2htmlImpl.xsl und suchen Sie das Template mit name=”topic.body”. Kopieren Sie es und fügen es nach der oben erwähnten Variable link-top-section ein.
  3. Suchen Sie im neu kopiertem Template den Eintrag <xsl:apply-templates/> und fügen Sie davor folgenden Template-Aufruf hinzu, so dass es nun folgendermaßen aussieht:
    <xsl:call-template name="gen-qatoc"/>
    <xsl:apply-templates/>
    
  4. Löschen bzw. kommentieren Sie das alte Template mit name=”topbody” aus, das nun nicht mehr gebraucht wird. Sie finden dieses Template unterhalb des folgenden Kommentars:
    <!-- override the body template to place this toc in the expected location -->
    <xsl:template match="*[contains(@class,' topic/body ')]" name="topbody">
      ...
    </xsl:template>>
    
  5. Löschen Sie im darunter befindlichen Template den Eintrag <p>Questions in this FAQ list</p>, denn dieser erscheint sonst in jedem Topic.
  6. Falls Sie keinen Trennstrich nach jedem! Topic-Titel haben möchten, entfernen Sie im gleichen Template die Notation <hr/>.
  7. Kopieren Sie die Datei demo/faq/ditafaq.xml in Ihr topic-Verzeichnis, benennen Sie sie um und nutzen Sie diese als Vorlage für Ihre individuellen FAQ-Seiten. Binden Sie neue FAQ-Topics in die die ditamap ein. Benutzen Sie dabei das Attribut type=”faq”.