Ditalog
msgbartop
DITA für Redakteure – von Single Source Publishing bis Self-Publishing
msgbarbottom

31 Aug 10 RenderX XEP für den PDF2-Output installieren

{lang: 'de'}

Anleitung: So installieren Sie den RenderX-Formatter für das FO-Plugin und den PDF2-Output.

Nur für die PDF-Generierung halte ich mir ein DITA-OT 1.4.2 mit funktionierendem XEP-Formatter vor. Denn nur letzterer ist in der Lage, ein Stichwortverzeichnis anzulegen. Bei der Generierung mit FOP kommen keine Indexe zustande. Für die Onlineausgabe hatte ich schon das DITA-OT 1.5 installiert. Mit dieser Doppelung sollte nun Schluß sein. Hilfe erhielt ich bei der Installation bei der Yahoo-DITA-Users-Group.

Kostenlosen PDF2-Formatter für DITA downloaden

Kostenlosen PDF2-Formatter für DITA downloaden.

Weiterlesen als PDF

Lesen Sie den ganzen Artikel als PDF-Datei weiter »

Angaben zum Artikel

Artikel als PDF anzeigen
Aufrufe bzw. Downloads: 218
Aktualisiert am: 31.08.2010
Autor: Andreas Petersell
In Kapitelausgabe: Ausgabeformat PDF

Text als PDF downloaden
Titel des Downloads: Ausgabeformat PDF
Art der Publikation: Kapitel
Beschreibung: Das gesamte Kapitel "Ausgabeformat PDF" als PDF-Datei. Ohne Leerseiten für den A4-Ausdruck optimiert.
Aktualisiert am: 28.11.2011
Anzahl der Downloads: 460
Teilen Sie die URL Ihren Xing-Kontakten mit.

20 Aug 10 Fusszeile im Template hinterlegen

{lang: 'de'}

Anleitung: So geben Sie eine einfache, zentrierte Fußzeile mit Hilfe eines angepaßten xsl-Templates im
Customization-Ordner des FO-Plugins aus.

Fusszeile in der PDF-Datei

Zentrierte Fußzeile in der PDF-Datei

Weiterlesen als PDF

Lesen Sie den ganzen Artikel als PDF-Datei weiter »

Angaben zum Artikel

Artikel als PDF anzeigen
Aufrufe bzw. Downloads: 193
Aktualisiert am: 20.08.2010
Autor: Andreas Petersell
In Kapitelausgabe: Ausgabeformat PDF

Text als PDF downloaden
Titel des Downloads: Ausgabeformat PDF
Art der Publikation: Kapitel
Beschreibung: Das gesamte Kapitel "Ausgabeformat PDF" als PDF-Datei. Ohne Leerseiten für den A4-Ausdruck optimiert.
Aktualisiert am: 28.11.2011
Anzahl der Downloads: 460
Teilen Sie die URL Ihren Xing-Kontakten mit.

17 Aug 10 A4 als Standardseitenformat

{lang: 'de'}

A4 ist für Europa ein Standard. Nicht jedoch für die Entwickler des Idiom FO Plugins. Es gilt, das Standardseitenformat A4 für den PDF-Output einzustellen.

Vom amerikanischen Format auf A4 umstellen

Manuelle Umschaltung beim Drucker.

Weiterlesen als PDF

Lesen Sie den ganzen Artikel als PDF-Datei weiter »

Angaben zum Artikel

Artikel als PDF anzeigen
Aufrufe bzw. Downloads: 234
Aktualisiert am: 17.08.2010
Autor: Andreas Petersell
In Kapitelausgabe: Ausgabeformat PDF

Text als PDF downloaden
Titel des Downloads: Ausgabeformat PDF
Art der Publikation: Kapitel
Beschreibung: Das gesamte Kapitel "Ausgabeformat PDF" als PDF-Datei. Ohne Leerseiten für den A4-Ausdruck optimiert.
Aktualisiert am: 28.11.2011
Anzahl der Downloads: 460
Teilen Sie die URL Ihren Xing-Kontakten mit.

14 Jul 10 Fusszeile ausgeben

{lang: 'de'}

Anleitung: So geben Sie eine einfache, zentrierte Fußzeile mit Hilfe des FO-Plugins  aus.

  1. Fügen Sie in der Datei
    DITA-OT\demo\fo\Customization\fo\attr\custom.xsl folgende zwei Attribut-Sets hinzu:

    <xsl:attribute-set name="__body__odd__footer">
     <xsl:attribute name="text-align">center</xsl:attribute>
     <xsl:attribute name="margin-bottom">10pt</xsl:attribute>
    </xsl:attribute-set>
    
    <xsl:attribute-set name="__body__even__footer">
     <xsl:attribute name="text-align">center</xsl:attribute>
     <xsl:attribute name="margin-bottom">10pt</xsl:attribute>
    </xsl:attribute-set>
    
  2. Füllen Sie die Variablen Body odd footer und Body even footer in der Datei DITA-OT\demo\fo\Customization\common\vars\de_DE.xml. So könnte dies beispielhaft aussehen.
    <variable id="Body odd footer">
    &#169;&#160;2010&#160;Andreas&#160;Petersell&#160;-&#160;www.ditalog.com
    </variable>

    Füllen Sie bei Bedarf ebenfalls die Variable Body even footer.

    Beispiel einer Fusszeile

    Fusszeile über dem RenderX-Formatter-Wasserzeichen

    Der Vorteil dieser Vorgehensweise ist die Schnelligkeit des Umsetzens. Ein gravierender Nachteil wird offenbar, wenn mehrere Layouts administriert werden müssen: beim Wechsel eines Layouts müssen die Variablen für die footer neu editiert werden.

Links zum Artikel

  1. RenderX  XSL-FO-Prozessor Personal Edition

Text als PDF downloaden
Titel des Downloads: Ausgabeformat PDF
Art der Publikation: Kapitel
Beschreibung: Das gesamte Kapitel "Ausgabeformat PDF" als PDF-Datei. Ohne Leerseiten für den A4-Ausdruck optimiert.
Aktualisiert am: 28.11.2011
Anzahl der Downloads: 460
Teilen Sie die URL Ihren Xing-Kontakten mit.

14 Jun 10 Paragraphensymbol § im indexterm

{lang: 'de'}

Innerhalb des indexterm-Tags wird das Paragraphensymbol nicht ausgeben und der Stichworteintrag entfällt als Ergebnis ganz.

Es kann sein, dass Ihre Stichworteinträge, beginnend mit dem Paraphensymbol, nicht geparst und somit nicht im Stichwortverzeichnis auftauchen. Behelfen Sie sich mit der Nummer im ISO-8859-1-Character-Set oder dem Namen. Im Falle des Paragraphensymbols (Section Sign) ist dies &#167; bzw. &sect;

Zwei zwingende Vorraussetzungen:

  1. Texteingabe nur in der Quellcode-Ansicht des Editors. XML Mind macht aus dem &sect; gnadenlos ein &amp;sect; – mit dem Ergebnis, dass dieses Stichwort falsch dargestellt wird.
  2. Das Paraphensymbol darf nicht zu Beginn des Stichworteintrages stehen. Setzen Sie z.B. das Kürzel des Gesetzes davor: StAG 3 Abs. 2.

Manchmal sind aber auch Quellcode-Editoren störrisch. Da hilft, wir bei mir, nur ein gutes Suchen-Ersetzen-Tool für das ändern von &amp;#167 in &#167.

Text als PDF downloaden
Titel des Downloads: Ausgabeformat PDF
Art der Publikation: Kapitel
Beschreibung: Das gesamte Kapitel "Ausgabeformat PDF" als PDF-Datei. Ohne Leerseiten für den A4-Ausdruck optimiert.
Aktualisiert am: 28.11.2011
Anzahl der Downloads: 460
Teilen Sie die URL Ihren Xing-Kontakten mit.

14 Jun 10 xref-Direktlinks in Onlinehilfe vs. Print

{lang: 'de'}

Hilfreiche xref-Links in der Onlinehilfe sollen im PDF-Output ausgeblendet werden.

Direktlinks

Manchmal möchte man auf xref-Links einfach nicht verzichten, denn in der Online-Hilfe erfüllen sie ihren Zweck, der auch durch sogenannte related links am Ende des Artikels nicht ersetzt werden kann. Hier der pure xref-Link und das Erscheinungsbild im Output. (weiterlesen…)

Teilen Sie die URL Ihren Xing-Kontakten mit.

21 Mai 10 Zugangsweg im PDF darstellen

{lang: 'de'}

Anleitung: So koppeln Sie den Zugangspfad zu einem Fenster aus den Handlungsschritten aus und ändern entsprechend das XSL-Stylesheet.

Anmerkung: Der PDF-Output wird mit Hilfe des Idiom-FO-Plugins realisiert. Letzteres verwendet den RenderX als XSL-FO-Prozessor. Die “Personal Edition” unter www.renderx.com/download/personal.html ist kostenlos und zeitlich unbegrenzt für nichtkommerzielle Zwecke nutzbar.

  1. Der Hinweis auf den Zugangsweg zum Bildschirm soll mit einem Cursor-Icon und dem Wort Zugang: gekennzeichnet werden.
    Abbildung 1. Cursor-Icon vorm Zugangspfad
    Zugangsweg
  2. Kopieren Sie das Bild, mit welchem Sie den Zugangspfad “flaggen” möchten, in den Idiom-FO-Plugin-Ordner C:\DITA-OT1.4.2.1\demo\fo\Customization\common\artwork
  3. Fügen Sie in der Datei custom.xsl im Ordner \demo\fo\Customization\fo\attr\custom.xsl folgendes Attributset hinzu:
    <xsl:attribute-set name="p.zugang">
    <xsl:attribute name="font-weight">bold</xsl:attribute>
    </xsl:attribute-set>
    
  4. Fügen Sie in der Datei custom.xsl im Ordner \demo\fo\Customization\fo\xsl folgenden Eintrag für ein Template hinzu:
    <xsl:template match="*[contains(@class, ' topic/p ')]">
    <xsl:choose>
    <xsl:when test="@otherprops='zugang'">
    <fo:block space-before="0.5em">
    <fo:inline><fo:external-graphic src="url({concat($artworkPrefix,
    '/Customization/OpenTopic/common/artwork/icon_cursor.gif')})"/></fo:inline>
    <fo:inline xsl:use-attribute-sets="p.zugang"><xsl:text> Zugang: </xsl:text>
    </fo:inline>
    <xsl:apply-templates/>
    </fo:block>
    </xsl:when>
    <xsl:otherwise>
    <fo:block xsl:use-attribute-sets="p" id="{@id}">
    <xsl:apply-templates/>
    </fo:block>
    </xsl:otherwise>
    </xsl:choose>
    </xsl:template>
    

    Neu ist hier die when-Anweisung. Die otherwise-Anweisung ist das normale Template für einen Absatz.

  5. Versehen Sie den Absatz, der den Zugangsweg beinhalten soll, mit dem Attribut otherprops="zugang". Der obige Screenshot wurde über einen Absatz im prereq-Tag realisiert:
    <prereq>
    <p id="konfigbzr" otherprops="zugang" outputclass="zugang">Klicken Sie
    im <wintitle>Hauptmenü</wintitle> auf
    <menucascade>
    <uicontrol>Systemarbeiten</uicontrol>
    <uicontrol>Konfiguration Module</uicontrol>
    <uicontrol>BZR.</uicontrol>
    </menucascade></p>
    </prereq>
    
  6. Optional:
    Weitere Überlegung sollte sein, diesen Zugangsweg nur einmal zu editieren und dann per conref-Mechanismus in die jeweilige Handlungsanleitung zu ziehen. Falls sich doch mal ein Bildschirm oder Menü ändert, brauchen Sie nur in der Originaldatei den Pfad oder ähnliches ändern und durch Content Referenzierung wird die Änderung in sämtlichen Handlungsanleitungen übernommern.
  7. Optional:
    Falls Sie wie im Beispiel um den Zugangsweg einen Rahmen ziehen möchten, vergeben Sie neben dem otherprops-Attribut noch ein outputclass-Attribut und erstellen in der CSS-Datei eine Deklaration gleichen Names.

Text als PDF downloaden
Titel des Downloads: Ausgabeformat PDF
Art der Publikation: Kapitel
Beschreibung: Das gesamte Kapitel "Ausgabeformat PDF" als PDF-Datei. Ohne Leerseiten für den A4-Ausdruck optimiert.
Aktualisiert am: 28.11.2011
Anzahl der Downloads: 460
Teilen Sie die URL Ihren Xing-Kontakten mit.

21 Mai 10 Texteinrückung mit hängender erster Zeile

{lang: 'de'}

Anleitung: So erstellen Sie einen Literaturverzeichniseintrag mit hängender 1. Zeile.

Anmerkung: Der PDF-Output wird mit Hilfe des Idiom-FO-Plugins realisiert. Letzteres verwendet den RenderX als XSL-FO-Prozessor. Die “Personal Edition” unter www.renderx.com/download/personal.html ist kostenlos und zeitlich unbegrenzt für nichtkommerzielle Zwecke nutzbar.

  1. Für ein Literaturverzeichnis sollen die Absätze pro Eintrag eingerückt werden mit der ersten Zeile hängend.
    Abbildung 1. Hängende erste Zeile
    Textindent
  2. Fügen Sie in der Datei custom.xsl im Ordner \demo\fo\Customization\fo\xsl folgenden Eintrag für ein Template hinzu:
    <xsl:template match="*[contains(@class, ' topic/p ')]">
    <xsl:choose>
    <xsl:when test="@otherprops='indent'">
    <fo:block text-indent="-2em" start-indent="4.5em">
    <xsl:apply-templates/>
    </fo:block>
    </xsl:when>
    <xsl:otherwise>
    <fo:block xsl:use-attribute-sets="p" id="{@id}">
    <xsl:apply-templates/>
    </fo:block>
    </xsl:otherwise>
    </xsl:choose>
    </xsl:template>
    

    Neu ist hier die when-Anweisung. Die otherwise-Anweisung ist das normale Template für einen Absatz. Für indent können Sie eigene Entsprechungen finden. Es soll hier nur als Beispiel dienen.

  3. Versehen Sie sämtliche Absätze, die Quellenangaben enthalten sollen, mit dem Attribut otherprops="indent".
    <p otherprops="indent" outputclass="indent">
    Erich Loest: Es geht seinen Gang oder Mühen in unserer Ebene. München 1994 (dtv 10430)</p>
  4. Optional:
    Falls Sie die Texteinrückung auch in XHTML-Output haben möchten, vergeben Sie wie oben ein Attribut outputclass="indent". Erstellen Sie anschließend in der CSS-Datei eine Deklaration gleichen Namens mit einem Eintrag für text-indent.

Text als PDF downloaden
Titel des Downloads: Ausgabeformat PDF
Art der Publikation: Kapitel
Beschreibung: Das gesamte Kapitel "Ausgabeformat PDF" als PDF-Datei. Ohne Leerseiten für den A4-Ausdruck optimiert.
Aktualisiert am: 28.11.2011
Anzahl der Downloads: 460
Teilen Sie die URL Ihren Xing-Kontakten mit.

20 Mai 10 Einzelkapitel in der DITA-Druckausgabe

{lang: 'de'}

Es sollen Einzelkapitel und Kapitel mit Unterabschnitten im Inhaltsverzeichnis korrekt dargestellt werden.

So soll es aussehen

Abbildung 1. Einzelkapitel in 2. und 4.

Einzelkapitel und Unterkapitel

Damit Kapitel 2 und 4 im Plugin nicht auf der typischen zweigeteilten Startseite eines Kapitels landen, ist einiges in der bookmap zu beachten. (weiterlesen…)

Teilen Sie die URL Ihren Xing-Kontakten mit.

20 Mai 10 Inhaltsverzeichnis Print vs. Online

{lang: 'de'}

Unterschiede zwischen Print- und Online-Inhaltsverzeichnis.

1:1-übertragung des Online-Verzeichnisses?

Meistens ist immer die Online-Hilfe das erst Output-Ergebnis und man macht sich daran, die Haupt-Ditamap als Grundlage für eine Bookmap für den PDF-Output zu nehmen. So sah dann mein erstes Ergebnis des PDF-Inhaltsverzeichnisses so aus:

Abbildung 1. Erster Output im PDF-Format
Inhaltsverzeichnis im PDF
Spätestens jetzt muss man sich Gedanken machen, ob eine 1:1-Kopie des Online-Verzeichnisses für den PDF-Output geeignet ist. Hier im Beispiel des ditalogs liegt es nahe, die verschiedenen Ausgabeformate auch unter einem Stichwort Ausgabeformate zu sammeln. Doch ist dies nicht das, was dem Leser in einem Druckdokument weiterhilft. Hier wäre es besser, den einzelnen Ausgabeformaten ein eigenes Kapitel zu widmen. Man erspart sich die dritte Ebene im Inhaltsverzeichnis und der Leser erhält einen schnelleren überblick. Und überblick steht bei einem Printinhaltsverzeichnis im Vordergrund. Wer wirklich etwas Spezielles sucht, muss über das Stichwortverzeichnis gehen.

Besondere Gestaltung der bookmap

Die Bookmap bedarf also meistens eine überarbeitung und sieht im Ergebnis anders als die Online-ditamap aus.

Abbildung 2. Neue Anordnung
PDF Inhaltsverzeichnis

Egal, wie man die bookmap neu anordnet – man wird sie immer flexibel den Bedürfnissen des Lesers (nicht Nutzers) anpassen müssen.

Text als PDF downloaden
Titel des Downloads: Ausgabeformat PDF
Art der Publikation: Kapitel
Beschreibung: Das gesamte Kapitel "Ausgabeformat PDF" als PDF-Datei. Ohne Leerseiten für den A4-Ausdruck optimiert.
Aktualisiert am: 28.11.2011
Anzahl der Downloads: 460
Teilen Sie die URL Ihren Xing-Kontakten mit.