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

14 Apr 11 Wie erzeuge ich die PDF-Metadaten?

{lang: 'de'}

So generieren Sie über das DITA-OT und dem FO-Plugin die Metadaten einer PDF-Datei.

Fehlende Metadaten im PDF

Fehlende Metadaten in der PDF-Datei

Auf zweierlei Wegen kann man sich die Eigenschaften einer PDF-Datei anzeigen lassen. Im Acrobat Reader unter
dem Menüpunkt Datei > Eigenschaften. Im Windows-Explorer per rechten Mausklick und Menüeintrag
Eigenschaften. Nun wies mich Ben, der seine Anleitungen ebenfalls mit DITA realisiert, darauf
hin, dass in meinen PDFs die Meta-Angaben fehlen. Kurz darauf gab es zufällig einen Forum-Eintrag in der
DITA-User-Yahoogruppe bezüglich der Meta-Daten in einer PDF-Datei. Der Artikel ist in der PDF-Datei Ditalog – Ausgabeformat PDF enthalten.

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: 461
Teilen Sie die URL Ihren Xing-Kontakten mit.

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: 461
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: 461
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: 235
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: 461
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: 461
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: 461
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 Leere Seiten aus PDF entfernen

{lang: 'de'}

Leere oder nicht benötigte Seiten sollen aus der PDF-Datei entfernt werden.

Problem der nicht benötigten Seiten

Als PDF-Ergebnis erhält man, auch ohne eine bookmap zu nutzen, eine PDF-Datei mit Deckblatt und Inhaltsverzeichnis. Möchte man jedoch nur eine A4-Seite für eine kleine Änderungsliste oder ähnliches erstellen, wirkt ein Deckblatt und ein Inhaltsverzeichnis mit nur einem Eintrag deplatziert.

Desweiteren enstehen oftmals leere Seiten, die nur im beidseitigem Druck einen Sinn ergeben. Der PDF-Ausdruck geschieht jedoch meistens für den einseitigen Ausdruck, worin die leeren Seiten als störend empfunden werden. (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: 461
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: 461
Teilen Sie die URL Ihren Xing-Kontakten mit.