Humanities

概要 2023/07/20時点において、まだベータ版のようですが、Omeka Sで変更履歴を記録するモジュール「Omeka-S-module-HistoryLog」を試す機会がありましたので、備忘録です。 https://github.com/Daniel-KM/Omeka-S-module-HistoryLog インストール 以下に記載がありますが、事前にGenericモジュールをインストールする必要がある場合があります。 https://github.com/Daniel-KM/Omeka-S-module-HistoryLog#installation その他は通常のモジュールのインストール手順と同じです。インストール後、モジュール一覧に以下のように表示されます。 使い方 例えば、特定のアイテムのタイトルを以下のように更新してみます。 保存すると、画面の右下に「History Log」という項目が表示され、最終更新日と更新イベントへのリンクが表示されます。 リンクをクリックすると、変更イベントの一覧が表示され、いつ・誰が・どのような更新を行なったかを確認できます。 まとめ StrapiやDrupalなどのCMSでは標準的な機能ですが、変更履歴を記録できるようになると、さらに便利になるように思います。 まだ開発中のモジュールのため、ご利用される際は注意が必要ですが、参考になりましたら幸いです。

概要 Omeka Classic IIIF Toolkitで使用されているMiradorを2.7にアップデートしました。以下のページでソースコードをご確認いただけます。 https://github.com/nakamura196/IiifItems また、以下のURLから、zipファイルをダウンロードできます。 https://github.com/nakamura196/IiifItems/releases/download/1.1.1/IiifItems-1.1.1.zip できるようになること Mirador 2.7を使用することにより、IIIFのImage APIに非対応の画像でもビューアに表示することが可能になります。これにより、一般に公開されている画像に対しても、Miradorを用いたアノテーションの付与および管理が可能になります。 この利点を活かして、画像のURLを含むCSVファイルを用意して、Omeka Classicに登録する以下の記事を執筆しています。 まとめ Omeka Classic IIIF Toolkitの利用にあたり、参考になりましたら幸いです。 なお、Omeka Classic IIIF Toolkitを開発してくださったトロント大学図書館の方々に感謝いたします。

概要 Amazon EC2に立てたVirtuosoのヘルスチェックを行う機会がありましたので、その備忘録です。 具体的には、何らかの不具合で、Virtuoso（https://xxx.zzz/sparql など）がエラーを返すようになってしまった際、その内容をメールで通知します。 方法 以下の記事で、Amazon EC2にVirtuoso RDFストアを構築する方法を紹介しています。 上記では、ELBを使用しています。上記の記事から1点だけ変更を行う必要があります。Health check pathを/に設定していますが、この部分をSPARQLエンドポイントへのパス（例えば/sparql）に変更します。 その後、以下の記事を参考に、CloudWatchやAmazon SNSの設定を行いました。 https://dev.classmethod.jp/articles/elb-healthcheck-monitoring-by-cloudwatch-alarm/ 結果 以下のようにモニタリングを行うことができるようになりました。 またアラート発生時には、以下のようなメールが届くようになりました。 Y V h A - - - - - - T - M - - - - - - - S - - - o i t l h o t u e t a N S R T A A r T n M M D P S U T a O A I w p r a t e i W l e h i e e i e t n r t K L N a s m m a a m S a s e t t t m r a i e e : A S r t : e t s e r h o r r e i t t a R U e h / D : e o s A m o a r i i n o i : t C M F i / e n t c l l e c c s d s M h : F r s u t C a c A d a d N N i : t i a I e s a h f m o r : r a a o i s n [ C c a - i a o p u n m M m m n c s g a I e l e l n r : n : e e e s : i e r E i a a s g t i t s : : n n N v r s : e S : s r p g A : T i m t : t i a D c a _ n - a i c c a t w D g i 1 t n : e t i s A n . e : a o : T t c t : n s A h t o C h s n : i h n h e : s s e s a : o n A u e A l g L s m W e e A - a S . : R e i a M a l M w s a s s t b n . t - e a a v O T F x a a 1 c g m i K h r x r t : a e a r r i x n e x u m z t e d x : x s e o u s a x a w x e n n o h y x w h x t . s A o x s e x y c o L l 1 x : n x o C o - A d 4 x c x u o m u R x l t A U [ 6 M n b x r n / n M C J x o h W n T 0 i o r x s c h r u x u e S H a n t e x A o l e o l x d / e r s i a x m l o a s y x w m A a g e m s c x a e u l s , a e p l e c u p h x z : d t e t t p t t o m e i x o w h d 2 c r l h G n c n : n a y : 0 h i i y r d i g D t h 2 : c c H o s f e C c o n 3 u a o u i f l h s o s i t s p e a o / t 0 - s i t d u u d c d 8 e o C = l d e o a : a G n o t W e u t 0 s r E u t _ a p n a 5 t e L n a C t l t p : - a B t r l c i - o 3 1 t g o h n a i 0 : e e u k l n x r t d A . a t U x T g W l j r s T x h r a a s m C x a o t r ? w x n u c m r e x O p h e r x r / _ " g e x E v A v i x q i l i o r x u r a r n e x a t r t = c x l u m u u e x T o s o s i x o s _ s - v : T o T o e e a h ] o - a d l r p u s a e [ i n t f r s A c h - o m h v ] e 1 r : o a a # v l i l a 5 i d l t l r a h a p t 1 b y r e u . i h m r o 0 l o s i s i s V o o f t t 2 d - o y c : s u r Z o a n o u l a h a n n a n e t e t r d a - m l l = a / 5 t e l v h a u a i m y s s r r i h t - m t s o e " u s s 5 a o i t s i s n c o t n o g o f - - u 1 t u d n t a h n a t h ] e h t - e e a a [ U a p l l L S l o a a o t i r s a E h n m t d a y t B s h s 5 a t o l s w p a ( t e e n N c r r c . o e i e u o r V n t d i t r ( = r - e s g a a ) a i l t p n a e o p i r d f / a m v ) a 6 i s 0 r r t e [ s u g B e o i r c s o e o o n a n / c d y h h s y a i . y s n y g y e ] y n . y t y e y r y e y d y y t y h y e ] A L A R M s t a t e , b e c a u s e " T h r e s h o l d C r o s s e d : n o d a t a p o i n t s w e r e r e c e i v e d f o r 5 p e r i o d s a n d 5 m i s s i n g d a t a p o i n t s w e r e t r e a t e d a s [ B r e a c h i n g ] . " a t " F r i d a y 1 4 J u l y , 2 0 2 3 0 8 : 0 5 : 3 0 U T C " . まとめ 同様の環境でVirtuosoを運用されている際の参考になりましたら幸いです。 ...

OpenSeadragonのzoomToメソッドを使用した後に、viewport.applyConstraints()を呼び出すことで、ビューポートが設定した制約を満たすように調整されます。これは、ズームやパンの操作がビューポートの制約を超えた場合に有用です。 以下にその例を示します： c v v o i i n e e ` s w w v t e e i r r e z . . w o v v e o i i r m e e ` L w w は e p p O v o o p e r r e l t t n . . S = z a e o p a 2 o p d . m l r 0 T y a ; o C g ( o o z n n o s の o t イ m r ン L a ス e i タ v n ン e t ス l s ) ( ; ) ; 上記のコードでは、まずビューポートのズームレベルを指定した値に設定します。その後、applyConstraintsメソッドを呼び出すことでビューポートがその制約を満たすように調整されます。つまり、もし指定したズームレベルが設定された制約を超えていた場合、ズームレベルはその制約に合うように調整されます。 ...

（以下、ChatGPTによる回答です。参考になりましたら幸いです。） OpenSeadragon(OSD)のfitBoundsとfitBoundsWithConstraintsの違いは、制約を適用するかどうかにあります。 OSDは高度なズーム機能とパニング機能を持つJavaScriptライブラリで、深くズーム可能な画像やコンテンツを扱う際に使われます。その中のfitBoundsとfitBoundsWithConstraintsは、ビューポート（表示領域）を特定の境界に合わせるメソッドです。 fitBounds(rectangle, immediately): ビューポートを指定した矩形に合わせます。immediatelyパラメータがtrueの場合、アニメーションなしで即座にビューポートをフィットさせます。falseの場合、アニメーションを伴ってビューポートをフィットさせます。 fitBoundsWithConstraints(rectangle, immediately): fitBoundsと同じ動作をしますが、ビューポートのズームとパンの制約を考慮します。つまり、指定した矩形にフィットさせる前に、最小ズームレベル、最大ズームレベル、画像のパン制約などを確認します。これにより、ユーザーが画像をズームやパンしても、設定した制約を超えることがありません。 つまり、主な違いはfitBoundsWithConstraintsがビューポートの制約を適用することで、その制約を超える動作を防ぎます。これは特に、ユーザーが画像をズームイン/ズームアウトしたり、画像をパン（スクロール）する際の振る舞いを制御するのに重要です。

概要 Omeka Classicでコレクションを一括削除する方法の一例を紹介します。Omeka Classic （Version 3.1.1）では、コレクションを複数選択して削除するGUIは提供されていません。アイテムについては、同機能が提供されています。 そこで、APIを用いてコレクションの一括削除を行います。 APIキーの取得 以下を参考に、APIの有効化とAPIキーの発行を行います。 https://omeka.org/classic/docs/Admin/Settings/API_Settings/ 具体的には、まず以下のページにアクセスします。 /admin/settings/edit-api そして、ユーザ毎のページにアクセスして、「API Keys」のタブを選択します。「New key label」からAPIキーを発行します。 /admin/users/api-keys/1 Pythonスクリプト 以下のようなPythonスクリプトにより、コレクションの一括削除を行うことができます。以下では、アイテム数が0のコレクションのみを削除するように設定しています。 i a e p } # u c f m p n a r o o p i d r コ l l r # i i o _ p a レ l t f r k o m " ク = e c コ e # r t e i s k シ c o レ m i e y n e ョ f t l ク s ア t u q r t = y ン " i l シ _ イ e r u e = " 一 { o e ョ c テ m l e q = { : 覧 e n c ン o ム s _ s u " の n s t に u 数 _ c t e < " a 取 d i 含 n が c o s s 取 h p 得 p = o ま t 0 o l . t 得 t i o n れ の u l d s し t _ i r る = 場 n e e た p k n e i ア 合 t c l A s e t q n イ c t e P : y } u テ o = i t I / / e c ム l = o e キ / c s o 数 l n ( ー e o t l を e 0 f > x l s l 取 c : = " " a l . e 得 t { m e g c i c u # p c e t o o r l t t i n l l 要 e i ( o [ l _ 変 . o u n " e c 更 o n r s i c o r s l : t t l g " , e i l / m o e o p s n c m a " [ t e r ] " i k a [ u o a m " r n / s c l } a = o " " p p u ] , i a n " r t p a " a # m ] r s a 要 ) m 変 . s 更 j = s p o a n r ( a ) m s ) まとめ Omeka Classicでコレクションを一括削除する際の参考になりましたら幸いです。 ...

概要 IIIF Mirador2のアノテーション画面の使い方（の一部）を説明します。 四角形アノテーションの作成 https://www.youtube.com/watch?v=jny09nLZvLU パス（多角形）アノテーションの作成 アノテーションを終了する場合には、ダブルクリックします。 https://www.youtube.com/watch?v=4cM-6-rXL9M 既存のアノテーションの修正 https://www.youtube.com/watch?v=HlE36inbgq4 既存のアノテーションの削除 https://www.youtube.com/watch?v=STk2vjLc_-k まとめ IIIF Mirador2を用いたアノテーション付与の際の参考になりましたら幸いです。

背景 ArchivematicaのAPIを用いて、TransferからAIPのダウンロードまでを行うことができましたので、メモします。 以前、ArchivematicaのAPI利用と、Storage ServiceのAPI利用をそれぞれ記事にしました。 今回は、上記を組み合わせて、TransferからAIPのダウンロードまでを行います。 方法 以下のノートブックに方法を記載しました。 https://colab.research.google.com/github/nakamura196/ndl_ocr/blob/main/ArchivematicaのAPIを使ってみる.ipynb まとめ ArchivematicaのAPI利用にあたり、参考になりましたら幸いです。 今後は、サーバへの処理対象ファイルのアップロードや、上記のAPIを使用したフロントエンドの開発にも取り組みたいと思います。

概要 Omeka Sでアイテムセット毎のページに表示されるアイテムのデフォルトソートを設定する方法について記載します。 具体的には、以下のような画面の初期ソートについてです。デフォルトでは「登録日」「降順」に設定されています。 以下、Omeka v4とv3で方法が異なりますので、それぞれについて説明します。 v4 以下のサイト毎の設定画面にアクセスします。 /admin/site/s/<URLスラッグ>#site-settings そして、以下の「Item browse defaults」で、フィールドと昇順・降順を設定します。 注意として、ここで設定したソートは、アイテムセットのページだけでなく、アイテムの一覧ページの初期ソートも変更されてしまいます。 そこで、以下のように、ナビゲーションのクエリ設定から、アイテム一覧については、別途デフォルトソートを設定することで、それぞれ異なるデフォルトソートを設定することができます。 /admin/site/s/<URLスラッグ>/navigation 他にも良い方法があるかもしれませんが、一つの方法として参考になりましたら幸いです。 v3 v3の場合、以下のモジュールを追加します。 https://github.com/Daniel-KM/Omeka-S-module-Next インストール後、サイト毎の設定画面に以下の項目が追加されます。 /admin/site/s/<URLスラッグ>#site-settings 以下のように説明があります。 Set order for item set, one by row, format “id,id,id property order”. Use “0” for the default. 例えば、0 dcterms:title ascと入力すると、アイテムセットにおけるアイテムのデフォルトソートがdcterms:titleに対する昇順になります。アイテムセット毎に設定を変更したい場合には、当該アイテムセットのIDを指定します。例75532 dcterms:title asc まとめ Omeka Sでアイテムセット毎のページに表示されるアイテムのデフォルトソートを設定する方法について記載しました。より良い方法があるかもしれませんが、一つの方法として参考になりましたら幸いです。

Strapi v4のGraphQLのソートやページネーションの方法を調べました。以下に記載がありました。 https://docs.strapi.io/dev-docs/api/graphql 具体的には、以下のような形で記述することで、ページネーションやソートを行うことができました。 q } u e b } r l y o m } d } g e a { P t p } t i a } o a a a d t s g t t c t { i o { r r s n t i e ( a a b a p t l u t a i t e g o e d i n s A n t a { { t i o n : { p a g e : 1 , p a g e S i z e : 1 0 } , s o r t : " c r e a t e d A t : d e s c " ) { 参考になりましたら幸いです。 ...

概要 DrupalでOpenAPIを有効にする機会がありましたので、その備忘録です。なお、以下のjson:apiモジュールを有効化済みです。 モジュールのインストール 以下の2つのモジュールをインストールします。 https://www.drupal.org/project/openapi https://www.drupal.org/project/openapi_jsonapi 結果、以下のURLで、jsonを取得することができます。 /openapi/jsonapi 以下にアクセスすると、「No UI …」と表示されます。次に、UIを追加してみます。 /admin/config/services/openapi UIの追加 以下の2つのモジュールをインストールします。 https://www.drupal.org/project/openapi_ui https://www.drupal.org/project/openapi_ui_redoc 結果、「Explore」のボタンが表示されます。 ボタンをクリックすると、以下の画面に遷移します。 /admin/config/services/openapi/redoc/jsonapi Swagger UIライクな画面が表示されます。 なお、Redocは、以下のように説明されていました。 Redoc is an open-source tool for generating documentation from OpenAPI (fka Swagger) definitions. https://github.com/Redocly/redoc 参考 以下の「Swagger UI for OpenAPI UI」についてもインストールしてみましたが、私の環境ではエラーが出てしまいました。 https://www.drupal.org/project/openapi_ui_swagger まとめ DrupalでOpenAPIを利用される際の参考になりましたら幸いです。

概要 Nuxt3でOpenSeadragonとOpenSeadragon SVG Overlayを使う例を作成しました。（鯰に御札を貼る要石）「国立国会図書館 所蔵」の画像を利用しています。 OpenSeadragon https://nuxt3-demo-nine.vercel.app/osd OpenSeadragon SVG Overlay https://nuxt3-demo-nine.vercel.app/osd-svg 方法 ポイントとして、以下のようなプラグインファイルを用意しました。これにより、SSR時に生じる不具合を解消できました。 https://github.com/nakamura196/nuxt3-demo/blob/main/plugins/osd.client.js またsvg overlayに関する記述は以下を参考にしました。 https://github.com/openseadragon/svg-overlay/blob/master/openseadragon-svg-overlay.js まとめ よりよい記述の方法があるかと思いますが、Nuxt3でのOpenSeadragonの利用にあたり、参考になりましたら幸いです。

DrupalをヘッドレスCMSとして使う機会があり、UIへのアクセスを管理者等に限定するDisable UIモジュールを試しました。 https://www.drupal.org/project/disable_ui 結果、トップページへのアクセス等は、以下のように表示されました。 一方、有効化したjson:apiなどについては、非ログインユーザもアクセスできました。 /jsonapi/ DrupalをヘッドレスCMSとして使用する際の参考になりましたら幸いです。

概要 さくらレンタルサーバにOmeka Sをインストールする際、imagemagickのパス指定が必要でした。 以下のように、設定ファイルを修正します。 < r ] ? e ; p t h u p r ' ] ' ] ' ] ' ] ' ] ' ] n l , h , c , t , t , s , o t l h r e [ g t i u a r g ' ' p ' ' ' ' m ' ] ' ] n ' v ' ] e l p _ s s p b t , t , s l i a , r o r c s s = h n y h l o c l ' g i l l l > p a p u a c e i ' o i c c c i e ' ' ' m ' t a _ a ' ' = r e a a [ l l s l m s b i o l m s O O > = i n p f i s ' a e q n m r e a e m m > t t a i _ ' r d u a a ' ' n s e e [ y ' t l p = g i a i g a ' k k f ' h e a = > e u r l e = = g a a a = ' ' t > ' m e e m > > e = \ \ l = > h [ ' ' r a r > F F s > = = ' [ = _ g [ ' ' i i e [ > > > = = o i e [ l l , \ = > > p c n = e e L n n > [ t k _ > \ \ a u u ' [ [ i _ U S T m l l n c ' ' o d S [ t h i l l u o c c n i ' o u n , , l n o o s r , r m a l s n n ' ' e b s , t s s ' n \ r t t = = a L a r r > > = i o i a a > l g n i i [ e \ t n n / ' r L ' t t u O ' o ' ' s m g = r e = g > = = / k > e > > l a r 8 o \ ' : 0 2 2 c F O : 0 0 0 a i m N ] 0 0 l l e O , ] ] / e k T , , b a I i S C n t F E ' o i , , r l e e # \ \ L T こ o h こ c u を a m 修 l b 正 ' n , a i l e r \ I m a g e M a g i c k ' ,

概要 StrapiとElasticsearchとの連携にあたり、以下の記事が参考になりました。 https://punits.dev/blog/integrating-elasticsearch-with-strapi/ ソースコードも公開されています。 https://github.com/geeky-biz/strapi-integrate-elasticsearch ここでは、上記の記事を参考にして、Amazon OpenSearchと連携するなど、一部カスタマイズした内容についてメモします。 カスタマイズしたソースコードは以下です。 https://github.com/nakamura196/strapi-integrate-opensearch 修正点 以下について、記事ではindexing_typeとなっていますが、indexing_request_typeとする必要がありました。 https://github.com/nakamura196/strapi-integrate-opensearch/blob/006c533d4d7882fc9779552db31a7b0e2ada5e57/elastic/cron-search-indexing.js#L16 またElasticsearchではなく、Amazon OpenSearchを使用するにあたり、以下のライブラリをインストールする必要があります。 n n p p m m i i n n s s t t a a l l l l @ @ o a p w e s n - s s e d a k r / c c h r - e p d r e o n j t e i c a t l / - o p p r e o n v s i e d a e r r c s h 認証の方法はいくつかあると思いますが、ここでは以下のように変更しました。 ...

概要 StrapiのREST APIの一部設定に関する備忘録です。 検索結果の上限を変更する 以下に記載がありました。 https://docs.strapi.io/dev-docs/api/rest/sort-pagination#pagination 具体的には、以下です。 The default and maximum values for pagination[limit] can be configured in the ./config/api.js file with the api.rest.defaultLimit and api.rest.maxLimit keys. m } o ; d r } u e , l s d m w e t e a i . : f x t e a L h x { u i C p l m o o t i u r L t n t i : t s m : i 1 = t 0 t : 0 r { 0 u 2 , e 5 , , 1 0 0 , STATEがDraftのものも含めて取得する デフォルトではSTATEがDraftのものは取得できませんでした。以下の記事が参考になりました。 ...

概要 IIIFマニフェストファイルからPDFファイルを作成する機会がありました。このソリューションとして、以下のリポジトリが見つかりましたが、うまく動かすことができませんでした。 https://github.com/jbaiter/pdiiif そこで、上記リポジトリはJavaScriptを使用していますが、今回はPythonを用いた変換ツールを作成しました。 使い方 以下のノートブックからお試しいただけます。 https://colab.research.google.com/github/nakamura196/ndl_ocr/blob/main/iiif2pdf.ipynb 初回インストール時に、img2pdfをインストールしますが、PILのバージョンの関係で、「RESTART RUNTIME」ボタンが表示されますので、クリックの上、再度同じセルを実行してください。 オプションとして、「IIIFマニフェストURLの指定」「画像が格納されているフォルダのパスの指定」「ローカルに存在するIIIFマニフェストファイルのパスの指定」の3種類を用意しています。 注意点として、2023年5月末時点では、IIIF Presentation API v2にのみ対応しています。v3へは今後の対応を検討しています。 まとめ IIIFからのPDFファイルの作成にあたり、参考になりましたら幸いです。

概要 Omeka SでIIIF画像をメディアとして登録する方法を紹介します。外部のIIIF画像サーバ等で公開されている画像をOmeka Sに登録します。 公式のマニュアルでは、以下に記載があります。 https://omeka.org/s/docs/user-manual/content/items/#media 具体的な方法 アイテムの編集画面のメディアの登録画面において、以下のような値を入力します。 /info.jsonで終わるURLを入力する必要があります。以下、国立国会図書館の校異源氏物語を例としています。 https://dl.ndl.go.jp/api/iiif/3437686/R0000001/info.json 結果、以下のように、OmekaからIIIF画像を利用できるようになります。 補足 Omeka S v4から外部のIIIFマニフェストファイルの取り込み機能も提供されています。 https://dl.ndl.go.jp/api/iiif/3437686/manifest.json まとめ IIIF画像の登録にあたり、末尾に/info.jsonを追加する点がポイントです。OmekaでIIIFを利用する際の参考になりましたら幸いです。

概要 Auth0 を使用して Strapi を認証する方法を試しました。以下の記事の通りに進めることで、実現することができました。 https://strapi.io/blog/auth0-provider-and-strapi-tutorial-1 ただし、Allowed Callback URLsを指定する箇所で、http://localhost:1337/connect/auth0/callbackとなっている箇所を、http://localhost:1337/api/connect/auth0/callbackに修正する必要がありました。 （参考）github 上記手順を参考に、githubをプロパイダーとして使用する方法もうまく設定できました。

graphqlモジュールで以下のエラーが発生しました。 The website encountered an unexpected error. Please try again later. TypeError: array_keys(): Argument #1 ($array) must be of type array, null given in array_keys() (line 40 of /bitnami/drupal/modules/contrib/graphql/graphql.install). そこで、以下の記事を参考に、ソースコードを修正しました。 https://www.drupal.org/project/google_tag/issues/3319621 具体的には、以下のように書き換えることで、エラーが解消しました。 $ n e $ g n o e t g i o a t t i i a o t n i o = n $ = l a $ n l g a u n a g g u e a T g y e p T e y s p - e > s g - e > t g ( e ' t n ( e ' g n o e t g i o a t t i i a o t n i ' o ) n ' ? ) ? ; [ ] ; 最新のバージョンでは修正されていると思いますが、同様のエラーでお困りの方の参考になりましたら幸いです。 ...