Skip to content

Commit b01410e

Browse files
committed
first pass fix P4 links
1 parent 69b51a8 commit b01410e

File tree

3 files changed

+22
-15
lines changed

3 files changed

+22
-15
lines changed

source/_includes/links.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -245,6 +245,7 @@
245245
[prezi3-considerations]: {{ site.api_url | absolute_url }}/presentation/3.{{ site.data.apis.presentation.latest.minor }}/#4-json-ld-considerations "Presentation API Section 4"
246246
[prezi3-html]: {{ site.api_url | absolute_url }}/presentation/3.{{ site.data.apis.presentation.latest.minor }}/#45-html-markup-in-property-values "Presentation API Section 4.4"
247247
[prezi3-languages]: {{ site.api_url | absolute_url }}/presentation/{{site.data.apis.presentation.latest.major}}.{{ site.data.apis.presentation.latest.minor }}/#language-of-property-values "Language of Property Values"
248+
[prezi40-languages]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#language-of-property-values "Language of Property Values"
248249
[prezi3-ldce]: {{ site.api_url | absolute_url }}/presentation/3.{{ site.data.apis.presentation.latest.minor }}/#linked-data-context-and-extensions "Linked Data Context and Extensions"
249250
[prezi3-provider]: {{ site.api_url | absolute_url }}/presentation/3.{{ site.data.apis.presentation.latest.minor }}/#provider
250251
[prezi3-service]: {{ site.api_url | absolute_url }}/presentation/3.{{ site.data.apis.presentation.latest.minor }}/#service
@@ -287,6 +288,7 @@
287288
[registry-selectors]: {{ site.api_url | absolute_url }}/registry/selectors/
288289
[registry-services]: {{ site.api_url | absolute_url }}/registry/services/
289290
[registry-profiles]: {{ site.api_url | absolute_url }}/registry/profiles/
291+
[registry-rights]: {{ site.api_url | absolute_url }}/registry/rights/
290292
[registry-timeModes]: {{ site.api_url | absolute_url }}/registry/timeModes/
291293
[registry-types]: {{ site.api_url | absolute_url }}/registry/types/
292294
[registry-viewingDirections]: {{ site.api_url | absolute_url }}/registry/viewingDirections/
@@ -350,8 +352,10 @@
350352
[prezi-40-model-body]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#body
351353
[prezi-40-model-color]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#color
352354
[prezi-40-model-duration]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#duration
355+
[prezi-40-model-environment-map]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#environmentMap
353356
[prezi-40-model-exclude]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#exclude
354357
[prezi-40-model-far]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#far
358+
[prezi-40-model-fileSize]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#fileSize
355359
[prezi-40-model-fieldOfView]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#fieldOfView
356360
[prezi-40-model-format]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#format
357361
[prezi-40-model-height]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#height
@@ -363,12 +367,14 @@
363367
[prezi-40-model-items]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#items
364368
[prezi-40-model-label]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#label
365369
[prezi-40-model-language]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#language
370+
[prezi-40-model-list]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#List
366371
[prezi-40-model-lookAt]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#lookAt
367372
[prezi-40-model-metadata]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#metadata
368373
[prezi-40-model-motivation]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#motivation
369374
[prezi-40-model-navDate]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#navDate
370375
[prezi-40-model-navPlace]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#navPlace
371376
[prezi-40-model-near]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#near
377+
[prezi-40-model-partOf]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#partOf
372378
[prezi-40-model-placeholderContainer]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#placeholderContainer
373379
[prezi-40-model-position]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#position
374380
[prezi-40-model-profile]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#profile
@@ -378,6 +384,7 @@
378384
[prezi-40-model-rendering]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#rendering
379385
[prezi-40-model-requiredStatement]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#requiredStatement
380386
[prezi-40-model-rights]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#rights
387+
[prezi-40-model-seeAlso]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#seeAlso
381388
[prezi-40-model-service]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#service
382389
[prezi-40-model-source]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#source
383390
[prezi-40-model-spatialScale]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#spatialScale

source/presentation/4.0/index.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -151,7 +151,7 @@ This document acts as an introduction to the specification through a set of typi
151151
8. **Comment on Feature of a Painting** - a Manifest that represents a painting and a comment highlighting a particular region of the painting.
152152
9. **Interactive 3D Light Switch** - a Manifest that represents a Scene containing a light and a 3D model of a light switch, where a user can click or otherwise interact with the switch to turn the light on and off.
153153

154-
These use case were chosen as a broad sample to introduce IIIF concepts. Many more use cases are provided as recipes in the [IIIF Cookbook](link).
154+
These use case were chosen as a broad sample to introduce IIIF concepts. Many more use cases are provided as recipes in the [IIIF Cookbook][annex-cookbook].
155155

156156

157157
> TODO Consider diagrams
@@ -294,7 +294,7 @@ Scenes can have time-based and image content in them as well as 3D content. See
294294
## Annotations
295295

296296

297-
IIIF uses the concept of _Annotation_ to link resources together from around the web. This specification uses a World Wide Web Consortium (W3C) standard for this called the [Web Annotation Data Model][org-web-anno]. This is a structured linking mechanism useful for making comments about Content Resources, but IIIF's primary use of it is to associate the images, audio and other Content Resources with their Containers for presentation.
297+
IIIF uses the concept of _Annotation_ to link resources together from around the web. This specification uses a World Wide Web Consortium (W3C) standard for this called the [Web Annotation Data Model][org-w3c-webanno]. This is a structured linking mechanism useful for making comments about Content Resources, but IIIF's primary use of it is to associate the images, audio and other Content Resources with their Containers for presentation.
298298

299299
In each of the three Containers above, an **Annotation** links the Container to a Content Resource. The Content Resource in the [`body`][prezi-40-model-body] property is _painted_ into the Container by an Annotation whose [`target`][prezi-40-model-target] property is the [`id`][prezi-40-model-id] of the Container. In all three simple cases here the [`target`][prezi-40-model-target] property is the [`id`][prezi-40-model-id] of the Container with no further qualification.
300300

@@ -1332,7 +1332,7 @@ This example is a Manifest with a single Scene, with a single 3D model of a spac
13321332

13331333
This example adds a Light and a Camera to the previous example, and places the model at a specific point rather than at the default origin position.
13341334

1335-
Annotations may use a type of Selector called a [`PointSelector`][prezi-40-model-PointSelector] to align the Annotation to a point within the Scene that is not the Scene's origin. PointSelectors have three spatial properties, [`x`][prezi-40-model-x], [`y`][prezi-40-model-y] and [`z`][prezi-40-model-z] which give the value on that axis. They also have a temporal property [`instant`][prezi-40-model-instant] which can be used if the Scene has a duration, which gives the temporal point in seconds from the start of the duration, the use of which is defined in the [section on Scenes with Durations]().
1335+
Annotations may use a type of Selector called a [`PointSelector`][prezi-40-model-PointSelector] to align the Annotation to a point within the Scene that is not the Scene's origin. PointSelectors have three spatial properties, [`x`][prezi-40-model-x], [`y`][prezi-40-model-y] and [`z`][prezi-40-model-z] which give the value on that axis. They also have a temporal property [`instant`][prezi-40-model-instant] which can be used if the Scene has a duration. The final commenting annotation in the [Audio in 3D](#audio-in-3d) section has an example of this property.
13361336

13371337
The Light is green and has a position, but has its default orientation of looking along the negative-y axis as no rotation has been specified. The Camera has a position and is pointing at the model's origin via the [`lookAt`][prezi-40-model-lookAt] property. The Camera has a [`fieldOfView`][prezi-40-model-fieldOfView] of 50. The [`near`][prezi-40-model-near] and [`far`][prezi-40-model-far] properties are included to ensure the model falls within the camera's range (although unnecessary in a simple Scene like this). The Scene has a background color.
13381338

@@ -2799,7 +2799,7 @@ In a storytelling or exhibition scenario, the non-painting [`annotations`][prezi
27992799

28002800
All the annotations referred to by the activating annotations' [`target`][prezi-40-model-target] and [`body`][prezi-40-model-body] properties are already present in the Scene from the beginning. Initially, many of them may have the behavior `hidden`, invisible until activated.
28012801

2802-
Interactive examples are provided as recipes in the [IIIF Cookbook](link).
2802+
Interactive examples are provided as recipes in the [IIIF Cookbook][annex-cookbook].
28032803

28042804

28052805
#### The `sequence` behavior
@@ -2828,19 +2828,19 @@ While a IIIF Manifest carries the information required to present a resource on
28282828

28292829
## Linked resources
28302830

2831-
In the following example, the Manifest represents an artwork. The Manifest links to a catalogue record via the [`seeAlso`](prezi-40-model-seeAlso) property, which is intended for machine-readable resources. The [`homepage`](prezi-40-model-homepage) property links to the museum's web page about the painting, and is intended for humans. A viewer displays the latter link for the user to click on, but is unlikely to display the former (the user would just see the JSON at the other end).
2831+
In the following example, the Manifest represents an artwork. The Manifest links to a catalogue record via the [`seeAlso`][prezi-40-model-seeAlso] property, which is intended for machine-readable resources. The [`homepage`][prezi-40-model-homepage] property links to the museum's web page about the painting, and is intended for humans. A viewer displays the latter link for the user to click on, but is unlikely to display the former (the user would just see the JSON at the other end).
28322832

28332833
```
28342834
artwork with seeAlso, rendering, partOf (link to ../c19-french-painting or something)
28352835
28362836
(maybe the seeAlso is to a linked art description)
28372837
```
28382838

2839-
There is one Canvas, and it has a [`rendering`](prezi-40-model-rendering) property linking to a single high resolution tiff file. This link is for human consumers and would typically be displayed as a download option.
2839+
There is one Canvas, and it has a [`rendering`][prezi-40-model-rendering] property linking to a single high resolution tiff file. This link is for human consumers and would typically be displayed as a download option.
28402840

2841-
The Manifest also has a [`partOf`](prezi-40-model-partOf) property that links to several IIIF Collections that contain a reference to it in their `items` properties. The [`partOf`](prezi-40-model-partOf) property allows a Manifest to assert its place in any hierarchical relationship, such as an archival description, or a volume of a periodical, allowing the user (or machines) to navigate "up" the hierarchy and explore further.
2841+
The Manifest also has a [`partOf`][prezi-40-model-partOf] property that links to several IIIF Collections that contain a reference to it in their `items` properties. The [`partOf`][prezi-40-model-partOf] property allows a Manifest to assert its place in any hierarchical relationship, such as an archival description, or a volume of a periodical, allowing the user (or machines) to navigate "up" the hierarchy and explore further.
28422842

2843-
Another common use of [`rendering`](prezi-40-model-rendering) is at the Manifest level, to download a single resource that represents the entire Manifest. For example, the Manifest for a 100-page printed book has 100 canvases, which generate a paged user experience in a viewer. The publisher also links to a PDF representation, a plain text representation, and an ePub representation via the `rendering` property - all representations that a user could download and use offline. Each Canvas could also link to a single text file of the text of that page.
2843+
Another common use of [`rendering`][prezi-40-model-rendering] is at the Manifest level, to download a single resource that represents the entire Manifest. For example, the Manifest for a 100-page printed book has 100 canvases, which generate a paged user experience in a viewer. The publisher also links to a PDF representation, a plain text representation, and an ePub representation via the `rendering` property - all representations that a user could download and use offline. Each Canvas could also link to a single text file of the text of that page.
28442844

28452845
```jsonc
28462846
{
@@ -2875,11 +2875,11 @@ Another common use of [`rendering`](prezi-40-model-rendering) is at the Manifest
28752875
}
28762876
```
28772877

2878-
This example also shows how the [`fileSize`](prezi-40-model-fileSize) property can give useful information to a user when deciding what they want to download.
2878+
This example also shows how the [`fileSize`][prezi-40-model-fileSize] property can give useful information to a user when deciding what they want to download.
28792879

28802880
## Services
28812881

2882-
In many of the examples in this specification an image resource has an associated [IIIF Image API][image-api] Service. This is the most common use of [`service`](prezi-40-model-service) in IIIF, but other types of service are defined by IIIF specifications or available as extensions. Rather than just offer the link for download, the client is expected to interact with the service on the user's behalf. For the Image API, this usually means generating multiple requests for image tiles at the appropriate zoom level. For the [IIIF Search API][search-api], this means accepting user query terms, sending them to the search service endpoint, and rendering the results for further interaction (typically navigation to the result location within the Manifest).
2882+
In many of the examples in this specification an image resource has an associated [IIIF Image API][image-api] Service. This is the most common use of [`service`][prezi-40-model-service] in IIIF, but other types of service are defined by IIIF specifications or available as extensions. Rather than just offer the link for download, the client is expected to interact with the service on the user's behalf. For the Image API, this usually means generating multiple requests for image tiles at the appropriate zoom level. For the [IIIF Search API][search-api], this means accepting user query terms, sending them to the search service endpoint, and rendering the results for further interaction (typically navigation to the result location within the Manifest).
28832883

28842884
Further IIIF Services are provided by the [IIIF Authorization Flow API](auth-api), which provides endpoints for a client to learn about a user's current access to a resource, and guide them through the publisher's access control arrangements if they do not have permission, so that they can (if authorised) acquire whatever credentials the publisher requires.
28852885

0 commit comments

Comments
 (0)