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

24 Nov 11 Der Romantische Nebel des Buchmarkts (RNB)

{lang: 'de'}

Im Oktober 2011 schrieb Sascha Lobo seine Allgemeinen Feststellungen zur Buchsituation. Nicht nur der Titel, auch der erste Absatz der Feststellungen gleichen einem Manifest:

0. Ich möchte in einer Welt leben, in der kluge Leute für das Nachdenken bezahlt werden, und dazu sind Bücher ziemlich gut geeignet. Das ist übrigens auch mein Argument für ein starkes Urheberrecht (mit digitalen Anpassungen, allerdings).

Leider verhält es sich bei mir nicht ganz so romantisch – obwohl ich mein Geld auch durch Nachdenken verdiene. Ich habe als Technischer Redakteur meine Urheberrechte am ersten Arbeitstag meinem Chef überschrieben. Er bezahlt mich nicht fürstlich, aber regelmäßig. Dafür gibt er täglich das Thema vor. Nun werde ich mich mit allzu harscher Kritik gegenüber meinem Chef zurückhalten. Solange wohl, wie dessen Geschäftsmodell mich und meine Familie ernährt.

Der Buchmarkt wird so lange nicht mit einem neuen Geschäftsmodell aufwarten, wie er genug Menschen ernährt. Natürlich wird es immer einen Buchmarkt geben. Genauso wie es noch Druckereien mit Druckern aus Fleisch und Blut gibt, obwohl ja jeder einen Drucker auf dem Schreibtisch zu stehen hat. Wer schon mal versucht hat, eine ePub-Datei mit einem Schleifenband zu versehen, wird sich das gänzliche Verschwinden des Buchmarkts sowieso nicht wünschen.

Gestern hielt ich im Supermarkt Lobos Wortschatz-Taschenbuch in der Hand. Ein Meisterwerk der Taschenbuchkunst. Sowohl der Inhalt als auch das Design waren genial. Und trotzdem hätte ich es nicht für einen Euro gekauft. Es will etwas von meinem Zeitkontingent beanspruchen – mit unterhaltsamen Zeittotschlagen! Aber was ist schon das Lesen von unterhaltsamen Zeittotschlagtexten gegen das Schreiben eigener Texte? Gegen das Aktivwerden, das Kreieren, die Kommunikation? Es beschlich mich ein unbeschreibares Gefühl der Trauer.

Lobos Wortschaftzfähigkeit ist gewaltig. So konstatiert er in den Feststellungen zur Buchsituation, nirgends gibt es alle Bücher wegen DRM, dem Senfgas des Internet. Ich war entzückt ob dieses Bildes. Bis die Verzückung nach einigen Tagen nachließ und ich mich fragen konnte: Was hat nur das Internet mit DRM zu tun? Richtiger muss es doch heißen: … dem Senfgas des Buchmarkts!

Ich habe der Ursache der lähmenden und alsbald nachlassenden Verzückung einen Namen gegeben: es ist der Romantische Nebel des Buchmarkts (RNB).

Woran erkennt man den RNB? Das ist ja das Schwierige. Er vernebelt auf geniale Weise. Aber ein sicheres Indiz für das Vorhandensein des RNB ist, dass sich der Autor an Amazon abmüht. Denn jedem außerhalb des Buchmarkts ist klar: Amazon is shipping goods. Buchmarkt und Amazon basieren auf dem selben Geschäftsmodell. Es ist, als ob zwei Verkäufer der Katze im Sack über die Beschaffenheit des Sackes fachsimpeln.

Ist der RNB etwas Schlimmes? Nein, er ist romantisch, unterhaltsam und inspirierend – wie jede Innenansicht. Außerdem reisen manche mit Nebelhörnern durchs Land und dürfen vor einem Publikum vortragen, die den RNB schlichtweg für den Nebel des Grauens halten. Auf diese Idee muss man erstmal kommen!

Wo immer ich den Romantischen Nebel des Buchmarkts vermute, lasse ich ein paar Tage verstreichen, bis der Nebel sich legt. Dann durchstöbere ich die Zuschriften zu z.B. den Allgemeinen Feststellungen zur Buchsituation nach unbeantworteten Kommentaren. Das sind die Außenansichten zur Buchsituation. Es funktioniert! Nach der romantischen Unterhaltung folgt nun die Inspiration.

Teilen Sie die URL Ihren Xing-Kontakten mit.

30 Mai 11 Dauerunterversorgung der Dokumentation?

{lang: 'de'}

Fristet im Software-Unternehmen die Technische Dokumentation das Leben eines unterversorgten Patienten? Vorschläge an die Redakteure und Geschäftsführer für die Zeit bis zur nächsten Visite.

Innovation immer mit Gewinn?

Vorigen Sommer verschlug es meine Familie wieder in den Freizeitpark IKEA. Ein Abstecher in den Sanitärbereich des Restaurants ließ mich schmunzeln: die Nachbartür war mit etwas mehr Text versehen als meine ersehnte!

Da kann keiner böse sein.

Noch lange habe ich überlegt, warum eine Tür mich zum Schmunzeln bringen konnte. Ich bemühte intellektuelle Konzepte wie Kontext oder Emotion. Immerhin hatte der Verfasser es geschafft, ein Verbot, eine Entschuldigung für eine verschlossene Tür in einen Sympathieträger umzumünzen! Doch nach einigen Tagen war ich dann bereit, es mir einzugestehen. Es war purer Neid! Nicht so sehr auf den Spruch, sondern dass dieser sich auf Tausenden von Türen ausbreiten konnte! Was muss das für eine innovative Geschäftsführung sein, in dessen Biotop nicht nur solche Ideen entstehen, sondern diese auch realisiert werden! Es ist bestimmt weniger aufwendig, für den Kundensupport ein Twitter-Account einzurichten, als Tausende Türen zu kennzeichnen. Trotzdem wird Ihnen Ersteres im Softwareunternehmen nicht so schnell gelingen!

Überall im Netz wird von Technischen Redakteuren die mangelnde Unterstützung für eine professionellere
Dokumentation beklagt. Oft herrscht im Softwareunternehmen die Mentalität des Jeder kann schreibens vor. Ich bildete mir ein, dass eine rudimentäre Technische Redaktion ähnlich zu werten ist wie diese Tür: als Indikator für die Innovationskultur im Unternehmen – also ebenfalls rudimentär. Bis Ute Klingelhöfers Frage Warum sollte man in die Technische Redaktion investieren? die Problematik der Dauerunterversorgung wieder auf die Füße stellte. Dieser Artikel soll Redakteuren helfen, die Gegenwart im Softwareunternehmen zu verstehen und sie befähigen, Ihre Kraft auf innovative Veränderungen in der Zukunft des Unternehmens zu verwenden.

Text als PDF downloaden
Titel des Downloads: Dauerunterversorgung der Dokumentation?
Art der Publikation: Artikel
Beschreibung: Fristet im Software-Unternehmen die Technische Dokumentation das Leben eines unterversorgten Patienten? Vorschläge an die Redakteure und Geschäftsführer für die Zeit bis zur nächsten Visite.
Aktualisiert am: 30. Mai 2011
Anzahl der Downloads: 71

(weiterlesen…)

Teilen Sie die URL Ihren Xing-Kontakten mit.

10 Mrz 11 Icon Teil 2: ICO-Datei erstellen und einbinden

{lang: 'de'}

Das Icon im Firefox-Browser

Sobald Sie Icon-Graphiken in den Größen 16, 32, 48 und 128 px haben, können Sie daraus eine Icondatei erstellen. Je nach Erfordernis erscheint das jeweilige Icon in der richtigen Größe. So z.B. auf dem Desktop als Verknüpfungssymbol oder im Internetbrowser an diversen Stellen wie z.B. der URL-Adresszeile. Das Open-Souce-Programm Icon Sushi hilft bei der ICO-Dateierstellung.

  1. Klicken Sie in Icon Sushi auf die Symbolschaltfläche Öffnen, und laden Sie sämtliche Icon-Graphiken ins Programm. Sie können mehrere markieren und im Block ins Programm laden. Das Icon der Größe 256 px kann nicht ins Programm importiert werden.

    Dateien sämtlicher Größen laden

  2. Markieren Sie sämtliche Bilddateien und klicken Sie auf die Symbolschaltfläche Save as Multiple Icon.

    Mehrfach-Icon erstellen

  3. Wählen Sie im Fenster Save as Multiple Icon einen Speicher-Ordner und einen Namen für die ICO-Datei. Klicken Sie abschließend auf Speichern.
  4. Kopieren Sie die ICO-Datei in das Hauptverzeichnis Ihrer Online-Hilfe. Bei einer WordPress-Installation kopieren Sie die Icondatei in das Hauptverzeichnis bzw. in das Hauptverzeichnis Ihres Templates.
  5. Bei WordPress: binden Sie die Icondatei (dateiname.ico) in die header.php innerhalb des head-Tags ein. Haben Sie keine WP-Installation, tragen Sie die URL ohne php-Tags ein.
    <link rel="shortcut icon" href="<?php bloginfo('url'); ?>/dateiname.ico"
    type="image/x-icon" />
    

Text als PDF downloaden
Titel des Downloads: Ideen für Dokumentationen und Online-Hilfen
Art der Publikation: Kapitel
Beschreibung: Das gesamte Kapitel als PDF-Datei. Ohne Leerseiten für die A4-Ausgabe optimiert.
Aktualisiert am: 10.03.2011
Anzahl der Downloads: 247

Links zum Thema

  1. Download Icon Sushi von pcmasters.de
Teilen Sie die URL Ihren Xing-Kontakten mit.

01 Mrz 11 Icon Teil 1: Grundform des Icons in Inkscape erstellen

{lang: 'de'}

Wenn man nicht gerade Webseiten und Online-Hilfen am Fließband erstellt, kommt man als Technischer Redakteur nicht so oft in die Verlegenheit, ein Favicon erstellen zu müssen. Als ich zum zweiten Mal vor der Aufgabe stand, hatte ich alles bisherige zur Iconerstellung vergessen. Für mich und für manch weiteren Redakteur nun die Anleitung fixiert.

  1. Erstellen Sie im Open Source Graphikprogramm Inkscape eine Grundform Ihres Icons. Bestimmt hilft Ihnen wie mir ein Graphiker weiter.
  2. Es gilt, Icons für die Größen 16, 32, 48 und 128 px zu erstellen. Erstellen Sie ein Quadrat mit 32px Breite und Höhe.

    Breite und Höhe des Quadrats einstellen

  3. Bestimmen Sie Farbe der Füllung und der Kontur des Quadrats. Soll das Icon transparent sein, wählen Sie links die Kreuzfarbfläche für “keine Farbe”.
  4. Soll das Icon und somit diese Hintergrundquadrat abgerundetet Ecken haben, markieren Sie das Rechteckt. Anschließend klicken Sie auf das Rechteck-/Quadrat-Tool in der Werkzeugleiste und ziehen den Anfasser in Kreisform in der rechten oberen Ecke in die diagonale, linke untere Ecke.

    Mit Rechtecktool die Ecken abrunden

    Mit Rechtecktool die Ecken abrunden

  5. Falls Ihnen das Icon nicht plastisch genug erscheint, fügen Sie der Icon-Grundform einen Farbverlauf hinzu.

    Mit dem Farbverlauf-Tool arbeiten

  6. Positionieren Sie das Objekt der Grundform in die Mitte des Quadrats.
  7. Markieren Sie beide Objekte und klicken Sie auf Objekte > Gruppieren.
  8. Klicken Sie auf Datei > Bitmap exportieren.

    Bitmap exportieren aus Inkscape

  9. Klicken Sie im Fenster Bitmap exportieren auf Auswahl.
  10. Optional: Hinterlegen Sie im Feld Dateiname einen Dateipfad.
  11. Klicken Sie auf Exportieren. Es wird im ausgewählten Pfad eine PNG-Datei erzeugt.
  12. Wiederholen Sie die Schritte für die Größen 16, 48, 128 und 256 px.

Text als PDF downloaden
Titel des Downloads: Ideen für Dokumentationen und Online-Hilfen
Art der Publikation: Kapitel
Beschreibung: Das gesamte Kapitel als PDF-Datei. Ohne Leerseiten für die A4-Ausgabe optimiert.
Aktualisiert am: 10.03.2011
Anzahl der Downloads: 247

Links zum Thema

  1. Download Inkscape von heise.de
Teilen Sie die URL Ihren Xing-Kontakten mit.

11 Jan 11 Die Konterrevolution der elektronischen Bücher

{lang: 'de'}

»E-Books: Die Konterrevolution der elektronischen Bücher« · http://bit.ly/f6EuU4 (FTD)

Teilen Sie die URL Ihren Xing-Kontakten mit.

21 Dez 10 Aus einem E-Book zitieren

{lang: 'de'}

Die letzten Wochen habe ich mir die Mühe gemacht, meine Diplomarbeit über die DDR-Literatur der 70er und 80er Jahre mit Hilfe des DITA-OTs neu zu veröffentlichen. Da ich weiß, dass einige Schüler und Studenten nur bestimmte Kapitel interessieren, habe ich die Arbeit sowohl als Gesamtausgabe als auch als einzelne Kapitel veröffentlicht. Jedes Kapitel erhielt ein verkürztes Literaturverzeichnis und Stichwortverzeichnis. Und siehe da: als PDF erhält das Kapitel natürlich eine andere Seitennummerierung als das integrierte Kapitel in der Gesamtausgabe! Natürlich soll auch eine ePUB-Version folgen und so weiter. Auf welche Weise soll man Zitiermöglichkeiten schaffen?

Kapitel und Abschnitte

Ich habe mich entschieden, den Text redaktionell zu bearbeiten und ihn in Kapitel und Abschnitte zu unterteilen. Die Abschnitte sind sinnvoll zusammenhängende Texteinheiten. Es hätte aber auch eine stupide Absatzzählung werden können. Es ist also ähnlich wie die Einteilung in der Bibel oder in Gesetzestexten. Das funktioniert so lange, wie der Autor bei Entstehung daran denkt, die Nummerierung vorzunehmen. Oder nachträglich eine Nummerierung vorgenommen wird. Was ist aber mit der Vielzahl von bereits veröffentlichten E-Books oder Blog-Posts?

Eines Lösung müßte m. E.  folgendes berücksichtigen:

  1. Eine Referenzierung auf Textstellen soll für jedermann nachvollziehbar sein – ohne Hilfesmittel. Das bedeutet, dass eine lange Prüfsumme zum Identifizieren nicht ohne Hilfsmittel zu verifizieren wäre und somit nicht in Frage kommt?
  2. Das Referenzier-System muss von jedermann anwendbar sein. Eine DOI, die eine Agentur davor schaltet und Kosten mit sich bringt, kommt ebenfalls nicht in Frage?
  3. Ideal wäre ein Referenzier-System, das auch auf bereits veröffentlichte Text jeglicher Art Anwendung finden kann.

Wie könnte innerhalb der DITA-Spezifikation eine Lösung aussehen?

Links zum Thema

  1. Blogpost auf teleread.com
  2. Lesen.net – Forum
Teilen Sie die URL Ihren Xing-Kontakten mit.

20 Okt 10 Manu, Hollywood und Social Media

{lang: 'de'}

Manu ist eine erfrischende Bloggerin – denn sie warf einen Kiesel in die ruhige  See der Aufklärung. Sie recherchierte im Juni 2010, dass hinter in Schulen ausgelegten Geschenkgutscheinen für Bücher ein Vertrieb von Finanzdienstleistungen steckt. Der Vertrieb warf im Oktober 2010 einen mannsgroßen Brocken auf den Kiesel: Per Anwaltschreiben wurde die Bloggerin aufgefordert, den Post zu löschen. Nun schlagen die Wellen hoch, werden größer – der Groundswell beginnt, hier und jetzt und immer weiter…

Der Groundswell oder wie man ein Erdbeben lostritt

Charlene Li und Josh Bernoff haben im gleichnamigen Buch viele Beispiele zusammengetragen, wie Unternehmen vom Groundswell überrollt wurden. Den ersten Groundswell lösten 2007 die großen Filmgesellschaften wie Disney, Warner Bros. und Sony mit einem Brocken auf digg.com aus: Digg sollte ein Link, der auf eine Webseite mit dem geknackten HD-DVD-Verschlüssungscode 09 F9 11 02… zeigte, entfernen. Und tatsächtlich entfernten die digg-Macher den Link.

Nun besorgten sich andere Blogger den Code. Am nächsten morgen tauchten 88 Links mit dem Code auf. Zum Abend waren es schon 3172 Links. Digg.com gab es auf, Links zu zensieren. Grant Robertson aus der digg-Mannschaft kommentierte das Phänomen mit einem Spruch aus einer TV-Show:

Aus dem Internet kann man nichts entfernen. Das ist so, als würde man versuchen, das Pipi aus einem Schwimmingpool zu bekommen.

Manus Recherche ist auch hier zu finden: www.webcitation.org/5tb90oNIc. Und an vielen weiteren Stellen.

Natürlich wissen wir, dass man nichts geschenkt bekommt. Immer ist eine Gegenleistung zu erbringen. Manu hat sich im Fall der Büchergeschenkgutscheine die Zeit genommen, die Gegenleistung zu ergründen. Die Scheine konnten so lange in Schulen ausliegen, wie sich niemand die Zeit nahm, auf sie in irgendeiner Form zu reagieren. Sie hat sie sich genommen. Nun wird sie viel unangenehme Zeit aufbringen, um Menschen in Deutschland die Funktionsweise des sozialen Internets nahe zu bringen.

Sowohl die Filmgesellschaften als auch der Finanzvertrieb nahmen an, dass es sich mit einem Blogpost genauso verhält wie mit einem Papieraushang am Schwarzen Brett: wenn man ihn abnimmt, gerät die Information in Vergessenheit. Manus Blogpost wird natürlich auf Jahre hinaus im Web präsent sein. Alle Beteiligten verlieren viel Zeit und für den Finanzvertrieb ist es der Kommunikations-Gau schlechthin. Da sich der Blogpost nicht mehr aus dem Internet entfernen läßt, hat der Finanzvertrieb nur eine Chance, Vorbehalte über sein Wirken auszuräumen: er muss ein anderes Geschäftsmodell entwickeln und darüber im Internet berichten. Ein Geschäftsmodell, bei dem man stolz und froh ist, wenn Blogger darüber kostenlos berichten und Werbung machen. (weiterlesen…)

Teilen Sie die URL Ihren Xing-Kontakten mit.

18 Okt 10 Technische Dokumentation im Überblick

{lang: 'de'}

Beim Ditalog steht DITA als eine bestimmte Technologie im Mittelpunkt. DITA steht für Single Source Publishing und Wiederverwendbarkeit (reuse). Der Redakteur ändert an einer zentralen Stelle die Bezeichnung für die Schaltfläche A in B – und schwupps – heißen nun sämtliche A-Schaltflächen B. Vererbung in Sekundenschnelle. Natürlich ist das Blog ganz aus Sicht des Redakteurs geschrieben. Nämlich, wie ein Redakteur seine Startschwierigkeiten im Praxisalltag überwindet.

Hauptanwendungsgebiet von DITA ist immer noch die Technische Dokumentation. Letztere soll hier im Blog nicht zu kurz kommen: die Sicht auf das Endprodukt – die Nutzersicht. Viele Blogs geben Hinweise und Tipps in Sachen Technischer Dokumentation. Ein umfangreiches deutschsprachiges Angebot unterbreitet Marc Achtelig auf www.indoition.com in seiner Rubrik Know-How. Besondere Erwähnung verdienen die Punkte:

eine umfangreiche, gut sortierte Linksammlung, in der es sich zu stöbern lohnt.  Wer Marc Achteligs Know-How offline lesen möchte, dem sei diese PDF-Broschüre zum Download empfohlen:

Teilen Sie die URL Ihren Xing-Kontakten mit.

08 Sep 10 Software für Leute…

{lang: 'de'}

Obwohl heute durch die Twittersuche via #techcomm gefunden, gab es wohl schon vor 10 Jahren Binsenweisheiten. Manchmal hilft es jedoch ungemein, sie schwarz auf weiß vor sich zu sehen:

Softwareoberfläche gestalten

Screenshot von joelonsoftware.com

Teilen Sie die URL Ihren Xing-Kontakten mit.

28 Jun 10 How do you design for function?

{lang: 'de'}

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

Teilen Sie die URL Ihren Xing-Kontakten mit.