You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
713 lines
30 KiB
713 lines
30 KiB
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
<html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta name="generator" content="HTML Tidy, see www.w3.org" />
|
|
<title>XHTML 2.0 - XHTML Metainformation Module</title>
|
|
<link rel="start" type="text/html" href="Overview.html" />
|
|
<link rel="contents" type="text/html" href="Overview.html#toc" />
|
|
<link rel="prev" type="text/html" href="mod-mediaAttribute.html" />
|
|
<link rel="next" type="text/html" href="mod-metaAttributes.html" />
|
|
<link rel="stylesheet" type="text/css" href="xhtml.css" />
|
|
<link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-WD.css" />
|
|
</head>
|
|
<body>
|
|
<div class="navbar">[<a accesskey="P" href="mod-mediaAttribute.html">previous</a>]   [<a accesskey="N" href="mod-metaAttributes.html">next</a>]  [<a accesskey="T" href=
|
|
"Overview.html#toc">table of contents</a>]  [<a accesskey="E" href="elements.html">elements</a>]  [<a accesskey="A" href="attributes.html">attributes</a>]
|
|
|
|
<hr />
|
|
</div>
|
|
|
|
<h1><a id="s_metamodule" name="s_metamodule">23.</a> XHTML Metainformation Module</h1>
|
|
|
|
<div class='subtoc'>
|
|
<p><strong>Contents</strong></p>
|
|
|
|
<ul class='toc'>
|
|
<li class='tocline'>23.1. <a href="#sec_23.1." class="tocxref">The link element</a>
|
|
|
|
<ul class="toc">
|
|
<li class='tocline'>23.1.1. <a href="#sec_23.1.1." class="tocxref">Forward and reverse links</a></li>
|
|
|
|
<li class='tocline'>23.1.2. <a href="#sec_23.1.2." class="tocxref">Links and search engines</a></li>
|
|
</ul>
|
|
</li>
|
|
|
|
<li class='tocline'>23.2. <a href="#sec_23.2." class="tocxref">The meta element</a>
|
|
|
|
<ul class="toc">
|
|
<li class='tocline'>23.2.1. <a href="#sec_23.2.1." class="tocxref">meta and search engines</a></li>
|
|
</ul>
|
|
</li>
|
|
|
|
<li class='tocline'>23.3. <a href="#sec_23.3." class="tocxref">Literals and Resources</a></li>
|
|
|
|
<li class='tocline'>23.4. <a href="#sec_23.4." class="tocxref">Document Properties</a>
|
|
|
|
<ul class="toc">
|
|
<li class='tocline'>23.4.1. <a href="#sec_23.4.1." class="tocxref">Literals</a></li>
|
|
|
|
<li class='tocline'>23.4.2. <a href="#sec_23.4.2." class="tocxref">Resources</a></li>
|
|
|
|
<li class='tocline'>23.4.3. <a href="#sec_23.4.3." class="tocxref">Making Use of External Lists of Properties</a></li>
|
|
</ul>
|
|
</li>
|
|
|
|
<li class='tocline'>23.5. <a href="#sec_23.5." class="tocxref">Properties of Other Resources</a>
|
|
|
|
<ul class="toc">
|
|
<li class='tocline'>23.5.1. <a href="#sec_23.5.1." class="tocxref">Resources Within the Containing Document</a></li>
|
|
|
|
<li class='tocline'>23.5.2. <a href="#sec_23.5.2." class="tocxref">External Resources</a></li>
|
|
</ul>
|
|
</li>
|
|
|
|
<li class='tocline'>23.6. <a href="#sec_23.6." class="tocxref">Chaining Metadata</a></li>
|
|
|
|
<li class='tocline'>23.7. <a href="#sec_23.7." class="tocxref">Issues</a></li>
|
|
</ul>
|
|
</div>
|
|
|
|
<p>This section is <em>normative</em>.</p>
|
|
|
|
<p>The Metainformation Module defines elements that allow the definition of relationships. These may relate to:</p>
|
|
|
|
<ul>
|
|
<li>the document itself,</li>
|
|
|
|
<li>items external to the document, or</li>
|
|
|
|
<li>other items of metadata within the document.</li>
|
|
</ul>
|
|
|
|
<p>Note that this module is dependent upon the <a href="mod-metaAttributes.html#s_metaAttributesmodule">Metainformation Attributes</a> module. The attributes defined therein are available on the
|
|
elements defined in this module, and their semantics are the essential part of how these elements behave.</p>
|
|
|
|
<p>Elements and attributes in this module are:</p>
|
|
|
|
<table class="moduledef" border="1" summary="Elements and Attributes for Metainformation Module">
|
|
<thead>
|
|
<tr>
|
|
<th>Elements</th>
|
|
<th>Attributes</th>
|
|
<th>Content Model</th>
|
|
</tr>
|
|
</thead>
|
|
|
|
<tbody>
|
|
<tr>
|
|
<td>link</td>
|
|
<td><a class="csref" href="mod-attribute-collections.html#col_Common">Common</a></td>
|
|
<td class="content">( link | meta )*</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>meta</td>
|
|
<td><a class="csref" href="mod-attribute-collections.html#col_Common">Common</a></td>
|
|
<td class="content">( PCDATA | <a class="csref" href="mod-text.html#cs_Text">Text</a> )*</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<p>Implementation: <a href="relax_module_defs.html#a_rmodule_Metainformation">RELAX NG</a></p>
|
|
|
|
<!-- INCLUDING ELEMENT modules/meta/link.mhtml -->
|
|
<h2><a id="sec_23.1." name="sec_23.1.">23.1.</a> The <a class="edef" id="edef_meta_link">link</a> element</h2>
|
|
|
|
<div class="aref-list">
|
|
<p><em>Attributes</em></p>
|
|
|
|
<!-- INCLUDING ATTRIBUTE modules/attributes/Common.mhtml -->
|
|
<dl class='attrDef'>
|
|
<dt>The <a class="csref" href="mod-attribute-collections.html#col_Common">Common</a> collection</dt>
|
|
|
|
<dd>A collection of other attribute collections, including: <a class="csref" href="mod-bidi.html#col_Bi-directional">Bi-directional</a>, <a class="csref" href="mod-core.html#col_Core">Core</a>, <a
|
|
class="csref" href="mod-edit.html#col_Edit">Edit</a>, <a class="csref" href="mod-embedding.html#col_Embedding">Embedding</a>, <a class="csref" href="mod-xml-events.html#col_Events">Events</a>, <a
|
|
class="csref" href="mod-xforms.html#col_Forms">Forms</a>, <a class="csref" href="mod-hyperAttributes.html#col_Hypertext">Hypertext</a>, <a class="csref" href="mod-i18n.html#col_I18N">I18N</a>, <a
|
|
class="csref" href="mod-csImgMap.html#col_Map">Map</a>, and <a class="csref" href="mod-metaAttributes.html#col_Metainformation">Metainformation</a>.</dd>
|
|
</dl>
|
|
|
|
<!-- END OF ATTRIBUTE FILE modules/attributes/Common.mhtml --></div>
|
|
|
|
<p>This element defines a link. <a class="eref" href="mod-meta.html#edef_meta_link">Link</a> conveys relationship information that may be rendered by user agents in a variety of ways (e.g., a
|
|
tool-bar with a drop-down menu of links). <span class="should">User agents should enable activation of links and the retrieval of link targets. Since <a class="eref" href=
|
|
"mod-meta.html#edef_meta_link">link</a> elements may have no content, information from the <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_rel">rel</a> and <a class="aref" href=
|
|
"mod-core.html#adef_core_title">title</a> attributes should be used when labelling links.</span></p>
|
|
|
|
<div class="example">
|
|
<p>This example illustrates how several <a class="eref" href="mod-meta.html#edef_meta_link">link</a> definitions may appear in the <a class="eref" href="mod-document.html#edef_document_head">head</a>
|
|
section of a document. The current document is "Chapter2.html". The <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_rel">rel</a> attribute specifies the relationship of the linked
|
|
document with the current document. The values "Index", "Next", and "Prev" are explained in the section on the attribute <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_rel">
|
|
rel</a>.</p>
|
|
|
|
<pre class="example">
|
|
<head>
|
|
<title>Chapter 2</title>
|
|
<link rel="index" href="../index.html"/>
|
|
<link rel="next" href="Chapter3.html"/>
|
|
<link rel="prev" href="Chapter1.html"/>
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<h3><a id="sec_23.1.1." name="sec_23.1.1.">23.1.1.</a> Forward and reverse links</h3>
|
|
|
|
<p>While the <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_rel">rel</a> attribute specifies a relationship <em>from</em> this document <em>to</em> another resource, the <a class=
|
|
"aref" href="mod-metaAttributes.html#adef_metaAttributes_rev">rev</a> attribute specifies the reverse relationship.</p>
|
|
|
|
<p>Consider two documents A and B.</p>
|
|
|
|
<pre>
|
|
Document A: <link href="docB" rel="index"/>
|
|
</pre>
|
|
|
|
<p>Has exactly the same meaning as:</p>
|
|
|
|
<pre>
|
|
Document B: <link href="docA" rev="index"/>
|
|
</pre>
|
|
|
|
<p>namely that document B is the index for document A.</p>
|
|
|
|
<p>Both the <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_rel">rel</a> and <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_rev">rev</a> attributes may be
|
|
specified simultaneously.</p>
|
|
|
|
<h3><a id="sec_23.1.2." name="sec_23.1.2.">23.1.2.</a> Links and search engines</h3>
|
|
|
|
<p>Authors may use the <a class="eref" href="mod-meta.html#edef_meta_link">link</a> element to provide a variety of information to search engines, including:</p>
|
|
|
|
<ul>
|
|
<li>Links to alternate versions of a document, written in another human language.</li>
|
|
|
|
<li>Links to alternate versions of a document, designed for different media, for instance a version especially suited for printing.</li>
|
|
|
|
<li>Links to the starting page of a collection of documents.</li>
|
|
</ul>
|
|
|
|
<p>The examples below illustrate how language information, media types, and link types may be combined to improve document handling by search engines.</p>
|
|
|
|
<div class="example">
|
|
<p>The following example shows how to use the <a class="aref" href="mod-hyperAttributes.html#adef_hyperAttributes_hreflang">hreflang</a> attribute to indicate to a search engine where to find other
|
|
language versions of a document. Note that for the sake of the example the <a class="aref" href="mod-i18n.html#adef_i18n_xml:lang">xml:lang</a> attribute has been used to indicate that the value of
|
|
the <a class="aref" href="mod-core.html#adef_core_title">title</a> attribute for the <a class="eref" href="mod-meta.html#edef_meta_link">link</a> element designating the French manual is in
|
|
French.</p>
|
|
|
|
<pre class="example">
|
|
<html ... xml:lang="en">
|
|
<head>
|
|
<title>The manual in English</title>
|
|
<link title="The manual in Dutch"
|
|
rel="alternate"
|
|
hreflang="nl"
|
|
href="http://example.com/manual/dutch.html"/>
|
|
<link title="La documentation en Français"
|
|
rel="alternate"
|
|
hreflang="fr" xml:lang="fr"
|
|
href="http://example.com/manual/french.html"/>
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<div class="example">
|
|
<p>In the following example, we tell search engines where to find the printed version of a manual.</p>
|
|
|
|
<pre class="example">
|
|
<head>
|
|
<title>Reference manual</title>
|
|
<link media="print"
|
|
title="The manual in PostScript"
|
|
hreftype="application/postscript"
|
|
rel="alternate"
|
|
href="http://example.com/manual/postscript.ps"/>
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<div class="example">
|
|
<p>In the following example, we tell search engines where to find the front page of a collection of documents.</p>
|
|
|
|
<pre class="example">
|
|
<head>
|
|
<title>Reference manual -- Chapter 5</title>
|
|
<link rel="start" title="The first chapter of the manual"
|
|
hreftype="application/xhtml+xml"
|
|
href="http://example.com/manual/start.html"/>
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<!-- END OF ELEMENT FILE modules/meta/link.mhtml --><!-- INCLUDING ELEMENT modules/meta/meta.mhtml -->
|
|
<h2><a id="sec_23.2." name="sec_23.2.">23.2.</a> The <a class="edef" id="edef_meta_meta">meta</a> element</h2>
|
|
|
|
<div class="adef-list">
|
|
<p><em>Attributes</em></p>
|
|
|
|
<!-- INCLUDING ATTRIBUTE modules/attributes/Common.mhtml -->
|
|
<dl class='attrRef'>
|
|
<dt>The <a class="csref" href="mod-attribute-collections.html#col_Common">Common</a> collection</dt>
|
|
|
|
<dd>A collection of other attribute collections, including: <a class="csref" href="mod-bidi.html#col_Bi-directional">Bi-directional</a>, <a class="csref" href="mod-core.html#col_Core">Core</a>, <a
|
|
class="csref" href="mod-edit.html#col_Edit">Edit</a>, <a class="csref" href="mod-embedding.html#col_Embedding">Embedding</a>, <a class="csref" href="mod-xml-events.html#col_Events">Events</a>, <a
|
|
class="csref" href="mod-xforms.html#col_Forms">Forms</a>, <a class="csref" href="mod-hyperAttributes.html#col_Hypertext">Hypertext</a>, <a class="csref" href="mod-i18n.html#col_I18N">I18N</a>, <a
|
|
class="csref" href="mod-csImgMap.html#col_Map">Map</a>, and <a class="csref" href="mod-metaAttributes.html#col_Metainformation">Metainformation</a>.</dd>
|
|
</dl>
|
|
|
|
<!-- END OF ATTRIBUTE FILE modules/attributes/Common.mhtml --></div>
|
|
|
|
<p>The <a class="eref" href="mod-meta.html#edef_meta_meta">meta</a> element can be used to identify properties of a document (e.g., author, expiration date, a list of key words, etc.) and assign
|
|
values to those properties. This specification defines a small normative set of properties, but users may extend this set as described for the <a class="aref" href=
|
|
"mod-metaAttributes.html#adef_metaAttributes_property">property</a> attribute.</p>
|
|
|
|
<p>Each <a class="eref" href="mod-meta.html#edef_meta_meta">meta</a> element specifies a property/value pair. The <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_property">
|
|
property</a> attribute identifies the property and the content of the element or the value of the <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_content">content</a> attribute
|
|
specifies the property's value.</p>
|
|
|
|
<p>For example, the following declaration sets a value for the <code>Author</code> property:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<meta property="dc:creator">Steven Pemberton</meta>
|
|
</pre>
|
|
</div>
|
|
|
|
<div class="note">
|
|
<p><em><strong>Note.</strong> The <a class="eref" href="mod-meta.html#edef_meta_meta">meta</a> element is a generic mechanism for specifying metadata. However, some XHTML elements and attributes
|
|
already handle certain pieces of metadata and may be used by authors instead of <a class="eref" href="mod-meta.html#edef_meta_meta">meta</a> to specify those pieces: the <a class="eref" href=
|
|
"mod-document.html#edef_document_title">title</a> element, the <a class="eref" href="mod-structural.html#edef_structural_address">address</a> element, the <a class="aref" href=
|
|
"mod-edit.html#adef_edit_edit">edit</a> and related attributes, the <a class="aref" href="mod-core.html#adef_core_title">title</a> attribute, and the <a class="aref" href=
|
|
"mod-hyperAttributes.html#adef_hyperAttributes_cite">cite</a> attribute.</em></p>
|
|
</div>
|
|
|
|
<div class="note">
|
|
<p><em><strong>Note.</strong> When a property specified by a <a class="eref" href="mod-meta.html#edef_meta_meta">meta</a> element takes a value that is a <span class="datatype"><a href=
|
|
"abstraction.html#dt_URI">URI</a></span>, some authors <span class="index-inst" title="metadata::LINK vs meta"><a name="idx-meta_data-2">prefer</a></span> to specify the metadata via the <a class=
|
|
"eref" href="mod-meta.html#edef_meta_link">link</a> element. Thus, the following metadata declaration:</em></p>
|
|
</div>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<meta property="dc:identifier">
|
|
http://www.rfc-editor.org/rfc/rfc3236.txt
|
|
</meta>
|
|
</pre>
|
|
</div>
|
|
|
|
<p><em>might also be written:</em></p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<link rel="dc:identifier"
|
|
href="http://www.rfc-editor.org/rfc/rfc3236.txt" />
|
|
</pre>
|
|
</div>
|
|
|
|
<h3><a id="sec_23.2.1." name="sec_23.2.1.">23.2.1.</a> meta and search engines</h3>
|
|
|
|
<p>A common use for <a class="eref" href="mod-meta.html#edef_meta_meta">meta</a> is to specify keywords that a <span class="index-inst" title="search engine::helping"><a name="idx-search_engine">
|
|
search engine</a></span> may use to improve the quality of search results. When several <a class="eref" href="mod-meta.html#edef_meta_meta">meta</a> elements provide language-dependent information
|
|
about a document, search engines may filter on the <a class="aref" href="mod-i18n.html#adef_i18n_xml:lang">xml:lang</a> attribute to display search results using the language preferences of the user.
|
|
For example,</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre class="example">
|
|
<!-- For speakers of US English -->
|
|
<meta property="keywords"
|
|
xml:lang="en-us">vacation, Greece, sunshine</meta>
|
|
<!-- For speakers of British English -->
|
|
<meta property="keywords"
|
|
xml:lang="en">holiday, Greece, sunshine</meta>
|
|
<!-- For speakers of French -->
|
|
<meta property="keywords"
|
|
xml:lang="fr">vacances, Grèce, soleil</meta>
|
|
</pre>
|
|
</div>
|
|
|
|
<p>The effectiveness of search engines can also be increased by using the <a class="eref" href="mod-meta.html#edef_meta_link">link</a> element to specify links to translations of the document in
|
|
other languages, links to versions of the document in other media (e.g., PDF), and, when the document is part of a collection, links to an appropriate starting point for browsing the collection.</p>
|
|
|
|
<!-- END OF ELEMENT FILE modules/meta/meta.mhtml -->
|
|
<h2><a id="sec_23.3." name="sec_23.3.">23.3.</a> Literals and Resources</h2>
|
|
|
|
<p>There are two types of properties that some item can have. The first is a simple string value, which is useful for specifying properties such as dates, names, numbers and so on:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
this document was written on "March 21st, 2004"
|
|
</pre>
|
|
</div>
|
|
|
|
<p>This is not so useful though when trying to uniquely identify items that could occur in other places. Take the example of the document's author being "Mark Birbeck":</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
this document was written by "Mark Birbeck"
|
|
</pre>
|
|
</div>
|
|
|
|
<p>Since there are other people called Mark Birbeck, then we won't know which of them wrote what. We get round this problem by allowing the value referred to, to be a URI. For example:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
this document was written by
|
|
<http://example.com/people/MarkBirbeck/654>
|
|
</pre>
|
|
</div>
|
|
|
|
<p>We distinguish these two types of properties by calling the first a 'string literal' and the second a 'resource'.</p>
|
|
|
|
<p>NOTE: Of course there is nothing to stop two people from using this URI to identify two completely different people. But in general URIs are accepted as a convenient way to identify a specific
|
|
item.</p>
|
|
|
|
<h2><a id="sec_23.4." name="sec_23.4.">23.4.</a> Document Properties</h2>
|
|
|
|
<h3><a id="sec_23.4.1." name="sec_23.4.1.">23.4.1.</a> Literals</h3>
|
|
|
|
<h4><a id="sec_23.4.1.1." name="sec_23.4.1.1.">23.4.1.1.</a> String Literals</h4>
|
|
|
|
<p>The simplest piece of metadata is a string literal attached to the containing document. This can be specified using <a class="eref" href="mod-meta.html#edef_meta_meta">meta</a>. For example:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<head>
|
|
<meta property="dc:creator">Mark Birbeck</meta>
|
|
<meta property="dc:created" content="2004-03-20" />
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<p>which states that:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
this document has an 'author' property of "Mark Birbeck";
|
|
this document has a 'created' property of "2004-03-20".
|
|
</pre>
|
|
</div>
|
|
|
|
<h4><a id="sec_23.4.1.2." name="sec_23.4.1.2.">23.4.1.2.</a> XML Literals</h4>
|
|
|
|
<p>It is also possible to include mark-up in the string. This will always be part of the string's value - in other words, no matter what the mark-up is, it will never be processed as if it were
|
|
anything other than the value of the property:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<head>
|
|
<meta property="dc:creator" content="Albert Einstein" />
|
|
<meta property="dc:title">E = mc<sup>2</sup>: The Most Urgent Problem
|
|
of Our Time</meta>
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<p>states that:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
this document has an 'author' property of "Albert Einstein";
|
|
this document has a 'title' property of
|
|
"E = mc<sup>2</sup>: The Most Urgent Problem of Our Time".
|
|
</pre>
|
|
</div>
|
|
|
|
<p>However, just because the mark-up is not processed as mark-up does not mean it need not be well-formed and valid if the processor requires it.</p>
|
|
|
|
<h4><a id="sec_23.4.1.3." name="sec_23.4.1.3.">23.4.1.3.</a> Typed Literals</h4>
|
|
|
|
<p>In some situations the value of a property is not sufficiently specified by a simple literal. For example, properties such as height or weight would require more than a string to fully specify
|
|
them:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<head>
|
|
<meta property="height">87</meta>
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<p>In cases such as this it is not clear whether we are dealing with metres, miles or microns. Whilst it's certainly possible to add the units to the literal itself there will be situations where
|
|
this is not possible, and so the unit should be specified with <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_datatype">datatype</a> In this example we use the XML Schema type for
|
|
date:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<head>
|
|
<meta property="created" datatype="xsd:date">2004-03-22</meta>
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<h3><a id="sec_23.4.2." name="sec_23.4.2.">23.4.2.</a> Resources</h3>
|
|
|
|
<p>There will be situations when a string literal is not suitable as the value of a property. In the example just given there would be no way to know which 'Mark Birbeck' we are referring to. This
|
|
might not be a problem when documents are only used within one company, but this becomes a big problem when documents are used across the internet.</p>
|
|
|
|
<p>When we need to provide a unique identifier for the value of a property we use <a class="eref" href="mod-meta.html#edef_meta_link">link</a>. <a class="eref" href="mod-meta.html#edef_meta_link">
|
|
link</a> identifies a <em>relationship</em> between one resource and another, and uses <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_rel">rel</a> to indicate the nature of this
|
|
relationship. In addition <a class="aref" href="mod-hyperAttributes.html#adef_hyperAttributes_href">href</a> contains the URI that is being used to uniquely identify the item being related to. For
|
|
example:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<head>
|
|
<link rel="author"
|
|
href="http://example.com/people/MarkBirbeck/654" />
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<p>Note that just because we are using URIs as unique identifiers doesn't mean that navigating to this URI with a web browser would yield anything useful. This is perhaps easier to see with the
|
|
following example:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<head>
|
|
<link rel="source" href="urn:isbn:0140449132" />
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<h3><a id="sec_23.4.3." name="sec_23.4.3.">23.4.3.</a> Making Use of External Lists of Properties</h3>
|
|
|
|
<p>Best practice for specifying metadata is to try as much as possible to make use of common property names. This can often be achieved by using lists in use by other document authors within a
|
|
similar field. There are many such lists for different sectors and industries, but for our examples here we will use Dublin Core[<a class="nref" href="references.html#ref_DCORE">DCORE</a>].</p>
|
|
|
|
<p>To replace the term 'author' with the more widely used Dublin Core term 'creator', we would need to not only substitute 'creator' for 'author', but also to indicate which list we are using. We
|
|
achieve the latter by using XML namespaces:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<head xmlns:dc="http://purl.org/dc/elements/1.1/">
|
|
<meta property="dc:creator">Mark Birbeck</meta>
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<p>Now we have stated that:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
this document has a property called 'creator' (which comes
|
|
from a library of properties called the Dublin Core) and the
|
|
value of that property is the literal "Mark Birbeck".
|
|
</pre>
|
|
</div>
|
|
|
|
<h2><a id="sec_23.5." name="sec_23.5.">23.5.</a> Properties of Other Resources</h2>
|
|
|
|
<p>While it is common to create properties and values that say something about the document that contains them, there is often a need to add metadata that refers only to a section of the document, or
|
|
to some external resource. This is achieved by using <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_about">about</a>, which can be present on <a class="eref" href=
|
|
"mod-meta.html#edef_meta_meta">meta</a> and <a class="eref" href="mod-meta.html#edef_meta_link">link</a>.</p>
|
|
|
|
<h3><a id="sec_23.5.1." name="sec_23.5.1.">23.5.1.</a> Resources Within the Containing Document</h3>
|
|
|
|
<p>A quote might be attributed as follows:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<html xmlns:dc="http://purl.org/dc/elements/1.1/">
|
|
<head>
|
|
<link about="#q1" rel="dc:source" href="urn:isbn:0140449132" />
|
|
</head>
|
|
<body>
|
|
<blockquote id="q1">
|
|
<p>
|
|
'Rodion Romanovitch! My dear friend! If you go on in this way
|
|
you will go mad, I am positive! Drink, pray, if only a few drops!'
|
|
</p>
|
|
</blockquote>
|
|
</body>
|
|
</html>
|
|
</pre>
|
|
</div>
|
|
|
|
<p>Note that the absence of <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_about">about</a> does not always mean that the metadata refers to the containing document. If the element
|
|
containing metadata is a child of <a class="eref" href="mod-document.html#edef_document_head">head</a>, then it does relate to the document, and so the following mark-up:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<head xmlns:dc="http://purl.org/dc/elements/1.1/">
|
|
<meta property="dc:creator">Mark Birbeck</meta>
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<p>can be regarded as a shorthand for this:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<head xmlns:dc="http://purl.org/dc/elements/1.1/">
|
|
<meta about="" property="dc:creator">Mark Birbeck</meta>
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<h3><a id="sec_23.5.2." name="sec_23.5.2.">23.5.2.</a> External Resources</h3>
|
|
|
|
<p>There is also a need to add metadata to a document that concerns an item that is external to the document. As before we use <a class="aref" href=
|
|
"mod-metaAttributes.html#adef_metaAttributes_about">about</a>, but this time we should provide an absolute or relative URI, rather than just a fragment identifier.</p>
|
|
|
|
<p>An example might be to say that the copyright of some document is owned by a company, and further, that the company is located in London:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<head xmlns:dc="http://purl.org/dc/elements/1.1/">
|
|
<link rel="dc:copyright"
|
|
href="http://example.com/company/BBC/6" />
|
|
<meta about="http://example.com/company/BBC/6"
|
|
property="dc:location">London</meta>
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<h2><a id="sec_23.6." name="sec_23.6.">23.6.</a> Chaining Metadata</h2>
|
|
|
|
<p>Metadata that is relevant to a resource referred to by a <a class="eref" href="mod-meta.html#edef_meta_link">link</a> can be placed inside the <a class="eref" href="mod-meta.html#edef_meta_link">
|
|
link</a> element with no <a class="aref" href="mod-metaAttributes.html#adef_metaAttributes_about">about</a>. Our previous example could be re-written as follows:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<head xmlns:dc="http://purl.org/dc/elements/1.1/">
|
|
<link rel="dc:copyright"
|
|
href="http://example.com/company/BBC/6">
|
|
<meta property="dc:location">London</meta>
|
|
</link>
|
|
</head>
|
|
</pre>
|
|
</div>
|
|
|
|
<p>There is no limit to the depth of this nesting.</p>
|
|
|
|
<div class="issue">
|
|
<p id="s_metamodule_issue_0" class="issueTitle">What attribute is this?</p>
|
|
|
|
There is no resource attribute any longer. What was it changed to in this context?</div>
|
|
|
|
<p>If resource is omitted from a <a class="eref" href="mod-meta.html#edef_meta_link">link</a> then the nested metadata is still legitimate, it simply relates to an anonymous resource. For example, we
|
|
might want to say that the 'mother tongue' of the author of <em>Crime and Punishment</em> is Russian, without saying anything further about the author:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<html xmlns:dc="http://purl.org/dc/elements/1.1/"
|
|
xmlns:con="http://example.org/terms/" >
|
|
<head />
|
|
<body>
|
|
<blockquote id="q1">
|
|
<link rel="dc:source" href="urn:isbn:0140449132">
|
|
<link rel="dc:creator">
|
|
<meta property="con:motherTongue">rus</meta>
|
|
</link>
|
|
</link>
|
|
<p>
|
|
'Rodion Romanovitch! My dear friend! If you go on in this way
|
|
you will go mad, I am positive! Drink, pray, if only a few drops!'
|
|
</p>
|
|
</blockquote>
|
|
</body>
|
|
</html>
|
|
</pre>
|
|
</div>
|
|
|
|
<p>When reading this metadata, the anonymous resource can be thought of simply as <em>'something'</em>. This mark-up means:</p>
|
|
|
|
<ol>
|
|
<li>The quote has a source of <em>Crime and Punishment</em>.</li>
|
|
|
|
<li><em>Crime and Punishment</em> has a property of 'creator' (from the Dublin Core taxonomy), and the value of that property is <em>something</em>.</li>
|
|
|
|
<li>The <em>something</em> that is the author of <em>Crime and Punishment</em> has a property of 'mother tongue' (from the SWAP contacts taxonomy), and the value of that Property is "Russian".</li>
|
|
</ol>
|
|
|
|
<p>Note however that while placing further elements inside <a class="eref" href="mod-meta.html#edef_meta_meta">meta</a> is structurally valid, it does not mean the same thing as the example we have
|
|
just given, since the content of <a class="eref" href="mod-meta.html#edef_meta_meta">meta</a> is an XML literal. The following:</p>
|
|
|
|
<div class="example">
|
|
<p>Example</p>
|
|
|
|
<pre>
|
|
<blockquote id="q1">
|
|
<link about="#q1" rel="dc:source" href="urn:isbn:0140449132">
|
|
<meta property="dc:creator">
|
|
<meta property="con:motherTongue">rus</meta>
|
|
</meta>
|
|
</link>
|
|
<p>...</p>
|
|
</blockquote>
|
|
</pre>
|
|
</div>
|
|
|
|
<p>means that:</p>
|
|
|
|
<ol>
|
|
<li>the quote has a source of <em>Crime and Punishment</em>.</li>
|
|
|
|
<li><em>Crime and Punishment</em> has a property of 'creator' (from the Dublin Core taxonomy), and the value of that property is the XML literal "<meta
|
|
property="con:motherTongue">rus</meta>".</li>
|
|
</ol>
|
|
|
|
<!-- errors said Getting issues from Meta
|
|
-->
|
|
<h2><a id="sec_23.7." name="sec_23.7.">23.7.</a> Issues</h2>
|
|
|
|
<div class="issue">
|
|
<p id="s_metamodule_issue_1" class="issueTitle">rebuild link element: chapter, section / subsection <span class="pr">PR #7869</span><br />
|
|
State: Open<br />
|
|
Resolution: None<br />
|
|
User: None</p>
|
|
|
|
<p><b>Notes:</b><br />
|
|
</p>
|
|
</div>
|
|
|
|
<hr />
|
|
<div class="navbar">[<a href="mod-mediaAttribute.html">previous</a>]   [<a href="mod-metaAttributes.html">next</a>]   [<a href="Overview.html#toc">table of contents</a>]  [<a href=
|
|
"elements.html">elements</a>]  [<a href="attributes.html">attributes</a>]</div>
|
|
</body>
|
|
</html>
|
|
|