Zum Vortrag von Achim Berndzen und Thorsten Rohm über Qualitätssicherung in XML-Workflows mit XProc-Pipelines stellen wir hier die Folien und das verwandte Paper von der MarkupUK-Konferenz bereit. Vielen Dank an die beiden Referenten!
Autor: Kai Weber
XUGS 27: Qualitätssicherung von XML-Workflows mit XProc-Pipelines
Die XUGS lädt für den 20.09.2023 zu einem Online-Vortrag über qualitätskritische XML-Workflows mit Hilfe von XProc-3-Pipelines ein.
Ausgangspunkt der beiden Referenten Achim Berndzen und Thorsten Rohm sind Pipelines, welche auf Batchskripten und XSLT basieren und XML-Ausgaben in hoher Qualität erzeugen. Einige Qualitäts-Eigenschaften wurden jedoch noch nicht automatisch sichergestellt und wurden von den beiden sukzessive hinzugefügt, um ein noch höheres Maß an Qualitätssicherung zu erreichen.
Achim Berndzen wird zunächst eine kurze allgemeine Einführung in XProc geben. Anschließend zeigen die beiden Referenten ihre erweiterten QS-Maßnahmen wie etwa die Validierung von Ergebnissen, die Überprüfung von Links auf Grafikdateien und die proaktive Sicherstellung von validen Transformationsergebnissen. Sie zeigen an diesen konkreten Beispielen, wie XProc 3.0 verwendet wurde, um die Pipeline zu verbessern, Abhängigkeiten zu verringern und summarische Logdateien zu generieren.
Der Vortrag wird auf Deutsch gehalten, die dabei verwendeten Folien werden allerdings in englischer Sprache gezeigt.
Der Vortrag wird via GoToMeeting übertragen, die Einwahldaten finden sich unten, eine vorherige Anmeldung ist nicht erforderlich.
Die Referenten
Achim Berndzen
Achim Berndzen erwarb einen M.A. in Philosophie an der Universität Aachen und hat mehr als zwanzig Jahre Lehrerfahrung in Kommunikationstrainings. Im Jahr 2014 gründete er <xml-project/>. Er ist der Entwickler von MorganaXProc, einem voll standardkonformen XProc-Prozessor mit einem Schwerpunkt auf Konfigurierbarkeit und Erweiterbarkeit.
Thorsten Rohm
Thorsten Rohm begann 1997 mit SGML-Anwendungen für die Druckausgabe und das elektronische Publizieren zu arbeiten. Er war in der Druckvorstufe für verschiedene juristische Fachverlage in den Bereichen Datenstrukturierung, -konvertierung und -anreicherung tätig. Seit 2002 beschäftigt er sich mit XML, XSLT, XSL-FO und dem Antenna House Formatter, sowie weiteren XML-Technologien.
2009 wechselte er zur Thieme Compliance GmbH, wo er nun als Head of Content Architecture & Management tätig ist. Gemeinsam mit seinem Team konzentriert er sich auf die Weiterentwicklung des XML-Content und stellt dessen Single-Source-Fähigkeit sicher. Die Hauptaufgabe liegt dabei in der Entwicklung und Pflege von Publishing-Pipelines für die voll- oder hochautomatisierte Ausgabe in unterschiedlichsten Medienformen. Einen weiteren Schwerpunkt stellt die Qualitätssicherung mittels Schematron sowie die Entwicklung und Pflege von Qualitätssicherungs-Pipelines dar, beispielsweise um neue Stylesheet-Versionen zu testen und Regressionen auszuschließen.
Er liebt alles, was mit Markup zu tun hat, und ist sehr am Austausch mit der XML-Community interessiert.
Einwahldaten
XUGS 27: QS mit XProc-Pipelines
20.09.2023, 18:30–19:30 Uhr (Europe/Amsterdam)
Nehmen Sie an diesem Meeting per Computer, Tablet oder Smartphone teil.
https://meet.goto.com/868222853
Sie können sich auch über ein Telefon einwählen.
Zugangscode: 868-222-853
Germany: +49 721 9881 4161
Installieren Sie jetzt die App, damit Sie für Ihr erstes Meeting bereit sind:
https://meet.goto.com/install
Unterlagen zur XSLT-Einführung
Die Folien und Beispieldaten unserer Einführung in XSLT haben die Referenten Heino Schmull und Martin Braun uns direkt im Anschluss an die Veranstaltungen zugeschickt. Leider haben wir es versäumt, den Artikel mit diesen Unterlagen hier auf der Website zeitnah freizuschalten. Wir bitten um Entschuldigung und geloben Besserung!
Folien zur „Einführung in X-Technologien, Teil 1: XPath“
Wir freuen uns, dass unsere Online-Präsentation zur Einführung in XPath auf große Resonanz stieß. Als eine XML User Group besteht für uns die Gefahr, dass wir mit unserer Kommunikation nur die Menschen erreichen, die schon Fachleute sind und weniger solche, die es vielleicht erst werden wollen – oder auch solche, die sich einfach nur ein bisschen in der XML-Welt bewegen möchten, daneben aber auch noch andere Hobbies haben…
Vielen Dank jedenfalls an den Referenten Dr. Björn Rudzewitz, der uns wie angekündigt auch seine Vortragsfolien zur Verfügung stellt:
Viel Freude beim weiteren Üben und Ausprobieren!
In unserer Reihe zur Einführung in XML-Technologien geht es Mitte Februar weiter mit XML Schema – eine konkrete Ankündigung folgt demnächst.
Einführung in X-Technologien: Eine Veranstaltungsreihe
Die XML User Group Stuttgart (XUGS) wird ab Anfang des nächsten Jahres eine neue Online-Veranstaltungsreihe zur Einführung in die typischen Technologien rund um die Verarbeitung von XML anbieten. Wir wenden uns damit explizit an interessierte Einsteiger:innen oder Wieder-Einsteiger:innen.
Sie haben im beruflichen Alltag gelegentlich oder sogar häufig mit XML-Daten zu tun, aber fühlen sich etwas unwohl, wenn Sie diese Daten selbst anfassen müssen? Sie haben verstanden, wieso sich XML für die moderne, digitale Medienproduktion gut eignet, wollen jetzt aber mal einen Eindruck bekommen, wie man XML-Daten konkret weiter verarbeiten kann? Die XML User Group Stuttgart (XUGS) möchte Ihnen für diese Fälle ein Angebot machen: Wir geben Ihnen in den nächsten Monaten einen einfachen, kurzen, praxisorientierten Einstieg in XML-Kerntechnologien wie XPath, XML Schema, XSLT, Schematron, xQuery, CSS usw. Dabei ist es hilfreich, wenn Sie schon mal spitze Klammern gesehen haben, darüber hinaus sind aber keine Vorkenntnisse nötig. Die geplanten Veranstaltungen werden online durchgeführt werden und sind selbstverständlich – wie alle Veranstaltungen – der XUGS kostenlos. Wir würden uns freuen, Sie in die feine XML-Gemeinde aufnehmen zu können!
Wir beginnen
am 18. Januar 2023 um 18:30 Uhr
mit einer Einführung in XPath.
Wenn wir Ihnen sagen würden, dass Sie mit XPath „Knoten in einem XML-Dokument adressieren“ können, wäre das zwar richtig, aber Ihnen viel zu abstrakt. Sagen wir also stattdessen: Mit XPath können Sie Fragen an ein XML-Dokument stellen und auf wunderbar einfache Weise Antworten erhalten, ohne das Dokument vollständig lesen zu müssen. Zum Beisipel:
- Was ist der längste Absatz in dem Dokument?
- Was ist der durchschnittliche Preis der Ware in einer XML-codierten Produktliste?
- Wieviele Überschriften der Ebene 1 gibt es in dem Dokument und welche sind das?
Gehen Sie gemeinsam mit uns und dem Referenten Dr. Björn Rudzewitz, dem Leiter des Geschäftsbereichs Publishing-Software der pagina GmbH, auf eine Wanderung auf dem XPath!
Nehmen Sie an dieser Einführung per Computer, Tablet oder Smartphone teil: https://meet.goto.com/133874245
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 9881 4161
– Direktwahl: tel:+4972198814161,,133874245#
Zugangscode: 133-874-245
Installieren Sie jetzt die App, damit Sie für Ihr erstes Meeting bereit sind: https://meet.goto.com/install
Google-Gruppe für die XUGS
Um weiterhin Newsletter versenden zu können, benötigen wir nachvollziehbare Einverständniserklärungen. Aus diesem Grund haben wir eine Google-Gruppe für zukünftigen Newsletter-Versand angelegt:
https://groups.google.com/g/xugs
Insgesamt gibt es nun also vier Arten, über Neuigkeiten aus der XUGS auf dem Laufenden zu bleiben:
- unserer XING-Gruppe beitreten: XUGS bei XING,
- unserer Google-Gruppe beitreten, die wir für Opt-In-Einverständniserklärung zum Versand von Newslettern verwenden (jeweils Ankündigung der geplanten Veranstaltungen),
- unserem Twitter-Kanal folgen: @xugstuttgart,
- den RSS-Feed dieser WordPress-Seite abonnieren.
Ankündigung XUGS 26: DITA-Learning (24.02.21)
Produktion von Bildungsdaten mit dem data2type DITA-LT-Framework
Nach Jahren der Entwicklung stellt Manuel Montero Pineda das data2type DITA-LT-Framework vor. Es erzeugt alle wichtigen Standards im Bildungsbereich, vollautomatisch, individualisiert und in allen Ausgabe-Kanälen, sei es nun als Print-PDF, Web-PDF, EPUB, Moodle-Kurs oder in einem anderen LMS oder in E-Testing-Plattformen.
Diese Veranstaltung findet am 24. Februar 2021 statt und beginnt um 18.30 Uhr.
XUGS26: DITA-Learning & Training
Nehmen Sie an meinem Meeting per Computer, Tablet oder Smartphone teil.
https://global.gotomeeting.com/join/475675941
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 891 2140 2090
- Direktwahl: tel:+4989121402090,,475675941#
Zugangscode: 475-675-941
Sie kennen GoToMeeting noch nicht? Installieren Sie jetzt die App, damit Sie für Ihr erstes Meeting bereit sind: https://global.gotomeeting.com/install/475675941
Ankündigung XUGS 25: DITA (25.11.20)
Das nächste XUGS-Treffen findet aufgrund der aktuellen politischen Vorgaben wieder Online statt, wie wir es schon im Frühjahr mal ausprobiert haben.
In XUGS 25 geht es um DITA, die Darwin Information Typing Archictecture. Evolutionäre Anpassung ist ein Grundprinzip dieser flexiblen Informationsarchitektur, um mit sich ändernden Umständen und Anforderungen zurechtzukommen. Es wird ein kurzer Überblick über die DITA Architektur gegeben und wie man sie im Learning & Training verwenden kann.
Als Referenten konnten wir den DITA-Spezialisten und -Trainer Gregor Bock gewinnen, der als Business-Analyst tätig ist und sich auch bei data2type um DITA-Themen kümmert.
Wir werden wie beim letzten Mal die Plattform GoToMeeting nutzen, das Onlinetreffen findet am Mittwoch, den 25. November 2020 statt und beginnt um 18:30 Uhr:
Nehmen Sie an XUGS 25 per Computer, Tablet oder Smartphone teil:
https://global.gotomeeting.com/join/434419813
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 891 2140 2090
- Direktwahl: tel:+4989121402090,,434419813#
Zugangscode: 434-419-813
Sie kennen GoToMeeting noch nicht? Installieren Sie jetzt die App, damit Sie für Ihr erstes Meeting bereit sind: https://global.gotomeeting.com/install/434419813
Nachlese zu #XUGS24: Webinar und DocBook
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
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
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).
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
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
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