Wrycan / NAVSEA: Casestudy

Overzicht

De marinebasis van Portsmouth in Kittery, Maine, is een onderdeel van Naval Sea Systems Command (NAVSEA), de grootste van de vijf operationele commandostructuren van de Amerikaanse marine. Zij hebben Wrycan benaderd, een Altova-partner gespecialiseerd in XML-technologie gericht op content, voor hulp bij het omzetten van enkele van hun technische handleidingen in oudere formaten naar XML, gebaseerd op de Navy ETM XML DTD, en het opnieuw creëren ervan als PDF-bestanden. De marinebasis had de opdracht gekregen om XML als hun primaire data- en opslagformaat te gaan gebruiken, en had een kosteneffectieve en betrouwbare publiceringsoplossing nodig die gemakkelijk door hun eigen personeel kon worden onderhouden.

Wrycan had ervaring met het gebruik van de Altova MissionKit voor XML-ontwikkeling, en beschikte over uitgebreide kennis van XML-technologieën, waaronder XML, XSL:FO en DTD. Ze kozen ervoor om XMLSpy, StyleVision en Authentic te gebruiken als ontwikkeltools voor deze implementatie vanwege hun intuïtieve gebruik, gebruiksgemak en relatief lage prijs.

De uitdaging

De marinebasis van Portsmouth moest ongeveer 10.000 pagina's aan content omzetten van een oud formaat naar XML, waarbij moest worden voldaan aan hun eigen DTD (Document Type Definition). Dit omvatte een geautomatiseerde conversie, een handmatige controle en correctie, en een commandoregelprogramma om de XML weer om te zetten naar het oorspronkelijke PDF-formaat. Net als bij elke grote publicatie- en conversieoperatie, vereiste dit project een uitgebreide kwaliteitscontrole na de conversie. Een groot deel hiervan kon worden uitgevoerd door niet-technische medewerkers van de marinebasis, mits zij een hulpmiddel hadden om de XML-markeringen te interpreteren en te bekijken. Bovendien, vanwege de relatieve complexiteit van het documentformaat, dat ingewikkelde lay-outdetails bevatte, zoals een variabel aantal kolommen per pagina, verschillende marges, opmerkingen verspreid tussen secties en genummerde lijsten, en veel grote schematische modellen, waarvan sommige op uitklapbladen stonden, beloofde de XSL:FO-codering een aanzienlijke uitdaging te vormen.

De oplossing

Wrycan heeft het grootste deel van de contentconversie intern uitgevoerd, met behulp van aangepaste scripts en enkele handmatige processen, evenals technische kwaliteitscontroles. Nadat de content was geconverteerd, gebruikte Wrycan de drag-and-drop ontwerpinterface van StyleVision om authentieke elektronische formulieren te creëren voor bewerking, waarbij de Navy ETM XML DTD als structurele component werd gebruikt. Geavanceerde stylesheet-functies, zoals voorwaardelijke templates en automatische berekeningen, werden toegevoegd om de kwaliteitscontrole en de bewerkingsprocessen te vereenvoudigen.

Na de conversie van de content heeft Wrycan een commandoregeltool geïmplementeerd die meerdere stappen omvat, zoals:

• Het samenstellen van documenten uit fragmenten van XML-bestanden Om meer flexibiliteit en bruikbaarheid te bieden, zijn de technische handleidingen van de marine opgedeeld in secties, waaronder een voorwoord, hoofdstukken, een afsluitende sectie en afbeeldingen. Dit stelde Wrycan in staat om bepaalde delen van deze bestanden beschikbaar te stellen voor hergebruik. Componenten die identiek verschenen op meerdere plaatsen in de handleidingen konden worden opgedeeld, zodat wijzigingen die op één plaats werden aangebracht, automatisch door de hele documentatie werden doorgevoerd.
• Conversie van XML naar XSL-FO Wrycan gebruikte XMLSpy, de uitgebreide XML-editor van Altova, om de complexe XSL:FO-code handmatig te creëren die nodig was voor de handleidingen. De complexiteit van de XML- en PDF-output is te zien in de volgende voorbeelden: Bronbestand voor het hele document, Bronbestand voor het voorwoord, Bronbestand voor een hoofdstuk, en Het definitieve document (een PDF-bestand van 3,8 MB).
• Aangepaste paginavormgeving Dit project vereiste verschillende paginagrootten binnen hetzelfde document, zoals een portretpagina gevolgd door een uitklapbare landscapepagina van 28 x 43 cm. Er zijn specificaties voor marine-documentatie die bepalen dat verschillende paginavormen verschillende printvereisten hebben. Zo worden uitklapbare pagina's bijvoorbeeld aan één kant gedrukt, terwijl andere pagina's aan beide kanten worden gedrukt.
• Nabewerking Er waren ook eisen met betrekking tot paginanummering, zoals dat elk hoofdstuk op een oneven paginanummer moet beginnen. Als dit resulteert in een lege pagina, wordt er een bericht op die pagina geplaatst dat aangeeft dat de pagina opzettelijk leeg is gelaten. Deze eisen worden automatisch nageleefd door het verwerkingsprogramma van Wrycan.
• PDF-generatie Wrycan heeft de XEP-software van RenderX geïntegreerd in de verwerkingsstroom om de XSL:FO-output, inclusief alle afbeeldingen en algemene inhoud, om te zetten in één PDF-bestand.

De bewerking van de inhoud gebeurt met Authentic via Stylevision, dat recentelijk is bijgewerkt naar de nieuwste versie voor betere ondersteuning van tabellen en uitgebreidere bewerkingsmogelijkheden. Hieronder is een voorbeeld van een screenshot van een van de Authentic e-formulieren voor WYSIWYG XML-bewerking, die is gegenereerd voor NAVSEA op basis van het StyleVision-stijlsjabloon.

De resultaten

De marinebasis Portsmouth heeft nu een XML-publicatielösung met ingebouwde mogelijkheden voor het bewerken van XML-bestanden. Ze kunnen hun technische handleidingen in PDF-formaat genereren, waarbij XML wordt gebruikt als de bron van de inhoud. Ze zijn nu klaar om door te gaan naar de volgende stap, namelijk het implementeren van een volledig contentmanagementsysteem met workflow en aangepaste publicatiefuncties. Ontdek hoe de Altova-tools u kunnen helpen bij uw uitdagingen op het gebied van documentatie en publicatie. Download vandaag nog een volledig functionerende proefversie van de Altova MissionKit!