Overview# I looked into how to use the Files/Markers tabs of the @samvera/ramp viewer, one of the viewers compatible with IIIF Audio/Visual, so this is a personal note for future reference.
Documentation# For Files, documentation was found at the following.
https://samvera-labs.github.io/ramp/#supplementalfiles
For Markers, documentation is found at the following.
https://samvera-labs.github.io/ramp/#markersdisplay
Data Used# “Kensei News Volume 1” (Nagano Prefectural Library) is used.
https://www.ro-da.jp/shinshu-dcommons/library/02FT0102974177
Files Tab# It is documented that it reads the rendering property. The rendering property is also featured in the following Cookbook.
https://iiif.io/api/cookbook/recipe/0046-rendering/
The following script adds the rendering property to the manifest file.
d e f a d d _ r m j j r m o w r e a a a e a u i e n n p p n n t t t d i a a d i p h u e f n n e l } i t f f u f r r e _ _ r a , d y o e t o . n i s s s i b = p r s _ p w n t e e n e j e m t p e r o g a a g l " a = a . a n i u ( = r r = j p " t r t ( t t s c c = { a a D = e h o e p e s h h " n a " n u ( u l e _ _ R : _ t a d = t m t f l i a e s a p e p a _ , f d p s [ e s p r f u n p . i o " a e l i " t i a m l = _ u ア r t i n { _ f t a o u r イ c " c g s p e h n a m r c テ h , a e a s i d a l e ム _ t = l t t f _ n I 参 a i f h . e m i = t 照 p o r . , j s a f e A i n e i s t n e f m P _ / n n " o _ i s " ( I u j d p w n p f t h " r s e u " ( a e . t ] l o r t ) i t s h t , , n i _ n h t o p " n d a d ) ( m s g i s e : m e : r n a p / } f t n a / / : = i g j m 2 f e p a ) e [ s n ) s 1 e i t ] a f _ . r e p i c s a d h t t . . _ h s g r ) p o e l . n i j d t p e ( / r " a i / p n " i g ) / . [ i j - t s 1 e o ] m n / " { j a p a n _ s e a r c h _ i d } "
The following manifest file is created.
{ } " " " " } " } " ] @ i t l , r , r , c d y a " ] e " } " } e { } o " p b j q l , v n n : e e a " u a " ] a " ] d " " " } " t " l " 県 i b j l j e i t l , f e " : " : 政 r e a " u a " r d y a " ] o x h : ニ e l " A e " 『 i " p b j r t t " [ ュ d " : t " : 県 n : e e a " m " t M { ー S : t : 政 g " l " ア a : p a ス t [ r [ ニ " " : " : イ t s n a { i { ュ : h : テ " " : i 第 t b ー t " [ ム : h / f 1 e u ス [ t D { 参 t / e 巻 m t p a 照 " t d s " e i 第 s t A a p 1 t n o 1 : a P p : u " t n 巻 / s I p / 7 , " " 』 / e " l / h : （ j t i i q 県 p " c i 8 { 立 s , a i z 長 e t f i 野 a i . l 図 r o i u 書 c n o w 館 h / / l ） . j a 9 を g s p . 改 o o i c 変 . n / l " j " p o p r u / e d a s f p e r i n o / t n i a t t t . e i n m o e / n t s / / d 3 s c / d o c c m o o m n m o t m n e o s x n _ t s n . _ p j n l s p - o l 0 n - 2 " 0 F , 2 T F 0 T 1 0 0 1 2 0 9 2 7 9 4 7 1 4 7 1 7 7 " 7 , / m a n i f e s t . j s o n " ,
Below is a display example in the viewer.
Note that the rendering property was displayed as follows in Clover IIIF.
Markers Tab# It is documented that annotations with highlighting motivation that have time information are displayed.
The following script adds annotations with highlighting motivation to the manifest file.
d e f a d d _ h m l i o w r i a a f u i e g n b t t t h i e o p h u l f l s w c l a a # c c f u f r i e _ . i a a n n a a o t o . n g s p p t n b n n d n n r _ p w h t a a h v e o o u v v p e r o t t t l a l _ _ r a a i l i s # n i i f i a n i u ( = h h o a s s p p a s s a f t a f n o f t ( t t s . p b a a t _ _ i b a e m s r h o e p e s = e e e = = g g i w h n e " r n e " t t u ( u l e x n l e e o i e l T c t d I c a j a b x y w h a a h b = t m t f l f i ( _ m l _ n d i t i o = n o n n b n n r r p a _ , f " s l s a a = i t g q = m n = = s n c i n = = = = n n e e f u n p . { t a e n b d = h h d e t l t t e n o = o o s a " t i a m l s s b g i e c t m l s i l s a a i s _ b b b b i m # t # b } _ a h k { _ f t a o e ( e f l a = 1 = ( a t n a t b n n r i i b b b b = d o a o p n o s p e h n a l l l = e _ n 0 = r b a u b a e c u = a d n [ [ [ [ = t t r t d a n l e a s i d f a _ s s v a 0 c a e m e e r l e e n s " " " " A a i a g a y g o d l t t f _ . b p j t e a n a c n l p l t [ s l g = t L T W H n n v r e r = " " " e f h . e m i e a s . g s n n a g s " [ " " a e a e o i e n n a g t g { t v f . > . , j s a n l t o i [ . o v n e [ " + L b ( f n f p d i o o t e = e y a o a i s t n p _ h n t " a _ a v ( i n T a n e l " c t " t g t _ i t f t p l r d 0 n " o _ i u p , . e L n p s a l ] o i d b o l e { e " ] h h a i o = " = e u m d p w n p f t a l m a n a . s e t m u e t [ n a s ] " t t d n f { f " e a _ a u " ( a e _ t " o s b o g w . n e r l " ( n [ ] " i , = " c " : " t i n t ) i t s d h r a [ e t e i h ( i s a " i L i n j ] o " { a { : " t d _ n h t i ) " d 0 l a . d e l n t t ] n a n o ] c n h c n c " : e d a d , ( r : ) ( ] s t i t i a a i [ b s _ [ c a ( i a v a T n m i i s e m } f " i d h g b l m o " l e t p " a n c g n a n e a " ( r n t a / a ) ] o h e a p n N a l a a B n v a c h v s v x m t > } f t h n o s n t l b " a b " n g o v a n a l a . a t e e / : = r i u s s e ] m e ] c e u a s v n i s i s u , x t m 2 e f t f [ ) l e l [ e _ n s _ a v g . d . a t h a ) s e p : 0 ) : / " [ " s i d _ h s a h i } i l / r n ) h s u ] ) ] " I ) d i w e _ s t d # d B h e i o t t : 1 L n ) } n i i w _ i } t } o t s f l _ _ 0 a s : / g d g i h n # = # d m h e d p l 0 b t a B t h d e g x { t y l o s = a a 0 e a { o h t t i " y s = " " l t 4 t b l n i x h g , w t { , , d _ 0 h e " c } " h h a s : h 0 ) l ] e - ] t = r t i ) . : s { { t a g : j " j x } r h s ] } } & t l o " , x } i n { y " g " y w , h } h t , = . { { j w x s } } o , , n { { " h y } } & , t { = w { } s , t { a h r } t " } , , { e n d } " ,
As a note, the markers were not displayed when the target was written as follows.
target=f"{canvas.id}#xywh={x},{y},{w},{h}&t={start},{end}",
It appeared that a format including #t= with only the start point is required, as shown below. xywh is optional.
target=f"{canvas.id}#t={start}&xywh={x},{y},{w},{h}",
As a result, the following manifest file is created.
{ } " " " " } " } " ] " @ i t l , r , h , i c d y a " ] e " } " } o { } { } t { o " p b j q l , v m , e n : e e a " u a " ] a " ] e " " " } " " " } m " " " " " " ] " t " l " 県 i b j l j p i t l i t l s i t h w d i , a e " : " : 政 r e a " u a " a d y a " ] d y a " ] " d y e i u t { } n { x h : ニ e l " A e " 『 g " p b j " p b j : " p i d r e n t t " [ ュ d " : t " : 県 e : e e a " : e e a " : e g t a m " " " ] o " " " " t M { ー S : t : 政 " " l " 信 " l " ジ [ " h h t s i t i t i t i : p a ス t [ r [ ニ : " : " : 州 " : " : ャ " : t " i " d y t { } a d y t { } { } { } s n a { i { ュ h : デ h : パ h " : o : " p e t " p e , , , " : i 第 t b ー [ t " [ ジ t " [ ン t " : n : e m " " " " } " i : e m " " " } " " } " " " " " } " " " " " } " h / f 1 e u ス t T { タ t T { サ t C 6 " [ " s i t m b , t o " s i t l , m b , t i t m b , t i t m b , t t / e 巻 m t p e ル p e ー p a 4 4 : " : " d y o o " " " " " " a n " : " d y a " ] o o " " " a d y o o " " " a d y o o " " " a t d s " e i 第 s x コ s x チ s n 8 0 h : " p t d i t h w d f r s h : " p b j t d i t f r " p t d t v f r " p t d t v f r p 1 t n o 1 : t モ : t " : 0 , 6 t " : e i y d y e i u o g " t " : e e a " i y d y o g : e i y y a o g : e i y y a o g : u " t n 巻 / " ン / " / a , 1 t A [ " v " " p i d r r e : t A [ " l " W v " " p r e " v " p l r e " v " p l r e / 7 , " " 』 / , ズ / , / s 9 p n " : a : : e g t a m t p n " : " : e a : : e m t " : a : e u m t " : a : e u m t / h : （ w j d " . s n h t " h h t a " [ s n h : b t " a " h t " e a " h t " e a " i q 県 w 県 p 1 , 6 : t " i { " : t " i t : : t " [ V i { " : t : t " i { : " t : t " i { : " t : i 8 { 立 w 立 s u 1 t t A o h " : o " t t A { T o h " t A o : " t A o : " i z 長 . 長 e 7 9 / a p n n t " : n : " / a p n T n t " : " p n n " : " p n n " : " f i 野 r 野 a h 6 d t s n " t V 6 " h d t s n " t T h s n " T " h s n " T " h . l 図 o 図 r q 2 1 i : : p i 4 4 : " t 1 i : T : p e " t : : e B " t : : e B " t i u 書 - 書 c 8 , u o t s d 8 0 v t u o t r s x t t t x l t t t x l t t o w 館 d 館 h z 7 n / a " : e 0 , 6 i p 7 n / a a " : t e p / a " t a e p / a " t a e p / l ） a 所 . i h P d t p / , 1 d s h P d t n s / " x s d t h u c x s d t h u c x s a 9 を . 蔵 g l q a 1 i a " 9 e : q a 1 i s u / , t : 1 i i a k t : 1 i i a k t : p . 改 j 資 o u 8 g u o i d , . o / 8 g u o c p d / / u o g l b / u o g l b / i c 変 p 料 . w z e 7 n n 1 6 / / z e 7 n r p 1 v / 7 n h B h / 7 n h B h / / l " / " j l i " h " t u 1 m d i " h " i l u t d h " l o a t d h " l o a t d p o s p 9 l , q , i 7 9 p 1 l , q , p e 7 t 1 q , i d r m 1 q , i d r m 1 r u h / . u 8 n h 6 4 u u 8 t m h " u 8 g y d l u 8 g y d l u e d i i c w z g q 2 " 7 w z e q 7 z h " " " 7 z h " " " 7 s f n t l l i " 8 , h l i ( n 8 h i t , , h i t , , h e r s e o 9 l , z q 9 l m t z q l i q l i q n o h m u . u i 8 . u a i i 8 u n 8 u n 8 t n u / d c w l z c w c n l z w g z w g z a t - s f l l u i l l h g u i l " i l " i t . d d r o 9 w l o 9 i " w l 9 , l 9 , l i n c c o u . l u u . n , l u . u . u o e o o n d c 9 w d c e 9 w c w c w n t m m t f l . l f l - . l l l l l / / m m . r o c 9 r o g c 9 o 9 o 9 3 s o o n o u l . o u e l . u . u . / d n n e n d o c n d n o c d c d c c c s s t t f u l t f e u l f l f l o o / _ / . r d o . r r d o r o r o n m l n s n o f u n o a f u o u o u t m i p d e n r d e n t r d n d n d e o b l c t t o f t t e o f t f t f x n r - o / . n r / . d n r . r . r t s a 0 m s n t o s n ) t o n o n o . _ r 2 m d e . n d e " . n e n e n j n y F o c t n t c t n t t t t t s p / T n o / e . o / e . / . / . o l 0 0 s m s t n m s t n s n s n n - 2 1 _ m d / e m d / e d e d e " 0 F 0 n o c s t o c s t c t c t , 2 T 2 p n o d / n o d / o / o / F 0 9 l s m c s s m c s m s m s T 1 7 - _ m o d _ m o d m d m d 0 0 4 0 n o m c n o m c o c o c 1 2 1 2 p n m o p n m o n o n o 0 9 7 F l s o m l s o m s m s m 2 7 7 T - _ n m - _ n m _ m _ m 9 4 " 0 0 n s o 0 n s o n o n o 7 1 , 1 2 p _ n 2 p _ n p n p n 4 7 0 F l n s F l n s l s l s 1 7 2 T - p _ T - p _ - _ - _ 7 " 9 0 0 l n 0 0 l n 0 n 0 n 7 , 7 1 2 - p 1 2 - p 2 p 2 p / 4 0 F 0 l 0 F 0 l F l F l m 1 2 T 2 - 2 T 2 - T - T - a 7 9 0 F 0 9 0 F 0 0 0 0 0 n 7 7 1 T 2 7 1 T 2 1 2 1 2 i / 4 0 0 F 4 0 0 F 0 F 0 F f c 1 2 1 T 1 2 1 T 2 T 2 T e a 7 9 0 0 7 9 0 0 9 0 9 0 s n 7 7 2 1 7 7 2 1 7 1 7 1 t v / 4 9 0 / 4 9 0 4 0 4 0 . a c 1 7 2 c 1 7 2 1 2 1 2 j s a 7 4 9 a 7 4 9 7 9 7 9 s " n 7 1 7 n 7 1 7 7 7 7 7 o , v / 7 4 v / 7 4 / 4 / 4 n a c 7 1 a c 7 1 c 1 c 1 " s a / 7 s a / 7 a 7 a 7 , / n v 7 / n v 7 n 7 n 7 p v i / p v i / v / v / a a d c a a d c a c a c g s e a g s e a s a s a e / o n e / o n / n / n " p . v 2 p . v p v p v , a m a " a v a a a a a g p s , g t s g s g s e 4 " e t " e # e # / " 2 " 2 t 2 t a , / , / = / = n a a 2 a 2 n 1 6 1 7 1 o " 9 . 1 . t , - 0 - 5 a 0 2 0 2 t " 1 " 1 i , & , & o x x n y y " w w , h h = = 3 5 3 . . 0 7 4 2 5 2 2 9 1 9 3 9 1 0 0 9 3 5 2 9 9 1 4 6 3 7 7 5 3 , , 2 5 3 . . 7 8 3 5 7 9 9 6 9 4 4 9 7 3 6 0 0 0 2 5 7 7 4 5 8 2 8 5 7 6 , , 6 5 2 5 7 5 . . 2 8 9 6 6 4 0 0 2 2 8 8 1 9 3 3 7 0 2 6 0 6 7 4 , 1 4 , 7 4 2 2 . 2 2 . 1 4 9 5 0 2 4 3 7 8 5 3 4 0 6 4 3 1 8 3 6 8 7 1 " 8 4 " As a note, only one annotation list was processed as a target. Therefore, annotations are stored in the same array as the supplementing motivation annotations.
Below is a display example in the viewer. Markers were displayed in a table format as shown below. Clicking the link attached to the marker name navigated to the specified time.
Additionally, in the above, supplementing annotations were not displayed and were only shown in the Transcripts tab.
Summary# I hope this serves as a useful reference for handling annotations in IIIF A/V.
