Skip to content

Commit 3f166a0

Browse files
leontpngleontpng
authored
Merge pull request #650 from leontpng/0027-alternative-page-order
Post-TRC changes
2 parents 9367c1d + 37a52d0 commit 3f166a0

File tree

2 files changed

+21
-25
lines changed

2 files changed

+21
-25
lines changed

‎recipe/0027-alternative-page-order/index.md‎

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -15,21 +15,17 @@ A book may contain pages in the incorrect order; for example, a codex that was r
1515

1616
## Implementation Notes
1717

18-
In [Presentation API 3.0](https://iiif.io/api/presentation/3.0/#54-range), setting a Range’s `behavior` value to `sequence` allows you to define a specific viewing order for Canvases that differs from the default order in the Manifest’s `items` property. When `behavior` is set to `sequence`, user interfaces that interact with this order should use the order within the selected Range, rather than the default order of items.
18+
In [Presentation API 3.0](https://iiif.io/api/presentation/3.0/#54-range), setting a Range’s `behavior` value to `sequence` allows you to define a specific viewing order for Canvases that differs from the default order in the Manifest’s `items` property. Such Ranges must be directly within the `structures` property of the Manifest and must not be referenced or embedded within other Ranges ([see specification](https://iiif.io/api/presentation/3.0/#54-range)). When `behavior` is set to `sequence`, user interfaces that interact with this order should use the order within the selected Range, rather than the default order of items.
1919

2020
There may be more than one Range, each representing an alternative sequence of items (such as different orderings of book pages). The first Range should act as the default ordering, and any additional Ranges should be available for the user to select. For a IIIF viewer to display the selectable Ranges, each Range should have a `label`.
2121

2222
If reordering the Canvases affects the reading layout or direction, properties can be set on the Range (such as `viewingDirection` or other [valid behaviors](https://iiif.io/api/presentation/3.0/#behavior) besides `sequence`) to override those inherited from the Manifest.
2323

24-
## Restrictions
25-
26-
Ranges with the `behavior` value set to `sequence` must be directly within the `structures` property of the Manifest and must not be referenced or embedded within other Ranges ([see specification](https://iiif.io/api/presentation/3.0/#54-range)). Such Ranges have limited hierarchical nesting and cannot be used to describe more complex structures, such as a [Table of Contents for Book Chapters][0024].
27-
2824
## Example
2925

30-
These manuscript folios are an excerpt from the original draft of the 1895 novel _Piccolo mondo antico_ by novelist and Nobel Prize nominee for Literature, Antonio Fogazzaro. The original autograph numbering in pen (384, 385, [386], 387) is incorrect, so archivists noted the correct reading order in pencil: 171r (387), 171v (384), 172r (385), 172v ([386]).
26+
These manuscript folios are an excerpt from the original draft of the 1895 novel _Piccolo mondo antico_ by novelist and Nobel Prize nominee for Literature, Antonio Fogazzaro. The pencil numbering in the upper right of each page (171r–172v) follows the bifolio's physical order, but does not correspond to the author's intended sequence, which he noted in ink: 384 (171v), 385 (172r), [386] (172v), 387 (171r).
3127

32-
Two Ranges are provided within the `structures` to represent this case study. From the two Ranges with the `behavior` value `sequence`, the first Range should be used as the navigation default, and the other should be selectable.
28+
Two Ranges are provided within the `structures` to represent this case study. From the two Ranges with the `behavior` value `sequence`, the first Range should be used as the navigation default, and the other should be selectable via its supplied `label`.
3329

3430
Images provided by permission of Biblioteca Civica Bertoliana.
3531

‎recipe/0027-alternative-page-order/manifest.json‎

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@
4545
"type": "Canvas",
4646
"label": {
4747
"en": [
48-
"384 (171v)"
48+
"171r (387)"
4949
]
5050
},
5151
"height": 3184,
@@ -60,14 +60,14 @@
6060
"type": "Annotation",
6161
"motivation": "painting",
6262
"body": {
63-
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0186v_aVISNK_384/full/max/0/default.jpg",
63+
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0186r_aVISNK_387/full/max/0/default.jpg",
6464
"type": "Image",
6565
"format": "image/jpeg",
6666
"height": 3184,
6767
"width": 2156,
6868
"service": [
6969
{
70-
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0186v_aVISNK_384",
70+
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0186r_aVISNK_387",
7171
"type": "ImageService3",
7272
"profile": "level1"
7373
}
@@ -84,7 +84,7 @@
8484
"type": "Canvas",
8585
"label": {
8686
"en": [
87-
"385 (172r)"
87+
"171v (384)"
8888
]
8989
},
9090
"height": 3184,
@@ -99,14 +99,14 @@
9999
"type": "Annotation",
100100
"motivation": "painting",
101101
"body": {
102-
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0187r_aVISNK_385/full/max/0/default.jpg",
102+
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0186v_aVISNK_384/full/max/0/default.jpg",
103103
"type": "Image",
104104
"format": "image/jpeg",
105105
"height": 3184,
106106
"width": 2156,
107107
"service": [
108108
{
109-
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0187r_aVISNK_385",
109+
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0186v_aVISNK_384",
110110
"type": "ImageService3",
111111
"profile": "level1"
112112
}
@@ -123,7 +123,7 @@
123123
"type": "Canvas",
124124
"label": {
125125
"en": [
126-
"[386] (172v)"
126+
"172r (385)"
127127
]
128128
},
129129
"height": 3184,
@@ -138,14 +138,14 @@
138138
"type": "Annotation",
139139
"motivation": "painting",
140140
"body": {
141-
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0187v_aVISNK_386/full/max/0/default.jpg",
141+
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0187r_aVISNK_385/full/max/0/default.jpg",
142142
"type": "Image",
143143
"format": "image/jpeg",
144144
"height": 3184,
145145
"width": 2156,
146146
"service": [
147147
{
148-
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0187v_aVISNK_386",
148+
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0187r_aVISNK_385",
149149
"type": "ImageService3",
150150
"profile": "level1"
151151
}
@@ -162,7 +162,7 @@
162162
"type": "Canvas",
163163
"label": {
164164
"en": [
165-
"387 (171r)"
165+
"172v [386]"
166166
]
167167
},
168168
"height": 3184,
@@ -177,14 +177,14 @@
177177
"type": "Annotation",
178178
"motivation": "painting",
179179
"body": {
180-
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0186r_aVISNK_387/full/max/0/default.jpg",
180+
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0187v_aVISNK_386/full/max/0/default.jpg",
181181
"type": "Image",
182182
"format": "image/jpeg",
183183
"height": 3184,
184184
"width": 2156,
185185
"service": [
186186
{
187-
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0186r_aVISNK_387",
187+
"id": "https://iiif.io/api/image/3.0/example/reference/3ec31f43ce55cfcc076804c88c06aa43-CF-f0187v_aVISNK_386",
188188
"type": "ImageService3",
189189
"profile": "level1"
190190
}
@@ -206,7 +206,7 @@
206206
],
207207
"label": {
208208
"en": [
209-
"Original Page Order"
209+
"Physical sequence"
210210
]
211211
},
212212
"items": [
@@ -236,24 +236,24 @@
236236
],
237237
"label": {
238238
"en": [
239-
"Corrected Page Order"
239+
"Author-intended sequence"
240240
]
241241
},
242242
"items": [
243243
{
244-
"id": "{{ id.path }}/canvas/p4",
244+
"id": "{{ id.path }}/canvas/p2",
245245
"type": "Canvas"
246246
},
247247
{
248-
"id": "{{ id.path }}/canvas/p1",
248+
"id": "{{ id.path }}/canvas/p3",
249249
"type": "Canvas"
250250
},
251251
{
252-
"id": "{{ id.path }}/canvas/p2",
252+
"id": "{{ id.path }}/canvas/p4",
253253
"type": "Canvas"
254254
},
255255
{
256-
"id": "{{ id.path }}/canvas/p3",
256+
"id": "{{ id.path }}/canvas/p1",
257257
"type": "Canvas"
258258
}
259259
]

0 commit comments

Comments
 (0)