Merge pull request #222 from markpbaggett/recipe_0046

Add solution for recipe_0046 and a helper to keep things neat.

docs/recipes/0046-rendering.md

@@ -0,0 +1,10 @@
+# Providing Alternative Representations
+|              | **Cookbook URLs** |
+|--------------|-------------------|
+| **Recipe:**  | [https://iiif.io/api/cookbook/recipe/0046-rendering/](https://iiif.io/api/cookbook/recipe/0046-rendering/) |
+| **JSON-LD:** | [https://iiif.io/api/cookbook/recipe/0046-rendering/manifest.json](https://iiif.io/api/cookbook/recipe/0046-rendering/manifest.json) |
+
+### Method 1 - Add External Item with add_rendering_helper
+```python
+--8<-- "docs/recipes/scripts/0046-rendering-method1.py"
+```

docs/recipes/scripts/0046-rendering-method1.py

@@ -0,0 +1,55 @@
+from iiif_prezi3 import Manifest, ExternalItem, config
+
+config.configs['helpers.auto_fields.AutoLang'].auto_lang = "en"
+base_url = "https://iiif.io/api/cookbook/recipe/0046-rendering"
+
+rendering = ExternalItem(
+    id="https://fixtures.iiif.io/other/UCLA/kabuki_ezukushi_rtl.pdf",
+    type="Text",
+    label="PDF version",
+    format="application/pdf"
+)
+manifest = Manifest(
+    id=f"{base_url}/manifest.json",
+    label="Alternative Representations Through Rendering",
+    summary="Playbill for \"Akiba gongen kaisen-banashi,\" \"Futatsu chōchō kuruwa nikki\" and \"Godairiki koi no fūjime\" performed at the Chikugo Theater in Osaka from the fifth month of Kaei 2 (May, 1849); main actors: Gadō Kataoka II, Ebizō Ichikawa VI, Kitō Sawamura II, Daigorō Mimasu IV and Karoku Nakamura I; on front cover: producer Mominosuke Ichikawa's crest.",
+    viewingDirection="right-to-left",
+    rendering=rendering,
+)
+canvas_front = manifest.make_canvas_from_iiif(
+    url="https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_001",
+    id=f"{base_url}/canvas/p1",
+    label="front cover",
+    anno_id=f"{base_url}/annotation/p0001-image",
+    anno_page_id=f"{base_url}/page/p1/1"
+)
+canvas_one_two = manifest.make_canvas_from_iiif(
+    url="https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_002",
+    id=f"{base_url}/canvas/p2",
+    label="pages 1–2",
+    anno_id=f"{base_url}/annotation/p0002-image",
+    anno_page_id=f"{base_url}/page/p2/1"
+)
+canvas_three_four = manifest.make_canvas_from_iiif(
+    url="https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_003",
+    id=f"{base_url}/canvas/p3",
+    label="pages 3–4",
+    anno_id=f"{base_url}/annotation/p0003-image",
+    anno_page_id=f"{base_url}/page/p3/1"
+)
+canvas_five_six = manifest.make_canvas_from_iiif(
+    url="https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_004",
+    id=f"{base_url}/canvas/p4",
+    label="pages 5–6",
+    anno_id=f"{base_url}/annotation/p0004-image",
+    anno_page_id=f"{base_url}/page/p4/1"
+)
+canvas_back_cover = manifest.make_canvas_from_iiif(
+    url="https://iiif.io/api/image/3.0/example/reference/4f92cceb12dd53b52433425ce44308c7-ucla_bib1987273_no001_rs_005",
+    id=f"{base_url}/canvas/p5",
+    label="back cover",
+    anno_id=f"{base_url}/annotation/p0005-image",
+    anno_page_id=f"{base_url}/page/p5/1"
+)
+
+print(manifest.json(indent=2))