Dieses Dokument wurde von Mitgliedern des W3C und anderen interessierten
Gruppen überprüft und vom Direktor als eine W3C-Empfehlung anerkannt. Es
ist ein stabiles Dokument und kann als Referenzmaterial verwendet oder als
normative Referenz von einem anderen Dokument zitiert werden. Die Aufgabe des
W3C bei der Erstellung dieser Empfehlung ist es, die Aufmerksamkeit auf diese
Spezifikation zu lenken und deren weitläufige Verbreitung zu fördern. Dies
erhöht die Funktionalität und die Interoperabilität des Webs.
Dieses Dokument wurde von der W3C XML Linking Working Group als Teil der
XML Activity in der W3C Architecture Domain erstellt. Für
Hintergrundinformationen zu dieser Arbeit lesen Sie bitte das XML Activity Statement.
Bitte senden Sie Berichte über mögliche Fehler in diesem Dokument an die
öffentliche Mailing-Liste www-xml-linking-comments@w3.org
(Archiv unter http://lists.w3.org/Archives/Public/www-xml-linking-comments/).
Jeder bestätigte Fehler wird in einer Fehlerliste dokumentiert, die
abgerufen werden kann unter http://www.w3.org/2001/06/xmlbase-errata.
Die englische Version dieser Spezifikation ist die einzige normative
Version. Übersetzungen dieses Dokuments sind abzurufen unter http://www.w3.org/2001/06/xmlbase-translations.
Eine Liste der aktuellen W3C-Empfehlungen und anderer Dokumente kann unter
http://www.w3.org/TR/ abgerufen
werden.
1 Einleitung
Die XML Linking Language [XLink] definiert
Konstrukte, die der Extensible Markup Language (XML) 1.0 [XML] unterliegen, um Verweise zwischen Quellen zu
beschreiben. Eine der ausgesprochenen Anforderungen von XLink ist es,
HTML-Verweiskonstrukte [HTML 4.01] generisch zu
unterstützen. Das HTML-Element BASE ist ein solches Konstrukt,
das die XLink Working Group in Betracht gezogen hat. BASE
erlaubt Autoren ausdrücklich, einen Base-URI für ein Dokument anzugeben, um
relative URIs zu externen Grafiken, Applets, Formular verarbeitenden
Programmen, Style Sheets usw. aufzulösen.
Dieses Dokument beschreibt einen Mechanismus, um die Vorteile eines
Base-URIs für XLink zu verwenden, aber als eine modulare Spezifikation, so
dass andere XML-Anwendungen, die von der zusätzlichen Kontrolle über
relative URIs profitieren können, aber nicht auf XLink aufbauen, ebenso
Gebrauch davon machen können. Die Syntax besteht aus einem einzigen
XML-Attribut namens xml:base.
Der Aufbau von XML Base beruht auf dem normativen Bezug zu neuen
Spezifikationen, zum Beispiel XLink und XML Infoset. Anwendungen und
Spezifikationen, die auf diesen neuen Technologien aufbauen, werden XML Base
von Haus aus unterstützen. Das Verhalten von
xml:base-Attributen in Anwendungen, die keinen direkten oder
indirekten Bezug zu XML Base haben, ist nicht definiert.
2 Terminologie
[Definition: Die
Schlüsselworte muss, darf nicht, erforderlich,
kann, sollte, empfohlen und optional in dieser
Spezifikation sind zu interpretieren, wie in [IETF RFC
2119] beschrieben.]
Die Begriffe Base-URI und relativer URI werden in dieser
Spezifikation verwendet, wie in [IETF RFC 2396]
definiert.
3 xml:base-Attribut
Das Attribut xml:base kann in XML-Dokumente eingefügt werden, um
einen Base-URI anzugeben, der sich vom Base-URI des Dokuments oder des
externen Entities unterscheidet. Der Wert dieses Attributs wird als
URI-Verweis interpretiert, wie in RFC 2396 [IETF RFC
2396] definiert, nachdem er laut Abschnitt 3.1 verarbeitet wurde.
In einem XML-Prozessor, der Namensräume berücksichtigt, ist das
xml-Präfix an den Namensraumnamen
http://www.w3.org/XML/1998/namespace gebunden wie in
"Namensräume in XML" [XML Names] beschrieben ist.
Beachten Sie, dass xml:base aber noch von Prozessoren
verarbeitet werden kann, die Namensräume nicht berücksichtigen.
Es folgt ein Beispiel mit xml:base in einem einfachen
Dokument, das XLinks enthält. XLink bezieht sich normativ auf XML Base zur
Interpretation relativer URI-Verweise in
xlink:href-Attributen.
<?xml version="1.0"?>
<doc xml:base="http://example.org/today/"
xmlns:xlink="http://www.w3.org/1999/xlink">
<head>
<title>Virtual Library</title>
</head>
<body>
<paragraph>See <link xlink:type="simple" xlink:href="new.xml">what's
new</link>!</paragraph>
<paragraph>Check out the hot picks of the day!</paragraph>
<olist xml:base="/hotpicks/">
<item>
<link xlink:type="simple" xlink:href="pick1.xml">Hot Pick #1</link>
</item>
<item>
<link xlink:type="simple" xlink:href="pick2.xml">Hot Pick #2</link>
</item>
<item>
<link xlink:type="simple" xlink:href="pick3.xml">Hot Pick #3</link>
</item>
</olist>
</body>
</doc>
Die URIs in diesem Beispiel werden wie folgt zu vollständigen URIs
aufgelöst:
"what's new" wird aufgelöst zum URI
"http://example.org/today/new.xml"
"Hot Pick #1" wird aufgelöst zum URI
"http://example.org/hotpicks/pick1.xml"
"Hot Pick #2" wird aufgelöst zum URI
"http://example.org/hotpicks/pick2.xml"
"Hot Pick #3" wird aufgelöst zum URI
"http://example.org/hotpicks/pick3.xml"
3.1 Codieren und Ersetzen in URI-Verweisen
Die erlaubten Zeichen in xml:base-Attributen sind die
gleichen wie für XML, [Unicode]. Jedoch sind einige
Unicode-Zeichen nicht für URI-Verweise zugelassen, deshalb müssen Prozessoren diese
Zeichen codieren und ersetzen, um einen gültigen URI-Verweis vom
Attributwert zu erhalten.
Diese nicht zugelassenen Zeichen beinhalten alle Nicht-ASCII-Zeichen und
die in Abschnitt 2.4 von [IETF RFC 2396]
ausgeschlossenen Zeichen mit Ausnahme des Zahlenzeichens (#) und des
Prozentzeichens (%) und der eckigen Klammern, die laut [IETF RFC 2732] wieder erlaubt sind. Nicht zugelassene
Zeichen müssen wie
folgt ersetzt werden:
Jedes nicht erlaubte Zeichen wird in UTF-8 [IETF
RFC 2279] konvertiert als ein oder mehrere Bytes.
Alle Bytes, die einem nicht zugelassenen Zeichen zuzuordnen sind,
werden mit dem URI-Ersatzmechanismus ersetzt (das bedeutet, sie werden in
%HH konvertiert, wobei HH der hexadezimale Wert des Byte-Werts ist).
Das originale Zeichen wird von der erhaltenen Zeichenkette
ersetzt.
4 Auflösen relativer URIs
4.1 Beziehung zu RFC 2396
RFC 2396 [IETF RFC 2396] sieht vor,
Base-URI-Informationen in ein Dokument einzubetten. Die Regeln für die
Ermittlung des Base-URI können wie folgt zusammengefasst werden (höchste
Priorität zuerst):
Der Base-URI ist im Inhalt des Dokuments eingebettet.
Der Base-URI ist der des einschließenden Entity (z.B. message,
document, oder none).
Der Base-URI ist der URI, mit dem das Entity empfangen wurde.
Der Base-URI wird durch den Kontext der Anwendung definiert.
Anmerkung:
Der Begriff "Entity" in den Punkten #2 und #3 verwendet die Bedeutung laut
RFC 2396. In allen anderen Bereichen dieses Dokuments wird der Begriff
"Entity" in seiner XML-Bedeutung verwendet.
Dieses Dokument gibt die Details zu Punkt #1 an, für die Einbindung von
Base-URI-Informationen im speziellen Fall von XML-Dokumenten.
4.2 Feinheit von Base-URI-Information
Relative URIs in einem XML-Dokument werden immer nach einem Element, einem
Dokument-Entity oder einem externen Entity aufgelöst. Es gibt keinen
Mechanismus für eine feinere Auswahl, wie z.B. nach Attribut, nach Zeichen
oder nach Entity Base Informationen. Weder von internen Entities, ob in einem
internen Subset oder einer externen DTD deklariert, noch von freistehendem
Text (Text, der nicht von einem Element umschlossen wird) in einem externen
Entity wird erwartet, einen Base-URI zu setzen, der von dem Base-URI im
Bereich des Entity-Verweises abweicht.
Der Base-URI eines Dokument-Entities oder eines externen Entities wird von
den Regeln in RFC 2396 bestimmt. Das bedeutet, dass der Base-URI jener URI
ist, mit dessen Hilfe das Dokument-Entity oder das externe Entity empfangen
wurde.
Der Base-URI eines Elements ist:
der Base-URI, der durch das xml:base-Attribut des
Elements bestimmt wird, sofern eines existiert, sonst
der Base-URI des Elternelements innerhalb des Dokument-Entities oder
des externen Entities, sofern eines existiert, sonst
der Base-URI des Dokument-Entity oder des externen Entities, das
dieses Element enthält.
4.3 Vervollständigen von URIs mit Hilfe von
Base-URIs
Der Base-URI, der zu einem gegebenen relativen URI in einem XML-Dokument
gehört, wird wie folgt bestimmt:
Der Base-URI für einen URI-Verweis, der in einem Textinhalt
erscheint, ist der Base-URI des Elements, das den Text enthält.
Der Base-URI für einen URI-Verweis, der in einem
xml:base-Attribut erscheint, ist der Base-URI des
Elternelements jenes Elements, welches das xml:base-Attribut
enthält, sofern eines innerhalb des Dokument-Entities oder des externen
Entities existiert, ansonsten der Base-URI des Dokument-Entities oder des
externen Entities, welches das Element enthält.
Der Base-URI für einen URI-Verweis, der in irgendeinem anderen
Attributwert erscheint, eingeschlossen voreingestellte Attributwerte, ist
der Base-URI des Elements, welches das Attribut enthält.
Der Base-URI für einen URI-Verweis, der im Inhalt einer
Verarbeitungsanweisung steht, ist der Base-URI des Elternelements der
Verarbeitungsanweisung, sofern eines innerhalb des Dokument-Entities oder
des externen Entities existiert, ansonsten ist es der Base-URI des
Dokument-Entities oder des externen Entities, das die
Verarbeitungsanweisung enthält.
Anmerkung:
Die Gegenwart eines xml:base-Attributs kann in dem Fall zu
unerwarteten Ergebnissen führen, in dem der Attributwert nicht direkt im
XML-Dokument-Entity angegeben wird, sondern über einen voreingestellten
Wert, der in einem externen Entity deklariert ist. Solche Deklarationen
können eventuell nicht von einer Software gelesen werden, die auf einem
nicht validierenden XML-Prozessor aufbaut. Viele XML-Anwendungen versäumen
es, einen validierenden Prozessor zu fordern. Um eine korrekte Verarbeitung
durch solche Prozessoren sicherzustellen, sollten xml:base-Werte
entweder direkt oder über voreingestellte Attribute innerhalb des internen
Subsets der DTD angegeben werden.
5 Konformität
Eine Anwedung ist konform zu XML Base, wenn sie Base-URIs in
Übereinstimmung mit den Regeln bestimmt, die in dieser Spezifikation
vorgeschrieben werden.
