resync 0.4.4 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.gitignore +50 -4
- data/.rubocop.yml +5 -0
- data/.ruby-version +1 -1
- data/CHANGES.md +10 -0
- data/Rakefile +4 -4
- data/lib/resync/capability_list.rb +3 -3
- data/lib/resync/link.rb +1 -1
- data/lib/resync/metadata.rb +1 -1
- data/lib/resync/resource.rb +1 -1
- data/lib/resync/shared/base_change_index.rb +1 -1
- data/lib/resync/shared/base_resource_list.rb +3 -3
- data/lib/resync/shared/descriptor.rb +3 -3
- data/lib/resync/shared/sorted_resource_list.rb +3 -6
- data/lib/resync/types/change.rb +1 -1
- data/lib/resync/types/change_frequency.rb +1 -1
- data/lib/resync/version.rb +1 -1
- data/lib/resync/xml.rb +1 -1
- data/lib/resync/xml_parser.rb +3 -3
- data/notes/resourcesync-1.0.9.html +3766 -0
- data/notes/resourcesync-1.0.html +3829 -0
- data/resync.gemspec +6 -5
- data/spec/.rubocop.yml +6 -0
- data/spec/acceptance/xml_parser_spec.rb +7 -7
- data/spec/rspec_custom_matchers.rb +3 -3
- data/spec/unit/resync/capability_list_spec.rb +1 -1
- data/spec/unit/resync/change_dump_manifest_spec.rb +2 -2
- data/spec/unit/resync/shared/augmented_examples.rb +1 -1
- data/spec/unit/resync/shared/base_resource_list_examples.rb +1 -1
- metadata +16 -15
|
@@ -0,0 +1,3766 @@
|
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
2
|
+
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
3
|
+
<head>
|
|
4
|
+
<title>ResourceSync Framework Specification</title>
|
|
5
|
+
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"/>
|
|
6
|
+
<link rel="shortcut icon" href="img/favicon.ico" type="image/x-icon"/>
|
|
7
|
+
<link rel="stylesheet" href="css/resourcesync.css" type="text/css"/>
|
|
8
|
+
</head>
|
|
9
|
+
|
|
10
|
+
<body>
|
|
11
|
+
<div id="header">
|
|
12
|
+
<table class="layout" summary="Logo and ResourceSync title">
|
|
13
|
+
<tbody><tr>
|
|
14
|
+
<td><img alt="NISO logo" src="img/niso_logo.png"/></td>
|
|
15
|
+
<td><img alt="OAI logo" src="img/OA100.gif" width="100" height="70"/></td>
|
|
16
|
+
<td class="OREtext">Open Archives Initiative<br/>ResourceSync Framework Specification</td>
|
|
17
|
+
<td><img alt="ResourceSync logo" src="img/resync_logo.jpg"/></td>
|
|
18
|
+
</tr>
|
|
19
|
+
</tbody>
|
|
20
|
+
</table>
|
|
21
|
+
</div>
|
|
22
|
+
<div id="titleBlock">
|
|
23
|
+
<h2 class="title">ResourceSync Framework Specification (NISO Z39.99-YYYY DRAFT)</h2>
|
|
24
|
+
<h3 class="subTitle">26 August 2016</h3>
|
|
25
|
+
</div><!--div-titleBlock-->
|
|
26
|
+
<dl>
|
|
27
|
+
<dt>This version:</dt>
|
|
28
|
+
<dd><a href="http://www.openarchives.org/rs/1.0.9/resourcesync">http://www.openarchives.org/rs/1.0.9/resourcesync</a></dd>
|
|
29
|
+
<dt>Latest version:</dt>
|
|
30
|
+
<dd><a href="http://www.openarchives.org/rs/resourcesync">http://www.openarchives.org/rs/resourcesync</a></dd>
|
|
31
|
+
<dt>Previous version:</dt>
|
|
32
|
+
<dd><a href="http://www.openarchives.org/rs/1.0/resourcesync">http://www.openarchives.org/rs/1.0/resourcesync</a></dd>
|
|
33
|
+
</dl>
|
|
34
|
+
|
|
35
|
+
<div class="abstract">
|
|
36
|
+
<h2><a name="abstract"></a>Abstract</h2>
|
|
37
|
+
<p>
|
|
38
|
+
This ResourceSync specification describes a synchronization framework for the web
|
|
39
|
+
consisting of various capabilities that allow third-party systems to remain synchronized
|
|
40
|
+
with a server's evolving resources. The capabilities may be combined in a modular manner
|
|
41
|
+
to meet local or community requirements. This specification also describes how a server
|
|
42
|
+
should advertise the synchronization capabilities it supports and how third-party systems
|
|
43
|
+
may discover this information. The specification repurposes the document formats defined
|
|
44
|
+
by the Sitemap protocol and introduces extensions for them.
|
|
45
|
+
</p>
|
|
46
|
+
</div>
|
|
47
|
+
|
|
48
|
+
<h2><a name="status"></a>Status of this Document</h2>
|
|
49
|
+
|
|
50
|
+
<p style="color:red">This document is an HTML version of a DRAFT REVISION of
|
|
51
|
+
<a href="http://www.niso.org/standards/z39-99-2014/">ANSI/NISO Z39.99-2014</a>.
|
|
52
|
+
Changes address issues discussed in
|
|
53
|
+
<a href="https://groups.google.com/forum/#!topic/resourcesync/IpDj3TlnZdM">Updating
|
|
54
|
+
ResourceSync specs regarding lastmod issue</a>. Feedback is most welcome on the
|
|
55
|
+
<a href="https://groups.google.com/d/forum/resourcesync">ResourceSync Google Group</a>.</p>
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
<p>This specification is one of several documents comprising the
|
|
59
|
+
<a href="http://www.openarchives.org/rs/toc">ResourceSync Framework Specifications</a>.</p>
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
<div class="toc">
|
|
63
|
+
<h2><a name="contents"></a>Table of Contents</h2>
|
|
64
|
+
<p class="toc">
|
|
65
|
+
|
|
66
|
+
1. <a href="#Introduction">Introduction</a><br/>
|
|
67
|
+
1.1 <a href="#PurposeScope">Purpose and Scope</a><br/>
|
|
68
|
+
1.2 <a href="#MotivExamples">Motivating Examples</a><br/>
|
|
69
|
+
1.3 <a href="#Walkthrough">Walkthrough</a><br/>
|
|
70
|
+
|
|
71
|
+
2. <a href="#NormativeRefs">Normative References</a><br/>
|
|
72
|
+
|
|
73
|
+
3. <a href="#Definitions">Definitions</a><br/>
|
|
74
|
+
|
|
75
|
+
4. <a href="#Namespaces">Namespace Prefix Bindings</a><br/>
|
|
76
|
+
|
|
77
|
+
5. <a href="#SyncProcesses">Synchronization Processes</a><br/>
|
|
78
|
+
5.1 <a href="#SourcePers">Source Perspective</a><br/>
|
|
79
|
+
5.2 <a href="#DestPers">Destination Perspective</a><br/>
|
|
80
|
+
5.3 <a href="#Summary">Summary</a><br/>
|
|
81
|
+
|
|
82
|
+
6. <a href="#FrameworkOrg">Framework Organization</a><br/>
|
|
83
|
+
6.1 <a href="#Structure">Structure</a><br/>
|
|
84
|
+
6.2 <a href="#Navigation">Navigation</a><br/>
|
|
85
|
+
6.3 <a href="#Discovery">Discovery</a><br/>
|
|
86
|
+
6.3.1 <a href="#DiscoOverview">Overview</a><br/>
|
|
87
|
+
6.3.2 <a href="#wellknown">ResourceSync Well-Known URI</a><br/>
|
|
88
|
+
6.3.3 <a href="#disco_links">Links</a><br/>
|
|
89
|
+
6.3.4 <a href="#robots">robots.txt</a><br/>
|
|
90
|
+
|
|
91
|
+
7. <a href="#DocumentFormats">Sitemap Document Formats</a><br/>
|
|
92
|
+
|
|
93
|
+
8. <a href="#SourceDesc">Describing the Source</a><br/>
|
|
94
|
+
|
|
95
|
+
9. <a href="#CapabilityList">Advertising Capabilities</a><br/>
|
|
96
|
+
|
|
97
|
+
10. <a href="#DescResources">Describing Resources</a><br/>
|
|
98
|
+
10.1 <a href="#ResourceList">Resource List</a><br/>
|
|
99
|
+
10.2 <a href="#ResourceListIndex">Resource List Index</a><br/>
|
|
100
|
+
|
|
101
|
+
11. <a href="#PackResources">Packaging Resources</a><br/>
|
|
102
|
+
11.1 <a href="#ResourceDump">Resource Dump</a><br/>
|
|
103
|
+
11.1.1 <a href="#ResourceDumpManifest">Resource Dump Manifest</a><br/>
|
|
104
|
+
|
|
105
|
+
12. <a href="#DesChanges">Describing Changes</a><br/>
|
|
106
|
+
12.1 <a href="#ChangeList">Change List</a><br/>
|
|
107
|
+
12.2 <a href="#ChangeListIndex">Change List Index</a><br/>
|
|
108
|
+
|
|
109
|
+
13. <a href="#PackChanges">Packaging Changes</a><br/>
|
|
110
|
+
13.1 <a href="#ChangeDump">Change Dump</a><br/>
|
|
111
|
+
13.1.1 <a href="#ChangeDumpManifest">Change Dump Manifest</a><br/>
|
|
112
|
+
|
|
113
|
+
14. <a href="#LinkRelRes">Linking to Related Resources</a><br/>
|
|
114
|
+
14.1 <a href="#LinkRelResOverview">Overview</a><br/>
|
|
115
|
+
14.2 <a href="#MirCon">Mirrored Content</a><br/>
|
|
116
|
+
14.3 <a href="#AltRep">Alternate Representations</a><br/>
|
|
117
|
+
14.4 <a href="#PatchCon">Patching Content</a><br/>
|
|
118
|
+
14.5 <a href="#ResMDLinking">Resources and Metadata about Resources</a><br/>
|
|
119
|
+
14.6 <a href="#ResVers">Prior Versions of Resources</a><br/>
|
|
120
|
+
14.7 <a href="#ColMem">Collection Membership</a><br/>
|
|
121
|
+
14.8 <a href="#RePub">Republishing Resources</a><br/>
|
|
122
|
+
|
|
123
|
+
Appendix A. (normative) <a href="#TimeAttributeReqs">Time Attribute Requirements</a><br/>
|
|
124
|
+
Appendix B. <a href="#Bibliography">Bibliography</a><br/>
|
|
125
|
+
Appendix C. <a href="#FrontMatter">Front Matter, Authorship, Acknowledgements</a><br/>
|
|
126
|
+
Appendix D. <a href="#Changelog">Change Log</a>
|
|
127
|
+
</p>
|
|
128
|
+
</div>
|
|
129
|
+
|
|
130
|
+
|
|
131
|
+
<div class="body">
|
|
132
|
+
<h2>1. <a name="Introduction">Introduction</a></h2>
|
|
133
|
+
|
|
134
|
+
<h3>1.1 <a name="PurposeScope">Purpose and Scope</a></h3>
|
|
135
|
+
|
|
136
|
+
<p>The web is highly dynamic, with resources continuously being created,
|
|
137
|
+
updated, and deleted. As a result, using resources from a remote
|
|
138
|
+
server involves the challenge of remaining in step with its changing
|
|
139
|
+
content. In many cases, there is no need to reflect a
|
|
140
|
+
server's evolving content perfectly and, therefore, well-established
|
|
141
|
+
resource discovery techniques, such as crawling, suffice as an
|
|
142
|
+
updating mechanism. However, there are significant use cases that
|
|
143
|
+
require low latency and high accuracy in reflecting a remote server's
|
|
144
|
+
changing content. These requirements have typically been addressed by
|
|
145
|
+
ad-hoc technical approaches implemented within a small group of
|
|
146
|
+
collaborating systems. There have been no widely adopted, web-based
|
|
147
|
+
approaches.</p>
|
|
148
|
+
|
|
149
|
+
<p>This <strong>ResourceSync</strong> specification introduces a range
|
|
150
|
+
of easy to implement capabilities that a server may support in order
|
|
151
|
+
to enable remote systems to remain more tightly in step with its
|
|
152
|
+
evolving resources. It also describes how a server should advertise the
|
|
153
|
+
capabilities it supports. Remote systems may inspect this information
|
|
154
|
+
to determine how best to remain aligned with the evolving data.</p>
|
|
155
|
+
|
|
156
|
+
<p>Each capability provides a different synchronization functionality,
|
|
157
|
+
such as a list of the server's resources or its recently changed
|
|
158
|
+
resources, including what the nature of the change was: create,
|
|
159
|
+
update, or delete. All capabilities are implemented on the basis of
|
|
160
|
+
the document formats introduced by the
|
|
161
|
+
<a href="#ref-sitemaps">Sitemap protocol</a>. Capabilities may be
|
|
162
|
+
combined to achieve varying levels of functionality and hence meet
|
|
163
|
+
different local or community requirements. This modularity provides
|
|
164
|
+
flexibility and makes ResourceSync suitable for a broad range of use
|
|
165
|
+
cases.</p>
|
|
166
|
+
|
|
167
|
+
<h3>1.2 <a name="MotivExamples"></a>Motivating Examples</h3>
|
|
168
|
+
|
|
169
|
+
<p>Many projects and services have synchronization needs and have
|
|
170
|
+
implemented ad hoc solutions. ResourceSync provides a standard
|
|
171
|
+
synchronization method that will reduce implementation effort and
|
|
172
|
+
facilitate easier reuse of resources. This section describes motivating
|
|
173
|
+
examples with differing needs and complexities.</p>
|
|
174
|
+
|
|
175
|
+
<p>Consider first the case of a website for a small museum collection.
|
|
176
|
+
The website may contain just a few dozen static webpages. The
|
|
177
|
+
maintainer may create a <a href="#ResourceList">Resource List</a> of these
|
|
178
|
+
webpages and expose it to services that leverage ResourceSync.</p>
|
|
179
|
+
|
|
180
|
+
<p>When building services over Linked Data, it is often desirable to
|
|
181
|
+
maintain a local copy of data for improved access and availability.
|
|
182
|
+
Harvesting may be enabled by publishing a <a href="#ResourceList">Resource List</a>
|
|
183
|
+
for the dataset. In many cases, resource representations exposed as Linked Data are small and
|
|
184
|
+
so retrieving them via individual HTTP GET requests is slow because of the
|
|
185
|
+
large number of round trips for a small amount of content.
|
|
186
|
+
Publishing a <a href="#ResourceDump">Resource Dump</a> that points to content
|
|
187
|
+
packaged and described in ZIP files makes
|
|
188
|
+
this more efficient for the client and less burdensome for the server.
|
|
189
|
+
Continued synchronization is enabled by recurrently publishing an up-to-date <a href="#ResourceList">Resource List</a> or <a href="#ResourceDump">Resource Dump</a>, or, more efficiently, by publishing a <a href="#ChangeList">Change List</a> that provides information about resource changes only.</p>
|
|
190
|
+
|
|
191
|
+
<p>Repositories of scholarly articles and data have typically
|
|
192
|
+
shared metadata via <a href="#ref-oaipmh">OAI-PMH</a>. As these repositories are
|
|
193
|
+
rearchitected to become resource- or web-centric, the ResourceSync Framework
|
|
194
|
+
enables sharing of both metadata and content with aggregators and
|
|
195
|
+
commodity web search engines alike. Publication of a
|
|
196
|
+
<a href="#ResourceList">Resource List</a> -- compatible with
|
|
197
|
+
<a href="#ref-sitemaps">Sitemaps</a> -- provides the base level of
|
|
198
|
+
interoperability and enables indexing by commodity web search engines.
|
|
199
|
+
Use of other capabilities such as
|
|
200
|
+
<a href="#ResourceDump">Resource Dumps</a>,
|
|
201
|
+
<a href="#ChangeList">Change Lists</a>, and
|
|
202
|
+
<a href="#ChangeDump">Change Dumps</a> supports easier initial
|
|
203
|
+
synchronization and more efficient increment updates. ResourceSync supports
|
|
204
|
+
synchronization of both <a href="#ResMDLinking">Resources and Metadata about
|
|
205
|
+
Resources</a> with the relationships clearly indicated. It also enables expression of
|
|
206
|
+
different sets of resources via the <a href="#SourceDesc">Source Description</a>
|
|
207
|
+
to support use cases requiring synchronization of subsets of a repository's
|
|
208
|
+
content.</p>
|
|
209
|
+
|
|
210
|
+
|
|
211
|
+
<h3>1.3 <a name="Walkthrough">Walkthrough</a></h3>
|
|
212
|
+
|
|
213
|
+
<p>
|
|
214
|
+
Let's assume a Source, http://example.com/, that exposes changing content that others
|
|
215
|
+
would like to remain synchronized with. A first step towards making this easy for
|
|
216
|
+
Destinations is for the Source to publish a <a href="#ResourceList">Resource List</a>
|
|
217
|
+
that conveys the URIs of resources available for synchronization. This Resource List is
|
|
218
|
+
expressed as a Sitemap. As shown in <a href="#ex_1">Example 1</a>, the Source conveys
|
|
219
|
+
the URI of each resource as the value of the
|
|
220
|
+
<code><loc></code> child element of a
|
|
221
|
+
<code><url></code> element. Note the
|
|
222
|
+
<code><rs:md></code> child element of the <code><urlset></code>
|
|
223
|
+
root element, which expresses that the Sitemap implements ResourceSync's Resource List
|
|
224
|
+
capability. It also conveys that the Resource List reflects the state of the Source's
|
|
225
|
+
resources at the datetime provided in the <code>at</code> attribute. This datetime
|
|
226
|
+
allows a Destination to quickly determine whether it has previously processed this
|
|
227
|
+
specific Resource List.
|
|
228
|
+
</p>
|
|
229
|
+
|
|
230
|
+
<!--EXAMPLE:ex_1.xml-->
|
|
231
|
+
<a name="ex_1"></a>
|
|
232
|
+
<div class="exampleInner">
|
|
233
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
234
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
235
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
236
|
+
<rs:md capability="resourcelist"
|
|
237
|
+
at="2013-01-03T09:00:00Z"/>
|
|
238
|
+
<url>
|
|
239
|
+
<loc>http://example.com/res1</loc>
|
|
240
|
+
</url>
|
|
241
|
+
<url>
|
|
242
|
+
<loc>http://example.com/res2</loc>
|
|
243
|
+
</url>
|
|
244
|
+
</urlset>
|
|
245
|
+
</pre>
|
|
246
|
+
</div>
|
|
247
|
+
<p class="caption">Example 1: A Resource List</p>
|
|
248
|
+
<!--/EXAMPLE:ex_1.xml-->
|
|
249
|
+
|
|
250
|
+
<p>
|
|
251
|
+
The Source can provide additional information in the Resource List to
|
|
252
|
+
help the Destination optimize the process of collecting
|
|
253
|
+
content and verifying its accuracy. For example,
|
|
254
|
+
when the Source expresses the datetime of the most recent modification
|
|
255
|
+
for a resource, a Destination can determine whether or not it already
|
|
256
|
+
holds the current version, minimizing the number of HTTP requests it
|
|
257
|
+
needs to issue in order to remain up-to-date. <a href="#ex_2">Example 2</a>
|
|
258
|
+
shows this information
|
|
259
|
+
conveyed using Sitemap's optional <code><lastmod></code> element.
|
|
260
|
+
When the Source also conveys a hash for a specific bitstream, a Destination
|
|
261
|
+
can verify whether the process of obtaining it was successful.
|
|
262
|
+
The example shows this information conveyed using the <code>hash</code>
|
|
263
|
+
attribute on the <code><rs:md></code> element.
|
|
264
|
+
In addition, the Source can provide links to related resources using the
|
|
265
|
+
<code><rs:ln></code> element. The example shows a link to a mirror
|
|
266
|
+
copy of the second listed resource, indicating that the Source would prefer
|
|
267
|
+
a Destination to obtain the resource from it.
|
|
268
|
+
</p>
|
|
269
|
+
|
|
270
|
+
<!--EXAMPLE:ex_2.xml-->
|
|
271
|
+
<a name="ex_2"></a>
|
|
272
|
+
<div class="exampleInner">
|
|
273
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
274
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
275
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
276
|
+
<rs:md capability="resourcelist"
|
|
277
|
+
at="2013-01-03T09:00:00Z"/>
|
|
278
|
+
<url>
|
|
279
|
+
<loc>http://example.com/res1</loc>
|
|
280
|
+
<lastmod>2013-01-02T13:00:00Z</lastmod>
|
|
281
|
+
<rs:md hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"/>
|
|
282
|
+
</url>
|
|
283
|
+
<url>
|
|
284
|
+
<loc>http://example.com/res2</loc>
|
|
285
|
+
<lastmod>2013-01-02T14:00:00Z</lastmod>
|
|
286
|
+
<rs:md hash="md5:1e0d5cb8ef6ba40c99b14c0237be735e"/>
|
|
287
|
+
<rs:ln rel="duplicate"
|
|
288
|
+
href="http://mirror.example.com/res2"/>
|
|
289
|
+
</url>
|
|
290
|
+
</urlset>
|
|
291
|
+
</pre>
|
|
292
|
+
</div>
|
|
293
|
+
<p class="caption">Example 2: A Resource List with additional information</p>
|
|
294
|
+
<!--/EXAMPLE:ex_2.xml-->
|
|
295
|
+
|
|
296
|
+
<p>
|
|
297
|
+
In order to describe its changing content in a more timely manner, the
|
|
298
|
+
Source can increase the frequency at which it publishes an up-to-date
|
|
299
|
+
Resource List. However, changes may be so frequent or the size of the content
|
|
300
|
+
collection so vast that regularly updating a complete Resource List may
|
|
301
|
+
be impractical. In such cases, the Source can implement a
|
|
302
|
+
capability that communicates information about changes
|
|
303
|
+
only. To this end, ResourceSync introduces Change Lists. A Change List
|
|
304
|
+
enumerates resource changes, along with the nature of the
|
|
305
|
+
change (create, update, or delete) and metadata describing the new
|
|
306
|
+
state of the resource.
|
|
307
|
+
A Destination can recurrently obtain a Change List from the Source,
|
|
308
|
+
inspect the listed changes to discover those it has already acted upon,
|
|
309
|
+
and process the remaining ones. Changes in a Change List are provided
|
|
310
|
+
in forward chronological order, helping a Destination determine which
|
|
311
|
+
changes it has already processed. In addition,
|
|
312
|
+
a Change List also contains datetimes that convey the start time and
|
|
313
|
+
the end time of the temporal interval covered by the Change List.
|
|
314
|
+
These times convey that all resource changes that
|
|
315
|
+
occurred during the interval are described in the Change List.
|
|
316
|
+
(ResourceSync does not specify for how long Change Lists must
|
|
317
|
+
continue to be available once they have been produced. The
|
|
318
|
+
longer Change Lists are maintained by the Source, the
|
|
319
|
+
better the odds are for a Destination to catch up on changes
|
|
320
|
+
it missed because it was offline, for example.)
|
|
321
|
+
</p>
|
|
322
|
+
|
|
323
|
+
<p><a href="#ex_3">Example 3</a> shows a Change List.
|
|
324
|
+
The value of the <code>capability</code> attribute of the <code><rs:md></code>
|
|
325
|
+
child element of <code><urlset></code> makes it clear that, this time,
|
|
326
|
+
the Sitemap is a Change List and not a Resource List. The <code>from</code>
|
|
327
|
+
and <code>until</code> attributes give the temporal interval covered
|
|
328
|
+
by the Change List. The Change List shown below conveys three
|
|
329
|
+
resource changes: one an update, another a deletion, and the third a
|
|
330
|
+
creation. The change types can be seen from the value of the <code>change</code>
|
|
331
|
+
attribute of each <code><rs:md></code> element.
|
|
332
|
+
The example also shows the use of the
|
|
333
|
+
<code><lastmod></code> element to convey the modification times of
|
|
334
|
+
the resources, and the <code>datetime</code> attribute of
|
|
335
|
+
<code><rs:md></code> to convey the change time. In the case of the
|
|
336
|
+
created resource, the datetime conveyed by the <code><lastmod></code>
|
|
337
|
+
element is earlier than that of the <code>datetime</code> attribute,
|
|
338
|
+
perhaps because the repository made an old file visible only at the
|
|
339
|
+
<code>datetime</code> given.
|
|
340
|
+
Note that the changes are listed in chronological order by update time,
|
|
341
|
+
which may be given as values of the <code>datetime</code> attribute.
|
|
342
|
+
</p>
|
|
343
|
+
|
|
344
|
+
<!--EXAMPLE:ex_3.xml-->
|
|
345
|
+
<a name="ex_3"></a>
|
|
346
|
+
<div class="exampleInner">
|
|
347
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
348
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
349
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
350
|
+
<rs:md capability="changelist"
|
|
351
|
+
from="2013-01-02T00:00:00Z"
|
|
352
|
+
until="2013-01-03T00:00:00Z"/>
|
|
353
|
+
<url>
|
|
354
|
+
<loc>http://example.com/res1.pdf</loc>
|
|
355
|
+
<lastmod>2013-01-02T13:00:00Z</lastmod>
|
|
356
|
+
<rs:md change="updated" datetime="2013-01-02T13:00:00Z"/>
|
|
357
|
+
</url>
|
|
358
|
+
<url>
|
|
359
|
+
<loc>http://example.com/res2.pdf</loc>
|
|
360
|
+
<rs:md change="deleted" datetime="2013-01-02T14:00:00Z"/>
|
|
361
|
+
</url>
|
|
362
|
+
<url>
|
|
363
|
+
<loc>http://example.com/res3.tiff</loc>
|
|
364
|
+
<lastmod>2011-01-01T00:00:00Z</lastmod>
|
|
365
|
+
<rs:md change="created" datetime="2013-01-02T15:00:00Z"/>
|
|
366
|
+
</url>
|
|
367
|
+
</urlset>
|
|
368
|
+
</pre>
|
|
369
|
+
</div>
|
|
370
|
+
<p class="caption">Example 3: A Change List</p>
|
|
371
|
+
<!--/EXAMPLE:ex_3.xml-->
|
|
372
|
+
|
|
373
|
+
<p>A Destination can issue HTTP GET requests against each resource URI listed in a Resource List. For
|
|
374
|
+
large Resource Lists, issuing all of these requests may be cumbersome. Therefore, ResourceSync introduces a
|
|
375
|
+
capability that a Source can use to
|
|
376
|
+
make packaged content available. A Resource Dump, implemented as a Sitemap, contains pointers to packaged content.
|
|
377
|
+
Each content package referenced in a Resource Dump is a ZIP file that contains the Source's bitstreams along with a Resource Dump Manifest
|
|
378
|
+
that describes each. The Resource Dump Manifest itself is also implemented as a Sitemap.
|
|
379
|
+
A Destination can retrieve a Resource Dump, obtain content packages by dereferencing the contained pointers, and unpack the retrieved packages.
|
|
380
|
+
Since the Resource Dump Manifest also lists the URI the Source associates with each bitstream, a Destination is able to achieve
|
|
381
|
+
the same result as obtaining the data by dereferencing the URIs listed in a Resource List.
|
|
382
|
+
<a href="#ex_4">Example 4</a> shows a Resource Dump that points at a single content package. Dereferencing the URI of that package leads to a ZIP file
|
|
383
|
+
that contains the Resource Dump Manifest shown in
|
|
384
|
+
<a href="#ex_5">Example 5</a>. It indicates that the Source's ZIP file contains two bitstreams.
|
|
385
|
+
The <code>path</code> attribute of the <code><rs:md></code> element conveys
|
|
386
|
+
the file path of the bitstream in the ZIP file (the relative file system path where the bitstream
|
|
387
|
+
would reside if the ZIP were unpacked), whereas the <code><loc></code> element conveys the URI associated with the bitstream at the Source.
|
|
388
|
+
</p>
|
|
389
|
+
|
|
390
|
+
<p>An additional capability, the Change Dump, provides a functionality similar to a Resource Dump but pertains to
|
|
391
|
+
packaging bitstreams of resources that have changed during a temporal interval,
|
|
392
|
+
instead of packaging a snapshot of resource bitstreams at a specific moment in time.</p>
|
|
393
|
+
|
|
394
|
+
<!--EXAMPLE:ex_4.xml-->
|
|
395
|
+
<a name="ex_4.xml"></a>
|
|
396
|
+
<div class="exampleInner">
|
|
397
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
398
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
399
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
400
|
+
<rs:md capability="resourcedump"
|
|
401
|
+
at="2013-01-03T09:00:00Z"/>
|
|
402
|
+
<url>
|
|
403
|
+
<loc>http://example.com/resourcedump.zip</loc>
|
|
404
|
+
</url>
|
|
405
|
+
</urlset>
|
|
406
|
+
</pre>
|
|
407
|
+
</div>
|
|
408
|
+
<p class="caption">Example 4: A Resource Dump</p>
|
|
409
|
+
<!--/EXAMPLE:ex_4.xml-->
|
|
410
|
+
|
|
411
|
+
<!--EXAMPLE:ex_5.xml-->
|
|
412
|
+
<a name="ex_5"></a>
|
|
413
|
+
<div class="exampleInner">
|
|
414
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
415
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
416
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
417
|
+
<rs:md capability="resourcedump-manifest"
|
|
418
|
+
at="2013-01-03T09:00:00Z"/>
|
|
419
|
+
<url>
|
|
420
|
+
<loc>http://example.com/res1</loc>
|
|
421
|
+
<rs:md hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
422
|
+
path="/resources/res1"/>
|
|
423
|
+
</url>
|
|
424
|
+
<url>
|
|
425
|
+
<loc>http://example.com/res2</loc>
|
|
426
|
+
<rs:md hash="md5:1e0d5cb8ef6ba40c99b14c0237be735e"
|
|
427
|
+
path="/resources/res2"/>
|
|
428
|
+
</url>
|
|
429
|
+
</urlset>
|
|
430
|
+
</pre>
|
|
431
|
+
</div>
|
|
432
|
+
<p class="caption">Example 5: A Resource Dump Manifest detailing the content of a ZIP file</p>
|
|
433
|
+
<!--/EXAMPLE:ex_5.xml-->
|
|
434
|
+
|
|
435
|
+
<p>ResourceSync also introduces a Capability List, which is a way for the
|
|
436
|
+
Source to describe the capabilities it supports for one set of resources.
|
|
437
|
+
<a href="#ex_6">Example 6</a> shows such a description.
|
|
438
|
+
It indicates that the Source supports the Resource List, Resource Dump, and
|
|
439
|
+
Change List capabilities and it lists their respective URIs. Note the
|
|
440
|
+
inclusion of an <code><rs:ln></code> child element of <code><urlset></code>
|
|
441
|
+
that links by means of a <code>describedby</code> relation
|
|
442
|
+
to a description of the set of resources covered by the Capability List.
|
|
443
|
+
Because these capabilities are conveyed in the same Capability List, they
|
|
444
|
+
uniformly apply to this set of resources. For example, if a given resource
|
|
445
|
+
appears in the Resource List then it must also appear in a Resource Dump
|
|
446
|
+
and changes to the resource must be reported in the Change List.
|
|
447
|
+
</p>
|
|
448
|
+
|
|
449
|
+
<!--EXAMPLE:ex_6.xml-->
|
|
450
|
+
<a name="ex_6"></a>
|
|
451
|
+
<div class="exampleInner">
|
|
452
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
453
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
454
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
455
|
+
<rs:ln rel="describedby"
|
|
456
|
+
href="http://example.com/info_about_set1_of_resources.xml"/>
|
|
457
|
+
<rs:ln rel="up"
|
|
458
|
+
href="http://example.com/resourcesync_description.xml"/>
|
|
459
|
+
<rs:md capability="capabilitylist"/>
|
|
460
|
+
<url>
|
|
461
|
+
<loc>http://example.com/dataset1/resourcelist.xml</loc>
|
|
462
|
+
<rs:md capability="resourcelist"/>
|
|
463
|
+
</url>
|
|
464
|
+
<url>
|
|
465
|
+
<loc>http://example.com/dataset1/resourcedump.xml</loc>
|
|
466
|
+
<rs:md capability="resourcedump"/>
|
|
467
|
+
</url>
|
|
468
|
+
<url>
|
|
469
|
+
<loc>http://example.com/dataset1/changelist.xml</loc>
|
|
470
|
+
<rs:md capability="changelist"/>
|
|
471
|
+
</url>
|
|
472
|
+
</urlset>
|
|
473
|
+
</pre>
|
|
474
|
+
</div>
|
|
475
|
+
<p class="caption">Example 6: A Capability List enumerating the ResourceSync capabilities a Source supports for a set of its resources</p>
|
|
476
|
+
<!--/EXAMPLE:ex_6.xml-->
|
|
477
|
+
|
|
478
|
+
<p>
|
|
479
|
+
There are three ways by which a Destination can discover whether and how a Source
|
|
480
|
+
supports ResourceSync: a Source-wide approach, a resource-specific approach, and
|
|
481
|
+
an approach that leverages existing practice for discovering Sitemaps.
|
|
482
|
+
The Source-wide approach leverages the well-known URI specification
|
|
483
|
+
and consists of the Source making a Source Description, like the one shown in
|
|
484
|
+
<a href="#ex_7">Example 7</a>, available at
|
|
485
|
+
<code>/.well-known/resourcesync</code>. The Source Description enumerates the
|
|
486
|
+
Capability Lists a Source offers, one Capability List per set of resources. If a
|
|
487
|
+
Source only has one set of resources and hence only one Capability List, the
|
|
488
|
+
mandatory Source Description contains only one pointer. The resource-specific
|
|
489
|
+
discovery approach
|
|
490
|
+
consists of a Source providing a link in an HTML document or in an HTTP Link header
|
|
491
|
+
that points at a Capability List that covers the resource that provides the link. Note
|
|
492
|
+
in <a href="#ex_6">Example 6</a> the inclusion of an <code><rs:ln></code> child
|
|
493
|
+
element of <code><urlset></code> that links by means of an <code>up</code> relation
|
|
494
|
+
to the Source Description, allowing for navigation from a Capability List to a Source
|
|
495
|
+
Description. Yet another approach follows the established practice for discovering
|
|
496
|
+
Sitemaps via a Source's <code>robots.txt</code> file. Since a Resource List is a
|
|
497
|
+
Sitemap it can be made discoverable by including its URI in the <code>robots.txt</code>
|
|
498
|
+
file as the value of the <code>Sitemap</code> directive. A navigational <code>up</code>
|
|
499
|
+
link included in the Resource List allows discovery of a Capability List pertaining
|
|
500
|
+
to the set of resources covered by that Resource List, and a further
|
|
501
|
+
<code>up</code> link in the Capability List leads to the Source Description.
|
|
502
|
+
</p>
|
|
503
|
+
|
|
504
|
+
<!--EXAMPLE:ex_7.xml-->
|
|
505
|
+
<a name="ex_7"></a>
|
|
506
|
+
<div class="exampleInner">
|
|
507
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
508
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
509
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
510
|
+
<rs:ln rel="describedby"
|
|
511
|
+
href="http://example.com/info-about-source.xml"/>
|
|
512
|
+
<rs:md capability="description"/>
|
|
513
|
+
<url>
|
|
514
|
+
<loc>http://example.com/dataset1/capabilitylist.xml</loc>
|
|
515
|
+
<rs:md capability="capabilitylist"/>
|
|
516
|
+
<rs:ln rel="describedby"
|
|
517
|
+
href="http://example.com/info_about_set1_of_resources.xml"/>
|
|
518
|
+
</url>
|
|
519
|
+
</urlset>
|
|
520
|
+
</pre>
|
|
521
|
+
</div>
|
|
522
|
+
<p class="caption">Example 7: A Source Description with a pointer to the Capability List for the single set of resources offered by a Source</p>
|
|
523
|
+
<!--/EXAMPLE:ex_7.xml-->
|
|
524
|
+
|
|
525
|
+
<p>In some cases, there is a need to split the documents described so far into parts.
|
|
526
|
+
For example, the Sitemap protocol currently prescribes a maximum of 50,000 resources
|
|
527
|
+
per Sitemap and a Source may have more resources that are subject to synchronization.
|
|
528
|
+
The ResourceSync framework follows these community defined limits and hence,
|
|
529
|
+
in such cases, publishes multiple Resource Lists as well as a Resource List Index
|
|
530
|
+
that points to each of them. The Resource List Index is expressed using
|
|
531
|
+
Sitemap's <code><sitemapindex></code> document format.
|
|
532
|
+
<a href="#ex_8">Example 8</a> shows a Resource List Index that points at two Resource
|
|
533
|
+
Lists.</p>
|
|
534
|
+
|
|
535
|
+
<!--EXAMPLE:ex_8.xml-->
|
|
536
|
+
<a name="ex_8"></a>
|
|
537
|
+
<div class="exampleInner">
|
|
538
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
539
|
+
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
540
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
541
|
+
<rs:md capability="resourcelist"
|
|
542
|
+
at="2013-01-03T09:00:00Z"/>
|
|
543
|
+
<sitemap>
|
|
544
|
+
<loc>http://example.com/resourcelist-part1.xml</loc>
|
|
545
|
+
</sitemap>
|
|
546
|
+
<sitemap>
|
|
547
|
+
<loc>http://example.com/resourcelist-part2.xml</loc>
|
|
548
|
+
</sitemap>
|
|
549
|
+
</sitemapindex>
|
|
550
|
+
</pre>
|
|
551
|
+
</div>
|
|
552
|
+
<p class="caption">Example 8: A Resource List Index expressed using the <code><sitemapindex></code> document format</p>
|
|
553
|
+
<!--/EXAMPLE:ex_8.xml-->
|
|
554
|
+
|
|
555
|
+
|
|
556
|
+
<h2>2. <a name="NormativeRefs">Normative References</a></h2>
|
|
557
|
+
|
|
558
|
+
<p>
|
|
559
|
+
The following documents contain provisions that are required for implementing
|
|
560
|
+
this standard. All standards are subject to revision; the most current version
|
|
561
|
+
of these standards should be used.
|
|
562
|
+
</p>
|
|
563
|
+
|
|
564
|
+
<dl>
|
|
565
|
+
<dt>[<a name="ref-ale" id="ref-ale">ALE</a>]</dt>
|
|
566
|
+
<dd>Snell, J.
|
|
567
|
+
<a href="http://tools.ietf.org/html/draft-snell-atompub-link-extensions-09"><cite>Atom Link Extensions</cite></a>.
|
|
568
|
+
Internet Draft. Internet Engineering Task Force (IETF), June 8, 2012.
|
|
569
|
+
Available at: <a href="http://tools.ietf.org/html/draft-snell-atompub-link-extensions-09">http://tools.ietf.org/html/draft-snell-atompub-link-extensions-09</a></dd>
|
|
570
|
+
|
|
571
|
+
<dt>[<a name="ref-iana-mime" id="ref-iana-mime">IANA MIME</a>]</dt>
|
|
572
|
+
<dd><a href="http://www.iana.org/assignments/media-types"><cite>MIME Media Types</cite></a> [registry website].
|
|
573
|
+
Internet Assigned Numbers Authority (IANA).
|
|
574
|
+
Available at: <a href="http://www.iana.org/assignments/media-types">http://www.iana.org/assignments/media-types</a></dd>
|
|
575
|
+
|
|
576
|
+
<dt>[<a name="ref-iana-rel" id="ref-iana-rel">IANA Relation</a>]</dt>
|
|
577
|
+
<dd><a href="http://www.iana.org/assignments/link-relations/link-relations.xml"><cite>Link Relations</cite></a> [registry website].
|
|
578
|
+
Internet Assigned Numbers Authority (IANA).
|
|
579
|
+
Available at: <a href="http://www.iana.org/assignments/link-relations/link-relations.xml">http://www.iana.org/assignments/link-relations/link-relations.xml</a></dd>
|
|
580
|
+
|
|
581
|
+
<dt>[<a name="ref-rfc2616" id="ref-rfc2616">RFC 2616</a>]</dt>
|
|
582
|
+
<dd>Fielding, R. <i>et al.</i>
|
|
583
|
+
<cite><a href="http://www.ietf.org/rfc/rfc2616.txt">Hypertext Transfer Protocol -- HTTP/1.1</a></cite>. RFC 2616.
|
|
584
|
+
Internet Engineering Task Force (IETF), June 1999.
|
|
585
|
+
Available at: <a href="http://www.ietf.org/rfc/rfc2616.txt">http://www.ietf.org/rfc/rfc2616.txt</a></dd>
|
|
586
|
+
|
|
587
|
+
<dt>[<a name="ref-rfc4287" id="ref-rfc4287">RFC 4287</a>]</dt>
|
|
588
|
+
<dd>Nottingham, M., and R. Sayre, <i>eds.</i>
|
|
589
|
+
<cite><a href="http://www.ietf.org/rfc/rfc4287.txt">The Atom Syndication Format</a></cite>. RFC 4287.
|
|
590
|
+
Internet Engineering Task Force (IETF), December 2005.
|
|
591
|
+
Available at: <a href="http://www.ietf.org/rfc/rfc4287.txt">http://www.ietf.org/rfc/rfc4287.txt</a></dd>
|
|
592
|
+
|
|
593
|
+
<dt>[<a name="ref-rfc5988" id="ref-rfc5988">RFC 5988</a>]</dt>
|
|
594
|
+
<dd>Nottingham, M.
|
|
595
|
+
<cite><a href="http://www.ietf.org/rfc/rfc5988.txt">Web Linking</a></cite>. RFC 5988.
|
|
596
|
+
Internet Engineering Task Force (IETF), October 2010.
|
|
597
|
+
Available at: <a href="http://www.ietf.org/rfc/rfc5988.txt">http://www.ietf.org/rfc/rfc5988.txt</a></dd>
|
|
598
|
+
|
|
599
|
+
<dt>[<a name="ref-rfc6249" id="ref-rfc6249">RFC 6249</a>]</dt>
|
|
600
|
+
<dd>Bryan, A. <i>et al.</i>
|
|
601
|
+
<cite><a href="http://www.ietf.org/rfc/rfc6249.txt">Metalink/HTTP: Mirrors and Hashes</a></cite>. RFC 6249.
|
|
602
|
+
Internet Engineering Task Force (IETF), June 2011.
|
|
603
|
+
Available at: <a href="http://www.ietf.org/rfc/rfc6249.txt">http://www.ietf.org/rfc/rfc6249.txt</a></dd>
|
|
604
|
+
|
|
605
|
+
<dt>[<a name="ref-rfc6906" id="ref-rfc6906">RFC 6906</a>]</dt>
|
|
606
|
+
<dd>Wilde, E.
|
|
607
|
+
<cite><a href="http://www.ietf.org/rfc/rfc6906.txt">The 'profile' Link Relation Type.</a></cite> RFC 6906.
|
|
608
|
+
Internet Engineering Task Force (IETF), March 2013.
|
|
609
|
+
Available at: <a href="http://www.ietf.org/rfc/rfc6906.txt">http://www.ietf.org/rfc/rfc6906.txt</a></dd>
|
|
610
|
+
|
|
611
|
+
<dt>[<a name="ref-rfc7089" id="ref-rfc7089">RFC 7089</a>]</dt>
|
|
612
|
+
<dd>Van de Sompel, H., M. Nelson, and R. Sanderson.
|
|
613
|
+
<a href="http://www.ietf.org/rfc/rfc7089.txt"><cite>HTTP Framework for Time-Based Access to Resource States -- Memento</cite></a>. RFC 7089.
|
|
614
|
+
Internet Engineering Task Force (IETF), December 2013.
|
|
615
|
+
Available at: <a href="http://www.ietf.org/rfc/rfc7089.txt">http://www.ietf.org/rfc/rfc7089.txt</a></dd>
|
|
616
|
+
|
|
617
|
+
<dt>[<a name="ref-sitemaps" id="ref-sitemaps">Sitemaps</a>]</dt>
|
|
618
|
+
<dd><cite><a href="http://www.sitemaps.org/protocol.html">Sitemaps XML Format</a></cite>.
|
|
619
|
+
sitemaps.org, last updated February 27, 2008.
|
|
620
|
+
Available at: <a href="http://www.sitemaps.org/protocol.html">http://www.sitemaps.org/protocol.html</a></dd>
|
|
621
|
+
|
|
622
|
+
<dt>[<a name="w3c-datetime" id="w3c-datetime">W3C Datetime</a>]</dt>
|
|
623
|
+
<dd>Wolf, Misha, and Charles Wicksteed.
|
|
624
|
+
<cite><a href="http://www.w3.org/TR/1998/NOTE-datetime-19980827">Date and Time Formats</a></cite>. W3C Note.
|
|
625
|
+
World Wide Web Consortium, August 27, 1998.
|
|
626
|
+
Available at: <a href="http://www.w3.org/TR/1998/NOTE-datetime-19980827">http://www.w3.org/TR/1998/NOTE-datetime-19980827</a></dd>
|
|
627
|
+
|
|
628
|
+
<dt>[<a name="ref-zip" id="ref-zip">ZIP</a>]</dt>
|
|
629
|
+
<dd><cite><a href="http://www.pkware.com/documents/casestudies/APPNOTE.TXT">.ZIP File Format Specification</a></cite>. Application Note. Version 6.3.3.
|
|
630
|
+
PKWARE Inc., September 1, 2012.
|
|
631
|
+
Available at: <a href="http://www.pkware.com/documents/casestudies/APPNOTE.TXT"> http://www.pkware.com/documents/casestudies/APPNOTE.TXT</a></dd>
|
|
632
|
+
|
|
633
|
+
</dl>
|
|
634
|
+
|
|
635
|
+
|
|
636
|
+
<h2>3. <a name="Definitions">Definitions</a></h2>
|
|
637
|
+
|
|
638
|
+
<p>
|
|
639
|
+
The following terms, as used in this standard, have the meanings indicated.
|
|
640
|
+
</p>
|
|
641
|
+
|
|
642
|
+
<a name="tab_1"></a>
|
|
643
|
+
<table class="namespace-table" summary="Definitions">
|
|
644
|
+
<tbody><tr class="top">
|
|
645
|
+
<th class="left">Term</th><th class="left">Definition</th>
|
|
646
|
+
</tr>
|
|
647
|
+
<tr class="odd">
|
|
648
|
+
<td class="left">Source</td>
|
|
649
|
+
<td class="left">A server that hosts resources subject to synchronization</td>
|
|
650
|
+
</tr>
|
|
651
|
+
<tr class="odd">
|
|
652
|
+
<td class="left">Destination</td>
|
|
653
|
+
<td class="left">A system that synchronizes itself with the Source's resources</td>
|
|
654
|
+
</tr>
|
|
655
|
+
<tr class="odd">
|
|
656
|
+
<td class="left">set of resources</td>
|
|
657
|
+
<td class="left">A collection of resources that is made available for synchronization by a
|
|
658
|
+
Source. A Source may expose one or more such collections and support distinct
|
|
659
|
+
ResourceSync capabilities for each. Individual resources may be included in
|
|
660
|
+
more than one set of resources</td>
|
|
661
|
+
</tr>
|
|
662
|
+
</tbody></table>
|
|
663
|
+
|
|
664
|
+
<p>This specification uses the terms <i>resource</i>, <i>representation</i>, <i>request</i>,
|
|
665
|
+
<i>response</i>, <i>content negotiation</i>, <i>client</i>, and <i>server</i> as
|
|
666
|
+
described in <a href="#ref-webarch">Architecture of the World Wide Web</a>.</p>
|
|
667
|
+
|
|
668
|
+
|
|
669
|
+
<h2>4. <a name="Namespaces">Namespace Prefix Bindings</a></h2>
|
|
670
|
+
|
|
671
|
+
<p>Throughout this document, the following namespace prefix bindings
|
|
672
|
+
are used:</p>
|
|
673
|
+
|
|
674
|
+
<a name="tab_1"></a>
|
|
675
|
+
<table class="namespace-table" summary="Namespaces used in this document">
|
|
676
|
+
<tbody><tr class="top">
|
|
677
|
+
<th class="left">Prefix</th><th class="center">Namespace URI</th><th class="right">Description</th>
|
|
678
|
+
</tr>
|
|
679
|
+
<tr class="odd">
|
|
680
|
+
<td class="left"></td><td class="center"><code>http://www.sitemaps.org/schemas/sitemap/0.9</code></td>
|
|
681
|
+
<td class="right">Sitemap XML elements defined in the <a href="#ref-sitemaps">Sitemap protocol</a></td>
|
|
682
|
+
</tr>
|
|
683
|
+
<tr class="even">
|
|
684
|
+
<td class="left"><code>rs</code></td><td class="center"><code>http://www.openarchives.org/rs/terms/</code></td>
|
|
685
|
+
<td class="right">Namespace for elements introduced in this specification</td>
|
|
686
|
+
</tr>
|
|
687
|
+
</tbody></table>
|
|
688
|
+
|
|
689
|
+
|
|
690
|
+
<h2>5. <a name="SyncProcesses">Synchronization Processes</a></h2>
|
|
691
|
+
|
|
692
|
+
<p>
|
|
693
|
+
<a href="#Walkthrough">Section 1.3</a> provides a concrete walkthrough of some
|
|
694
|
+
capabilities that a Source may implement and describes how a
|
|
695
|
+
Destination may use those capabilities to remain synchronized with
|
|
696
|
+
the Source's changing data. This section provides a high-level
|
|
697
|
+
overview of the various ResourceSync capabilities and shows how
|
|
698
|
+
these fit into processes at a Destination designed to keep it in
|
|
699
|
+
step with changes.
|
|
700
|
+
</p>
|
|
701
|
+
|
|
702
|
+
<h3>5.1 <a name="SourcePers">Source Perspective</a></h3>
|
|
703
|
+
|
|
704
|
+
<p>From the perspective of a <b>Source</b>, the ResourceSync capabilities
|
|
705
|
+
that may be supported to enable Destination processes to remain in
|
|
706
|
+
sync with its changing data are summarized as follows:
|
|
707
|
+
</p>
|
|
708
|
+
|
|
709
|
+
<ul>
|
|
710
|
+
<li><b>Describing Content</b> -- In order to describe its data, a
|
|
711
|
+
Source may maintain an up-to-date <b>Resource List</b>. A
|
|
712
|
+
basic Resource List minimally provides the URIs of resources
|
|
713
|
+
that the Source makes available for synchronization. However,
|
|
714
|
+
additional information may be added to the Resource List to optimize
|
|
715
|
+
the Destination's process of obtaining the Source's resources,
|
|
716
|
+
including the most recent modification time of resources and fixity
|
|
717
|
+
information such as content-based checksum or hash and length.
|
|
718
|
+
<a href="#fig_source_perspective">Figure 1</a> shows a Source
|
|
719
|
+
publishing up-to-date Resource Lists at times t2 and t4. At t4,
|
|
720
|
+
too many resources need to be listed to fit in a single
|
|
721
|
+
Resource List and hence multiple Resource Lists are published and
|
|
722
|
+
grouped in a Resource List Index.
|
|
723
|
+
</li>
|
|
724
|
+
<li><b>Packaging Content</b> -- In order to make its data available for
|
|
725
|
+
download, a Source may recurrently make an up-to-date <b>Resource Dump</b>
|
|
726
|
+
of its content available. A Resource Dump points at one or more packages,
|
|
727
|
+
each of which contains bitstreams associated with resources hosted by the Source.
|
|
728
|
+
Each package also contains a <b>Resource Dump Manifest</b> that provides
|
|
729
|
+
metadata about the bitstreams contained in the package, and must minimally
|
|
730
|
+
include their associated URI and their file path in the ZIP file.
|
|
731
|
+
<a href="#fig_source_perspective">Figure 1</a> shows a Source publishing
|
|
732
|
+
up-to-date Resource Dumps at times t1 and t3. At time t3, multiple
|
|
733
|
+
Resource Dumps are published and grouped in a Resource Dump Index.
|
|
734
|
+
</li>
|
|
735
|
+
<li><b>Describing Changes</b> -- In order to achieve lower
|
|
736
|
+
synchronization latency and/or to improve transfer efficiency,
|
|
737
|
+
a Source may publish a Change List that provides information about
|
|
738
|
+
changes to its resources. It is up to the Source to decide the temporal
|
|
739
|
+
interval covered by a Change List, for example, all the changes
|
|
740
|
+
that occurred during the previous hour, the current day, or since
|
|
741
|
+
the most recent publication of a Resource List. For each resource
|
|
742
|
+
change, a Change List must minimally convey the URI of the changed
|
|
743
|
+
resource as well as the nature of the change (create,
|
|
744
|
+
update, delete). Since a Change List is organized on the basis of
|
|
745
|
+
changes, it may list the same resource multiple times, once per change.
|
|
746
|
+
<a href="#fig_source_perspective">Figure 2</a> shows three Change Lists.
|
|
747
|
+
The first Change List covers resource changes that occurred between
|
|
748
|
+
t1 and t3, the second between t3 and t5, and the third between t5 and t7.
|
|
749
|
+
Since too many changes occurred between t5 and t7 to fit in a single
|
|
750
|
+
Change List, multiple Change Lists are published and grouped in a
|
|
751
|
+
Change List Index.
|
|
752
|
+
</li>
|
|
753
|
+
<li><b>Packaging Changes</b> -- In order to make content changes available for download,
|
|
754
|
+
a Source may publish a <b>Change Dump</b>. A Change Dump points at one or more packages,
|
|
755
|
+
each of which contains bitstreams that correspond to the state of resources after they changed.
|
|
756
|
+
Each package also contains a <b>Change Dump Manifest</b> that provides metadata about the
|
|
757
|
+
bitstreams provided in the Change Dump.
|
|
758
|
+
For each bitstream, the Change Dump Manifest must minimally include the associated URI,
|
|
759
|
+
the nature of the change (create, update, delete) and, where appropriate, the file
|
|
760
|
+
path of the bitstream in the ZIP file.
|
|
761
|
+
It is up to a Source to decide the temporal interval covered by a
|
|
762
|
+
Change Dump, for example, covering all the resource changes that occurred during the
|
|
763
|
+
previous hour, the current day, or since the most recent publication
|
|
764
|
+
of a Resource Dump. Since a Change Dump is organized on the basis of changes,
|
|
765
|
+
the package(s) it points at may contain multiple bitstreams associated with any given
|
|
766
|
+
resource, one per change. <a href="#fig_source_perspective">Figure 2</a>
|
|
767
|
+
shows three Change Dumps. The first Change Dump covers resource changes
|
|
768
|
+
that occurred between t2 and t4, the second between t4 and t6, and the third
|
|
769
|
+
between t6 and t8. During the time period between t6 and t8, multiple
|
|
770
|
+
Change Dumps are published and grouped in a Change Dump Index.
|
|
771
|
+
</li>
|
|
772
|
+
<li><b>Linking to Related Resources</b> -- There are several reasons to
|
|
773
|
+
provide additional links from a resource subject to synchronization to
|
|
774
|
+
related resources, including:
|
|
775
|
+
<ul>
|
|
776
|
+
<li><b>Alternate Content Transfer</b> -- The default mechanisms by which a Destination obtains
|
|
777
|
+
content for a resource are to issue an HTTP GET against its URI found
|
|
778
|
+
in a Resource List or Change List, or to unpack packages obtained via a
|
|
779
|
+
Resource Dump or Change Dump. However, additional approaches may also be supported.
|
|
780
|
+
For example, a Source may prefer, for synchronization purposes, that
|
|
781
|
+
content be obtained from a mirror server and hence from a different
|
|
782
|
+
URI. Also, a Source may allow obtaining only the changes that a
|
|
783
|
+
resource underwent, instead of the entire changed resource.
|
|
784
|
+
This may be desirable when the resource size is considerable and/or the
|
|
785
|
+
frequency of changes high. Such an Alternate Content Transfer approach
|
|
786
|
+
is expressed by means of a link from the resource to another resource that
|
|
787
|
+
makes the content available in an alternate way. It is possible that certain
|
|
788
|
+
Destinations do not recognize a specific Alternate Content Transfer approach,
|
|
789
|
+
in which case ignoring the link and dereferencing the resource's URI remains
|
|
790
|
+
the fallback approach.</li>
|
|
791
|
+
<li><b>Resources and Metadata about Resources</b> -- Cases exist where both resources and
|
|
792
|
+
metadata about resources must be synchronized, for example, a collection of scientific
|
|
793
|
+
publications and metadata describing each. From the ResourceSync perspective, both the
|
|
794
|
+
resource and the metadata about it are regarded as resources with distinct URIs that
|
|
795
|
+
are subject to synchronization. Their inter-relationship is expressed by means of links
|
|
796
|
+
with appropriate relation types.</li>
|
|
797
|
+
<li><b>Prior Versions of Resources</b> -- In some cases a Destination requires a copy of
|
|
798
|
+
each version of a resource, not just the most recent one.
|
|
799
|
+
A Source may support discovery and access to prior resource versions through links.
|
|
800
|
+
Three approaches are provided, one based on linking to
|
|
801
|
+
resource versions, and two that leverage features of the
|
|
802
|
+
<a href="#ref-rfc7089">Memento</a> protocol for time-based
|
|
803
|
+
access to resource states.</li>
|
|
804
|
+
</ul>
|
|
805
|
+
</li>
|
|
806
|
+
</ul>
|
|
807
|
+
|
|
808
|
+
<div class="image">
|
|
809
|
+
<a name="fig_source_perspective"></a>
|
|
810
|
+
<img alt="ResourceSync Source Perspective" src="img/resync_source_perspective.png"/>
|
|
811
|
+
<p class="caption">Figure 1: ResourceSync Source perspective of resource description</p>
|
|
812
|
+
</div>
|
|
813
|
+
|
|
814
|
+
<div class="image">
|
|
815
|
+
<a name="fig_source_perspective"></a>
|
|
816
|
+
<!--FIXME-->
|
|
817
|
+
<p class="caption">Figure 2: ResourceSync Source perspective of change description</p>
|
|
818
|
+
</div>
|
|
819
|
+
|
|
820
|
+
<h3>5.2 <a name="DestPers">Destination Perspective</a></h3>
|
|
821
|
+
|
|
822
|
+
<p>From the perspective of a <b>Destination</b>, three key processes are enabled by the ResourceSync capabilities; <a href="#fig_destination_perspective">Figure 3</a>
|
|
823
|
+
provides an overview:</p>
|
|
824
|
+
|
|
825
|
+
<ul>
|
|
826
|
+
<li><b>Baseline Synchronization</b> -- In order to become synchronized with
|
|
827
|
+
a Source, the Destination must make an initial copy of the Source's data.
|
|
828
|
+
A Destination may obtain the Resource List that conveys the URIs of
|
|
829
|
+
the Source's resources, and subsequently dereference those URIs one by one.
|
|
830
|
+
A Destination may also obtain a Resource Dump that conveys the URIs of one
|
|
831
|
+
or more content packages each of which contains bitstreams associated
|
|
832
|
+
with the Source's resources. A Destination may dereference those URIs
|
|
833
|
+
and subsequently unpack the retrieved content packages, guided by the
|
|
834
|
+
contained Resource Dump Manifest.
|
|
835
|
+
</li>
|
|
836
|
+
<li><b>Incremental Synchronization</b> -- A Destination may remain in
|
|
837
|
+
sync with a Source by repeatedly performing a Baseline Synchronization.
|
|
838
|
+
To increase efficiency and decrease latency, a
|
|
839
|
+
Source may communicate information about changes to its resources via Change Lists.
|
|
840
|
+
This allows a Destination to obtain up-to-date content by dereferencing the
|
|
841
|
+
URIs of newly created and updated resources listed in the Change List.
|
|
842
|
+
It also allows a Destination to remove its copies of deleted resources, if needed.
|
|
843
|
+
A Source may also make a Change Dump available that points at one or more packages,
|
|
844
|
+
each of which contains bitstreams that correspond to the state of resources after they changed.
|
|
845
|
+
In this case the Destination first obtains the Change Dump, then obtains the
|
|
846
|
+
package(s) by dereferencing the URI(s) listed in the Change Dump, and
|
|
847
|
+
subsequently unpacks those, guided by the contained Change Dump Manifest.
|
|
848
|
+
</li>
|
|
849
|
+
<li><b>Audit</b> -- In order to verify whether it is in sync
|
|
850
|
+
with the Source, a Destination must be able to check that the content
|
|
851
|
+
it obtained matches the current resources hosted by the Source both regarding coverage and accuracy. This requires an up-to-date
|
|
852
|
+
list of resources hosted by the Source, which may be compiled on the basis of a Resource List and Change Lists. It also requires these Lists to contain metadata
|
|
853
|
+
per resource that characterizes its most recent state, such
|
|
854
|
+
as last modification time, length, and content-based hash.
|
|
855
|
+
</li>
|
|
856
|
+
</ul>
|
|
857
|
+
|
|
858
|
+
<div class="image">
|
|
859
|
+
<a name="fig_destination_perspective"></a>
|
|
860
|
+
<img alt="ResourceSync Destination Perspective" src="img/resync_destination_perspective.png"/>
|
|
861
|
+
<p class="caption">Figure 3: ResourceSync Destination perspective</p>
|
|
862
|
+
</div>
|
|
863
|
+
|
|
864
|
+
<h3>5.3 <a name="Summary">Summary</a></h3>
|
|
865
|
+
|
|
866
|
+
<p>
|
|
867
|
+
<a href="#tab_1">Table 1</a> provides a summary of
|
|
868
|
+
<a href="#SyncProcesses">Section 5</a>. The table lists Destination processes
|
|
869
|
+
as columns and Source capabilities as rows, with cells indicating the
|
|
870
|
+
applicability of a capability for a given process.
|
|
871
|
+
</p>
|
|
872
|
+
|
|
873
|
+
<!--TABLE:tab_1.xml-->
|
|
874
|
+
<a name="tab_1"></a>
|
|
875
|
+
<table class="capability-table" summary="Source Capabilities versus
|
|
876
|
+
Destination Processes">
|
|
877
|
+
<tbody><tr class="top">
|
|
878
|
+
<th>Source Capabilities</th><th colspan="3">Destination Processes</th>
|
|
879
|
+
</tr>
|
|
880
|
+
<tr class="top">
|
|
881
|
+
<th> </th><th>Baseline Synchronization</th><th>Incremental Synchronization</th><th>Audit</th>
|
|
882
|
+
</tr>
|
|
883
|
+
<tr class="odd">
|
|
884
|
+
<td class="scap"><a href="#SourceDesc">Describing the Source</a></td><td class="sync">X</td><td class="sync">X</td><td class="audit">X</td>
|
|
885
|
+
</tr>
|
|
886
|
+
<tr class="odd">
|
|
887
|
+
<td class="scap"><a href="#CapabilityList">Advertising Capabilities</a></td><td class="sync">X</td><td class="sync">X</td><td class="audit">X</td>
|
|
888
|
+
</tr>
|
|
889
|
+
<tr class="odd">
|
|
890
|
+
<td class="scap"><a href="#DescResources">Describing Resources</a></td><td colspan="3" class="sync"> </td><!--td class="sync"> </td><td class="audit"> </td-->
|
|
891
|
+
</tr>
|
|
892
|
+
<tr class="even">
|
|
893
|
+
<td class="scap"> <a href="#ResourceList">Resource List</a></td><td class="sync">X</td><td class="sync"> </td><td class="audit">X</td>
|
|
894
|
+
</tr>
|
|
895
|
+
<tr class="odd">
|
|
896
|
+
<td class="scap"><a href="#PackResources">Packaging Resources</a></td><td colspan="3" class="sync"> </td><!--td class="sync"> </td><td class="audit"> </td-->
|
|
897
|
+
</tr>
|
|
898
|
+
<tr class="even">
|
|
899
|
+
<td class="scap"> <a href="#ResourceDump">Resource Dump</a></td><td class="sync">X</td><td class="sync"> </td><td class="audit"></td>
|
|
900
|
+
</tr>
|
|
901
|
+
<tr class="odd">
|
|
902
|
+
<td class="scap"><a href="#DesChanges">Describing Changes</a></td><td colspan="3" class="sync"> </td><!--td class="sync"> </td><td class="audit"> </td-->
|
|
903
|
+
</tr>
|
|
904
|
+
<tr class="even">
|
|
905
|
+
<td class="scap"> <a href="#ChangeList">Change List</a></td><td class="sync"> </td><td class="sync">X</td><td class="audit">X</td>
|
|
906
|
+
</tr>
|
|
907
|
+
<tr class="odd">
|
|
908
|
+
<td class="scap"><a href="#PackChanges">Packaging Changes</a></td><td colspan="3" class="sync"> </td><!--td class="sync"> </td><td class="audit"> </td-->
|
|
909
|
+
</tr>
|
|
910
|
+
<tr class="even">
|
|
911
|
+
<td class="scap"> <a href="#ChangeDump">Change Dump</a></td><td class="sync"> </td><td class="sync">X</td><td class="audit"> </td>
|
|
912
|
+
</tr>
|
|
913
|
+
<tr class="odd">
|
|
914
|
+
<td class="scap"><a href="#LinkRelRes">Linking to Related Resources</a></td><td colspan="3" class="sync"> </td><!--td class="sync"> </td><td class="audit"> </td-->
|
|
915
|
+
</tr>
|
|
916
|
+
<tr class="even">
|
|
917
|
+
<td class="scap"> <a href="#MirCon">Mirrored Content</a></td><td class="sync">X</td><td class="sync">X</td><td class="audit">X</td>
|
|
918
|
+
</tr>
|
|
919
|
+
<tr class="even">
|
|
920
|
+
<td class="scap"> <a href="#AltRep">Alternate Representations</a></td><td class="sync">X</td><td class="sync">X</td><td class="audit">X</td>
|
|
921
|
+
</tr>
|
|
922
|
+
<tr class="even">
|
|
923
|
+
<td class="scap"> <a href="#PatchCon">Patching Content</a></td><td class="sync"> </td><td class="sync">X</td><td class="audit">X</td>
|
|
924
|
+
</tr>
|
|
925
|
+
<tr class="even">
|
|
926
|
+
<td class="scap"> <a href="#ResMDLinking">Resources and Metadata about Resources</a></td><td class="sync">X</td><td class="sync">X</td><td class="audit">X</td>
|
|
927
|
+
</tr>
|
|
928
|
+
<tr class="even">
|
|
929
|
+
<td class="scap"> <a href="#ResVers">Prior Versions of Resources</a></td><td class="sync"></td><td class="sync">X</td><td class="audit">X</td>
|
|
930
|
+
</tr>
|
|
931
|
+
<tr class="even">
|
|
932
|
+
<td class="scap"> <a href="#ColMem">Collection Membership</a></td><td class="sync">X</td><td class="sync">X</td><td class="audit">X</td>
|
|
933
|
+
</tr>
|
|
934
|
+
<tr class="even">
|
|
935
|
+
<td class="scap"> <a href="#RePub">Republishing Resources</a></td><td class="sync">X</td><td class="sync">X</td><td class="audit">X</td>
|
|
936
|
+
</tr>
|
|
937
|
+
</tbody></table>
|
|
938
|
+
<p class="caption">Table 1: Source capabilities versus Destination processes</p>
|
|
939
|
+
<!--/TABLE:tab_1.xml-->
|
|
940
|
+
|
|
941
|
+
|
|
942
|
+
<h2>6. <a name="FrameworkOrg">Framework Organization</a></h2>
|
|
943
|
+
|
|
944
|
+
<h3>6.1 <a name="Structure">Structure</a></h3>
|
|
945
|
+
<p>
|
|
946
|
+
All capabilities in the ResourceSync framework are implemented on the basis of the
|
|
947
|
+
<code><urlset></code> and <code><sitemapindex></code>
|
|
948
|
+
Sitemap document formats.
|
|
949
|
+
<a href="#fig_framework_structure">Figure 4: ResourceSync framework structure</a>,
|
|
950
|
+
depicts the overall structure of the set of documents that is used:
|
|
951
|
+
</p>
|
|
952
|
+
|
|
953
|
+
<ul>
|
|
954
|
+
<li>
|
|
955
|
+
At the top of the picture is the mandatory Source Description. It is a
|
|
956
|
+
Destination's typical entry point to learn about a Source's ResourceSync
|
|
957
|
+
implementation. The Source Description enumerates all Capability Lists
|
|
958
|
+
offered by the Source, one Capability List per set of resources.
|
|
959
|
+
If the Source only offers one set of resources, the ResourceSync
|
|
960
|
+
Description contains a single pointer.
|
|
961
|
+
A Source Description is expressed as a <code><urlset></code>
|
|
962
|
+
document and, per Capability List, a <code><url></code> element
|
|
963
|
+
is introduced. The <code><loc></code> child element of <code><url></code>
|
|
964
|
+
contains the URI of the Capability List, and the <code>capabilitylist</code> value for
|
|
965
|
+
the <code>capability</code> attribute of the <code><rs:md></code>
|
|
966
|
+
child element of <code><url></code>
|
|
967
|
+
makes clear that the URI is that of a Capability List.
|
|
968
|
+
</li>
|
|
969
|
+
<li>A Capability List enumerates all capabilities supported for a set of the Source's resources.
|
|
970
|
+
The capabilities defined in this ResourceSync specification are
|
|
971
|
+
Resource List, Change List, Resource Dump, and Change Dump. Additional capabilities may be defined
|
|
972
|
+
in other specifications.
|
|
973
|
+
A Capability List is expressed as a <code><urlset></code>
|
|
974
|
+
document and, for each supported capability, a <code><url></code> element is introduced. The <code><loc></code>
|
|
975
|
+
child element of
|
|
976
|
+
<code><url></code> contains the URI of the document that implements a capability, and the type of capability is expressed
|
|
977
|
+
by means of the value of the <code>capability</code> attribute of the <code><rs:md></code>
|
|
978
|
+
child element of <code><url></code>, e.g., <code>resourcelist</code> for a Resource List.</li>
|
|
979
|
+
<li>A Resource List and a Change List point at resources. A representation of a resource
|
|
980
|
+
may be obtained by dereferencing its URI, listed as the value of the
|
|
981
|
+
<code><loc></code> child element of the <code><url></code> element
|
|
982
|
+
for the resource.</li>
|
|
983
|
+
<li>A Resource Dump and a Change Dump point at packages, each of which contains bitstreams
|
|
984
|
+
associated with resources, as well as a
|
|
985
|
+
Manifest that describes the bitstreams provided in the package.</li>
|
|
986
|
+
<li>The Manifest contained in a package of bitstreams is expressed as a <code><urlset></code> document. For each bitstream contained in the package, that document
|
|
987
|
+
contains a <code><url></code> element; the <code><loc></code> child element of <code><url></code> provides
|
|
988
|
+
the URI that corresponds to the bitstream, whereas the <code>path</code> attribute of the <code><rs:md></code> child element
|
|
989
|
+
of <code><url></code> provides the path of the bitstream in the package.</li>
|
|
990
|
+
|
|
991
|
+
<li>If a single document suffices to express a Source Description, a Resource List, a Change List etc.,
|
|
992
|
+
then the <code><urlset></code> document format is used.
|
|
993
|
+
If multiple documents are required, each is expressed using the <code><urlset></code> document format, and a
|
|
994
|
+
<code><sitemapindex></code> document is introduced as an index to point at all individual <code><urlset></code> documents.
|
|
995
|
+
As a result, the URI of, for example, a Resource List provided in a Capability List may be
|
|
996
|
+
either that of a <code><urlset></code> or a <code><sitemapindex></code> document.
|
|
997
|
+
The <code><urlset></code> or <code><sitemapindex></code> documents used for a specific capability
|
|
998
|
+
(e.g., Resource List) have the same value for the
|
|
999
|
+
<code>capability</code> attribute (e.g., <code>resourcelist</code>).</li>
|
|
1000
|
+
</ul>
|
|
1001
|
+
|
|
1002
|
+
<p>
|
|
1003
|
+
The Resource List branch of <a href="#fig_framework_structure">Figure 4</a> is fully compatible with the existing
|
|
1004
|
+
Sitemap specification, whereas the other branches are extensions introduced to support resource synchronization that
|
|
1005
|
+
leverage the Sitemap document formats.
|
|
1006
|
+
</p>
|
|
1007
|
+
|
|
1008
|
+
<div class="image">
|
|
1009
|
+
<a name="fig_framework_structure"></a>
|
|
1010
|
+
<img alt="ResourceSync Framework Structure" src="img/resync_structure.png"/>
|
|
1011
|
+
<p class="caption">Figure 4: ResourceSync framework structure</p>
|
|
1012
|
+
</div>
|
|
1013
|
+
|
|
1014
|
+
<h3>6.2 <a name="Navigation">Navigation</a></h3>
|
|
1015
|
+
|
|
1016
|
+
<p>The following mechanisms are introduced to support navigating the document
|
|
1017
|
+
hierarchy described in <a href="#Structure">Section 6.1</a>;
|
|
1018
|
+
they are illustrated in <a href="#fig_navigation_up">Figure 5</a> and
|
|
1019
|
+
<a href="#fig_navigation_down">Figure 6</a>:</p>
|
|
1020
|
+
<ul>
|
|
1021
|
+
<li>A link for upward navigation is provided by means of an <code><rs:ln></code> child element of the
|
|
1022
|
+
<code><urlset></code> or <code><sitemapindex></code> element of a document. This pointer has
|
|
1023
|
+
<code>up</code> as the value for the <code>rel</code> attribute, and the URI of the document that sits higher
|
|
1024
|
+
in the hierarchy is provided as the value of the <code>href</code> attribute. Following consecutive <code>up</code>
|
|
1025
|
+
links eventually leads to the Source Description.</li>
|
|
1026
|
+
<li>A link for navigation from a document to the index under which it resides, if one exists, is
|
|
1027
|
+
provided by means of an <code><rs:ln></code> child element of the
|
|
1028
|
+
<code><urlset></code> element of the document. This pointer has
|
|
1029
|
+
<code>index</code> as the value for the <code>rel</code> attribute, and the URI of the index document
|
|
1030
|
+
is provided as the value of the <code>href</code> attribute.</li>
|
|
1031
|
+
<li>A link for downward navigation is provided by the content of a <code><url></code> element:
|
|
1032
|
+
the URI of the document that sits lower in the hierarchy is provided as the value of its <code><loc></code>
|
|
1033
|
+
child element, and its type is conveyed as the value of the <code>capability</code> attribute of the
|
|
1034
|
+
<code><rs:md></code> child element.</li>
|
|
1035
|
+
</ul>
|
|
1036
|
+
|
|
1037
|
+
<div class="image">
|
|
1038
|
+
<a name="fig_navigation_up"></a>
|
|
1039
|
+
<img alt="ResourceSync Navigation Upwards" src="img/resync_navigation_up.png"/>
|
|
1040
|
+
<p class="caption">Figure 5: ResourceSync upwards navigation</p>
|
|
1041
|
+
</div>
|
|
1042
|
+
|
|
1043
|
+
<div class="image">
|
|
1044
|
+
<a name="fig_navigation_down"></a>
|
|
1045
|
+
<img alt="ResourceSync Navigation Downwards" src="img/resync_navigation_down.png"/>
|
|
1046
|
+
<p class="caption">Figure 6: ResourceSync downwards navigation</p>
|
|
1047
|
+
</div>
|
|
1048
|
+
|
|
1049
|
+
<h3>6.3 <a name="Discovery">Discovery</a></h3>
|
|
1050
|
+
|
|
1051
|
+
<h4>6.3.1 <a name="DiscoOverview">Overview</a></h4>
|
|
1052
|
+
|
|
1053
|
+
<p>ResourceSync provides three ways for a Destination to discover
|
|
1054
|
+
whether and how a Source supports ResourceSync: a Source-wide
|
|
1055
|
+
approach detailed in <a href="#wellknown">Section 6.3.2</a>, a
|
|
1056
|
+
resource-specific approach detailed in
|
|
1057
|
+
<a href="#disco_links">Section 6.3.3</a>, and an approach that
|
|
1058
|
+
leverages the existing practice of Sitemap discovery via the
|
|
1059
|
+
<code>robots.txt</code> file described in <a href="#robots">Section 6.3.4</a>.
|
|
1060
|
+
All approaches are summarized in <a href="#fig_discovery">Figure 7</a>.
|
|
1061
|
+
</p>
|
|
1062
|
+
|
|
1063
|
+
<div class="image">
|
|
1064
|
+
<a name="fig_discovery"></a>
|
|
1065
|
+
<img alt="ResourceSync Discovery" src="img/resync_discovery.png"/>
|
|
1066
|
+
<p class="caption">Figure 7: Discovery of Source Description and Capability List</p>
|
|
1067
|
+
</div>
|
|
1068
|
+
|
|
1069
|
+
<h4>6.3.2 <a name="wellknown">ResourceSync Well-Known URI</a></h4>
|
|
1070
|
+
|
|
1071
|
+
<p>
|
|
1072
|
+
A Source must publish a Source Description, such as the one shown in
|
|
1073
|
+
<a href="#ex_7">Example 7</a>, and it should be published at the
|
|
1074
|
+
well-known URI [<a href="#ref-rfc5785">RFC 5785</a>]
|
|
1075
|
+
<code>/.well-known/resourcesync</code> as defined here.
|
|
1076
|
+
The Source Description document enumerates a Source's Capability Lists
|
|
1077
|
+
and as such is an appropriate entry
|
|
1078
|
+
point for Destinations interested in understanding a Source's capabilities.
|
|
1079
|
+
</p>
|
|
1080
|
+
|
|
1081
|
+
<h4>6.3.3 <a name="disco_links">Links</a></h4>
|
|
1082
|
+
|
|
1083
|
+
<p>
|
|
1084
|
+
A Capability List may be made discoverable by means of links provided either
|
|
1085
|
+
in an HTML document [<a href="#ref-html-links">HTML Links</a>,
|
|
1086
|
+
<a href="#ref-xhtml-links">XHTML Links</a>] or in an
|
|
1087
|
+
HTTP Link header [<a href="#ref-rfc5988">RFC 5988</a>].
|
|
1088
|
+
</p>
|
|
1089
|
+
<p>
|
|
1090
|
+
In order to include a discovery link in an HTML document,
|
|
1091
|
+
a <code><link></code> element is introduced in the <code><head></code>
|
|
1092
|
+
of the document that points to a Capability List.
|
|
1093
|
+
This <code><link></code> must have a <code>rel</code> attribute
|
|
1094
|
+
with a value of <code>resourcesync</code>.
|
|
1095
|
+
The Capability List that is made discoverable in this way must pertain to
|
|
1096
|
+
the resource that provides the link. This means that
|
|
1097
|
+
the resource must be covered by the capabilities listed in the linked Capability List.
|
|
1098
|
+
<a href="#ex_9">Example 9</a> shows the structure of a webpage that contains a
|
|
1099
|
+
link to a Capability List.
|
|
1100
|
+
</p>
|
|
1101
|
+
|
|
1102
|
+
<p>
|
|
1103
|
+
As shown in <a href="#ex_6">Example 6</a> the Source Description can
|
|
1104
|
+
be discovered from the Capability List by following the
|
|
1105
|
+
link provided in the <code><rs:ln></code> element with the relation type <code>up</code>.
|
|
1106
|
+
</p>
|
|
1107
|
+
<a name="ex_9"></a>
|
|
1108
|
+
<div class="exampleInner">
|
|
1109
|
+
<pre><html>
|
|
1110
|
+
<head>
|
|
1111
|
+
<span class="rs"><link rel="resourcesync"
|
|
1112
|
+
href="http://www.example.com/dataset1/capabilitylist.xml"/></span>
|
|
1113
|
+
...
|
|
1114
|
+
</head>
|
|
1115
|
+
<body>...</body>
|
|
1116
|
+
</html>
|
|
1117
|
+
</pre>
|
|
1118
|
+
</div>
|
|
1119
|
+
<p class="caption">Example 9: Discovery by means of an HTML link</p>
|
|
1120
|
+
|
|
1121
|
+
<p>
|
|
1122
|
+
A Capability List may also be made discoverable by means of an HTTP
|
|
1123
|
+
Link header that may be included with a representation of a resource of any
|
|
1124
|
+
content-type. In order to do so, a link is introduced in the HTTP Link header.
|
|
1125
|
+
The target of this link is the URI of a Capability List and the value of
|
|
1126
|
+
its <code>rel</code> attribute is <code>resourcesync</code>. The Capability
|
|
1127
|
+
List that is made discoverable in this way must pertain to the resource that
|
|
1128
|
+
provides the link. This means that the resource must be covered by the
|
|
1129
|
+
capabilities listed in the linked Capability List. <a href="#ex_10">Example 10</a>
|
|
1130
|
+
shows an excerpt of an HTTP response header that illustrates this approach.
|
|
1131
|
+
</p>
|
|
1132
|
+
|
|
1133
|
+
<p>
|
|
1134
|
+
As shown in <a href="#ex_6">Example 6</a> the Source Description can be
|
|
1135
|
+
discovered from the Capability List by following the link provided in the
|
|
1136
|
+
<code><rs:ln></code> element with the relation type <code>up</code>.
|
|
1137
|
+
</p>
|
|
1138
|
+
|
|
1139
|
+
<a name="ex_10"></a>
|
|
1140
|
+
<div class="exampleInner">
|
|
1141
|
+
<pre>HTTP/1.1 200 OK
|
|
1142
|
+
Date: Thu, 21 Jan 2010 00:02:12 GMT
|
|
1143
|
+
Server: Apache
|
|
1144
|
+
<span class="rs">Link: <http://www.example.com/dataset1/capabilitylist.xml>;
|
|
1145
|
+
rel="resourcesync"</span>
|
|
1146
|
+
...
|
|
1147
|
+
</pre>
|
|
1148
|
+
</div>
|
|
1149
|
+
<p class="caption">Example 10: Discovery by means of an HTTP link</p>
|
|
1150
|
+
|
|
1151
|
+
|
|
1152
|
+
<h4>6.3.4 <a name="robots">robots.txt</a></h4>
|
|
1153
|
+
<p>
|
|
1154
|
+
A Resource List is a Sitemap and hence may be made discoverable via the
|
|
1155
|
+
established approach of adding a <code>Sitemap</code> directive to a
|
|
1156
|
+
Source's <code>robots.txt</code> file that has the URI of the Resource
|
|
1157
|
+
List as its value. If a Source supports multiple sets of resources,
|
|
1158
|
+
multiple directives may be added, one for each Resource List associated
|
|
1159
|
+
with a specific set of resources. In case a Source supports both regular
|
|
1160
|
+
Sitemaps and ResourceSync Sitemaps (Resource Lists) they may be
|
|
1161
|
+
made discoverable, again, by including multiple <code>Sitemap</code>
|
|
1162
|
+
directives as shown in <a href="#ex_11">Example 11</a>.</p>
|
|
1163
|
+
|
|
1164
|
+
<p>Once a Resource List for a set of resources has been discovered
|
|
1165
|
+
in this manner, the corresponding Capability List can be discovered
|
|
1166
|
+
by following a link with the <code>up</code> relation type provided
|
|
1167
|
+
in the Resource List. Next, the Source Description can be discovered
|
|
1168
|
+
by following yet another link with the <code>up</code>
|
|
1169
|
+
relation type provided in the Capability List.
|
|
1170
|
+
</p>
|
|
1171
|
+
|
|
1172
|
+
<a name="ex_11"></a>
|
|
1173
|
+
<div class="exampleInner">
|
|
1174
|
+
<pre>User-agent: *
|
|
1175
|
+
Disallow: /cgi-bin/
|
|
1176
|
+
Disallow: /tmp/
|
|
1177
|
+
<span class="rs">Sitemap: http://example.com/dataset1/resourcelist.xml</span>
|
|
1178
|
+
</pre>
|
|
1179
|
+
</div>
|
|
1180
|
+
<p class="caption">Example 11: A <code>robots.txt</code> file that points at a Resource List</p>
|
|
1181
|
+
|
|
1182
|
+
|
|
1183
|
+
<h2>7. <a name="DocumentFormats">Sitemap Document Formats</a></h2>
|
|
1184
|
+
|
|
1185
|
+
<p>
|
|
1186
|
+
In order to convey information pertaining to resources in the ResourceSync framework,
|
|
1187
|
+
the Sitemap (root element <code><urlset></code>) and Sitemap index (root
|
|
1188
|
+
element <code><sitemapindex></code>) document formats introduced by the
|
|
1189
|
+
<a href="#ref-sitemaps">Sitemap protocol</a> are used for a variety of purposes.
|
|
1190
|
+
The <code><sitemapindex></code> document format is used when it is necessary to
|
|
1191
|
+
group multiple documents of the <code><urlset></code> format.
|
|
1192
|
+
The ResourceSync framework follows community-defined limits for when to
|
|
1193
|
+
publish multiple documents of the <code><urlset></code> format.
|
|
1194
|
+
At time of publication of this specification, the limit is 50,000 items
|
|
1195
|
+
per document and a document size of 50 MB.
|
|
1196
|
+
</p>
|
|
1197
|
+
|
|
1198
|
+
<p>
|
|
1199
|
+
The document formats, as well as their ResourceSync extension elements, are
|
|
1200
|
+
shown in <a href="#tab_2">Table 2</a>. The <code><rs:md></code>
|
|
1201
|
+
and <code><rs:ln></code> elements are introduced to express metadata
|
|
1202
|
+
and links, respectively.
|
|
1203
|
+
Both are in the ResourceSync XML Namespace and may have attributes.
|
|
1204
|
+
The attributes of these elements defined by ResourceSync are listed in
|
|
1205
|
+
<a href="#elem_intro_tab">Table 3</a> and detailed below. As shown in
|
|
1206
|
+
the examples, these attributes must not have an XML Namespace prefix.
|
|
1207
|
+
The <code><rs:ln></code> element as well as several of the
|
|
1208
|
+
ResourceSync attributes are based upon other specifications and in those
|
|
1209
|
+
cases inherit the semantics defined there; the "Specification" column of
|
|
1210
|
+
<a href="#elem_intro_tab">Table 3</a> refers to those specifications.
|
|
1211
|
+
Communities may introduce additional attributes when needed but must use
|
|
1212
|
+
an XML Namespace other than that of ResourceSync and must appropriately use
|
|
1213
|
+
namespace prefixes for those attributes.
|
|
1214
|
+
</p>
|
|
1215
|
+
|
|
1216
|
+
<a name="tab_2"></a>
|
|
1217
|
+
<table class="elem_intro-table" summary="Sitemap document formats">
|
|
1218
|
+
<tbody><tr class="top">
|
|
1219
|
+
<th>Sitemap</th><th>Sitemap Index</th>
|
|
1220
|
+
</tr>
|
|
1221
|
+
<tr class="even">
|
|
1222
|
+
<td class="left">
|
|
1223
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
1224
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
1225
|
+
<span class="rs">xmlns:rs="http://www.openarchives.org/rs/terms/"</span>>
|
|
1226
|
+
<span class="rs"><rs:md /></span>
|
|
1227
|
+
<span class="rs"><rs:ln /></span>
|
|
1228
|
+
<url>
|
|
1229
|
+
<loc />
|
|
1230
|
+
<span class="rs"><rs:md /></span>
|
|
1231
|
+
<span class="rs"><rs:ln /></span>
|
|
1232
|
+
</url>
|
|
1233
|
+
<url>
|
|
1234
|
+
...
|
|
1235
|
+
</url>
|
|
1236
|
+
</urlset>
|
|
1237
|
+
</pre>
|
|
1238
|
+
</td>
|
|
1239
|
+
<td class="left">
|
|
1240
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
1241
|
+
<sitemapindex xmlns="..."
|
|
1242
|
+
<span class="rs">xmlns:rs="..."</span>>
|
|
1243
|
+
<span class="rs"><rs:md /></span>
|
|
1244
|
+
<span class="rs"><rs:ln /></span>
|
|
1245
|
+
<sitemap>
|
|
1246
|
+
<loc />
|
|
1247
|
+
<span class="rs"><rs:md /></span>
|
|
1248
|
+
<span class="rs"><rs:ln /></span>
|
|
1249
|
+
</sitemap>
|
|
1250
|
+
<sitemap>
|
|
1251
|
+
...
|
|
1252
|
+
</sitemap>
|
|
1253
|
+
</sitemapindex>
|
|
1254
|
+
</pre>
|
|
1255
|
+
</td>
|
|
1256
|
+
</tr>
|
|
1257
|
+
</tbody></table>
|
|
1258
|
+
<p class="caption">Table 2: The Sitemap document formats including the ResourceSync extensions</p>
|
|
1259
|
+
|
|
1260
|
+
<p>The overall structure of the ResourceSync documents is as follows:</p>
|
|
1261
|
+
|
|
1262
|
+
<p><code><urlset></code> or <code><sitemapindex></code> -- These
|
|
1263
|
+
elements are the root elements of ResourceSync documents; this specification
|
|
1264
|
+
adds one mandatory and one optional child element to the child elements of
|
|
1265
|
+
the Sitemap document formats:</p>
|
|
1266
|
+
<ul>
|
|
1267
|
+
<li><code><rs:md></code> -- In this context, the element conveys information about the document itself. Its use is
|
|
1268
|
+
mandatory and it may have the following attributes:
|
|
1269
|
+
<ul>
|
|
1270
|
+
<li><code>at</code> -- This attribute is used for Resource Lists, Resource List Indexes,
|
|
1271
|
+
Resource Dumps, Resource Dump Indexes, and Resource Dump Manifests; it is
|
|
1272
|
+
not used for Change Lists, Change List Indexes, Change Dumps, Change Dump
|
|
1273
|
+
Indexes, and Change Dump Manifests. Required use of the attribute is detailed in the
|
|
1274
|
+
sections describing the respective documents and summarized in <a href="#TimeAttributeReqs">Appendix A</a>.
|
|
1275
|
+
The <code>at</code> attribute conveys the datetime at which the process of taking
|
|
1276
|
+
a snapshot of resources for their inclusion in the document to which the
|
|
1277
|
+
attribute pertains started.
|
|
1278
|
+
It thus provides a guarantee that each resource state represented in the document is
|
|
1279
|
+
the result of all changes to the resource at least up until the
|
|
1280
|
+
datetime expressed as the value of the <code>at</code> attribute.
|
|
1281
|
+
The attribute value is expressed as a <a href="#w3c-datetime">W3C Datetime</a> and the
|
|
1282
|
+
use of a complete date and time expressed in UTC using the format <code>YYYY-MM-DDThh:mm:ss[.s]Z</code> is recommended.
|
|
1283
|
+
The attribute represents the time of a snapshot
|
|
1284
|
+
such as t1, t2, t3, and t4 of <a href="#fig_source_perspective">Figure 1</a>.
|
|
1285
|
+
</li>
|
|
1286
|
+
<li><code>capability</code> -- This attribute is mandatory in all ResourceSync documents. The value of the attribute conveys the nature of the document,
|
|
1287
|
+
e.g., whether the document is a Resource List, a Change List, a Manifest, etc.
|
|
1288
|
+
Defined values are <code>resourcelist</code>, <code>changelist</code>, <code>resourcedump</code>, <code>changedump</code>, <code>resourcedump-manifest</code>,
|
|
1289
|
+
<code>changedump-manifest</code>, <code>capabilitylist</code>, and <code>description</code>.
|
|
1290
|
+
</li>
|
|
1291
|
+
<li><code>completed</code> -- This optional attribute is used for Resource Lists,
|
|
1292
|
+
Resource List Indexes,
|
|
1293
|
+
Resource Dumps, Resource Dump Indexes, and Resource Dump Manifests; it is
|
|
1294
|
+
not used for Change Lists, Change List Indexes, Change Dumps, Change Dump
|
|
1295
|
+
Indexes, and Change Dump Manifests.
|
|
1296
|
+
The <code>completed</code> attribute conveys the datetime at which the process of taking
|
|
1297
|
+
a snapshot of resources for their inclusion in the document to which the attribute pertains completed.
|
|
1298
|
+
The combination of the datetimes provided in the <code>at</code> and <code>completed</code> attributes
|
|
1299
|
+
expresses an interval during which resources may have changed beyond the state they had at the datetime
|
|
1300
|
+
expressed in the <code>at</code> attribute.
|
|
1301
|
+
The attribute value for <code>completed</code> is expressed as a <a href="#w3c-datetime">W3C Datetime</a> and the
|
|
1302
|
+
use of a complete date and time expressed in UTC using the format <code>YYYY-MM-DDThh:mm:ss[.s]Z</code> is recommended.
|
|
1303
|
+
</li>
|
|
1304
|
+
<li><code>from</code> -- This attribute is used for Change Lists, Change List Indexes,
|
|
1305
|
+
Change Dumps, Change Dump Indexes, and Change Dump Manifests; it is not used
|
|
1306
|
+
for Resource Lists, Resource List Indexes, Resource Dumps, Resource Dump Indexes,
|
|
1307
|
+
and Resource Dump Manifests. Required use of the attribute is detailed in
|
|
1308
|
+
the sections describing the respective documents and summarized in
|
|
1309
|
+
<a href="#TimeAttributeReqs">Appendix A</a>.
|
|
1310
|
+
The attribute indicates that all changes that occurred to the set of resources at the Source
|
|
1311
|
+
since the datetime expressed (and up until the datetime expressed in the <code>until</code>
|
|
1312
|
+
attribute, if it exists) are included in the document to which the attribute pertains.
|
|
1313
|
+
The attribute value is expressed as a <a href="#w3c-datetime">W3C Datetime</a> and the
|
|
1314
|
+
use of a complete date and time expressed in UTC using the format <code>YYYY-MM-DDThh:mm:ss[.s]Z</code> is recommended.
|
|
1315
|
+
For example, the first Change List in
|
|
1316
|
+
<a href="#fig_source_perspective">Figure 2</a> would have a <code>from</code> value of t1, and the second Change List would have a <code>from</code>
|
|
1317
|
+
value of t3.
|
|
1318
|
+
</li>
|
|
1319
|
+
<li><code>until</code> -- This optional attribute is used for Change Lists, Change List Indexes, Change Dumps,
|
|
1320
|
+
Change Dump Indexes, and Change Dump Manifests; it is not used for Resource Lists,
|
|
1321
|
+
Resource List Indexes, Resource Dumps, Resource Dump Indexes, and Resource Dump Manifests.
|
|
1322
|
+
The attribute indicates that all changes that occurred to the set of resource at the Source
|
|
1323
|
+
up until the datetime expressed are included in the document to which the attribute pertains.
|
|
1324
|
+
<ul>
|
|
1325
|
+
<li>When a document carries the <code>until</code> attribute, this indicates that
|
|
1326
|
+
the document will not be updated anymore.</li>
|
|
1327
|
+
<li>When a change document does not carry the <code>until</code> attribute, any
|
|
1328
|
+
subsequent changes to the corresponding set of resources will cause the document
|
|
1329
|
+
to be updated.</li>
|
|
1330
|
+
</ul>
|
|
1331
|
+
The attribute value is expressed as a <a href="#w3c-datetime">W3C Datetime</a> and the
|
|
1332
|
+
use of a complete date and time expressed in UTC using the format <code>YYYY-MM-DDThh:mm:ss[.s]Z</code> is recommended.
|
|
1333
|
+
For example, the first Change List in <a href="#fig_source_perspective">Figure 2</a> would have an <code>until</code> value of t3 and the second
|
|
1334
|
+
Change List would have an <code>until</code> value of t5.
|
|
1335
|
+
</li>
|
|
1336
|
+
</ul>
|
|
1337
|
+
</li>
|
|
1338
|
+
<li>
|
|
1339
|
+
<code><rs:ln></code> -- A repeatable element used to support discovery of other
|
|
1340
|
+
documents by means of a link. Required use of the element is detailed in the sections
|
|
1341
|
+
that describe the documents in which <code><rs:ln></code> is used. It may have
|
|
1342
|
+
several attributes and the ones defined by ResourceSync are as follows:
|
|
1343
|
+
<ul>
|
|
1344
|
+
<li><code>href</code> -- A mandatory attribute to convey the URI of the other document.</li>
|
|
1345
|
+
<li><code>rel</code> -- A mandatory attribute to express a relationship. The following values are explicitly used in this specification:
|
|
1346
|
+
<ul>
|
|
1347
|
+
<li><code>describedby</code> -- for linking from a Capability List to a document that describes the set of resources
|
|
1348
|
+
covered by it, and from a Source Description to a document that describes the Source.</li>
|
|
1349
|
+
<li><code>up</code> -- for linking from a Capability List to the Source Description and from a
|
|
1350
|
+
document that conveys a capability, such as a Resource List, to the Capability List under which it resides.
|
|
1351
|
+
</li>
|
|
1352
|
+
<li><code>index</code> -- for linking from a document that conveys a capability (e.g., a Resource List)
|
|
1353
|
+
to a parent index document (e.g., a Resource List Index).</li>
|
|
1354
|
+
</ul>
|
|
1355
|
+
</li>
|
|
1356
|
+
</ul>
|
|
1357
|
+
</li>
|
|
1358
|
+
|
|
1359
|
+
<li><code><url></code> or <code><sitemap></code> -- The <code><urlset></code> element has zero or more
|
|
1360
|
+
<code><url></code> child elements, and the
|
|
1361
|
+
<code><sitemapindex></code> element has zero or more <code><sitemap></code> child elements. Each such child element is used to convey information about
|
|
1362
|
+
a resource that plays a role in the ResourceSync framework. They may have the
|
|
1363
|
+
following child elements:
|
|
1364
|
+
<ul>
|
|
1365
|
+
<li><code><loc></code> -- A mandatory element that conveys the URI of the resource that plays a role in the ResourceSync framework.</li>
|
|
1366
|
+
<li><code><lastmod></code> -- An element that conveys the last
|
|
1367
|
+
modification time of the resource with the URI provided in <code><loc></code>,
|
|
1368
|
+
as defined in <a href="#ref-rfc2616">RFC 2616, Sec. 14.29</a>. The value is expressed
|
|
1369
|
+
as a <a href="#w3c-datetime">W3C Datetime</a> as described earlier in this section.
|
|
1370
|
+
The use of <code><lastmod></code> is optional in all ResourceSync documents.
|
|
1371
|
+
Note that there is significant variation in practices for the use and maintenance
|
|
1372
|
+
of last modification times, the time expressed may not correspond with the
|
|
1373
|
+
<code>datetime</code> of the last ResourceSync change event, or fall within the
|
|
1374
|
+
<code>from</code> and <code>until</code> datetimes of a Change List or Change Dump
|
|
1375
|
+
Manifest that includes the resource.</li>
|
|
1376
|
+
<li><code><changefreq></code> -- An optional element that provides a hint about the change frequency
|
|
1377
|
+
of the resource with the URI provided in <code><loc></code>. Defined values are <code>always</code>, <code>hourly</code>,
|
|
1378
|
+
<code>daily</code>, <code>weekly</code>, <code>monthly</code>, <code>yearly</code>, and <code>never</code>.
|
|
1379
|
+
The value <code>always</code> should be used for resources that change each time they are accessed.
|
|
1380
|
+
The value <code>never</code> should be used for archived resources.</li>
|
|
1381
|
+
<li><code><rs:md></code> -- In this context, the element conveys metadata pertaining to the resource with the URI provided in <code><loc></code>.
|
|
1382
|
+
The element is not repeatable, and is mandatory for some documents and optional
|
|
1383
|
+
for others, as described in the appropriate sections. It may have several
|
|
1384
|
+
attributes and the ones defined by ResourceSync are as follows:
|
|
1385
|
+
<ul>
|
|
1386
|
+
<li><code>at</code> and <code>completed</code> -- The semantics and value
|
|
1387
|
+
of these attributes are as defined earlier in this section.
|
|
1388
|
+
They are only used for Resource List Indexes, Resource Dumps, and Resource Dump Indexes.
|
|
1389
|
+
Required use of the attributes is detailed in the sections describing the respective documents
|
|
1390
|
+
and summarized in <a href="#TimeAttributeReqs">Appendix A</a>.</li>
|
|
1391
|
+
<li><code>capability</code> -- This attribute is mandatory in Source Descriptions and Capability Lists.
|
|
1392
|
+
Its value indicates the nature of the resource identified by the URI
|
|
1393
|
+
in the <code><loc></code> element, e.g., a Resource List, a Change
|
|
1394
|
+
List, a Change Dump, etc. Values defined in this specification are
|
|
1395
|
+
<code>resourcelist</code>, <code>changelist</code>, <code>resourcedump</code>, <code>changedump</code>, and <code>capabilitylist</code>.</li>
|
|
1396
|
+
<li><code>change</code> -- The value of the attribute conveys the type of change
|
|
1397
|
+
that a resource underwent. Values defined in this specification are
|
|
1398
|
+
<code>created</code>, <code>updated</code>, and <code>deleted</code>, which
|
|
1399
|
+
convey the creation, update, and deletion of a resource, respectively.
|
|
1400
|
+
This attribute is used in <a href="#ChangeList">Change Lists (Section 12.1)</a> and <a href="#ChangeDumpManifest">Change Dump Manifests (Section 13.2)</a>.</li>
|
|
1401
|
+
<li><code>datetime</code> -- The value of the attribute conveys the datetime of
|
|
1402
|
+
the change event for the resource. The value is expressed as a
|
|
1403
|
+
<a href="#w3c-datetime">W3C Datetime</a> as described earlier in this section.
|
|
1404
|
+
This attribute may be used in <a href="#ChangeList">Change Lists (Section 12.1)</a>
|
|
1405
|
+
and <a href="#ChangeDumpManifest">Change Dump Manifests (Section 13.2)</a>. The value
|
|
1406
|
+
must be equal to or after the <code>from</code> datetime, and before or equal to
|
|
1407
|
+
the <code>until</code> datetime if specified.</li>
|
|
1408
|
+
<li><code>encoding</code> -- The value of the attribute conveys what content codings have been applied to the resource. The value of the
|
|
1409
|
+
<code>encoding</code> attribute should be equal to the value of the <code>content-encoding</code> header in the HTTP response as defined in
|
|
1410
|
+
<a href="#ref-rfc2616">RFC 2616, Sec. 14.11</a>.</li>
|
|
1411
|
+
<li><code>from</code> and <code>until</code> -- The semantics and value
|
|
1412
|
+
of these attributes are as defined earlier in this section.
|
|
1413
|
+
They are only used for Change List Indexes, Change Dumps, and Change Dump Indexes.
|
|
1414
|
+
Required use of the attributes is detailed in the sections describing the respective documents
|
|
1415
|
+
and summarized in <a href="#TimeAttributeReqs">Appendix A</a>.</li>
|
|
1416
|
+
<li><code>hash</code> -- The value of the attribute conveys fixity information for a resource representation returned when the URI in <code><loc></code> is dereferenced.
|
|
1417
|
+
The attribute value is expressed in the form of a whitespace-delimited list of hash values.
|
|
1418
|
+
Each hash value is represented by a hex-encoded digest and is preceded by a token that identifies the utilized hash algorithm, e.g., <code>md5:</code>, <code>sha-256:</code>.</li>
|
|
1419
|
+
<li><code>length</code> -- The value of the attribute conveys the content length of a resource representation returned when the URI in <code><loc></code> is dereferenced.
|
|
1420
|
+
The value of the <code>length</code> attribute should be equal to the value of the <code>Content-Length</code> header in the HTTP response
|
|
1421
|
+
and must be computed as defined in <a href="#ref-rfc2616">RFC 2616, Sec. 4.4</a>.</li>
|
|
1422
|
+
|
|
1423
|
+
<li><code>path</code> -- The attribute is only used in
|
|
1424
|
+
<a href="#ResourceDumpManifest">Resource Dump Manifests (Section 11.2)</a> and
|
|
1425
|
+
<a href="#ChangeDumpManifest">Change Dump Manifests (Section 13.2)</a>.
|
|
1426
|
+
Its value conveys the file path of the bitstream associated with the URI in <code><loc></code> in the ZIP file. That is
|
|
1427
|
+
the relative file system path where the bitstream would reside if the ZIP were unpacked.</li>
|
|
1428
|
+
<li><code>type</code> -- The value of the attribute conveys the Media Type of a resource representation returned when the URI in
|
|
1429
|
+
<code><loc></code> is dereferenced.
|
|
1430
|
+
Registered values are listed in the <a href="#ref-iana-mime">IANA MIME Media Type registry</a>.</li>
|
|
1431
|
+
</ul>
|
|
1432
|
+
</li>
|
|
1433
|
+
<li><code><rs:ln></code> -- In this context, an optional and repeatable element used to link to resources related to the one with the
|
|
1434
|
+
URI provided in <code><loc></code>, such as
|
|
1435
|
+
a copy on a mirror site, a prior version of the resource, etc. (see
|
|
1436
|
+
Linking to Related Resources in <a href="#SourcePers">Section 5.1</a>).
|
|
1437
|
+
It may have several attributes and the ones defined by ResourceSync are as follows:
|
|
1438
|
+
<ul>
|
|
1439
|
+
<li><code>href</code> -- A mandatory attribute to convey the URI of the related resource.
|
|
1440
|
+
</li>
|
|
1441
|
+
<li><code>rel</code> -- A mandatory attribute to convey the relationship between the resource with the URI in <code><loc></code>
|
|
1442
|
+
and the one with the URI in <code>href</code>.
|
|
1443
|
+
Values for the <code>rel</code> attribute are listed in the document
|
|
1444
|
+
<a href="#ref-relationtypes">Relation Types Used in the ResourceSync
|
|
1445
|
+
Framework</a>. The ones featured in this specification are:
|
|
1446
|
+
<ul>
|
|
1447
|
+
<li><code>contents</code> -- for a link from an entry in a Resource Dump or Change Dump that points to a bitstream package
|
|
1448
|
+
to a Resource Dump Manifest or to a Change Dump Manifest, respectively, for that bitstream package.</li>
|
|
1449
|
+
<li><code>duplicate</code> -- for a link to a resource's mirror location.</li>
|
|
1450
|
+
<li><code>alternate</code> and <code>canonical</code> -- for a link to an alternate representation of a resource.</li>
|
|
1451
|
+
<li><code>http://www.openarchives.org/rs/terms/patch</code> -- for a link to a resource that details the difference between the
|
|
1452
|
+
previous and current version of a resource.</li>
|
|
1453
|
+
<li><code>describedby</code> and <code>describes</code> -- for a link providing additional information about a resource.</li>
|
|
1454
|
+
<li><code>memento</code> and <code>timegate</code> -- for a link to access prior versions of a resource.</li>
|
|
1455
|
+
<li><code>collection</code> -- for a link that expresses collection membership.</li>
|
|
1456
|
+
<li><code>via</code> -- for a link that provides provenance information.</li>
|
|
1457
|
+
</ul>
|
|
1458
|
+
</li>
|
|
1459
|
+
<li><code>encoding</code>, <code>hash</code>, <code>length</code>,
|
|
1460
|
+
<code>modified</code>, <code>path</code>, <code>type</code> -- Optional
|
|
1461
|
+
attributes with meanings as described earlier in this section and
|
|
1462
|
+
pertaining to the related resource.</li>
|
|
1463
|
+
<li><code>pri</code> -- An optional attribute used to express a priority
|
|
1464
|
+
among links with the same relation type. The attribute value is an integer
|
|
1465
|
+
between 1 and 999,999, with a lower integer indicating a higher priority
|
|
1466
|
+
and the absence of the attribute indicating a value of 999,999.</li>
|
|
1467
|
+
</ul>
|
|
1468
|
+
</li>
|
|
1469
|
+
</ul>
|
|
1470
|
+
</li>
|
|
1471
|
+
</ul>
|
|
1472
|
+
|
|
1473
|
+
<p><a href="#elem_intro_tab">Table 3</a> lists the elements used in ResourceSync
|
|
1474
|
+
documents and for each shows the attributes defined by ResourceSync
|
|
1475
|
+
that may be used with them. The "Specification" column refers to the
|
|
1476
|
+
specification where elements or attributes were introduced that
|
|
1477
|
+
ResourceSync equivalents are based upon and from where they inherit their semantics.
|
|
1478
|
+
A mark in the "Representation" column for an attribute indicates
|
|
1479
|
+
that it should only be used when a specific representation of a resource is concerned,
|
|
1480
|
+
whereas a mark in the "Resource" column indicates it is usable for a
|
|
1481
|
+
resource in general. A <a href="resourcesync.xsd">W3C XML Schema</a> (available
|
|
1482
|
+
at <a href="resourcesync.xsd">http://www.openarchives.org/rs/resourcesync.xsd</a>)
|
|
1483
|
+
is provided to validate the elements introduced by ResourceSync.</p>
|
|
1484
|
+
|
|
1485
|
+
<p>Relation types other than the ones listed above may be used in the
|
|
1486
|
+
ResourceSync Framework. Valid relation types must be registered in the
|
|
1487
|
+
<a href="http://www.iana.org/assignments/link-relations/link-relations.xml">IANA Link Relation Type Registry</a>
|
|
1488
|
+
or expressed as URIs as specified in <a href="#ref-rfc5988">RFC 5988, Sec. 4.2</a>. The document
|
|
1489
|
+
<a href="#ref-relationtypes">Relation Types Used in the ResourceSync Framework</a> attempts to
|
|
1490
|
+
provide an up-to-date overview.</p>
|
|
1491
|
+
|
|
1492
|
+
<a name="elem_intro_tab"></a>
|
|
1493
|
+
<table class="elem_intro-table" summary="Elements used and sources of definitions">
|
|
1494
|
+
<tbody>
|
|
1495
|
+
<tr class="top">
|
|
1496
|
+
<th class="left">Element/Attribute</th><th>Specification</th><th>Resource</th><th>Representation</th>
|
|
1497
|
+
</tr>
|
|
1498
|
+
<tr class="top1">
|
|
1499
|
+
<td class="left"><b><code><urlset></code> or <code><sitemapindex></code></b></td><td><a href="#ref-sitemaps">Sitemap protocol</a></td><td></td><td></td>
|
|
1500
|
+
</tr>
|
|
1501
|
+
<tr class="top1">
|
|
1502
|
+
<td class="left"> <b><code><rs:md></code></b></td><td>This specification</td><td></td><td></td>
|
|
1503
|
+
</tr>
|
|
1504
|
+
<tr class="odd">
|
|
1505
|
+
<td class="left"> <code>at</code></td><td>This specification</td><td></td><td></td>
|
|
1506
|
+
</tr>
|
|
1507
|
+
<tr class="even">
|
|
1508
|
+
<td class="left"> <code>capability</code></td><td>This specification</td><td></td><td></td>
|
|
1509
|
+
</tr>
|
|
1510
|
+
<tr class="odd">
|
|
1511
|
+
<td class="left"> <code>completed</code></td><td>This specification</td><td></td><td></td>
|
|
1512
|
+
</tr>
|
|
1513
|
+
<tr class="even">
|
|
1514
|
+
<td class="left"> <code>from</code></td><td>This specification</td><td></td><td></td>
|
|
1515
|
+
</tr>
|
|
1516
|
+
<tr class="odd">
|
|
1517
|
+
<td class="left"> <code>until</code></td><td>This specification</td><td></td><td></td>
|
|
1518
|
+
</tr>
|
|
1519
|
+
<tr class="top1">
|
|
1520
|
+
<td class="left"> <b><code><rs:ln></code></b></td><td><a href="#ref-rfc4287">RFC4287</a></td><td></td><td></td>
|
|
1521
|
+
</tr>
|
|
1522
|
+
<tr class="odd">
|
|
1523
|
+
<td class="left"> <code>href</code></td><td><a href="#ref-rfc4287">RFC4287</a></td><td></td><td></td>
|
|
1524
|
+
</tr>
|
|
1525
|
+
<tr class="even">
|
|
1526
|
+
<td class="left"> <code>rel</code></td><td><a href="#ref-rfc4287">RFC4287</a></td><td></td><td></td>
|
|
1527
|
+
</tr>
|
|
1528
|
+
<tr class="top1">
|
|
1529
|
+
<td class="left"> <b><code><url></code> or <code><sitemap></code></b></td><td><a href="#ref-sitemaps">Sitemap protocol</a></td><td></td><td></td>
|
|
1530
|
+
</tr>
|
|
1531
|
+
<tr class="odd">
|
|
1532
|
+
<td class="left"> <code><loc></code></td><td><a href="#ref-sitemaps">Sitemap protocol</a></td><td></td><td></td>
|
|
1533
|
+
</tr>
|
|
1534
|
+
<tr class="even">
|
|
1535
|
+
<td class="left"> <code><lastmod></code></td><td><a href="#ref-sitemaps">Sitemap protocol</a></td><td></td><td></td>
|
|
1536
|
+
</tr>
|
|
1537
|
+
<tr class="odd">
|
|
1538
|
+
<td class="left"> <code><changefreq></code></td><td><a href="#ref-sitemaps">Sitemap protocol</a></td><td></td><td></td>
|
|
1539
|
+
</tr>
|
|
1540
|
+
<tr class="top1">
|
|
1541
|
+
<td class="left"> <b><code><rs:md></code></b></td><td>This specification</td><td></td><td></td>
|
|
1542
|
+
</tr>
|
|
1543
|
+
<tr class="odd">
|
|
1544
|
+
<td class="left"> <code>at</code></td><td>This specification</td><td></td><td></td>
|
|
1545
|
+
</tr>
|
|
1546
|
+
<tr class="even">
|
|
1547
|
+
<td class="left"> <code>capability</code></td><td>This specification</td><td></td><td></td>
|
|
1548
|
+
</tr>
|
|
1549
|
+
<tr class="odd">
|
|
1550
|
+
<td class="left"> <code>change</code></td><td>This specification</td><td>X</td><td>X</td>
|
|
1551
|
+
</tr>
|
|
1552
|
+
<tr class="even">
|
|
1553
|
+
<td class="left"> <code>completed</code></td><td>This specification</td><td></td><td></td>
|
|
1554
|
+
</tr>
|
|
1555
|
+
<tr class="odd">
|
|
1556
|
+
<td class="left"> <code>datetime</code></td><td>This specification</td><td>X</td><td>X</td>
|
|
1557
|
+
</tr>
|
|
1558
|
+
<tr class="even">
|
|
1559
|
+
<td class="left"> <code>encoding</code></td><td><a href="#ref-rfc2616">RFC2616</a></td><td></td><td>X</td>
|
|
1560
|
+
</tr>
|
|
1561
|
+
<tr class="odd">
|
|
1562
|
+
<td class="left"> <code>from</code></td><td>This specification</td><td></td><td></td>
|
|
1563
|
+
</tr>
|
|
1564
|
+
<tr class="even">
|
|
1565
|
+
<td class="left"> <code>hash</code></td><td><a href="#ref-ale">Atom Link Extensions</a></td><td></td><td>X</td>
|
|
1566
|
+
</tr>
|
|
1567
|
+
<tr class="odd">
|
|
1568
|
+
<td class="left"> <code>length</code></td><td><a href="#ref-rfc4287">RFC4287</a></td><td></td><td>X</td>
|
|
1569
|
+
</tr>
|
|
1570
|
+
<tr class="even">
|
|
1571
|
+
<td class="left"> <code>path</code></td><td>This specification</td><td></td><td>X</td>
|
|
1572
|
+
</tr>
|
|
1573
|
+
<tr class="odd">
|
|
1574
|
+
<td class="left"> <code>type</code></td><td><a href="#ref-rfc4287">RFC4287</a></td><td></td><td>X</td>
|
|
1575
|
+
</tr>
|
|
1576
|
+
<tr class="even">
|
|
1577
|
+
<td class="left"> <code>until</code></td><td>This specification</td><td></td><td></td>
|
|
1578
|
+
</tr>
|
|
1579
|
+
<tr class="top1">
|
|
1580
|
+
<td class="left"> <b><code><rs:ln></code></b></td><td>This specification</td><td></td><td></td>
|
|
1581
|
+
</tr>
|
|
1582
|
+
<tr class="odd">
|
|
1583
|
+
<td class="left"> <code>encoding</code></td><td><a href="#ref-rfc2616">RFC2616</a></td><td></td><td>X</td>
|
|
1584
|
+
</tr>
|
|
1585
|
+
<tr class="even">
|
|
1586
|
+
<td class="left"> <code>hash</code></td><td><a href="#ref-ale">Atom Link Extensions</a></td><td></td><td>X</td>
|
|
1587
|
+
</tr>
|
|
1588
|
+
<tr class="odd">
|
|
1589
|
+
<td class="left"> <code>href</code></td><td><a href="#ref-rfc4287">RFC4287</a></td><td>X</td><td>X</td>
|
|
1590
|
+
</tr>
|
|
1591
|
+
<tr class="even">
|
|
1592
|
+
<td class="left"> <code>length</code></td><td><a href="#ref-rfc4287">RFC4287</a></td><td></td><td>X</td>
|
|
1593
|
+
</tr>
|
|
1594
|
+
<tr class="odd">
|
|
1595
|
+
<td class="left"> <code>modified</code></td><td><a href="#ref-ale">Atom Link Extensions</a></td><td>X</td><td>X</td>
|
|
1596
|
+
</tr>
|
|
1597
|
+
<tr class="even">
|
|
1598
|
+
<td class="left"> <code>path</code></td><td>This specification</td><td></td><td>X</td>
|
|
1599
|
+
</tr>
|
|
1600
|
+
<tr class="odd">
|
|
1601
|
+
<td class="left"> <code>pri</code></td><td><a href="#ref-rfc6249">RFC6249</a></td><td>X</td><td>X</td>
|
|
1602
|
+
</tr>
|
|
1603
|
+
<tr class="even">
|
|
1604
|
+
<td class="left"> <code>rel</code></td><td><a href="#ref-rfc4287">RFC4287</a></td><td>X</td><td>X</td>
|
|
1605
|
+
</tr>
|
|
1606
|
+
<tr class="odd">
|
|
1607
|
+
<td class="left"> <code>type</code></td><td><a href="#ref-rfc4287">RFC4287</a></td><td></td><td>X</td>
|
|
1608
|
+
</tr>
|
|
1609
|
+
</tbody></table>
|
|
1610
|
+
<p class="caption">Table 3: Elements and associated attributes defined for the ResourceSync documents</p>
|
|
1611
|
+
|
|
1612
|
+
|
|
1613
|
+
<h2>8. <a name="SourceDesc"></a>Describing the Source</h2>
|
|
1614
|
+
|
|
1615
|
+
<p>
|
|
1616
|
+
A <b>Source Description</b> is a mandatory document that enumerates the
|
|
1617
|
+
Capability Lists offered by a Source. Since a Source has one Capability
|
|
1618
|
+
List per set of resources that it distinguishes, the Source Description
|
|
1619
|
+
will enumerate as many Capability Lists as the Source has distinct sets
|
|
1620
|
+
of resources.
|
|
1621
|
+
</p>
|
|
1622
|
+
<p>
|
|
1623
|
+
The Source Description is based on the <code><urlset></code> format.
|
|
1624
|
+
It has the <code><urlset></code> root element and the following structure:
|
|
1625
|
+
</p>
|
|
1626
|
+
<ul>
|
|
1627
|
+
<li>The mandatory <code><rs:md></code> child element of <code><urlset></code>
|
|
1628
|
+
must have a <code>capability</code> attribute that has a value of <code>description</code>.</li>
|
|
1629
|
+
<li>A recommended <code><rs:ln></code> child element of <code><urlset></code>
|
|
1630
|
+
with the relation type <code>describedby</code>
|
|
1631
|
+
points to a document that provides information about the Source.</li>
|
|
1632
|
+
<li>One <code><url></code> child element of <code><urlset></code>
|
|
1633
|
+
should be included for each Capability List offered by the Source. This
|
|
1634
|
+
element does not have attributes, but uses child elements to convey
|
|
1635
|
+
information about the Capability Lists. The <code><url></code>
|
|
1636
|
+
element has the following child elements:
|
|
1637
|
+
<ul>
|
|
1638
|
+
<li>A mandatory <code><loc></code> child element provides the URI of the respective Capability List.</li>
|
|
1639
|
+
<li>An optional <code><rs:md></code> child element must have a <code>capability</code> attribute with a value of
|
|
1640
|
+
<code>capabilitylist</code>
|
|
1641
|
+
to convey that the URI points to a Capability List.</li>
|
|
1642
|
+
<li>A recommended <code><rs:ln></code> child element with a <code>describedby</code> relation type
|
|
1643
|
+
points to a document that describes the set of resources described by the Capability List.</li>
|
|
1644
|
+
</ul>
|
|
1645
|
+
</li>
|
|
1646
|
+
</ul>
|
|
1647
|
+
<p>
|
|
1648
|
+
The <code><lastmod></code> elements should be omitted from the Source Description unless the Source updates the
|
|
1649
|
+
Source Description every time it updates one of the Capability Lists.
|
|
1650
|
+
</p>
|
|
1651
|
+
<p>
|
|
1652
|
+
<a href="#ex_12">Example 12</a> shows a Source Description where the Source offers three Capability Lists.
|
|
1653
|
+
</p>
|
|
1654
|
+
<a name="ex_12"></a>
|
|
1655
|
+
<div class="exampleInner">
|
|
1656
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
1657
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
1658
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
1659
|
+
<rs:ln rel="describedby"
|
|
1660
|
+
href="http://example.com/info_about_source.xml"/>
|
|
1661
|
+
<rs:md <span class="rs">capability="description"</span>/>
|
|
1662
|
+
<url>
|
|
1663
|
+
<loc>http://example.com/capabilitylist1.xml</loc>
|
|
1664
|
+
<rs:md capability="capabilitylist"/>
|
|
1665
|
+
<rs:ln rel="describedby"
|
|
1666
|
+
href="http://example.com/info_about_set1_of_resources.xml"/>
|
|
1667
|
+
</url>
|
|
1668
|
+
<url>
|
|
1669
|
+
<loc>http://example.com/capabilitylist2.xml</loc>
|
|
1670
|
+
<rs:md capability="capabilitylist"/>
|
|
1671
|
+
<rs:ln rel="describedby"
|
|
1672
|
+
href="http://example.com/info_about_set2_of_resources.xml"/>
|
|
1673
|
+
</url>
|
|
1674
|
+
<url>
|
|
1675
|
+
<loc>http://example.com/capabilitylist3.xml</loc>
|
|
1676
|
+
<rs:md capability="capabilitylist"/>
|
|
1677
|
+
<rs:ln rel="describedby"
|
|
1678
|
+
href="http://example.com/info_about_set3_of_resources.xml"/>
|
|
1679
|
+
</url>
|
|
1680
|
+
</urlset>
|
|
1681
|
+
</pre>
|
|
1682
|
+
</div>
|
|
1683
|
+
<p class="caption">Example 12: A Source Description</p>
|
|
1684
|
+
|
|
1685
|
+
<p>
|
|
1686
|
+
If a Source needs to or chooses to publish multiple Source Descriptions, it must group them by means of a Source Description Index.
|
|
1687
|
+
</p>
|
|
1688
|
+
|
|
1689
|
+
|
|
1690
|
+
<h2>9. <a name="CapabilityList"></a>Advertising Capabilities</h2>
|
|
1691
|
+
|
|
1692
|
+
<p>
|
|
1693
|
+
A <b>Capability List</b> is a document that enumerates all capabilities supported by a
|
|
1694
|
+
Source for a specific set of resources. The Source defines which resources are
|
|
1695
|
+
part of the set of resources described by the Capability List.
|
|
1696
|
+
If there is more than one such set, then the Source must distinguish them with
|
|
1697
|
+
different capability lists. The choice of which resources are part of which set
|
|
1698
|
+
may derive from a variety of criteria, including media type, collection membership,
|
|
1699
|
+
change frequency, subject of the resource and many others.
|
|
1700
|
+
</p>
|
|
1701
|
+
<p>
|
|
1702
|
+
A Capability List points at the capability documents for its set of resources:
|
|
1703
|
+
Resource List (<a href="#DescResources">Section 10.1</a>),
|
|
1704
|
+
Resource Dump (<a href="#ResourceDump">Section 11.1</a>),
|
|
1705
|
+
Change List (<a href="#DesChanges">Section 12.1</a>), and
|
|
1706
|
+
Change Dump (<a href="#ChangeDump">Section 13.1</a>).
|
|
1707
|
+
A Capability List must only contain one entry per capability.
|
|
1708
|
+
</p>
|
|
1709
|
+
<p>
|
|
1710
|
+
Capabilities that are conveyed in the same Capability List uniformly apply to
|
|
1711
|
+
the set of resources covered by that Capability List. For example, if a
|
|
1712
|
+
Capability List enumerates a Resource List, a Resource Dump, and a Change List,
|
|
1713
|
+
then a given resource that appears in a Resource List must also appear in a
|
|
1714
|
+
Resource Dump, and changes to the resource must be conveyed in the Change List.
|
|
1715
|
+
</p>
|
|
1716
|
+
<p>
|
|
1717
|
+
The Capability List is based on the <code><urlset></code> format.
|
|
1718
|
+
It has the <code><urlset></code> root element and the following structure:
|
|
1719
|
+
</p>
|
|
1720
|
+
<ul>
|
|
1721
|
+
<li>The mandatory <code><rs:md></code> child element of <code><urlset></code> must have a
|
|
1722
|
+
<code>capability</code> attribute that has a value of <code>capabilitylist</code>.</li>
|
|
1723
|
+
<li>A mandatory <code><rs:ln></code> child element of <code><urlset></code> with the relation type <code>up</code>
|
|
1724
|
+
points to the Source Description document that enumerates all Capability Lists offered by the Source.</li>
|
|
1725
|
+
<li>A recommended <code><rs:ln></code> child element of <code><urlset></code> with the relation type <code>describedby</code>
|
|
1726
|
+
points to a document that provides information about the set of resources covered by the Capability List.</li>
|
|
1727
|
+
<li>One <code><url></code> child element of <code><urlset></code> per capability offered by the Source. This element does not have attributes, but uses
|
|
1728
|
+
child elements to convey information about the capabilities. The <code><url></code> element has the following child elements:
|
|
1729
|
+
<ul>
|
|
1730
|
+
<li>A mandatory <code><loc></code> child element provides the URI of the respective capability document.</li>
|
|
1731
|
+
<li>A mandatory <code><rs:md></code> child element must have a <code>capability</code> attribute to convey the type of the respective capability.</li>
|
|
1732
|
+
</ul>
|
|
1733
|
+
</li>
|
|
1734
|
+
</ul>
|
|
1735
|
+
<p>
|
|
1736
|
+
The <code><lastmod></code> elements should be omitted from the Capability List unless the Source updates the Capability List
|
|
1737
|
+
every time it updates one of the capability documents.
|
|
1738
|
+
</p>
|
|
1739
|
+
<p>
|
|
1740
|
+
<a href="#ex_13">Example 13</a> shows a Capability List where the Source offers four capabilities: a Resource List, a Resource Dump, a Change List,
|
|
1741
|
+
and a Change Dump. A Destination cannot determine from the Capability List whether a Source provides, for example, a Resource List Index or a single Resource List.
|
|
1742
|
+
The capability document must be downloaded to make this determination: a document with a <code><sitemapindex></code> root element is an index,
|
|
1743
|
+
a document with a <code><urlset></code> root element is not.
|
|
1744
|
+
</p>
|
|
1745
|
+
<a name="ex_13"></a>
|
|
1746
|
+
<div class="exampleInner">
|
|
1747
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
1748
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
1749
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
1750
|
+
<rs:ln rel="describedby"
|
|
1751
|
+
href="http://example.com/info_about_set1_of_resources.xml"/>
|
|
1752
|
+
<rs:ln <span class="rs">rel="up"</span>
|
|
1753
|
+
href="http://example.com/resourcesync_description.xml"/>
|
|
1754
|
+
<rs:md <span class="rs">capability="capabilitylist"</span>/>
|
|
1755
|
+
<url>
|
|
1756
|
+
<loc>http://example.com/dataset1/resourcelist.xml</loc>
|
|
1757
|
+
<rs:md capability="resourcelist"/>
|
|
1758
|
+
</url>
|
|
1759
|
+
<url>
|
|
1760
|
+
<loc>http://example.com/dataset1/resourcedump.xml</loc>
|
|
1761
|
+
<rs:md capability="resourcedump"/>
|
|
1762
|
+
</url>
|
|
1763
|
+
<url>
|
|
1764
|
+
<loc>http://example.com/dataset1/changelist.xml</loc>
|
|
1765
|
+
<rs:md capability="changelist"/>
|
|
1766
|
+
</url>
|
|
1767
|
+
<url>
|
|
1768
|
+
<loc>http://example.com/dataset1/changedump.xml</loc>
|
|
1769
|
+
<rs:md capability="changedump"/>
|
|
1770
|
+
</url>
|
|
1771
|
+
</urlset>
|
|
1772
|
+
</pre>
|
|
1773
|
+
</div>
|
|
1774
|
+
<p class="caption">Example 13: A Capability List</p>
|
|
1775
|
+
|
|
1776
|
+
<p>
|
|
1777
|
+
ResourceSync defines only a small number of capabilities, and enumerating those
|
|
1778
|
+
does not approach the limits of a single Capability List. Thus no
|
|
1779
|
+
<code><sitemapindex></code> document structure is necessary and Sources
|
|
1780
|
+
should not generate such structures.
|
|
1781
|
+
</p>
|
|
1782
|
+
|
|
1783
|
+
|
|
1784
|
+
<h2>10. <a name="DescResources">Describing Resources</a></h2>
|
|
1785
|
+
<p>
|
|
1786
|
+
A Source may publish a description of the resources it makes available
|
|
1787
|
+
for synchronization. This information enables a Destination to make an
|
|
1788
|
+
initial copy of some or all of those resources, or to update a local
|
|
1789
|
+
copy to remain synchronized with changes.
|
|
1790
|
+
</p>
|
|
1791
|
+
|
|
1792
|
+
<h3>10.1 <a name="ResourceList">Resource List</a></h3>
|
|
1793
|
+
<p>
|
|
1794
|
+
A <b>Resource List</b> is introduced to list and describe the resources
|
|
1795
|
+
that a Source makes available for synchronization.
|
|
1796
|
+
It presents a snapshot of a Source's resources at a particular point in time.
|
|
1797
|
+
</p>
|
|
1798
|
+
|
|
1799
|
+
<p>
|
|
1800
|
+
A Resource List is based on the <code><urlset></code> document format
|
|
1801
|
+
introduced by the Sitemap protocol. It has the <code><urlset></code>
|
|
1802
|
+
root element and the following structure:
|
|
1803
|
+
</p>
|
|
1804
|
+
<ul>
|
|
1805
|
+
<li>The mandatory <code><rs:md></code> child element of <code><urlset></code> must have a
|
|
1806
|
+
<code>capability</code> attribute that has a value of <code>resourcelist</code>. It must also have an
|
|
1807
|
+
<code>at</code> attribute that conveys the datetime at which the process of taking a snapshot of resources
|
|
1808
|
+
for their inclusion in the Resource List started, and it may have a <code>completed</code> attribute that conveys
|
|
1809
|
+
the datetime at which that process completed.</li>
|
|
1810
|
+
<li>A mandatory <code><rs:ln></code> child element of <code><urlset></code> points to the Capability List with the relation type
|
|
1811
|
+
<code>up</code>.</li>
|
|
1812
|
+
<li>In case a <a href="#ResourceListIndex">Resource List Index</a> exists,
|
|
1813
|
+
a recommended <code><rs:ln></code> child element of
|
|
1814
|
+
<code><urlset></code> points to it with the relation type <code>index</code>.</li>
|
|
1815
|
+
<li>One <code><url></code> child element of <code><urlset></code> should be included for each resource. This element does not have attributes, but uses
|
|
1816
|
+
child elements to convey information about the resource. The <code><url></code> element has the following child elements:
|
|
1817
|
+
<ul>
|
|
1818
|
+
<li>A mandatory <code><loc></code> child element provides the URI of the resource.</li>
|
|
1819
|
+
<li>Optional <code><lastmod></code> and <code><changefreq></code> child
|
|
1820
|
+
element with semantics as described in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
1821
|
+
<li>An optional <code><rs:md></code> child element provides further metadata about
|
|
1822
|
+
the resource. It may have the attributes as described in
|
|
1823
|
+
<a href="#DocumentFormats">Section 7</a>.</li>
|
|
1824
|
+
<li>Optional <code><rs:ln></code> child elements link to related resources as described in <a href="#DocumentFormats">Section 7</a>, and
|
|
1825
|
+
detailed in <a href="#LinkRelRes">Section 14</a>.</li>
|
|
1826
|
+
</ul>
|
|
1827
|
+
</li>
|
|
1828
|
+
</ul>
|
|
1829
|
+
<p>
|
|
1830
|
+
<a href="#ex_14">Example 14</a> shows a Resource List with two resources.
|
|
1831
|
+
The <code>at</code> attribute allows a Destination to determine that neither
|
|
1832
|
+
of the listed resources have undergone a change between their respective
|
|
1833
|
+
last modification datetimes, <code>2013-01-02T13:00:00Z</code> and
|
|
1834
|
+
<code>2013-01-02T14:00:00Z</code>, and the datetime that is the value of
|
|
1835
|
+
the <code>at</code> attribute, <code>2013-01-03T09:00:00Z</code>.
|
|
1836
|
+
</p>
|
|
1837
|
+
|
|
1838
|
+
<a name="ex_14"></a>
|
|
1839
|
+
<div class="exampleInner">
|
|
1840
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
1841
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
1842
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
1843
|
+
<rs:ln <span class="rs">rel="up"</span>
|
|
1844
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
1845
|
+
<rs:md <span class="rs">capability="resourcelist"
|
|
1846
|
+
at="2013-01-03T09:00:00Z"
|
|
1847
|
+
completed="2013-01-03T09:01:00Z"</span>/>
|
|
1848
|
+
<url>
|
|
1849
|
+
<span class="rs"><loc></span>http://example.com/res1<span class="rs"></loc></span>
|
|
1850
|
+
<span class="rs"><lastmod></span>2013-01-02T13:00:00Z<span class="rs"></lastmod></span>
|
|
1851
|
+
<span class="rs"><rs:md hash</span>="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
1852
|
+
<span class="rs">length</span>="8876"
|
|
1853
|
+
<span class="rs">type</span>="text/html"<span class="rs">/></span>
|
|
1854
|
+
</url>
|
|
1855
|
+
<url>
|
|
1856
|
+
<loc>http://example.com/res2</loc>
|
|
1857
|
+
<lastmod>2013-01-02T14:00:00Z</lastmod>
|
|
1858
|
+
<rs:md hash="md5:1e0d5cb8ef6ba40c99b14c0237be735e
|
|
1859
|
+
sha-256:854f61290e2e197a11bc91063afce22e43f8ccc655237050ace766adc68dc784"
|
|
1860
|
+
length="14599"
|
|
1861
|
+
type="application/pdf"/>
|
|
1862
|
+
</url>
|
|
1863
|
+
</urlset>
|
|
1864
|
+
</pre>
|
|
1865
|
+
</div>
|
|
1866
|
+
<p class="caption">Example 14: A Resource List</p>
|
|
1867
|
+
|
|
1868
|
+
<h3>10.2 <a name="ResourceListIndex"></a>Resource List Index</h3>
|
|
1869
|
+
|
|
1870
|
+
<p>
|
|
1871
|
+
The ResourceSync framework adopts the community-defined limits for publishing
|
|
1872
|
+
documents of the <code><urlset></code> format and
|
|
1873
|
+
introduces a <b>Resource List Index</b> for grouping multiple Resource Lists.
|
|
1874
|
+
The union of the Resource Lists referred to in the Resource List Index represents
|
|
1875
|
+
the entire set of resources that a Source makes available for synchronization.
|
|
1876
|
+
This set of resources, regardless of whether it is conveyed in a single Resource
|
|
1877
|
+
List or in multiple Resource Lists via
|
|
1878
|
+
a Resource List Index, represents the state of the Source's data at a point in time.
|
|
1879
|
+
</p>
|
|
1880
|
+
|
|
1881
|
+
<p>
|
|
1882
|
+
A Resource List Index is based on the <code><sitemapindex></code> document
|
|
1883
|
+
format introduced by the Sitemap protocol. It has the
|
|
1884
|
+
<code><sitemapindex></code> root element and the following structure:
|
|
1885
|
+
</p>
|
|
1886
|
+
<ul>
|
|
1887
|
+
<li>The mandatory <code><rs:md></code> child element of <code><sitemapindex></code> must have a
|
|
1888
|
+
<code>capability</code> attribute that has a value of <code>resourcelist</code>. It must also have an
|
|
1889
|
+
<code>at</code> attribute that conveys the datetime at which the process of taking a snapshot of resources
|
|
1890
|
+
for their inclusion in the Resource List Index started, and it may have a <code>completed</code> attribute that conveys
|
|
1891
|
+
the datetime at which that process completed.</li>
|
|
1892
|
+
<li>A mandatory <code><rs:ln></code> child element of <code><sitemapindex></code> points to the Capability List with the relation type
|
|
1893
|
+
<code>up</code>.</li>
|
|
1894
|
+
<li>One <code><sitemap></code> child element of <code><sitemapindex></code>
|
|
1895
|
+
should be included for each Resource List. This element does not have attributes,
|
|
1896
|
+
but uses child elements to convey information about the Resource List. The
|
|
1897
|
+
<code><sitemap></code> element has the following child elements:
|
|
1898
|
+
<ul>
|
|
1899
|
+
<li>A mandatory <code><loc></code> child element provides the URI of the Resource List.</li>
|
|
1900
|
+
<li>An optional <code><lastmod></code> child element with semantics as described in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
1901
|
+
<li>An optional <code><rs:md></code> child element with an <code>at</code> attribute and possibly a
|
|
1902
|
+
<code>completed</code> attribute to convey the datetime at which the process of taking a snapshot of resources
|
|
1903
|
+
for their inclusion in the Resource List respectively started and ended.</li>
|
|
1904
|
+
</ul>
|
|
1905
|
+
</li>
|
|
1906
|
+
</ul>
|
|
1907
|
+
<p>
|
|
1908
|
+
The Destination can determine whether it has reached a Resource List or
|
|
1909
|
+
a Resource List Index based on whether the root element is
|
|
1910
|
+
<code><urlset></code> or <code><sitemapindex></code>
|
|
1911
|
+
respectively. A Resource List Index that points to three Resource Lists
|
|
1912
|
+
is shown in <a href="#ex_15">Example 15</a>.
|
|
1913
|
+
</p>
|
|
1914
|
+
|
|
1915
|
+
<a name="ex_15"></a>
|
|
1916
|
+
<div class="exampleInner">
|
|
1917
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
1918
|
+
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
1919
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
1920
|
+
<rs:ln rel="up"
|
|
1921
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
1922
|
+
<rs:md <span class="rs">capability="resourcelist"</span>
|
|
1923
|
+
at="2013-01-03T09:00:00Z"
|
|
1924
|
+
completed="2013-01-03T09:10:00Z"/>
|
|
1925
|
+
<sitemap>
|
|
1926
|
+
<loc>http://example.com/resourcelist1.xml</loc>
|
|
1927
|
+
<span class="rs"><rs:md at="2013-01-03T09:00:00Z"/></span>
|
|
1928
|
+
</sitemap>
|
|
1929
|
+
<sitemap>
|
|
1930
|
+
<loc>http://example.com/resourcelist2.xml</loc>
|
|
1931
|
+
<span class="rs"><rs:md at="2013-01-03T09:03:00Z"/></span>
|
|
1932
|
+
</sitemap>
|
|
1933
|
+
<sitemap>
|
|
1934
|
+
<loc>http://example.com/resourcelist3.xml</loc>
|
|
1935
|
+
<span class="rs"><rs:md at="2013-01-03T09:07:00Z"/></span>
|
|
1936
|
+
</sitemap>
|
|
1937
|
+
</sitemapindex>
|
|
1938
|
+
</pre>
|
|
1939
|
+
</div>
|
|
1940
|
+
<p class="caption">Example 15: A Resource List Index</p>
|
|
1941
|
+
|
|
1942
|
+
<p>
|
|
1943
|
+
<a href="#ex_16">Example 16</a> shows the content of the Resource List identified by the URI
|
|
1944
|
+
<code>http://example.com/resourcelist1.xml</code>.
|
|
1945
|
+
Structurally, it is identical to the Resource List shown in <a href="#ex_14">Example 14</a>
|
|
1946
|
+
but it contains an additional
|
|
1947
|
+
<code><rs:ln></code> child element of <code><urlset></code>
|
|
1948
|
+
that provides a navigational link with the relation type <code>index</code> to the parent Resource List Index
|
|
1949
|
+
shown in <a href="#ex_15">Example 15</a>.
|
|
1950
|
+
This link is meant to ease navigation for Destinations and their adoption is therefore recommended.
|
|
1951
|
+
</p>
|
|
1952
|
+
<a name="ex_16"></a>
|
|
1953
|
+
<div class="exampleInner">
|
|
1954
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
1955
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
1956
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
1957
|
+
<rs:ln rel="up"
|
|
1958
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
1959
|
+
<rs:ln <span class="rs">rel="index"</span>
|
|
1960
|
+
href="http://example.com/dataset1/resourcelist-index.xml"/>
|
|
1961
|
+
<rs:md capability="resourcelist"
|
|
1962
|
+
at="2013-01-03T09:00:00Z"/>
|
|
1963
|
+
<url>
|
|
1964
|
+
<loc>http://example.com/res3</loc>
|
|
1965
|
+
<rs:md hash="md5:1584abdf8ebdc9802ac0c6a7402c8753"
|
|
1966
|
+
length="4385"
|
|
1967
|
+
type="application/pdf"/>
|
|
1968
|
+
</url>
|
|
1969
|
+
<url>
|
|
1970
|
+
<loc>http://example.com/res4</loc>
|
|
1971
|
+
<rs:md hash="md5:4556abdf8ebdc9802ac0c6a7402c9881"
|
|
1972
|
+
length="883"
|
|
1973
|
+
type="image/png"/>
|
|
1974
|
+
</url>
|
|
1975
|
+
</urlset>
|
|
1976
|
+
</pre>
|
|
1977
|
+
</div>
|
|
1978
|
+
<p class="caption">Example 16: A Resource List with a navigational link to its parent Resource List Index</p>
|
|
1979
|
+
|
|
1980
|
+
|
|
1981
|
+
<h2>11. <a name="PackResources">Packaging Resources</a></h2>
|
|
1982
|
+
<p>
|
|
1983
|
+
In order to provide Destinations with an efficient way to copy a Source's
|
|
1984
|
+
data using a small number of HTTP requests, a Source may provide packaged
|
|
1985
|
+
bitstreams for its resources.
|
|
1986
|
+
</p>
|
|
1987
|
+
|
|
1988
|
+
<h3>11.1 <a name="ResourceDump">Resource Dump</a></h3>
|
|
1989
|
+
<p>
|
|
1990
|
+
A Source may publish a <strong>Resource Dump</strong>, which provides links
|
|
1991
|
+
to packages of the resources' bitstreams. The Resource Dump represents the
|
|
1992
|
+
Source's state at a point in time. It may be used to transfer resources from
|
|
1993
|
+
the Source in bulk, rather than the Destination having to make many separate
|
|
1994
|
+
requests.
|
|
1995
|
+
</p>
|
|
1996
|
+
<p>
|
|
1997
|
+
The ResourceSync framework recommends the use of the
|
|
1998
|
+
<a href="#ref-zip">ZIP file format</a> as the packaging format. Communities
|
|
1999
|
+
may define their own packaging format, but need to be aware that doing so
|
|
2000
|
+
will have a negative impact on cross-community interoperability.
|
|
2001
|
+
A Resource Dump should only point to packages of the same format.
|
|
2002
|
+
</p>
|
|
2003
|
+
<p>
|
|
2004
|
+
A Resource Dump is based on the <code><urlset></code> document format
|
|
2005
|
+
introduced by the Sitemap protocol. It has the <code><urlset></code> root
|
|
2006
|
+
element and the following structure:
|
|
2007
|
+
</p>
|
|
2008
|
+
<ul>
|
|
2009
|
+
<li>The mandatory <code><rs:md></code> child element of <code><urlset></code> must have a
|
|
2010
|
+
<code>capability</code> attribute that has a value of <code>resourcedump</code>. It must also have an
|
|
2011
|
+
<code>at</code> attribute that conveys the datetime at which the process of taking a snapshot of resources
|
|
2012
|
+
for their inclusion in the Resource Dump started, and it may have a <code>completed</code> attribute that conveys
|
|
2013
|
+
the datetime at which that process completed.</li>
|
|
2014
|
+
<li> A mandatory <code><rs:ln></code> child element of <code><urlset></code> points to the Capability List with the relation type
|
|
2015
|
+
<code>up</code>.</li>
|
|
2016
|
+
<li>In case a <a href="#ResourceDumpIndex">Resource Dump Index</a> exists,
|
|
2017
|
+
a recommended <code><rs:ln></code> child element of
|
|
2018
|
+
<code><urlset></code> points to it with the relation type <code>index</code>.</li>
|
|
2019
|
+
<li>One <code><url></code> child element of <code><urlset></code>
|
|
2020
|
+
should be included for each bitstream package. This element does not have attributes,
|
|
2021
|
+
but uses child elements to convey information about the package. The
|
|
2022
|
+
<code><url></code> element has the following child elements:
|
|
2023
|
+
<ul>
|
|
2024
|
+
<li>A mandatory <code><loc></code> child element provides the URI of the package.</li>
|
|
2025
|
+
<li>An optional <code><lastmod></code> child element with semantics as described in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
2026
|
+
<li>A recommended <code><rs:md></code> child element to convey the Media Type and
|
|
2027
|
+
the length of the package using the <code>type</code> and <code>length</code>
|
|
2028
|
+
attribute, respectively. The element may also have an <code>at</code> attribute and possibly
|
|
2029
|
+
a <code>completed</code> attribute to convey the datetime at which the process
|
|
2030
|
+
of taking a snapshot of resources
|
|
2031
|
+
for their inclusion in the package respectively started and ended.
|
|
2032
|
+
The child element may further have attributes such as
|
|
2033
|
+
<code>hash</code>, as described in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
2034
|
+
<li>An optional <code><rs:ln></code> child element with the relation type <code>contents</code> that points to the Resource Dump Manifest
|
|
2035
|
+
associated with the bitstream package.</li>
|
|
2036
|
+
</ul>
|
|
2037
|
+
</li>
|
|
2038
|
+
</ul>
|
|
2039
|
+
<p>
|
|
2040
|
+
<a href="#ex_17">Example 17</a> shows a Resource Dump that points to three ZIP files.
|
|
2041
|
+
Included in each <code><url></code> element is a pointer to the
|
|
2042
|
+
<a href="#ResourceDumpManifest">Resource Dump Manifest</a> associated with
|
|
2043
|
+
the package. While this pointer is optional and intended for the Destination's
|
|
2044
|
+
convenience, if provided, the Source needs to ensure that the referred Manifest
|
|
2045
|
+
corresponds with the Manifest included in the bitstream package.
|
|
2046
|
+
</p>
|
|
2047
|
+
|
|
2048
|
+
<a name="ex_17"></a>
|
|
2049
|
+
<div class="exampleInner">
|
|
2050
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
2051
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
2052
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
2053
|
+
<rs:ln rel="up"
|
|
2054
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
2055
|
+
<rs:md <span class="rs">capability="resourcedump"</span>
|
|
2056
|
+
at="2013-01-03T09:00:00Z"
|
|
2057
|
+
completed="2013-01-03T09:04:00Z"/>
|
|
2058
|
+
<url>
|
|
2059
|
+
<loc>http://example.com/resourcedump-part1.zip</loc>
|
|
2060
|
+
<rs:md <span class="rs">type="application/zip"
|
|
2061
|
+
length="4765"
|
|
2062
|
+
at="2013-01-03T09:00:00Z"
|
|
2063
|
+
completed="2013-01-03T09:02:00Z"</span>/>
|
|
2064
|
+
<rs:ln <span class="rs">rel="contents"</span>
|
|
2065
|
+
href="http://example.com/resourcedump_manifest-part1.xml"
|
|
2066
|
+
type="application/xml"/>
|
|
2067
|
+
</url>
|
|
2068
|
+
<url>
|
|
2069
|
+
<loc>http://example.com/resourcedump-part2.zip</loc>
|
|
2070
|
+
<rs:md type="application/zip"
|
|
2071
|
+
length="9875"
|
|
2072
|
+
at="2013-01-03T09:01:00Z"
|
|
2073
|
+
completed="2013-01-03T09:03:00Z"/>
|
|
2074
|
+
<rs:ln rel="contents"
|
|
2075
|
+
href="http://example.com/resourcedump_manifest-part2.xml"
|
|
2076
|
+
type="application/xml"/>
|
|
2077
|
+
</url>
|
|
2078
|
+
<url>
|
|
2079
|
+
<loc>http://example.com/resourcedump-part3.zip</loc>
|
|
2080
|
+
<rs:md type="application/zip"
|
|
2081
|
+
length="2298"
|
|
2082
|
+
at="2013-01-03T09:03:00Z"
|
|
2083
|
+
completed="2013-01-03T09:04:00Z"/>
|
|
2084
|
+
<rs:ln rel="contents"
|
|
2085
|
+
href="http://example.com/resourcedump_manifest-part3.xml"
|
|
2086
|
+
type="application/xml"/>
|
|
2087
|
+
</url>
|
|
2088
|
+
</urlset>
|
|
2089
|
+
</pre>
|
|
2090
|
+
</div>
|
|
2091
|
+
<p class="caption">Example 17: A Resource Dump</p>
|
|
2092
|
+
|
|
2093
|
+
<p>
|
|
2094
|
+
If a Source needs to or chooses to publish multiple Resource Dumps, it must
|
|
2095
|
+
group them using a <a name="ResourceDumpIndex">Resource Dump Index</a>,
|
|
2096
|
+
in a manner that is similar to what was described in
|
|
2097
|
+
<a href="#ResourceListIndex">Section 11.2</a>.
|
|
2098
|
+
</p>
|
|
2099
|
+
|
|
2100
|
+
<h3>11.2 <a name="ResourceDumpManifest">Resource Dump Manifest</a></h3>
|
|
2101
|
+
<p>
|
|
2102
|
+
Each ZIP package referred to from a Resource Dump must contain a <b>Resource Dump Manifest</b>
|
|
2103
|
+
file that describes the package's constituent bitstreams. The file must be named <code>manifest.xml</code>
|
|
2104
|
+
and must be located at the top level of the ZIP package.
|
|
2105
|
+
</p>
|
|
2106
|
+
|
|
2107
|
+
<p>
|
|
2108
|
+
The Resource Dump Manifest is based on the <code><urlset></code> format.
|
|
2109
|
+
It has the <code><urlset></code> root element and the following structure:
|
|
2110
|
+
</p>
|
|
2111
|
+
<ul>
|
|
2112
|
+
<li>The mandatory <code><rs:md></code> child element of <code><urlset></code> must have a
|
|
2113
|
+
<code>capability</code> attribute with a value of <code>resourcedump-manifest</code>. It must also have an
|
|
2114
|
+
<code>at</code> attribute that conveys the datetime at which the process of taking a snapshot of resources
|
|
2115
|
+
for their inclusion in the ZIP package started, and it may have a <code>completed</code> attribute that conveys
|
|
2116
|
+
the datetime at which that process completed.</li>
|
|
2117
|
+
<li>A mandatory <code><rs:ln></code> child element of <code><urlset></code> points to the Capability List with the relation type
|
|
2118
|
+
<code>up</code>.</li>
|
|
2119
|
+
<li>One <code><url></code> child element of <code><urlset></code> per bitstream. This element does not have attributes, but uses
|
|
2120
|
+
child elements to convey information about the bitstream. The <code><url></code> element has the following child elements:
|
|
2121
|
+
<ul>
|
|
2122
|
+
<li>A mandatory <code><loc></code> child element provides the URI that the Source associates with the bitstream.</li>
|
|
2123
|
+
<li>Optional <code><lastmod></code> and <code><changefreq></code> child elements with semantics as described in <a href="#DocumentFormats">Section 7</a>.
|
|
2124
|
+
</li>
|
|
2125
|
+
<li>A mandatory <code><rs:md></code> child element must have a <code>path</code>
|
|
2126
|
+
attribute to convey the location of the bitstream within the package. The value
|
|
2127
|
+
of the attribute is relative to root of the package and it is expressed with a
|
|
2128
|
+
leading slash (/). The use of the <code>type</code> attribute in the
|
|
2129
|
+
<code><rs:md></code> element is recommended to help Destinations determine
|
|
2130
|
+
the Media Type of the bitstream. The <code><rs:md></code> element may further
|
|
2131
|
+
have the attributes <code>hash</code> and <code>length</code>, as described in
|
|
2132
|
+
<a href="#DocumentFormats">Section 7</a>.</li>
|
|
2133
|
+
<li>Optional <code><rs:ln></code> child elements link to related resources
|
|
2134
|
+
as described in <a href="#DocumentFormats">Section 7</a>, and detailed in
|
|
2135
|
+
<a href="#LinkRelRes">Section 14</a>.</li>
|
|
2136
|
+
</ul>
|
|
2137
|
+
</li>
|
|
2138
|
+
</ul>
|
|
2139
|
+
|
|
2140
|
+
<p>
|
|
2141
|
+
<a href="#ex_18">Example 18</a> shows a Resource Dump Manifest for a ZIP file that contains two bitstreams.
|
|
2142
|
+
</p>
|
|
2143
|
+
|
|
2144
|
+
<a name="ex_18"></a>
|
|
2145
|
+
<div class="exampleInner">
|
|
2146
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
2147
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
2148
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
2149
|
+
<rs:ln rel="up"
|
|
2150
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
2151
|
+
<rs:md <span class="rs">capability="resourcedump-manifest"</span>
|
|
2152
|
+
at="2013-01-03T09:00:00Z"
|
|
2153
|
+
completed="2013-01-03T09:02:00Z"/>
|
|
2154
|
+
<url>
|
|
2155
|
+
<loc>http://example.com/res1</loc>
|
|
2156
|
+
<lastmod>2013-01-02T13:00:00Z</lastmod>
|
|
2157
|
+
<rs:md hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
2158
|
+
length="8876"
|
|
2159
|
+
type="text/html"
|
|
2160
|
+
<span class="rs">path="/resources/res1"</span>/>
|
|
2161
|
+
</url>
|
|
2162
|
+
<url>
|
|
2163
|
+
<loc>http://example.com/res2</loc>
|
|
2164
|
+
<lastmod>2013-01-02T14:00:00Z</lastmod>
|
|
2165
|
+
<rs:md hash="md5:1e0d5cb8ef6ba40c99b14c0237be735e
|
|
2166
|
+
sha-256:854f61290e2e197a11bc91063afce22e43f8ccc655237050ace766adc68dc784"
|
|
2167
|
+
length="14599"
|
|
2168
|
+
type="application/pdf"
|
|
2169
|
+
<span class="rs">path="/resources/res2"</span>/>
|
|
2170
|
+
</url>
|
|
2171
|
+
</urlset>
|
|
2172
|
+
</pre>
|
|
2173
|
+
</div>
|
|
2174
|
+
<p class="caption">Example 18: A Resource Dump Manifest</p>
|
|
2175
|
+
|
|
2176
|
+
|
|
2177
|
+
<h2>12. <a name="DesChanges">Describing Changes</a></h2>
|
|
2178
|
+
<p>
|
|
2179
|
+
A Source may publish a record of the changes to its resources.
|
|
2180
|
+
This enables Destinations to efficiently learn about those changes and
|
|
2181
|
+
hence to synchronize incrementally.
|
|
2182
|
+
</p>
|
|
2183
|
+
|
|
2184
|
+
<h3>12.1 <a name="ChangeList">Change List</a></h3>
|
|
2185
|
+
<p>
|
|
2186
|
+
A <b>Change List</b> is a document that contains a description of changes to a Source's resources.
|
|
2187
|
+
It is up to the Source to determine the publication frequency of Change Lists, as well as the temporal interval they cover.
|
|
2188
|
+
For example, a Source may choose to publish a fixed number of changes per Change List, or all the changes in a period of fixed length,
|
|
2189
|
+
such as an hour, a day, or a week. All entries in a Change List must be provided in forward chronological order:
|
|
2190
|
+
the least recently changed resource must be listed at the beginning of the
|
|
2191
|
+
Change List, while the most recently changed resource must be listed at the end of the document.
|
|
2192
|
+
If a resource underwent multiple changes in the period covered by a Change List, then it will be listed multiple times, once per change.
|
|
2193
|
+
</p>
|
|
2194
|
+
|
|
2195
|
+
<p>
|
|
2196
|
+
A Change List is based on the <code><urlset></code> document format introduced by the Sitemap protocol.
|
|
2197
|
+
It has the <code><urlset></code> root element and the following structure:
|
|
2198
|
+
</p>
|
|
2199
|
+
|
|
2200
|
+
<ul>
|
|
2201
|
+
<li>The mandatory <code><rs:md></code> child element of <code><urlset></code> must have a
|
|
2202
|
+
<code>capability</code> attribute that has a value of <code>changelist</code>. It also has the mandatory
|
|
2203
|
+
<code>from</code> and the optional <code>until</code> attributes to convey the temporal interval
|
|
2204
|
+
covered by the Change List. Details about the semantics of these attributes are provided below.</li>
|
|
2205
|
+
<li>A mandatory <code><rs:ln></code> child element of <code><urlset></code> points to the Capability List with the relation type
|
|
2206
|
+
<code>up</code>.</li>
|
|
2207
|
+
<li>In case a <a href="#ChangeListIndex">Change List Index</a> exists,
|
|
2208
|
+
a recommended <code><rs:ln></code> child element of
|
|
2209
|
+
<code><urlset></code> points to it with the relation type
|
|
2210
|
+
<code>index</code>.</li>
|
|
2211
|
+
<li>One <code><url></code> child element of <code><urlset></code>
|
|
2212
|
+
should be included for each resource change. This element does not have attributes,
|
|
2213
|
+
but uses child elements to convey information about the changed resource.
|
|
2214
|
+
The <code><url></code> element has the following child elements:
|
|
2215
|
+
<ul>
|
|
2216
|
+
<li>A mandatory <code><loc></code> child element provides the URI of the changed resource.</li>
|
|
2217
|
+
<li>Optional <code><lastmod></code> and <code><changefreq></code>
|
|
2218
|
+
child elements with semantics as described in
|
|
2219
|
+
<a href="#DocumentFormats">Section 7</a>.</li>
|
|
2220
|
+
<li>A mandatory <code><rs:md></code> child element must have the attribute <code>change</code> to convey the nature of the change.
|
|
2221
|
+
The value of the <code>change</code> attribute is <code>created</code>,
|
|
2222
|
+
<code>updated</code>, or <code>deleted</code>.
|
|
2223
|
+
The element may also have attributes <code>datetime</code>, <code>hash</code>,
|
|
2224
|
+
<code>length</code>, and <code>type</code>, as described in
|
|
2225
|
+
<a href="#DocumentFormats">Section 7</a>.</li>
|
|
2226
|
+
<li>Optional <code><rs:ln></code> child elements link to related
|
|
2227
|
+
resources as described in <a href="#DocumentFormats">Section 7</a>
|
|
2228
|
+
and detailed in <a href="#LinkRelRes">Section 14</a>.</li>
|
|
2229
|
+
</ul>
|
|
2230
|
+
</li>
|
|
2231
|
+
</ul>
|
|
2232
|
+
|
|
2233
|
+
<p>The temporal interval covered by a Change List is conveyed by means of the <code>from</code> and <code>until</code> attributes of the
|
|
2234
|
+
<code><rs:md></code> child element of the <code><urlset></code> root element.
|
|
2235
|
+
The <code>from</code> attribute indicates that the Change List includes all changes that
|
|
2236
|
+
occurred to the set of resources at the Source since the datetime expressed as the value
|
|
2237
|
+
of the attribute. If it exists, the <code>until</code> attribute indicates that the Change List
|
|
2238
|
+
includes all changes that occurred to the set of resources at the Source until the
|
|
2239
|
+
datetime expressed as the value of the attribute. Its use is optional for Change Lists:</p>
|
|
2240
|
+
<ul>
|
|
2241
|
+
<li>When a document carries the <code>until</code> attribute, this indicates that the document
|
|
2242
|
+
will not be updated anymore; the Change List is closed.
|
|
2243
|
+
When a Destination has finished processing a closed Change List, it should consult the enclosing
|
|
2244
|
+
Change List Index (following the link with the <code>index</code> relation type), if applicable,
|
|
2245
|
+
or the Capability List (following the link with the <code>up</code> relation type)
|
|
2246
|
+
to determine the URI of the Change List that reports the changes that occurred after the datetime expressed as the closed Change List's <code>until</code> value.
|
|
2247
|
+
</li>
|
|
2248
|
+
<li>When a document does not carry the <code>until</code> attribute, this
|
|
2249
|
+
indicates that the document will be updated with further changes; the Change
|
|
2250
|
+
List remains open. A Destination should continue to poll an open Change List
|
|
2251
|
+
to learn about further changes. It does not need to consult the enclosing
|
|
2252
|
+
Change List Index, if applicable, nor the Capability List.
|
|
2253
|
+
</li>
|
|
2254
|
+
</ul>
|
|
2255
|
+
|
|
2256
|
+
<p>
|
|
2257
|
+
The <code>from</code> and <code>until</code> attributes help a Destination to
|
|
2258
|
+
determine whether it has or has not fully processed a Change List. The forward
|
|
2259
|
+
chronological order of changes in a Change List, the datetime of a resource
|
|
2260
|
+
change (if provided), and the URI of a changed resource help the Destination
|
|
2261
|
+
to determine the first unprocessed change in a not fully processed Change List.
|
|
2262
|
+
The Destination should start processing there; it can retrieve a representation
|
|
2263
|
+
of a changed resource by dereferencing its URI provided in the <code><loc></code>
|
|
2264
|
+
child element of the <code><url></code> element that conveys the change.
|
|
2265
|
+
</p>
|
|
2266
|
+
|
|
2267
|
+
<p>
|
|
2268
|
+
<a href="#ex_19">Example 19</a> shows a Change List that indicates that four
|
|
2269
|
+
resource changes occurred since 2013-01-03T00:00:00Z: one creation, two
|
|
2270
|
+
updates, and one deletion. One resource underwent two of these changes and
|
|
2271
|
+
hence is listed twice. The Change List has no <code>until</code> attribute,
|
|
2272
|
+
which indicates that it may report further changes; a Destination should
|
|
2273
|
+
keep polling this Change List. This example illustrates differences between
|
|
2274
|
+
the optional <code><lastmod></code> element and the optional
|
|
2275
|
+
<code>datetime</code> attribute. The creation event is for a resource that has
|
|
2276
|
+
a <code><lastmod></code> earlier than the event's <code>datetime</code>
|
|
2277
|
+
and before the <code>from</code> datetime of the Change List. The first update
|
|
2278
|
+
event shows a matching <code><lastmod></code> element and
|
|
2279
|
+
<code>datetime</code> attribute. The second update event has neither a
|
|
2280
|
+
<code><lastmod></code> element nor a <code>datetime</code> attribute,
|
|
2281
|
+
though its position in the Change List indicates that it was a later update
|
|
2282
|
+
of the resource. The Source can make it easier for a Destination to determine
|
|
2283
|
+
which change event it has last processed by providing a <code>datetime</code>
|
|
2284
|
+
attribute for each event.
|
|
2285
|
+
</p>
|
|
2286
|
+
|
|
2287
|
+
<a name="ex_19"></a>
|
|
2288
|
+
<div class="exampleInner">
|
|
2289
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
2290
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
2291
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
2292
|
+
<rs:ln rel="up"
|
|
2293
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
2294
|
+
<rs:md <span class="rs">capability="changelist"
|
|
2295
|
+
from="2013-01-03T00:00:00Z"</span>/>
|
|
2296
|
+
<url>
|
|
2297
|
+
<loc>http://example.com/res1.html</loc>
|
|
2298
|
+
<lastmod><span class="rs">2000-01-01T01:01:00Z</span></lastmod>
|
|
2299
|
+
<rs:md <span class="rs">change="created" datetime="2013-01-03T11:00:00Z"</span>/>
|
|
2300
|
+
</url>
|
|
2301
|
+
<url>
|
|
2302
|
+
<loc>http://example.com/res2.pdf</loc>
|
|
2303
|
+
<lastmod><span class="rs">2013-01-03T13:00:00Z</span></lastmod>
|
|
2304
|
+
<rs:md <span class="rs">change="updated" datetime="2013-01-03T13:00:00Z"</span>/>
|
|
2305
|
+
</url>
|
|
2306
|
+
<url>
|
|
2307
|
+
<loc>http://example.com/res3.tiff</loc>
|
|
2308
|
+
<rs:md <span class="rs">change="deleted" datetime="2013-01-03T18:00:00Z"</span>/>
|
|
2309
|
+
</url>
|
|
2310
|
+
<url>
|
|
2311
|
+
<loc><span class="rs">http://example.com/res2.pdf</span></loc>
|
|
2312
|
+
<rs:md <span class="rs">change="updated"</span>/>
|
|
2313
|
+
</url>
|
|
2314
|
+
</urlset>
|
|
2315
|
+
</pre>
|
|
2316
|
+
</div>
|
|
2317
|
+
<p class="caption">Example 19: An open Change List describing four resource changes</p>
|
|
2318
|
+
|
|
2319
|
+
<h3>12.2 <a name="ChangeListIndex">Change List Index</a></h3>
|
|
2320
|
+
|
|
2321
|
+
<p>
|
|
2322
|
+
If a Source needs to publish multiple Change Lists, it must group them in a Change List Index.
|
|
2323
|
+
A Change List Index must enumerate Change Lists in forward chronological order.
|
|
2324
|
+
</p>
|
|
2325
|
+
|
|
2326
|
+
<p>
|
|
2327
|
+
A Change List Index is based on the <code><sitemapindex></code> document format introduced by the Sitemap protocol.
|
|
2328
|
+
It has the <code><sitemapindex></code> root element and the following structure:
|
|
2329
|
+
</p>
|
|
2330
|
+
<ul>
|
|
2331
|
+
<li>The mandatory <code><rs:md></code> child element of <code><sitemapindex></code> must have a
|
|
2332
|
+
<code>capability</code> attribute that has a value of <code>changelist</code>. It also has the mandatory
|
|
2333
|
+
<code>from</code> and the optional <code>until</code> attributes to convey the temporal interval
|
|
2334
|
+
covered by the Change List Index. The semantics of these attributes are as explained in detail for
|
|
2335
|
+
<a href="#ChangeList">Change Lists</a>.</li>
|
|
2336
|
+
<li>A mandatory <code><rs:ln></code> child element of <code><sitemapindex></code>
|
|
2337
|
+
points to the Capability List with the relation type <code>up</code>.</li>
|
|
2338
|
+
<li>One <code><sitemap></code> child element of <code><sitemapindex></code>
|
|
2339
|
+
should be included for each Change List. This element does not have attributes, but
|
|
2340
|
+
uses child elements to convey information about the Change List. The
|
|
2341
|
+
<code><sitemap></code> element has the following child elements:
|
|
2342
|
+
<ul>
|
|
2343
|
+
<li>A mandatory <code><loc></code> child element provides the URI of the Change List.</li>
|
|
2344
|
+
<li>An optional <code><lastmod></code> child element with semantics as described in
|
|
2345
|
+
<a href="#DocumentFormats">Section 7</a>.</li>
|
|
2346
|
+
<li>A recommended <code><rs:md></code> child element with the <code>from</code> and possibly <code>until</code>
|
|
2347
|
+
attributes to convey the temporal interval covered by the Change List. The use of the <code>until</code> is as follows:
|
|
2348
|
+
<ul>
|
|
2349
|
+
<li>If the Change List is closed the use of <code><until></code> is required.</li>
|
|
2350
|
+
<li>If the Change List is open <code><until></code> must not be provided.</li>
|
|
2351
|
+
</ul>
|
|
2352
|
+
</li>
|
|
2353
|
+
</ul>
|
|
2354
|
+
</li>
|
|
2355
|
+
</ul>
|
|
2356
|
+
|
|
2357
|
+
<p>
|
|
2358
|
+
The Destination should determine whether it has reached a Change List or a
|
|
2359
|
+
Change List Index based on whether the root element is
|
|
2360
|
+
<code><urlset></code> or <code><sitemapindex></code> respectively.
|
|
2361
|
+
</p>
|
|
2362
|
+
<p>
|
|
2363
|
+
A Change List Index that points to three Change Lists is shown in
|
|
2364
|
+
<a href="#ex_20">Example 20</a>. Two of those Change Lists are closed, as
|
|
2365
|
+
indicated by the presence of the <code>until</code> attribute,
|
|
2366
|
+
and one is open, as indicated by its absence. The closed Change List
|
|
2367
|
+
<code>http://example.com/20130102-changelist.xml</code> is shown in
|
|
2368
|
+
<a href="#ex_21">Example 21</a>.
|
|
2369
|
+
The open Change List could be the one shown in
|
|
2370
|
+
<a href="#ex_19">Example 19</a>, in which case that list would have an additional link
|
|
2371
|
+
with an <code>index</code> relation type pointing to the Change List Index.
|
|
2372
|
+
</p>
|
|
2373
|
+
|
|
2374
|
+
<a name="ex_20"></a>
|
|
2375
|
+
<div class="exampleInner">
|
|
2376
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
2377
|
+
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
2378
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
2379
|
+
<rs:ln rel="up"
|
|
2380
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
2381
|
+
<rs:md <span class="rs">capability="changelist"
|
|
2382
|
+
from="2013-01-01T00:00:00Z"</span>/>
|
|
2383
|
+
<sitemap>
|
|
2384
|
+
<loc>http://example.com/20130101-changelist.xml</loc>
|
|
2385
|
+
<rs:md <span class="rs">from="2013-01-01T00:00:00Z"
|
|
2386
|
+
until="2013-01-02T00:00:00Z"</span>/>
|
|
2387
|
+
</sitemap>
|
|
2388
|
+
<sitemap>
|
|
2389
|
+
<loc>http://example.com/20130102-changelist.xml</loc>
|
|
2390
|
+
<rs:md from="2013-01-02T00:00:00Z"
|
|
2391
|
+
until="2013-01-03T00:00:00Z"/>
|
|
2392
|
+
</sitemap>
|
|
2393
|
+
<sitemap>
|
|
2394
|
+
<loc>http://example.com/20130103-changelist.xml</loc>
|
|
2395
|
+
<rs:md from="2013-01-03T00:00:00Z"/>
|
|
2396
|
+
</sitemap>
|
|
2397
|
+
</sitemapindex>
|
|
2398
|
+
</pre>
|
|
2399
|
+
</div>
|
|
2400
|
+
<p class="caption">Example 20: A Change List Index</p>
|
|
2401
|
+
|
|
2402
|
+
<a name="ex_21"></a>
|
|
2403
|
+
<div class="exampleInner">
|
|
2404
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
2405
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
2406
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
2407
|
+
<rs:ln rel="up"
|
|
2408
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
2409
|
+
<rs:ln <span class="rs">rel="index"</span>
|
|
2410
|
+
href="http://example.com/dataset1/changelist.xml"/>
|
|
2411
|
+
<rs:md <span class="rs">capability="changelist"
|
|
2412
|
+
from="2013-01-02T00:00:00Z"
|
|
2413
|
+
until="2013-01-03T00:00:00Z"</span>/>
|
|
2414
|
+
<url>
|
|
2415
|
+
<loc>http://example.com/res7.html</loc>
|
|
2416
|
+
<rs:md change="created" datetime="2013-01-02T12:00:00Z"/>
|
|
2417
|
+
</url>
|
|
2418
|
+
<url>
|
|
2419
|
+
<loc>http://example.com/res9.pdf</loc>
|
|
2420
|
+
<rs:md change="updated" datetime="2013-01-02T13:00:00Z"/>
|
|
2421
|
+
</url>
|
|
2422
|
+
<url>
|
|
2423
|
+
<loc>http://example.com/res5.tiff</loc>
|
|
2424
|
+
<rs:md change="deleted" datetime="2013-01-02T19:00:00Z"/>
|
|
2425
|
+
</url>
|
|
2426
|
+
<url>
|
|
2427
|
+
<loc>http://example.com/res7.html</loc>
|
|
2428
|
+
<rs:md change="updated" datetime="2013-01-02T20:00:00Z"/>
|
|
2429
|
+
</url>
|
|
2430
|
+
</urlset>
|
|
2431
|
+
</pre>
|
|
2432
|
+
</div>
|
|
2433
|
+
<p class="caption">Example 21: A closed Change List pointing back to its Index</p>
|
|
2434
|
+
|
|
2435
|
+
|
|
2436
|
+
<h2>13. <a name="PackChanges">Packaging Changes</a></h2>
|
|
2437
|
+
<p>
|
|
2438
|
+
In order to reduce the number of requests required to obtain resource changes,
|
|
2439
|
+
a Source may provide packaged bitstreams for changed resources.
|
|
2440
|
+
</p>
|
|
2441
|
+
|
|
2442
|
+
<h3>13.1 <a name="ChangeDump">Change Dump</a></h3>
|
|
2443
|
+
<p>
|
|
2444
|
+
To make content changes available for download, a Source may publish
|
|
2445
|
+
<b>Change Dumps</b>. A Change Dump is a document that points to packages
|
|
2446
|
+
containing bitstreams for the Source's changed resources.
|
|
2447
|
+
The ResourceSync framework specifies the use of the <a href="#ref-zip">ZIP file format</a> as
|
|
2448
|
+
the packaging format. Communities may define their own packaging format.
|
|
2449
|
+
A Change Dump should only point to packages of the same format.
|
|
2450
|
+
</p>
|
|
2451
|
+
<p>
|
|
2452
|
+
It is up to the Source to determine the publication frequency of these packages,
|
|
2453
|
+
as well as the temporal interval they cover.
|
|
2454
|
+
For example, a Source may choose to publish a fixed number of changes per package, or all the
|
|
2455
|
+
changes in a period of fixed length, such as an hour, a day, or a week.
|
|
2456
|
+
If a resource underwent multiple changes in the period covered by a package,
|
|
2457
|
+
then the package will contain multiple bitstreams for the resource, one per change.
|
|
2458
|
+
As new packages are published, new entries are added to the Change Dump that points at them.
|
|
2459
|
+
All entries in a Change Dump should be provided in forward chronological
|
|
2460
|
+
order: the least recently published package listed at the beginning of the
|
|
2461
|
+
Change Dump, the most recently published package listed at the end of the document.
|
|
2462
|
+
</p>
|
|
2463
|
+
|
|
2464
|
+
<p>
|
|
2465
|
+
A Change Dump is based on the <code><urlset></code> document format
|
|
2466
|
+
introduced by the Sitemap protocol. It has the <code><urlset></code>
|
|
2467
|
+
root element and the following structure:
|
|
2468
|
+
</p>
|
|
2469
|
+
<ul>
|
|
2470
|
+
<li>The mandatory <code><rs:md></code> child element of <code><urlset></code> must have a
|
|
2471
|
+
<code>capability</code> attribute that has a value of <code>changedump</code>. It also has the
|
|
2472
|
+
mandatory <code>from</code> and the optional <code>until</code> attributes to convey the temporal interval
|
|
2473
|
+
covered by the Change Dump. The semantics of these attributes are as explained in detail for
|
|
2474
|
+
<a href="#ChangeList">Change Lists</a>.</li>
|
|
2475
|
+
<li> A mandatory <code><rs:ln></code> child element of <code><urlset></code> points to the Capability List with the relation type
|
|
2476
|
+
<code>up</code>.</li>
|
|
2477
|
+
<li>In case a <a href="#ChangeDumpIndex">Change Dump Index</a> exists,
|
|
2478
|
+
a recommended <code><rs:ln></code> child element of
|
|
2479
|
+
<code><urlset></code> points to it with the relation type
|
|
2480
|
+
<code>index</code>.</li>
|
|
2481
|
+
<li>One <code><url></code> child element of <code><urlset></code>
|
|
2482
|
+
should be included for each bitstream package. This element does not have
|
|
2483
|
+
attributes, but uses child elements to convey information about the package.
|
|
2484
|
+
The <code><url></code> element has the following child elements:
|
|
2485
|
+
<ul>
|
|
2486
|
+
<li>A mandatory <code><loc></code> child element provides the URI of the package.</li>
|
|
2487
|
+
<li>An optional <code><lastmod></code> child element with semantics as described in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
2488
|
+
<li>A recommended <code><rs:md></code> child element to convey the Media Type
|
|
2489
|
+
and the length of the package using the <code>type</code> and <code>length</code>
|
|
2490
|
+
attribute, respectively. It may also have the <code>from</code> and <code>until</code>
|
|
2491
|
+
attributes to convey the temporal interval covered by the package. The child element
|
|
2492
|
+
may further have attributes such as <code>hash</code>, as described in
|
|
2493
|
+
<a href="#DocumentFormats">Section 7</a>.</li>
|
|
2494
|
+
<li>An optional <code><rs:ln></code> child element with the relation type <code>contents</code> that points to
|
|
2495
|
+
a copy of the Change Dump Manifest associated with each package.</li>
|
|
2496
|
+
</ul>
|
|
2497
|
+
</li>
|
|
2498
|
+
</ul>
|
|
2499
|
+
|
|
2500
|
+
<p>
|
|
2501
|
+
<a href="#ex_22">Example 22</a> shows a Change Dump with pointers to three
|
|
2502
|
+
bitstream packages associated with changed resources. The absence of the
|
|
2503
|
+
<code>until</code> attribute indicates that further packages will be added.
|
|
2504
|
+
The example also includes within each <code><url></code> element a pointer to a copy of
|
|
2505
|
+
the <a href="#ChangeDumpManifest">Change Dump Manifest</a> associated with the package.
|
|
2506
|
+
This pointer is optional and intended to allow a Destination
|
|
2507
|
+
to determine whether the package should be downloaded.
|
|
2508
|
+
If such pointers are provided, the Source must ensure that the Manifest referred to
|
|
2509
|
+
matches the Manifest included in the bitstream package.
|
|
2510
|
+
</p>
|
|
2511
|
+
|
|
2512
|
+
<a name="ex_22"></a>
|
|
2513
|
+
<div class="exampleInner">
|
|
2514
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
2515
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
2516
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
2517
|
+
<rs:ln rel="up"
|
|
2518
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
2519
|
+
<rs:md <span class="rs">capability="changedump"</span>
|
|
2520
|
+
from="2013-01-01T00:00:00Z"/>
|
|
2521
|
+
<url>
|
|
2522
|
+
<loc>http://example.com/20130101-changedump.zip</loc>
|
|
2523
|
+
<lastmod>2013-01-01T23:59:59Z</lastmod>
|
|
2524
|
+
<rs:md <span class="rs">type="application/zip"
|
|
2525
|
+
length="3109"
|
|
2526
|
+
from="2013-01-01T00:00:00Z"
|
|
2527
|
+
until="2013-01-02T00:00:00Z"</span>/>
|
|
2528
|
+
<rs:ln <span class="rs">rel="contents"</span>
|
|
2529
|
+
href="http://example.com/20130101-changedump-manifest.xml"
|
|
2530
|
+
type="application/xml"/>
|
|
2531
|
+
</url>
|
|
2532
|
+
<url>
|
|
2533
|
+
<loc>http://example.com/20130102-changedump.zip</loc>
|
|
2534
|
+
<lastmod>2013-01-02T23:59:59Z</lastmod>
|
|
2535
|
+
<rs:md type="application/zip"
|
|
2536
|
+
length="6629"
|
|
2537
|
+
from="2013-01-02T00:00:00Z"
|
|
2538
|
+
until="2013-01-03T00:00:00Z"/>
|
|
2539
|
+
<rs:ln rel="contents"
|
|
2540
|
+
href="http://example.com/20130102-changedump-manifest.xml"
|
|
2541
|
+
type="application/xml"/>
|
|
2542
|
+
</url>
|
|
2543
|
+
<url>
|
|
2544
|
+
<loc>http://example.com/20130103-changedump.zip</loc>
|
|
2545
|
+
<lastmod>2013-01-03T23:59:59Z</lastmod>
|
|
2546
|
+
<rs:md type="application/zip"
|
|
2547
|
+
length="8124"
|
|
2548
|
+
from="2013-01-03T00:00:00Z"
|
|
2549
|
+
until="2013-01-04T00:00:00Z"/>
|
|
2550
|
+
<rs:ln rel="contents"
|
|
2551
|
+
href="http://example.com/20130103-changedump-manifest.xml"
|
|
2552
|
+
type="application/xml"/>
|
|
2553
|
+
</url>
|
|
2554
|
+
</urlset>
|
|
2555
|
+
</pre>
|
|
2556
|
+
</div>
|
|
2557
|
+
<p class="caption">Example 22: A Change Dump</p>
|
|
2558
|
+
<p>
|
|
2559
|
+
If a Source needs to publish multiple Change Dumps, it must group them in
|
|
2560
|
+
a <a name="ChangeDumpIndex">Change Dump Index</a>, in a manner similar to
|
|
2561
|
+
what was described in <a href="#ChangeListIndex">Section 12.2</a>.
|
|
2562
|
+
</p>
|
|
2563
|
+
|
|
2564
|
+
<h3>13.2 <a name="ChangeDumpManifest">Change Dump Manifest</a></h3>
|
|
2565
|
+
<p>
|
|
2566
|
+
Each ZIP package referred to from a Change Dump must contain a
|
|
2567
|
+
<b>Change Dump Manifest</b> file that describes the constituent bitstreams of the package.
|
|
2568
|
+
The file must be named <code>manifest.xml</code>
|
|
2569
|
+
and must be located at the top level of the ZIP package.
|
|
2570
|
+
All entries in a Change Dump Manifest must be provided in forward chronological order:
|
|
2571
|
+
the bitstream associated with the least
|
|
2572
|
+
recent resource change is listed first, and the bitstream associated with the most recent change
|
|
2573
|
+
is listed last.
|
|
2574
|
+
</p>
|
|
2575
|
+
|
|
2576
|
+
<p>
|
|
2577
|
+
The Change Dump Manifest is based on the <code><urlset></code> format.
|
|
2578
|
+
It has the <code><urlset></code> root element and the following structure:
|
|
2579
|
+
</p>
|
|
2580
|
+
<ul>
|
|
2581
|
+
<li>The mandatory <code><rs:md></code> child element of <code><urlset></code> must have a
|
|
2582
|
+
<code>capability</code> attribute that has a value of <code>changedump-manifest</code>.
|
|
2583
|
+
It also has the mandatory
|
|
2584
|
+
<code>from</code> and the optional <code>until</code> attributes to convey the temporal interval
|
|
2585
|
+
covered by the ZIP package in which the Change Dump Manifest is contained:
|
|
2586
|
+
bitstream for all resource changes that occurred during the specified
|
|
2587
|
+
interval must be included in the ZIP package and the Change Dump Manifest must refer to each.</li>
|
|
2588
|
+
<li>A mandatory <code><rs:ln></code> child element of <code><urlset></code> points to the Capability List with the relation type
|
|
2589
|
+
<code>up</code>.</li>
|
|
2590
|
+
<li>One <code><url></code> child element of <code><urlset></code>
|
|
2591
|
+
should be included for each resource change, and hence for each bitstream.
|
|
2592
|
+
This element does not have attributes, but uses child elements to convey
|
|
2593
|
+
information about the resource change and its associated bitstream.
|
|
2594
|
+
The <code><url></code> element has the following child elements:
|
|
2595
|
+
<ul>
|
|
2596
|
+
<li>A mandatory <code><loc></code> child element provides the URI
|
|
2597
|
+
which the Source associates with the bitstream.</li>
|
|
2598
|
+
<li>Optional <code><lastmod></code> and <code><changefreq></code>
|
|
2599
|
+
child elements with semantics as described in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
2600
|
+
<li>A mandatory <code><rs:md></code> child element must have a <code>change</code>
|
|
2601
|
+
attribute to convey the type of change the resource underwent. The <code>change</code>
|
|
2602
|
+
attribute value may be <code>created</code>, <code>updated</code>, or <code>deleted</code>.
|
|
2603
|
+
Except in the case of <code>change="deleted"</code>, the element must also have a
|
|
2604
|
+
<code>path</code> attribute to convey the location of the bitstream within the ZIP
|
|
2605
|
+
package. The path is relative to root of the package and it is expressed with a
|
|
2606
|
+
leading slash (/). The use of the <code>type</code> attribute in the
|
|
2607
|
+
<code><rs:md></code> element is strongly recommended to help Destinations
|
|
2608
|
+
determine the Media Type of the bitstream. The <code><rs:md></code> element may
|
|
2609
|
+
further have the attributes <code>datetime</code>, <code>hash</code> and
|
|
2610
|
+
<code>length</code>, as described in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
2611
|
+
<li>Optional <code><rs:ln></code> child elements link to related resources
|
|
2612
|
+
as described in <a href="#DocumentFormats">Section 7</a> and detailed in <a href="#LinkRelRes">Section 14</a>.</li>
|
|
2613
|
+
</ul>
|
|
2614
|
+
</li>
|
|
2615
|
+
</ul>
|
|
2616
|
+
<p>
|
|
2617
|
+
<a href="#ex_23">Example 23</a> shows the Change Dump Manifest associated with the
|
|
2618
|
+
second entry in the Resource Dump from <a href="#ex_22">Example 22</a>. The Manifest
|
|
2619
|
+
must be named <code>manifest.xml</code> at the top level of the ZIP package. A copy
|
|
2620
|
+
of the Manifest may also be provided at a location indicated by an
|
|
2621
|
+
optional <code><rs:ln></code> element with the relation type
|
|
2622
|
+
<code>contents</code> in the Change Dump,
|
|
2623
|
+
<code>http://example.com/20130102-changedump-manifest.xml</code> in
|
|
2624
|
+
<a href="#ex_22">Example 22</a>. The Manifest covers the same
|
|
2625
|
+
changes as conveyed in the closed Change List of <a href="#ex_21">Example 21</a>.
|
|
2626
|
+
The resource <code>http://example.com/res7.html</code> is listed twice, once
|
|
2627
|
+
because it was created, and once because it was updated. Both entries have
|
|
2628
|
+
the same URI. The ZIP package in which this Manifest is contained has two
|
|
2629
|
+
bitstreams for this resource, available at different paths in the package.
|
|
2630
|
+
</p>
|
|
2631
|
+
|
|
2632
|
+
<a name="ex_23"></a>
|
|
2633
|
+
<div class="exampleInner">
|
|
2634
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
2635
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
2636
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
2637
|
+
<rs:ln rel="up"
|
|
2638
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
2639
|
+
<rs:md <span class="rs">capability="changedump-manifest"
|
|
2640
|
+
from="2013-01-02T00:00:00Z"
|
|
2641
|
+
until="2013-01-03T00:00:00Z"</span>/>
|
|
2642
|
+
<url>
|
|
2643
|
+
<loc>http://example.com/res7.html</loc>
|
|
2644
|
+
<lastmod>2013-01-02T12:00:00Z</lastmod>
|
|
2645
|
+
<rs:md change="created"
|
|
2646
|
+
datetime="2013-01-02T12:00:00Z"
|
|
2647
|
+
hash="md5:1c1b0e264fa9b7e1e9aa6f9db8d6362b"
|
|
2648
|
+
length="4339"
|
|
2649
|
+
type="text/html"
|
|
2650
|
+
<span class="rs">path="/changes/res7.html"</span>/>
|
|
2651
|
+
</url>
|
|
2652
|
+
<url>
|
|
2653
|
+
<loc>http://example.com/res9.pdf</loc>
|
|
2654
|
+
<lastmod>2013-01-02T13:00:00Z</lastmod>
|
|
2655
|
+
<rs:md change="updated"
|
|
2656
|
+
datetime="2013-01-02T13:00:00Z"
|
|
2657
|
+
hash="md5:f906610c3d4aa745cb2b986f25b37c5a"
|
|
2658
|
+
length="38297"
|
|
2659
|
+
type="application/pdf"
|
|
2660
|
+
<span class="rs">path="/changes/res9.pdf"</span>/>
|
|
2661
|
+
</url>
|
|
2662
|
+
<url>
|
|
2663
|
+
<loc>http://example.com/res5.tiff</loc>
|
|
2664
|
+
<rs:md change="deleted"
|
|
2665
|
+
datetime="2013-01-02T19:00:00Z"/>
|
|
2666
|
+
|
|
2667
|
+
</url>
|
|
2668
|
+
<url>
|
|
2669
|
+
<loc>http://example.com/res7.html</loc>
|
|
2670
|
+
<lastmod>2013-01-02T20:00:00Z</lastmod>
|
|
2671
|
+
<rs:md change="updated"
|
|
2672
|
+
datetime="2013-01-02T20:00:00Z"
|
|
2673
|
+
hash="md5:0988647082c8bc51778894a48ec3b576"
|
|
2674
|
+
length="5426"
|
|
2675
|
+
type="text/html"
|
|
2676
|
+
<span class="rs">path="/changes/res7-v2.html"</span>/>
|
|
2677
|
+
</url>
|
|
2678
|
+
</urlset>
|
|
2679
|
+
</pre>
|
|
2680
|
+
</div>
|
|
2681
|
+
<p class="caption">Example 23: A Change Dump Manifest</p>
|
|
2682
|
+
|
|
2683
|
+
|
|
2684
|
+
<h2>14. <a name="LinkRelRes">Linking to Related Resources</a></h2>
|
|
2685
|
+
|
|
2686
|
+
<h3>14.1 <a name="LinkRelRevOverview">Overview</a></h3>
|
|
2687
|
+
<p>
|
|
2688
|
+
In order to facilitate alternative approaches to obtain content for a
|
|
2689
|
+
resource that is subject to synchronization or to provide additional
|
|
2690
|
+
information about it, a Source may provide links from that resource to
|
|
2691
|
+
related resources. Such links may occur in Resource Lists, Resource Dump
|
|
2692
|
+
Manifests, Change Lists, and Change Dump Manifests. The following cases
|
|
2693
|
+
are considered and detailed (in examples of Change Lists) in the
|
|
2694
|
+
remainder of this section:
|
|
2695
|
+
</p>
|
|
2696
|
+
<ul>
|
|
2697
|
+
<li>The Source makes the resource content available at a mirror location.</li>
|
|
2698
|
+
<li>The Source provides alternate representations for the resource.</li>
|
|
2699
|
+
<li>The Source details the difference between the current and the previous version
|
|
2700
|
+
of the resource.</li>
|
|
2701
|
+
<li>The Source makes a resource as well as metadata about the resource available
|
|
2702
|
+
for synchronization.</li>
|
|
2703
|
+
<li>The Source provides access to prior versions of the resource.</li>
|
|
2704
|
+
<li>The Source provides collection membership information about the resource.</li>
|
|
2705
|
+
<li>A Destination republishes a resource obtained from a Source, makes that
|
|
2706
|
+
republished resource available for synchronization (i.e. acts as a Source itself),
|
|
2707
|
+
and links to the original resource that it republished.</li>
|
|
2708
|
+
</ul>
|
|
2709
|
+
|
|
2710
|
+
<p>
|
|
2711
|
+
As always, the <code><loc></code> child element of <code><url></code>
|
|
2712
|
+
conveys the URI of the resource that is subject to synchronization. The related
|
|
2713
|
+
resource is provided by means of the <code><rs:ln></code> child element
|
|
2714
|
+
of <code><url></code>. The possible attributes for
|
|
2715
|
+
<code><rs:ln></code> as well as the link relation types used to address
|
|
2716
|
+
the aforementioned use cases are detailed in <a href="#DocumentFormats">Section 7</a>.
|
|
2717
|
+
Links to meet needs other than the ones listed may be provided, and appropriate
|
|
2718
|
+
relation types may be selected from the
|
|
2719
|
+
<a href="http://www.iana.org/assignments/link-relations/link-relations.xml">IANA Link Relation Type Registry</a>
|
|
2720
|
+
or expressed as URIs as specified in <a href="#ref-rfc5988">RFC 5988, Sec. 4.2</a>.
|
|
2721
|
+
</p>
|
|
2722
|
+
|
|
2723
|
+
<p>
|
|
2724
|
+
In case a Destination is not able to adequately interpret the information conveyed in
|
|
2725
|
+
an <code><rs:ln></code> element, it should refrain from accessing the related
|
|
2726
|
+
resource and rather use the URI provided in <code><loc></code> to retrieve
|
|
2727
|
+
the resource.
|
|
2728
|
+
</p>
|
|
2729
|
+
|
|
2730
|
+
<h3>14.2 <a name="MirCon">Mirrored Content</a></h3>
|
|
2731
|
+
<p>
|
|
2732
|
+
In order to reduce the load on its primary access mechanism, a Source may convey
|
|
2733
|
+
one or more mirror locations for a resource. An <code><rs:ln></code> element
|
|
2734
|
+
is introduced to express each mirror location for the resource. This element
|
|
2735
|
+
has the following attributes:</p>
|
|
2736
|
+
<ul>
|
|
2737
|
+
<li>A mandatory <code>rel</code> attribute with a value of <code>duplicate</code>.</li>
|
|
2738
|
+
<li>A mandatory <code>href</code> attribute that conveys the URI of the mirrored resource.</li>
|
|
2739
|
+
<li>An optional <code>pri</code> attribute to express a prioritization among multiple mirror locations, each expressed by means of an individual
|
|
2740
|
+
<code><rs:ln></code> element. The use of <code>pri</code> is detailed in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
2741
|
+
<li>Other attributes are as described for the <code><rs:ln></code> child element of
|
|
2742
|
+
<code><url></code> in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
2743
|
+
</ul>
|
|
2744
|
+
|
|
2745
|
+
<p>
|
|
2746
|
+
<a href="#ex_24">Example 24</a> shows how a Source conveys information about
|
|
2747
|
+
prioritized mirror locations for a resource. Since the three locations conveyed
|
|
2748
|
+
by <code><rs:ln></code> elements point to duplicates of the resource specified in
|
|
2749
|
+
<code><loc></code>, the values for each of the attributes of
|
|
2750
|
+
<code><rs:md></code> are expected to be identical for the resource and its
|
|
2751
|
+
mirrors. Hence, they should be omitted from the <code><rs:ln></code> elements.
|
|
2752
|
+
The last <code><rs:ln></code> element points to a mirror location where the
|
|
2753
|
+
resource is accessible via a protocol other than HTTP as can be seen from the URI
|
|
2754
|
+
scheme. Even though the resources are duplicates, their last modified datetimes may vary.
|
|
2755
|
+
</p>
|
|
2756
|
+
|
|
2757
|
+
<a name="ex_24"></a>
|
|
2758
|
+
<div class="exampleInner">
|
|
2759
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
2760
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
2761
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
2762
|
+
<rs:ln rel="up"
|
|
2763
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
2764
|
+
<rs:md capability="changelist"
|
|
2765
|
+
from="2013-01-03T00:00:00Z"/>
|
|
2766
|
+
<url>
|
|
2767
|
+
<loc>http://example.com/res1</loc>
|
|
2768
|
+
<lastmod>2013-01-03T18:00:00Z</lastmod>
|
|
2769
|
+
<rs:md change="updated"
|
|
2770
|
+
hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
2771
|
+
length="8876"
|
|
2772
|
+
type="text/html"/>
|
|
2773
|
+
<rs:ln <span class="rs">rel="duplicate"</span>
|
|
2774
|
+
<span class="rs">pri="1"</span>
|
|
2775
|
+
href="http://mirror1.example.com/res1"
|
|
2776
|
+
modified="2013-01-03T18:00:00Z"/>
|
|
2777
|
+
<rs:ln <span class="rs">rel="duplicate"</span>
|
|
2778
|
+
<span class="rs">pri="2"</span>
|
|
2779
|
+
href="http://mirror2.example.com/res1"
|
|
2780
|
+
modified="2013-01-03T18:00:00Z"/>
|
|
2781
|
+
<rs:ln <span class="rs">rel="duplicate"</span>
|
|
2782
|
+
<span class="rs">pri="3"</span>
|
|
2783
|
+
href="gsiftp://gridftp.example.com/res1"
|
|
2784
|
+
modified="2013-01-03T18:00:23Z"/>
|
|
2785
|
+
</url>
|
|
2786
|
+
</urlset>
|
|
2787
|
+
</pre>
|
|
2788
|
+
</div>
|
|
2789
|
+
<p class="caption">Example 24: Mirrored content</p>
|
|
2790
|
+
|
|
2791
|
+
|
|
2792
|
+
<h3>14.3 <a name="AltRep">Alternate Representations</a></h3>
|
|
2793
|
+
<p>
|
|
2794
|
+
A resource may have multiple representations available from different URIs.
|
|
2795
|
+
A resource may, for example, be identified by a generic URI such as
|
|
2796
|
+
<code>http://example.com/res1</code>. After performing content negotiation
|
|
2797
|
+
with the server, a client may, for example, obtain the resource's HTML
|
|
2798
|
+
representation available from the specific URI
|
|
2799
|
+
<code>http://example.com/res1.html</code>. Another client may ask for and
|
|
2800
|
+
retrieve the PDF representation of the
|
|
2801
|
+
resource from the specific URI <code>http://example.com/res1.pdf</code>.
|
|
2802
|
+
Which representation a client obtains, can depend on its
|
|
2803
|
+
preferences in terms of Media Type and language, its geographical location,
|
|
2804
|
+
and its device type.
|
|
2805
|
+
</p>
|
|
2806
|
+
<p>
|
|
2807
|
+
A Source may express that a resource is subject to synchronization by conveying its
|
|
2808
|
+
generic URI in <code><loc></code>. In this case, per alternate representation
|
|
2809
|
+
that the Source wants to advertise, an <code><rs:ln></code> element is
|
|
2810
|
+
introduced. This element has the following attributes:
|
|
2811
|
+
</p>
|
|
2812
|
+
<ul>
|
|
2813
|
+
<li>A mandatory <code>rel</code> attribute with a value of <code>alternate</code>.</li>
|
|
2814
|
+
<li>A mandatory <code>href</code> attribute that conveys the specific URI of the alternate
|
|
2815
|
+
representation of the resource.</li>
|
|
2816
|
+
<li>A recommended <code>type</code> attribute that conveys the Media Type of the
|
|
2817
|
+
alternate representation.</li>
|
|
2818
|
+
<li>Other attributes, as described for the <code><rs:ln></code> child element of
|
|
2819
|
+
<code><url></code> in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
2820
|
+
</ul>
|
|
2821
|
+
|
|
2822
|
+
<p>
|
|
2823
|
+
Cases exist in which there is no generic URI for a resource, only specific URIs.
|
|
2824
|
+
This may occur, for example, when a resource has different representations
|
|
2825
|
+
available for different devices.
|
|
2826
|
+
In this case the URI in <code><loc></code> will be a specific URI, and
|
|
2827
|
+
<code><rs:ln></code> elements with an <code>alternate</code> relation
|
|
2828
|
+
type are still used to refer to alternate representations available from other
|
|
2829
|
+
specific URIs.
|
|
2830
|
+
</p>
|
|
2831
|
+
<p>
|
|
2832
|
+
<a href="#ex_25">Example 25</a> shows how to promote a generic URI in <code><loc></code>
|
|
2833
|
+
while also pointing to alternate representations available from specific URIs,
|
|
2834
|
+
for example, through content negotiation.
|
|
2835
|
+
</p>
|
|
2836
|
+
|
|
2837
|
+
<a name="ex_25"></a>
|
|
2838
|
+
<div class="exampleInner">
|
|
2839
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
2840
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
2841
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
2842
|
+
<rs:ln rel="up"
|
|
2843
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
2844
|
+
<rs:md capability="changelist"
|
|
2845
|
+
from="2013-01-03T11:00:00Z"/>
|
|
2846
|
+
<url>
|
|
2847
|
+
<loc>http://example.com/res1</loc>
|
|
2848
|
+
<rs:md change="updated"
|
|
2849
|
+
datetime="2013-01-03T18:00:00Z"/>
|
|
2850
|
+
<rs:ln <span class="rs">rel="alternate"</span>
|
|
2851
|
+
href="http://example.com/res1.html"
|
|
2852
|
+
<span class="rs">type="text/html"</span>/>
|
|
2853
|
+
<rs:ln rel="alternate"
|
|
2854
|
+
href="http://example.com/res1.pdf"
|
|
2855
|
+
<span class="rs">type="application/pdf"</span>/>
|
|
2856
|
+
</url>
|
|
2857
|
+
</urlset>
|
|
2858
|
+
</pre>
|
|
2859
|
+
</div>
|
|
2860
|
+
<p class="caption">Example 25: Generic URI and alternates with specific URIs</p>
|
|
2861
|
+
|
|
2862
|
+
<p>
|
|
2863
|
+
In cases where a particular representation is considered the subject of synchronization,
|
|
2864
|
+
its specific URI is provided in <code><loc></code>. The associated
|
|
2865
|
+
generic URI, if one exists, may be provided using an <code><rs:ln></code>
|
|
2866
|
+
element. This element has the following attributes:
|
|
2867
|
+
</p>
|
|
2868
|
+
<ul>
|
|
2869
|
+
<li>A mandatory <code>rel</code> attribute with a value of <code>canonical</code>.</li>
|
|
2870
|
+
<li>A mandatory <code>href</code> attribute that conveys the generic URI associated with the
|
|
2871
|
+
specific URI provided in <code><loc></code>.</li>
|
|
2872
|
+
<li>Other attributes are as described for the <code><rs:ln></code> child element of
|
|
2873
|
+
<code><url></code> in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
2874
|
+
</ul>
|
|
2875
|
+
|
|
2876
|
+
<p>
|
|
2877
|
+
This approach might be most appropriate for Resource Dump Manifests and Change Dump Manifests
|
|
2878
|
+
that describe bitstreams contained in a ZIP file.
|
|
2879
|
+
</p>
|
|
2880
|
+
<p>
|
|
2881
|
+
<a href="#ex_26">Example 26</a> shows a Source promoting a specific URI
|
|
2882
|
+
in <code><loc></code> while also pointing to the
|
|
2883
|
+
resource's generic URI by means of an <code><rs:ln></code> element.
|
|
2884
|
+
Metadata pertaining to the representation available from that specific URI is
|
|
2885
|
+
conveyed by means of attributes of the <code><rs:md></code> element.
|
|
2886
|
+
</p>
|
|
2887
|
+
|
|
2888
|
+
<a name="ex_26"></a>
|
|
2889
|
+
<div class="exampleInner">
|
|
2890
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
2891
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
2892
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
2893
|
+
<rs:ln rel="up"
|
|
2894
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
2895
|
+
<rs:md capability="changelist"
|
|
2896
|
+
from="2013-01-03T00:00:00Z"/>
|
|
2897
|
+
<url>
|
|
2898
|
+
<loc>http://example.com/res1.html</loc>
|
|
2899
|
+
<rs:md change="updated"
|
|
2900
|
+
datetime="2013-01-03T18:00:00Z"
|
|
2901
|
+
hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
2902
|
+
length="8876"/>
|
|
2903
|
+
<rs:ln <span class="rs">rel="canonical"</span>
|
|
2904
|
+
href="http://example.com/res1"
|
|
2905
|
+
modified="2013-01-03T18:00:00Z"/>
|
|
2906
|
+
</url>
|
|
2907
|
+
</urlset>
|
|
2908
|
+
</pre>
|
|
2909
|
+
</div>
|
|
2910
|
+
<p class="caption">Example 26: Specific URI and alternate with generic URI</p>
|
|
2911
|
+
|
|
2912
|
+
<h3>14.4 <a name="PatchCon">Patching Content</a></h3>
|
|
2913
|
+
<p>
|
|
2914
|
+
In order to increase the efficiency of updating a resource, a Source may make a
|
|
2915
|
+
description available of the changes that the resource underwent, in addition
|
|
2916
|
+
to the entire changed resource. Especially when frequent minor changes and/or
|
|
2917
|
+
changes to large resources are concerned, such an approach may be attractive.
|
|
2918
|
+
It will, however, require an unambiguous way to describe the changes so
|
|
2919
|
+
that a Destination can construct the most recent version of the resource
|
|
2920
|
+
by appropriately patching the previous version with the description of the changes.
|
|
2921
|
+
</p>
|
|
2922
|
+
|
|
2923
|
+
<p>
|
|
2924
|
+
A Source may express that it makes a description of resource changes available
|
|
2925
|
+
by providing the URI of the resource in <code><loc></code>, as usual, and by
|
|
2926
|
+
introducing an <code><rs:ln></code> element with the following attributes:
|
|
2927
|
+
</p>
|
|
2928
|
+
<ul>
|
|
2929
|
+
<li>A mandatory <code>rel</code> attribute with a value of
|
|
2930
|
+
<code>http://www.openarchives.org/rs/terms/patch</code>.</li>
|
|
2931
|
+
<li>A mandatory <code>href</code> attribute that conveys the URI of the description
|
|
2932
|
+
of the resource changes.</li>
|
|
2933
|
+
<li>A mandatory <code>type</code> attribute that conveys the Media Type of the
|
|
2934
|
+
change description. That Media Type must be such that it allows the unambiguous
|
|
2935
|
+
application of the described changes to the previous version of the resource to
|
|
2936
|
+
construct the current one.</li>
|
|
2937
|
+
<li>Other attributes are as described for the <code><rs:ln></code> child element
|
|
2938
|
+
of <code><url></code> in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
2939
|
+
</ul>
|
|
2940
|
+
|
|
2941
|
+
<p><a href="#ex_27">Example 27</a> shows a Source that expresses changes that a
|
|
2942
|
+
JSON resource underwent expressed using the <code>application/json-patch</code>
|
|
2943
|
+
Media Type introduced in <a href="#ref-json-patch">JSON Patch</a>. It also shows
|
|
2944
|
+
the Source conveying changes to a large TIFF file using an experimental Media
|
|
2945
|
+
Type that may, for example, be described in a community specification.
|
|
2946
|
+
A Destination that does not understand the Media Type should ignore the
|
|
2947
|
+
description of changes and use the URI in <code><loc></code>
|
|
2948
|
+
to obtain the most recent version of the resource. Another example of a
|
|
2949
|
+
well-specified Media Type for expressing changes to XML document is
|
|
2950
|
+
<code>application/patch-ops-error+xml</code>, as specified in
|
|
2951
|
+
<a href="#ref-rfc5261">RFC 5261</a>.
|
|
2952
|
+
</p>
|
|
2953
|
+
<p>
|
|
2954
|
+
Expressing resource changes in this manner is only applicable to Change Lists
|
|
2955
|
+
(as in <a href="#ex_27">Example 27</a>) and Change Dumps.
|
|
2956
|
+
When doing so for a Change Dump, the entry in the Change Dump Manifest must
|
|
2957
|
+
have the <code>path</code> attribute for the <code><rs:ln></code>
|
|
2958
|
+
element that points to the change description that is included in the content package.
|
|
2959
|
+
</p>
|
|
2960
|
+
<a name="ex_27"></a>
|
|
2961
|
+
<div class="exampleInner">
|
|
2962
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
2963
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
2964
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
2965
|
+
<rs:ln rel="up"
|
|
2966
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
2967
|
+
<rs:md capability="changelist"
|
|
2968
|
+
from="2013-01-03T00:00:00Z"/>
|
|
2969
|
+
<url>
|
|
2970
|
+
<loc>http://example.com/res4</loc>
|
|
2971
|
+
<rs:md change="updated"
|
|
2972
|
+
hash="sha-256:f4OxZX_x_DFGFDgghgdfb6rtSx-iosjf6735432nklj"
|
|
2973
|
+
length="56778"
|
|
2974
|
+
<span class="rs">type="application/json"</span>/>
|
|
2975
|
+
<rs:ln <span class="rs">rel="http://www.openarchives.org/rs/terms/patch"</span>
|
|
2976
|
+
href="http://example.com/res4-json-patch"
|
|
2977
|
+
hash="sha-256:y66dER_t_HWEIKpesdkeb7rtSc-ippjf9823742opld"
|
|
2978
|
+
length="73"
|
|
2979
|
+
<span class="rs">type="application/json-patch"</span>/>
|
|
2980
|
+
</url>
|
|
2981
|
+
<url>
|
|
2982
|
+
<loc>http://example.com/res5-full.tiff</loc>
|
|
2983
|
+
<rs:md change="updated"
|
|
2984
|
+
hash="sha-256:f4OxZX_x_FO5LcGBSKHWXfwtSx-j1ncoSt3SABJtkGk"
|
|
2985
|
+
length="9788456778"
|
|
2986
|
+
<span class="rs">type="image/tiff"</span>/>
|
|
2987
|
+
<rs:ln <span class="rs">rel="http://www.openarchives.org/rs/terms/patch"</span>
|
|
2988
|
+
href="http://example.com/res5-diff"
|
|
2989
|
+
hash="sha-256:h986gT_t_87HTkjHYE76G558hY-jdfgy76t55sadJUYT"
|
|
2990
|
+
length="4533"
|
|
2991
|
+
<span class="rs">type="application/x-tiff-diff"</span>/>
|
|
2992
|
+
</url>
|
|
2993
|
+
</urlset>
|
|
2994
|
+
</pre>
|
|
2995
|
+
</div>
|
|
2996
|
+
<p class="caption">Example 27: A Change List with links to document that detail how to patch resources</p>
|
|
2997
|
+
|
|
2998
|
+
<h3>14.5 <a name="ResMDLinking">Resources and Metadata about Resources</a></h3>
|
|
2999
|
+
<p>
|
|
3000
|
+
Cases exist where both resources and metadata about those resources must be synchronized.
|
|
3001
|
+
From the ResourceSync perspective, both the resource and the metadata about it are regarded
|
|
3002
|
+
as resources with distinct URIs that are subject to synchronization. As usual, each
|
|
3003
|
+
gets its distinct <code><url></code> block and each URI is conveyed in a
|
|
3004
|
+
<code><loc></code> child element of the respective block. If required, the
|
|
3005
|
+
inter-relationship between the resources is expressed by means of an
|
|
3006
|
+
<code><rs:ln></code> element with appropriate relation types added to each block.
|
|
3007
|
+
The <code><rs:ln></code> element has the following attributes:
|
|
3008
|
+
</p>
|
|
3009
|
+
<ul>
|
|
3010
|
+
<li>A mandatory <code>rel</code> attribute. When pointing from a resource to metadata
|
|
3011
|
+
that describes it, the <code>rel</code> attribute's value is <code>describedby</code>;
|
|
3012
|
+
when pointing from metadata to the resource described by the metadata,
|
|
3013
|
+
its value is <code>describes</code>.</li>
|
|
3014
|
+
<li>A mandatory <code>href</code> attribute. When pointing from a resource to metadata
|
|
3015
|
+
that describes it, the <code>href</code> attribute's value is the URI of the metadata
|
|
3016
|
+
resource; when pointing from metadata to the resource described by it,
|
|
3017
|
+
the value is the URI of the described resource.</li>
|
|
3018
|
+
<li>Other attributes are as described for the <code><rs:ln></code> child element of
|
|
3019
|
+
<code><url></code> in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
3020
|
+
</ul>
|
|
3021
|
+
|
|
3022
|
+
<p>
|
|
3023
|
+
<a href="#ex_28">Example 28</a> shows how a Source may express this inter-relationship
|
|
3024
|
+
between the two resources. Note that a Destination can use the metadata that
|
|
3025
|
+
describes a resource as a filtering mechanism to only synchronize with those
|
|
3026
|
+
resources that meet its metadata-based selection criteria. Note also in the
|
|
3027
|
+
<code><url></code> element that conveys the metadata record update,
|
|
3028
|
+
the use of the link with a <code>profile</code> relation type
|
|
3029
|
+
[<a href="#ref-rfc6906">RFC 6906</a>] to express the kind of metadata that
|
|
3030
|
+
is used to describe the resource (in this case, the kind of metadata is expressed
|
|
3031
|
+
by means of its XML Namespace).
|
|
3032
|
+
The link should provide a URI that supports the Destination
|
|
3033
|
+
in interpreting the metadata information. For example, it could refer to a
|
|
3034
|
+
namespace, an XML schema, or a description of MARC.
|
|
3035
|
+
</p>
|
|
3036
|
+
|
|
3037
|
+
<a name="ex_28"></a>
|
|
3038
|
+
<div class="exampleInner">
|
|
3039
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
3040
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
3041
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
3042
|
+
<rs:ln rel="up"
|
|
3043
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
3044
|
+
<rs:md capability="changelist"
|
|
3045
|
+
from="2013-01-03T00:00:00Z"/>
|
|
3046
|
+
<url>
|
|
3047
|
+
<loc>http://example.com/res2.pdf</loc>
|
|
3048
|
+
<rs:md change="updated"
|
|
3049
|
+
datetime="2013-01-03T18:00:00Z"
|
|
3050
|
+
hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
3051
|
+
length="8876"
|
|
3052
|
+
type="application/pdf"/>
|
|
3053
|
+
<rs:ln <span class="rs">rel="describedby"</span>
|
|
3054
|
+
href="http://example.com/res2_dublin-core_metadata.xml"
|
|
3055
|
+
type="application/xml"/>
|
|
3056
|
+
</url>
|
|
3057
|
+
<url>
|
|
3058
|
+
<loc>http://example.com/res2_dublin-core_metadata.xml</loc>
|
|
3059
|
+
<rs:md change="updated"
|
|
3060
|
+
datetime="2013-01-03T19:00:00Z"
|
|
3061
|
+
type="application/xml"/>
|
|
3062
|
+
<rs:ln <span class="rs">rel="describes"</span>
|
|
3063
|
+
href="http://example.com/res2.pdf"
|
|
3064
|
+
hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
3065
|
+
length="8876"
|
|
3066
|
+
type="application/pdf"/>
|
|
3067
|
+
<rs:ln <span class="rs">rel="profile"</span>
|
|
3068
|
+
href="http://purl.org/dc/elements/1.1/"/>
|
|
3069
|
+
</url>
|
|
3070
|
+
</urlset>
|
|
3071
|
+
</pre>
|
|
3072
|
+
</div>
|
|
3073
|
+
<p class="caption">Example 28: Linking between a resource and metadata about a resource in a Change List</p>
|
|
3074
|
+
|
|
3075
|
+
<h3>14.6 <a name="ResVers">Prior Versions of Resources</a></h3>
|
|
3076
|
+
<p>
|
|
3077
|
+
A Source may provide access to prior versions of a resource to allow Destinations to obtain a
|
|
3078
|
+
historical perspective, rather than just remaining synchronized with the most recent version.
|
|
3079
|
+
This approach leverages a common resource versioning paradigm that consists of:
|
|
3080
|
+
</p>
|
|
3081
|
+
<ul>
|
|
3082
|
+
<li>The existence of a time-generic URI from which, at any moment in time, the current representation of the
|
|
3083
|
+
resource is available.</li>
|
|
3084
|
+
<li>The existence of a time-specific URI for each resource version, from which a specific temporal version of
|
|
3085
|
+
the resource is available.</li>
|
|
3086
|
+
</ul>
|
|
3087
|
+
<p>
|
|
3088
|
+
When communicating about the resource, its time-generic URI is provided in
|
|
3089
|
+
the <code><loc></code> element. The <code><lastmod></code> element
|
|
3090
|
+
may be used to provide the resource's last modification time.
|
|
3091
|
+
</p>
|
|
3092
|
+
<p>
|
|
3093
|
+
A first approach consists of conveying the time-specific URI of the resource that
|
|
3094
|
+
corresponds with the time of last modification, as given in the <code><lastmod></code> element.
|
|
3095
|
+
This is achieved by introducing a single <code><rs:ln></code> element with
|
|
3096
|
+
the following attributes:
|
|
3097
|
+
</p>
|
|
3098
|
+
<ul>
|
|
3099
|
+
<li>A mandatory <code>rel</code> attribute with a value of <code>memento</code>.</li>
|
|
3100
|
+
<li>A mandatory <code>href</code> attribute that conveys the time-specific URI of
|
|
3101
|
+
the resource that corresponds with the time of last modification.
|
|
3102
|
+
This URI allows a Destination to obtain that specific version during a catch-up
|
|
3103
|
+
operation, for example, because it had been offline, even if the resource has
|
|
3104
|
+
meanwhile changed again.</li>
|
|
3105
|
+
<li>The last modified datetime of the resource version
|
|
3106
|
+
identified by the time-specific URI is conveyed by the value of the
|
|
3107
|
+
<code>modified</code> attribute.</li>
|
|
3108
|
+
<li>Other attributes are as described for the <code><rs:ln></code> child element of
|
|
3109
|
+
<code><url></code> in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
3110
|
+
</ul>
|
|
3111
|
+
|
|
3112
|
+
<p>
|
|
3113
|
+
A second approach consists of pointing to a TimeGate associated with the
|
|
3114
|
+
time-generic resource. A TimeGate supports negotiation in the datetime dimension,
|
|
3115
|
+
as introduced in the Memento protocol [<a href="#ref-rfc7089">RFC 7089</a>],
|
|
3116
|
+
to obtain a version of the resource as it existed at a specified moment in time.
|
|
3117
|
+
This allows the Destination to obtain the version that existed at a time in the
|
|
3118
|
+
past, for example the time of last modification (if a <code><lastmod></code>
|
|
3119
|
+
value is included as shown in <a href="#ex_29">Example 29</a>) or any other
|
|
3120
|
+
desired time. A pointer to a TimeGate is introduced by using an
|
|
3121
|
+
<code><rs:ln></code> element with the following attributes:
|
|
3122
|
+
</p>
|
|
3123
|
+
<ul>
|
|
3124
|
+
<li>A mandatory <code>rel</code> attribute with a value of <code>timegate</code>.</li>
|
|
3125
|
+
<li>A mandatory <code>href</code> attribute that conveys the URI of TimeGate associated with the
|
|
3126
|
+
time-generic resource.</li>
|
|
3127
|
+
<li>The other attributes described for the <code><rs:ln></code> child element of
|
|
3128
|
+
<code><url></code> in <a href="#DocumentFormats">Section 7</a>
|
|
3129
|
+
should not be used as they are meaningless for TimeGates.</li>
|
|
3130
|
+
</ul>
|
|
3131
|
+
|
|
3132
|
+
<p>
|
|
3133
|
+
A third approach consists of pointing to a TimeMap associated with the time-generic resource. A TimeMap, as introduced in the Memento protocol
|
|
3134
|
+
[<a href="#ref-rfc7089">RFC 7089</a>],
|
|
3135
|
+
enables Destinations to retrieve a comprehensive list of all time-specific resources known to a server.
|
|
3136
|
+
This allows Destinations to choose a particular version of a resource from that list.
|
|
3137
|
+
A pointer to a TimeMap is introduced by using an <code><rs:ln></code> element with the following attributes:
|
|
3138
|
+
</p>
|
|
3139
|
+
<ul>
|
|
3140
|
+
<li>A mandatory <code>rel</code> attribute with a value of <code>timemap</code>.</li>
|
|
3141
|
+
<li>A mandatory <code>href</code> attribute that conveys the URI of TimeMap associated with the
|
|
3142
|
+
time-generic resource.</li>
|
|
3143
|
+
<li>Other attributes are as described for the <code><rs:ln></code> child element of
|
|
3144
|
+
<code><url></code> in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
3145
|
+
</ul>
|
|
3146
|
+
|
|
3147
|
+
<p>
|
|
3148
|
+
<a href="#ex_29">Example 29</a> shows a Change List with a link to a prior version of a
|
|
3149
|
+
resource, a link to a TimeGate, as well as a link to a TimeMap.
|
|
3150
|
+
Note that the values of the <code>hash, length,</code> and <code>type</code> attributes
|
|
3151
|
+
are identical between the <code><rs:md></code> child element and the
|
|
3152
|
+
<code><rs:ln></code> child element that points to the prior version.
|
|
3153
|
+
</p>
|
|
3154
|
+
|
|
3155
|
+
<a name="ex_29"></a>
|
|
3156
|
+
<div class="exampleInner">
|
|
3157
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
3158
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
3159
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
3160
|
+
<rs:ln rel="up"
|
|
3161
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
3162
|
+
<rs:md capability="changelist"
|
|
3163
|
+
from="2013-01-03T00:00:00Z"/>
|
|
3164
|
+
<url>
|
|
3165
|
+
<loc>http://example.com/res1</loc>
|
|
3166
|
+
<lastmod>2013-01-03T18:00:00Z</lastmod>
|
|
3167
|
+
<rs:md hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
3168
|
+
length="8876"
|
|
3169
|
+
type="text/html"
|
|
3170
|
+
change="updated"/>
|
|
3171
|
+
<rs:ln <span class="rs">rel="memento"</span>
|
|
3172
|
+
href="http://example.com/20130103070000/res1"
|
|
3173
|
+
modified="2013-01-02T18:00:00Z"
|
|
3174
|
+
hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
3175
|
+
length="8876"
|
|
3176
|
+
type="text/html"/>
|
|
3177
|
+
<rs:ln <span class="rs">rel="timegate"</span>
|
|
3178
|
+
href="http://example.com/timegate/http://example.com/res1"/>
|
|
3179
|
+
<rs:ln <span class="rs">rel="timemap"</span>
|
|
3180
|
+
href="http://example.com/timemap/http://example.com/res1"
|
|
3181
|
+
type="application/link-format"/>
|
|
3182
|
+
</url>
|
|
3183
|
+
</urlset>
|
|
3184
|
+
</pre>
|
|
3185
|
+
</div>
|
|
3186
|
+
<p class="caption">Example 29: Links to a resource version, and a Memento TimeGate and TimeMap</p>
|
|
3187
|
+
|
|
3188
|
+
<h3>14.7 <a name="ColMem">Collection Membership</a></h3>
|
|
3189
|
+
<p>
|
|
3190
|
+
A Source may express that a resource is a member of a collection such
|
|
3191
|
+
as an <a href="#ref-oaiore">OAI-ORE</a> Aggregation or an
|
|
3192
|
+
<a href="#ref-oaipmh">OAI-PMH</a> Set.
|
|
3193
|
+
A Source may express collection membership of a resource that is subject to synchronization
|
|
3194
|
+
by providing the URI of that resource in <code><loc></code>, as usual, and by
|
|
3195
|
+
introducing an <code><rs:ln></code> element with the following attributes:
|
|
3196
|
+
</p>
|
|
3197
|
+
<ul>
|
|
3198
|
+
<li>A mandatory <code>rel</code> attribute with a value of <code>collection</code>.</li>
|
|
3199
|
+
<li>A mandatory <code>href</code> attribute that conveys the URI that identifies the collection.</li>
|
|
3200
|
+
<li>Other attributes are as described for the <code><rs:ln></code> child element of
|
|
3201
|
+
<code><url></code> in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
3202
|
+
</ul>
|
|
3203
|
+
|
|
3204
|
+
<p>
|
|
3205
|
+
<a href="#ex_30">Example 30</a> shows a Change List with one resource that is
|
|
3206
|
+
a member of an OAI-ORE Aggregation.
|
|
3207
|
+
</p>
|
|
3208
|
+
|
|
3209
|
+
<a name="ex_30"></a>
|
|
3210
|
+
<div class="exampleInner">
|
|
3211
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
3212
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
3213
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
3214
|
+
<rs:ln rel="up"
|
|
3215
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
3216
|
+
<rs:md capability="changelist"
|
|
3217
|
+
from="2013-01-03T00:00:00Z"/>
|
|
3218
|
+
<url>
|
|
3219
|
+
<loc>http://example.com/res1</loc>
|
|
3220
|
+
<rs:md hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
3221
|
+
length="8876"
|
|
3222
|
+
type="text/html"
|
|
3223
|
+
change="updated"/>
|
|
3224
|
+
<rs:ln <span class="rs">rel="collection"</span>
|
|
3225
|
+
href="http://example.com/aggregation/0601007"/>
|
|
3226
|
+
</url>
|
|
3227
|
+
</urlset>
|
|
3228
|
+
</pre>
|
|
3229
|
+
</div>
|
|
3230
|
+
<p class="caption">Example 30: A resource as a member of a collection</p>
|
|
3231
|
+
|
|
3232
|
+
<h3>14.8 <a name="RePub">Republishing Resources</a></h3>
|
|
3233
|
+
<p>
|
|
3234
|
+
A special kind of Destination, henceforth called an aggregator,
|
|
3235
|
+
may retrieve content from a Source, republish it, and in its turn
|
|
3236
|
+
act as a Source for the republished content. In such an aggregator
|
|
3237
|
+
scenario, it may be important for a Destination that synchronizes
|
|
3238
|
+
with the aggregator to understand the provenance of the content and
|
|
3239
|
+
to be able to verify its accuracy with the original Source of the
|
|
3240
|
+
content. When communicating about a republished resource, the
|
|
3241
|
+
aggregator may provide such provenance information by introducing
|
|
3242
|
+
an <code><rs:ln></code> element with the following attributes:
|
|
3243
|
+
</p>
|
|
3244
|
+
|
|
3245
|
+
<ul>
|
|
3246
|
+
<li>A mandatory <code>rel</code> attribute with a value of <code>via</code>.</li>
|
|
3247
|
+
<li>A mandatory <code>href</code> attribute that conveys the URI of the resource at the original Source.</li>
|
|
3248
|
+
<li>Other attributes are as described for the <code><rs:ln></code> child element of
|
|
3249
|
+
<code><url></code> in <a href="#DocumentFormats">Section 7</a>.</li>
|
|
3250
|
+
</ul>
|
|
3251
|
+
<p>
|
|
3252
|
+
<a href="#ex_31">Example 31</a> shows a Change List in which a
|
|
3253
|
+
Source publishes information about a change to a single resource.
|
|
3254
|
+
</p>
|
|
3255
|
+
|
|
3256
|
+
<a name="ex_31"></a>
|
|
3257
|
+
<div class="exampleInner">
|
|
3258
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
3259
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
3260
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
3261
|
+
<rs:ln rel="up"
|
|
3262
|
+
href="http://example.com/dataset1/capabilitylist.xml"/>
|
|
3263
|
+
<rs:md capability="changelist"
|
|
3264
|
+
<span class="rs">from="2013-01-03T00:00:00Z"</span>/>
|
|
3265
|
+
<url>
|
|
3266
|
+
<loc><span class="rs">http://original.example.com/res1.html</span></loc>
|
|
3267
|
+
<lastmod><span class="rs">2013-01-03T07:00:00Z</span></lastmod>
|
|
3268
|
+
<rs:md hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
3269
|
+
length="8876"
|
|
3270
|
+
type="text/html"
|
|
3271
|
+
change="updated"/>
|
|
3272
|
+
</url>
|
|
3273
|
+
</urlset>
|
|
3274
|
+
</pre>
|
|
3275
|
+
</div>
|
|
3276
|
+
<p class="caption">Example 31: An original Source publishes</p>
|
|
3277
|
+
|
|
3278
|
+
<p>
|
|
3279
|
+
<a href="#ex_32">Example 32</a> shows a primary aggregator's Change
|
|
3280
|
+
List that refers to the original Source's resource. It includes a link
|
|
3281
|
+
with the relation type <code>via</code> that has attributes such as
|
|
3282
|
+
<code>href</code> to convey information about the origin of the resource.
|
|
3283
|
+
This information corresponds with the data provided in the
|
|
3284
|
+
<code><url></code> block of the Change List shown in
|
|
3285
|
+
<a href="#ex_31">Example 31</a>. For example, the value of the
|
|
3286
|
+
<code>href</code> attribute in <a href="#ex_32">Example 32</a>
|
|
3287
|
+
equals the value of the <code><loc></code> child element in the
|
|
3288
|
+
<code><url></code> block in <a href="#ex_31">Example 31</a>.
|
|
3289
|
+
</p>
|
|
3290
|
+
|
|
3291
|
+
<a name="ex_32"></a>
|
|
3292
|
+
<div class="exampleInner">
|
|
3293
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
3294
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
3295
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
3296
|
+
<rs:ln rel="up"
|
|
3297
|
+
href="http://aggregator1.example.com/dataset1/capabilitylist.xml"/>
|
|
3298
|
+
<rs:md capability="changelist"
|
|
3299
|
+
<span class="rs">from="2013-01-03T11:00:00Z"</span>/>
|
|
3300
|
+
<url>
|
|
3301
|
+
<loc><span class="rs">http://aggregator1.example.com/res1.html</span></loc>
|
|
3302
|
+
<lastmod><span class="rs">2013-01-03T20:00:00Z</span></lastmod>
|
|
3303
|
+
<rs:md hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
3304
|
+
length="8876"
|
|
3305
|
+
type="text/html"
|
|
3306
|
+
change="updated"/>
|
|
3307
|
+
<rs:ln <span class="rs">rel="via"</span>
|
|
3308
|
+
href=<span class="rs">"http://original.example.com/res1.html"</span>
|
|
3309
|
+
modified="2013-01-03T07:00:00Z"
|
|
3310
|
+
hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
3311
|
+
length="8876"
|
|
3312
|
+
type="text/html"/>
|
|
3313
|
+
</url>
|
|
3314
|
+
</urlset>
|
|
3315
|
+
</pre>
|
|
3316
|
+
</div>
|
|
3317
|
+
<p class="caption">Example 32: A primary aggregator republishes</p>
|
|
3318
|
+
|
|
3319
|
+
<p>
|
|
3320
|
+
If a secondary aggregator obtains the changed resource by consuming the
|
|
3321
|
+
Change List of the primary aggregator and republishes its Change List,
|
|
3322
|
+
a chain of aggregations is created. In this case each aggregator should
|
|
3323
|
+
maintain only the existing <code>via</code> link in order to convey
|
|
3324
|
+
information about the origin of the resource.
|
|
3325
|
+
</p>
|
|
3326
|
+
<p>
|
|
3327
|
+
<a href="#ex_33">Example 33</a> shows the Change List of a secondary
|
|
3328
|
+
aggregator with information about the changed resource and the
|
|
3329
|
+
<code>via</code> link equal to <a href="#ex_32">Example 32</a>.
|
|
3330
|
+
The data conveyed with the link corresponds to the data provided in the
|
|
3331
|
+
<code><url></code> block in <a href="#ex_31">Example 31</a>.
|
|
3332
|
+
</p>
|
|
3333
|
+
|
|
3334
|
+
<a name="ex_33"></a>
|
|
3335
|
+
<div class="exampleInner">
|
|
3336
|
+
<pre><?xml version="1.0" encoding="UTF-8"?>
|
|
3337
|
+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
|
|
3338
|
+
xmlns:rs="http://www.openarchives.org/rs/terms/">
|
|
3339
|
+
<rs:ln rel="up"
|
|
3340
|
+
href="http://aggregator2.example.com/dataset1/capabilitylist.xml"/>
|
|
3341
|
+
<rs:md capability="changelist"
|
|
3342
|
+
<span class="rs">from="2013-01-03T12:00:00Z"</span>/>
|
|
3343
|
+
<url>
|
|
3344
|
+
<loc><span class="rs">http://aggregator2.example.com/res1.html</span></loc>
|
|
3345
|
+
<lastmod><span class="rs">2013-01-04T09:00:00Z</span></lastmod>
|
|
3346
|
+
<rs:md hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
3347
|
+
length="8876"
|
|
3348
|
+
type="text/html"
|
|
3349
|
+
change="updated"/>
|
|
3350
|
+
<rs:ln <span class="rs">rel="via"</span>
|
|
3351
|
+
href=<span class="rs">"http://original.example.com/res1.html"</span>
|
|
3352
|
+
modified="2013-01-03T07:00:00Z"
|
|
3353
|
+
hash="md5:1584abdf8ebdc9802ac0c6a7402c03b6"
|
|
3354
|
+
length="8876"
|
|
3355
|
+
type="text/html"/>
|
|
3356
|
+
</url>
|
|
3357
|
+
</urlset>
|
|
3358
|
+
</pre>
|
|
3359
|
+
</div>
|
|
3360
|
+
<p class="caption">Example 33: A second aggregator republishes</p>
|
|
3361
|
+
|
|
3362
|
+
<p>
|
|
3363
|
+
The values of the <code>at</code>, <code>completed</code>,
|
|
3364
|
+
<code>from</code>, and <code>until</code> attributes must always be
|
|
3365
|
+
expressed from the perspective of the Source that publishes the
|
|
3366
|
+
document that contains them. Hence it is possible that the
|
|
3367
|
+
<code>from</code> datetime of a Change List is more recent than
|
|
3368
|
+
the <code><lastmod></code> datetime of the original Source's
|
|
3369
|
+
resource described in the Change List, which is conveyed using an
|
|
3370
|
+
<code><rs:ln></code> link with the <code>via</code> relation type.
|
|
3371
|
+
</p>
|
|
3372
|
+
<p>
|
|
3373
|
+
An aggregator should be cautious when inheriting links, other than the
|
|
3374
|
+
one with the <code>via</code> relation type, from a Source that precedes
|
|
3375
|
+
it in an aggregation chain. It should make sure that each such link remains
|
|
3376
|
+
appropriate from its own perspective and refrain from inheriting it when
|
|
3377
|
+
it is not. For example, a link with the relation type <code>collection</code>
|
|
3378
|
+
or <code>canonical</code> expressed by the original Source may not be
|
|
3379
|
+
appropriate in the context of the aggregator's copy, and hence should not
|
|
3380
|
+
be included in the description of the changed resource in the aggregator's
|
|
3381
|
+
capability document.
|
|
3382
|
+
</p>
|
|
3383
|
+
|
|
3384
|
+
</div> <!--class="body"-->
|
|
3385
|
+
|
|
3386
|
+
<div class="back">
|
|
3387
|
+
<div class="body">
|
|
3388
|
+
|
|
3389
|
+
|
|
3390
|
+
<h2><a name="TimeAttributeReqs"></a>A. Time Attribute Requirements</h2>
|
|
3391
|
+
|
|
3392
|
+
<p><i>(normative)</i></p>
|
|
3393
|
+
|
|
3394
|
+
<p>
|
|
3395
|
+
<a href="#tab_4">Table 4</a> provides an overview of the requirements
|
|
3396
|
+
for use of the <code>at</code> and <code>from</code> attributes
|
|
3397
|
+
in ResourceSync documents.
|
|
3398
|
+
The <i>top</i> label in the column headings represents the <code><sitemapindex></code> root element for index documents, and the
|
|
3399
|
+
<code><urlset></code> root element for all other documents.
|
|
3400
|
+
The <i>child</i> label in the column headings represents the <code><sitemap></code> child element for index documents, and the
|
|
3401
|
+
<code><url></code> child element for all other documents.
|
|
3402
|
+
</p>
|
|
3403
|
+
<p>
|
|
3404
|
+
The optional attributes <code>completed</code> and <code>until</code> are not shown
|
|
3405
|
+
in the table, but they may be added wherever the corresponding <code>at</code> and
|
|
3406
|
+
<code>from</code> attributes are mandatory, recommended, or optional.
|
|
3407
|
+
</p>
|
|
3408
|
+
<p>
|
|
3409
|
+
<a href="#tab_4">Table 4</a> shows that, for example, a Change List must contain the
|
|
3410
|
+
<code><rs:md></code> child element of the <code><urlset></code> root
|
|
3411
|
+
element with the attribute <code>from</code> to convey the temporal
|
|
3412
|
+
interval covered by the Change List.
|
|
3413
|
+
</p>
|
|
3414
|
+
|
|
3415
|
+
<a name="tab_4"></a>
|
|
3416
|
+
<table class="attr_req_level-table" summary="Time Attribute Requirements">
|
|
3417
|
+
<tbody>
|
|
3418
|
+
<tr class="top">
|
|
3419
|
+
<th>Capability Document</th><th>/<i>top</i>/rs:md/@at</th><th>/<i>top</i>/rs:md/@from</th><th>/<i>top</i>/<i>child</i>/rs:md/@at</th><th>/<i>top</i>/<i>child</i>/rs:md/@from</th>
|
|
3420
|
+
</tr>
|
|
3421
|
+
<tr class="odd">
|
|
3422
|
+
<td class="cap">Resource List</td>
|
|
3423
|
+
<td class="mand">Mandatory</td>
|
|
3424
|
+
<td class="na">X</td>
|
|
3425
|
+
<td class="na">X</td>
|
|
3426
|
+
<td class="na">X</td>
|
|
3427
|
+
</tr>
|
|
3428
|
+
<tr class="odd">
|
|
3429
|
+
<td class="cap">Resource List Index</td>
|
|
3430
|
+
<td class="mand">Mandatory</td>
|
|
3431
|
+
<td class="na">X</td>
|
|
3432
|
+
<td class="opt">Optional</td>
|
|
3433
|
+
<td class="na">X</td>
|
|
3434
|
+
</tr>
|
|
3435
|
+
<tr class="even">
|
|
3436
|
+
<td class="cap">Resource Dump</td>
|
|
3437
|
+
<td class="mand">Mandatory</td>
|
|
3438
|
+
<td class="na">X</td>
|
|
3439
|
+
<td class="opt">Optional</td>
|
|
3440
|
+
<td class="na">X</td>
|
|
3441
|
+
</tr>
|
|
3442
|
+
<tr class="even">
|
|
3443
|
+
<td class="cap">Resource Dump Index</td>
|
|
3444
|
+
<td class="mand">Mandatory</td>
|
|
3445
|
+
<td class="na">X</td>
|
|
3446
|
+
<td class="opt">Optional</td>
|
|
3447
|
+
<td class="na">X</td>
|
|
3448
|
+
</tr>
|
|
3449
|
+
<tr class="even">
|
|
3450
|
+
<td class="cap">Resource Dump Manifest</td>
|
|
3451
|
+
<td class="mand">Mandatory</td>
|
|
3452
|
+
<td class="na">X</td>
|
|
3453
|
+
<td class="na">X</td>
|
|
3454
|
+
<td class="na">X</td>
|
|
3455
|
+
</tr>
|
|
3456
|
+
<tr class="odd">
|
|
3457
|
+
<td class="cap">Change List</td>
|
|
3458
|
+
<td class="na">X</td>
|
|
3459
|
+
<td class="mand">Mandatory</td>
|
|
3460
|
+
<td class="na">X</td>
|
|
3461
|
+
<td class="na">X</td>
|
|
3462
|
+
</tr>
|
|
3463
|
+
|
|
3464
|
+
<tr class="odd">
|
|
3465
|
+
<td class="cap">Change List Index</td>
|
|
3466
|
+
<td class="na">X</td>
|
|
3467
|
+
<td class="mand">Mandatory</td>
|
|
3468
|
+
<td class="na">X</td>
|
|
3469
|
+
<td class="rec">Recommended</td>
|
|
3470
|
+
</tr>
|
|
3471
|
+
|
|
3472
|
+
<tr class="even">
|
|
3473
|
+
<td class="cap">Change Dump</td>
|
|
3474
|
+
<td class="na">X</td>
|
|
3475
|
+
<td class="mand">Mandatory</td>
|
|
3476
|
+
<td class="na">X</td>
|
|
3477
|
+
<td class="rec">Recommended</td>
|
|
3478
|
+
</tr>
|
|
3479
|
+
|
|
3480
|
+
<tr class="even">
|
|
3481
|
+
<td class="cap">Change Dump Index</td>
|
|
3482
|
+
<td class="na">X</td>
|
|
3483
|
+
<td class="mand">Mandatory</td>
|
|
3484
|
+
<td class="na">X</td>
|
|
3485
|
+
<td class="rec">Recommended</td>
|
|
3486
|
+
</tr>
|
|
3487
|
+
|
|
3488
|
+
<tr class="even">
|
|
3489
|
+
<td class="cap">Change Dump Manifest</td>
|
|
3490
|
+
<td class="na">X</td>
|
|
3491
|
+
<td class="mand">Mandatory</td>
|
|
3492
|
+
<td class="na">X</td>
|
|
3493
|
+
<td class="na">X</td>
|
|
3494
|
+
</tr>
|
|
3495
|
+
</tbody>
|
|
3496
|
+
</table>
|
|
3497
|
+
<p class="caption">Table 4: Required and optional use of <code>at</code> and <code>from</code> attributes in ResourceSync documents</p>
|
|
3498
|
+
|
|
3499
|
+
|
|
3500
|
+
|
|
3501
|
+
<h2>B. <a name="Bibliography">Bibliography</a></h2>
|
|
3502
|
+
|
|
3503
|
+
<p>(This Bibliography is not part of the ResourceSync Framework Specification,
|
|
3504
|
+
NISO Z39.99-YYYY. It is included for information only.)</p>
|
|
3505
|
+
|
|
3506
|
+
<dl>
|
|
3507
|
+
|
|
3508
|
+
|
|
3509
|
+
<dt>[<a name="ref-html-links" id="ref-html-links">HTML Links</a>]</dt>
|
|
3510
|
+
<dd>Raggett, Dave, Arnaud Le Hors, and Ian Jacobs, eds.
|
|
3511
|
+
<a href="http://www.w3.org/TR/html401/struct/links.html"><cite>"Links." Section 12 in: HTML 4.01 Specification</cite></a>.
|
|
3512
|
+
W3C Recommendation. World Wide Web Consortium, December 24, 1999.
|
|
3513
|
+
Available at: <a href="http://www.w3.org/TR/html401/struct/links.html">http://www.w3.org/TR/html401/struct/links.html</a></dd>
|
|
3514
|
+
|
|
3515
|
+
<dt>[<a name="ref-json-patch" id="ref-json-patch">JSON-Patch</a>]</dt>
|
|
3516
|
+
<dd>Bryan, P., and M. Nottingham, eds.
|
|
3517
|
+
<a href="http://tools.ietf.org/html/draft-ietf-appsawg-json-patch"><cite>JSON Patch</cite></a>. Internet Draft.
|
|
3518
|
+
Internet Engineering Task Force (IETF), January 20, 2013.
|
|
3519
|
+
Available at: <a href="http://tools.ietf.org/html/draft-ietf-appsawg-json-patch">http://tools.ietf.org/html/draft-ietf-appsawg-json-patch-10</a></dd>
|
|
3520
|
+
|
|
3521
|
+
<dt>[<a name="ref-oaipmh" id="ref-oaipm">OAI-PMH</a>]</dt>
|
|
3522
|
+
<dd>Lagoze, Carl, Herbert Van de Sompel, Michael Nelson, and Simeon Warner, eds.
|
|
3523
|
+
<cite><a href="http://www.openarchives.org/OAI/openarchivesprotocol.html">The Open Archives Initiative Protocol for Metadata Harvesting</a></cite>.
|
|
3524
|
+
Version 2.0. Open Archives Initiative, December 7, 2008.
|
|
3525
|
+
Available at: <a href="http://www.openarchives.org/OAI/openarchivesprotocol.html">http://www.openarchives.org/OAI/openarchivesprotocol.html</a></dd>
|
|
3526
|
+
|
|
3527
|
+
<dt>[<a name="ref-oaiore" id="ref-oaiore">ORE</a>]</dt>
|
|
3528
|
+
<dd>Lagoze, Carl, Herbert Van de Sompel, Pete Johnston, Michael Nelson, Robert Sanderson, and Simeon Warner, eds.
|
|
3529
|
+
<cite><a href="http://www.openarchives.org/ore/datamodel">ORE Specification - Abstract Data Model</a></cite>.
|
|
3530
|
+
Open Archives Initiative, October 17, 2008.
|
|
3531
|
+
Available at: <a href="http://www.openarchives.org/ore/1.0/datamodel">http://www.openarchives.org/ore/1.0/datamodel</a></dd>
|
|
3532
|
+
|
|
3533
|
+
<dt>[<a name="ref-relationtypes" id="ref-relationtype">Relation Types</a>]</dt>
|
|
3534
|
+
<dd>Klein, Martin, Herbert Van de Sompel, Simeon Warner, Graham Klyne, Bernhard Haslhofer, Michael Nelson, Carl Lagoze, and Robert Sanderson, eds.
|
|
3535
|
+
<a href="http://www.openarchives.org/rs/relationtypes"><cite>Relation Types Used in the ResourceSync Framework</cite></a>.
|
|
3536
|
+
Open Archives Initiative.
|
|
3537
|
+
Available at: <a href="http://www.openarchives.org/rs/relationtypes">http://www.openarchives.org/rs/relationtypes</a></dd>
|
|
3538
|
+
|
|
3539
|
+
<dt>[<a name="ref-rfc5261" id="ref-rfc5261">RFC 5261</a>]</dt>
|
|
3540
|
+
<dd>Urpalainen, J.
|
|
3541
|
+
<cite><a href="http://www.ietf.org/rfc/rfc5261.txt">An Extensible Markup Language (XML) Patch Operations Framework Utilizing XML Path Language (XPath) Selectors. RFC 5261</a></cite>.
|
|
3542
|
+
Internet Engineering Task Force (IETF), September 2008.
|
|
3543
|
+
Available at: <a href="http://www.ietf.org/rfc/rfc5261.txt">http://www.ietf.org/rfc/rfc5261.txt</a></dd>
|
|
3544
|
+
|
|
3545
|
+
<dt>[<a name="ref-rfc5785" id="ref-rfc5785">RFC 5785</a>]</dt>
|
|
3546
|
+
<dd>Nottingham, M., and E. Hammer-Lahav.
|
|
3547
|
+
<cite><a href="http://www.ietf.org/rfc/rfc5785.txt">Defining Well-Known Uniform Resource Identifiers (URIs). RFC 5785</a></cite>.
|
|
3548
|
+
Internet Engineering Task Force (IETF), April 2010.
|
|
3549
|
+
Available at: <a href="http://www.ietf.org/rfc/rfc5785.txt">http://www.ietf.org/rfc/rfc5785.txt</a></dd>
|
|
3550
|
+
|
|
3551
|
+
<dt>[<a name="ref-rfc6596" id="ref-rfc6596">RFC 6596</a>]</dt>
|
|
3552
|
+
<dd>Ohye, M., and J. Kupke.
|
|
3553
|
+
<cite><a href="http://www.ietf.org/rfc/rfc6596.txt">The Canonical Link Relation. RFC 6596</a></cite>.
|
|
3554
|
+
Internet Engineering Task Force (IETF), April 2012.
|
|
3555
|
+
Available at: <a href="http://www.ietf.org/rfc/rfc6596.txt">http://www.ietf.org/rfc/rfc6596.txt</a></dd>
|
|
3556
|
+
|
|
3557
|
+
<dt>[<a name="ref-rsync" id="ref-rsync">rsync</a>]</dt>
|
|
3558
|
+
<dd><cite><a href="http://en.wikipedia.org/wiki/Rsync">rsync</a></cite>.
|
|
3559
|
+
From Wikipedia, the free encyclopedia.
|
|
3560
|
+
Available at: <a href="http://en.wikipedia.org/wiki/Rsync">http://en.wikipedia.org/wiki/Rsync</a></dd>
|
|
3561
|
+
|
|
3562
|
+
<dt>[<a name="ref-webarch" id="ref-webarch">Web Architecture</a>]</dt>
|
|
3563
|
+
<dd>Jacobs, Ian, and Norman Walsh, eds.
|
|
3564
|
+
<a href="http://www.w3.org/TR/webarch/"><cite>Architecture of the World Wide Web, Volume One</cite></a>.
|
|
3565
|
+
W3C Recommendation. World Wide Web Consortium, December 15, 2004.
|
|
3566
|
+
Available at: <a href="http://www.w3.org/TR/webarch/">http://www.w3.org/TR/webarch/</a></dd>
|
|
3567
|
+
|
|
3568
|
+
<dt>[<a name="ref-xhtml-links" id="ref-xhtml-links">XHTML Links</a>]</dt>
|
|
3569
|
+
<dd>McCarron, Shane, et al., eds.
|
|
3570
|
+
<a href="http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_linkmodule"><cite>"Link Module." Section 5.19 in: XHTML Modularization 1.1. Second Edition</cite></a>.
|
|
3571
|
+
World Wide Web Consortium, July 29, 2010.
|
|
3572
|
+
Available at: <a href="http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_linkmodule">http://www.w3.org/TR/xhtml-modularization/abstract_modules.html#s_linkmodule</a></dd>
|
|
3573
|
+
</dl>
|
|
3574
|
+
|
|
3575
|
+
<h2><a name="FrontMatter"></a>C. Front Matter, Authorship, Acknowledgements</h2>
|
|
3576
|
+
|
|
3577
|
+
<p>(This appendix is contains front matter, authorship and acknowledgements
|
|
3578
|
+
from the PDF version of this specification. They have been moved here to
|
|
3579
|
+
preserve the readability of this web document.)</p>
|
|
3580
|
+
|
|
3581
|
+
<h3>About NISO Standards</h3>
|
|
3582
|
+
|
|
3583
|
+
<p>NISO standards are developed by Working Groups of the National
|
|
3584
|
+
Information Standards Organization. The development process is a strenuous
|
|
3585
|
+
one that includes a rigorous peer review of proposed standards open to each
|
|
3586
|
+
NISO Voting Member and any other interested party. Final approval of the
|
|
3587
|
+
standard involves verification by the American National Standards Institute
|
|
3588
|
+
that its requirements for due process, consensus, and other approval criteria
|
|
3589
|
+
have been met by NISO. Once verified and approved, NISO Standards also become
|
|
3590
|
+
American National Standards.</p>
|
|
3591
|
+
|
|
3592
|
+
<p>These standards may be revised or withdrawn at any time. For current
|
|
3593
|
+
information on the status of this standard contact the NISO office or visit
|
|
3594
|
+
the NISO website at: <a href="http://www.niso.org/">www.niso.org</a>.</p>
|
|
3595
|
+
|
|
3596
|
+
<p>Published by<br/>
|
|
3597
|
+
NISO<br/>
|
|
3598
|
+
3600 Clipper Mill Road<br/>
|
|
3599
|
+
Suite 302<br/>
|
|
3600
|
+
Baltimore, MD 21211<br/>
|
|
3601
|
+
<a href="http://www.niso.org/">www.niso.org</a></p>
|
|
3602
|
+
|
|
3603
|
+
ISBN: ??? (HTML)<br/>
|
|
3604
|
+
ISBN: ??? (PDF)</p>
|
|
3605
|
+
|
|
3606
|
+
<h3>Foreword</h3>
|
|
3607
|
+
|
|
3608
|
+
<p>(This foreword is not part of the ResourceSync Framework Specification,
|
|
3609
|
+
NISO Z39.99-YYYY. It is included for information only.)</p>
|
|
3610
|
+
|
|
3611
|
+
<h4>About This Standard</h4>
|
|
3612
|
+
|
|
3613
|
+
<p>This document is structured as follows:</p>
|
|
3614
|
+
|
|
3615
|
+
<ul>
|
|
3616
|
+
<li><a href="#Walkthrough">Section 1</a>, Introduction, discusses the purpose and scope and provides example use cases and includes a Walkthrough, introducing the core components of the ResourceSync framework by example.</li>
|
|
3617
|
+
<li><a href="#NormativeRefs">Section 2</a>, Normative References, lists references to other standards/specifications that are required for conformance with this standard.</li>
|
|
3618
|
+
<li><a href="#Definitions">Section 3</a>, Definitions, introduces terminology important for the understanding of this standard.</li>
|
|
3619
|
+
<li><a href="#Namespaces">Section 4</a>, Namespace Prefix Bindings, identifies the namespaces used for this specification.</li>
|
|
3620
|
+
<li><a href="#SyncProcesses">Section 5</a>, Synchronization Processes, provides a high-level overview of the various ResourceSync capabilities and shows how these fit in processes aimed at remaining in step with resource changes.</li>
|
|
3621
|
+
<li><a href="#FrameworkOrg">Section 6</a>, Framework Organization, describes the overall organization of the ResourceSync framework: structure, navigation, and discovery.</li>
|
|
3622
|
+
<li><a href="#DocumentFormats">Section 7</a>, Sitemap Document Formats, describes the way in which the document formats introduced by the Sitemap protocol are used to convey synchronization related information in all ResourceSync capabilities.</li>
|
|
3623
|
+
<li><a href="#SourceDesc">Section 8</a>, Describing the Source, and <a href="#CapabilityList">Section 9</a>, Advertising Capabilities, describe how a server should convey the ResourceSync capabilities it supports.</li>
|
|
3624
|
+
<li><a href="#DescResources">Section 10</a>, Describing Resources; <a href="#PackResources">Section 11</a>, Packaging Resources; <a href="#DesChanges">Section 12</a>, Describing Changes; <a href="#PackChanges">Section 13</a>, Packaging Changes; and <a href="#LinkRelRes">Section 14</a>, Linking to Related Resources, each provide details about a capability that a server may implement in order to enable remote systems to remain aligned with its evolving data.</li>
|
|
3625
|
+
<li><a href="#TimeAttributeReqs">Appendix A</a>, Time Attribute Requirements, provides an overview of the requirements for use of the <code>at</code> and <code>from</code> attributes in ResourceSync documents.</li>
|
|
3626
|
+
</ul>
|
|
3627
|
+
|
|
3628
|
+
<h4>2016 Revision</h4>
|
|
3629
|
+
|
|
3630
|
+
<p>Revisions to the standard reflect changes to fix problems related to the conflation of last modification date of a resource and the datetime of notification of a change to the resource.</p>
|
|
3631
|
+
|
|
3632
|
+
<h4>Trademarks, Services Marks</h4>
|
|
3633
|
+
|
|
3634
|
+
<p>Wherever used in this standard, all terms that are trademarks or
|
|
3635
|
+
service marks are and remain the property of their respective owners.</p>
|
|
3636
|
+
|
|
3637
|
+
<h4>NISO Voting Members</h4>
|
|
3638
|
+
|
|
3639
|
+
<p>The following were members of the NISO Z39.99-201x ResourceSync voting pool that approved this standard. NISO approval of this standard does not necessarily imply that all Voting Pool members voted for its approval.</p>
|
|
3640
|
+
|
|
3641
|
+
<dl>
|
|
3642
|
+
<dt>[To be added upon approval]</dt>
|
|
3643
|
+
</dl>
|
|
3644
|
+
|
|
3645
|
+
<h4>NISO D2D Topic Committee</h4>
|
|
3646
|
+
|
|
3647
|
+
<p>The following individuals served on the Discovery to Delivery (D2D) Topic Committee at the time it approved this standard:</p>
|
|
3648
|
+
|
|
3649
|
+
<dl>
|
|
3650
|
+
<dt>[To be added upon approval]</dt>
|
|
3651
|
+
</dl>
|
|
3652
|
+
|
|
3653
|
+
<h4>NISO ResourceSync Working Group Members</h4>
|
|
3654
|
+
|
|
3655
|
+
<p>The following individuals served on the NISO ResourceSync Working Group,
|
|
3656
|
+
which developed and approved this standard:</p>
|
|
3657
|
+
|
|
3658
|
+
<dl>
|
|
3659
|
+
<dt>Todd Carpenter, Co-chair</dt>
|
|
3660
|
+
<dd>NISO</dd>
|
|
3661
|
+
<dt>Michael Nelson<sup>*</sup></dt>
|
|
3662
|
+
<dd>Old Dominion University</dd>
|
|
3663
|
+
<dt>Bernhard Haslhofer<sup>*</sup></dt>
|
|
3664
|
+
<dd>Vienna University of Technology</dd>
|
|
3665
|
+
<dt>Shlomo Sanders</dt>
|
|
3666
|
+
<dd>Ex Libris, Inc.</dd>
|
|
3667
|
+
<dt>Richard Jones</dt>
|
|
3668
|
+
<dd>Cottage Labs</dd>
|
|
3669
|
+
<dt>Robert Sanderson<sup>*</sup></dt>
|
|
3670
|
+
<dd>Los Alamos National Laboratory</dd>
|
|
3671
|
+
<dt>Martin Klein<sup>*</sup></dt>
|
|
3672
|
+
<dd>Los Alamos National Laboratory</dd>
|
|
3673
|
+
<dt>Herbert Van de Sompel, Co-chair<sup>*</sup></dt>
|
|
3674
|
+
<dd>Los Alamos National Laboratory</dd>
|
|
3675
|
+
<dt>Graham Klyne<sup>*</sup></dt>
|
|
3676
|
+
<dd>University of Oxford</dd>
|
|
3677
|
+
<dt>Paul Walk</dt>
|
|
3678
|
+
<dd>EDINA</dd>
|
|
3679
|
+
<dt>Carl Lagoze<sup>*</sup></dt>
|
|
3680
|
+
<dd>University of Michigan</dd>
|
|
3681
|
+
<dt>Simeon Warner<sup>*</sup></dt>
|
|
3682
|
+
<dd>Cornell University</dd>
|
|
3683
|
+
<dt>Stuart Lewis</dt>
|
|
3684
|
+
<dd>Jisc Collections</dd>
|
|
3685
|
+
<dt>Zhiwu Xie</dt>
|
|
3686
|
+
<dd>Virginia Tech University Libraries</dd>
|
|
3687
|
+
<dt>Peter Murray</dt>
|
|
3688
|
+
<dd>Lyrasis</dd>
|
|
3689
|
+
<dt>Jeff Young</dt>
|
|
3690
|
+
<dd>OCLC Online Computer Library Center</dd>
|
|
3691
|
+
</dl>
|
|
3692
|
+
|
|
3693
|
+
<p>* responsible for 2016 updates</a>
|
|
3694
|
+
|
|
3695
|
+
<h4><a name="Acknowledgments"></a>Acknowledgements</h4>
|
|
3696
|
+
|
|
3697
|
+
<p>This specification is the collaborative work of
|
|
3698
|
+
<a href="http://niso.org/">NISO</a> and the
|
|
3699
|
+
<a href="http://www.openarchives.org/">Open Archives Initiative</a>.
|
|
3700
|
+
Initial funding for ResourceSync was provided by the
|
|
3701
|
+
<a href="http://www.sloan.org/">Alfred P. Sloan Foundation</a>.
|
|
3702
|
+
UK participation was supported by
|
|
3703
|
+
<a href="http://www.jisc.ac.uk/">Jisc</a>.
|
|
3704
|
+
We also thank numerous individual contributors including: Martin Haye
|
|
3705
|
+
(California Digital Library), David Rosenthal (Stanford University Libraries),
|
|
3706
|
+
Ed Summers (Library of Congress), and Vincent Wehren (Microsoft).</p>
|
|
3707
|
+
|
|
3708
|
+
<div class="Changelog">
|
|
3709
|
+
<h2><a name="Changelog">D. Change Log</a></h2>
|
|
3710
|
+
|
|
3711
|
+
<p>(This appendix is not part of the ResourceSync Framework Specification,
|
|
3712
|
+
NISO Z39.99-YYYY. It is included for information only.)</p>
|
|
3713
|
+
|
|
3714
|
+
<table class="Changelog" summary="Change log">
|
|
3715
|
+
<tbody><tr>
|
|
3716
|
+
<th>Date</th>
|
|
3717
|
+
<th>Editor</th>
|
|
3718
|
+
<th>Description</th>
|
|
3719
|
+
</tr>
|
|
3720
|
+
<tr>
|
|
3721
|
+
<td>2016-08-26</td>
|
|
3722
|
+
<td>martin, herbert, simeon</td>
|
|
3723
|
+
<td>verson 1.0.9, DRAFT REVISION expected to become NISO Z39.99-YYYY</td>
|
|
3724
|
+
</tr>
|
|
3725
|
+
<tr>
|
|
3726
|
+
<td>2014-04-21</td>
|
|
3727
|
+
<td>martin, herbert, simeon</td>
|
|
3728
|
+
<td>verson 1.0, ANSI/NISO Z39.99-2014</td>
|
|
3729
|
+
</tr>
|
|
3730
|
+
<tr>
|
|
3731
|
+
<td>2013-08-05</td>
|
|
3732
|
+
<td>martin, herbert, rob, simeon</td>
|
|
3733
|
+
<td>version 0.9.1</td>
|
|
3734
|
+
</tr>
|
|
3735
|
+
<tr>
|
|
3736
|
+
<td>2013-06-07</td>
|
|
3737
|
+
<td>martin, herbert, rob, simeon</td>
|
|
3738
|
+
<td>version 0.9</td>
|
|
3739
|
+
</tr>
|
|
3740
|
+
<tr>
|
|
3741
|
+
<td>2013-05-01</td>
|
|
3742
|
+
<td>martin, herbert, rob, simeon</td>
|
|
3743
|
+
<td>version 0.6</td>
|
|
3744
|
+
</tr>
|
|
3745
|
+
<tr>
|
|
3746
|
+
<td>2013-02-01</td>
|
|
3747
|
+
<td>martin, herbert, rob, simeon</td>
|
|
3748
|
+
<td>beta spec draft</td>
|
|
3749
|
+
</tr>
|
|
3750
|
+
<tr>
|
|
3751
|
+
<td>2012-08-13</td>
|
|
3752
|
+
<td>martin, herbert, simeon, bernhard</td>
|
|
3753
|
+
<td>first alpha spec draft</td>
|
|
3754
|
+
</tr>
|
|
3755
|
+
</tbody>
|
|
3756
|
+
</table>
|
|
3757
|
+
</div>
|
|
3758
|
+
|
|
3759
|
+
</div>
|
|
3760
|
+
</div>
|
|
3761
|
+
|
|
3762
|
+
<div id="license">
|
|
3763
|
+
<p><a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/"><img alt="Creative Commons License" style="border-width:0" src="img/cc-by-sa-4.0-88x31.png"/></a><br/>This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/">Creative Commons Attribution-Share Alike 4.0 International License</a>.</p>
|
|
3764
|
+
</div>
|
|
3765
|
+
</body>
|
|
3766
|
+
</html>
|