Presentation 4

.github/workflows/internal.yml

@@ -0,0 +1,39 @@
+# This is a basic workflow to help you get started with Actions
+
+name: Test internal links
+
+# Controls when the action will run. Triggers the workflow on push or pull request
+# events but only for the master branch
+on:
+  push:
+    branches:
+      - '**'
+      - '!main'
+
+jobs: # A workflow run is made up of one or more jobs that can run sequentially or in parallel
+  build: # This workflow contains a single job called "build"
+    runs-on: ubuntu-latest # The type of runner that the job will run on
+    env:
+      BUNDLE_WITH: test jekyll_plugins
+      SITE_ID:  'api' # which iiif site this is
+    steps: # Steps represent a sequence of tasks that will be executed as part of the job
+    - name: Checkout # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+      uses: actions/checkout@v6
+    - name: Export BRANCH_NAME # store branch name in $BRANCH_NAME
+      run: echo BRANCH_NAME=`git rev-parse --abbrev-ref HEAD` >> $GITHUB_ENV
+    - name: Setup ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        bundler-cache: true
+    - name: Install
+      run: gem install bundler && bundle
+    - name: Build preview site
+      run: bundle exec rake build:preview
+    - name: Test html
+      run: bundle exec rake test:html
+    - name: Test internal links
+      run: bundle exec rake test:links:internal
+    - name: Test *iiif.io* links
+      run: bundle exec rake test:links:iiif
+    - name: Spec tests
+      run: bundle exec rake api:spec

.github/workflows/linkrot.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest # The type of runner that the job will run on
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v6
       - name: Setup ruby
         uses: ruby/setup-ruby@v1
         with:

.github/workflows/live.yml

@@ -20,7 +20,7 @@ jobs: # A workflow run is made up of one or more jobs that can run sequentially
       JEKYLL_ENV: 'production'
     steps: # Steps represent a sequence of tasks that will be executed as part of the job
     - name: Checkout # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
-      uses: actions/checkout@v2
+      uses: actions/checkout@v6
     - name: Setup ruby
       uses: ruby/setup-ruby@v1
       with:

.github/workflows/preview.yml

@@ -19,7 +19,7 @@ jobs: # A workflow run is made up of one or more jobs that can run sequentially
       SITE_ID:  'api' # which iiif site this is
     steps: # Steps represent a sequence of tasks that will be executed as part of the job
     - name: Checkout # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
-      uses: actions/checkout@v2
+      uses: actions/checkout@v6
     - name: Export BRANCH_NAME # store branch name in $BRANCH_NAME
       run: echo BRANCH_NAME=`git rev-parse --abbrev-ref HEAD` >> $GITHUB_ENV
     - name: Setup ruby
@@ -32,12 +32,6 @@ jobs: # A workflow run is made up of one or more jobs that can run sequentially
       run: bundle exec rake build:preview
     - name: Test html
       run: bundle exec rake test:html
-    - name: Test internal links
-      run: bundle exec rake test:links:internal
-    - name: Test *iiif.io* links
-      run: bundle exec rake test:links:iiif
-    - name: Spec tests
-      run: bundle exec rake api:spec
     - name: Create GitHub deployment # Deploy to Preview site
       uses: glenrobson/deployments@v0.4.2
       id: deployment

.github/workflows/validate.yml

@@ -0,0 +1,23 @@
+name: validate
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    env:
+      BUNDLE_WITH: test jekyll_plugins
+      SITE_ID:  'cookbook' # which iiif site this is
+      URL: 'https://preview.iiif.io'
+
+    steps:
+      - name: Check out this repository
+        uses: actions/checkout@v5
+
+      - name: Run IIIF validator
+        uses: IIIF/presentation-validator@main
+        with:
+          directory: source/presentation/4.0/example/
+          version: "4.0"

.gitignore

@@ -11,3 +11,8 @@ tmp/
 iiifc-theme
 Gemfile.lock
 vendor
+
+.vscode
+.idea
+
+.claude/

source/_data/apis.yml

@@ -17,7 +17,7 @@ presentation:
   image: assets/images/icons/location-info@2x.webp
   alt_text: Presentation API icon
   draft:
-    major: 3
+    major: 4
     minor: 0
     patch: 0
   stable:

source/_includes/code_example.html

@@ -0,0 +1,10 @@
+{% assign _title = include.title | default: 'Full JSON example' %}
+{% assign _target = include.target | default: "_blank" %}
+
+<div class="code-example">
+  <div class="code-example__header">
+    <a href="example/{{ include.src }}" target="{{ _target }}">{{ _title }}</a></div>
+  {% highlight json %}
+  {% include_lines presentation/4.0/example/{{ include.src }} from:{{ include.from }} to:{{ include.to }} %}
+  {% endhighlight %}
+</div>

source/_includes/links.md

@@ -189,7 +189,7 @@
 [org-open-annotation-multi]: http://www.openannotation.org/spec/core/multiplicity.html#Choice "Open Annotation: Multiplicity"
 [org-open-annotation-types]: http://www.openannotation.org/spec/core/core.html#BodyTargetType "Open Annotation: Body Target"
 [org-open-annotation]: http://www.openannotation.org/spec/core/ "Open Annotation"
-[org-openarchives-rsync]: http://openarchives.org/rs/toc
+[org-openarchives-rsync]: https://openarchives.org/rs/toc
 [org-rfc-2119]: https://tools.ietf.org/html/rfc2119 "RFC Keywords"
 [org-rfc-2617]: https://tools.ietf.org/html/rfc2617 "HTTP Authentication: Basic and Digest Access Authentication"
 [org-rfc-2818]: https://tools.ietf.org/html/rfc2818 "HTTP Over TLS"
@@ -207,6 +207,8 @@
 [org-rfc-7231-status]: https://tools.ietf.org/html/rfc7231#section-6 "HTTP 1.1, 6. Response Status Codes"
 [org-rfc-7540]: https://tools.ietf.org/html/rfc7540 "HTTP/2"
 [org-rfc-8259]: https://tools.ietf.org/html/rfc8259 "JSON RFC"
+[org-rfc-7946]: https://datatracker.ietf.org/doc/html/rfc7946 "GeoJSON RFC"
+
 [org-rs-terms]: http://rightsstatements.org/page/1.0/ "rightsstatements.org"
 [org-semver]: http://semver.org/spec/v2.0.0.html "Semantic Versioning 2.0.0"
 [org-w3c-activitystreams]: https://www.w3.org/TR/activitystreams-core/
@@ -245,6 +247,7 @@
 [prezi3-considerations]: {{ site.api_url | absolute_url }}/presentation/3.{{ site.data.apis.presentation.latest.minor }}/#4-json-ld-considerations "Presentation API Section 4"
 [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"
 [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"
+[prezi40-languages]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#language-of-property-values "Language of Property Values"
 [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"
 [prezi3-provider]: {{ site.api_url | absolute_url }}/presentation/3.{{ site.data.apis.presentation.latest.minor }}/#provider
 [prezi3-service]: {{ site.api_url | absolute_url }}/presentation/3.{{ site.data.apis.presentation.latest.minor }}/#service
@@ -279,13 +282,15 @@
 [navPlace]: {{ site.api_url | absolute_url }}/extension/navplace/
 [georeference]: {{ site.api_url | absolute_url }}/extension/georef/
 [registry]: {{ site.api_url | absolute_url }}/registry/ "IIIF Extension Registry"
+[registry-accessibility]: {{ site.api_url | absolute_url }}/registry/accessibility/
 [registry-activity-streams]: https://registry.iiif.io/ "IIIF Registry of Activity Streams"
 [registry-motivations]: {{ site.api_url | absolute_url }}/registry/motivations/
 [registry-behaviors]: {{ site.api_url | absolute_url }}/registry/behaviors/
 [registry-process]: {{ site.api_url | absolute_url }}/registry/process/
 [registry-selectors]: {{ site.api_url | absolute_url }}/registry/selectors/
 [registry-services]: {{ site.api_url | absolute_url }}/registry/services/
 [registry-profiles]: {{ site.api_url | absolute_url }}/registry/profiles/
+[registry-rights]: {{ site.api_url | absolute_url }}/registry/rights/
 [registry-timeModes]: {{ site.api_url | absolute_url }}/registry/timeModes/
 [registry-types]: {{ site.api_url | absolute_url }}/registry/types/
 [registry-viewingDirections]: {{ site.api_url | absolute_url }}/registry/viewingDirections/
@@ -304,5 +309,114 @@
 [recipe-process]: {{  site.cookbook_url | absolute_url }}/recipe/ "Cookbook process"
 [recipe-mvm-image]: {{ site.cookbook_url | absolute_url }}/recipe/0001-mvm-image/ "Simplest Manifest - Image"
 [recipe-segment-image-part]: {{ site.api_url | absolute_url }}/cookbook/segment-image-part/ "Annotating part of an image to a canvas"
+[schema-accessibility]: https://www.w3.org/community/reports/a11y-discov-vocab/CG-FINAL-vocabulary-20241209/#accessibilityFeature-vocabulary "Accessibility Properties for Discoverability Vocabulary"
 [slack]: http://bit.ly/iiif-slack
 [web-arch]: http://www.w3.org/TR/webarch/ "Architecture of the World Wide Web"
+
+[prezi40]: {{ site.api_url | absolute_url }}/presentation/4.0/
+[prezi40-terminology]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#terminology
+
+<!-- Link definitions for Presentation API 4.0 model references -->
+<!-- Generated by scripts/link_code_references.py -->
+
+[prezi40-ldce]: {{ site.api_url | absolute_url }}/presentation/4.{{ site.data.apis.presentation.latest.minor }}/#json-ld-and-extensions "Linked Data Context and Extensions"
+
+[prezi40-context-collisions]: {{ site.api_url | absolute_url }}/presentation/4.{{ site.data.apis.presentation.latest.minor }}/#term-collisions-between-contexts
+
+[prezi-40-model-Agent]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#Agent
+[prezi-40-model-AmbientAudio]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#AmbientAudio
+[prezi-40-model-AmbientLight]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#AmbientLight
+[prezi-40-model-AnimationSelector]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#AnimationSelector
+[prezi-40-model-Annotation]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#Annotation
+[prezi-40-model-AnnotationCollection]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#AnnotationCollection
+[prezi-40-model-AnnotationPage]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#AnnotationPage
+[prezi-40-model-Canvas]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#Canvas
+[prezi-40-model-Choice]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#Choice
+[prezi-40-model-Collection]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#Collection
+[prezi-40-model-DirectionalLight]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#DirectionalLight
+[prezi-40-model-FragmentSelector]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#FragmentSelector
+[prezi-40-model-ImageBasedLight]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#ImageBasedLight
+[prezi-40-model-Manifest]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#Manifest
+[prezi-40-model-OrthographicCamera]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#OrthographicCamera
+[prezi-40-model-PerspectiveCamera]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#PerspectiveCamera
+[prezi-40-model-PointAudio]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#PointAudio
+[prezi-40-model-PointLight]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#PointLight
+[prezi-40-model-PointSelector]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#PointSelector
+[prezi-40-model-Quantity]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#Quantity
+[prezi-40-model-Range]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#Range
+[prezi-40-model-RotateTransform]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#RotateTransform
+[prezi-40-model-ScaleTransform]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#ScaleTransform
+[prezi-40-model-Scene]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#Scene
+[prezi-40-model-Service]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#Service
+[prezi-40-model-SpecificResource]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#SpecificResource
+[prezi-40-model-SpotAudio]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#SpotAudio
+[prezi-40-model-SpotLight]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#SpotLight
+[prezi-40-model-SvgSelector]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#SvgSelector
+[prezi-40-model-TextualBody]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#TextualBody
+[prezi-40-model-Timeline]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#Timeline
+[prezi-40-model-TranslateTransform]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#TranslateTransform
+[prezi-40-model-WktSelector]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#WktSelector
+[prezi-40-model-accompanyingContainer]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#accompanyingContainer
+[prezi-40-model-action]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#action
+[prezi-40-model-angle]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#angle
+[prezi-40-model-annotations]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#annotations
+[prezi-40-model-backgroundColor]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#backgroundColor
+[prezi-40-model-behavior]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#behavior
+[prezi-40-model-body]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#body
+[prezi-40-model-color]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#color
+[prezi-40-model-duration]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#duration
+[prezi-40-model-environment-map]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#environmentMap
+[prezi-40-model-exclude]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#exclude
+[prezi-40-model-far]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#far
+[prezi-40-model-fileSize]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#fileSize
+[prezi-40-model-fieldOfView]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#fieldOfView
+[prezi-40-model-format]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#format
+[prezi-40-model-height]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#height
+[prezi-40-model-homepage]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#homepage
+[prezi-40-model-id]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#id
+[prezi-40-model-instant]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#instant
+[prezi-40-model-intensity]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#intensity
+[prezi-40-model-interactionMode]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#interactionMode
+[prezi-40-model-items]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#items
+[prezi-40-model-label]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#label
+[prezi-40-model-language]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#language
+[prezi-40-model-list]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#List
+[prezi-40-model-lookAt]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#lookAt
+[prezi-40-model-metadata]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#metadata
+[prezi-40-model-motivation]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#motivation
+[prezi-40-model-navDate]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#navDate
+[prezi-40-model-navPlace]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#navPlace
+[prezi-40-model-near]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#near
+[prezi-40-model-partOf]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#partOf
+[prezi-40-model-placeholderContainer]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#placeholderContainer
+[prezi-40-model-position]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#position
+[prezi-40-model-profile]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#profile
+[prezi-40-model-provider]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#provider
+[prezi-40-model-provides]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#provides
+[prezi-40-model-refinedBy]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#refinedBy
+[prezi-40-model-rendering]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#rendering
+[prezi-40-model-requiredStatement]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#requiredStatement
+[prezi-40-model-rights]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#rights
+[prezi-40-model-scope]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#scope
+[prezi-40-model-selector]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#selector
+[prezi-40-model-seeAlso]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#seeAlso
+[prezi-40-model-service]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#service
+[prezi-40-model-source]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#source
+[prezi-40-model-spatialScale]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#spatialScale
+[prezi-40-model-start]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#start
+[prezi-40-model-structures]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#structures
+[prezi-40-model-summary]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#summary
+[prezi-40-model-supplementary]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#supplementary
+[prezi-40-model-target]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#target
+[prezi-40-model-temporalScale]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#temporalScale
+[prezi-40-model-thumbnail]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#thumbnail
+[prezi-40-model-timeMode]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#timeMode
+[prezi-40-model-transform]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#transform
+[prezi-40-model-type]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#type
+[prezi-40-model-value]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#value
+[prezi-40-model-viewingDirection]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#viewingDirection
+[prezi-40-model-volume]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#volume
+[prezi-40-model-width]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#width
+[prezi-40-model-x]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#x
+[prezi-40-model-y]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#y
+[prezi-40-model-z]: {{ site.api_url | absolute_url }}/presentation/4.0/model/#z