Autor: Kai Weber

Nachlese zu #XUGS24: Webinar und DocBook

Teilnehmerliste
~ Kai Weber

Am vergangenen Mittwoch, den 22. April 2020, fand #XUGS24 in Form eines Online-Webinars statt. Das war eine aus der Corona-Kontaktbeschränkungsnot geborene Idee, ein bereits geplantes Treffen doch noch stattfinden zu lassen, auch wenn es nicht in den Räumen der Hochschule der Medien in Stuttgart stattfinden konnte.
Im Orga-Team der XUGS herrschte einerseits ein bisschen Skepsis, ob XUGS-Treffen funktionieren können, ohne sich von Angesicht zu Angesicht begegnen zu können, andererseits aber auch die Lust, sich auf ein Wagnis des Neuen mal einzulassen. Im Nachhinein können wir froh sein, das Treffen zum Thema DocBook in dieser Form durchgeführt zu haben, das Feedback vor allem der überregionalen Teilnehmenden war durchweg positiv.
Doch eine positive Überraschung erwartete uns gleich zu Beginn. Neben den beiden angekündigten Praxisberichten aus dem DocBook-Umfeld kam aus der Teilnehmerrunde das spontane Angebot eines dritten solchen Berichts. Vielen Dank an den XMLArbyter Thomas Meinike für den Vorschlag und die Präsentation!

Technische Dokumentation für das parsX-Framework

Quellenarbeit an der Doku des parsX-Frameworks

Den Aufschlag machte Tobias Fischer von der pagina GmbH Publikationstechnologien in Tübingen. Er zeigte einen klassischen Anwendungsfall von DocBook, nämlich die technische Dokumentation für das parsX-Framework, einem kommerziellen Toolpaket zur Arbeit mit dem Open-Source-Dokumentformat parsX. Seine Live-Präsentation zeigte das Authoring der Inhalte im oXygen XML-Editor,  die Konfiguration des Ausgabeszenarios durch Setzen von Parametern und durch Hinterlegung eigener CSS-Regeln und die eigentliche Transformation der DocBook-Quelldateien in statisches HTML. Fischer betonte die einfache Anpassbarkeit, die geringen Anforderungen an den Webserver beim Ausspielen des generierten HTMLs und der komfortablen Navigation und Durchsuchbarkeit der Seite, die mit Hilfe des von Synchrosoft entwickelten Frameworks Oxygen WebHelp erzeugt wurde.

Akademisches Schrifttum mit DocBook

Erste Orientierung in DocBook

Ich selbst zeigte anschließend die Anwendung von DocBook zur Auszeichnung und Ausgabe einer akademischen Abschlussarbeit. Typische Elemente, die für eine solche Publikation nötig sind, wurden kurz angerissen: Verwaltung von Bibliografien und Glossaren, Erstellen eines Registers, Einbettung mathematischer Formeln. Anschließend präsentierte ich in einem einfachen Beispiel die Anpassung des DocBook-Schemas und des DocBook-XSL, um im Text einige Variablen zu setzen, die erst zum Rendering-Zeitpunkt befüllt werden. Die Folien zum Vortrag stehen hier auf der Seite zum Download bereit [PDF]. Außerdem ist das gesamte Projekt (Oxygen-Projektdatei, XML-Quelldaten, Anpassungen, Folien) in GitHub zum Herunterladen und Nachvollziehen erhältlich. Herzlichen Dank auch an dieser Stelle noch einmal an Gerrit Imsieke von le-tex publishing services für die ursprüngliche Inspiration (siehe Folien).

Teilnehmerliste

Studentisches Projekt zur Ausgabe mobiler Dokumentationen

In der spontan aufgenommenen dritten Präsentation stellte uns Dr. Thomas Meinike von der Hochschule Merseburg ein Projekt vor, in dem er mit Studierenden eine mobile Dokumentationsapplikation mit jQuery mobile aufgebaut und als Quellformat DocBook genutzt hat. Ein Bericht zu dem Projekt ist auf der Website der Hochschule verfügbar. Besonders interessant war dabei, dass in diesem Projekt nicht auf den im Oxygen Editor eingebauten XSL-Stylesheets aus dem Umfeld der DocBook-Community aufgesetzt wurde, sondern die XSL-Transformationen von der Pike auf von den Studierenden entwickelt wurden und damit gezeigt werden konnte, wie weit man schon mit 500 Zeilen XSLT-Code kommt.
Thomas Meinike hat auf seiner Website nicht nur eine kurze Nachricht zur XUGS24 veröffentlicht, sondern seinen Teil auch mitgeschnitten und online bereitgestellt, so dass man ihn sich nachträglich jederzeit noch einmal ansehen kann. Vielen Dank auch dafür!

Abschlussdiskussion

Teilnehmerliste
Abschlussdiskussion

Im Feedback der Teilnehmenden ist das Veranstaltungsformat gut angekommen. Die Befürchtung, dass inzwischen aufgrund wochenlanger Homeoffice-Arbeit eine gewisse Telekonferenz-Müdigkeit eingetreten sei, wurde nicht bestätigt. Auch die Kombination von drei „mittellangen“ Vorträgen mit Praxisbeispielen wurde positiv genannt. Beim Ausblick in die Zukunft wurde als spannendes Thema mehrfach DITA genannt, aber auch EPUB. Insbesondere die überregional Teilnehmenden waren froh, auf dem Online-Wege überhaupt an der Veranstaltung partizipieren zu können. Im Chatfenster der Veranstaltung stellte Markus Müller-Trabucchi von der XML-User-Group Berlin (XUGBER) in Aussicht, dass es dort möglicherweise demnächst mit einem ähnlichen Format weitergehen könnte. Wir freuen uns drauf!

Mehr Feedback?

Im Zuge der DSGVO-Diskussionen haben wir die Kommentarfunktion hier im XUGS-Blog abgeschaltet. Ihr könnt uns für Rückfragen oder Feedback aber per E-Mail an info(at)xugs.de erreichen und findet uns auf Twitter (@xugstuttgart) oder Xing (Gruppe XML User Group Stuttgart).

XUGS #24: DocBook in der Praxis

~ Kai Weber

Das nächste Treffen der XML User Group Stuttgart (XUGS) wird am 22. April stattfinden, aber dieses Mal nicht wie gewohnt an der Hochschule der Medien in Stuttgart-Vaihingen, sondern per Online-Konferenz-Tool.
In dieser vierundzwanzigsten Zusammenkunft der XUGS werden wir einen Blick auf den OASIS-Standard DocBook werfen. Wir wollen dabei bewusst keine allgemeine Einführung geben, sondern zwei Anwendungsfälle aus der Praxis vorstellen:

  • Tobias Fischer (Leiter Entwicklung bei der pagina GmbH, @tobias_fischer) wird zunächst zeigen, wie die technische Dokumentation des parsX-Frameworks in DocBook gepflegt und mit Hilfe von Oxygen-Bordmitteln als Online-Hilfe ausgegeben wird.
  • Kai Weber (Entwickler im Bereich Digital Humanities der pagina GmbH, @fruehlingstag) stellt dann vor, wie er eine akademische Abschlussarbeit in DocBook erfasst und nach PDF ausgegeben hat. Dabei geht es dann etwa um die Einbettung von MathML, die Verwaltung von bibliografischen Angaben und Glossaren, sowie individuelle Anpassungen am DocBook-Schema und den Standard-XSL-Transformationen.

Wir laden alle Interessierten herzlich ein, sich am 22. April ab 18.15 Uhr in GoToMeeting anzumelden – offizieller Beginn ist dann um 18.30 Uhr. Anmeldedaten siehe unten.
Da wir dann nicht wie gewöhnlich noch gemütlich zusammen in die Pizzeria gehen können, bitten wir alle Interessierten, sich an diesem Abend die Prospekte ihrer Lieblings-Lieferdienste bereitzulegen.
 
Nehmen Sie an der XUGS #24 per Computer, Tablet oder Smartphone teil:
https://global.gotomeeting.com/join/952811445
 
Sie können sich auch über ein Telefon einwählen.
(Bei Geräten, die diese Funktion unterstützen, ist die sofortige Teilnahme über eine der unten aufgeführten Direktwahlnummern möglich.)
Deutschland: +49 721 6059 6510
– Direktwahl: tel:+4972160596510,,952811445#
Zugangscode: 952-811-445
 
Sie kennen GoToMeeting noch nicht? Installieren Sie jetzt die App, damit Sie für Ihr erstes Meeting bereit sind: https://global.gotomeeting.com/install/952811445

XUGS 23: BaseX produktiv – CMS und PIM mit XML 

~ Kai Weber
Mittwoch, 04. Dezember 2019
18.30 Uhr
Hörsaal 204
Thema: BaseX produktiv – CMS und PIM mit XML
Referent: Maximilian Gärber / axxepta solutions
axxepta solutions hat aus den verschiedenen Kundenanforderungen im Kontext CMS (Content Management System) und PIM (Product Information Management) eine eigene Lösung mit BaseX als freiem, nativem und kompaktem XML-Datenbankmanagementsystem im Mittelpunkt entwickelt.
Maximilian Gärber gewährt der Xugs einen Blick in die Werkstatt. Spannend zu sehen, was passiert wenn man es mit der spitzen Klammer auf die Spitze treibt: Weniger Code, wenn Datenbank, Verarbeitungsregeln und Output eine Sprache sprechen.

Nachlese XUGS 22: XLIFF

~ Kai Weber

Die Folien unseres Referenten Stefan Fisahn zur Einführung in die Möglichkeiten der Lokalisierung von Dokumenten mit dem OASIS-Standard XLIFF stehen nun hier zum Herunterladen bereit. Besonders spannend war das im Standard vorgesehene, in der Praxis aber leider häufig vernachlässigte Skeleton-Konzept, mit dessen Hilfe Struktur und Inhalt der an lokale Gegebenheiten anzupassenden Dokumente getrennt werden können.
Vielen Dank auch an Dr. Wolfgang Schindler, der uns einen interessanten Überblick über das Programm der diesjährigen XML Prague gegeben hat. Im Zusammenhang mit unserem XUGS-22-Thema XLIFF sei hier insbesondere auch noch einmal auf den Prager Vortrag zu einer JSON-Portierung JLIFF hingewiesen. Der JLIFF-Vortrag findet sich im Videostream der Konferenz ab dem Zeitpunkt 2:39:15 zum Nachsehen, die schriftliche Ausarbeitung in den Conference Proceedings.
Der informative Abend klang dann mit einer Neuerung aus: Da unser italienisches Stammlokal ausgebucht war, saßen wir noch ein Weilchen beim Griechen zusammen. Alles eine Frage der Lokalisierung…
Stefan Fisahn trägt vor

Nachlese XUGS 21: Eine Einführung in XML

~ Kai Weber

Bei der XUGS 21 im November 2018 führte uns Tobias Ott von der pagina GmbH Publikationstechnologien noch mal ganz von vorne in XML ein. Die Folien zum Vortrag stellen wir nun hier zum Herunterladen bereit: XUGS XML-Grundlagen Nov2018_Druckfassung
Im Dunkeln zu sitzen war in diesem Fall keine Herausforderung – der spannende Vortrag verhinderte auch den leisesten Anflug von Dämmerstimmung.
XML-Einfürhung im Dunkeln
Und als das Licht wieder anging, war das Publikum bereit, sich mit Helm und XML auch in wilde Gebirgswasser hinein zu springen… siehe die letzte Folie:
Tobias Ott beantwortet Fragen
Weiter geht es nun in der XUGS 22 am 20. Februar 2019 mit XLIFF. Wir wagen uns nun sozusagen in die internationalen Gewässer jenseits der 200-Meilen-Zone vor.

Vorankündigung XUGS 22: XLIFF

~ Kai Weber

XLIFF-Logo
Das Thema für die 22. Veranstaltung der XUGS steht fest, es geht um XLIFF:
XLIFF (XML Localization Interchange File Format) ist ein OASIS XML-Standard, der zum Austausch lokalisierbarer Daten dient.
Content sei ja King – aber der König spricht halt nicht alle Sprachen. Ob nun im Sinne von Produktinformationen, Metadaten oder anderer Inhalte, die in Systemen wie CMS, CRM, PIM, ERPs erzeugt werden….
Die Daten müssen nun irgendwie in die Übersetzung, und das heißt konkret in ein CAT (Computer-assisted translation) und wieder zurück.
Datenaustausch ist ja etwas, was quasi in der „Job Description“ von XML steht. Wir schauen uns den XLIFF Standard an, was man damit machen kann und warum Excel nicht immer die perfekte Antwort ist.
Die Veranstaltung findet am 20. Februar 2019 im Hörsaal 204 an der Hochschule der Medien in Stuttgart-Vaihingen statt. Wir beginnen wie üblich um 18:30 Uhr.
Referent:
Stefan Fisahn, Informatica

Schnittmenge XML/InDesign-User

~ Kai Weber

Logo der InDesign User Group Stuttgart
Wie wir bei der XUGS #21 in der vergangenen Woche festgestellt haben, gibt es ein gegenseitiges, sehr wohlwollendes Interesse zwischen den XML- und InDesign-User-Groups. Wir haben deshalb vereinbart, unsere XML-Zielgruppe zukünftig auch über Veranstaltungen der Stuttgarter InDesign-User-Group zu informieren.
Die nächste Veranstaltung findet am

Donnerstag, den 22. November 2018, von 18:00 Uhr bis 20:00 Uhr an der Hochschule der Medien

statt. Es wird zwei Vorträge geben, einen mit einem Design-Schwerpunkt, den anderen zum Thema Sprachkorrekturen via Duden-Korrektor. Nähere Infos dazu gibt es auf Eventbrite oder au der Facebook-Seite der IDUGS.
P.S.: Ist das Logo der IDUGS (siehe oben) nicht großartig?