Showing:

Annotations
Attributes
Diagrams
Element import_leseprobe
Annotations

Leeres Element zum Einbinden externer parsX-XML-Inhalte in den Nachspann.

Hinweis: Das Element kann nur bei Lizenzierung des Import-Modules genutzt werden. Mit Hilfe des Import-Moduls können Leseproben aus beliebigen Werken in ein E-Book importiert werden, das aus einer anderen parsX-Datei generiert wird.

Zum Einbinden von Fremdleseproben im E-Book vgl. die Anleitung in der EPUB-Dokumentation)

Für das eingebundene Projekt können:

  • in einem <meta>-Container ein <toctitel> oder <kolumnentitel> vergeben werden.

  • ein Deckblatt für den gesamten Band angelegt werden.

Mit toc="nein" kann die Aufnahme ins TOC unterdrückt werden.

Diagram
Diagramparsx_xsd_Attribute_Group_globale_attribute.tmp#globale_attributeparsx_xsd_Attribute_Group_ausgabesteuerung.tmp#ausgabesteuerungparsx_xsd_Complex_Type_typ_import.tmp#typ_import_import-auspraegungparsx_xsd_Attribute_toc.tmp#tocparsx_xsd_Element_Group_kapitel__meta.tmp#kapitel__meta_metaparsx_xsd_Element_Group_kapitel__meta.tmp#kapitel__metaparsx_xsd_Complex_Type_typ_import.tmp#typ_importparsx_xsd_Attribute_Group_cms_attribut_quelle_extend.tmp#cms.attribut_quelle.extendparsx_xsd_Attribute_quelle.tmp#quelleparsx_xsd_Element_import_leseprobe_extend.tmp#import_leseprobe.extend
Substitution Group Affiliation
Children meta
Attributes
QName Type Default 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)

auspraegung xs:IDREFS optional

Liste mit ID-Referenzen zur Zuordnung von Ausprägungen

Die Struktur kann einer oder mehreren Ausprägungen zugeordnet werden. Dazu werden die IDs der jeweiligen Ausprägungen durch Leerzeichen getrennt notiert.

Es lassen sich auch die IDs von Ausgaben notieren. In diesem Fall werden der Struktur alle Ausprägungen dieser Ausgabe zugeordnet.

auspraegung-ausschluss xs:IDREFS optional

Liste mit ID-Referenzen zum Ausschließen von Ausprägungen

Einer oder mehrere Ausprägungen können von der Zuordnung zu der Struktur ausgenommen werden. Dazu werden die IDs der jeweiligen Ausprägungen durch Leerzeichen getrennt notiert.

Es lassen sich auch die IDs von Ausgaben notieren. In diesem Fall werden alle Ausprägungen dieser Ausgabe von der Zuordnung zu der Struktur ausgenommen.

ebook ja-nein ja optional

Zum Ausblenden bestimmter Elemente bei der Ausgabe als E-Book (Standardwert ist ebook="ja").

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.

import-auspraegung xs:token optional

Mit dem import-auspraegung-Attribut wird die ID derjenigen Ausprägung des importierten Werkes angegeben, mit der im Kontext des Sammelbandes produziert werden soll.

Da diese ID nicht innerhalb des Sammelband-Projekts vorliegt, kann hier keine ID-IDREF-Beziehung per Schema geprüft werden. Das Vorhandensein einer entsprechenden Ausprägung in dem referenzierten Projekt prüft eine Schematronregel (parsX-Konventionsprüfungen).

print ja-nein ja optional

Zum Ausblenden bestimmter Elemente im Print (Standardwert ist print="ja")

quelle restriction of xs:string required

Eingabe des Dateinamen einer externen Ressource (ohne Pfadangabe)

Ausnahme: Wird das quelle-Attribut an <import> verwendet um Inhalte aus anderen parsX-XML-Dateien einzubinden, muss ein Pfad relativ zur aktuellen parsX-XML-Datei angegeben werden.

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.

system-ressource optional

Das system-ressource-Attribut kann beim Einsatz eines MAM oder CMS zusätzlich zum quelle-Attribut verwendet werden, um auf mit system-id-Attribut identifizierte Datenbank-Objekte zuzugreifen. Dieses steht zusätzlich zum system-referenz-Attribut zur Verfügung, mit dem allgemein ein Bezug zu einem Asset hergestellt werden kann.

Im Unterschied zum verweis-intern-Attribut müssen nicht die Konventionen des IDREF-Datentyps von XML eingehalten werden. So können beispielsweise führende Ziffern oder Sonderzeichen verwendet werden, ohne einen Wohlgeformtheits-Fehler zu verursachen.

Das quelle-Attribut bleibt dabei obligatorisch, um einen Re-Import in das CMS sicherzustellen.

toc ja-nein ja optional

Mit dem Attribut können Teile der Werkstruktur gezielt in das TOC eines E-Books oder ein generiertes Inhaltsverzeichnis aufgenommen oder dort unterdrückt werden.

Der Standardwert unterscheidet sich dabei für die einzelnen Elemente:

  • <kapitel>, <deckblatt> und (bei Lizenzierung des Moduls) mit den Import-Elementen eingebundene Elemente werden automatisch in das TOC aufgenommen.

    Die Aufnahme kann mit der Angabe toc="nein" unterdrückt werden.

  • Ein <hauptteil> wird in der Regel nicht in das TOC aufgenommen.

    Mit der Angabe toc="ja" kann ein Hauptteil aufgenommen werden. In diesem Fall sollte im zugehörigen <meta> ein <toctitel> angegeben sein.

  • Für <vorspann> und <nachspann> wird der Standardwert durch die EPUB-Config- und Jobticket-Option "Vorspann/Nachspann ausklappbar" gesetzt.

    Diese Vorgabe kann mit toc="ja" oder toc="nein" überschrieben werden.