Add a Helper for AnnotationPageRef to Canvas like `add_annotation_page_ref()`

[markpbaggett]

Description

Recipes like 269 require you to add an annotation page ref, which isn't possible with existing helpers. It would also be nice that helpers like make_canvas_from_iiif() would also allow you to pass an AnnotationPageRef to the constructor. Doing so currently throws an error.

Function name / Parameters / Return

add_annotation_page_ref() should live on Canvas, and only require an id. None should not be allowed since the reference is an External Item. It should return the pre-existing Canvas with the annotation page ref.

Function name:

add_annotation_page_ref()

Parameters:

annotation_page_ref_id

Returns:

Canvas

Objects

• Base Object (all Prezi3 Classes)
• Collection
• Manifest
• Canvas
• Range
• AnnotationCollection
• AnnotationPage
• Annotation
• Content Resource - Image
• Content Resource - Video
• Content Resource - Text
• Service
• Provider
• Other - please list below

Considerations

N/A

[glenrobson]

Discussion on slack: https://iiif.slack.com/archives/C04EWD70FCH/p1755517697984749