Dokumentation mit DocBook

• About this group
• Forums

• Home
• Groups
• Dokumentation mit DocBook
• Forums
• Grundlagen
• DITA Specialization für Testzwecke gesucht

• 
  Gunthilde Sohn    Premium Member

  The company name is only visible to registered members.

  DITA Specialization für Testzwecke gesucht

  Auch wenn wir uns hier im DocBook Forum befinden, möchte ich eine DITA bezogene Anfrage adressieren:
  
  Für den Betatest der neusten Version unseres DITA-basierten Tools für Technische Dokumentation suchen wir DITA Specializations, mit denen wir den umfangreichen Modelling Support des Tools testen können.
  
  Wenn Sie bereit sind, uns ihre Specialization Files zu senden, bieten wir Ihnen im Gegenzug gerne eine Demo zur Arbeit mit Ihrer Specialization in unserem Dokumentationstool an.
  
  Die ersten drei Einsendungen von Specialization Files honorieren wir mit je einer Flasche Württembergischen Rotwein (mit goldenem Weinsigel versteht sich...)
  
  Es freut sich auf viele Beiträge und grüßt aus Stuttgart,
  
  Gunthilde Sohn
  
  • 24 Oct 2008, 11:51 am
  Gunthilde Sohn wrote: > Auch wenn wir uns hier im DocBook Forum befinden, möchte ich eine > DITA bezogene Anfrage adressieren: > > Für den Betatest der neusten Version unseres DITA-basierten Tools für > Technische Dokumentation suchen wir DITA Specializations, mit denen > wir den umfangreichen Modelling Support des Tools testen können. > > Wenn Sie bereit sind, uns ihre Specialization Files zu senden, bieten > wir Ihnen im Gegenzug gerne eine Demo zur Arbeit mit Ihrer > Specialization in unserem Dokumentationstool an. > > Die ersten drei Einsendungen von Specialization Files honorieren wir > mit je einer Flasche Württembergischen Rotwein (mit goldenem > Weinsigel versteht sich...) > > Es freut sich auf viele Beiträge und grüßt aus Stuttgart, > > Gunthilde Sohn
• 
  Michael Valent    Group moderator

  The company name is only visible to registered members.

  Re: DITA Specialization für Testzwecke gesucht

  Hallo!
  
  Ich weiß nicht, ob es bekannt ist: Hier gibt's auch eine DITA-Gruppe (https://www.xing.com/net/dita/ )? Dort wird sich vielleicht eher jemand finden, denke ich ...
  
  Was uns in dieser Gruppe wahrscheinlich brennender interssiert: Wird dieses Tool auch DocBook unterstützen? Wenn ja, wie?
  
  Grüße aus Wien!
  
  Michael
  
  • 24 Oct 2008, 3:36 pm
  Michael Valent wrote: > Hallo! > > Ich weiß nicht, ob es bekannt ist: Hier gibt's auch eine DITA-Gruppe > (https://www.xing.com/net/dita/ )? Dort wird sich vielleicht eher > jemand finden, denke ich ... > > Was uns in dieser Gruppe wahrscheinlich brennender interssiert: Wird > dieses Tool auch DocBook unterstützen? Wenn ja, wie? > > Grüße aus Wien! > > Michael
• 
  Gunthilde Sohn    Premium Member

  The company name is only visible to registered members.

  Re^2: DITA Specialization für Testzwecke gesucht

  Hallo,
  
  vielen Dank für den Hinweis - ich habe mich gleich angemeldet.
  
  Unser Tool ist auch für DocBook geeignet (die webbasierte Version). Genauer gesagt, war das der Ausgangspunkt. Hier ein paar Informationen und Fragen für eine mögliche Verknüpfung dazu:
  
  Als Basis für unser DITA Redaktionstool haben wir viele Ideen und Erfahrungen der DocBook Lösung verwendet, die unser Unternehmen seit 2004 entwickelt. Diese Docbook-basierte Lösung ist eine web-basierte Lösung, die auf Java J2EE realisiert wurde. Diese Lösung unterstützt vereinfachten DocBook Standard, der aber erweitert wurde, um Content Modularität und Single Sourcing zu unterstützen. So haben Redakteure die Möglichkeit, mit DocBook ähnlich wie mit der DITA Vorgehensweise zu arbeiten (Spezialisierungen ausgenommen)
  
  Redakteure können Contentblöcke erstellen und sie in unterschiedliche Books verlinken. Jeder Block entspricht einer DocBook "Section" mit Inhalten. So eine Section ist in ein oder mehreren Books verlinkt, die aus konzetioneller Sicht ähnlich wie eine DITA Map aufgebaut sind. Aus DocBook Sicht enthält ein solches Book "chapters", die wiederum aus "sections" bestehen, die bereits erstellte Contentblöcken referenzieren.
  
  Die Redakteure können so verschiedene DocBook Dokumente erstellen indem sie verschiedene Kombinationen von Contentblöcken nutzenb. Diese Books sind sofort in HTML verfügbar, man kann über das Web auf sie zugreifen oder in PDF Format exportieren. Auch Import/Export Funktionen in reinem DocBook/XML Format stehen zur Verfügung.
  
  Die Anwendung unterstützt auch die Vererbung, wenn ein Buch auf Basis eines anderen erstellt werden kann. Dann muss der Redakteur nur noch ausgewählte Teile des Parent überschreiben. Internationalisierungs- Support und Export/Import für Übersetzungen sind ebenfalls vorhanden.
  Diese DocBook Lösung wurde als Hilfesystem für die Einkaufsanwendungen bei Daimler designt und seit der Einführung in 2004 laufend erweitert und weltweit ausgerollt. Somit handelt es sich um eine skalierbare Lösung auf Enterprise Level und enthält für eine solche Lösung typische Features wie Versionskontrolle, Locking, Workflow, Content Validation, etc. Andere interessante Features sind:
  - multidimensionaler Content Support – erlaubt den Redakteuren maximale Wiederverwendbarkeit von Contents
  - kontextabhängige Generierung von Büchern – ermöglicht die Verwendung von Variablen (entities), die während der Buch-transformation umgewandelt werden. So können leicht verschiedene Versionen erstellt werden.
  - Funktionen für dynamische Content Generierung, dynamische Bücher oder Strukturen, die z.B. für Change logs oder die Erstellung von FAQs genutzt werden können.
  
  Aus Sicht der Redaktion sind die Editoren ist zu erwähnen. Das Tool verfügt ausser über einen XML Editor einen web-basierten WYSIWYG Editor, aber auch jeder andere externe Editor per export/import unterstützt wird.
  
  Wir überlegen derzeit auch, DocBook auf unserer DITA Lösung zu unterstützen. Eine Idee für die Implementierung ist, DocBook durch eine DITA Spezialisierung zu emulieren, die ein bestimmtes DocBook Subset nachahmt. Dieser Ansatz ist nicht einfach, da DocBook Elemente / Attribute enthält, die in DITA reservierte Begriffe sind. Ferner ist DocBook auf Attribute angewiesen, was zu Problemen bei der DITA DocBook Spezialisierung führen kann. Import/Export von DocBook nach DITA (und zurück) wird benötig. Wenn jemand hierzu Idee oder bereits Erfahrungen hat, freuen wir uns darauf und würden wir sie gerne diskutieren.
  Ferner sind wir an allen Hinweise zu typischen Problempunkten oder Anforderungen bei der Arbeit mit Dokumentationstandards (auch z.B. Branchen spezifisch) interessiert.
  
  • 27 Oct 2008, 12:30 pm
  Gunthilde Sohn wrote: > Hallo, > > vielen Dank für den Hinweis - ich habe mich gleich angemeldet. > > Unser Tool ist auch für DocBook geeignet (die webbasierte Version). > Genauer gesagt, war das der Ausgangspunkt. Hier ein paar > Informationen und Fragen für eine mögliche Verknüpfung dazu: > > Als Basis für unser DITA Redaktionstool haben wir viele Ideen und > Erfahrungen der DocBook Lösung verwendet, die unser Unternehmen seit > 2004 entwickelt. Diese Docbook-basierte Lösung ist eine web-basierte > Lösung, die auf Java J2EE realisiert wurde. Diese Lösung unterstützt > vereinfachten DocBook Standard, der aber erweitert wurde, um Content > Modularität und Single Sourcing zu unterstützen. So haben Redakteure > die Möglichkeit, mit DocBook ähnlich wie mit der DITA Vorgehensweise > zu arbeiten (Spezialisierungen ausgenommen) > > Redakteure können Contentblöcke erstellen und sie in unterschiedliche > Books verlinken. Jeder Block entspricht einer DocBook "Section" mit > Inhalten. So eine Section ist in ein oder mehreren Books verlinkt, > die aus konzetioneller Sicht ähnlich wie eine DITA Map aufgebaut > sind. Aus DocBook Sicht enthält ein solches Book "chapters", die > wiederum aus "sections" bestehen, die bereits erstellte > Contentblöcken referenzieren. > > Die Redakteure können so verschiedene DocBook Dokumente erstellen > indem sie verschiedene Kombinationen von Contentblöcken nutzenb. > Diese Books sind sofort in HTML verfügbar, man kann über das Web auf > sie zugreifen oder in PDF Format exportieren. Auch Import/Export > Funktionen in reinem DocBook/XML Format stehen zur Verfügung. > > Die Anwendung unterstützt auch die Vererbung, wenn ein Buch auf Basis > eines anderen erstellt werden kann. Dann muss der Redakteur nur noch > ausgewählte Teile des Parent überschreiben. Internationalisierungs- > Support und Export/Import für Übersetzungen sind ebenfalls vorhanden. > Diese DocBook Lösung wurde als Hilfesystem für die > Einkaufsanwendungen bei Daimler designt und seit der Einführung in > 2004 laufend erweitert und weltweit ausgerollt. Somit handelt es sich > um eine skalierbare Lösung auf Enterprise Level und enthält für eine > solche Lösung typische Features wie Versionskontrolle, Locking, > Workflow, Content Validation, etc. Andere interessante Features sind: > - multidimensionaler Content Support – erlaubt den Redakteuren > maximale Wiederverwendbarkeit von Contents > - kontextabhängige Generierung von Büchern – ermöglicht die > Verwendung von Variablen (entities), die während der > Buch-transformation umgewandelt werden. So können leicht verschiedene > Versionen erstellt werden. > - Funktionen für dynamische Content Generierung, dynamische Bücher > oder Strukturen, die z.B. für Change logs oder die Erstellung von > FAQs genutzt werden können. > > Aus Sicht der Redaktion sind die Editoren ist zu erwähnen. Das Tool > verfügt ausser über einen XML Editor einen web-basierten WYSIWYG > Editor, aber auch jeder andere externe Editor per export/import > unterstützt wird. > > Wir überlegen derzeit auch, DocBook auf unserer DITA Lösung zu > unterstützen. Eine Idee für die Implementierung ist, DocBook durch > eine DITA Spezialisierung zu emulieren, die ein bestimmtes DocBook > Subset nachahmt. Dieser Ansatz ist nicht einfach, da DocBook Elemente > / Attribute enthält, die in DITA reservierte Begriffe sind. Ferner > ist DocBook auf Attribute angewiesen, was zu Problemen bei der DITA > DocBook Spezialisierung führen kann. Import/Export von DocBook nach > DITA (und zurück) wird benötig. Wenn jemand hierzu Idee oder bereits > Erfahrungen hat, freuen wir uns darauf und würden wir sie gerne > diskutieren. > Ferner sind wir an allen Hinweise zu typischen Problempunkten oder > Anforderungen bei der Arbeit mit Dokumentationstandards (auch z.B. > Branchen spezifisch) interessiert.