Wrycan / Fallstudie der NAVSEA

Übersicht

Die Werft der US-Marine in Portsmouth in Kittery, Maine, ist eine Abteilung des Naval Sea Systems Command (NAVSEA), dem größten der fünf Systemkommandos der US-Marine. Sie wandten sich an Wrycan, einen Altova-Partner mit Schwerpunkt auf XML-Technologie für den Bereich Content-Management, um Unterstützung bei der Umwandlung einiger ihrer technischen Handbücher im älteren Format in XML-Dateien gemäß der Navy ETM XML DTD und deren anschließender Umwandlung in PDF-Dokumente. Die Werft hatte die Anweisung erhalten, XML als ihr primäres Daten- und Speicherformat einzusetzen und benötigte eine kostengünstige und zuverlässige Lösung für die Veröffentlichung, die von ihren eigenen Mitarbeitern einfach gewartet werden konnte.

Wrycan verfügte über Erfahrung im Umgang mit dem Altova MissionKit für die XML-Entwicklung sowie über umfassende Kenntnisse in XML-Technologien, einschließlich XML, XSL:FO und DTD. Sie entschieden sich für die Verwendung von XMLSpy, StyleVision und Authentic als Entwicklungswerkzeuge für diese Implementierung, da diese intuitiv, einfach zu bedienen und kostengünstig sind.

Die Herausforderung

Die Werft Portsmouth Naval Shipyard musste etwa 10.000 Seiten an Inhalten von einem älteren Format in XML konvertieren, wobei die XML-Dateien den dortigen DTD-Standards entsprechen mussten. Dies umfasste eine automatisierte Konvertierung, eine manuelle Überprüfung und Korrektur sowie ein Kommandozeilen-Tool, um die XML-Dateien wieder in ihr ursprüngliches PDF-Format zu konvertieren. Wie bei jedem umfangreichen Publikations- und Konvertierungsprojekt war nach der Konvertierung eine umfassende Qualitätskontrolle erforderlich, wobei ein Großteil davon von nicht-technischen Mitarbeitern der Werft durchgeführt werden konnte, sofern sie über ein Werkzeug verfügten, das ihnen half, die XML-Struktur zu verstehen und darauf zuzugreifen. Darüber hinaus stellte die relative Komplexität des Dokumentenformats, das komplizierte Layoutdetails wie eine variable Anzahl von Spalten pro Seite, unterschiedliche Randbreiten, eingebettete Elemente zwischen Abschnitten und nummerierte Listen sowie viele große Schemazeichnungen enthielt, von denen einige sich über doppelseitigen Seiten erstreckten, eine erhebliche Herausforderung für die Programmierung mit XSL:FO dar.

Die Lösung

Wrycan führte den Großteil der Inhaltsumwandlung intern durch, unter Verwendung von eigens entwickelten Skripten und einigen manuellen Prozessen, sowie durch technische Qualitätssicherung. Nach der Umwandlung des Inhalts nutzte Wrycan die Drag-and-Drop-Designoberfläche von StyleVision, um authentische elektronische Formulare zur Bearbeitung zu erstellen, wobei das Navy ETM XML DTD als strukturelles Element verwendet wurde. Erweiterte Stylesheet-Funktionen wie bedingte Vorlagen und automatische Berechnungen wurden integriert, um die Qualitätssicherung und die Bearbeitungsprozesse zu erleichtern.

Nach der Umwandlung der Inhalte implementierte Wrycan ein Kommandozeilen-Verarbeitungstool, das mehrere Schritte umfasst, wie zum Beispiel:

• Zusammenstellung von Inhalten aus XML-Dateien Um die Flexibilität und Benutzerfreundlichkeit zu erhöhen, wurden die technischen Handbücher der Marine in Abschnitte unterteilt, darunter Vorwort, Kapitel, Anhang und Bilddateien. Dies ermöglichte es Wrycan, bestimmte Teile dieser Dateien für die Wiederverwendung verfügbar zu machen. Komponenten, die in mehr als einer Stelle innerhalb der Handbücher identisch auftraten, konnten so segmentiert werden, dass Änderungen, die an einer Stelle vorgenommen wurden, sich automatisch in der gesamten Dokumentation widerspiegelten.
• Konvertierung von XML nach XSL-FO Wrycan verwendete XMLSpy, den umfassenden XML-Editor von Altova, um den komplexen XSL-FO-Code zu erstellen, der für die Erstellung der Handbücher erforderlich war. Die Komplexität des XML-Codes und des resultierenden PDF-Dokuments wird in den folgenden Beispielen deutlich: Quelle für das Gesamtverzeichnis, Quelle für den Vorwortbereich, Quelle für ein Kapitel und Endgültiges Dokument (3,8 MB PDF).
• Individuelle Seitenformatierung Dieses Projekt erforderte verschiedene Seitenformate innerhalb eines Dokuments, beispielsweise eine hochformatige Seite, gefolgt von einer doppelseitigen, querformatigen Seite im Format 27,9 x 43,2 cm (11" x 17"). Es gibt spezifische Anforderungen an die Dokumentation der Marine, die festlegen, dass unterschiedliche Seitenformate unterschiedliche Druckanforderungen haben. Beispielsweise werden doppelseitige Seiten nur auf einer Seite gedruckt, während andere Seiten beidseitig bedruckt werden.
• Nachbearbeitungsschritte Es gab auch Anforderungen bezüglich der Seitennummerierung, beispielsweise musste jedes Kapitel auf einer Seite mit einer ungeraden Seitenzahl beginnen. Wenn dies dazu führt, dass eine Seite leer ist, wird auf dieser Seite eine Notiz platziert, die darauf hinweist, dass die Seite absichtlich leer gelassen wurde. Diese Anforderungen werden automatisch durch das Verarbeitungstool von Wrycan erfüllt.
• PDF-Erstellung Wrycan hat die Software XEP von RenderX in die Verarbeitungspipeline integriert, um die XSL:FO-Ausgabe, einschließlich aller Bilder und Inhalte, in eine einzige PDF-Datei zu konvertieren.

Die Bearbeitung der Inhalte erfolgt mit Authentic über Stylevision, das kürzlich auf die neueste Version aktualisiert wurde, um eine erweiterte Tabellenunterstützung und umfassendere Bearbeitungsmöglichkeiten zu bieten. Im Folgenden ist ein Beispielbildschirm eines der Authentic-Formulare für die WYSIWYG-XML-Bearbeitung dargestellt, das für NAVSEA basierend auf dem StyleVision-Stylesheet-Design erstellt wurde.

Die Ergebnisse

Die Werft Portsmouth Naval Shipyard verfügt nun über eine XML-Publishing-Lösung mit integrierten XML-Bearbeitungsfunktionen. Sie können ihre technischen Handbücher im PDF-Format erstellen, wobei XML als Quelle für die Inhalte dient. Sie sind nun bereit für den nächsten Schritt, nämlich die Implementierung eines umfassenden Content-Management-Systems mit Workflow- und individuellen Publishing-Funktionen. Erfahren Sie, wie die Altova-Tools Ihnen bei Ihren Herausforderungen im Bereich Dokumentation und Publishing helfen können. Laden Sie noch heute eine voll funktionsfähige kostenlose Testversion des Altova MissionKit herunter!