Document ID: /fineweb-2-swissfilter-quality_10-filterrobots/filtered/03647.jsonl.gz/538

Wie sollen ID’s bezeichnet werden?
Externe Entity-Referenzen
Container nutzen
termrefs und entrefs
Elemente gezielt austauschen
Figure floating oder floating figures
Figure-text-container
para-Figure-text-container
Sollten Sie ein Buch mit mehreren XML-Instanzen aufbauen oder Externe Entities verwenden, dann sollten ID’s in allen XML-Instanzen unique sein.
Sie sollen folgende Informationen enthalten:
- die Dokuart, die Bezeichnung des Dokuments, evtl. die Version des Dokuments
- die Bezeichnung des ID-Typs mit eindeutigem Bezug, z.B. FN für Fussnote, gefolgt von einem Begriff, der die Fussnote im gesamten Bestand einmalig macht.
Beispiel für eine ID bei footnotes: Doc-XXX-b-FN-Sinngebende-Bez
Beispiel für eine chapter-ID: Doc-XXX-b-ch-Ueberblicks
Beispiel für eine section-ID: Doc-XXX-b-sec-Sinngebender-Name
Externe Entities sind nützlich, wenn z.B. Inhalte in allen Dokumenten gleich sind, z.B. eine legend, oder wenn die Daten wegen ihres Umfangs aus einem Dokument ausgelagert werden sollen.
Externe Entities erstellt man in XMetaL wie folgt:
- erstelle eine xml-Datei ohne Doctype-Deklaration
- In XMetaL: Unter Tools: External Entity: bilden: Name der Entity und Datei wählen —> new
- an der Stelle im Dokument, an der die Struktur der Entity erlaubt ist: Insert: Datei wählen: OK
- fertig!
titled-container
Mittels titled-container können Inhalte in einer section weiter strukturiert werden. Es ist darauf zu achten, dass jeder titled-container innerhalb einer section eine für sich abgeschlossenen Context hat. Da titled-container die letzte Stufe einer Struktur sind, darf nicht der Inhalt eines titled-container auf den nächsten aufbauen.
Sind Abhängigkeiten vorhanden, dann muss die Struktur eine oder mehrere (Unter-)section bekommen.
list-container
Listen sollen grundsätzlich in list-container enthalt sein, weil eine list-container bereits zwingend einen Start-para enthält.
list-container können auch in titled-container gesetzt werden.
Termrefs und entrefs sind Referenzen auf sog. Interne Entities. Über ein spezifisches Konzept können diese Entities aus den Ressourcen heraus in die XML-Instanz gesetzt werden (XmetaL). Im Editor Oxygen werden diese in einem spezifischen Fenster aufgelistet und können von dort aus über einen Doppelklick in die XML-Instanz eingesetzt werden. Die Internen Entities müssen in der DocType-Deklaration eingetragen werden.
termrefs
termrefs werden dazu gebildet, einen Eintrag in den Glossar zu erhalten. Es sind größtenteils Abkürzungen, die nicht selbsterklärend sind.
Die Suche nach termrefs erübrigt sich, weil das Script tagallterms die bereits vorhandenen terms in der Instanz sucht und die Auszeichnung vorschlägt.
Jedes termref muss nur einmal in der Instanz gesetzt werden.
Neue terms müssen zur Aufnahme in der Redaktion beantragt werden.
entrefs
entrefs haben zwei Ziele:
- sie sollen die Schreibweise von Begriffen vereinheitlichen
- sie sollen als Schreibhilfe dienen.
In beiden Fällen muss der Redaktor wissen, unter welcher Rubrik sich der Begriff verbirgt. Über die spezifische Suche kann man den Term rasch finden.
Figures, die sich ausserhalb von containern, also von
fig-text-container oder von
para-fig.text-container befinden, können über das Attibut
@float in
figure als flooting eingestellt werden.
Hier zusammen gefasst die Bedingungen und das Resultat:
- das Floating funktioniert lediglich mit normalen figures im laufenden Text (kein fig-text-container o.ä.!)
- es verschiebt die Abbildung mit fig-title und ggf. legend nach oben in den Kopf der Seite
- das Attribut float muss auf den Wert yes gesetzt werden
- das Attribut pagewide kann den Wert yes oder no haben
- pagewide ist nicht wirksam.
Verwende
fig-text-container, wenn Folgendes zutrifft:
- direkte Text-zu-Bild-Informationen vorhanden und nowendig
- der Inhalt kann mit einem
bridgeheadüberschrieben werden
- die Abbildung lässt von der Größe her Text rechts neben der Abbildung zu.
Gehe wie folgt vor:
- setze den
fig-text-container
- wähle die Graphik und setze das Attribut
contentwidthauf einen Wert von ca. 50 bis 90 mm
- setze ein Element
bridgehead
- setze mind. einen
paraoder einen
listcontainerfür die Text-zu-Bild-Informationen.
Verwende
para-fig-text-container, wenn Folgendes zutrifft:
- eine Einleitung
parazu Text-zu-Bild-Informationen ist nowendig
- direkte Text-zu-Bild-Informationen vorhanden und nowendig
- der Inhalt kann nach der
figuremit einem
bridgeheadüberschrieben werden (optional)
- die Abbildung lässt von der Größe her Text rechts neben der Abbildung zu.
Gehe wie folgt vor:
- setze den
para-fig-text-container
- setze einen
para
- setze eine
figure
- wähle die Graphik und setze das Attribut
contentwidthauf einen Wert von ca. 50 bis 90 mm
- setze ein Element
bridgehead(optional)
- setze mind. einen
paraoder einen
listcontainerfür die Text-zu-Bild-Informationen.