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

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: 3
Aktualisiert am: 31.08.2010
Autor: Andreas Petersell
In Gesamtausgabe: ja
In Kapitelausgabe: Ausgabeformat PDF

Weitere Downloads

Kapitel 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: 30.08.2010
Anzahl der Downloads: 65

20 Aug 10 Fusszeile im Template hinterlegen

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: 14
Aktualisiert am: 20.08.2010
Autor: Andreas Petersell
In Gesamtausgabe: ja
In Kapitelausgabe: Ausgabeformat PDF

Weitere Downloads


Kapitel 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: 30.08.2010
Anzahl der Downloads: 65

17 Aug 10 A4 als Standardseitenformat

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: 16
Aktualisiert am: 17.08.2010
Autor: Andreas Petersell
In Gesamtausgabe: ja
In Kapitelausgabe: Ausgabeformat PDF

Weitere Downloads


Kapitel 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: 30.08.2010
Anzahl der Downloads: 65

14 Jul 10 Fusszeile ausgeben

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
Kapitel 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: 30.08.2010
Anzahl der Downloads: 65

28 Jun 10 How do you design for function?

Wer als Technischer Redakteur noch nichts mit Twitter anfangen kann, sollte wenigstens die Suche von Twitter nutzen. Sie verät, was gerade aktuell ist oder wieder aufgewärmt wird bzw. gar “gehypt” wird.

http://search.twitter.com besuchen und den Hashtag #techcomm eingeben.

So stieß ich auf einen Artikel vom Januar 2009: Building a 21st century user interface von Brett D. McLoughlin.

So einfach wie es klingt, Entwickler und Webdesigner sollen sich auf die Kernfunktion ihres Programms bzw. Website besinnen.  Und am besten ist es, wenn man sich diese Kernfunktion an den Bildschirm klebt. Was immer Sie nun machen, dieser Klebezettel steht über allem, was Sie in Zukunft für Aufgaben anstehen.

Beispielhaft wird Amazon erwähnt. Auf der Website sind die wenigen wirklich wichtigen Schaltfläche orange, im Gegensatz zum blauen Gesamterscheinungsbild der Seite. Die Feuerprobe ist ein “Fuzzy Test” bzw. Milchglas-Test.

Milchglastest fürs Funktionsdesign einer Webseite

Alles wichtige ist noch auszumachen: das Produktvorschaubild und sämtliche Verkaufsabschluß-Schaltflächen.

Was ist das Wesentliche vom Ditalog? Die Tutorials ergeben erst wirklich einen Sinn, wenn man sie in Ruhe schwarz auf weiß lesen und begreifen kann. Also wurde die Farbe der Downloadbox für den PDF-Datei-Download von grau in gelb geändert. Ja, und die Sexy-Bookmarks waren einfach zu sexy – sie lenkten vom Download ab. Hier ein Screenshot vom Wordpress Plugin Directory:

Lenkten ab - Bookmarkplugin

14 Jun 10 Paragraphensymbol § im indexterm

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.

Kapitel 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: 30.08.2010
Anzahl der Downloads: 65

14 Jun 10 xref-Direktlinks in Onlinehilfe vs. Print

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

10 Jun 10 Link: OASIS-Artikel zu DITA 1.2

Wer sich in längeren Artikeln statt in Powerpoint-Folien über die neuen Merkmale von DITA 1.2 vertraut machen will, ist auf der Artikel-Seite des OASIS DITA Adoption Technical Committees gut augehoben.

OASIS DITA Adoption Technical Committee

03 Jun 10 Mein Theme-Schock

Wordpress Theme Excelence

Excelentes Theme Excelence

Schock ist etwas übertrieben. Aber man muss ihn erlebt haben, um zu wissen, dass es ihn gibt. Mit anderen Worten, hier kommt eine Anleitung, wie man “den Unterschied zwischen Theorie und Praxis erfahren” kann.

  1. Man möchte ein Websitenprojekt mit Wordpress realisieren und sucht jetzt nach dem schönsten und kostenlosesten Theme, dass es gibt.
  2. Man findet ein exzelentes Theme und findet es einzigartig. Man glaubt, die Einzigartigkeit wird nur von einem selbst erkannt und überliest geflissentlich die Anzeige This post was viewed 52,897 times
  3. Man passt über mehrere Tage das Theme für seine Bedürfnisse an.
  4. Man surft fleißig – und dann kommt der Schock: eine vertraute Website springt einem ins Auge und es ist nicht die eigene!

Was will uns das sagen? Dass das 2 sehr gute Websites sind:

21 Mai 10 DITA-Plugin dita4publishers installieren

Anleitung: So installieren Sie das Plugin dita4publishers.

  1. Downloaden Sie das Plugin unter http://sourceforge.net/projects/dita4publishers/files/. Die Dateisyntax ist dita4publishers-datum.zip.
  2. Entpacken Sie die Zip-Datei. Als Ergebnis erhalten Sie folgende Zip-Dateien und Ordner:
    • dita4publishers_toolkit_plugins.zip
    • documentation
    • epubs
    • sample_data
    • xslt
  3. Entpacken Sie die Datei dita4publishers_toolkit_plugins.zip in den Plugin-Ordner Ihrer Toolkit-Installation.

    Abbildung 1. plugins als Zielverzeichnis zum Entpacken

    Entpacken Dita For Publishers

    Im Ergebnis entstehen im Verzeichnis \plugins folgende Unterordner:

    • net.sourceforge.dita4publishers.doctypes
    • net.sourceforge.dita4publishers.epub
    • net.sourceforge.dita4publishers.pubmap.html
    • net.sourceforge.dita4publishers.shakespear.doctypes
    • net.sourceforge.dita4publishers.shakespear.html
    • net.sourceforge.dita4publishers.xmldomain.doctypes
    • net.sourceforge.dita4publishers.xmldomain.html
  4. Öffnen Sie das Toolkit auf Kommandoebene und geben Sie den Befehl ant -f integrator.xml ein.
  5. Probieren Sie die Generierung eines mitgelieferten Beispiels aus dem Ordner \sample_data, welcher beim Entpacken des ursprünglichen Archivs von Sourceforge entstanden ist. Kopieren Sie den Ordner \wizard-of-oz in den DITA-OT-Ordner \samples.
  6. Wechseln Sie in das Toolkit-Fenster und geben Sie folgenden Build-Befehl ab:
    java -jar lib\dost.jar /i:C:/DITA-OT1.5/samples/wizard-of-oz/wizard-of-oz.ditamap
    /transtype:epub
    /outdir:C:/DITA-OT1.5/out /logdir:C:/DITA-OT1.5/log

    Im Out-Ordner sollte sich nun die erzeugte epub-Datei befinden.

Da das Plugin die Templates für XHTML zu Grunde legt, ist es ratsam, mit einer ditaval-Datei über das Product-Attribut bestimmte Links herauszufiltern. So sieht dann mein Build-Befehl mit Filter folgendermaßen aus:

java -jar lib\dost.jar /i:C:/DITA-SRC/Installationsanleitung.ditamap
/transtype:epub /filter:C:/DITA-SRC/filters/admin-print.ditaval
/outdir:C:/DITA-SRC/out/epub-admin /logdir:C:/DITA-SRC/log