Stíluslap XML dokumentumhoz

A WebBuilderWikiBÓL

Tartalomjegyzék

[szerkesztés] Stíluslapok hozzárendelése XML dokumentumokhoz - Version 1.0

'W3C Ajánlás, 1999. június 29.'

Jelen verzió eredetije
http://www.w3.org/1999/06/REC-xml-stylesheet-19990629
Legutóbbi verzió
http://www.w3.org/TR/xml-stylesheet
Előző verzió
http://www.w3.org/TR/1999/xml-stylesheet-19990428
Szerkesztette
James Clark jjc@jclark.com

Copyright © 1999 W3C (MIT, INRIA, Keio ), minden jog fenntartva. A W3C felelősségvállalási, védjegyhasználati, dokumentumhasználati és szoftverlicensz szabályai alkalmazandók.


[szerkesztés] Bevezetés

Jelen dokumentum leírja, hogyan kell stíluslapot XML dokumentumhoz rendelni, a dokumentum elején alkalmazott egy vagy több feldolgozási utasítás használatával.

[szerkesztés] A dokumentum státusza

Jelen dokumentumot a W3C tagjai és más érdekeltek felülvizsgálták és az Igazgató jóváhagyta, mint W3C Ajánlást. Ez egy stabil dokumentum, referenciaanyagként használható, idézhető más dokumentumokban is normatív hivatkozásként. A W3C szerepe az Ajánlás létrehozásában az, hogy felhívja a figyelmet a specifikációra és elősegítse használatának elterjedését. Ez kiterjeszti a Web használhatóságát és kezelhetőségét.

Az ismert hibák felsorolása elérhető a http://www.w3.org/TR/1999/xml-stylesheet-19990629/errata címen.

Jelen specifikációval kapcsolatos vélemények a www-xml-stylesheet-comments@w3.org címre küldhetőek. A nyilvánosságra hozott vélemények archívuma elérhető a http://w3.org/Archives/Public/www-xml-stylesheet-comments címen.

Az aktuális W3C Ajánlások és más technikai dokumentumok felsorolása megtalálható a http://www.w3.org/TR címen.

A Munkacsoport valószínűnek tartja, hogy a jövőben az XML dokumentumokhoz a stíluslapokat további módokon is csatolni lehet.

A jelen specifikációban szereplő XML feldolgozási utasítások használati módját nem kell irányadónak tekinteni. A W3C nem szándékozik a jövőben a feldolgozási utasításokról ajánlást kibocsátnai. A Racionálé kifejti, miért is használtuk mégis jelen specifikációban.

Jelen dokumentum a W3C XML Tevékenységének részeként jött létre.

A magyar fordítás a HTML Info szerkesztőjének munkája. A fordítás során a legnagyobb gondossággal jártunk el, ennek ellenére a szövegben maradhattak helyesírási, illetve egyéb hibák.

A HTML Info nem vállal felelősséget a dokumentum felhasználásából eredő bármilyen vélt, valós, közvetlen, vagy közvetett kárért. Kérjük az olvasót, hogy az esetleges fordítási, helyesírási, tartalmi hibákra hívja fel figyelmünket a htmlinfo@htmlinfo.hu címre küldött e-maillel.

[szerkesztés] 1 - Az xml-stylesheet feldolgozási utasítás

A stíluslapok egy feldolgozási utasítással rendelhetők egy XML dokumentumhoz, amelynek célja egy xml-stylesheet. Ez a feldolgozási utasítás a HTML 4.0 -ből ismert <LINK REL="stylesheet"> kifejezésnek megfelelően viselkedik.

Az xml-stylesheet feldolgozási utasítás elemzése ugyanúgy történik, mint egy kezdő címkéé, azzal a különbséggel, hogy a nem előre definiált egyedek nem hivatkozhatóak.

A következőkben megadott nyelvtan ugyanazt a jelölést használja, mint az XML Ajánlás nyelvtana. A nyelvtan itt nem definiált szimbólumai az XML Ajánlásban definiáltak.

[szerkesztés] xml-stylesheet feldolgozási utasítás

[1] StyleSheetPI    ::= '<?xml-stylesheet' (S PseudoAtt)* S? '?>'
[2] PseudoAtt       ::= Name S? '=' S? PseudoAttValue
[3] PseudoAttValue  ::= ('"' ([^"<&] | CharRef | PredefEntityRef)* '"'
                        "'" ([^'<&] | CharRef | PredefEntityRef)* "'")
                        - (Char* '?>' Char*)
[4] PredefEntityRef ::= '&' | '<' | '>' | '"' | '&apos;'


A PseudoAttValue-ban egy CharRef vagy egy PredefEntityRef ugyanúgy van értelmezve, mint egy normál XML attribútum értékben. A pszeudo-attribútum aktuális értéke az az érték, amelyet a feldolgozó a hivatkozások helyére behelyettesít. Ezt a behelyettesítést az XML értelmező nem hajtja végre automatikusan.

Az xml-stylesheet feldolgozási utasítás csak az XML dokumentum elején engedélyezett. Az XML nyelvtana korlátozásokat tartalmaz, ha feldolgozási utasítás engedélyezett a dokumentum elején; az xml-stylesheet feldolgozási utasítás a dokumentum elején bárhol engedélyezett, ahol megfelel a korlátozásoknak.

MEGJEGYZÉS:
Ha az xml-stylesheet feldolgozási utasítás a külső
DTD alkészletben vagy paraméter egyedben található,
lehetséges, hogy egy nem-érvényesítő (non-validating)
XML feldolgozó végrehajtja (lásd: [XML10]). 

A következő pszeudo-attribútumok definiáltak:

href      CDATA    #REQUIRED
type      CDATA    #REQUIRED
title     CDATA    #IMPLIED
media     CDATA    #IMPLIED
charset   CDATA    #IMPLIED
alternate (yes|no) "no"

A pszeudo-attribútumok jelentése pontosan ugyanaz, mint a HTML 4.0 -ben a <LINK REL="stylesheet">, kivéve az alternate pszeudo-attribútumot. Ha ebben alternate="yes" van megadva, akkor a feldolgozási utasítás jelentése ugyanaz, mint a <LINK REL="alternate stylesheet"> HTML elemé, nem pedig a <LINK REL="stylesheet"> elem-attribútum páréval egyezik meg.

MEGJEGYZÉS:
Mivel a href attribútum értéke URI hivatkozás,
az lehet relatív URI is és tartalmazhat részazonosítót is.
Részletesebben, az URI hivatkozás állhat csak részazonosítóból is.
Így egy URI hivatkozás tulajdonsképpen hivatkozás a dokumentumnak
arra a részére, amely az xml-stylesheet feldolgozási utasítást
tartalmazza (lásd: RFC2396). Ennek eredménye, hogy az xml-stylesheet
feldolgozási utasítás lehetővé teszi, hogy a stíluslapok
ugyanabba a dokumentumba legyenek beágyazva, mint az xml-stylesheet
feldolgozási utasítás. 

Bizonyos esetekben a stíluslapok csatolhatók külső eszközökkel is a dokumentumhoz. Például, a HTTP korábbi verzióiban (RFC2068, 19.6.2.4 alpont) engedélyezett, hogy az XML dokumentumhoz rendelt stíluslap a [LINK] fejléccel kapcsolódjon. Bármely stíluslapra mutató kapcsolat, amely a dokumentumhoz kívülről kapcsolódik, úgy lesz figyelembe véve, mintha az xml-stylesheet feldolgozási utasítás előtt fordulna elő. Ez ugyanugy működik, mint a HTML 4.0 -ben (lásd: 14.6 pont).

Néhány példa a HTML 4.0 -ből, a neki megfelelő feldolgozási utasítással együtt:


<LINK href="mystyle.css" rel="style sheet" type="text/css">

<?xml-stylesheet href="mystyle.css" type="text/css"?>


<LINK href="mystyle.css" title="Compact" rel="stylesheet" type="text/css">

<?xml-stylesheet href="mystyle.css" title="Compact" type="text/css"?>


<LINK href="mystyle.css" title="Medium" rel="alternate stylesheet" type="text/css">

<?xml-stylesheet alternate="yes" href="mystyle.css" title="Medium" type="text/css"?>

Több xml-stylesheet végrehajtási utasítás is engedélyezett, pontosan ugyanazokkal a használati szabályokkal, mint a LINK REL="stylesheet". Például:

<LINK rel="alternate stylesheet" title="compact" href="small-base.css" type="text/css">

<LINK rel="alternate stylesheet" title="compact" href="small-extras.css" type="text/css">

<LINK rel="alternate stylesheet" title="big print" href="bigprint.css" type="text/css">

<LINK rel="stylesheet" href="common.css" type="text/css">

A fentiek feldolgozási utasításként:

<?xml-stylesheet alternate="yes" title="compact" href="small-base.css" type="text/css"?>

<?xml-stylesheet alternate="yes" title="compact" href="small-extras.css" type="text/css"?>

<?xml-stylesheet alternate="yes" title="big print" href="bigprint.css" type="text/css"?>

<?xml-stylesheet href="common.css" type="text/css"?>

[szerkesztés] A Függelék - Hivatkozások

HTML40
World Wide Web Consortium. HTML 4.0 Specification. W3C Ajánlás.
http://www.w3.org/TR/REC-html40
RFC2068
R. Fielding, J. Gettys, J. Mogul, H. Frystyk Nielsen, és T. Berners-Lee. Hypertext Transfer Protocol -- HTTP/1.1.. IETF RFC 2068.

http://www.ietf.org/rfc/rfc2068.txt.

RFC2396
T. Berners-Lee, R. Fielding, és L. Masinter. Uniform Resource Identifiers (URI): Generic Syntax. IETF RFC 2396.
Lásd http://www.ietf.org/rfc/rfc2396.txt.
XML10
World Wide Web Consortium. Extensible Markup Language (XML) 1.0. W3C Ajánlás. Lásd:
http://www.w3.org/TR/1998/REC-xml-19980210

[szerkesztés] B Függelék - Racionálé

Sürgősen szükségessé vált egy olyan specifikációt kiadni a stíluslap csatolásról, amely időben elkészül ahhoz, hogy a főbb böngészőkészítők figyelembe vehessék. Ez csak egy bizonyítottan működő, már létező mechanizmushoz közel álló eljárás választásával vált lehetségessé.

Egy feldolgozási utasítás használatával elkerülehető a fő dokumentum szerkezetének megfertőzése alkalmazás-specifikus feldolgozási információval.

A specifikáció jelen verziójához választott mechanizmus nem korlátozza a jövőbeni verziók további eljárásmódjait. Nincs olyan elvárás, hogy azok feldolgozási utasításokat használjanak; valójában nem is biztos, hogy a forrásdokumentumba kell foglalni a csatolási információkat.

--Htmlinfo 2007. február 14., 19:39 (CET)

Személyes eszközök