Warum wird docbook benötigt

warum wird docbook benötigt?

Das DocBook-Format wurde vom OASIS-Konsortium speziell für technische Dokumentation entwickelt. Es bietet eine umfangreiche Sammlung von Étiquettes zur Beschreibung des Inhalts Ihres Dokuments.
Hier sind einige Schlüsselpunkte, die helfen, DocBook zu verstehen:

• DocBook ist eine Auszeichnungssprache
  Sie ähnelt in dieser Hinsicht sehr HTML. Die Étiquettes geben Ihrer Dokumentation eine Struktur und sind mit dem Informationstext vermischt.
  Dieser besondere Aspekt revolutioniert die Dokumentationslokalisierung, da die DTP-Phase (Formatierung des Textes) einmalig indirekt durch Tagging des Originaltextes durchgeführt wird. Übersetzer müssen nur „zwischen den Étiquettes" übersetzen und erzeugen durch einen einfachen Tastendruck die übersetzte Ausgabe.
• Sie ist für technische Dokumentation konzipiert
  DocBook eignet sich perfekt für Dokumentation von Automotorenteilen. Allerdings ist sie stark auf Softwaredokumentation ausgerichtet.
• Technisch ist DocBook eine SGML- oder XML-DTD
  Dies ermöglicht die Nutzung vieler SGML- und XML-fähiger Tools. Während DocBook als XML-Implementierung relativ neu ist, hat es eine lange Geschichte als SGML-Implementierung.
• DocBook ist keine Präsentationssprache
  DocBook achtet sorgfältig darauf, nicht festzulegen, wie die endgültige Dokumentation aussieht. Dies ermöglicht es dem Autor, sich auf die Organisation und Bedeutung des Dokuments zu konzentrieren. Alle Präsentationsfragen werden an Stylesheets delegiert.
  Dies gewährleistet, dass alle Ihre Dokumente ein einheitliches Erscheinungsbild haben, unabhängig davon, wer der technische Autor ist.
• DocBook ist anpassbar
  Die DTD lässt sich dank ihrer modularen Struktur leicht an die jeweiligen Anforderungen anpassen. Man muss sich jedoch bewusst sein, dass dies unter Beachtung von SGML-/XML-Konventionen erfolgen muss und Inkompatibilitäten entstehen können.
  Wird DocBook zusammen mit Norman Walshs modularen Stylesheets verwendet, lässt sich auch die Art anpassen, in der eine DocBook-Datei gedruckt oder online veröffentlicht wird.
• DocBook ist umfassend
  Die große Anzahl der in DocBook definierten Étiquettes garantiert, dass es eine breite Palette von Situationen und Verarbeitungsanforderungen bewältigen kann.
  Dies macht es zwar etwas schwierig zu erlernen, aber man kann Dokumentation schreiben, indem man nur einen begrenzten Satz von Étiquettes kennt und bei Bedarf auf die Referenzdokumentation verweist.

Comments