Generierung der XML-Light-Datei für den Import mit dem Plugin

Spezielle Meldungen beim XML-Import

Die Generierung der XML-Light-Datei erfolgt im Framework per XSLT-Transformation "parsX-2-light Transformation (für InDesign)" im Oxygen-Editor.

Transformationsszenarien im Oxygen-Framework

Die transformierte XML-Light-Datei für den Import befindet sich im selben Verzeichnis wie die pagina XML-Datei.

Der Dateiname der XML-Light-Datei lautet: [Dateiname]_LIGHT.xml

	Wichtig
	Nach der Transformation wird im Oxygen-Editor eine Log-Datei ausgegeben (Reiter "Nachrichten/Fehler"), die Informationen, Warnungen oder Fehlermeldungen bei der Transformation dokumentiert. Diese Log-Datei wird im selben Verzeichnis gespeichert wie die transformierte XML-Light-Datei. Der Dateiname lautet [Dateiname]_parsx2light_log.html

Die Log-Datei enthält jeweils eine Angabe über den "Schweregrad" ([Info], [Warnung], [Schwerwiegend]) des Fehlers bei der Transformation, einen Erläuterungstext sowie den XPath-Ausdruck des betroffenen Elements. Die Meldungen der Log-Datei sind dem Schweregrad entsprechend farbig hinterlegt.
Auch wenn wegen schwerwiegender Probleme keine LIGHT-Daten ausgegeben werden, enthält das Log nun alle Meldungen zu der betreffenden Datei, auch die Warnungen und Infos:

Fehlerausgabe bei der Transformation

Angezeigt wird nun ein Link-Button, der zu der problematischen Stelle im XML führt. Zu beachten ist dabei:

Wenn Korrekturen im XML vorgenommen werden, können sich die XPath-Angaben zu den Meldungen ändern. Dann muss die Transformation neu gestartet werden, um das Log zu aktualisieren.
Die Links funktionieren auch unabhängig von der Transformation, wenn Log und XML-Datei zugleich im Oxygen-Editor geöffnet werden. In der HTML-Autoransicht muss dann das Link-Symbol vor dem Text "Zu dieser Stelle im XML springen" angeklickt werden. Aus einem Browser heraus funktionieren die Links nicht.

Fehlerausgabe bei der Transformation

Meldungen mit "[Info]" enthalten Hinweise zur transformierten Datei, etwa zur Umsetzung von Listen oder Tabellen ohne @typ-Attribut, zur Anzahl von Elementen mit @print="nein" oder zu internen Verweisen.

Meldungen mit "[Warnung]" bedeuten, dass Strukturen nicht vollständig erhalten werden können, etwa Inline-Auszeichnungen in Zählerelementen, Initialen in Einschüben, Listenzähler mit nichtnumerischen Typen etc.

Der Text bleibt in diesen Fällen vollständig erhalten, es kann aber sein, dass in InDesign manuell nachbearbeitet werden muss.

Fehlermeldungen mit "[Schwerwiegend]" werden ausgegeben, wenn Elemente im parsX 3-Plugin bzw. in der Light-DTD überhaupt nicht umgesetzt werden können (z.B. <szene>, <gedicht>, <endnote> im Nachspann) oder Konflikte entstehen (z.B. wenn <abbildungstitel> und <legende> kombiniert sind). In diesen Fällen bricht die Transformation ab und es wird nur das Logfile ausgegeben. Sollte die Datei mehrere solcher Strukturen enthalten, wird die Transformation erst nach Behebung aller Problemstellen erfolgreich sein.

Hier muss geprüft werden, ob es möglich ist durch "Umtaggen" dieser Elemente einen XML-Import zu ermöglichen, oder ob dieser Titel nur in einem anderen Satzsystem gesetzt werden kann (momentan gibt es z.B. im Plugin noch keine Umsetzung eines <index>-Elements in einen Adobe InDesign-Index). Zum Beispiel wäre ein einfaches <gedicht> auch über das Tagging als <einschub> umsetzbar und somit der XML-Import möglich. Nach Abschluss der Satzarbeiten, dem XML-Export aus Adobe InDesign und der Rücktransformation nach pagina-XML könnte dieser <einschub> wieder als <gedicht> getaggt werden.

	Wichtig
	Die Log-Datei muss vor dem Import auf Fehlermeldungen geprüft werden! Ein Ignorieren der Fehlermeldungen kann schlimmstenfalls zu Datenverlusten führen!