XML namespace: Difference between revisions
mNo edit summary |
m (using an external editor) |
||
Line 1: | Line 1: | ||
{{Incomplete}} | {{Incomplete}} | ||
Note on its production: It's a Framemaker to Word to Mediawiki translation from parts of teaching slides - | This is an ''introductory'' XML namespace tutorial. | ||
Note on its production: It's a Framemaker to Word to Mediawiki translation from parts of teaching slides. There are some details that need to be fixed - (20 March 2007) | |||
== Definition == | == Definition == | ||
Line 32: | Line 33: | ||
* http://www.w3.org/2004/CDF/ | * http://www.w3.org/2004/CDF/ | ||
See also: The [[standard]]s overview article. Most XML-based standards in education (e.g. [[IMS Content Packaging]] make heavy use of namespaces ! In addition most [[IMS]] and [[SCORM]] standards use [[XML Schema]] which are associated to XML contents via namespace declarations. | See also: The [[standard]]s overview article. Most XML-based standards in education (e.g. [[IMS Content Packaging]] make heavy use of namespaces ! In addition, most [[IMS]] and [[SCORM]] standards use [[XML Schema]]s which are associated to XML contents via namespace declarations. | ||
== Namespaces == | == Namespaces == | ||
Line 38: | Line 39: | ||
=== An example demonstrating the need for namespaces === | === An example demonstrating the need for namespaces === | ||
Here is an XML fragment using title within a bibliography element: | Here is an XML fragment using '''title''' within a '''bibliography''' element: | ||
< | <nowiki>book</nowiki> | ||
< | <nowiki>title</nowiki>A true story<nowiki>/title</nowiki> | ||
< | <nowiki>description</nowiki>A real cool publication<nowiki>/description</nowiki> | ||
< | <nowiki>/book</nowiki> | ||
A 2nd XML fragment uses title in a employees record: | A 2nd XML fragment uses '''title''' in a '''employees''' record: | ||
< | <nowiki>record</nowiki> | ||
< | <nowiki>name</nowiki>Miller<nowiki>/name</nowiki> <nowiki>title</nowiki>Dr. <nowiki>/title</nowiki> | ||
< | <nowiki>publications</nowiki> ... <nowiki>/publications</nowiki> | ||
< | <nowiki>/record</nowiki> | ||
If these two XML fragments were added together, there would be a name conflict because both contain a < | If these two XML fragments were added together, there would be a name conflict because both contain a <nowiki>title</nowiki> element with different meaning. In one case we mean ''book title'' and in the other ''something link nothing, PhD, etc.''. E.g. a stylesheet would have to render these elements very differently. But we can solve this problem by adding prefixes, like this: | ||
< | <nowiki>''employees'':record</nowiki> | ||
< | <nowiki>''employees'':name</nowiki>Miller<nowiki>/''employees'':name</nowiki> | ||
< | <nowiki>''employees'':title</nowiki>Dr. <nowiki>/''employees'':title</nowiki> | ||
< | <nowiki>''employees'':publications</nowiki> | ||
< | <nowiki>''biblio'':book</nowiki> | ||
< | <nowiki>''biblio'':title</nowiki>A true story<nowiki>/biblio:title</nowiki> | ||
< | <nowiki>''biblio'':description</nowiki>A real cool publication<nowiki>/biblio:description</nowiki> | ||
< | <nowiki>/''biblio'':book</nowiki> | ||
< | <nowiki>/''employees'':publications</nowiki> | ||
< | <nowiki>/''employees'':record</nowiki> | ||
=== Declaring namespaces === | === Declaring namespaces === | ||
Line 71: | Line 72: | ||
# Create or identify a namespace identifier you wish to use: An XML namespace is identified by a unique URI reference, usually a URL. | # Create or identify a namespace identifier you wish to use: An XML namespace is identified by a unique URI reference, usually a URL. | ||
# The URL '''need not point to anything on the Internet'''. It is just used as a unique string, i.e. a name | # The URL does '''need not point to anything on the Internet'''. It is just used as a unique string, i.e. a name ! | ||
# Therefore if some namespace URLs below are broken there is absolutly nothing to worry about. However, most namespace identifiers actually point to a real web page that either provides an explanation or at least informations about the organization. This means that if you plan to create your own namespaces, you should use the name of any webpage over which you have control. | # Therefore if some namespace URLs below are broken there is absolutly nothing to worry about. However, most namespace identifiers actually point to a real web page that either provides an explanation or at least informations about the organization/author that created the namespace. This means that if you plan to create your own namespaces, you should use the name of any webpage over which you have control. | ||
# Make a namespace declaration within the element that belongs to this namespace, i.e. map a prefix of your choice to a unique URI. | # Make a namespace declaration within the element that belongs to this namespace, i.e. map a prefix of your choice to a unique URI. | ||
Line 79: | Line 80: | ||
(1) declaring a namespace that will require insertion of prefixes | (1) declaring a namespace that will require insertion of prefixes | ||
< | <nowiki>prefix:element xmlns:prefix="URI"</nowiki> | ||
e.g. | e.g. | ||
< | <nowiki>html:html xmlns:html=<nowiki>’</nowiki>http://www.w3.org/1999/xhtml<nowiki>’></nowiki> | ||
(2) declaring a default namespace | (2) declaring a default namespace for an element plus its children (by default they belong to namespace of the parent). See also below. | ||
< | <nowiki>element xmlns="URI"</nowiki> | ||
e.g. | e.g. | ||
< | <nowiki>html xmlns=<nowiki>’</nowiki>http://www.w3.org/1999/xhtml<nowiki>’></nowiki> ..... | ||
=== Scoping === | === Scoping === | ||
Line 96: | Line 97: | ||
;XHMTL fragment example: | ;XHMTL fragment example: | ||
< | <nowiki>?xml version="1.0"?</nowiki> | ||
< | <nowiki>html:html xmlns:html=<nowiki>’</nowiki>http://www.w3.org/1999/xhtml<nowiki>’></nowiki> | ||
< | <nowiki>html:headhtml:title</nowiki>Frobnostication<nowiki>/html:title/html:head</nowiki> | ||
< | <nowiki>html:bodyhtml:p</nowiki>Moved to | ||
< | <nowiki>html:a href=<nowiki>’</nowiki>http://frob.example.com<nowiki>’></nowiki>here.<nowiki>/html:a/html:p</nowiki> | ||
< | <nowiki>/html:body</nowiki> | ||
< | <nowiki>/html:html</nowiki> | ||
;Example with 2 namespaces (both use URNs instead of URLs) | ;Example with 2 namespaces (both use URNs instead of URLs) | ||
< | <nowiki>?xml version="1.0"?</nowiki> | ||
< | <nowiki>!-- both namespace prefixes are available throughout --</nowiki> | ||
< | <nowiki>bk:book xmlns:bk=<nowiki>’</nowiki>urn:loc.gov:books<nowiki>’</nowiki> xmlns:isbn=<nowiki>’</nowiki>urn:ISBN:0-395-36341-6<nowiki>’></nowiki> | ||
< | <nowiki>bk:title</nowiki>Cheaper by the Dozen<nowiki>/bk:title</nowiki> | ||
< | <nowiki>isbn:number</nowiki>1568491379<nowiki>/isbn:number</nowiki> | ||
< | <nowiki>/bk:book</nowiki> | ||
=== Default namespaces === | === Default namespaces === | ||
If most elements in an XML document belonged to the same namespace, it | If most elements in an XML document belonged to the same namespace, it would be ugly to prefix each element name. Instead, define a default namespace that applies to all non-prefixed elements and attributes. | ||
< | <nowiki>element xmlns="URI"</nowiki> .... | ||
The default namespace applies to the element | The default namespace applies to the element in which it was defined and all descendants of that element. But if a descendants has another default namespace defined on it, this new namespace definition overrides the previous one and becomes the default for that element and its descendants. | ||
Note that namespaces does not apply to attribute names ! This is a likely source of trouble for XSLT ... | Note that namespaces does not apply to attribute names ! This is a likely source of trouble for XSLT ... | ||
;XHTML default namespace example: | ;XHTML default namespace example: | ||
< | <nowiki>?xml version="1.0"?</nowiki> | ||
< | <nowiki>!-- elements are in the HTML namespace by default --</nowiki> | ||
< | <nowiki>html xmlns=<nowiki>’</nowiki>http://www.w3.org/1999/xhtml<nowiki>’></nowiki> | ||
<nowiki> | <nowiki>headtitle</nowiki>Frobnostication<nowiki>/title/head</nowiki> | ||
<nowiki> | <nowiki>bodyp</nowiki>Moved to | ||
< | <nowiki>a href=<nowiki>’</nowiki>http://frob.example.com<nowiki>’></nowiki>here<nowiki>/a</nowiki>.<nowiki>/p/body</nowiki> | ||
< | <nowiki>/html</nowiki> | ||
Default namespace for a book vocabulary plus a namespace for ISBN example: | Default namespace for a book vocabulary plus a namespace for ISBN example: | ||
< | <nowiki>?xml version="1.0"?</nowiki> | ||
< | <nowiki>!-- unprefixed element types are from "books" --</nowiki> | ||
< | <nowiki>book xmlns=<nowiki>’</nowiki>urn:loc.gov:books<nowiki>’</nowiki> | ||
xmlns:isbn=<nowiki>’</nowiki>urn:ISBN:0-395-36341-6<nowiki>’></nowiki> | xmlns:isbn=<nowiki>’</nowiki>urn:ISBN:0-395-36341-6<nowiki>’></nowiki> | ||
< | <nowiki>title</nowiki>Cheaper by the Dozen<nowiki>/title</nowiki> | ||
< | <nowiki>isbn:number</nowiki>1568491379<nowiki>/isbn:number</nowiki> | ||
< | <nowiki>/book</nowiki> | ||
;A larger example of namespace scoping | ;A larger example of namespace scoping | ||
Line 145: | Line 146: | ||
It includes some XHTML whose namespace is declared within the "p" element. | It includes some XHTML whose namespace is declared within the "p" element. | ||
< | <nowiki>?xml version="1.0"?</nowiki> | ||
< | <nowiki>!-- initially, the default namespace is "books" --</nowiki> | ||
< | <nowiki>book xmlns=<nowiki>’</nowiki>urn:loc.gov:books<nowiki>’</nowiki> xmlns:isbn=<nowiki>’</nowiki>urn:ISBN:0-395-36341-6<nowiki>’></nowiki> | ||
< | <nowiki>title</nowiki>Cheaper by the Dozen<nowiki>/title</nowiki> | ||
< | <nowiki>isbn:number</nowiki>1568491379<nowiki>/isbn:number</nowiki> | ||
< | <nowiki>notes</nowiki> | ||
< | <nowiki>!-- make HTML the default namespace for some commentary --</nowiki> | ||
< | <nowiki>p xmlns=<nowiki>’</nowiki>http://www.w3.org/1999/xhtml<nowiki>’></nowiki> This is a <nowiki>i</nowiki>funny<nowiki>/i</nowiki> book! | ||
< | <nowiki>/p</nowiki> | ||
< | <nowiki>/notes</nowiki> | ||
< | <nowiki>/book</nowiki> | ||
; XSLT namespace example | ; XSLT namespace example | ||
# XSLT instructions are prefixed with "xsl" here | # XSLT instructions are prefixed with "xsl" here | ||
# Output is namespace-less here | # Output is namespace-less here ...) | ||
< | |||
< | <nowiki>?xml version="1.0"?</nowiki> | ||
< | <nowiki>xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"</nowiki> | ||
<nowiki>xsl:template match="page"</nowiki> | |||
..... | ..... | ||
< | <nowiki>html</nowiki> | ||
< | <nowiki>head</nowiki> <nowiki>title</nowiki> <nowiki>xsl:value-of select="title"/</nowiki> <nowiki>/title</nowiki><nowiki>/head</nowiki> | ||
< | <nowiki>body bgcolor="<nowiki> </nowiki>ffffff"</nowiki> | ||
< | <nowiki>xsl:apply-templates/</nowiki> | ||
< | <nowiki>/body</nowiki> | ||
< | <nowiki>/html</nowiki> | ||
< | <nowiki>/xsl:template</nowiki> | ||
< | <nowiki>xsl:template match="title"</nowiki> | ||
< | <nowiki>h1 align="center"</nowiki> | ||
< | <nowiki>xsl:apply-templates/</nowiki> | ||
< | <nowiki>/h1</nowiki> | ||
< | <nowiki>/xsl:template</nowiki> | ||
< | <nowiki>xsl:template match="content"</nowiki> | ||
< | <nowiki>p align="center"</nowiki> | ||
< | <nowiki>xsl:apply-templates/</nowiki> | ||
< | <nowiki>/p</nowiki> | ||
< | <nowiki>/xsl:template</nowiki> | ||
< | <nowiki>xsl:template match="comment"</nowiki> | ||
< | <nowiki>hr /</nowiki> | ||
< | <nowiki>xsl:apply-templates/</nowiki> | ||
< | <nowiki>/xsl:template</nowiki> | ||
< | <nowiki>/xsl:stylesheet</nowiki> | ||
=== Validation of composite documents === | === Validation of composite documents === | ||
Line 202: | Line 204: | ||
# We declare the namespace in the root element, but also could have done it just for the "el" element... | # We declare the namespace in the root element, but also could have done it just for the "el" element... | ||
< | <nowiki>!ELEMENT link_list (el<nowiki>+</nowiki>)</nowiki> | ||
< | <nowiki>!ATTLIST link_list xmlns:xlink CDATA <nowiki> </nowiki>FIXED "http://www.w3.org/1999/xlink"</nowiki> | ||
< | <nowiki>!ELEMENT el (<nowiki> </nowiki>PCDATA)</nowiki> | ||
< | <nowiki>!ATTLIST el description CDATA <nowiki> </nowiki>IMPLIED xlink:href CDATA <nowiki> </nowiki>REQUIRED xlink:type CDATA <nowiki> </nowiki>FIXED "simple"</nowiki> | ||
; An XML Example file | ; An XML Example file | ||
< | <nowiki>?xml version="1.0" encoding="ISO-8859-1" ?</nowiki> | ||
< | <nowiki>!DOCTYPE link_list SYSTEM "link_list.dtd"</nowiki> | ||
< | <nowiki>?xml-stylesheet href="link_list.css" type="text/css" ?</nowiki> | ||
< | <nowiki>link_list xmlns:xlink="http://www.w3.org/1999/xlink"</nowiki> | ||
< | <nowiki>el description="verified" xlink:type="simple" xlink:href="http://tecfa.unige.ch/"</nowiki>TECFA<nowiki>/el</nowiki> | ||
< | <nowiki>el xlink:href="http://tecfa.unige.ch/" xlink:type="simple"</nowiki>TECFA<nowiki>/el</nowiki> | ||
< | <nowiki>/link_list</nowiki> | ||
== Client-side XML languages and namespaces overview == | == Client-side XML languages and namespaces overview == | ||
Line 299: | Line 301: | ||
Workarounds: | Workarounds: | ||
* Use a browser that is more advanced (e.g. Firefox) or specialized players (e.g. Realplayer for SMIL) | * Use a browser that is more advanced (e.g. Firefox) or specialized players (e.g. Realplayer for SMIL) | ||
* Install plugins for your web browser and use a more indirect method to assemble contents, i.e. < | * Install plugins for your web browser and use a more indirect method to assemble contents, i.e. <nowiki>object</nowiki> or <nowiki>iframe</nowiki> This will work with most browsers if you have the right plugin (SVG in this case) installed. | ||
< | <nowiki>iframe src="hello-svg.svg" height="300" width="80%" frameborder="0"</nowiki> | ||
... Sorry you need an SVG plugin ... | ... Sorry you need an SVG plugin ... | ||
< | <nowiki>/iframe</nowiki> | ||
=== XHTML + other vocabularies === | === XHTML + other vocabularies === | ||
Line 317: | Line 319: | ||
; Example - Story grammar that implements XLink for an A element | ; Example - Story grammar that implements XLink for an A element | ||
< | <nowiki>?xml version="1.0" encoding="ISO-8859-1" ?</nowiki> | ||
< | <nowiki>STORY xmlns:xlink="http://www.w3.org/1999/xlink"</nowiki> | ||
< | <nowiki>Title</nowiki>The Webmaster<nowiki>/Title</nowiki> | ||
..... | ..... | ||
< | <nowiki>INFOS</nowiki> | ||
< | <nowiki>Date</nowiki>30 octobre 2003<nowiki>/Date</nowiki> | ||
< | <nowiki>Author</nowiki>DKS -<nowiki>/Author</nowiki> | ||
< | <nowiki>A xlink:href=http://jigsaw.w3.org/css-validator/check/referer xlink:type="simple"</nowiki>CSS Validator<nowiki>/A</nowiki> | ||
< | <nowiki>/INFOS</nowiki> | ||
< | <nowiki>/STORY</nowiki> | ||
;SVG example | ;SVG example | ||
Line 332: | Line 334: | ||
XHTML with embedded SVG tags (tested with Firefox) | XHTML with embedded SVG tags (tested with Firefox) | ||
< | <nowiki>?xml version="1.0" encoding="ISO-8859-1" ?</nowiki> | ||
< | <nowiki>!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" </nowiki> | ||
< | <nowiki>html xmlns="http://www.w3.org/1999/xhtml" | ||
xmlns:svg="http://www.w3.org/2000/svg" | xmlns:svg="http://www.w3.org/2000/svg"</nowiki> | ||
< | <nowiki>head</nowiki> | ||
< | <nowiki>title</nowiki>SVG within XHTML Demo<nowiki>/title</nowiki> | ||
< | <nowiki>/head</nowiki> | ||
< | <nowiki>body</nowiki> | ||
.... The SVG part starts below < | .... The SVG part starts below <nowiki>hr /</nowiki> | ||
< | <nowiki>svg xmlns="http://www.w3.org/2000/svg" version="1.1" width="400" height="300"</nowiki> | ||
< | <nowiki>!-- a small rectangle --</nowiki> | ||
< | <nowiki>rect x="50" y="50" rx="5" ry="5" width="300" height="100" style="fill:<nowiki> </nowiki>CCCCFF;stroke:#000099"/</nowiki> | ||
< | <nowiki>!-- a text in the same place --</nowiki> | ||
< | <nowiki>text x="55" y="90" style="stroke:#000099;fill:#000099;font-size:24;"</nowiki>HELLO dear reader <nowiki>/text</nowiki> | ||
< | <nowiki>/svg</nowiki> | ||
< | <nowiki>hr /</nowiki> | ||
The SVG part ended above | The SVG part ended above | ||
< | <nowiki>/body</nowiki> | ||
< | <nowiki>/html</nowiki> | ||
=== Combining XHTML with your XML === | === Combining XHTML with your XML === | ||
Line 371: | Line 373: | ||
XHTML with some cooking XML included (file cooking.xhtml): | XHTML with some cooking XML included (file cooking.xhtml): | ||
< | <nowiki>?xml version="1.0" encoding="iso-8859-1"?</nowiki> | ||
< | <nowiki>?xml-stylesheet type="text/css" href="cooking.css"?</nowiki> | ||
< | <nowiki>html xmlns="http://www.w3.org/1999/xhtml" xmlns:re="http://tecfa.unige.ch/ns/cooking"</nowiki> | ||
< | <nowiki>head</nowiki> | ||
< | <nowiki>title</nowiki>A Compound XHTML-XML Document<nowiki>/title</nowiki> | ||
< | <nowiki>!-- this should work with IE but doesn<nowiki>’</nowiki>t, maybe IE6 ? --</nowiki> | ||
< | <nowiki>link href="cooking.css" type="text/css" rel="stylesheet"/</nowiki> | ||
< | <nowiki>/head</nowiki> | ||
< | <nowiki>body</nowiki> | ||
< | <nowiki>h1</nowiki>A Compound XHTML-XML Document<nowiki>/h1</nowiki> | ||
< | <nowiki>p</nowiki>Contains a cooking recipee written down by R. D. as an exercise. | ||
Everything below the line is XML styled with a CSS stylesheet< | Everything below the line is XML styled with a CSS stylesheet<nowiki>/ p</nowiki> | ||
< | <nowiki>hr/</nowiki> | ||
< | <nowiki>re:recipe</nowiki> | ||
< | <nowiki>re:recipe_head</nowiki> | ||
< | <nowiki>re:recipe_name</nowiki>Cold Salmon in Creamy Spiced Sauce<nowiki>/re:recipe_name</nowiki> | ||
< | <nowiki>re:recipe_author</nowiki>H.W.<nowiki>/re:recipe_author</nowiki> | ||
< | <nowiki>re:meal_type</nowiki>Fish and Shellfish<nowiki>/re:meal_type</nowiki> | ||
< | <nowiki>/re:recipe_head</nowiki> | ||
..... | ..... | ||
< | <nowiki>/re:recipe</nowiki> | ||
< | <nowiki>/body</nowiki> | ||
< | <nowiki>/html</nowiki> | ||
=== Combining your XML with XHTML === | === Combining your XML with XHTML === | ||
Line 402: | Line 404: | ||
;XML plus XHTML (file xml_plus_xhtml.xml) | ;XML plus XHTML (file xml_plus_xhtml.xml) | ||
< | <nowiki>?xml version="1.0" ?</nowiki> | ||
< | <nowiki>?xml-stylesheet href="xml_plus_xhtml.css" type="text/css"?</nowiki> | ||
< | <nowiki>page xmlns:html="http://www.w3.org/1999/xhtml" updated="jan 2007"</nowiki> | ||
< | <nowiki>title</nowiki>Hello friend<nowiki>/title</nowiki> | ||
< | <nowiki>list</nowiki> | ||
< | <nowiki>!-- we use an HTML tag below to include a picture --</nowiki> | ||
< | <nowiki>html:img src="photo.jpg"/</nowiki> | ||
< | <nowiki>item price="10"</nowiki> White plate <nowiki>/item</nowiki> | ||
< | <nowiki>item price="20"</nowiki> Gold plate <nowiki>/item</nowiki> | ||
< | <nowiki>item price="15"</nowiki> Silver plate <nowiki>/item</nowiki> | ||
< | <nowiki>/list</nowiki> | ||
< | <nowiki>comment</nowiki> Written by <nowiki>html:a href="...."</nowiki>DKS/Tecfa<nowiki>/html:a</nowiki> , feb 2007 <nowiki>/comment</nowiki> | ||
< | <nowiki>/page</nowiki> | ||
[[Category: Technologies]] | [[Category: Technologies]] | ||
[[Category: XML]] | [[Category: XML]] | ||
[[Category: Tutorials]] | [[Category: Tutorials]] |
Revision as of 10:25, 4 May 2007
This is an introductory XML namespace tutorial.
Note on its production: It's a Framemaker to Word to Mediawiki translation from parts of teaching slides. There are some details that need to be fixed - (20 March 2007)
Definition
XML Namespaces allow to fully/uniquely qualify XML element and attribute names to prevent from confusing two elements that have the same name but mean different things.
Purpose and history of XML namespace
Various XML vocabularies (languages/applications) can be mixed. But then we can run into naming conflicts, i.e. different vocabularies (DTDs) can use the same names for elements !
Since DTDs are not mandatory for most W3C languages, the W3C requires namespace definitions within root elements, e.g. XHTML must have one:
<html xmlns="http://www.w3.org/1999/xhtml">
Namespaces are a W3C standard since Jan 1999. That means that namespaces have been introduced after XML has been invented.
Standards involved
The Namespace standard:
Namespaces are identified with URIs
A URI is either a URL or a URN
Compound W3C documents
See also: The standards overview article. Most XML-based standards in education (e.g. IMS Content Packaging make heavy use of namespaces ! In addition, most IMS and SCORM standards use XML Schemas which are associated to XML contents via namespace declarations.
Namespaces
An example demonstrating the need for namespaces
Here is an XML fragment using title within a bibliography element:
book titleA true story/title descriptionA real cool publication/description /book
A 2nd XML fragment uses title in a employees record:
record nameMiller/name titleDr. /title publications ... /publications /record
If these two XML fragments were added together, there would be a name conflict because both contain a title element with different meaning. In one case we mean book title and in the other something link nothing, PhD, etc.. E.g. a stylesheet would have to render these elements very differently. But we can solve this problem by adding prefixes, like this:
''employees'':record ''employees'':nameMiller/''employees'':name ''employees'':titleDr. /''employees'':title ''employees'':publications ''biblio'':book ''biblio'':titleA true story/biblio:title ''biblio'':descriptionA real cool publication/biblio:description /''biblio'':book /''employees'':publications /''employees'':record
Declaring namespaces
Formally speaking, an XML namespace is simply a collection of names (elements and attributes) of a markup vocabulary that can be uniquely identified
- Procedure
- Create or identify a namespace identifier you wish to use: An XML namespace is identified by a unique URI reference, usually a URL.
- The URL does need not point to anything on the Internet. It is just used as a unique string, i.e. a name !
- Therefore if some namespace URLs below are broken there is absolutly nothing to worry about. However, most namespace identifiers actually point to a real web page that either provides an explanation or at least informations about the organization/author that created the namespace. This means that if you plan to create your own namespaces, you should use the name of any webpage over which you have control.
- Make a namespace declaration within the element that belongs to this namespace, i.e. map a prefix of your choice to a unique URI.
There are two major variants to declare namespaces
(1) declaring a namespace that will require insertion of prefixes
prefix:element xmlns:prefix="URI"
e.g.
html:html xmlns:html=<nowiki>’http://www.w3.org/1999/xhtml’>
(2) declaring a default namespace for an element plus its children (by default they belong to namespace of the parent). See also below.
element xmlns="URI"
e.g.
html xmlns=<nowiki>’http://www.w3.org/1999/xhtml’> .....
Scoping
"Scoping" means "where does a declaration apply ?
The scope of an XML namespace declaration extends from the beginning of the start-tag in which it appears to the end of the corresponding end-tag, including all children. Most frequently, namespaces are declared in the document root.
- XHMTL fragment example
?xml version="1.0"? html:html xmlns:html=<nowiki>’http://www.w3.org/1999/xhtml’> html:headhtml:titleFrobnostication/html:title/html:head html:bodyhtml:pMoved to html:a href=<nowiki>’http://frob.example.com’>here./html:a/html:p /html:body /html:html
- Example with 2 namespaces (both use URNs instead of URLs)
?xml version="1.0"? !-- both namespace prefixes are available throughout -- bk:book xmlns:bk=<nowiki>’urn:loc.gov:books’ xmlns:isbn=’urn:ISBN:0-395-36341-6’> bk:titleCheaper by the Dozen/bk:title isbn:number1568491379/isbn:number /bk:book
Default namespaces
If most elements in an XML document belonged to the same namespace, it would be ugly to prefix each element name. Instead, define a default namespace that applies to all non-prefixed elements and attributes.
element xmlns="URI" ....
The default namespace applies to the element in which it was defined and all descendants of that element. But if a descendants has another default namespace defined on it, this new namespace definition overrides the previous one and becomes the default for that element and its descendants. Note that namespaces does not apply to attribute names ! This is a likely source of trouble for XSLT ...
- XHTML default namespace example
?xml version="1.0"? !-- elements are in the HTML namespace by default -- html xmlns=<nowiki>’http://www.w3.org/1999/xhtml’> headtitleFrobnostication/title/head bodypMoved to a href=<nowiki>’http://frob.example.com’>here/a./p/body /html
Default namespace for a book vocabulary plus a namespace for ISBN example:
?xml version="1.0"? !-- unprefixed element types are from "books" -- book xmlns=<nowiki>’urn:loc.gov:books’ xmlns:isbn=’urn:ISBN:0-395-36341-6’> titleCheaper by the Dozen/title isbn:number1568491379/isbn:number /book
- A larger example of namespace scoping
It includes some XHTML whose namespace is declared within the "p" element.
?xml version="1.0"? !-- initially, the default namespace is "books" -- book xmlns=<nowiki>’urn:loc.gov:books’ xmlns:isbn=’urn:ISBN:0-395-36341-6’> titleCheaper by the Dozen/title isbn:number1568491379/isbn:number notes !-- make HTML the default namespace for some commentary -- p xmlns=<nowiki>’http://www.w3.org/1999/xhtml’> This is a ifunny/i book! /p /notes /book
- XSLT namespace example
- XSLT instructions are prefixed with "xsl" here
- Output is namespace-less here ...)
?xml version="1.0"? xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xsl:template match="page" ..... html head title xsl:value-of select="title"/ /title/head body bgcolor="<nowiki> ffffff"</nowiki> xsl:apply-templates/ /body /html /xsl:template xsl:template match="title" h1 align="center" xsl:apply-templates/ /h1 /xsl:template
xsl:template match="content" p align="center" xsl:apply-templates/ /p /xsl:template
xsl:template match="comment" hr / xsl:apply-templates/ /xsl:template /xsl:stylesheet
Validation of composite documents
- Validating documents that contain different namespaces are called composite or compound documents and validation is not always easy since combined DTDs may not exist
- A validation standard for composite W3C vocabularies is currently under preparation ...
- Usually, combined documents are produced by server-side programs for delivery and they are just well-formed (not attached to DTDs or other schemas)
- You may write DTDs that validate compound documents.
- A DTD rule with an extra namespace example
- In this example, the "a" element and the "description" attribute belongs to the default namespace, but the href and type attributes belong to the xlink namespace
- We declare the namespace in the root element, but also could have done it just for the "el" element...
!ELEMENT link_list (el<nowiki>+)</nowiki> !ATTLIST link_list xmlns:xlink CDATA <nowiki> FIXED "http://www.w3.org/1999/xlink"</nowiki> !ELEMENT el (<nowiki> PCDATA)</nowiki> !ATTLIST el description CDATA <nowiki> IMPLIED xlink:href CDATA REQUIRED xlink:type CDATA FIXED "simple"</nowiki>
- An XML Example file
?xml version="1.0" encoding="ISO-8859-1" ? !DOCTYPE link_list SYSTEM "link_list.dtd" ?xml-stylesheet href="link_list.css" type="text/css" ? link_list xmlns:xlink="http://www.w3.org/1999/xlink" el description="verified" xlink:type="simple" xlink:href="http://tecfa.unige.ch/"TECFA/el el xlink:href="http://tecfa.unige.ch/" xlink:type="simple"TECFA/el /link_list
Client-side XML languages and namespaces overview
The W3C defines several Internet languages and for which namespace declarations are mandatory (even if you use them "standalone", i.e. not in composite documents.
- Some W3C languages
Name | Namespace URL | Explanation |
XSLT | http://www.w3.org/1999/XSL/Transform | XSL - Transformations |
XSL-FO | http://www.w3.org/1999/XSL/Format | XSL - Formatting |
XML Schema | http://www.w3.org/2001/XMLSchema | |
SVG | http://www.w3.org/2000/svg | Scalable Vector Graphics |
RDF | http://www.w3.org/1999/02/22-rdf-syntax-ns | Resource Description Format |
SMIL 2.0 | http://www.w3.org/2001/SMIL20/ | Synchronized Multimedia Integration Lang. |
VoiceXML 2.0 | http://www.w3.org/2001/vxml | Synthesized voice |
XLink | xmlns:xlink="http://www.w3.org/1999/xlink" | XML Linking Language |
XForms | http://www.w3.org/2002/xforms | Next generation of HTML forms. |
XHTML | http://www.w3.org/1999/xhtml | |
MathML | http://www.w3.org/1998/Math/MathML | Mathematical markup language |
Some of these languages (e.g. SMIL, MathML, SVG, X3D) need special clients for display. Others are transducers or helpers, i.e. are used to define, style, transform and process XML contents
- RDF namespace
RDF-based languages are very prolific and add to the complexity of semantic web initiatives
See 100 most common RDF namespaces
Compound documents
Combining various content delivery formats is the future (also on cell phones). For example, XHTML-formatted content can be augmented by SVG objects or mathematical formula.
- Examples of possible Compound Document profiles
- XHTML + SVG + MathML
- XHTML + SMIL
- XHTML + XForms
- XHTML + VoiceML
The W3C is working on a generic Compound Document by Reference Framework (CDRF) that defines a language-independent processing model for combining arbitrary document formats ...
- Web browser caveats
- IE doesn't support natively most of these languages, Firefox supports more but not all.
Workarounds:
- Use a browser that is more advanced (e.g. Firefox) or specialized players (e.g. Realplayer for SMIL)
- Install plugins for your web browser and use a more indirect method to assemble contents, i.e. object or iframe This will work with most browsers if you have the right plugin (SVG in this case) installed.
iframe src="hello-svg.svg" height="300" width="80%" frameborder="0"
... Sorry you need an SVG plugin ...
/iframe
XHTML + other vocabularies
- XHTML / MathML example
See the MathML article. It contains some mixed XHTML/MathML code.
- Xlink example
XLink was supposed to replace all linking constructs in the W3C languages. It is adopted by SVG, X3D, but not by XHTML 2 which introduces its own linking constructs. XML-capable browsers are also supposed to implement this (Firefox, but not IE)
- Example - Story grammar that implements XLink for an A element
?xml version="1.0" encoding="ISO-8859-1" ? STORY xmlns:xlink="http://www.w3.org/1999/xlink" TitleThe Webmaster/Title ..... INFOS Date30 octobre 2003/Date AuthorDKS -/Author A xlink:href=http://jigsaw.w3.org/css-validator/check/referer xlink:type="simple"CSS Validator/A /INFOS /STORY
- SVG example
XHTML with embedded SVG tags (tested with Firefox)
?xml version="1.0" encoding="ISO-8859-1" ? !DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" html xmlns="http://www.w3.org/1999/xhtml" xmlns:svg="http://www.w3.org/2000/svg" head titleSVG within XHTML Demo/title /head body .... The SVG part starts below hr / svg xmlns="http://www.w3.org/2000/svg" version="1.1" width="400" height="300" !-- a small rectangle -- rect x="50" y="50" rx="5" ry="5" width="300" height="100" style="fill:<nowiki> CCCCFF;stroke:#000099"/</nowiki> !-- a text in the same place -- text x="55" y="90" style="stroke:#000099;fill:#000099;font-size:24;"HELLO dear reader /text /svg hr / The SVG part ended above /body /html
Combining XHTML with your XML
It sometimes can be practical to combine your own XML contents with XHTML, because HTML offers easy-to-use functionality like image inclusions or links. Note however that in practice this feature is not often used since:
- XSLT stylesheets allow transformations of XML data into XHTML (i.e. the stylesheet will contain the extra HTML and the result displayed usually will be all HTML and easier to manage with CSS)
- the way browsers implement this is not really stable
- XHTML with some XML included and CSS example
- Tested with Firefox 2.x (works) and IE 7 (CSS doesn’t work, I don’t know why ...)
Procedure:
- Define a namespace for the included XML content
- Attach a CSS stylesheet with an XML processor instruction
- Your file must be understood as "XML", e.g. call it something.xml or something.xhtml but not something.html !
XHTML with some cooking XML included (file cooking.xhtml):
?xml version="1.0" encoding="iso-8859-1"? ?xml-stylesheet type="text/css" href="cooking.css"? html xmlns="http://www.w3.org/1999/xhtml" xmlns:re="http://tecfa.unige.ch/ns/cooking" head titleA Compound XHTML-XML Document/title !-- this should work with IE but doesn<nowiki>’t, maybe IE6 ? --</nowiki> link href="cooking.css" type="text/css" rel="stylesheet"/ /head body h1A Compound XHTML-XML Document/h1 pContains a cooking recipee written down by R. D. as an exercise. Everything below the line is XML styled with a CSS stylesheet/ p hr/ re:recipe re:recipe_head re:recipe_nameCold Salmon in Creamy Spiced Sauce/re:recipe_name re:recipe_authorH.W./re:recipe_author re:meal_typeFish and Shellfish/re:meal_type /re:recipe_head ..... /re:recipe /body /html
Combining your XML with XHTML
Works with Firefox 1x/2x and IE7 (probably also with IE6).
- An HTML namespace is declared in the root element and we use it twice (for the img and a tags).
- Btw this is a trick to get around non-implementation of the xlink standard in IE.
- XML plus XHTML (file xml_plus_xhtml.xml)
?xml version="1.0" ? ?xml-stylesheet href="xml_plus_xhtml.css" type="text/css"? page xmlns:html="http://www.w3.org/1999/xhtml" updated="jan 2007" titleHello friend/title list !-- we use an HTML tag below to include a picture -- html:img src="photo.jpg"/ item price="10" White plate /item item price="20" Gold plate /item item price="15" Silver plate /item /list comment Written by html:a href="...."DKS/Tecfa/html:a , feb 2007 /comment /page