Ten dokument został zbadany przez członków W3C i inne zainteresowane strony, oraz został zatwierdzony przez Dyrektora jako Rekomendacja W3C. Jest on stabilny i może być używany jako materiał referencyjny lub cytowany w innych dokumentach jako referencja normatywna. Rolą W3C w utworzeniu tej rekomendacji było przyciągnięcie uwagi do tej specyfikacji oraz promowanie jej szerokiego zastosowania. Rozszerza to funkcjonalność i uniwersalność sieci internetowej.
Następujący dokument został sporządzony przez W3C XML Linking Working Group jako część pola działalności języka XML w strukturze domeny W3C. W celu uzyskania dalszych informacji dotyczących owej pracy zobacz proszę
XML
Activity Statement.
Proszę o zgłaszanie błędów zawartych w tym dokumencie na powszechną listę email www-xml-linking-comments@w3.org (archiwum na
http://lists.w3.org/Archives/Public/www-xml-linking-comments/). Wszelkie potwierdzone błędy zostaną dołączone do erraty dostępnej na http://www.w3.org/2001/06/xmlbase-errata.
Angielska wersja tej rekomendacji jest jedyną wersją normatywną. Jednakże przekłady w innych językach są dostępne pod: http://www.w3.org/2001/06/xmlbase-translations.
Listę aktualnych Rekomendacji W3C lub innych technicznych dokumentów można znaleść pod http://www.w3.org/TR/.
1 Wstęp
XML Linking Language [XLink]określa konstrukcję Rozszerzalnego Języka Znaczników (XML) 1.0 [XML]w celu opisania związków pomiędzy poszczególnymi zasobami. Jednym z podstawowych wymogów według XLink jest wspieranie konstrukcji łączących HTML [HTML 4.01]generycznie. Element HTML BASE zalicza się do konstrukcji zgodnej z wymogami Xlink Working Group. BASE pozwala autorom dobitnie określić base URI dokumentu w celu przejścia relatywnych URI w łączach do obrazów zewnętrznych, apletów, programów typu form-processing, arkuszy stylów, itp.
Dokument opisuje mechanizm mający na celu dostarczenie podstawowych usług URI dla Xlink, lecz w formie modułowej specyfikacji tak, aby inne aplikacje XML czerpały korzyści płynące z dodatkowej kontroli nad relatywnymi URI, jednak nie budowane na XLink, mogą także mieć z niego pożytek. Składnia składa się z pojedynczego atrybutu XML o nazwie xml:base.
Zastosowanie elementu XML BASE następuje poprzez odniesienie normatywne według nowych wytycznych, na przykład XLink oraz XML Infoset. Programy użytkowe i specyfikacje oparte na powyższych technologiach wesprą XML BASE. Zachowanie atrybutów xml:basew programach opartych na specyfikacjach nie posiadających bezpośrednich, lub pośrednich odniesień normatywnych dla XML Base jest nieokreślone.
2 Terminologia
[Definicja: Następujące słowa kluczowe: musi, nie może, wymagany, będzie, nie będzie, powinien, nie powinien, rekomendowany, oraz opocjonalnie w tej specyfikacji mają być interpretowane zgodnie z opisem [IETF RFC 2119].]
Określeń base URI, oraz relative URI używa się w owej specyfikacji, w sposób jaki jest określony w [IETF RFC 2396].
3 Atrybut xml:base
Atrybut xml:base można mieścić w dokumentach XML aby określic base URI inne, niż base URI dokumentu lub encji zewnętrznej. Wartość wymienionego atrybutu interpretuje się jako Referencje URI, jak wyszczególniono w RFC 2396 [IETF RFC 2396], według procedury zawartej w sekcji 3.1.
Dla procesorów XML obsługujących przestrzeń nazw, prefix ''xml'' jest związany z nazwą przestrzeni nazwy http://www.w3.org/XML/1998/namespacejak opisano w Namespaces w XML [XML Names]. Zauważ, że xml:base może być wciąż używane przez procesory nie obsługujące przestrzeni nazw.
Przykład xml:base w prostym dokumencie zawierającym XLink poniżej. XLink w normatywny sposób odnosi się do elementu XML BASE dla interpretacji referencji relatywnych URI w atrybutach xlink:href.
<?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> |
The URIs in this example resolve to full URIs as follows:
"what's new" przechodzi w URI "http://example.org/today/new.xml"
"Hot Pick #1" przechodzi w URI "http://example.org/hotpicks/pick1.xml"
"Hot Pick #2" przechodzi w URI "http://example.org/hotpicks/pick2.xml"
"Hot Pick #3" przechodzi w URI "http://example.org/hotpicks/pick3.xml"
3.1 Referencja URI Kodowanie danych i mechanizm pomijania
Zbiór symboli dozwolonych w atrybutach xml:base jest taka sama jak dla XML, mianowicie [Unicode]. Jednakże, niektóre symbole Unicode są niedozwolone w referencji URI, i dlatego też procesory muszą kodować i unikać powyższych symboli aby uzyskać prawidłową referencję URI z atrybutu wartości.
Niedozwolone symbole zawierają wszystkie symbole non-ASCII, plus symbole wykluczone zamieszczone w Section 2.4 [IETF RFC 2396],
[IETF RFC 2396], z wyjątkiem symboli znakowych numerycznych(?)(#) i znakowych procentowych (%) oraz symbolu kwadratowego nawiasu ponownie dopuszczonego w [IETF RFC 2732].
Odrzuconych symboli należy unikać w następujący sposób:
-
Każdy niedozwolony symbol jest przekształcony w UTF-8 [IETF RFC 2279] na jeden lub więcej bajtów.
-
Każdy bajt odpowiadający niedozwolonym symbolom zostanie pominięty dzięki mechanizmowi pomijania URI (to znaczy, przekształcony w %HH, gdzie HH jest szestnastkowym zapisem wartości bajta).
-
Oryginalny symbol jest zastąpiony sekwencją symboli wynikowych.
4 Rozkład relatywnych URI
4.1 Związek z RFC 2396
RFC 2396 [IETF RFC 2396] dostarcza dla base URI informacji dotyczącej umiejscowienia w dokumencie. Zasady dla określenia base URI można streścić w następujący sposób (od najważniejszego w dół):
-
Base URI jest umieszczony w zawartości dokumentu.
-
Base URI jest ten o właściwie zamkniętej całości (wiadomość, dokument, lub żaden).
-
Base URI jest URI wykorzystywanym do odzyskiwania całości.
-
Base URI jest określony przez kontekst aplikacji.
Uwaga:
Termin całość(entity) użyte w punkcie #2 i #3 powyżej odnosi się do znaczenia słowa naznaczonego w RFC 2396. Gdziekolwiek indziej w owym dokumencie terminu ''entity''(encja) używa się w znaczeniu charakterystycznym dla języka XML.
Dokument ten określa szczegóły zasady #1 związane z umieszczeniem informacji base URI w określonym kontekście dokumentów XML.
4.2 Stopień detalizacji informacji Base URI
Relatywne URI pojawiające się w dokumencie XML są zawsze rozkładane podrzędnie na albo element, encję dokumentu, lub encję zewnętrzną. Większy stopień detalizacji taki jak stosowanie per-attribute, per-character, czy per-entity informacji base nie jest wymagane. Ani encje wewnętrzne, czy to deklarowane w wewnętrznym podzbiorze, czy też w wewnętrznym DTD, ani tekst nie załączony do encji zewnętrznej, są uważane za przygotowujące base URI odrębne od base URI przeznaczonego dla referencji encji.
Base URI encji dokumentu, czy też encji zewnętrznej jest sprecyzowane przez zasady RFC 2396, mianowicie, że base URI jest URI używane do odzyskiwania encji dokumentu lub encji zewnętrznej.
Base URI URI elementu jest:
-
base URI określony przez atrybut xml:base, jeśli istnieje, w przeciwnym razie
- the base URI elementu należący do elementu nadrzędnego danego dokumentu lub encji zewnętrznej, jeśli istnieje, w przeciwnym razie
-
baseURI encji dokumentu lub encji zewnętrznej zawierającej dany element.
4.3 Łączenie URI z base URI
Base URI odpowiadające danym relatywnym URI pojawiającym się w dokumencie XML jest określone w następujący sposób:
-
Base URI dla referencji URI pojawiające się w zawartości tekstu jest base URI elementu zawierającego tekst.
-
Podstawowe URI dla referencji URI pojawiające się w atrybucie xml:basejest base URI elementu nadrzędnego należącego do elementu posiadającego atrybut xml:basejeśli taki istnieje w encji dokumentu lub encji zewnętrznej, w innym przypadku base URI encji dokumentu lub encji zewnetrznej zawierającej owy element.
-
Base URI dla referencji URI pojawiający się w jakiejkolwiek innej wartosci atrybutu , włączając w to domyślne wartości atrybutów, jest base URI elementu posiadającego owy atrybut.
-
Base URI dla referencji URI pojawiające się w zawartości instrukcji procesu przetwarzania jest base URI elementu nadrzędnego instrukcji procesu przetwarzania, jeśli taki istnieje w encji dokumentu lub encji zewnętrznej, w innym przypadku base URI encji dokumentu lub encji zewnętrznej zawierającej instrukcję procesu przetwarzania.
Uwaga:
Obecność atrybutów xml:base może doprowadzić do niespodziewanych wyników w przypadku gdzie dostarczono wartość atrybutu, nie bezpośrednio do encji dokumentu XML, lecz poprzez domyślny atrybut stwierdzony w encji zewnętrznej. Powyższe deklaracje mogą nie zostać odczytane przez oprogramowanie oparte na procesorach nie obsługujących języka XML. Many XML applications fail to require validating processors(?). Dla właściwego działania powyższych aplikacji, wartości xml:base neleży dostarczyć, albo bezpośrednio, lub przez domyślne atrybuty deklarowane w wewnętrznym podzbiorze DTD.
5 Zgodność
Jakakolwiek aplikacja jest zgodna z elementem XML BASE jeśli jest w stanie obliczyć base URI według warunków przedłożonych w tej specyfikacji.
