File: refentry.xml

package info (click to toggle)
docbook-defguide 2.0.17%2Bsvn7549-3
  • links: PTS, VCS
  • area: main
  • in suites: lenny, squeeze
  • size: 101,040 kB
  • ctags: 261
  • sloc: xml: 426,495; perl: 4,471; python: 815; sh: 193; makefile: 181
file content (105 lines) | stat: -rw-r--r-- 3,513 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
<refentry id="bibliocoverage.element" revision='4.2'>
<?dbhtml filename="bibliocoverage.html"?>
<refentryinfo>
<pubdate>$Date: 2002-06-11 12:52:43 +0200 (Tue, 11 Jun 2002) $</pubdate>
<releaseinfo>$Revision: 1625 $</releaseinfo>
</refentryinfo>

<refmeta>
<indexterm><primary>elements</primary>
<secondary>bibliocoverage</secondary></indexterm>
<refentrytitle>bibliocoverage</refentrytitle>
<refmiscinfo>Element</refmiscinfo>
</refmeta>

<refnamediv>
<refname>bibliocoverage</refname>
<refpurpose>&bibliocoverage.purpose;</refpurpose>
</refnamediv>

&bibliocoverage.synopsis.gen;

<refsect1 condition='ref.description'><title>Description</title>

<para>The <sgmltag>bibliocoverage</sgmltag> element satisfies coverage
element of the <ulink url="http://dublincore.org/">Dublin Core
Metadata Initiative</ulink>.</para>

<para>The Dublin Core defines coverage as <quote>the
extent or scope of the content of the resource.</quote> It goes on
to say:</para>

<blockquote>
<para>Coverage will typically include spatial location (a place name
or geographic coordinates), temporal period (a period label,
date, or date range) or jurisdiction (such as a named
administrative entity).
</para>
<para>Recommended best practice is to select a value from a
controlled vocabulary (for example, the
<ulink url="http://www.getty.edu/research/tools/vocabulary/tgn/">Thesaurus of Geographic
Names</ulink> [TGN]) and that, where appropriate, named places or time
periods be used in preference to numeric identifiers such as
sets of coordinates or date ranges.
</para>
</blockquote>

<para>DocBook 4.2 added <sgmltag>bibliocoverage</sgmltag>,
<sgmltag>bibliorelation</sgmltag>, and
<sgmltag>bibliosource</sgmltag> to make the DocBook meta-information wrappers
a complete superset of the Dublin Core.</para>

<refsect2><title>Processing expectations</title>
<para>
&format.inline; &format.csuppress;
</para>

<para>This element is used for both spatial and temporal coverage, but the intent
is that only one is specified at a time. In other words, on any given instance
of the <sgmltag>bibliocoverage</sgmltag> element, specify either
a <sgmltag class="attribute">spatial</sgmltag> or a 
<sgmltag class="attribute">temporal</sgmltag> encoding, but not both.</para>

</refsect2>

&bibliocoverage.parents.gen;
&bibliocoverage.children.gen;

</refsect1>

<refsect1 condition='ref.elem.attrdesc'><title>Attributes</title>
<variablelist>
<varlistentry><term>spatial</term>
<listitem>
<para>Identifies the encoding scheme for the supplied spatial identifier.
See the <ulink url="http://dublincore.org/documents/dcmes-qualifiers/">Dublin
Core Qualifiers</ulink> for details about the meaning of each encoding.
</para>
</listitem>
</varlistentry>
<varlistentry><term>otherspatial</term>
<listitem>
<para>Used to identify the encoding scheme when
<sgmltag class="attribute">spatial</sgmltag> is set to
<literal>otherspatial</literal>.</para>
</listitem>
</varlistentry>
<varlistentry><term>temporal</term>
<listitem>
<para>Identifies the encoding scheme for the supplied temporal identifier.
See the <ulink url="http://dublincore.org/documents/dcmes-qualifiers/">Dublin
Core Qualifiers</ulink> for details about the meaning of each encoding.
</para>
</listitem>
</varlistentry>
<varlistentry><term>othertemporal</term>
<listitem>
<para>Used to identify the encoding scheme when
<sgmltag class="attribute">temporal</sgmltag> is set to
<literal>othertemporal</literal>.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
</refentry>