Dokumentation mit DocBook

Dokumentation mit DocBook

Posts 1-8 of 8
  • Mike Elstermann
    Mike Elstermann    Group moderator
    The company name is only visible to registered members.
    Oxygen-Author: "Abbildung" statt "Figure" welche Eigenschaft/generelle Einstellung steuert das?
    Hallo zusammen,

    bin Neuling, deshalb ... ;-)

    Meine Frage,

    wie kann ich DocBook (nutze Oxygen-Author) dazu bewegen, die Bild-Unter-/Überschriften mit z. B. "Abbildung" statt dem Default "Figure" bei Nutzung des "<figure></figure>"-Tags zu beschreiben?
    Wo stelle ich die Formate für die Tags ein? z. B. bei "Figure" immer Times-italic, 11pt?

    Danke, mikeE.
    • 06 May 2011, 1:49 pm
  • Post visible to registered members
  • Mike Elstermann
    Mike Elstermann    Group moderator
    The company name is only visible to registered members.
    Re^2: Oxygen-Author: "Abbildung" statt "Figure" welche Eigenschaft/generelle Einstellung steuert das?
    T.S. schrieb:
    Sie müssen die Sprache in Ihrem Dokument setzen. Beispielsweise im Start-Tag <book> als <book lang="de"> (DocBook 4.x) Dann erkennen die DocBook XSL Stylesheet die Sprache und setzen die korrekte Überschrift. Danke, klappt prima :-)

    Wo stelle ich die Formate für die Tags ein? z. B. bei "Figure" immer Times-italic, 11pt?
     
    Die Frage ist für mich mehrdeutig: Im oXygen? Im PDF Endformat? Vermutlich letzteres, oder? :)     Genau: Im Ausgabeformat, also PDF oder HTML.
    Also wo stehen die Definitionen der Ausgabeformate für die Tags (vergleichbar mit CSS, also wie sieht die Schrift beim BODY oder im H1 oder im TH aus)

    Danke, mikeE.
    • 06 May 2011, 3:27 pm
  • Post visible to registered members
  • Michael Sahm
    Michael Sahm
    The company name is only visible to registered members.
    Re^3: Oxygen-Author: "Abbildung" statt "Figure" welche Eigenschaft/generelle Einstellung steuert das?
    Hallo Herr Elstermann,

    Also wo stehen die Definitionen der Ausgabeformate für die Tags (vergleichbar mit CSS, also wie sieht die Schrift beim BODY oder im H1 oder im TH aus)
    DocBook wird von Hause aus mit einer Anzahl unterschiedlicher Stylesheets für verschiedene Ausgabeformate angeboten:

    http://sourceforge.net/projects/docbook/files/docbook-xsl/

    Diese Stylesheets direkt zu ändern ist jedoch nicht empfehlenswert.
    Sinnvoller ist eine Änderung z.B. über eine XSLT-Anpassungsdatei.
    Und dafür sollte man mit der XSL-Syntax ein Stück weit vertraut sein.

    Ich empfehle Ihnen als Anfänger die folgenden Bücher:

    - "DocBook-XML" von Thomas Schraitle (ISBN 3-89990-078-2)
    - "DocBook XSL - The Complete Guide" von Bob Stayton (ISBN 978-0-9741521-3-4)

    (letzteres auch als Online-Version: http://sagehill.net/docbookxsl/index.html)

    Viele Grüße
    Michael Sahm

    ...ups, da war Herr Schraitle schneller. Verständlich. ;-)
    This post was modified on 06 May 2011 at 05:15 pm.
    • 06 May 2011, 5:13 pm
  • Post visible to registered members
  • Mike Elstermann
    Mike Elstermann    Group moderator
    The company name is only visible to registered members.
    Re^5: Oxygen-Author: "Abbildung" statt "Figure" welche Eigenschaft/generelle Einstellung steuert das?
    Danke für den Input, ich werd wohl um das Bücherstudium nicht drumrum kommen.

    Noch eine "Kleinigkeit":
    Wie bekomme ich Oxygen dazu, die Sektionen ordentlich in der Form:

    1.
    1.1.
    1.1.1
    1.1.1.1

    durch zu numerieren - bei mir werden in der Ausspielung als HTML/PDF nur die Kapitel numeriert.
    Gibt es außerdem die Möglichkeit, für jede Section eine eigene HTML-Seite zu erzeugen, ich schaff das nur bis zur ersten Sectionstiefe. Gibt es da ein Extra-Tag oder eine zentrale Einstellung?

    Hier ein Quelltext-Schnipsel:

    <chapter>
    <title>GUI - die grafische Benutzeroberfläche</title>
    <section>
    <title>Hauptmenü</title>
    </section>
    <section>
    <title>Werkzeugleiste</title>
    <sect1>
    <title>xxxxx</title>
    <sect2>
    <title>xxxxx</title>
    <sect3>
    <title>xxxxx</title>
    <sect4>
    <title>xxxxx</title>
    <sect5>
    <title>xxxxx</title>
    </sect5>
    </sect4>
    </sect3>
    </sect2>
    </sect1> . . .
    • 09 May 2011, 10:06 am
  • Post visible to registered members