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

16 Sep 11 Einbinden der Dita4Publishers-DTDs in XMLSpy und XMLMind

{lang: 'de'}

Als Quellcode-Editor nutze ich Altova XMLSpy. Als WYSIWYG-Editor XMLMind.  Bei allen anderen XML-Editoren wird es sich jedoch ähnlich verhalten. Es gilt hauptsächlich, die DITA-Catalog-Datei in die Catalogdatei des jeweiligen Editors einzubinden. Darum habe ich das eBook Dita4Publishers – von Eliot Kimber um ein Kapitel erweitert. Darin finden Sie eine Anleitung, wie Sie pubmap.dtd, article.dtd und weitere Document Type Definitions in XMLSpy einbinden und lokal nutzen können. Ein zweites Kapitel beschreibt das Einbinden der DTDs in XMLMind. Leider scheint das Programm noch keine Cataloge zu unterstützen. So fällt das Einbinden recht arbeitsintensiv aus. Aber ich bin ein Fan des Programms, weil es das Nutzen des Conref-Mechanismus´ so einfach macht.

Text als PDF downloaden
Titel des Downloads: Dita4Publishers
Art der Publikation: Thema
Beschreibung: Sämtliche Artikel zum Dita4Publishers-Plugin von Eliot Kimber. Besonders geschätzt im Plugin: die ePUB-Dateigenerierung.
Aktualisiert am: 07.12.2011
Anzahl der Downloads: 157
Teilen Sie die URL Ihren Xing-Kontakten mit.

18 Feb 11 Autor unbekannt in EPUB-Vorschau

{lang: 'de'}

Autor und verlag unbekannt

Geben Sie Autor und Verleger in einer Ditamap an, so dass in der Adobe Digital Editions bei Autor und Verleger
Ihre Angaben stehen.

In vielen ePUB-Reader fällt der Umstand der fehlenden Angaben zu Autor und Verlag nicht auf. So z.B. im
Firefox-Addon ePUB-Reader. Jedoch in Adobe Digital Editions wirken die unbekannt-Vermerke wenig
vertrauenserweckend.

Angaben in der ditamap hinterlegen

Hinterlegen Sie in Ihrer Ditamap-Datei nach dem map-Tag und vor dem ersten topicref-Tag die
topicmeta-Angaben wie in diesem Beispiel.

<map id="DDR-Protagonisten" title="DDR-Protagonisten der 70er
und 80er Jahre" xml:lang="de-de">
<topicmeta>
<author>Andreas Petersell</author>
<publisher>Andreas Petersell</publisher>
<copyright>
<copyryear year="2011"></copyryear>
<copyrholder>Andreas Petersell</copyrholder>
</copyright>
</topicmeta>
...

Text als PDF downloaden
Titel des Downloads: Dita4Publishers
Art der Publikation: Thema
Beschreibung: Sämtliche Artikel zum Dita4Publishers-Plugin von Eliot Kimber. Besonders geschätzt im Plugin: die ePUB-Dateigenerierung.
Aktualisiert am: 07.12.2011
Anzahl der Downloads: 157
Teilen Sie die URL Ihren Xing-Kontakten mit.

18 Jan 11 Fußnoten im Dita4Publishers-Plugin

{lang: 'de'}

Offizielles ePUB-Logo der IDPF.

Im Rahmen meines Projektes DDR-Protagonisten der 70er und 80er Jahre stieß ich auf den leidigen Umstand, dass im Dita4Publishers-Plugin von Eliot Kimber die Fußnoten zwar am Ende der Seite angezeigt werden, jedoch nicht im Text an der Stelle, wo sie definiert werden. Nicht nur für wissenschaftliche Texte ist die Fußnotenkennzeichnung unverzichtbar.

Natürlich verliert man Zeit, da man die Fehlerursache erst bei sich selbst sucht. Doch mein anfänglicher “Frust” schlug in Begeisterung um, als der “Meister” selbst binnen weniger Tage Abhilfe schaffte. Mit der Version 0.9.12 werden Fußnoten <fn> korrekt umgesetzt.

Teilen Sie die URL Ihren Xing-Kontakten mit.

27 Sep 10 Neue Publikation für HTML, CHM und ePUB

{lang: 'de'}

Nun ist es mir schon wieder passiert: weil ich mir keine Notizen gemacht hatte, durfte ich von neuem herausfinden, warum mein HTML-Output mit dem Plugin TOCJS wieder die Umlaute nicht richtig darstellt.

Umlaute falsch in DITA TOCJS-Navigation

Falsche Darstellung der Umlaute im Navigationsframe des TOCJS-Plugins

Es gilt, die Datei \demo\tocjs\xsl\tocjs.xml zu editieren. Ändern Sie den Wert für encoding von utf-8 auf ISO-8859-1. So muß es am Ende aussehen:

<xsl:output method="text" encoding="ISO-8859-1"/>

Diese Aktualisierung des TOCJS-Plugins ist auch in die neue PDF-Publikation mit eingeflossen. In ihr sind sämtliche Kapitel mit den Ausgabeformaten HTML, CHM und ePUB mit eingebunden. Wenn Ihnen die Ditalog-Artikel eine Hilfe waren, schreiben Sie darüber in Ihrem Blog! Wenn Sie Ihnen keine Hilfe waren, schreiben Sie die Gründe ebenfalls in Ihrem Blog.

Text als PDF downloaden
Titel des Downloads: Ausgabeformate HTML und CHM
Art der Publikation: Kapitel
Beschreibung: Sämtliche Artikel zu den Ausgabeformaten HTML, HTML mit dem Plugin TOCJS (Javascript-Navigationsframe) sowie CHM (Windowshilfe). Ohne Leerseiten.
Aktualisiert am: 18.04.2011. Die EPUB-Generierung ist in der Kapitelausgabe "Dita4Publishers" zu finden.
Anzahl der Downloads: 273
Teilen Sie die URL Ihren Xing-Kontakten mit.

21 Mai 10 DITA-Plugin dita4publishers installieren

{lang: 'de'}

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

Text als PDF downloaden
Titel des Downloads: Dita4Publishers
Art der Publikation: Thema
Beschreibung: Sämtliche Artikel zum Dita4Publishers-Plugin von Eliot Kimber. Besonders geschätzt im Plugin: die ePUB-Dateigenerierung.
Aktualisiert am: 07.12.2011
Anzahl der Downloads: 157
Teilen Sie die URL Ihren Xing-Kontakten mit.