-
Heute: ein großartiger Fehler! Ich habe in meinem Topic einen Link auf ein PDF im Internet gesetzt. <xref href=“http://redakteuse.de/blubber.pdf“ format=“pdf“ scope=“external“>User Guide</xref> Im HTML-Output hat der Link auch super funktioniert, ABER im PDF-Output hat der Link nicht funktioniert. Aaah! Ich ahnte Böses in die Richtung, dass ich hier schon wieder geFOPpt werde und damit erst einmal gar nichts tun kann bis ich nicht ein neues PDF-Tool habe. Und so ist es auch. Nun muss ich irgendeinen Workaround finden, der vermutlich so aussehen wird, dass ich auf eine HTML-Seite verlinken muss (das geht nämlich wiederum) auf der der Nutzer dann selbst… ….den ganzen Beitrag lesen.
-
Eine typische Doku-Situation geht so: Man hat zwei Kapitel, die inhaltlich unter einen Oberkapitel passen und um die Struktur übersichtlicher zu machen, packt man die Zweikapitel mit ihren Überschriften unter eine Ober-Überschrift (siehe unten). 1 Installation 1.1 blubTunes installieren So installieren Sie…bla 1.2 blobTunes installieren So installieren Sie… Ein Problem stellt sich mir aber dar, wenn ich so etwas in DITA umsetzen möchte. Ich schreibe also zwei Topic und stelle beim Zusammenstellen zu einer Map fest, dass ich die in einem Inhaltsverzeichnis eigentlich unter eine Ober-Überschrift packen möchte. Was mache ich nun? Es ist definitiv keine angebrachte Lösung ein Topic… ….den ganzen Beitrag lesen.
-
Das Topic Ein Wort, das nun spätestens seit DITA eingeschlagen ist wie eine Bombe und in vieler Munde ist. In der Welt der Software-Hilfen ist das Topic an und für sich schon länger präsent, da dort die Hilfe in Form von Einzelartikeln präsentiert wird. Oftmals wurde hier aber nicht topic-orientiert geschrieben, sondern eben wirklich nur die Präsentationsform der vielen einzelnen Artikel gewählt. Doch Topic-Orientierung bedeutet vor allem, dass ein Topic ein Thema behandelt. Und zwar ein einziges, das für sich alleine stehen kann: beispielsweise muss die Beschreibung eines Luftballons getrennt von sein von der Beschreibung wie man ihn aufbläst. Außerdem… ….den ganzen Beitrag lesen.
-
Jeder Redakteur für web-basierte Software kennt das Problem, dass die Software, die man zum Doku schreiben benutzt, oft etwas anzeigt, was der Kunde in der Doku so nicht sehen soll. Zum Beispiel steht irgendwo noch „Beta-Version“ im Text oder es werden Testdaten angezeigt („Sie sind als Test Testosteron eingeloggt.“). Man macht also einen Screenshot und ändert den Text ziemlich umständlich in Photoshop. Kurz: eines der nervigen Elemente im Redakteursalltag. Für die Webentwicklung nutze ich den Firebug schon recht lange. Das ist ein Firefox-Addon mit man dem das HTML, CSS und Javascript einer Seite live editieren kann. D.h. man kann beispielsweise… ….den ganzen Beitrag lesen.
-
Eigentlich ist es eine ganz einfache Sache bei DITA: man setzt xml:lang-Attribut auf die gewünschte Sprache/Sprachvariante und zack, sind die Standardtexte (so etwas wie „Achtung“, „Voraussetzung“ u.ä.) lokalisiert. DITA bringt schon eine ganze Latte von Sprachdateien mit sich, die diese Texte enthalten und zwar unter DITA_OT/xsl/common. Nun habe ich diese Dateien erweitert und das hat in der Standardsprache meiner Pilot-Doku (en-us) auch super geklappt das einzubinden. Als ich nun diese Doku in das britische Englisch (also en-gb) übersetzen wollte, wurden die Standardtexe weiterhin aus der Sprachdatei für en-us eingebunden. Ein kurzer, erfolgreicher Test mit der Lokalisierung ins Deutsche hat ergeben,… ….den ganzen Beitrag lesen.
-
Wir befinden uns mit DITA noch in einer Pilotphase, d.h. das ganze muss erst einmal so wenig wie möglich kosten, weil man ja nicht weiß, ob der Weg vielleicht doch nicht der Richtige ist. Das heißt also wir nutzen einfach das, was im Open Tool Kit mitgeliefert wird. Beim PDF-Output hat sich aber ein Layoutmangel gezeigt, der mir die ganze Zeit schon Kopfzerbrechen bereitet und zwar die Absatzkontrolle. Ganz häufig wird zwischen Überschrift und dazugehörendem Text ein Seitenumbruch gemacht (ist das dann auch ein Schusterjunge?). Jedenfalls ging es mir nicht in den Kopf, dass so ein typografischer Grundsatz bei den… ….den ganzen Beitrag lesen.
-
Da verarbeite ich doch gerade die Kartoffeln zum Mittagessen, als mir da was auffällt… Die Arbeit lässt einen auch nie in Ruhe! ….den ganzen Beitrag lesen.
-
Beweggründe dieses Blog zu beginnen Ich bin eine begeisterte Anhängerin davon mein (Un-)Wissen zu teilen und das werde ich hier tun. Und zwar erst einmal aus völligem Eigennutz. Ich befinde mich gerade in einer megaspannenden Phase bei der ich viel Neuland betreten werde. Einige dieser Erfahrungen werde ich hier preisgeben, damit ich das ganze nicht vergesse. Denn es kommt ja vielleicht jemand vorbei, der auch was Schlaues dazu zu sagen hat, es vielleicht besser gemacht hat oder einfach mal sehen will, was andere so treiben. Wer ist die denn? Ich bin eine technische Redakteuse mit Germanistikhintergrund und ergründe in meinem… ….den ganzen Beitrag lesen.