Showing:

Annotations
Attributes
Diagrams
Used by
Element element
Annotations

Enthält <vorkommen> und <beschreibung> für einen mit den name- und typ-Attributen bezeichneten Elementtyp.

Wird in den Metadaten in <dokumentation> zur Dokumentation und Erläuterung der verwendeten Typnummern verwendet.

Neben den Joker-Elementen mit obligatorischem Typ-Attribut, lassen sich auch eine Vielzahl regulärer Elemente typisieren, um verschiedene Varianten dieser Elemente zu kennzeichnen. Diese müssen mit ihrer Fundstelle und ihrer Verwendung in einem korrespondierenden <element> dokumentiert werden.

Konvention: Wenn in der Instanz Elemente über Typnummern unterschieden werden (etwa verschiedene Überschriften gleicher Stufe, Listen, Kapitel etc.), so müssen diese dokumentiert werden. Dies wird über den DokuChecker abgeprüft.

Zu dieser Struktur gibt es eine Grammatikregel.

Diagram
Diagramparsx_xsd_Element_element.tmp#element_nameparsx_xsd_Element_element.tmp#element_typparsx_xsd_Attribute_Group_globale_attribute.tmp#globale_attributeparsx_xsd_Element_vorkommen.tmp#vorkommenparsx_xsd_Element_beschreibung.tmp#beschreibung
Used by
Element typisierung
Children beschreibung, vorkommen
Attributes
QName Type Use Annotation
aria-role restriction of xs:token optional

Mit dem role-Attribut des ARIA-Standards können zur Verbesserung der Barrierefreiheit Auszeichnungen in die Daten eingebracht werden, die von Screenreadern ausgewertet werden.

Zur Anwendung des Attributs s. https://www.w3.org/WAI/PF/aria/roles.

Aufgenommen wurden auch weitere role-Attributwerte aus dem Digital Publishing WAI-ARIA Module 1.0 (W3C Recommendation 14 December 2017, https://www.w3.org/TR/dpub-aria-1.0/#role_definitions)

id xs:ID optional

Analog zu <a name="..."> bzw. zum id-Attribut innerhalb von HTML für die Angabe von benannten Sprungzielen.

Alle Elemente können über das id-Attribut referenziert werden (globales Attribut).

Die ID heißt bei allen Elementen einheitlich id, IDREF-Attribute (z.B. an <verweis>, <abbildung> etc.) heißen verweis-intern.

An allen Elementen, an denen ein id-Attribut zulässig ist, sind das sprache- und aria-role-Attribut zulässig.

Verlagsspezifisch können weitere globale Attribute definiert werden. Bereits vorgesehen sind als Beispielumsetzung ein sytem-id- und system-referenz-Attribut, weitere können ergänzt werden.

name name.typisierung required
sprache xs:string optional

Das Attribut enthält als Wert einen Sprachcode entsprechend BCP 47.

Quelle für die Codes: www.iana.org und https://www.techonthenet.com/js/language_tags.php

(Tool zum Auffinden von Sprachcodes)

An allen Elementen an denen das id-Attribut zulässig ist, kann auch das sprache-Attribut angegeben werden und ganze Textbereiche einer Sprache zuweisen. Mit <fremd> ist dies auf Inline-Ebene möglich.

  • Umsetzung im EPUB: für Screenreader, anderes Schriftsystem (z.B. Arabisch) für ganze Abschnitte eines Werks.

    • Das xml:lang-Attribut - und für EPUB 3 auch das lang-Attribut - wird gesetzt.

      Dabei wirkt sich das sprache-Attribut an Hauptteil/Kapitel/etc. auf das (xml:)lang-Attribut am entsprechenden <html>-Root-Element aus.

  • Umsetzung in InDesign: Ist technisch nicht automatisiert möglich (z.T. manuell möglich), eine automatische Anpassung z.B. der Silbentrennung kann nur dokumentweit oder über das aus dem <fremd>-Element generierte Zeichenformat erfolgen.

system-id optional

Das system-id-Attribut kann beim Einsatz eines MAM oder CMS zur eindeutigen Identifikation von Datenbank-Objekten verwendet werden. Im Unterschied zu dem regulären id-Attribut müssen nicht die Konventionen des ID-Datentyps von XML eingehalten werden. So können beispielsweise führende Ziffern oder Sonderzeichen verwendet werden, ohne einen Wohlgeformtheits-Fehler zu verursachen.

system-referenz optional

Das system-referenz-Attribut kann beim Einsatz eines MAM oder CMS verwendet werden, um den Bezug zu einem Datenbank-Objekt herzustellen. Dadurch lässt sich zum Beispiel eine Tabelle mit einer Excel-Datei verknüpfen, auf der diese Tabelle basiert.

Im Unterschied zum system-verweis-Attribut wird durch den Einsatz des system-referenz-Attributes kein Link auf eine ID erstellt. Es wird nur eine Beziehung zwischen Inhalt und Datenbank-Objekt gekennzeichnet.

Die Implementierung ist systemabhängig. Denkbar wäre zum Beispiel, dass ein System die Bearbeitung einer Tabelle in Excel erlaubt und diese dann beim Export des Assets automatisch wieder in parsX-XML überführt.

typ typ.nummern required
Attribute element / @name
Used by
Element element
Attribute element / @typ
Used by
Element element