From f82020d3771c634c52f048beeb75ae28237ee407 Mon Sep 17 00:00:00 2001 From: github-bot-metro Date: Wed, 21 Feb 2024 20:01:34 +0000 Subject: [PATCH] Deployed 9ebdd72 to 1.3.0 with MkDocs 1.5.3 and mike 2.0.0 --- 1.3.0/404.html | 27 +- 1.3.0/AMIviaSpreadsheets/index.html | 27 +- 1.3.0/CODE_OF_CONDUCT/index.html | 27 +- 1.3.0/I7solrImporter/index.html | 27 +- 1.3.0/about/index.html | 27 +- 1.3.0/acknowledgments/index.html | 27 +- 1.3.0/ami_index/index.html | 27 +- 1.3.0/ami_lod_rec/index.html | 27 +- 1.3.0/ami_spreadsheet_overview/index.html | 27 +- 1.3.0/ami_update/index.html | 27 +- 1.3.0/annotations/index.html | 27 +- 1.3.0/archifilepersistencestrategy/index.html | 27 +- .../index.html | 27 +- .../index.html | 27 +- .../index.html | 27 +- .../index.html | 27 +- .../index.html | 27 +- .../index.html | 27 +- .../index.html | 27 +- .../index.html | 27 +- .../index.html | 27 +- 1.3.0/archipelago-deployment-osx/index.html | 27 +- .../archipelago-deployment-readme/index.html | 27 +- .../archipelago-deployment-ubuntu/index.html | 27 +- .../archipelago-deployment-windows/index.html | 27 +- .../assets/stylesheets/main.7e359304.min.css | 1 + .../stylesheets/main.7e359304.min.css.map | 1 + .../assets/stylesheets/main.f2e4d321.min.css | 1 - .../stylesheets/main.f2e4d321.min.css.map | 1 - 1.3.0/createdisplaymodes/index.html | 27 +- 1.3.0/customwebformelements/index.html | 71 +- 1.3.0/devops/index.html | 27 +- 1.3.0/documentation_about/index.html | 27 +- 1.3.0/documentation_features/index.html | 27 +- 1.3.0/documentation_technical/index.html | 27 +- 1.3.0/documentation_template/index.html | 27 +- 1.3.0/documentation_workflow/index.html | 27 +- 1.3.0/drupal_core_update/index.html | 27 +- 1.3.0/find_and_replace/index.html | 27 +- .../index.html | 27 +- 1.3.0/find_and_replace_action_text/index.html | 27 +- .../index.html | 27 +- 1.3.0/firstobject/index.html | 27 +- 1.3.0/fragaria/index.html | 27 +- 1.3.0/generalqa_minio_logging/index.html | 27 +- 1.3.0/generalqa_smtp_configuration/index.html | 27 +- .../index.html | 27 +- 1.3.0/giveortake/index.html | 27 +- 1.3.0/googleapi/index.html | 27 +- 1.3.0/images/DefaultArchipelagoWebforms.png | Bin 0 -> 315437 bytes 1.3.0/images/WebformAddElement.png | Bin 0 -> 34060 bytes 1.3.0/images/WebformLoDfromCSVaddElement.png | Bin 0 -> 101660 bytes 1.3.0/images/WebformLoDfromCSVadvancedTab.png | Bin 0 -> 110854 bytes .../WebformLoDfromCSVautocompleteSettings.png | Bin 0 -> 107758 bytes .../WebformLoDfromCSVgeneralSettings.png | Bin 0 -> 87271 bytes 1.3.0/images/WebformLoDfromCSVinAction.png | Bin 0 -> 51530 bytes 1.3.0/index.html | 27 +- 1.3.0/inthewild/index.html | 27 +- 1.3.0/metadata_display_preview/index.html | 27 +- 1.3.0/metadatainarchipelago/index.html | 27 +- 1.3.0/metadatatwigs/index.html | 27 +- .../index.html | 27 +- 1.3.0/ourtake/index.html | 27 +- 1.3.0/presentations_events/index.html | 27 +- 1.3.0/search-within-collection/index.html | 27 +- 1.3.0/search/search_index.json | 2 +- 1.3.0/search_advanced/index.html | 27 +- 1.3.0/search_solr_index/index.html | 27 +- 1.3.0/security_bots/index.html | 27 +- 1.3.0/sitemap.xml | 149 +- 1.3.0/sitemap.xml.gz | Bin 929 -> 941 bytes 1.3.0/sslsetup/index.html | 27 +- .../strawberry_key_name_providers/index.html | 27 +- 1.3.0/strawberryfield-formatters/index.html | 27 +- 1.3.0/strawberryfields/index.html | 27 +- 1.3.0/strawberryrunners/index.html | 27 +- 1.3.0/strawberryrunners_pager_ocr/index.html | 27 +- .../strawberryrunners_wacz_binary/index.html | 27 +- .../strawberryrunners_webpage_text/index.html | 27 +- 1.3.0/traditional-install/index.html | 27 +- 1.3.0/twig_extensions/index.html | 27 +- 1.3.0/twig_recipe_cards/index.html | 27 +- 1.3.0/utility_scripts/index.html | 27 +- 1.3.0/webformLoDfromCSV/index.html | 3008 +++++++++++++++++ 1.3.0/webforms/index.html | 93 +- 1.3.0/webformsasinput/index.html | 27 +- 1.3.0/workingtwigs/index.html | 27 +- 1.3.0/xdebug/index.html | 27 +- 88 files changed, 5005 insertions(+), 239 deletions(-) create mode 100644 1.3.0/assets/stylesheets/main.7e359304.min.css create mode 100644 1.3.0/assets/stylesheets/main.7e359304.min.css.map delete mode 100644 1.3.0/assets/stylesheets/main.f2e4d321.min.css delete mode 100644 1.3.0/assets/stylesheets/main.f2e4d321.min.css.map create mode 100644 1.3.0/images/DefaultArchipelagoWebforms.png create mode 100644 1.3.0/images/WebformAddElement.png create mode 100644 1.3.0/images/WebformLoDfromCSVaddElement.png create mode 100644 1.3.0/images/WebformLoDfromCSVadvancedTab.png create mode 100644 1.3.0/images/WebformLoDfromCSVautocompleteSettings.png create mode 100644 1.3.0/images/WebformLoDfromCSVgeneralSettings.png create mode 100644 1.3.0/images/WebformLoDfromCSVinAction.png create mode 100644 1.3.0/webformLoDfromCSV/index.html diff --git a/1.3.0/404.html b/1.3.0/404.html index a91f7392..f7165c42 100644 --- a/1.3.0/404.html +++ b/1.3.0/404.html @@ -16,7 +16,7 @@ - + @@ -24,7 +24,7 @@ - + @@ -1664,6 +1664,8 @@ + + @@ -1781,6 +1783,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/AMIviaSpreadsheets/index.html b/1.3.0/AMIviaSpreadsheets/index.html index ffe9d999..e0e78d69 100644 --- a/1.3.0/AMIviaSpreadsheets/index.html +++ b/1.3.0/AMIviaSpreadsheets/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1686,6 +1686,8 @@ + + @@ -1803,6 +1805,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/CODE_OF_CONDUCT/index.html b/1.3.0/CODE_OF_CONDUCT/index.html index 401e2be1..c3206125 100644 --- a/1.3.0/CODE_OF_CONDUCT/index.html +++ b/1.3.0/CODE_OF_CONDUCT/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1684,6 +1684,8 @@ + + @@ -1801,6 +1803,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/I7solrImporter/index.html b/1.3.0/I7solrImporter/index.html index 06658845..06bcfd51 100644 --- a/1.3.0/I7solrImporter/index.html +++ b/1.3.0/I7solrImporter/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1686,6 +1686,8 @@ + + @@ -1803,6 +1805,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/about/index.html b/1.3.0/about/index.html index b20b310a..22756e8e 100644 --- a/1.3.0/about/index.html +++ b/1.3.0/about/index.html @@ -18,7 +18,7 @@ - + @@ -26,7 +26,7 @@ - + @@ -1680,6 +1680,8 @@ + + @@ -1797,6 +1799,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/acknowledgments/index.html b/1.3.0/acknowledgments/index.html index cf81a8db..b2ed9314 100644 --- a/1.3.0/acknowledgments/index.html +++ b/1.3.0/acknowledgments/index.html @@ -20,7 +20,7 @@ - + @@ -28,7 +28,7 @@ - + @@ -1682,6 +1682,8 @@ + + @@ -1799,6 +1801,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/ami_index/index.html b/1.3.0/ami_index/index.html index 445505ee..302ccd91 100644 --- a/1.3.0/ami_index/index.html +++ b/1.3.0/ami_index/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1686,6 +1686,8 @@ + + @@ -1803,6 +1805,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/ami_lod_rec/index.html b/1.3.0/ami_lod_rec/index.html index 31304b7c..4342dbca 100644 --- a/1.3.0/ami_lod_rec/index.html +++ b/1.3.0/ami_lod_rec/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1686,6 +1686,8 @@ + + @@ -1803,6 +1805,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/ami_spreadsheet_overview/index.html b/1.3.0/ami_spreadsheet_overview/index.html index 6b2dce68..7de6a442 100644 --- a/1.3.0/ami_spreadsheet_overview/index.html +++ b/1.3.0/ami_spreadsheet_overview/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1686,6 +1686,8 @@ + + @@ -1803,6 +1805,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/ami_update/index.html b/1.3.0/ami_update/index.html index 57261235..adb55b23 100644 --- a/1.3.0/ami_update/index.html +++ b/1.3.0/ami_update/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1686,6 +1686,8 @@ + + @@ -1803,6 +1805,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/annotations/index.html b/1.3.0/annotations/index.html index 443f6023..120db885 100644 --- a/1.3.0/annotations/index.html +++ b/1.3.0/annotations/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1688,6 +1688,8 @@ + + @@ -1805,6 +1807,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archifilepersistencestrategy/index.html b/1.3.0/archifilepersistencestrategy/index.html index b8f10691..ce286fa1 100644 --- a/1.3.0/archifilepersistencestrategy/index.html +++ b/1.3.0/archifilepersistencestrategy/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1784,6 +1784,8 @@ + + @@ -1901,6 +1903,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-UpgradeDrupalD9toD10/index.html b/1.3.0/archipelago-deployment-UpgradeDrupalD9toD10/index.html index 0250ac2b..4269b242 100644 --- a/1.3.0/archipelago-deployment-UpgradeDrupalD9toD10/index.html +++ b/1.3.0/archipelago-deployment-UpgradeDrupalD9toD10/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1970,6 +1970,8 @@ + + @@ -2087,6 +2089,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-democontent/index.html b/1.3.0/archipelago-deployment-democontent/index.html index 77c65730..04ddf4c9 100644 --- a/1.3.0/archipelago-deployment-democontent/index.html +++ b/1.3.0/archipelago-deployment-democontent/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1829,6 +1829,8 @@ + + @@ -1946,6 +1948,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-live-UpgradeDrupalD9toD10/index.html b/1.3.0/archipelago-deployment-live-UpgradeDrupalD9toD10/index.html index 48f40c29..e7358172 100644 --- a/1.3.0/archipelago-deployment-live-UpgradeDrupalD9toD10/index.html +++ b/1.3.0/archipelago-deployment-live-UpgradeDrupalD9toD10/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1979,6 +1979,8 @@ + + @@ -2096,6 +2098,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-live-gitworkflow/index.html b/1.3.0/archipelago-deployment-live-gitworkflow/index.html index 76739b97..e65eae2d 100644 --- a/1.3.0/archipelago-deployment-live-gitworkflow/index.html +++ b/1.3.0/archipelago-deployment-live-gitworkflow/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1889,6 +1889,8 @@ + + @@ -2006,6 +2008,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-live-moveToLive/index.html b/1.3.0/archipelago-deployment-live-moveToLive/index.html index 501d0c04..f6f29c75 100644 --- a/1.3.0/archipelago-deployment-live-moveToLive/index.html +++ b/1.3.0/archipelago-deployment-live-moveToLive/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1949,6 +1949,8 @@ + + @@ -2066,6 +2068,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-live-readme/index.html b/1.3.0/archipelago-deployment-live-readme/index.html index c269194a..1a4761ec 100644 --- a/1.3.0/archipelago-deployment-live-readme/index.html +++ b/1.3.0/archipelago-deployment-live-readme/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -2033,6 +2033,8 @@ + + @@ -2150,6 +2152,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-live-updatingContainers/index.html b/1.3.0/archipelago-deployment-live-updatingContainers/index.html index 767e2f45..830ea6aa 100644 --- a/1.3.0/archipelago-deployment-live-updatingContainers/index.html +++ b/1.3.0/archipelago-deployment-live-updatingContainers/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1772,6 +1772,8 @@ + + @@ -1889,6 +1891,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-live-upgradeFromD8ToD9/index.html b/1.3.0/archipelago-deployment-live-upgradeFromD8ToD9/index.html index a9f67cdd..17c798ad 100644 --- a/1.3.0/archipelago-deployment-live-upgradeFromD8ToD9/index.html +++ b/1.3.0/archipelago-deployment-live-upgradeFromD8ToD9/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1925,6 +1925,8 @@ + + @@ -2042,6 +2044,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-live-upgradeFromRC3/index.html b/1.3.0/archipelago-deployment-live-upgradeFromRC3/index.html index 2020cb9f..5c7c5287 100644 --- a/1.3.0/archipelago-deployment-live-upgradeFromRC3/index.html +++ b/1.3.0/archipelago-deployment-live-upgradeFromRC3/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1916,6 +1916,8 @@ + + @@ -2033,6 +2035,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-osx/index.html b/1.3.0/archipelago-deployment-osx/index.html index caaa4c10..878b18f3 100644 --- a/1.3.0/archipelago-deployment-osx/index.html +++ b/1.3.0/archipelago-deployment-osx/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1859,6 +1859,8 @@ + + @@ -1976,6 +1978,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-readme/index.html b/1.3.0/archipelago-deployment-readme/index.html index 5351d424..85a0722e 100644 --- a/1.3.0/archipelago-deployment-readme/index.html +++ b/1.3.0/archipelago-deployment-readme/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1700,6 +1700,8 @@ + + @@ -1817,6 +1819,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-ubuntu/index.html b/1.3.0/archipelago-deployment-ubuntu/index.html index affcc53c..bca1020f 100644 --- a/1.3.0/archipelago-deployment-ubuntu/index.html +++ b/1.3.0/archipelago-deployment-ubuntu/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1883,6 +1883,8 @@ + + @@ -2000,6 +2002,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/archipelago-deployment-windows/index.html b/1.3.0/archipelago-deployment-windows/index.html index 3d872281..ecf7fc3e 100644 --- a/1.3.0/archipelago-deployment-windows/index.html +++ b/1.3.0/archipelago-deployment-windows/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1805,6 +1805,8 @@ + + @@ -1922,6 +1924,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/assets/stylesheets/main.7e359304.min.css b/1.3.0/assets/stylesheets/main.7e359304.min.css new file mode 100644 index 00000000..e5a7e3a7 --- /dev/null +++ b/1.3.0/assets/stylesheets/main.7e359304.min.css @@ -0,0 +1 @@ +@charset "UTF-8";html{-webkit-text-size-adjust:none;-moz-text-size-adjust:none;text-size-adjust:none;box-sizing:border-box}*,:after,:before{box-sizing:inherit}@media (prefers-reduced-motion){*,:after,:before{transition:none!important}}body{margin:0}a,button,input,label{-webkit-tap-highlight-color:transparent}a{color:inherit;text-decoration:none}hr{border:0;box-sizing:initial;display:block;height:.05rem;overflow:visible;padding:0}small{font-size:80%}sub,sup{line-height:1em}img{border-style:none}table{border-collapse:initial;border-spacing:0}td,th{font-weight:400;vertical-align:top}button{background:#0000;border:0;font-family:inherit;font-size:inherit;margin:0;padding:0}input{border:0;outline:none}:root{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-scheme=default]{color-scheme:light}[data-md-color-scheme=default] img[src$="#gh-dark-mode-only"],[data-md-color-scheme=default] img[src$="#only-dark"]{display:none}:root,[data-md-color-scheme=default]{--md-hue:225deg;--md-default-fg-color:#000000de;--md-default-fg-color--light:#0000008a;--md-default-fg-color--lighter:#00000052;--md-default-fg-color--lightest:#00000012;--md-default-bg-color:#fff;--md-default-bg-color--light:#ffffffb3;--md-default-bg-color--lighter:#ffffff4d;--md-default-bg-color--lightest:#ffffff1f;--md-code-fg-color:#36464e;--md-code-bg-color:#f5f5f5;--md-code-hl-color:#4287ff;--md-code-hl-color--light:#4287ff1a;--md-code-hl-number-color:#d52a2a;--md-code-hl-special-color:#db1457;--md-code-hl-function-color:#a846b9;--md-code-hl-constant-color:#6e59d9;--md-code-hl-keyword-color:#3f6ec6;--md-code-hl-string-color:#1c7d4d;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-del-color:#f5503d26;--md-typeset-ins-color:#0bd57026;--md-typeset-kbd-color:#fafafa;--md-typeset-kbd-accent-color:#fff;--md-typeset-kbd-border-color:#b8b8b8;--md-typeset-mark-color:#ffff0080;--md-typeset-table-color:#0000001f;--md-typeset-table-color--light:rgba(0,0,0,.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-warning-fg-color:#000000de;--md-warning-bg-color:#ff9;--md-footer-fg-color:#fff;--md-footer-fg-color--light:#ffffffb3;--md-footer-fg-color--lighter:#ffffff73;--md-footer-bg-color:#000000de;--md-footer-bg-color--dark:#00000052;--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #0000001a,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0003,0 0 0.05rem #00000059}.md-icon svg{fill:currentcolor;display:block;height:1.2rem;width:1.2rem}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;--md-text-font-family:var(--md-text-font,_),-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;--md-code-font-family:var(--md-code-font,_),SFMono-Regular,Consolas,Menlo,monospace}aside,body,input{font-feature-settings:"kern","liga";color:var(--md-typeset-color);font-family:var(--md-text-font-family)}code,kbd,pre{font-feature-settings:"kern";font-family:var(--md-code-font-family)}:root{--md-typeset-table-sort-icon:url('data:image/svg+xml;charset=utf-8,');--md-typeset-table-sort-icon--asc:url('data:image/svg+xml;charset=utf-8,');--md-typeset-table-sort-icon--desc:url('data:image/svg+xml;charset=utf-8,')}.md-typeset{-webkit-print-color-adjust:exact;color-adjust:exact;font-size:.8rem;line-height:1.6}@media print{.md-typeset{font-size:.68rem}}.md-typeset blockquote,.md-typeset dl,.md-typeset figure,.md-typeset ol,.md-typeset pre,.md-typeset ul{margin-bottom:1em;margin-top:1em}.md-typeset h1{color:var(--md-default-fg-color--light);font-size:2em;line-height:1.3;margin:0 0 1.25em}.md-typeset h1,.md-typeset h2{font-weight:300;letter-spacing:-.01em}.md-typeset h2{font-size:1.5625em;line-height:1.4;margin:1.6em 0 .64em}.md-typeset h3{font-size:1.25em;font-weight:400;letter-spacing:-.01em;line-height:1.5;margin:1.6em 0 .8em}.md-typeset h2+h3{margin-top:.8em}.md-typeset h4{font-weight:700;letter-spacing:-.01em;margin:1em 0}.md-typeset h5,.md-typeset h6{color:var(--md-default-fg-color--light);font-size:.8em;font-weight:700;letter-spacing:-.01em;margin:1.25em 0}.md-typeset h5{text-transform:uppercase}.md-typeset hr{border-bottom:.05rem solid var(--md-default-fg-color--lightest);display:flow-root;margin:1.5em 0}.md-typeset a{color:var(--md-typeset-a-color);word-break:break-word}.md-typeset a,.md-typeset a:before{transition:color 125ms}.md-typeset a:focus,.md-typeset a:hover{color:var(--md-accent-fg-color)}.md-typeset a:focus code,.md-typeset a:hover code{background-color:var(--md-accent-fg-color--transparent)}.md-typeset a code{color:currentcolor;transition:background-color 125ms}.md-typeset a.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset code,.md-typeset kbd,.md-typeset pre{color:var(--md-code-fg-color);direction:ltr;font-variant-ligatures:none}@media print{.md-typeset code,.md-typeset kbd,.md-typeset pre{white-space:pre-wrap}}.md-typeset code{background-color:var(--md-code-bg-color);border-radius:.1rem;-webkit-box-decoration-break:clone;box-decoration-break:clone;font-size:.85em;padding:0 .2941176471em;word-break:break-word}.md-typeset code:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-typeset pre{display:flow-root;line-height:1.4;position:relative}.md-typeset pre>code{-webkit-box-decoration-break:slice;box-decoration-break:slice;box-shadow:none;display:block;margin:0;outline-color:var(--md-accent-fg-color);overflow:auto;padding:.7720588235em 1.1764705882em;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin;touch-action:auto;word-break:normal}.md-typeset pre>code:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-typeset pre>code::-webkit-scrollbar{height:.2rem;width:.2rem}.md-typeset pre>code::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-typeset pre>code::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}.md-typeset kbd{background-color:var(--md-typeset-kbd-color);border-radius:.1rem;box-shadow:0 .1rem 0 .05rem var(--md-typeset-kbd-border-color),0 .1rem 0 var(--md-typeset-kbd-border-color),0 -.1rem .2rem var(--md-typeset-kbd-accent-color) inset;color:var(--md-default-fg-color);display:inline-block;font-size:.75em;padding:0 .6666666667em;vertical-align:text-top;word-break:break-word}.md-typeset mark{background-color:var(--md-typeset-mark-color);-webkit-box-decoration-break:clone;box-decoration-break:clone;color:inherit;word-break:break-word}.md-typeset abbr{border-bottom:.05rem dotted var(--md-default-fg-color--light);cursor:help;text-decoration:none}.md-typeset small{opacity:.75}[dir=ltr] .md-typeset sub,[dir=ltr] .md-typeset sup{margin-left:.078125em}[dir=rtl] .md-typeset sub,[dir=rtl] .md-typeset sup{margin-right:.078125em}[dir=ltr] .md-typeset blockquote{padding-left:.6rem}[dir=rtl] .md-typeset blockquote{padding-right:.6rem}[dir=ltr] .md-typeset blockquote{border-left:.2rem solid var(--md-default-fg-color--lighter)}[dir=rtl] .md-typeset blockquote{border-right:.2rem solid var(--md-default-fg-color--lighter)}.md-typeset blockquote{color:var(--md-default-fg-color--light);margin-left:0;margin-right:0}.md-typeset ul{list-style-type:disc}[dir=ltr] .md-typeset ol,[dir=ltr] .md-typeset ul{margin-left:.625em}[dir=rtl] .md-typeset ol,[dir=rtl] .md-typeset ul{margin-right:.625em}.md-typeset ol,.md-typeset ul{padding:0}.md-typeset ol:not([hidden]),.md-typeset ul:not([hidden]){display:flow-root}.md-typeset ol ol,.md-typeset ul ol{list-style-type:lower-alpha}.md-typeset ol ol ol,.md-typeset ul ol ol{list-style-type:lower-roman}[dir=ltr] .md-typeset ol li,[dir=ltr] .md-typeset ul li{margin-left:1.25em}[dir=rtl] .md-typeset ol li,[dir=rtl] .md-typeset ul li{margin-right:1.25em}.md-typeset ol li,.md-typeset ul li{margin-bottom:.5em}.md-typeset ol li blockquote,.md-typeset ol li p,.md-typeset ul li blockquote,.md-typeset ul li p{margin:.5em 0}.md-typeset ol li:last-child,.md-typeset ul li:last-child{margin-bottom:0}[dir=ltr] .md-typeset ol li ol,[dir=ltr] .md-typeset ol li ul,[dir=ltr] .md-typeset ul li ol,[dir=ltr] .md-typeset ul li ul{margin-left:.625em}[dir=rtl] .md-typeset ol li ol,[dir=rtl] .md-typeset ol li ul,[dir=rtl] .md-typeset ul li ol,[dir=rtl] .md-typeset ul li ul{margin-right:.625em}.md-typeset ol li ol,.md-typeset ol li ul,.md-typeset ul li ol,.md-typeset ul li ul{margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset dd{margin-left:1.875em}[dir=rtl] .md-typeset dd{margin-right:1.875em}.md-typeset dd{margin-bottom:1.5em;margin-top:1em}.md-typeset img,.md-typeset svg,.md-typeset video{height:auto;max-width:100%}.md-typeset img[align=left]{margin:1em 1em 1em 0}.md-typeset img[align=right]{margin:1em 0 1em 1em}.md-typeset img[align]:only-child{margin-top:0}.md-typeset figure{display:flow-root;margin:1em auto;max-width:100%;text-align:center;width:-webkit-fit-content;width:-moz-fit-content;width:fit-content}.md-typeset figure img{display:block;margin:0 auto}.md-typeset figcaption{font-style:italic;margin:1em auto;max-width:24rem}.md-typeset iframe{max-width:100%}.md-typeset table:not([class]){background-color:var(--md-default-bg-color);border:.05rem solid var(--md-typeset-table-color);border-radius:.1rem;display:inline-block;font-size:.64rem;max-width:100%;overflow:auto;touch-action:auto}@media print{.md-typeset table:not([class]){display:table}}.md-typeset table:not([class])+*{margin-top:1.5em}.md-typeset table:not([class]) td>:first-child,.md-typeset table:not([class]) th>:first-child{margin-top:0}.md-typeset table:not([class]) td>:last-child,.md-typeset table:not([class]) th>:last-child{margin-bottom:0}.md-typeset table:not([class]) td:not([align]),.md-typeset table:not([class]) th:not([align]){text-align:left}[dir=rtl] .md-typeset table:not([class]) td:not([align]),[dir=rtl] .md-typeset table:not([class]) th:not([align]){text-align:right}.md-typeset table:not([class]) th{font-weight:700;min-width:5rem;padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) td{border-top:.05rem solid var(--md-typeset-table-color);padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) tbody tr{transition:background-color 125ms}.md-typeset table:not([class]) tbody tr:hover{background-color:var(--md-typeset-table-color--light);box-shadow:0 .05rem 0 var(--md-default-bg-color) inset}.md-typeset table:not([class]) a{word-break:normal}.md-typeset table th[role=columnheader]{cursor:pointer}[dir=ltr] .md-typeset table th[role=columnheader]:after{margin-left:.5em}[dir=rtl] .md-typeset table th[role=columnheader]:after{margin-right:.5em}.md-typeset table th[role=columnheader]:after{content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-typeset-table-sort-icon);mask-image:var(--md-typeset-table-sort-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset table th[role=columnheader]:hover:after{background-color:var(--md-default-fg-color--lighter)}.md-typeset table th[role=columnheader][aria-sort=ascending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--asc);mask-image:var(--md-typeset-table-sort-icon--asc)}.md-typeset table th[role=columnheader][aria-sort=descending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--desc);mask-image:var(--md-typeset-table-sort-icon--desc)}.md-typeset__scrollwrap{margin:1em -.8rem;overflow-x:auto;touch-action:auto}.md-typeset__table{display:inline-block;margin-bottom:.5em;padding:0 .8rem}@media print{.md-typeset__table{display:block}}html .md-typeset__table table{display:table;margin:0;overflow:hidden;width:100%}@media screen and (max-width:44.984375em){.md-content__inner>pre{margin:1em -.8rem}.md-content__inner>pre code{border-radius:0}}.md-typeset .md-author{border-radius:100%;display:block;flex-shrink:0;height:1.6rem;overflow:hidden;position:relative;transition:color 125ms,transform 125ms;width:1.6rem}.md-typeset .md-author img{display:block}.md-typeset .md-author--more{background:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--lighter);font-size:.6rem;font-weight:700;line-height:1.6rem;text-align:center}.md-typeset .md-author--long{height:2.4rem;width:2.4rem}.md-typeset a.md-author{transform:scale(1)}.md-typeset a.md-author img{filter:grayscale(100%) opacity(75%);transition:filter 125ms}.md-typeset a.md-author:focus,.md-typeset a.md-author:hover{transform:scale(1.1);z-index:1}.md-typeset a.md-author:focus img,.md-typeset a.md-author:hover img{filter:grayscale(0)}.md-banner{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color);overflow:auto}@media print{.md-banner{display:none}}.md-banner--warning{background-color:var(--md-warning-bg-color);color:var(--md-warning-fg-color)}.md-banner__inner{font-size:.7rem;margin:.6rem auto;padding:0 .8rem}[dir=ltr] .md-banner__button{float:right}[dir=rtl] .md-banner__button{float:left}.md-banner__button{color:inherit;cursor:pointer;transition:opacity .25s}.no-js .md-banner__button{display:none}.md-banner__button:hover{opacity:.7}html{font-size:125%;height:100%;overflow-x:hidden}@media screen and (min-width:100em){html{font-size:137.5%}}@media screen and (min-width:125em){html{font-size:150%}}body{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;font-size:.5rem;min-height:100%;position:relative;width:100%}@media print{body{display:block}}@media screen and (max-width:59.984375em){body[data-md-scrolllock]{position:fixed}}.md-grid{margin-left:auto;margin-right:auto;max-width:61rem}.md-container{display:flex;flex-direction:column;flex-grow:1}@media print{.md-container{display:block}}.md-main{flex-grow:1}.md-main__inner{display:flex;height:100%;margin-top:1.5rem}.md-ellipsis{overflow:hidden;text-overflow:ellipsis}.md-toggle{display:none}.md-option{height:0;opacity:0;position:absolute;width:0}.md-option:checked+label:not([hidden]){display:block}.md-option.focus-visible+label{outline-color:var(--md-accent-fg-color);outline-style:auto}.md-skip{background-color:var(--md-default-fg-color);border-radius:.1rem;color:var(--md-default-bg-color);font-size:.64rem;margin:.5rem;opacity:0;outline-color:var(--md-accent-fg-color);padding:.3rem .5rem;position:fixed;transform:translateY(.4rem);z-index:-1}.md-skip:focus{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 175ms 75ms;z-index:10}@page{margin:25mm}:root{--md-clipboard-icon:url('data:image/svg+xml;charset=utf-8,')}.md-clipboard{border-radius:.1rem;color:var(--md-default-fg-color--lightest);cursor:pointer;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;position:absolute;right:.5em;top:.5em;transition:color .25s;width:1.5em;z-index:1}@media print{.md-clipboard{display:none}}.md-clipboard:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}:hover>.md-clipboard{color:var(--md-default-fg-color--light)}.md-clipboard:focus,.md-clipboard:hover{color:var(--md-accent-fg-color)}.md-clipboard:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-image:var(--md-clipboard-icon);mask-image:var(--md-clipboard-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-clipboard--inline{cursor:pointer}.md-clipboard--inline code{transition:color .25s,background-color .25s}.md-clipboard--inline:focus code,.md-clipboard--inline:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}@keyframes consent{0%{opacity:0;transform:translateY(100%)}to{opacity:1;transform:translateY(0)}}@keyframes overlay{0%{opacity:0}to{opacity:1}}.md-consent__overlay{animation:overlay .25s both;-webkit-backdrop-filter:blur(.1rem);backdrop-filter:blur(.1rem);background-color:#0000008a;height:100%;opacity:1;position:fixed;top:0;width:100%;z-index:5}.md-consent__inner{animation:consent .5s cubic-bezier(.1,.7,.1,1) both;background-color:var(--md-default-bg-color);border:0;border-radius:.1rem;bottom:0;box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;max-height:100%;overflow:auto;padding:0;position:fixed;width:100%;z-index:5}.md-consent__form{padding:.8rem}.md-consent__settings{display:none;margin:1em 0}input:checked+.md-consent__settings{display:block}.md-consent__controls{margin-bottom:.8rem}.md-typeset .md-consent__controls .md-button{display:inline}@media screen and (max-width:44.984375em){.md-typeset .md-consent__controls .md-button{display:block;margin-top:.4rem;text-align:center;width:100%}}.md-consent label{cursor:pointer}.md-content{flex-grow:1;min-width:0}.md-content__inner{margin:0 .8rem 1.2rem;padding-top:.6rem}@media screen and (min-width:76.25em){[dir=ltr] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}[dir=ltr] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner,[dir=rtl] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=rtl] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}}.md-content__inner:before{content:"";display:block;height:.4rem}.md-content__inner>:last-child{margin-bottom:0}[dir=ltr] .md-content__button{float:right}[dir=rtl] .md-content__button{float:left}[dir=ltr] .md-content__button{margin-left:.4rem}[dir=rtl] .md-content__button{margin-right:.4rem}.md-content__button{margin:.4rem 0;padding:0}@media print{.md-content__button{display:none}}.md-typeset .md-content__button{color:var(--md-default-fg-color--lighter)}.md-content__button svg{display:inline;vertical-align:top}[dir=rtl] .md-content__button svg{transform:scaleX(-1)}[dir=ltr] .md-dialog{right:.8rem}[dir=rtl] .md-dialog{left:.8rem}.md-dialog{background-color:var(--md-default-fg-color);border-radius:.1rem;bottom:.8rem;box-shadow:var(--md-shadow-z3);min-width:11.1rem;opacity:0;padding:.4rem .6rem;pointer-events:none;position:fixed;transform:translateY(100%);transition:transform 0ms .4s,opacity .4s;z-index:4}@media print{.md-dialog{display:none}}.md-dialog--active{opacity:1;pointer-events:auto;transform:translateY(0);transition:transform .4s cubic-bezier(.075,.85,.175,1),opacity .4s}.md-dialog__inner{color:var(--md-default-bg-color);font-size:.7rem}.md-feedback{margin:2em 0 1em;text-align:center}.md-feedback fieldset{border:none;margin:0;padding:0}.md-feedback__title{font-weight:700;margin:1em auto}.md-feedback__inner{position:relative}.md-feedback__list{display:flex;flex-wrap:wrap;place-content:baseline center;position:relative}.md-feedback__list:hover .md-icon:not(:disabled){color:var(--md-default-fg-color--lighter)}:disabled .md-feedback__list{min-height:1.8rem}.md-feedback__icon{color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;margin:0 .1rem;transition:color 125ms}.md-feedback__icon:not(:disabled).md-icon:hover{color:var(--md-accent-fg-color)}.md-feedback__icon:disabled{color:var(--md-default-fg-color--lightest);pointer-events:none}.md-feedback__note{opacity:0;position:relative;transform:translateY(.4rem);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-feedback__note>*{margin:0 auto;max-width:16rem}:disabled .md-feedback__note{opacity:1;transform:translateY(0)}.md-footer{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color)}@media print{.md-footer{display:none}}.md-footer__inner{justify-content:space-between;overflow:auto;padding:.2rem}.md-footer__inner:not([hidden]){display:flex}.md-footer__link{align-items:end;display:flex;flex-grow:0.01;margin-bottom:.4rem;margin-top:1rem;max-width:100%;outline-color:var(--md-accent-fg-color);overflow:hidden;transition:opacity .25s}.md-footer__link:focus,.md-footer__link:hover{opacity:.7}[dir=rtl] .md-footer__link svg{transform:scaleX(-1)}@media screen and (max-width:44.984375em){.md-footer__link--prev{flex-shrink:0}.md-footer__link--prev .md-footer__title{display:none}}[dir=ltr] .md-footer__link--next{margin-left:auto}[dir=rtl] .md-footer__link--next{margin-right:auto}.md-footer__link--next{text-align:right}[dir=rtl] .md-footer__link--next{text-align:left}.md-footer__title{flex-grow:1;font-size:.9rem;margin-bottom:.7rem;max-width:calc(100% - 2.4rem);padding:0 1rem;white-space:nowrap}.md-footer__button{margin:.2rem;padding:.4rem}.md-footer__direction{font-size:.64rem;opacity:.7}.md-footer-meta{background-color:var(--md-footer-bg-color--dark)}.md-footer-meta__inner{display:flex;flex-wrap:wrap;justify-content:space-between;padding:.2rem}html .md-footer-meta.md-typeset a{color:var(--md-footer-fg-color--light)}html .md-footer-meta.md-typeset a:focus,html .md-footer-meta.md-typeset a:hover{color:var(--md-footer-fg-color)}.md-copyright{color:var(--md-footer-fg-color--lighter);font-size:.64rem;margin:auto .6rem;padding:.4rem 0;width:100%}@media screen and (min-width:45em){.md-copyright{width:auto}}.md-copyright__highlight{color:var(--md-footer-fg-color--light)}.md-social{display:inline-flex;gap:.2rem;margin:0 .4rem;padding:.2rem 0 .6rem}@media screen and (min-width:45em){.md-social{padding:.6rem 0}}.md-social__link{display:inline-block;height:1.6rem;text-align:center;width:1.6rem}.md-social__link:before{line-height:1.9}.md-social__link svg{fill:currentcolor;max-height:.8rem;vertical-align:-25%}.md-typeset .md-button{border:.1rem solid;border-radius:.1rem;color:var(--md-primary-fg-color);cursor:pointer;display:inline-block;font-weight:700;padding:.625em 2em;transition:color 125ms,background-color 125ms,border-color 125ms}.md-typeset .md-button--primary{background-color:var(--md-primary-fg-color);border-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color)}.md-typeset .md-button:focus,.md-typeset .md-button:hover{background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[dir=ltr] .md-typeset .md-input{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .md-input,[dir=rtl] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-left-radius:.1rem}.md-typeset .md-input{border-bottom:.1rem solid var(--md-default-fg-color--lighter);box-shadow:var(--md-shadow-z1);font-size:.8rem;height:1.8rem;padding:0 .6rem;transition:border .25s,box-shadow .25s}.md-typeset .md-input:focus,.md-typeset .md-input:hover{border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input--stretch{width:100%}.md-header{background-color:var(--md-primary-fg-color);box-shadow:0 0 .2rem #0000,0 .2rem .4rem #0000;color:var(--md-primary-bg-color);display:block;left:0;position:sticky;right:0;top:0;z-index:4}@media print{.md-header{display:none}}.md-header[hidden]{transform:translateY(-100%);transition:transform .25s cubic-bezier(.8,0,.6,1),box-shadow .25s}.md-header--shadow{box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;transition:transform .25s cubic-bezier(.1,.7,.1,1),box-shadow .25s}.md-header__inner{align-items:center;display:flex;padding:0 .2rem}.md-header__button{color:currentcolor;cursor:pointer;margin:.2rem;outline-color:var(--md-accent-fg-color);padding:.4rem;position:relative;transition:opacity .25s;vertical-align:middle;z-index:1}.md-header__button:hover{opacity:.7}.md-header__button:not([hidden]){display:inline-block}.md-header__button:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-header__button.md-logo{margin:.2rem;padding:.4rem}@media screen and (max-width:76.234375em){.md-header__button.md-logo{display:none}}.md-header__button.md-logo img,.md-header__button.md-logo svg{fill:currentcolor;display:block;height:1.2rem;width:auto}@media screen and (min-width:60em){.md-header__button[for=__search]{display:none}}.no-js .md-header__button[for=__search]{display:none}[dir=rtl] .md-header__button[for=__search] svg{transform:scaleX(-1)}@media screen and (min-width:76.25em){.md-header__button[for=__drawer]{display:none}}.md-header__topic{display:flex;max-width:100%;position:absolute;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;white-space:nowrap}.md-header__topic+.md-header__topic{opacity:0;pointer-events:none;transform:translateX(1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__topic+.md-header__topic{transform:translateX(-1.25rem)}.md-header__topic:first-child{font-weight:700}[dir=ltr] .md-header__title{margin-left:1rem;margin-right:.4rem}[dir=rtl] .md-header__title{margin-left:.4rem;margin-right:1rem}.md-header__title{flex-grow:1;font-size:.9rem;height:2.4rem;line-height:2.4rem}.md-header__title--active .md-header__topic{opacity:0;pointer-events:none;transform:translateX(-1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__title--active .md-header__topic{transform:translateX(1.25rem)}.md-header__title--active .md-header__topic+.md-header__topic{opacity:1;pointer-events:auto;transform:translateX(0);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;z-index:0}.md-header__title>.md-header__ellipsis{height:100%;position:relative;width:100%}.md-header__option{display:flex;flex-shrink:0;max-width:100%;transition:max-width 0ms .25s,opacity .25s .25s;white-space:nowrap}[data-md-toggle=search]:checked~.md-header .md-header__option{max-width:0;opacity:0;transition:max-width 0ms,opacity 0ms}.md-header__option>input{bottom:0}.md-header__source{display:none}@media screen and (min-width:60em){[dir=ltr] .md-header__source{margin-left:1rem}[dir=rtl] .md-header__source{margin-right:1rem}.md-header__source{display:block;max-width:11.7rem;width:11.7rem}}@media screen and (min-width:76.25em){[dir=ltr] .md-header__source{margin-left:1.4rem}[dir=rtl] .md-header__source{margin-right:1.4rem}}.md-meta{color:var(--md-default-fg-color--light);font-size:.7rem;line-height:1.3}.md-meta__list{display:inline-flex;flex-wrap:wrap;list-style:none;margin:0;padding:0}.md-meta__item:not(:last-child):after{content:"·";margin-left:.2rem;margin-right:.2rem}.md-meta__link{color:var(--md-typeset-a-color)}.md-meta__link:focus,.md-meta__link:hover{color:var(--md-accent-fg-color)}.md-draft{background-color:#ff1744;border-radius:.125em;color:#fff;display:inline-block;font-weight:700;padding-left:.5714285714em;padding-right:.5714285714em}:root{--md-nav-icon--prev:url('data:image/svg+xml;charset=utf-8,');--md-nav-icon--next:url('data:image/svg+xml;charset=utf-8,');--md-toc-icon:url('data:image/svg+xml;charset=utf-8,')}.md-nav{font-size:.7rem;line-height:1.3}.md-nav__title{color:var(--md-default-fg-color--light);display:block;font-weight:700;overflow:hidden;padding:0 .6rem;text-overflow:ellipsis}.md-nav__title .md-nav__button{display:none}.md-nav__title .md-nav__button img{height:100%;width:auto}.md-nav__title .md-nav__button.md-logo img,.md-nav__title .md-nav__button.md-logo svg{fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__list{list-style:none;margin:0;padding:0}.md-nav__link{align-items:flex-start;display:flex;gap:.4rem;margin-top:.625em;scroll-snap-align:start;transition:color 125ms}.md-nav__link--passed{color:var(--md-default-fg-color--light)}.md-nav__item .md-nav__link--active,.md-nav__item .md-nav__link--active code{color:var(--md-typeset-a-color)}.md-nav__link .md-ellipsis{position:relative}[dir=ltr] .md-nav__link .md-icon:last-child{margin-left:auto}[dir=rtl] .md-nav__link .md-icon:last-child{margin-right:auto}.md-nav__link svg{fill:currentcolor;flex-shrink:0;height:1.3em}.md-nav__link[for]:focus,.md-nav__link[for]:hover,.md-nav__link[href]:focus,.md-nav__link[href]:hover{color:var(--md-accent-fg-color);cursor:pointer}.md-nav__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-nav--primary .md-nav__link[for=__toc]{display:none}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{background-color:currentcolor;display:block;height:100%;-webkit-mask-image:var(--md-toc-icon);mask-image:var(--md-toc-icon);width:100%}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:none}.md-nav__container>.md-nav__link{margin-top:0}.md-nav__container>.md-nav__link:first-child{flex-grow:1;min-width:0}.md-nav__icon{flex-shrink:0}.md-nav__source{display:none}@media screen and (max-width:76.234375em){.md-nav--primary,.md-nav--primary .md-nav{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;height:100%;left:0;position:absolute;right:0;top:0;z-index:1}.md-nav--primary .md-nav__item,.md-nav--primary .md-nav__title{font-size:.8rem;line-height:1.5}.md-nav--primary .md-nav__title{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);cursor:pointer;height:5.6rem;line-height:2.4rem;padding:3rem .8rem .2rem;position:relative;white-space:nowrap}[dir=ltr] .md-nav--primary .md-nav__title .md-nav__icon{left:.4rem}[dir=rtl] .md-nav--primary .md-nav__title .md-nav__icon{right:.4rem}.md-nav--primary .md-nav__title .md-nav__icon{display:block;height:1.2rem;margin:.2rem;position:absolute;top:.4rem;width:1.2rem}.md-nav--primary .md-nav__title .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--prev);mask-image:var(--md-nav-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}.md-nav--primary .md-nav__title~.md-nav__list{background-color:var(--md-default-bg-color);box-shadow:0 .05rem 0 var(--md-default-fg-color--lightest) inset;overflow-y:auto;scroll-snap-type:y mandatory;touch-action:pan-y}.md-nav--primary .md-nav__title~.md-nav__list>:first-child{border-top:0}.md-nav--primary .md-nav__title[for=__drawer]{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);font-weight:700}.md-nav--primary .md-nav__title .md-logo{display:block;left:.2rem;margin:.2rem;padding:.4rem;position:absolute;right:.2rem;top:.2rem}.md-nav--primary .md-nav__list{flex:1}.md-nav--primary .md-nav__item{border-top:.05rem solid var(--md-default-fg-color--lightest)}.md-nav--primary .md-nav__item--active>.md-nav__link{color:var(--md-typeset-a-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:focus,.md-nav--primary .md-nav__item--active>.md-nav__link:hover{color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__link{margin-top:0;padding:.6rem .8rem}.md-nav--primary .md-nav__link svg{margin-top:.1em}.md-nav--primary .md-nav__link>.md-nav__link{padding:0}[dir=ltr] .md-nav--primary .md-nav__link .md-nav__icon{margin-right:-.2rem}[dir=rtl] .md-nav--primary .md-nav__link .md-nav__icon{margin-left:-.2rem}.md-nav--primary .md-nav__link .md-nav__icon{font-size:1.2rem;height:1.2rem;width:1.2rem}.md-nav--primary .md-nav__link .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-nav--primary .md-nav__icon:after{transform:scale(-1)}.md-nav--primary .md-nav--secondary .md-nav{background-color:initial;position:static}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-left:1.4rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-right:1.4rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-left:2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-right:2rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-left:2.6rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-right:2.6rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-left:3.2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-right:3.2rem}.md-nav--secondary{background-color:initial}.md-nav__toggle~.md-nav{display:flex;opacity:0;transform:translateX(100%);transition:transform .25s cubic-bezier(.8,0,.6,1),opacity 125ms 50ms}[dir=rtl] .md-nav__toggle~.md-nav{transform:translateX(-100%)}.md-nav__toggle:checked~.md-nav{opacity:1;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 125ms 125ms}.md-nav__toggle:checked~.md-nav>.md-nav__list{-webkit-backface-visibility:hidden;backface-visibility:hidden}}@media screen and (max-width:59.984375em){.md-nav--primary .md-nav__link[for=__toc]{display:flex}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--primary .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:flex}.md-nav__source{background-color:var(--md-primary-fg-color--dark);color:var(--md-primary-bg-color);display:block;padding:0 .2rem}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-nav--integrated .md-nav__link[for=__toc]{display:flex}.md-nav--integrated .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--integrated .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--integrated .md-nav__link[for=__toc]~.md-nav{display:flex}}@media screen and (min-width:60em){.md-nav{margin-bottom:-.4rem}.md-nav--secondary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--secondary .md-nav__title[for=__toc]{scroll-snap-align:start}.md-nav--secondary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--secondary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--secondary .md-nav__list{padding-right:.6rem}.md-nav--secondary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--secondary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--secondary .md-nav__item>.md-nav__link{margin-left:.4rem}}@media screen and (min-width:76.25em){.md-nav{margin-bottom:-.4rem;transition:max-height .25s cubic-bezier(.86,0,.07,1)}.md-nav--primary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--primary .md-nav__title[for=__drawer]{scroll-snap-align:start}.md-nav--primary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--primary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--primary .md-nav__list{padding-right:.6rem}.md-nav--primary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--primary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--primary .md-nav__item>.md-nav__link{margin-left:.4rem}.md-nav__toggle~.md-nav{display:grid;grid-template-rows:0fr;opacity:0;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .25s,visibility 0ms .25s;visibility:collapse}.md-nav__toggle~.md-nav>.md-nav__list{overflow:hidden}.md-nav__toggle.md-toggle--indeterminate~.md-nav,.md-nav__toggle:checked~.md-nav{grid-template-rows:1fr;opacity:1;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .15s .1s,visibility 0ms;visibility:visible}.md-nav__toggle.md-toggle--indeterminate~.md-nav{transition:none}.md-nav__item--nested>.md-nav>.md-nav__title{display:none}.md-nav__item--section{display:block;margin:1.25em 0}.md-nav__item--section:last-child{margin-bottom:0}.md-nav__item--section>.md-nav__link{font-weight:700}.md-nav__item--section>.md-nav__link[for]{color:var(--md-default-fg-color--light)}.md-nav__item--section>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav__item--section>.md-nav__link .md-icon,.md-nav__item--section>.md-nav__link>[for]{display:none}[dir=ltr] .md-nav__item--section>.md-nav{margin-left:-.6rem}[dir=rtl] .md-nav__item--section>.md-nav{margin-right:-.6rem}.md-nav__item--section>.md-nav{display:block;opacity:1;visibility:visible}.md-nav__item--section>.md-nav>.md-nav__list>.md-nav__item{padding:0}.md-nav__icon{border-radius:100%;height:.9rem;transition:background-color .25s;width:.9rem}.md-nav__icon:hover{background-color:var(--md-accent-fg-color--transparent)}.md-nav__icon:after{background-color:currentcolor;border-radius:100%;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:transform .25s;vertical-align:-.1rem;width:100%}[dir=rtl] .md-nav__icon:after{transform:rotate(180deg)}.md-nav__item--nested .md-nav__toggle:checked~.md-nav__link .md-nav__icon:after,.md-nav__item--nested .md-toggle--indeterminate~.md-nav__link .md-nav__icon:after{transform:rotate(90deg)}.md-nav--lifted>.md-nav__list>.md-nav__item,.md-nav--lifted>.md-nav__title{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active{display:block}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);margin-top:0;position:sticky;top:0;z-index:1}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active.md-nav__item--section{margin:0}[dir=ltr] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-left:-.6rem}[dir=rtl] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-right:-.6rem}.md-nav--lifted>.md-nav__list>.md-nav__item>[for]{color:var(--md-default-fg-color--light)}.md-nav--lifted .md-nav[data-md-level="1"]{grid-template-rows:1fr;opacity:1;visibility:visible}[dir=ltr] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-left:.05rem solid var(--md-primary-fg-color)}[dir=rtl] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-right:.05rem solid var(--md-primary-fg-color)}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{display:block;margin-bottom:1.25em;opacity:1;visibility:visible}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__list{overflow:visible;padding-bottom:0}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__title{display:none}}.md-pagination{font-size:.8rem;font-weight:700;gap:.4rem}.md-pagination,.md-pagination>*{align-items:center;display:flex;justify-content:center}.md-pagination>*{border-radius:.2rem;height:1.8rem;min-width:1.8rem;text-align:center}.md-pagination__current{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light)}.md-pagination__link{transition:color 125ms,background-color 125ms}.md-pagination__link:focus,.md-pagination__link:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-pagination__link:focus svg,.md-pagination__link:hover svg{color:var(--md-accent-fg-color)}.md-pagination__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-pagination__link svg{fill:currentcolor;color:var(--md-default-fg-color--lighter);display:block;max-height:100%;width:1.2rem}.md-post__back{border-bottom:.05rem solid var(--md-default-fg-color--lightest);margin-bottom:1.2rem;padding-bottom:1.2rem}@media screen and (max-width:76.234375em){.md-post__back{display:none}}[dir=rtl] .md-post__back svg{transform:scaleX(-1)}.md-post__authors{display:flex;flex-direction:column;gap:.6rem;margin:0 .6rem 1.2rem}.md-post .md-post__meta a{transition:color 125ms}.md-post .md-post__meta a:focus,.md-post .md-post__meta a:hover{color:var(--md-accent-fg-color)}.md-post__title{color:var(--md-default-fg-color--light);font-weight:700}.md-post--excerpt{margin-bottom:3.2rem}.md-post--excerpt .md-post__header{align-items:center;display:flex;gap:.6rem;min-height:1.6rem}.md-post--excerpt .md-post__authors{align-items:center;display:inline-flex;flex-direction:row;gap:.2rem;margin:0;min-height:2.4rem}[dir=ltr] .md-post--excerpt .md-post__meta .md-meta__list{margin-right:.4rem}[dir=rtl] .md-post--excerpt .md-post__meta .md-meta__list{margin-left:.4rem}.md-post--excerpt .md-post__content>:first-child{--md-scroll-margin:6rem;margin-top:0}.md-post>.md-nav--secondary{margin:1em 0}.md-profile{align-items:center;display:flex;font-size:.7rem;gap:.6rem;line-height:1.4;width:100%}.md-profile__description{flex-grow:1}.md-content--post{display:flex}@media screen and (max-width:76.234375em){.md-content--post{flex-flow:column-reverse}}.md-content--post>.md-content__inner{min-width:0}@media screen and (min-width:76.25em){[dir=ltr] .md-content--post>.md-content__inner{margin-left:1.2rem}[dir=rtl] .md-content--post>.md-content__inner{margin-right:1.2rem}}@media screen and (max-width:76.234375em){.md-sidebar.md-sidebar--post{padding:0;position:static;width:100%}.md-sidebar.md-sidebar--post .md-sidebar__scrollwrap{overflow:visible}.md-sidebar.md-sidebar--post .md-sidebar__inner{padding:0}.md-sidebar.md-sidebar--post .md-post__meta{margin-left:.6rem;margin-right:.6rem}.md-sidebar.md-sidebar--post .md-nav__item{border:none;display:inline}.md-sidebar.md-sidebar--post .md-nav__list{display:inline-flex;flex-wrap:wrap;gap:.6rem;padding-bottom:.6rem;padding-top:.6rem}.md-sidebar.md-sidebar--post .md-nav__link{padding:0}.md-sidebar.md-sidebar--post .md-nav{height:auto;margin-bottom:0;position:static}}:root{--md-progress-value:0;--md-progress-delay:400ms}.md-progress{background:var(--md-primary-bg-color);height:.075rem;opacity:min(clamp(0,var(--md-progress-value),1),clamp(0,100 - var(--md-progress-value),1));position:fixed;top:0;transform:scaleX(calc(var(--md-progress-value)*1%));transform-origin:left;transition:transform .5s cubic-bezier(.19,1,.22,1),opacity .25s var(--md-progress-delay);width:100%;z-index:4}:root{--md-search-result-icon:url('data:image/svg+xml;charset=utf-8,')}.md-search{position:relative}@media screen and (min-width:60em){.md-search{padding:.2rem 0}}.no-js .md-search{display:none}.md-search__overlay{opacity:0;z-index:1}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__overlay{left:-2.2rem}[dir=rtl] .md-search__overlay{right:-2.2rem}.md-search__overlay{background-color:var(--md-default-bg-color);border-radius:1rem;height:2rem;overflow:hidden;pointer-events:none;position:absolute;top:-1rem;transform-origin:center;transition:transform .3s .1s,opacity .2s .2s;width:2rem}[data-md-toggle=search]:checked~.md-header .md-search__overlay{opacity:1;transition:transform .4s,opacity .1s}}@media screen and (min-width:60em){[dir=ltr] .md-search__overlay{left:0}[dir=rtl] .md-search__overlay{right:0}.md-search__overlay{background-color:#0000008a;cursor:pointer;height:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0}[data-md-toggle=search]:checked~.md-header .md-search__overlay{height:200vh;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@media screen and (max-width:29.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(45)}}@media screen and (min-width:30em) and (max-width:44.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(60)}}@media screen and (min-width:45em) and (max-width:59.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(75)}}.md-search__inner{-webkit-backface-visibility:hidden;backface-visibility:hidden}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__inner{left:0}[dir=rtl] .md-search__inner{right:0}.md-search__inner{height:0;opacity:0;overflow:hidden;position:fixed;top:0;transform:translateX(5%);transition:width 0ms .3s,height 0ms .3s,transform .15s cubic-bezier(.4,0,.2,1) .15s,opacity .15s .15s;width:0;z-index:2}[dir=rtl] .md-search__inner{transform:translateX(-5%)}[data-md-toggle=search]:checked~.md-header .md-search__inner{height:100%;opacity:1;transform:translateX(0);transition:width 0ms 0ms,height 0ms 0ms,transform .15s cubic-bezier(.1,.7,.1,1) .15s,opacity .15s .15s;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__inner{float:right}[dir=rtl] .md-search__inner{float:left}.md-search__inner{padding:.1rem 0;position:relative;transition:width .25s cubic-bezier(.1,.7,.1,1);width:11.7rem}}@media screen and (min-width:60em) and (max-width:76.234375em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:23.4rem}}@media screen and (min-width:76.25em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:34.4rem}}.md-search__form{background-color:var(--md-default-bg-color);box-shadow:0 0 .6rem #0000;height:2.4rem;position:relative;transition:color .25s,background-color .25s;z-index:2}@media screen and (min-width:60em){.md-search__form{background-color:#00000042;border-radius:.1rem;height:1.8rem}.md-search__form:hover{background-color:#ffffff1f}}[data-md-toggle=search]:checked~.md-header .md-search__form{background-color:var(--md-default-bg-color);border-radius:.1rem .1rem 0 0;box-shadow:0 0 .6rem #00000012;color:var(--md-default-fg-color)}[dir=ltr] .md-search__input{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__input{padding-left:2.2rem;padding-right:3.6rem}.md-search__input{background:#0000;font-size:.9rem;height:100%;position:relative;text-overflow:ellipsis;width:100%;z-index:2}.md-search__input::placeholder{transition:color .25s}.md-search__input::placeholder,.md-search__input~.md-search__icon{color:var(--md-default-fg-color--light)}.md-search__input::-ms-clear{display:none}@media screen and (max-width:59.984375em){.md-search__input{font-size:.9rem;height:2.4rem;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__input{padding-left:2.2rem}[dir=rtl] .md-search__input{padding-right:2.2rem}.md-search__input{color:inherit;font-size:.8rem}.md-search__input::placeholder{color:var(--md-primary-bg-color--light)}.md-search__input+.md-search__icon{color:var(--md-primary-bg-color)}[data-md-toggle=search]:checked~.md-header .md-search__input{text-overflow:clip}[data-md-toggle=search]:checked~.md-header .md-search__input+.md-search__icon{color:var(--md-default-fg-color--light)}[data-md-toggle=search]:checked~.md-header .md-search__input::placeholder{color:#0000}}.md-search__icon{cursor:pointer;display:inline-block;height:1.2rem;transition:color .25s,opacity .25s;width:1.2rem}.md-search__icon:hover{opacity:.7}[dir=ltr] .md-search__icon[for=__search]{left:.5rem}[dir=rtl] .md-search__icon[for=__search]{right:.5rem}.md-search__icon[for=__search]{position:absolute;top:.3rem;z-index:2}[dir=rtl] .md-search__icon[for=__search] svg{transform:scaleX(-1)}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__icon[for=__search]{left:.8rem}[dir=rtl] .md-search__icon[for=__search]{right:.8rem}.md-search__icon[for=__search]{top:.6rem}.md-search__icon[for=__search] svg:first-child{display:none}}@media screen and (min-width:60em){.md-search__icon[for=__search]{pointer-events:none}.md-search__icon[for=__search] svg:last-child{display:none}}[dir=ltr] .md-search__options{right:.5rem}[dir=rtl] .md-search__options{left:.5rem}.md-search__options{pointer-events:none;position:absolute;top:.3rem;z-index:2}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__options{right:.8rem}[dir=rtl] .md-search__options{left:.8rem}.md-search__options{top:.6rem}}[dir=ltr] .md-search__options>.md-icon{margin-left:.2rem}[dir=rtl] .md-search__options>.md-icon{margin-right:.2rem}.md-search__options>.md-icon{color:var(--md-default-fg-color--light);opacity:0;transform:scale(.75);transition:transform .15s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-search__options>.md-icon:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon{opacity:1;pointer-events:auto;transform:scale(1)}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon:hover{opacity:.7}[dir=ltr] .md-search__suggest{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__suggest{padding-left:2.2rem;padding-right:3.6rem}.md-search__suggest{align-items:center;color:var(--md-default-fg-color--lighter);display:flex;font-size:.9rem;height:100%;opacity:0;position:absolute;top:0;transition:opacity 50ms;white-space:nowrap;width:100%}@media screen and (min-width:60em){[dir=ltr] .md-search__suggest{padding-left:2.2rem}[dir=rtl] .md-search__suggest{padding-right:2.2rem}.md-search__suggest{font-size:.8rem}}[data-md-toggle=search]:checked~.md-header .md-search__suggest{opacity:1;transition:opacity .3s .1s}[dir=ltr] .md-search__output{border-bottom-left-radius:.1rem}[dir=ltr] .md-search__output,[dir=rtl] .md-search__output{border-bottom-right-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-left-radius:.1rem}.md-search__output{overflow:hidden;position:absolute;width:100%;z-index:1}@media screen and (max-width:59.984375em){.md-search__output{bottom:0;top:2.4rem}}@media screen and (min-width:60em){.md-search__output{opacity:0;top:1.9rem;transition:opacity .4s}[data-md-toggle=search]:checked~.md-header .md-search__output{box-shadow:var(--md-shadow-z3);opacity:1}}.md-search__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);height:100%;overflow-y:auto;touch-action:pan-y}@media (-webkit-max-device-pixel-ratio:1),(max-resolution:1dppx){.md-search__scrollwrap{transform:translateZ(0)}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-search__scrollwrap{width:23.4rem}}@media screen and (min-width:76.25em){.md-search__scrollwrap{width:34.4rem}}@media screen and (min-width:60em){.md-search__scrollwrap{max-height:0;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}[data-md-toggle=search]:checked~.md-header .md-search__scrollwrap{max-height:75vh}.md-search__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-search__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-search__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-search__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}}.md-search-result{color:var(--md-default-fg-color);word-break:break-word}.md-search-result__meta{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.8rem;padding:0 .8rem;scroll-snap-align:start}@media screen and (min-width:60em){[dir=ltr] .md-search-result__meta{padding-left:2.2rem}[dir=rtl] .md-search-result__meta{padding-right:2.2rem}}.md-search-result__list{list-style:none;margin:0;padding:0;-webkit-user-select:none;user-select:none}.md-search-result__item{box-shadow:0 -.05rem var(--md-default-fg-color--lightest)}.md-search-result__item:first-child{box-shadow:none}.md-search-result__link{display:block;outline:none;scroll-snap-align:start;transition:background-color .25s}.md-search-result__link:focus,.md-search-result__link:hover{background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:last-child p:last-child{margin-bottom:.6rem}.md-search-result__more>summary{cursor:pointer;display:block;outline:none;position:sticky;scroll-snap-align:start;top:0;z-index:1}.md-search-result__more>summary::marker{display:none}.md-search-result__more>summary::-webkit-details-marker{display:none}.md-search-result__more>summary>div{color:var(--md-typeset-a-color);font-size:.64rem;padding:.75em .8rem;transition:color .25s,background-color .25s}@media screen and (min-width:60em){[dir=ltr] .md-search-result__more>summary>div{padding-left:2.2rem}[dir=rtl] .md-search-result__more>summary>div{padding-right:2.2rem}}.md-search-result__more>summary:focus>div,.md-search-result__more>summary:hover>div{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more[open]>summary{background-color:var(--md-default-bg-color)}.md-search-result__article{overflow:hidden;padding:0 .8rem;position:relative}@media screen and (min-width:60em){[dir=ltr] .md-search-result__article{padding-left:2.2rem}[dir=rtl] .md-search-result__article{padding-right:2.2rem}}[dir=ltr] .md-search-result__icon{left:0}[dir=rtl] .md-search-result__icon{right:0}.md-search-result__icon{color:var(--md-default-fg-color--light);height:1.2rem;margin:.5rem;position:absolute;width:1.2rem}@media screen and (max-width:59.984375em){.md-search-result__icon{display:none}}.md-search-result__icon:after{background-color:currentcolor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-search-result-icon);mask-image:var(--md-search-result-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-search-result__icon:after{transform:scaleX(-1)}.md-search-result .md-typeset{color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.6}.md-search-result .md-typeset h1{color:var(--md-default-fg-color);font-size:.8rem;font-weight:400;line-height:1.4;margin:.55rem 0}.md-search-result .md-typeset h1 mark{text-decoration:none}.md-search-result .md-typeset h2{color:var(--md-default-fg-color);font-size:.64rem;font-weight:700;line-height:1.6;margin:.5em 0}.md-search-result .md-typeset h2 mark{text-decoration:none}.md-search-result__terms{color:var(--md-default-fg-color);display:block;font-size:.64rem;font-style:italic;margin:.5em 0}.md-search-result mark{background-color:initial;color:var(--md-accent-fg-color);text-decoration:underline}.md-select{position:relative;z-index:1}.md-select__inner{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:50%;margin-top:.2rem;max-height:0;opacity:0;position:absolute;top:calc(100% - .2rem);transform:translate3d(-50%,.3rem,0);transition:transform .25s 375ms,opacity .25s .25s,max-height 0ms .5s}.md-select:focus-within .md-select__inner,.md-select:hover .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select__inner:after{border-bottom:.2rem solid #0000;border-bottom-color:var(--md-default-bg-color);border-left:.2rem solid #0000;border-right:.2rem solid #0000;border-top:0;content:"";height:0;left:50%;margin-left:-.2rem;margin-top:-.2rem;position:absolute;top:0;width:0}.md-select__list{border-radius:.1rem;font-size:.8rem;list-style-type:none;margin:0;max-height:inherit;overflow:auto;padding:0}.md-select__item{line-height:1.8rem}[dir=ltr] .md-select__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-select__link{padding-left:1.2rem;padding-right:.6rem}.md-select__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:background-color .25s,color .25s;width:100%}.md-select__link:focus,.md-select__link:hover{color:var(--md-accent-fg-color)}.md-select__link:focus{background-color:var(--md-default-fg-color--lightest)}.md-sidebar{align-self:flex-start;flex-shrink:0;padding:1.2rem 0;position:sticky;top:2.4rem;width:12.1rem}@media print{.md-sidebar{display:none}}@media screen and (max-width:76.234375em){[dir=ltr] .md-sidebar--primary{left:-12.1rem}[dir=rtl] .md-sidebar--primary{right:-12.1rem}.md-sidebar--primary{background-color:var(--md-default-bg-color);display:block;height:100%;position:fixed;top:0;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),box-shadow .25s;width:12.1rem;z-index:5}[data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{box-shadow:var(--md-shadow-z3);transform:translateX(12.1rem)}[dir=rtl] [data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{transform:translateX(-12.1rem)}.md-sidebar--primary .md-sidebar__scrollwrap{bottom:0;left:0;margin:0;overflow:hidden;position:absolute;right:0;scroll-snap-type:none;top:0}}@media screen and (min-width:76.25em){.md-sidebar{height:0}.no-js .md-sidebar{height:auto}.md-header--lifted~.md-container .md-sidebar{top:4.8rem}}.md-sidebar--secondary{display:none;order:2}@media screen and (min-width:60em){.md-sidebar--secondary{height:0}.no-js .md-sidebar--secondary{height:auto}.md-sidebar--secondary:not([hidden]){display:block}.md-sidebar--secondary .md-sidebar__scrollwrap{touch-action:pan-y}}.md-sidebar__scrollwrap{scrollbar-gutter:stable;-webkit-backface-visibility:hidden;backface-visibility:hidden;margin:0 .2rem;overflow-y:auto;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}.md-sidebar__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-sidebar__scrollwrap:focus-within,.md-sidebar__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb:hover,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}@supports selector(::-webkit-scrollbar){.md-sidebar__scrollwrap{scrollbar-gutter:auto}[dir=ltr] .md-sidebar__inner{padding-right:calc(100% - 11.5rem)}[dir=rtl] .md-sidebar__inner{padding-left:calc(100% - 11.5rem)}}@media screen and (max-width:76.234375em){.md-overlay{background-color:#0000008a;height:0;opacity:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0;z-index:5}[data-md-toggle=drawer]:checked~.md-overlay{height:100%;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@keyframes facts{0%{height:0}to{height:.65rem}}@keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}:root{--md-source-forks-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-repositories-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-stars-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-version-icon:url('data:image/svg+xml;charset=utf-8,')}.md-source{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.65rem;line-height:1.2;outline-color:var(--md-accent-fg-color);transition:opacity .25s;white-space:nowrap}.md-source:hover{opacity:.7}.md-source__icon{display:inline-block;height:2.4rem;vertical-align:middle;width:2rem}[dir=ltr] .md-source__icon svg{margin-left:.6rem}[dir=rtl] .md-source__icon svg{margin-right:.6rem}.md-source__icon svg{margin-top:.6rem}[dir=ltr] .md-source__icon+.md-source__repository{padding-left:2rem}[dir=rtl] .md-source__icon+.md-source__repository{padding-right:2rem}[dir=ltr] .md-source__icon+.md-source__repository{margin-left:-2rem}[dir=rtl] .md-source__icon+.md-source__repository{margin-right:-2rem}[dir=ltr] .md-source__repository{margin-left:.6rem}[dir=rtl] .md-source__repository{margin-right:.6rem}.md-source__repository{display:inline-block;max-width:calc(100% - 1.2rem);overflow:hidden;text-overflow:ellipsis;vertical-align:middle}.md-source__facts{display:flex;font-size:.55rem;gap:.4rem;list-style-type:none;margin:.1rem 0 0;opacity:.75;overflow:hidden;padding:0;width:100%}.md-source__repository--active .md-source__facts{animation:facts .25s ease-in}.md-source__fact{overflow:hidden;text-overflow:ellipsis}.md-source__repository--active .md-source__fact{animation:fact .4s ease-out}[dir=ltr] .md-source__fact:before{margin-right:.1rem}[dir=rtl] .md-source__fact:before{margin-left:.1rem}.md-source__fact:before{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-top;width:.6rem}.md-source__fact:nth-child(1n+2){flex-shrink:0}.md-source__fact--version:before{-webkit-mask-image:var(--md-source-version-icon);mask-image:var(--md-source-version-icon)}.md-source__fact--stars:before{-webkit-mask-image:var(--md-source-stars-icon);mask-image:var(--md-source-stars-icon)}.md-source__fact--forks:before{-webkit-mask-image:var(--md-source-forks-icon);mask-image:var(--md-source-forks-icon)}.md-source__fact--repositories:before{-webkit-mask-image:var(--md-source-repositories-icon);mask-image:var(--md-source-repositories-icon)}.md-source-file{margin:1em 0}[dir=ltr] .md-source-file__fact{margin-right:.6rem}[dir=rtl] .md-source-file__fact{margin-left:.6rem}.md-source-file__fact{align-items:center;color:var(--md-default-fg-color--light);display:inline-flex;font-size:.68rem;gap:.3rem}.md-source-file__fact .md-icon{flex-shrink:0;margin-bottom:.05rem}[dir=ltr] .md-source-file__fact .md-author{float:left}[dir=rtl] .md-source-file__fact .md-author{float:right}.md-source-file__fact .md-author{margin-right:.2rem}.md-source-file__fact svg{width:.9rem}:root{--md-status:url('data:image/svg+xml;charset=utf-8,');--md-status--new:url('data:image/svg+xml;charset=utf-8,');--md-status--deprecated:url('data:image/svg+xml;charset=utf-8,');--md-status--encrypted:url('data:image/svg+xml;charset=utf-8,')}.md-status:after{background-color:var(--md-default-fg-color--light);content:"";display:inline-block;height:1.125em;-webkit-mask-image:var(--md-status);mask-image:var(--md-status);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-bottom;width:1.125em}.md-status:hover:after{background-color:currentcolor}.md-status--new:after{-webkit-mask-image:var(--md-status--new);mask-image:var(--md-status--new)}.md-status--deprecated:after{-webkit-mask-image:var(--md-status--deprecated);mask-image:var(--md-status--deprecated)}.md-status--encrypted:after{-webkit-mask-image:var(--md-status--encrypted);mask-image:var(--md-status--encrypted)}.md-tabs{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);display:block;line-height:1.3;overflow:auto;width:100%;z-index:3}@media print{.md-tabs{display:none}}@media screen and (max-width:76.234375em){.md-tabs{display:none}}.md-tabs[hidden]{pointer-events:none}[dir=ltr] .md-tabs__list{margin-left:.2rem}[dir=rtl] .md-tabs__list{margin-right:.2rem}.md-tabs__list{contain:content;display:flex;list-style:none;margin:0;overflow:auto;padding:0;scrollbar-width:none;white-space:nowrap}.md-tabs__list::-webkit-scrollbar{display:none}.md-tabs__item{height:2.4rem;padding-left:.6rem;padding-right:.6rem}.md-tabs__item--active .md-tabs__link{color:inherit;opacity:1}.md-tabs__link{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:flex;font-size:.7rem;margin-top:.8rem;opacity:.7;outline-color:var(--md-accent-fg-color);outline-offset:.2rem;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .25s}.md-tabs__link:focus,.md-tabs__link:hover{color:inherit;opacity:1}[dir=ltr] .md-tabs__link svg{margin-right:.4rem}[dir=rtl] .md-tabs__link svg{margin-left:.4rem}.md-tabs__link svg{fill:currentcolor;height:1.3em}.md-tabs__item:nth-child(2) .md-tabs__link{transition-delay:20ms}.md-tabs__item:nth-child(3) .md-tabs__link{transition-delay:40ms}.md-tabs__item:nth-child(4) .md-tabs__link{transition-delay:60ms}.md-tabs__item:nth-child(5) .md-tabs__link{transition-delay:80ms}.md-tabs__item:nth-child(6) .md-tabs__link{transition-delay:.1s}.md-tabs__item:nth-child(7) .md-tabs__link{transition-delay:.12s}.md-tabs__item:nth-child(8) .md-tabs__link{transition-delay:.14s}.md-tabs__item:nth-child(9) .md-tabs__link{transition-delay:.16s}.md-tabs__item:nth-child(10) .md-tabs__link{transition-delay:.18s}.md-tabs__item:nth-child(11) .md-tabs__link{transition-delay:.2s}.md-tabs__item:nth-child(12) .md-tabs__link{transition-delay:.22s}.md-tabs__item:nth-child(13) .md-tabs__link{transition-delay:.24s}.md-tabs__item:nth-child(14) .md-tabs__link{transition-delay:.26s}.md-tabs__item:nth-child(15) .md-tabs__link{transition-delay:.28s}.md-tabs__item:nth-child(16) .md-tabs__link{transition-delay:.3s}.md-tabs[hidden] .md-tabs__link{opacity:0;transform:translateY(50%);transition:transform 0ms .1s,opacity .1s}:root{--md-tag-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .md-tags:not([hidden]){display:inline-flex;flex-wrap:wrap;gap:.5em;margin-bottom:.75em;margin-top:-.125em}.md-typeset .md-tag{align-items:center;background:var(--md-default-fg-color--lightest);border-radius:2.4rem;display:inline-flex;font-size:.64rem;font-size:min(.8em,.64rem);font-weight:700;gap:.5em;letter-spacing:normal;line-height:1.6;padding:.3125em .78125em}.md-typeset .md-tag[href]{-webkit-tap-highlight-color:transparent;color:inherit;outline:none;transition:color 125ms,background-color 125ms}.md-typeset .md-tag[href]:focus,.md-typeset .md-tag[href]:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[id]>.md-typeset .md-tag{vertical-align:text-top}.md-typeset .md-tag-icon:before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-tag-icon);mask-image:var(--md-tag-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset .md-tag-icon[href]:focus:before,.md-typeset .md-tag-icon[href]:hover:before{background-color:var(--md-accent-bg-color)}@keyframes pulse{0%{transform:scale(.95)}75%{transform:scale(1)}to{transform:scale(.95)}}:root{--md-annotation-bg-icon:url('data:image/svg+xml;charset=utf-8,');--md-annotation-icon:url('data:image/svg+xml;charset=utf-8,');--md-tooltip-width:20rem}.md-tooltip{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);font-family:var(--md-text-font-family);left:clamp(var(--md-tooltip-0,0rem) + .8rem,var(--md-tooltip-x),100vw + var(--md-tooltip-0,0rem) + .8rem - var(--md-tooltip-width) - 2 * .8rem);max-width:calc(100vw - 1.6rem);opacity:0;position:absolute;top:var(--md-tooltip-y);transform:translateY(-.4rem);transition:transform 0ms .25s,opacity .25s,z-index .25s;width:var(--md-tooltip-width);z-index:0}.md-tooltip--active{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip--inline{font-weight:700;-webkit-user-select:none;user-select:none;width:auto}.md-tooltip--inline:not(.md-tooltip--active){transform:translateY(.2rem) scale(.9)}.md-tooltip--inline .md-tooltip__inner{font-size:.5rem;padding:.2rem .4rem}[hidden]+.md-tooltip--inline{display:none}.focus-visible>.md-tooltip,.md-tooltip:target{outline:var(--md-accent-fg-color) auto}.md-tooltip__inner{font-size:.64rem;padding:.8rem}.md-tooltip__inner.md-typeset>:first-child{margin-top:0}.md-tooltip__inner.md-typeset>:last-child{margin-bottom:0}.md-annotation{font-weight:400;outline:none;vertical-align:text-bottom;white-space:normal}[dir=rtl] .md-annotation{direction:rtl}code .md-annotation{font-family:var(--md-code-font-family);font-size:inherit}.md-annotation:not([hidden]){display:inline-block;line-height:1.25}.md-annotation__index{border-radius:.01px;cursor:pointer;display:inline-block;margin-left:.4ch;margin-right:.4ch;outline:none;overflow:hidden;position:relative;-webkit-user-select:none;user-select:none;vertical-align:text-top;z-index:0}.md-annotation .md-annotation__index{transition:z-index .25s}@media screen{.md-annotation__index{width:2.2ch}[data-md-visible]>.md-annotation__index{animation:pulse 2s infinite}.md-annotation__index:before{background:var(--md-default-bg-color);-webkit-mask-image:var(--md-annotation-bg-icon);mask-image:var(--md-annotation-bg-icon)}.md-annotation__index:after,.md-annotation__index:before{content:"";height:2.2ch;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:-.1ch;width:2.2ch;z-index:-1}.md-annotation__index:after{background-color:var(--md-default-fg-color--lighter);-webkit-mask-image:var(--md-annotation-icon);mask-image:var(--md-annotation-icon);transform:scale(1.0001);transition:background-color .25s,transform .25s}.md-tooltip--active+.md-annotation__index:after{transform:rotate(45deg)}.md-tooltip--active+.md-annotation__index:after,:hover>.md-annotation__index:after{background-color:var(--md-accent-fg-color)}}.md-tooltip--active+.md-annotation__index{animation-play-state:paused;transition-duration:0ms;z-index:2}.md-annotation__index [data-md-annotation-id]{display:inline-block}@media print{.md-annotation__index [data-md-annotation-id]{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);font-weight:700;padding:0 .6ch;white-space:nowrap}.md-annotation__index [data-md-annotation-id]:after{content:attr(data-md-annotation-id)}}.md-typeset .md-annotation-list{counter-reset:xxx;list-style:none}.md-typeset .md-annotation-list li{position:relative}[dir=ltr] .md-typeset .md-annotation-list li:before{left:-2.125em}[dir=rtl] .md-typeset .md-annotation-list li:before{right:-2.125em}.md-typeset .md-annotation-list li:before{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);content:counter(xxx);counter-increment:xxx;font-size:.8875em;font-weight:700;height:2ch;line-height:1.25;min-width:2ch;padding:0 .6ch;position:absolute;text-align:center;top:.25em}[dir=ltr] .md-top{margin-left:50%}[dir=rtl] .md-top{margin-right:50%}.md-top{background-color:var(--md-default-bg-color);border-radius:1.6rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color--light);cursor:pointer;display:block;font-size:.7rem;outline:none;padding:.4rem .8rem;position:fixed;top:3.2rem;transform:translate(-50%);transition:color 125ms,background-color 125ms,transform 125ms cubic-bezier(.4,0,.2,1),opacity 125ms;z-index:2}@media print{.md-top{display:none}}[dir=rtl] .md-top{transform:translate(50%)}.md-top[hidden]{opacity:0;pointer-events:none;transform:translate(-50%,.2rem);transition-duration:0ms}[dir=rtl] .md-top[hidden]{transform:translate(50%,.2rem)}.md-top:focus,.md-top:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top svg{display:inline-block;vertical-align:-.5em}@keyframes hoverfix{0%{pointer-events:none}}:root{--md-version-icon:url('data:image/svg+xml;charset=utf-8,')}.md-version{flex-shrink:0;font-size:.8rem;height:2.4rem}[dir=ltr] .md-version__current{margin-left:1.4rem;margin-right:.4rem}[dir=rtl] .md-version__current{margin-left:.4rem;margin-right:1.4rem}.md-version__current{color:inherit;cursor:pointer;outline:none;position:relative;top:.05rem}[dir=ltr] .md-version__current:after{margin-left:.4rem}[dir=rtl] .md-version__current:after{margin-right:.4rem}.md-version__current:after{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-image:var(--md-version-icon);mask-image:var(--md-version-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.4rem}.md-version__list{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);list-style-type:none;margin:.2rem .8rem;max-height:0;opacity:0;overflow:auto;padding:0;position:absolute;scroll-snap-type:y mandatory;top:.15rem;transition:max-height 0ms .5s,opacity .25s .25s;z-index:3}.md-version:focus-within .md-version__list,.md-version:hover .md-version__list{max-height:10rem;opacity:1;transition:max-height 0ms,opacity .25s}@media (hover:none),(pointer:coarse){.md-version:hover .md-version__list{animation:hoverfix .25s forwards}.md-version:focus-within .md-version__list{animation:none}}.md-version__item{line-height:1.8rem}[dir=ltr] .md-version__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-version__link{padding-left:1.2rem;padding-right:.6rem}.md-version__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:color .25s,background-color .25s;white-space:nowrap;width:100%}.md-version__link:focus,.md-version__link:hover{color:var(--md-accent-fg-color)}.md-version__link:focus{background-color:var(--md-default-fg-color--lightest)}:root{--md-admonition-icon--note:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--abstract:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--info:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--tip:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--success:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--question:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--warning:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--failure:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--danger:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--bug:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--quote:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .admonition,.md-typeset details{background-color:var(--md-admonition-bg-color);border:.075rem solid #448aff;border-radius:.2rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid;transition:box-shadow 125ms}@media print{.md-typeset .admonition,.md-typeset details{box-shadow:none}}.md-typeset .admonition:focus-within,.md-typeset details:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .admonition>*,.md-typeset details>*{box-sizing:border-box}.md-typeset .admonition .admonition,.md-typeset .admonition details,.md-typeset details .admonition,.md-typeset details details{margin-bottom:1em;margin-top:1em}.md-typeset .admonition .md-typeset__scrollwrap,.md-typeset details .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset .admonition .md-typeset__table,.md-typeset details .md-typeset__table{padding:0 .6rem}.md-typeset .admonition>.tabbed-set:only-child,.md-typeset details>.tabbed-set:only-child{margin-top:0}html .md-typeset .admonition>:last-child,html .md-typeset details>:last-child{margin-bottom:.6rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{padding-left:2rem;padding-right:.6rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{padding-left:.6rem;padding-right:2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-left-width:.2rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-right-width:.2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset .admonition-title,.md-typeset summary{background-color:#448aff1a;border:none;font-weight:700;margin:0 -.6rem;padding-bottom:.4rem;padding-top:.4rem;position:relative}html .md-typeset .admonition-title:last-child,html .md-typeset summary:last-child{margin-bottom:0}[dir=ltr] .md-typeset .admonition-title:before,[dir=ltr] .md-typeset summary:before{left:.6rem}[dir=rtl] .md-typeset .admonition-title:before,[dir=rtl] .md-typeset summary:before{right:.6rem}.md-typeset .admonition-title:before,.md-typeset summary:before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset .admonition-title code,.md-typeset summary code{box-shadow:0 0 0 .05rem var(--md-default-fg-color--lightest)}.md-typeset .admonition.note,.md-typeset details.note{border-color:#448aff}.md-typeset .admonition.note:focus-within,.md-typeset details.note:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .note>.admonition-title,.md-typeset .note>summary{background-color:#448aff1a}.md-typeset .note>.admonition-title:before,.md-typeset .note>summary:before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note)}.md-typeset .note>.admonition-title:after,.md-typeset .note>summary:after{color:#448aff}.md-typeset .admonition.abstract,.md-typeset details.abstract{border-color:#00b0ff}.md-typeset .admonition.abstract:focus-within,.md-typeset details.abstract:focus-within{box-shadow:0 0 0 .2rem #00b0ff1a}.md-typeset .abstract>.admonition-title,.md-typeset .abstract>summary{background-color:#00b0ff1a}.md-typeset .abstract>.admonition-title:before,.md-typeset .abstract>summary:before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract)}.md-typeset .abstract>.admonition-title:after,.md-typeset .abstract>summary:after{color:#00b0ff}.md-typeset .admonition.info,.md-typeset details.info{border-color:#00b8d4}.md-typeset .admonition.info:focus-within,.md-typeset details.info:focus-within{box-shadow:0 0 0 .2rem #00b8d41a}.md-typeset .info>.admonition-title,.md-typeset .info>summary{background-color:#00b8d41a}.md-typeset .info>.admonition-title:before,.md-typeset .info>summary:before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info)}.md-typeset .info>.admonition-title:after,.md-typeset .info>summary:after{color:#00b8d4}.md-typeset .admonition.tip,.md-typeset details.tip{border-color:#00bfa5}.md-typeset .admonition.tip:focus-within,.md-typeset details.tip:focus-within{box-shadow:0 0 0 .2rem #00bfa51a}.md-typeset .tip>.admonition-title,.md-typeset .tip>summary{background-color:#00bfa51a}.md-typeset .tip>.admonition-title:before,.md-typeset .tip>summary:before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip)}.md-typeset .tip>.admonition-title:after,.md-typeset .tip>summary:after{color:#00bfa5}.md-typeset .admonition.success,.md-typeset details.success{border-color:#00c853}.md-typeset .admonition.success:focus-within,.md-typeset details.success:focus-within{box-shadow:0 0 0 .2rem #00c8531a}.md-typeset .success>.admonition-title,.md-typeset .success>summary{background-color:#00c8531a}.md-typeset .success>.admonition-title:before,.md-typeset .success>summary:before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success)}.md-typeset .success>.admonition-title:after,.md-typeset .success>summary:after{color:#00c853}.md-typeset .admonition.question,.md-typeset details.question{border-color:#64dd17}.md-typeset .admonition.question:focus-within,.md-typeset details.question:focus-within{box-shadow:0 0 0 .2rem #64dd171a}.md-typeset .question>.admonition-title,.md-typeset .question>summary{background-color:#64dd171a}.md-typeset .question>.admonition-title:before,.md-typeset .question>summary:before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question)}.md-typeset .question>.admonition-title:after,.md-typeset .question>summary:after{color:#64dd17}.md-typeset .admonition.warning,.md-typeset details.warning{border-color:#ff9100}.md-typeset .admonition.warning:focus-within,.md-typeset details.warning:focus-within{box-shadow:0 0 0 .2rem #ff91001a}.md-typeset .warning>.admonition-title,.md-typeset .warning>summary{background-color:#ff91001a}.md-typeset .warning>.admonition-title:before,.md-typeset .warning>summary:before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning)}.md-typeset .warning>.admonition-title:after,.md-typeset .warning>summary:after{color:#ff9100}.md-typeset .admonition.failure,.md-typeset details.failure{border-color:#ff5252}.md-typeset .admonition.failure:focus-within,.md-typeset details.failure:focus-within{box-shadow:0 0 0 .2rem #ff52521a}.md-typeset .failure>.admonition-title,.md-typeset .failure>summary{background-color:#ff52521a}.md-typeset .failure>.admonition-title:before,.md-typeset .failure>summary:before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure)}.md-typeset .failure>.admonition-title:after,.md-typeset .failure>summary:after{color:#ff5252}.md-typeset .admonition.danger,.md-typeset details.danger{border-color:#ff1744}.md-typeset .admonition.danger:focus-within,.md-typeset details.danger:focus-within{box-shadow:0 0 0 .2rem #ff17441a}.md-typeset .danger>.admonition-title,.md-typeset .danger>summary{background-color:#ff17441a}.md-typeset .danger>.admonition-title:before,.md-typeset .danger>summary:before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger)}.md-typeset .danger>.admonition-title:after,.md-typeset .danger>summary:after{color:#ff1744}.md-typeset .admonition.bug,.md-typeset details.bug{border-color:#f50057}.md-typeset .admonition.bug:focus-within,.md-typeset details.bug:focus-within{box-shadow:0 0 0 .2rem #f500571a}.md-typeset .bug>.admonition-title,.md-typeset .bug>summary{background-color:#f500571a}.md-typeset .bug>.admonition-title:before,.md-typeset .bug>summary:before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug)}.md-typeset .bug>.admonition-title:after,.md-typeset .bug>summary:after{color:#f50057}.md-typeset .admonition.example,.md-typeset details.example{border-color:#7c4dff}.md-typeset .admonition.example:focus-within,.md-typeset details.example:focus-within{box-shadow:0 0 0 .2rem #7c4dff1a}.md-typeset .example>.admonition-title,.md-typeset .example>summary{background-color:#7c4dff1a}.md-typeset .example>.admonition-title:before,.md-typeset .example>summary:before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example)}.md-typeset .example>.admonition-title:after,.md-typeset .example>summary:after{color:#7c4dff}.md-typeset .admonition.quote,.md-typeset details.quote{border-color:#9e9e9e}.md-typeset .admonition.quote:focus-within,.md-typeset details.quote:focus-within{box-shadow:0 0 0 .2rem #9e9e9e1a}.md-typeset .quote>.admonition-title,.md-typeset .quote>summary{background-color:#9e9e9e1a}.md-typeset .quote>.admonition-title:before,.md-typeset .quote>summary:before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote)}.md-typeset .quote>.admonition-title:after,.md-typeset .quote>summary:after{color:#9e9e9e}:root{--md-footnotes-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .footnote{color:var(--md-default-fg-color--light);font-size:.64rem}[dir=ltr] .md-typeset .footnote>ol{margin-left:0}[dir=rtl] .md-typeset .footnote>ol{margin-right:0}.md-typeset .footnote>ol>li{transition:color 125ms}.md-typeset .footnote>ol>li:target{color:var(--md-default-fg-color)}.md-typeset .footnote>ol>li:focus-within .footnote-backref{opacity:1;transform:translateX(0);transition:none}.md-typeset .footnote>ol>li:hover .footnote-backref,.md-typeset .footnote>ol>li:target .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li>:first-child{margin-top:0}.md-typeset .footnote-ref{font-size:.75em;font-weight:700}html .md-typeset .footnote-ref{outline-offset:.1rem}.md-typeset [id^="fnref:"]:target>.footnote-ref{outline:auto}.md-typeset .footnote-backref{color:var(--md-typeset-a-color);display:inline-block;font-size:0;opacity:0;transform:translateX(.25rem);transition:color .25s,transform .25s .25s,opacity 125ms .25s;vertical-align:text-bottom}@media print{.md-typeset .footnote-backref{color:var(--md-typeset-a-color);opacity:1;transform:translateX(0)}}[dir=rtl] .md-typeset .footnote-backref{transform:translateX(-.25rem)}.md-typeset .footnote-backref:hover{color:var(--md-accent-fg-color)}.md-typeset .footnote-backref:before{background-color:currentcolor;content:"";display:inline-block;height:.8rem;-webkit-mask-image:var(--md-footnotes-icon);mask-image:var(--md-footnotes-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.8rem}[dir=rtl] .md-typeset .footnote-backref:before svg{transform:scaleX(-1)}[dir=ltr] .md-typeset .headerlink{margin-left:.5rem}[dir=rtl] .md-typeset .headerlink{margin-right:.5rem}.md-typeset .headerlink{color:var(--md-default-fg-color--lighter);display:inline-block;opacity:0;transition:color .25s,opacity 125ms}@media print{.md-typeset .headerlink{display:none}}.md-typeset .headerlink:focus,.md-typeset :hover>.headerlink,.md-typeset :target>.headerlink{opacity:1;transition:color .25s,opacity 125ms}.md-typeset .headerlink:focus,.md-typeset .headerlink:hover,.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset :target{--md-scroll-margin:3.6rem;--md-scroll-offset:0rem;scroll-margin-top:calc(var(--md-scroll-margin) - var(--md-scroll-offset))}@media screen and (min-width:76.25em){.md-header--lifted~.md-container .md-typeset :target{--md-scroll-margin:6rem}}.md-typeset h1:target,.md-typeset h2:target,.md-typeset h3:target{--md-scroll-offset:0.2rem}.md-typeset h4:target{--md-scroll-offset:0.15rem}.md-typeset div.arithmatex{overflow:auto}@media screen and (max-width:44.984375em){.md-typeset div.arithmatex{margin:0 -.8rem}.md-typeset div.arithmatex>*{width:-webkit-min-content;width:min-content}}.md-typeset div.arithmatex>*{margin-left:auto!important;margin-right:auto!important;padding:0 .8rem;touch-action:auto}.md-typeset div.arithmatex>* mjx-container{margin:0!important}.md-typeset div.arithmatex mjx-assistive-mml{height:0}.md-typeset del.critic{background-color:var(--md-typeset-del-color)}.md-typeset del.critic,.md-typeset ins.critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset ins.critic{background-color:var(--md-typeset-ins-color)}.md-typeset .critic.comment{-webkit-box-decoration-break:clone;box-decoration-break:clone;color:var(--md-code-hl-comment-color)}.md-typeset .critic.comment:before{content:"/* "}.md-typeset .critic.comment:after{content:" */"}.md-typeset .critic.block{box-shadow:none;display:block;margin:1em 0;overflow:auto;padding-left:.8rem;padding-right:.8rem}.md-typeset .critic.block>:first-child{margin-top:.5em}.md-typeset .critic.block>:last-child{margin-bottom:.5em}:root{--md-details-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset details{display:flow-root;overflow:visible;padding-top:0}.md-typeset details[open]>summary:after{transform:rotate(90deg)}.md-typeset details:not([open]){box-shadow:none;padding-bottom:0}.md-typeset details:not([open])>summary{border-radius:.1rem}[dir=ltr] .md-typeset summary{padding-right:1.8rem}[dir=rtl] .md-typeset summary{padding-left:1.8rem}[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset summary{cursor:pointer;display:block;min-height:1rem;overflow:hidden}.md-typeset summary.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset summary:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[dir=ltr] .md-typeset summary:after{right:.4rem}[dir=rtl] .md-typeset summary:after{left:.4rem}.md-typeset summary:after{background-color:currentcolor;content:"";height:1rem;-webkit-mask-image:var(--md-details-icon);mask-image:var(--md-details-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;transform:rotate(0deg);transition:transform .25s;width:1rem}[dir=rtl] .md-typeset summary:after{transform:rotate(180deg)}.md-typeset summary::marker{display:none}.md-typeset summary::-webkit-details-marker{display:none}.md-typeset .emojione,.md-typeset .gemoji,.md-typeset .twemoji{--md-icon-size:1.125em;display:inline-flex;height:var(--md-icon-size);vertical-align:text-top}.md-typeset .emojione svg,.md-typeset .gemoji svg,.md-typeset .twemoji svg{fill:currentcolor;max-height:100%;width:var(--md-icon-size)}.md-typeset .lg,.md-typeset .xl,.md-typeset .xxl,.md-typeset .xxxl{vertical-align:text-bottom}.md-typeset .middle{vertical-align:middle}.md-typeset .lg{--md-icon-size:1.5em}.md-typeset .xl{--md-icon-size:2.25em}.md-typeset .xxl{--md-icon-size:3em}.md-typeset .xxxl{--md-icon-size:4em}.highlight .o,.highlight .ow{color:var(--md-code-hl-operator-color)}.highlight .p{color:var(--md-code-hl-punctuation-color)}.highlight .cpf,.highlight .l,.highlight .s,.highlight .s1,.highlight .s2,.highlight .sb,.highlight .sc,.highlight .si,.highlight .ss{color:var(--md-code-hl-string-color)}.highlight .cp,.highlight .se,.highlight .sh,.highlight .sr,.highlight .sx{color:var(--md-code-hl-special-color)}.highlight .il,.highlight .m,.highlight .mb,.highlight .mf,.highlight .mh,.highlight .mi,.highlight .mo{color:var(--md-code-hl-number-color)}.highlight .k,.highlight .kd,.highlight .kn,.highlight .kp,.highlight .kr,.highlight .kt{color:var(--md-code-hl-keyword-color)}.highlight .kc,.highlight .n{color:var(--md-code-hl-name-color)}.highlight .bp,.highlight .nb,.highlight .no{color:var(--md-code-hl-constant-color)}.highlight .nc,.highlight .ne,.highlight .nf,.highlight .nn{color:var(--md-code-hl-function-color)}.highlight .nd,.highlight .ni,.highlight .nl,.highlight .nt{color:var(--md-code-hl-keyword-color)}.highlight .c,.highlight .c1,.highlight .ch,.highlight .cm,.highlight .cs,.highlight .sd{color:var(--md-code-hl-comment-color)}.highlight .na,.highlight .nv,.highlight .vc,.highlight .vg,.highlight .vi{color:var(--md-code-hl-variable-color)}.highlight .ge,.highlight .gh,.highlight .go,.highlight .gp,.highlight .gr,.highlight .gs,.highlight .gt,.highlight .gu{color:var(--md-code-hl-generic-color)}.highlight .gd,.highlight .gi{border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight .gd{background-color:var(--md-typeset-del-color)}.highlight .gi{background-color:var(--md-typeset-ins-color)}.highlight .hll{background-color:var(--md-code-hl-color--light);box-shadow:2px 0 0 0 var(--md-code-hl-color) inset;display:block;margin:0 -1.1764705882em;padding:0 1.1764705882em}.highlight span.filename{background-color:var(--md-code-bg-color);border-bottom:.05rem solid var(--md-default-fg-color--lightest);border-top-left-radius:.1rem;border-top-right-radius:.1rem;display:flow-root;font-size:.85em;font-weight:700;margin-top:1em;padding:.6617647059em 1.1764705882em;position:relative}.highlight span.filename+pre{margin-top:0}.highlight span.filename+pre>code{border-top-left-radius:0;border-top-right-radius:0}.highlight [data-linenos]:before{background-color:var(--md-code-bg-color);box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;color:var(--md-default-fg-color--light);content:attr(data-linenos);float:left;left:-1.1764705882em;margin-left:-1.1764705882em;margin-right:1.1764705882em;padding-left:1.1764705882em;position:sticky;-webkit-user-select:none;user-select:none;z-index:3}.highlight code a[id]{position:absolute;visibility:hidden}.highlight code[data-md-copying] .hll{display:contents}.highlight code[data-md-copying] .md-annotation{display:none}.highlighttable{display:flow-root}.highlighttable tbody,.highlighttable td{display:block;padding:0}.highlighttable tr{display:flex}.highlighttable pre{margin:0}.highlighttable th.filename{flex-grow:1;padding:0;text-align:left}.highlighttable th.filename span.filename{margin-top:0}.highlighttable .linenos{background-color:var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-top-left-radius:.1rem;font-size:.85em;padding:.7720588235em 0 .7720588235em 1.1764705882em;-webkit-user-select:none;user-select:none}.highlighttable .linenodiv{box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;padding-right:.5882352941em}.highlighttable .linenodiv pre{color:var(--md-default-fg-color--light);text-align:right}.highlighttable .code{flex:1;min-width:0}.linenodiv a{color:inherit}.md-typeset .highlighttable{direction:ltr;margin:1em 0}.md-typeset .highlighttable>tbody>tr>.code>div>pre>code{border-bottom-left-radius:0;border-top-left-radius:0}.md-typeset .highlight+.result{border:.05rem solid var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-bottom-right-radius:.1rem;border-top-width:.1rem;margin-top:-1.125em;overflow:visible;padding:0 1em}.md-typeset .highlight+.result:after{clear:both;content:"";display:block}@media screen and (max-width:44.984375em){.md-content__inner>.highlight{margin:1em -.8rem}.md-content__inner>.highlight>.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.code>div>pre>code,.md-content__inner>.highlight>.highlighttable>tbody>tr>.filename span.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.linenos,.md-content__inner>.highlight>pre>code{border-radius:0}.md-content__inner>.highlight+.result{border-left-width:0;border-radius:0;border-right-width:0;margin-left:-.8rem;margin-right:-.8rem}}.md-typeset .keys kbd:after,.md-typeset .keys kbd:before{-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys span{color:var(--md-default-fg-color--light);padding:0 .2em}.md-typeset .keys .key-alt:before,.md-typeset .keys .key-left-alt:before,.md-typeset .keys .key-right-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-command:before,.md-typeset .keys .key-left-command:before,.md-typeset .keys .key-right-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-control:before,.md-typeset .keys .key-left-control:before,.md-typeset .keys .key-right-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-left-meta:before,.md-typeset .keys .key-meta:before,.md-typeset .keys .key-right-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-left-option:before,.md-typeset .keys .key-option:before,.md-typeset .keys .key-right-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-left-shift:before,.md-typeset .keys .key-right-shift:before,.md-typeset .keys .key-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-left-super:before,.md-typeset .keys .key-right-super:before,.md-typeset .keys .key-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-left-windows:before,.md-typeset .keys .key-right-windows:before,.md-typeset .keys .key-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-arrow-down:before{content:"↓";padding-right:.4em}.md-typeset .keys .key-arrow-left:before{content:"←";padding-right:.4em}.md-typeset .keys .key-arrow-right:before{content:"→";padding-right:.4em}.md-typeset .keys .key-arrow-up:before{content:"↑";padding-right:.4em}.md-typeset .keys .key-backspace:before{content:"⌫";padding-right:.4em}.md-typeset .keys .key-backtab:before{content:"⇤";padding-right:.4em}.md-typeset .keys .key-caps-lock:before{content:"⇪";padding-right:.4em}.md-typeset .keys .key-clear:before{content:"⌧";padding-right:.4em}.md-typeset .keys .key-context-menu:before{content:"☰";padding-right:.4em}.md-typeset .keys .key-delete:before{content:"⌦";padding-right:.4em}.md-typeset .keys .key-eject:before{content:"⏏";padding-right:.4em}.md-typeset .keys .key-end:before{content:"⤓";padding-right:.4em}.md-typeset .keys .key-escape:before{content:"⎋";padding-right:.4em}.md-typeset .keys .key-home:before{content:"⤒";padding-right:.4em}.md-typeset .keys .key-insert:before{content:"⎀";padding-right:.4em}.md-typeset .keys .key-page-down:before{content:"⇟";padding-right:.4em}.md-typeset .keys .key-page-up:before{content:"⇞";padding-right:.4em}.md-typeset .keys .key-print-screen:before{content:"⎙";padding-right:.4em}.md-typeset .keys .key-tab:after{content:"⇥";padding-left:.4em}.md-typeset .keys .key-num-enter:after{content:"⌤";padding-left:.4em}.md-typeset .keys .key-enter:after{content:"⏎";padding-left:.4em}:root{--md-tabbed-icon--prev:url('data:image/svg+xml;charset=utf-8,');--md-tabbed-icon--next:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .tabbed-set{border-radius:.1rem;display:flex;flex-flow:column wrap;margin:1em 0;position:relative}.md-typeset .tabbed-set>input{height:0;opacity:0;position:absolute;width:0}.md-typeset .tabbed-set>input:target{--md-scroll-offset:0.625em}.md-typeset .tabbed-set>input.focus-visible~.tabbed-labels:before{background-color:var(--md-accent-fg-color)}.md-typeset .tabbed-labels{-ms-overflow-style:none;box-shadow:0 -.05rem var(--md-default-fg-color--lightest) inset;display:flex;max-width:100%;overflow:auto;scrollbar-width:none}@media print{.md-typeset .tabbed-labels{display:contents}}@media screen{.js .md-typeset .tabbed-labels{position:relative}.js .md-typeset .tabbed-labels:before{background:var(--md-default-fg-color);bottom:0;content:"";display:block;height:2px;left:0;position:absolute;transform:translateX(var(--md-indicator-x));transition:width 225ms,background-color .25s,transform .25s;transition-timing-function:cubic-bezier(.4,0,.2,1);width:var(--md-indicator-width)}}.md-typeset .tabbed-labels::-webkit-scrollbar{display:none}.md-typeset .tabbed-labels>label{border-bottom:.1rem solid #0000;border-radius:.1rem .1rem 0 0;color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;font-size:.64rem;font-weight:700;padding:.78125em 1.25em .625em;scroll-margin-inline-start:1rem;transition:background-color .25s,color .25s;white-space:nowrap;width:auto}@media print{.md-typeset .tabbed-labels>label:first-child{order:1}.md-typeset .tabbed-labels>label:nth-child(2){order:2}.md-typeset .tabbed-labels>label:nth-child(3){order:3}.md-typeset .tabbed-labels>label:nth-child(4){order:4}.md-typeset .tabbed-labels>label:nth-child(5){order:5}.md-typeset .tabbed-labels>label:nth-child(6){order:6}.md-typeset .tabbed-labels>label:nth-child(7){order:7}.md-typeset .tabbed-labels>label:nth-child(8){order:8}.md-typeset .tabbed-labels>label:nth-child(9){order:9}.md-typeset .tabbed-labels>label:nth-child(10){order:10}.md-typeset .tabbed-labels>label:nth-child(11){order:11}.md-typeset .tabbed-labels>label:nth-child(12){order:12}.md-typeset .tabbed-labels>label:nth-child(13){order:13}.md-typeset .tabbed-labels>label:nth-child(14){order:14}.md-typeset .tabbed-labels>label:nth-child(15){order:15}.md-typeset .tabbed-labels>label:nth-child(16){order:16}.md-typeset .tabbed-labels>label:nth-child(17){order:17}.md-typeset .tabbed-labels>label:nth-child(18){order:18}.md-typeset .tabbed-labels>label:nth-child(19){order:19}.md-typeset .tabbed-labels>label:nth-child(20){order:20}}.md-typeset .tabbed-labels>label:hover{color:var(--md-default-fg-color)}.md-typeset .tabbed-labels>label>[href]:first-child{color:inherit}.md-typeset .tabbed-labels--linked>label{padding:0}.md-typeset .tabbed-labels--linked>label>a{display:block;padding:.78125em 1.25em .625em}.md-typeset .tabbed-content{width:100%}@media print{.md-typeset .tabbed-content{display:contents}}.md-typeset .tabbed-block{display:none}@media print{.md-typeset .tabbed-block{display:block}.md-typeset .tabbed-block:first-child{order:1}.md-typeset .tabbed-block:nth-child(2){order:2}.md-typeset .tabbed-block:nth-child(3){order:3}.md-typeset .tabbed-block:nth-child(4){order:4}.md-typeset .tabbed-block:nth-child(5){order:5}.md-typeset .tabbed-block:nth-child(6){order:6}.md-typeset .tabbed-block:nth-child(7){order:7}.md-typeset .tabbed-block:nth-child(8){order:8}.md-typeset .tabbed-block:nth-child(9){order:9}.md-typeset .tabbed-block:nth-child(10){order:10}.md-typeset .tabbed-block:nth-child(11){order:11}.md-typeset .tabbed-block:nth-child(12){order:12}.md-typeset .tabbed-block:nth-child(13){order:13}.md-typeset .tabbed-block:nth-child(14){order:14}.md-typeset .tabbed-block:nth-child(15){order:15}.md-typeset .tabbed-block:nth-child(16){order:16}.md-typeset .tabbed-block:nth-child(17){order:17}.md-typeset .tabbed-block:nth-child(18){order:18}.md-typeset .tabbed-block:nth-child(19){order:19}.md-typeset .tabbed-block:nth-child(20){order:20}}.md-typeset .tabbed-block>.highlight:first-child>pre,.md-typeset .tabbed-block>pre:first-child{margin:0}.md-typeset .tabbed-block>.highlight:first-child>pre>code,.md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child>.filename{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable{margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.filename span.filename,.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.linenos{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.code>div>pre>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child+.result{margin-top:-.125em}.md-typeset .tabbed-block>.tabbed-set{margin:0}.md-typeset .tabbed-button{align-self:center;border-radius:100%;color:var(--md-default-fg-color--light);cursor:pointer;display:block;height:.9rem;margin-top:.1rem;pointer-events:auto;transition:background-color .25s;width:.9rem}.md-typeset .tabbed-button:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .tabbed-button:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-tabbed-icon--prev);mask-image:var(--md-tabbed-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color .25s,transform .25s;width:100%}.md-typeset .tabbed-control{background:linear-gradient(to right,var(--md-default-bg-color) 60%,#0000);display:flex;height:1.9rem;justify-content:start;pointer-events:none;position:absolute;transition:opacity 125ms;width:1.2rem}[dir=rtl] .md-typeset .tabbed-control{transform:rotate(180deg)}.md-typeset .tabbed-control[hidden]{opacity:0}.md-typeset .tabbed-control--next{background:linear-gradient(to left,var(--md-default-bg-color) 60%,#0000);justify-content:end;right:0}.md-typeset .tabbed-control--next .tabbed-button:after{-webkit-mask-image:var(--md-tabbed-icon--next);mask-image:var(--md-tabbed-icon--next)}@media screen and (max-width:44.984375em){[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels{margin:0 -.8rem;max-width:100vw;scroll-padding-inline-start:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels:after{content:""}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-right:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-left:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-right:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{width:2rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-left:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-right:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-left:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{width:2rem}}@media screen{.md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){color:var(--md-default-fg-color)}.md-typeset .no-js .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .no-js .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .no-js .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .no-js .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .no-js .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .no-js .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .no-js .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .no-js .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .no-js .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .no-js .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .no-js .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .no-js .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .no-js .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .no-js .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .no-js .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .no-js .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .no-js .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .no-js .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .no-js .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .no-js .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.no-js .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.no-js .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.no-js .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.no-js .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.no-js .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.no-js .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.no-js .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.no-js .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.no-js .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.no-js .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.no-js .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.no-js .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.no-js .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.no-js .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.no-js .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.no-js .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.no-js .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.no-js .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.no-js .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.no-js .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){border-color:var(--md-default-fg-color)}}.md-typeset .tabbed-set>input:first-child.focus-visible~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10).focus-visible~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11).focus-visible~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12).focus-visible~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13).focus-visible~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14).focus-visible~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15).focus-visible~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16).focus-visible~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17).focus-visible~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18).focus-visible~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19).focus-visible~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2).focus-visible~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20).focus-visible~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3).focus-visible~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4).focus-visible~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5).focus-visible~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6).focus-visible~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7).focus-visible~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8).focus-visible~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9).focus-visible~.tabbed-labels>:nth-child(9){color:var(--md-accent-fg-color)}.md-typeset .tabbed-set>input:first-child:checked~.tabbed-content>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-content>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-content>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-content>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-content>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-content>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-content>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-content>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-content>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-content>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-content>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-content>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-content>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-content>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-content>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-content>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-content>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-content>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-content>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-content>:nth-child(9){display:block}:root{--md-tasklist-icon:url('data:image/svg+xml;charset=utf-8,');--md-tasklist-icon--checked:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .task-list-item{list-style-type:none;position:relative}[dir=ltr] .md-typeset .task-list-item [type=checkbox]{left:-2em}[dir=rtl] .md-typeset .task-list-item [type=checkbox]{right:-2em}.md-typeset .task-list-item [type=checkbox]{position:absolute;top:.45em}.md-typeset .task-list-control [type=checkbox]{opacity:0;z-index:-1}[dir=ltr] .md-typeset .task-list-indicator:before{left:-1.5em}[dir=rtl] .md-typeset .task-list-indicator:before{right:-1.5em}.md-typeset .task-list-indicator:before{background-color:var(--md-default-fg-color--lightest);content:"";height:1.25em;-webkit-mask-image:var(--md-tasklist-icon);mask-image:var(--md-tasklist-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.15em;width:1.25em}.md-typeset [type=checkbox]:checked+.task-list-indicator:before{background-color:#00e676;-webkit-mask-image:var(--md-tasklist-icon--checked);mask-image:var(--md-tasklist-icon--checked)}:root>*{--md-mermaid-font-family:var(--md-text-font-family),sans-serif;--md-mermaid-edge-color:var(--md-code-fg-color);--md-mermaid-node-bg-color:var(--md-accent-fg-color--transparent);--md-mermaid-node-fg-color:var(--md-accent-fg-color);--md-mermaid-label-bg-color:var(--md-default-bg-color);--md-mermaid-label-fg-color:var(--md-code-fg-color);--md-mermaid-sequence-actor-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actor-fg-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-actor-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-actor-line-color:var(--md-default-fg-color--lighter);--md-mermaid-sequence-actorman-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actorman-line-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-box-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-box-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-label-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-label-fg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-loop-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-loop-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-loop-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-message-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-message-line-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-note-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-border-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-number-bg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-number-fg-color:var(--md-accent-bg-color)}.mermaid{line-height:normal;margin:1em 0}.md-typeset .grid{grid-gap:.4rem;display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,16rem),1fr));margin:1em 0}.md-typeset .grid.cards>ol,.md-typeset .grid.cards>ul{display:contents}.md-typeset .grid.cards>ol>li,.md-typeset .grid.cards>ul>li,.md-typeset .grid>.card{border:.05rem solid var(--md-default-fg-color--lightest);border-radius:.1rem;display:block;margin:0;padding:.8rem;transition:border .25s,box-shadow .25s}.md-typeset .grid.cards>ol>li:focus-within,.md-typeset .grid.cards>ol>li:hover,.md-typeset .grid.cards>ul>li:focus-within,.md-typeset .grid.cards>ul>li:hover,.md-typeset .grid>.card:focus-within,.md-typeset .grid>.card:hover{border-color:#0000;box-shadow:var(--md-shadow-z2)}.md-typeset .grid.cards>ol>li>hr,.md-typeset .grid.cards>ul>li>hr,.md-typeset .grid>.card>hr{margin-bottom:1em;margin-top:1em}.md-typeset .grid.cards>ol>li>:first-child,.md-typeset .grid.cards>ul>li>:first-child,.md-typeset .grid>.card>:first-child{margin-top:0}.md-typeset .grid.cards>ol>li>:last-child,.md-typeset .grid.cards>ul>li>:last-child,.md-typeset .grid>.card>:last-child{margin-bottom:0}.md-typeset .grid>*,.md-typeset .grid>.admonition,.md-typeset .grid>.highlight>*,.md-typeset .grid>.highlighttable,.md-typeset .grid>.md-typeset details,.md-typeset .grid>details,.md-typeset .grid>pre{margin-bottom:0;margin-top:0}.md-typeset .grid>.highlight>pre:only-child,.md-typeset .grid>.highlight>pre>code,.md-typeset .grid>.highlighttable,.md-typeset .grid>.highlighttable>tbody,.md-typeset .grid>.highlighttable>tbody>tr,.md-typeset .grid>.highlighttable>tbody>tr>.code,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre>code{height:100%}.md-typeset .grid>.tabbed-set{margin-bottom:0;margin-top:0}@media screen and (min-width:45em){[dir=ltr] .md-typeset .inline{float:left}[dir=rtl] .md-typeset .inline{float:right}[dir=ltr] .md-typeset .inline{margin-right:.8rem}[dir=rtl] .md-typeset .inline{margin-left:.8rem}.md-typeset .inline{margin-bottom:.8rem;margin-top:0;width:11.7rem}[dir=ltr] .md-typeset .inline.end{float:right}[dir=rtl] .md-typeset .inline.end{float:left}[dir=ltr] .md-typeset .inline.end{margin-left:.8rem;margin-right:0}[dir=rtl] .md-typeset .inline.end{margin-left:0;margin-right:.8rem}} \ No newline at end of file diff --git a/1.3.0/assets/stylesheets/main.7e359304.min.css.map b/1.3.0/assets/stylesheets/main.7e359304.min.css.map new file mode 100644 index 00000000..15b8fcf1 --- /dev/null +++ b/1.3.0/assets/stylesheets/main.7e359304.min.css.map @@ -0,0 +1 @@ +{"version":3,"sources":["src/templates/assets/stylesheets/main/components/_meta.scss","../../../../src/templates/assets/stylesheets/main.scss","src/templates/assets/stylesheets/main/_resets.scss","src/templates/assets/stylesheets/main/_colors.scss","src/templates/assets/stylesheets/main/_icons.scss","src/templates/assets/stylesheets/main/_typeset.scss","src/templates/assets/stylesheets/utilities/_break.scss","src/templates/assets/stylesheets/main/components/_author.scss","src/templates/assets/stylesheets/main/components/_banner.scss","src/templates/assets/stylesheets/main/components/_base.scss","src/templates/assets/stylesheets/main/components/_clipboard.scss","src/templates/assets/stylesheets/main/components/_consent.scss","src/templates/assets/stylesheets/main/components/_content.scss","src/templates/assets/stylesheets/main/components/_dialog.scss","src/templates/assets/stylesheets/main/components/_feedback.scss","src/templates/assets/stylesheets/main/components/_footer.scss","src/templates/assets/stylesheets/main/components/_form.scss","src/templates/assets/stylesheets/main/components/_header.scss","node_modules/material-design-color/material-color.scss","src/templates/assets/stylesheets/main/components/_nav.scss","src/templates/assets/stylesheets/main/components/_pagination.scss","src/templates/assets/stylesheets/main/components/_post.scss","src/templates/assets/stylesheets/main/components/_progress.scss","src/templates/assets/stylesheets/main/components/_search.scss","src/templates/assets/stylesheets/main/components/_select.scss","src/templates/assets/stylesheets/main/components/_sidebar.scss","src/templates/assets/stylesheets/main/components/_source.scss","src/templates/assets/stylesheets/main/components/_status.scss","src/templates/assets/stylesheets/main/components/_tabs.scss","src/templates/assets/stylesheets/main/components/_tag.scss","src/templates/assets/stylesheets/main/components/_tooltip.scss","src/templates/assets/stylesheets/main/components/_top.scss","src/templates/assets/stylesheets/main/components/_version.scss","src/templates/assets/stylesheets/main/extensions/markdown/_admonition.scss","src/templates/assets/stylesheets/main/extensions/markdown/_footnotes.scss","src/templates/assets/stylesheets/main/extensions/markdown/_toc.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_arithmatex.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_critic.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_details.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_emoji.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_highlight.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_keys.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tabbed.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tasklist.scss","src/templates/assets/stylesheets/main/integrations/_mermaid.scss","src/templates/assets/stylesheets/main/modifiers/_grid.scss","src/templates/assets/stylesheets/main/modifiers/_inline.scss"],"names":[],"mappings":"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E,oEACE,0BhCmwGJ,CgChwGI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ChCkwGN,CgC9vGI,gFACE,ahCgwGN,CgCrxGE,8DACE,oBhCwxGJ,CgCrxGI,wFACE,gChCuxGN,CgClxGE,sEACE,0BhCqxGJ,CgClxGI,oFACE,wBAlBG,CAmBH,sDAAA,CAAA,8ChCoxGN,CgChxGI,kFACE,ahCkxGN,CgCvyGE,4DACE,oBhC0yGJ,CgCvyGI,sFACE,gChCyyGN,CgCpyGE,oEACE,0BhCuyGJ,CgCpyGI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ChCsyGN,CgClyGI,gFACE,ahCoyGN,CgCzzGE,4DACE,oBhC4zGJ,CgCzzGI,sFACE,gChC2zGN,CgCtzGE,oEACE,0BhCyzGJ,CgCtzGI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ChCwzGN,CgCpzGI,gFACE,ahCszGN,CgC30GE,0DACE,oBhC80GJ,CgC30GI,oFACE,gChC60GN,CgCx0GE,kEACE,0BhC20GJ,CgCx0GI,gFACE,wBAlBG,CAmBH,oDAAA,CAAA,4ChC00GN,CgCt0GI,8EACE,ahCw0GN,CgC71GE,oDACE,oBhCg2GJ,CgC71GI,8EACE,gChC+1GN,CgC11GE,4DACE,0BhC61GJ,CgC11GI,0EACE,wBAlBG,CAmBH,iDAAA,CAAA,yChC41GN,CgCx1GI,wEACE,ahC01GN,CgC/2GE,4DACE,oBhCk3GJ,CgC/2GI,sFACE,gChCi3GN,CgC52GE,oEACE,0BhC+2GJ,CgC52GI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ChC82GN,CgC12GI,gFACE,ahC42GN,CgCj4GE,wDACE,oBhCo4GJ,CgCj4GI,kFACE,gChCm4GN,CgC93GE,gEACE,0BhCi4GJ,CgC93GI,8EACE,wBAlBG,CAmBH,mDAAA,CAAA,2ChCg4GN,CgC53GI,4EACE,ahC83GN,CiCliHA,MACE,wMjCqiHF,CiC5hHE,sBAEE,uCAAA,CADA,gBjCgiHJ,CiC5hHI,mCACE,ajC8hHN,CiC/hHI,mCACE,cjC8hHN,CiC1hHM,4BACE,sBjC4hHR,CiCzhHQ,mCACE,gCjC2hHV,Ci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","file":"main.css"} \ No newline at end of file diff --git a/1.3.0/assets/stylesheets/main.f2e4d321.min.css b/1.3.0/assets/stylesheets/main.f2e4d321.min.css deleted file mode 100644 index 6b059f66..00000000 --- a/1.3.0/assets/stylesheets/main.f2e4d321.min.css +++ /dev/null @@ -1 +0,0 @@ -@charset "UTF-8";html{-webkit-text-size-adjust:none;-moz-text-size-adjust:none;text-size-adjust:none;box-sizing:border-box}*,:after,:before{box-sizing:inherit}@media (prefers-reduced-motion){*,:after,:before{transition:none!important}}body{margin:0}a,button,input,label{-webkit-tap-highlight-color:transparent}a{color:inherit;text-decoration:none}hr{border:0;box-sizing:initial;display:block;height:.05rem;overflow:visible;padding:0}small{font-size:80%}sub,sup{line-height:1em}img{border-style:none}table{border-collapse:initial;border-spacing:0}td,th{font-weight:400;vertical-align:top}button{background:#0000;border:0;font-family:inherit;font-size:inherit;margin:0;padding:0}input{border:0;outline:none}:root{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-scheme=default]{color-scheme:light}[data-md-color-scheme=default] img[src$="#gh-dark-mode-only"],[data-md-color-scheme=default] img[src$="#only-dark"]{display:none}:root,[data-md-color-scheme=default]{--md-hue:225deg;--md-default-fg-color:#000000de;--md-default-fg-color--light:#0000008a;--md-default-fg-color--lighter:#00000052;--md-default-fg-color--lightest:#00000012;--md-default-bg-color:#fff;--md-default-bg-color--light:#ffffffb3;--md-default-bg-color--lighter:#ffffff4d;--md-default-bg-color--lightest:#ffffff1f;--md-code-fg-color:#36464e;--md-code-bg-color:#f5f5f5;--md-code-hl-color:#4287ff;--md-code-hl-color--light:#4287ff1a;--md-code-hl-number-color:#d52a2a;--md-code-hl-special-color:#db1457;--md-code-hl-function-color:#a846b9;--md-code-hl-constant-color:#6e59d9;--md-code-hl-keyword-color:#3f6ec6;--md-code-hl-string-color:#1c7d4d;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-del-color:#f5503d26;--md-typeset-ins-color:#0bd57026;--md-typeset-kbd-color:#fafafa;--md-typeset-kbd-accent-color:#fff;--md-typeset-kbd-border-color:#b8b8b8;--md-typeset-mark-color:#ffff0080;--md-typeset-table-color:#0000001f;--md-typeset-table-color--light:rgba(0,0,0,.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-warning-fg-color:#000000de;--md-warning-bg-color:#ff9;--md-footer-fg-color:#fff;--md-footer-fg-color--light:#ffffffb3;--md-footer-fg-color--lighter:#ffffff73;--md-footer-bg-color:#000000de;--md-footer-bg-color--dark:#00000052;--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #0000001a,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0003,0 0 0.05rem #00000059}.md-icon svg{fill:currentcolor;display:block;height:1.2rem;width:1.2rem}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;--md-text-font-family:var(--md-text-font,_),-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;--md-code-font-family:var(--md-code-font,_),SFMono-Regular,Consolas,Menlo,monospace}aside,body,input{font-feature-settings:"kern","liga";color:var(--md-typeset-color);font-family:var(--md-text-font-family)}code,kbd,pre{font-feature-settings:"kern";font-family:var(--md-code-font-family)}:root{--md-typeset-table-sort-icon:url('data:image/svg+xml;charset=utf-8,');--md-typeset-table-sort-icon--asc:url('data:image/svg+xml;charset=utf-8,');--md-typeset-table-sort-icon--desc:url('data:image/svg+xml;charset=utf-8,')}.md-typeset{-webkit-print-color-adjust:exact;color-adjust:exact;font-size:.8rem;line-height:1.6}@media print{.md-typeset{font-size:.68rem}}.md-typeset blockquote,.md-typeset dl,.md-typeset figure,.md-typeset ol,.md-typeset pre,.md-typeset ul{margin-bottom:1em;margin-top:1em}.md-typeset h1{color:var(--md-default-fg-color--light);font-size:2em;line-height:1.3;margin:0 0 1.25em}.md-typeset h1,.md-typeset h2{font-weight:300;letter-spacing:-.01em}.md-typeset h2{font-size:1.5625em;line-height:1.4;margin:1.6em 0 .64em}.md-typeset h3{font-size:1.25em;font-weight:400;letter-spacing:-.01em;line-height:1.5;margin:1.6em 0 .8em}.md-typeset h2+h3{margin-top:.8em}.md-typeset h4{font-weight:700;letter-spacing:-.01em;margin:1em 0}.md-typeset h5,.md-typeset h6{color:var(--md-default-fg-color--light);font-size:.8em;font-weight:700;letter-spacing:-.01em;margin:1.25em 0}.md-typeset h5{text-transform:uppercase}.md-typeset hr{border-bottom:.05rem solid var(--md-default-fg-color--lightest);display:flow-root;margin:1.5em 0}.md-typeset a{color:var(--md-typeset-a-color);word-break:break-word}.md-typeset a,.md-typeset a:before{transition:color 125ms}.md-typeset a:focus,.md-typeset a:hover{color:var(--md-accent-fg-color)}.md-typeset a:focus code,.md-typeset a:hover code{background-color:var(--md-accent-fg-color--transparent)}.md-typeset a code{color:currentcolor;transition:background-color 125ms}.md-typeset a.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset code,.md-typeset kbd,.md-typeset pre{color:var(--md-code-fg-color);direction:ltr;font-variant-ligatures:none}@media print{.md-typeset code,.md-typeset kbd,.md-typeset pre{white-space:pre-wrap}}.md-typeset code{background-color:var(--md-code-bg-color);border-radius:.1rem;-webkit-box-decoration-break:clone;box-decoration-break:clone;font-size:.85em;padding:0 .2941176471em;word-break:break-word}.md-typeset code:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-typeset pre{display:flow-root;line-height:1.4;position:relative}.md-typeset pre>code{-webkit-box-decoration-break:slice;box-decoration-break:slice;box-shadow:none;display:block;margin:0;outline-color:var(--md-accent-fg-color);overflow:auto;padding:.7720588235em 1.1764705882em;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin;touch-action:auto;word-break:normal}.md-typeset pre>code:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-typeset pre>code::-webkit-scrollbar{height:.2rem;width:.2rem}.md-typeset pre>code::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-typeset pre>code::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}.md-typeset kbd{background-color:var(--md-typeset-kbd-color);border-radius:.1rem;box-shadow:0 .1rem 0 .05rem var(--md-typeset-kbd-border-color),0 .1rem 0 var(--md-typeset-kbd-border-color),0 -.1rem .2rem var(--md-typeset-kbd-accent-color) inset;color:var(--md-default-fg-color);display:inline-block;font-size:.75em;padding:0 .6666666667em;vertical-align:text-top;word-break:break-word}.md-typeset mark{background-color:var(--md-typeset-mark-color);-webkit-box-decoration-break:clone;box-decoration-break:clone;color:inherit;word-break:break-word}.md-typeset abbr{border-bottom:.05rem dotted var(--md-default-fg-color--light);cursor:help;text-decoration:none}.md-typeset small{opacity:.75}[dir=ltr] .md-typeset sub,[dir=ltr] .md-typeset sup{margin-left:.078125em}[dir=rtl] .md-typeset sub,[dir=rtl] .md-typeset sup{margin-right:.078125em}[dir=ltr] .md-typeset blockquote{padding-left:.6rem}[dir=rtl] .md-typeset blockquote{padding-right:.6rem}[dir=ltr] .md-typeset blockquote{border-left:.2rem solid var(--md-default-fg-color--lighter)}[dir=rtl] .md-typeset blockquote{border-right:.2rem solid var(--md-default-fg-color--lighter)}.md-typeset blockquote{color:var(--md-default-fg-color--light);margin-left:0;margin-right:0}.md-typeset ul{list-style-type:disc}[dir=ltr] .md-typeset ol,[dir=ltr] .md-typeset ul{margin-left:.625em}[dir=rtl] .md-typeset ol,[dir=rtl] .md-typeset ul{margin-right:.625em}.md-typeset ol,.md-typeset ul{padding:0}.md-typeset ol:not([hidden]),.md-typeset ul:not([hidden]){display:flow-root}.md-typeset ol ol,.md-typeset ul ol{list-style-type:lower-alpha}.md-typeset ol ol ol,.md-typeset ul ol ol{list-style-type:lower-roman}[dir=ltr] .md-typeset ol li,[dir=ltr] .md-typeset ul li{margin-left:1.25em}[dir=rtl] .md-typeset ol li,[dir=rtl] .md-typeset ul li{margin-right:1.25em}.md-typeset ol li,.md-typeset ul li{margin-bottom:.5em}.md-typeset ol li blockquote,.md-typeset ol li p,.md-typeset ul li blockquote,.md-typeset ul li p{margin:.5em 0}.md-typeset ol li:last-child,.md-typeset ul li:last-child{margin-bottom:0}[dir=ltr] .md-typeset ol li ol,[dir=ltr] .md-typeset ol li ul,[dir=ltr] .md-typeset ul li ol,[dir=ltr] .md-typeset ul li ul{margin-left:.625em}[dir=rtl] .md-typeset ol li ol,[dir=rtl] .md-typeset ol li ul,[dir=rtl] .md-typeset ul li ol,[dir=rtl] .md-typeset ul li ul{margin-right:.625em}.md-typeset ol li ol,.md-typeset ol li ul,.md-typeset ul li ol,.md-typeset ul li ul{margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset dd{margin-left:1.875em}[dir=rtl] .md-typeset dd{margin-right:1.875em}.md-typeset dd{margin-bottom:1.5em;margin-top:1em}.md-typeset img,.md-typeset svg,.md-typeset video{height:auto;max-width:100%}.md-typeset img[align=left]{margin:1em 1em 1em 0}.md-typeset img[align=right]{margin:1em 0 1em 1em}.md-typeset img[align]:only-child{margin-top:0}.md-typeset figure{display:flow-root;margin:1em auto;max-width:100%;text-align:center;width:-webkit-fit-content;width:-moz-fit-content;width:fit-content}.md-typeset figure img{display:block;margin:0 auto}.md-typeset figcaption{font-style:italic;margin:1em auto;max-width:24rem}.md-typeset iframe{max-width:100%}.md-typeset table:not([class]){background-color:var(--md-default-bg-color);border:.05rem solid var(--md-typeset-table-color);border-radius:.1rem;display:inline-block;font-size:.64rem;max-width:100%;overflow:auto;touch-action:auto}@media print{.md-typeset table:not([class]){display:table}}.md-typeset table:not([class])+*{margin-top:1.5em}.md-typeset table:not([class]) td>:first-child,.md-typeset table:not([class]) th>:first-child{margin-top:0}.md-typeset table:not([class]) td>:last-child,.md-typeset table:not([class]) th>:last-child{margin-bottom:0}.md-typeset table:not([class]) td:not([align]),.md-typeset table:not([class]) th:not([align]){text-align:left}[dir=rtl] .md-typeset table:not([class]) td:not([align]),[dir=rtl] .md-typeset table:not([class]) th:not([align]){text-align:right}.md-typeset table:not([class]) th{font-weight:700;min-width:5rem;padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) td{border-top:.05rem solid var(--md-typeset-table-color);padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) tbody tr{transition:background-color 125ms}.md-typeset table:not([class]) tbody tr:hover{background-color:var(--md-typeset-table-color--light);box-shadow:0 .05rem 0 var(--md-default-bg-color) inset}.md-typeset table:not([class]) a{word-break:normal}.md-typeset table th[role=columnheader]{cursor:pointer}[dir=ltr] .md-typeset table th[role=columnheader]:after{margin-left:.5em}[dir=rtl] .md-typeset table th[role=columnheader]:after{margin-right:.5em}.md-typeset table th[role=columnheader]:after{content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-typeset-table-sort-icon);mask-image:var(--md-typeset-table-sort-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset table th[role=columnheader]:hover:after{background-color:var(--md-default-fg-color--lighter)}.md-typeset table th[role=columnheader][aria-sort=ascending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--asc);mask-image:var(--md-typeset-table-sort-icon--asc)}.md-typeset table th[role=columnheader][aria-sort=descending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--desc);mask-image:var(--md-typeset-table-sort-icon--desc)}.md-typeset__scrollwrap{margin:1em -.8rem;overflow-x:auto;touch-action:auto}.md-typeset__table{display:inline-block;margin-bottom:.5em;padding:0 .8rem}@media print{.md-typeset__table{display:block}}html .md-typeset__table table{display:table;margin:0;overflow:hidden;width:100%}@media screen and (max-width:44.984375em){.md-content__inner>pre{margin:1em -.8rem}.md-content__inner>pre code{border-radius:0}}.md-typeset .md-author{border-radius:100%;display:block;flex-shrink:0;height:1.6rem;overflow:hidden;position:relative;transition:color 125ms,transform 125ms;width:1.6rem}.md-typeset .md-author img{display:block}.md-typeset .md-author--more{background:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--lighter);font-size:.6rem;font-weight:700;line-height:1.6rem;text-align:center}.md-typeset .md-author--long{height:2.4rem;width:2.4rem}.md-typeset a.md-author{transform:scale(1)}.md-typeset a.md-author img{filter:grayscale(100%) opacity(75%);transition:filter 125ms}.md-typeset a.md-author:focus,.md-typeset a.md-author:hover{transform:scale(1.1);z-index:1}.md-typeset a.md-author:focus img,.md-typeset a.md-author:hover img{filter:grayscale(0)}.md-banner{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color);overflow:auto}@media print{.md-banner{display:none}}.md-banner--warning{background-color:var(--md-warning-bg-color);color:var(--md-warning-fg-color)}.md-banner__inner{font-size:.7rem;margin:.6rem auto;padding:0 .8rem}[dir=ltr] .md-banner__button{float:right}[dir=rtl] .md-banner__button{float:left}.md-banner__button{color:inherit;cursor:pointer;transition:opacity .25s}.no-js .md-banner__button{display:none}.md-banner__button:hover{opacity:.7}html{font-size:125%;height:100%;overflow-x:hidden}@media screen and (min-width:100em){html{font-size:137.5%}}@media screen and (min-width:125em){html{font-size:150%}}body{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;font-size:.5rem;min-height:100%;position:relative;width:100%}@media print{body{display:block}}@media screen and (max-width:59.984375em){body[data-md-scrolllock]{position:fixed}}.md-grid{margin-left:auto;margin-right:auto;max-width:61rem}.md-container{display:flex;flex-direction:column;flex-grow:1}@media print{.md-container{display:block}}.md-main{flex-grow:1}.md-main__inner{display:flex;height:100%;margin-top:1.5rem}.md-ellipsis{overflow:hidden;text-overflow:ellipsis}.md-toggle{display:none}.md-option{height:0;opacity:0;position:absolute;width:0}.md-option:checked+label:not([hidden]){display:block}.md-option.focus-visible+label{outline-color:var(--md-accent-fg-color);outline-style:auto}.md-skip{background-color:var(--md-default-fg-color);border-radius:.1rem;color:var(--md-default-bg-color);font-size:.64rem;margin:.5rem;opacity:0;outline-color:var(--md-accent-fg-color);padding:.3rem .5rem;position:fixed;transform:translateY(.4rem);z-index:-1}.md-skip:focus{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 175ms 75ms;z-index:10}@page{margin:25mm}:root{--md-clipboard-icon:url('data:image/svg+xml;charset=utf-8,')}.md-clipboard{border-radius:.1rem;color:var(--md-default-fg-color--lightest);cursor:pointer;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;position:absolute;right:.5em;top:.5em;transition:color .25s;width:1.5em;z-index:1}@media print{.md-clipboard{display:none}}.md-clipboard:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}:hover>.md-clipboard{color:var(--md-default-fg-color--light)}.md-clipboard:focus,.md-clipboard:hover{color:var(--md-accent-fg-color)}.md-clipboard:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-image:var(--md-clipboard-icon);mask-image:var(--md-clipboard-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-clipboard--inline{cursor:pointer}.md-clipboard--inline code{transition:color .25s,background-color .25s}.md-clipboard--inline:focus code,.md-clipboard--inline:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}@keyframes consent{0%{opacity:0;transform:translateY(100%)}to{opacity:1;transform:translateY(0)}}@keyframes overlay{0%{opacity:0}to{opacity:1}}.md-consent__overlay{animation:overlay .25s both;-webkit-backdrop-filter:blur(.1rem);backdrop-filter:blur(.1rem);background-color:#0000008a;height:100%;opacity:1;position:fixed;top:0;width:100%;z-index:5}.md-consent__inner{animation:consent .5s cubic-bezier(.1,.7,.1,1) both;background-color:var(--md-default-bg-color);border:0;border-radius:.1rem;bottom:0;box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;max-height:100%;overflow:auto;padding:0;position:fixed;width:100%;z-index:5}.md-consent__form{padding:.8rem}.md-consent__settings{display:none;margin:1em 0}input:checked+.md-consent__settings{display:block}.md-consent__controls{margin-bottom:.8rem}.md-typeset .md-consent__controls .md-button{display:inline}@media screen and (max-width:44.984375em){.md-typeset .md-consent__controls .md-button{display:block;margin-top:.4rem;text-align:center;width:100%}}.md-consent label{cursor:pointer}.md-content{flex-grow:1;min-width:0}.md-content__inner{margin:0 .8rem 1.2rem;padding-top:.6rem}@media screen and (min-width:76.25em){[dir=ltr] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}[dir=ltr] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner,[dir=rtl] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=rtl] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}}.md-content__inner:before{content:"";display:block;height:.4rem}.md-content__inner>:last-child{margin-bottom:0}[dir=ltr] .md-content__button{float:right}[dir=rtl] .md-content__button{float:left}[dir=ltr] .md-content__button{margin-left:.4rem}[dir=rtl] .md-content__button{margin-right:.4rem}.md-content__button{margin:.4rem 0;padding:0}@media print{.md-content__button{display:none}}.md-typeset .md-content__button{color:var(--md-default-fg-color--lighter)}.md-content__button svg{display:inline;vertical-align:top}[dir=rtl] .md-content__button svg{transform:scaleX(-1)}[dir=ltr] .md-dialog{right:.8rem}[dir=rtl] .md-dialog{left:.8rem}.md-dialog{background-color:var(--md-default-fg-color);border-radius:.1rem;bottom:.8rem;box-shadow:var(--md-shadow-z3);min-width:11.1rem;opacity:0;padding:.4rem .6rem;pointer-events:none;position:fixed;transform:translateY(100%);transition:transform 0ms .4s,opacity .4s;z-index:4}@media print{.md-dialog{display:none}}.md-dialog--active{opacity:1;pointer-events:auto;transform:translateY(0);transition:transform .4s cubic-bezier(.075,.85,.175,1),opacity .4s}.md-dialog__inner{color:var(--md-default-bg-color);font-size:.7rem}.md-feedback{margin:2em 0 1em;text-align:center}.md-feedback fieldset{border:none;margin:0;padding:0}.md-feedback__title{font-weight:700;margin:1em auto}.md-feedback__inner{position:relative}.md-feedback__list{display:flex;flex-wrap:wrap;place-content:baseline center;position:relative}.md-feedback__list:hover .md-icon:not(:disabled){color:var(--md-default-fg-color--lighter)}:disabled .md-feedback__list{min-height:1.8rem}.md-feedback__icon{color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;margin:0 .1rem;transition:color 125ms}.md-feedback__icon:not(:disabled).md-icon:hover{color:var(--md-accent-fg-color)}.md-feedback__icon:disabled{color:var(--md-default-fg-color--lightest);pointer-events:none}.md-feedback__note{opacity:0;position:relative;transform:translateY(.4rem);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-feedback__note>*{margin:0 auto;max-width:16rem}:disabled .md-feedback__note{opacity:1;transform:translateY(0)}.md-footer{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color)}@media print{.md-footer{display:none}}.md-footer__inner{justify-content:space-between;overflow:auto;padding:.2rem}.md-footer__inner:not([hidden]){display:flex}.md-footer__link{align-items:end;display:flex;flex-grow:0.01;margin-bottom:.4rem;margin-top:1rem;max-width:100%;outline-color:var(--md-accent-fg-color);overflow:hidden;transition:opacity .25s}.md-footer__link:focus,.md-footer__link:hover{opacity:.7}[dir=rtl] .md-footer__link svg{transform:scaleX(-1)}@media screen and (max-width:44.984375em){.md-footer__link--prev{flex-shrink:0}.md-footer__link--prev .md-footer__title{display:none}}[dir=ltr] .md-footer__link--next{margin-left:auto}[dir=rtl] .md-footer__link--next{margin-right:auto}.md-footer__link--next{text-align:right}[dir=rtl] .md-footer__link--next{text-align:left}.md-footer__title{flex-grow:1;font-size:.9rem;margin-bottom:.7rem;max-width:calc(100% - 2.4rem);padding:0 1rem;white-space:nowrap}.md-footer__button{margin:.2rem;padding:.4rem}.md-footer__direction{font-size:.64rem;opacity:.7}.md-footer-meta{background-color:var(--md-footer-bg-color--dark)}.md-footer-meta__inner{display:flex;flex-wrap:wrap;justify-content:space-between;padding:.2rem}html .md-footer-meta.md-typeset a{color:var(--md-footer-fg-color--light)}html .md-footer-meta.md-typeset a:focus,html .md-footer-meta.md-typeset a:hover{color:var(--md-footer-fg-color)}.md-copyright{color:var(--md-footer-fg-color--lighter);font-size:.64rem;margin:auto .6rem;padding:.4rem 0;width:100%}@media screen and (min-width:45em){.md-copyright{width:auto}}.md-copyright__highlight{color:var(--md-footer-fg-color--light)}.md-social{display:inline-flex;gap:.2rem;margin:0 .4rem;padding:.2rem 0 .6rem}@media screen and (min-width:45em){.md-social{padding:.6rem 0}}.md-social__link{display:inline-block;height:1.6rem;text-align:center;width:1.6rem}.md-social__link:before{line-height:1.9}.md-social__link svg{fill:currentcolor;max-height:.8rem;vertical-align:-25%}.md-typeset .md-button{border:.1rem solid;border-radius:.1rem;color:var(--md-primary-fg-color);cursor:pointer;display:inline-block;font-weight:700;padding:.625em 2em;transition:color 125ms,background-color 125ms,border-color 125ms}.md-typeset .md-button--primary{background-color:var(--md-primary-fg-color);border-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color)}.md-typeset .md-button:focus,.md-typeset .md-button:hover{background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[dir=ltr] .md-typeset .md-input{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .md-input,[dir=rtl] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-left-radius:.1rem}.md-typeset .md-input{border-bottom:.1rem solid var(--md-default-fg-color--lighter);box-shadow:var(--md-shadow-z1);font-size:.8rem;height:1.8rem;padding:0 .6rem;transition:border .25s,box-shadow .25s}.md-typeset .md-input:focus,.md-typeset .md-input:hover{border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input--stretch{width:100%}.md-header{background-color:var(--md-primary-fg-color);box-shadow:0 0 .2rem #0000,0 .2rem .4rem #0000;color:var(--md-primary-bg-color);display:block;left:0;position:sticky;right:0;top:0;z-index:4}@media print{.md-header{display:none}}.md-header[hidden]{transform:translateY(-100%);transition:transform .25s cubic-bezier(.8,0,.6,1),box-shadow .25s}.md-header--shadow{box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;transition:transform .25s cubic-bezier(.1,.7,.1,1),box-shadow .25s}.md-header__inner{align-items:center;display:flex;padding:0 .2rem}.md-header__button{color:currentcolor;cursor:pointer;margin:.2rem;outline-color:var(--md-accent-fg-color);padding:.4rem;position:relative;transition:opacity .25s;vertical-align:middle;z-index:1}.md-header__button:hover{opacity:.7}.md-header__button:not([hidden]){display:inline-block}.md-header__button:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-header__button.md-logo{margin:.2rem;padding:.4rem}@media screen and (max-width:76.234375em){.md-header__button.md-logo{display:none}}.md-header__button.md-logo img,.md-header__button.md-logo svg{fill:currentcolor;display:block;height:1.2rem;width:auto}@media screen and (min-width:60em){.md-header__button[for=__search]{display:none}}.no-js .md-header__button[for=__search]{display:none}[dir=rtl] .md-header__button[for=__search] svg{transform:scaleX(-1)}@media screen and (min-width:76.25em){.md-header__button[for=__drawer]{display:none}}.md-header__topic{display:flex;max-width:100%;position:absolute;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;white-space:nowrap}.md-header__topic+.md-header__topic{opacity:0;pointer-events:none;transform:translateX(1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__topic+.md-header__topic{transform:translateX(-1.25rem)}.md-header__topic:first-child{font-weight:700}[dir=ltr] .md-header__title{margin-left:1rem;margin-right:.4rem}[dir=rtl] .md-header__title{margin-left:.4rem;margin-right:1rem}.md-header__title{flex-grow:1;font-size:.9rem;height:2.4rem;line-height:2.4rem}.md-header__title--active .md-header__topic{opacity:0;pointer-events:none;transform:translateX(-1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__title--active .md-header__topic{transform:translateX(1.25rem)}.md-header__title--active .md-header__topic+.md-header__topic{opacity:1;pointer-events:auto;transform:translateX(0);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;z-index:0}.md-header__title>.md-header__ellipsis{height:100%;position:relative;width:100%}.md-header__option{display:flex;flex-shrink:0;max-width:100%;transition:max-width 0ms .25s,opacity .25s .25s;white-space:nowrap}[data-md-toggle=search]:checked~.md-header .md-header__option{max-width:0;opacity:0;transition:max-width 0ms,opacity 0ms}.md-header__option>input{bottom:0}.md-header__source{display:none}@media screen and (min-width:60em){[dir=ltr] .md-header__source{margin-left:1rem}[dir=rtl] .md-header__source{margin-right:1rem}.md-header__source{display:block;max-width:11.7rem;width:11.7rem}}@media screen and (min-width:76.25em){[dir=ltr] .md-header__source{margin-left:1.4rem}[dir=rtl] .md-header__source{margin-right:1.4rem}}.md-meta{color:var(--md-default-fg-color--light);font-size:.7rem;line-height:1.3}.md-meta__list{display:inline-flex;flex-wrap:wrap;list-style:none;margin:0;padding:0}.md-meta__item:not(:last-child):after{content:"·";margin-left:.2rem;margin-right:.2rem}.md-meta__link{color:var(--md-typeset-a-color)}.md-meta__link:focus,.md-meta__link:hover{color:var(--md-accent-fg-color)}.md-draft{background-color:#ff1744;border-radius:.125em;color:#fff;display:inline-block;font-weight:700;padding-left:.5714285714em;padding-right:.5714285714em}:root{--md-nav-icon--prev:url('data:image/svg+xml;charset=utf-8,');--md-nav-icon--next:url('data:image/svg+xml;charset=utf-8,');--md-toc-icon:url('data:image/svg+xml;charset=utf-8,')}.md-nav{font-size:.7rem;line-height:1.3}.md-nav__title{color:var(--md-default-fg-color--light);display:block;font-weight:700;overflow:hidden;padding:0 .6rem;text-overflow:ellipsis}.md-nav__title .md-nav__button{display:none}.md-nav__title .md-nav__button img{height:100%;width:auto}.md-nav__title .md-nav__button.md-logo img,.md-nav__title .md-nav__button.md-logo svg{fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__list{list-style:none;margin:0;padding:0}.md-nav__link{align-items:flex-start;display:flex;gap:.4rem;margin-top:.625em;scroll-snap-align:start;transition:color 125ms}.md-nav__link--passed{color:var(--md-default-fg-color--light)}.md-nav__item .md-nav__link--active,.md-nav__item .md-nav__link--active code{color:var(--md-typeset-a-color)}.md-nav__link .md-ellipsis{position:relative}[dir=ltr] .md-nav__link .md-icon:last-child{margin-left:auto}[dir=rtl] .md-nav__link .md-icon:last-child{margin-right:auto}.md-nav__link svg{fill:currentcolor;flex-shrink:0;height:1.3em}.md-nav__link[for]:focus,.md-nav__link[for]:hover,.md-nav__link[href]:focus,.md-nav__link[href]:hover{color:var(--md-accent-fg-color);cursor:pointer}.md-nav__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-nav--primary .md-nav__link[for=__toc]{display:none}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{background-color:currentcolor;display:block;height:100%;-webkit-mask-image:var(--md-toc-icon);mask-image:var(--md-toc-icon);width:100%}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:none}.md-nav__container>.md-nav__link{margin-top:0}.md-nav__container>.md-nav__link:first-child{flex-grow:1;min-width:0}.md-nav__icon{flex-shrink:0}.md-nav__source{display:none}@media screen and (max-width:76.234375em){.md-nav--primary,.md-nav--primary .md-nav{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;height:100%;left:0;position:absolute;right:0;top:0;z-index:1}.md-nav--primary .md-nav__item,.md-nav--primary .md-nav__title{font-size:.8rem;line-height:1.5}.md-nav--primary .md-nav__title{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);cursor:pointer;height:5.6rem;line-height:2.4rem;padding:3rem .8rem .2rem;position:relative;white-space:nowrap}[dir=ltr] .md-nav--primary .md-nav__title .md-nav__icon{left:.4rem}[dir=rtl] .md-nav--primary .md-nav__title .md-nav__icon{right:.4rem}.md-nav--primary .md-nav__title .md-nav__icon{display:block;height:1.2rem;margin:.2rem;position:absolute;top:.4rem;width:1.2rem}.md-nav--primary .md-nav__title .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--prev);mask-image:var(--md-nav-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}.md-nav--primary .md-nav__title~.md-nav__list{background-color:var(--md-default-bg-color);box-shadow:0 .05rem 0 var(--md-default-fg-color--lightest) inset;overflow-y:auto;scroll-snap-type:y mandatory;touch-action:pan-y}.md-nav--primary .md-nav__title~.md-nav__list>:first-child{border-top:0}.md-nav--primary .md-nav__title[for=__drawer]{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);font-weight:700}.md-nav--primary .md-nav__title .md-logo{display:block;left:.2rem;margin:.2rem;padding:.4rem;position:absolute;right:.2rem;top:.2rem}.md-nav--primary .md-nav__list{flex:1}.md-nav--primary .md-nav__item{border-top:.05rem solid var(--md-default-fg-color--lightest)}.md-nav--primary .md-nav__item--active>.md-nav__link{color:var(--md-typeset-a-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:focus,.md-nav--primary .md-nav__item--active>.md-nav__link:hover{color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__link{margin-top:0;padding:.6rem .8rem}.md-nav--primary .md-nav__link svg{margin-top:.1em}.md-nav--primary .md-nav__link>.md-nav__link{padding:0}[dir=ltr] .md-nav--primary .md-nav__link .md-nav__icon{margin-right:-.2rem}[dir=rtl] .md-nav--primary .md-nav__link .md-nav__icon{margin-left:-.2rem}.md-nav--primary .md-nav__link .md-nav__icon{font-size:1.2rem;height:1.2rem;width:1.2rem}.md-nav--primary .md-nav__link .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-nav--primary .md-nav__icon:after{transform:scale(-1)}.md-nav--primary .md-nav--secondary .md-nav{background-color:initial;position:static}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-left:1.4rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-right:1.4rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-left:2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-right:2rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-left:2.6rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-right:2.6rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-left:3.2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-right:3.2rem}.md-nav--secondary{background-color:initial}.md-nav__toggle~.md-nav{display:flex;opacity:0;transform:translateX(100%);transition:transform .25s cubic-bezier(.8,0,.6,1),opacity 125ms 50ms}[dir=rtl] .md-nav__toggle~.md-nav{transform:translateX(-100%)}.md-nav__toggle:checked~.md-nav{opacity:1;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 125ms 125ms}.md-nav__toggle:checked~.md-nav>.md-nav__list{-webkit-backface-visibility:hidden;backface-visibility:hidden}}@media screen and (max-width:59.984375em){.md-nav--primary .md-nav__link[for=__toc]{display:flex}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--primary .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:flex}.md-nav__source{background-color:var(--md-primary-fg-color--dark);color:var(--md-primary-bg-color);display:block;padding:0 .2rem}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-nav--integrated .md-nav__link[for=__toc]{display:flex}.md-nav--integrated .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--integrated .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--integrated .md-nav__link[for=__toc]~.md-nav{display:flex}}@media screen and (min-width:60em){.md-nav{margin-bottom:-.4rem}.md-nav--secondary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--secondary .md-nav__title[for=__toc]{scroll-snap-align:start}.md-nav--secondary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--secondary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--secondary .md-nav__list{padding-right:.6rem}.md-nav--secondary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--secondary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--secondary .md-nav__item>.md-nav__link{margin-left:.4rem}}@media screen and (min-width:76.25em){.md-nav{margin-bottom:-.4rem;transition:max-height .25s cubic-bezier(.86,0,.07,1)}.md-nav--primary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--primary .md-nav__title[for=__drawer]{scroll-snap-align:start}.md-nav--primary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--primary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--primary .md-nav__list{padding-right:.6rem}.md-nav--primary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--primary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--primary .md-nav__item>.md-nav__link{margin-left:.4rem}.md-nav__toggle~.md-nav{display:grid;grid-template-rows:0fr;opacity:0;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .25s,visibility 0ms .25s;visibility:collapse}.md-nav__toggle~.md-nav>.md-nav__list{overflow:hidden}.md-nav__toggle.md-toggle--indeterminate~.md-nav,.md-nav__toggle:checked~.md-nav{grid-template-rows:1fr;opacity:1;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .15s .1s,visibility 0ms;visibility:visible}.md-nav__toggle.md-toggle--indeterminate~.md-nav{transition:none}.md-nav__item--nested>.md-nav>.md-nav__title{display:none}.md-nav__item--section{display:block;margin:1.25em 0}.md-nav__item--section:last-child{margin-bottom:0}.md-nav__item--section>.md-nav__link{font-weight:700}.md-nav__item--section>.md-nav__link[for]{color:var(--md-default-fg-color--light)}.md-nav__item--section>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav__item--section>.md-nav__link .md-icon,.md-nav__item--section>.md-nav__link>[for]{display:none}[dir=ltr] .md-nav__item--section>.md-nav{margin-left:-.6rem}[dir=rtl] .md-nav__item--section>.md-nav{margin-right:-.6rem}.md-nav__item--section>.md-nav{display:block;opacity:1;visibility:visible}.md-nav__item--section>.md-nav>.md-nav__list>.md-nav__item{padding:0}.md-nav__icon{border-radius:100%;height:.9rem;transition:background-color .25s;width:.9rem}.md-nav__icon:hover{background-color:var(--md-accent-fg-color--transparent)}.md-nav__icon:after{background-color:currentcolor;border-radius:100%;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:transform .25s;vertical-align:-.1rem;width:100%}[dir=rtl] .md-nav__icon:after{transform:rotate(180deg)}.md-nav__item--nested .md-nav__toggle:checked~.md-nav__link .md-nav__icon:after,.md-nav__item--nested .md-toggle--indeterminate~.md-nav__link .md-nav__icon:after{transform:rotate(90deg)}.md-nav--lifted>.md-nav__list>.md-nav__item,.md-nav--lifted>.md-nav__title{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active{display:block}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);margin-top:0;position:sticky;top:0;z-index:1}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active.md-nav__item--section{margin:0}[dir=ltr] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav{margin-left:-.6rem}[dir=rtl] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav{margin-right:-.6rem}.md-nav--lifted>.md-nav__list>.md-nav__item>[for]{color:var(--md-default-fg-color--light)}.md-nav--lifted .md-nav[data-md-level="1"]{grid-template-rows:1fr;opacity:1;visibility:visible}.md-nav--integrated>.md-nav__list>.md-nav__item--active:not(.md-nav__item--nested){padding:0 .6rem}.md-nav--integrated>.md-nav__list>.md-nav__item--active:not(.md-nav__item--nested)>.md-nav__link{padding:0}[dir=ltr] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-left:.05rem solid var(--md-primary-fg-color)}[dir=rtl] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-right:.05rem solid var(--md-primary-fg-color)}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{display:block;margin-bottom:1.25em;opacity:1;visibility:visible}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__list{overflow:visible;padding-bottom:0}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__title{display:none}}.md-pagination{font-size:.8rem;font-weight:700;gap:.4rem}.md-pagination,.md-pagination>*{align-items:center;display:flex;justify-content:center}.md-pagination>*{border-radius:.2rem;height:1.8rem;min-width:1.8rem;text-align:center}.md-pagination__current{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light)}.md-pagination__link{transition:color 125ms,background-color 125ms}.md-pagination__link:focus,.md-pagination__link:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-pagination__link:focus svg,.md-pagination__link:hover svg{color:var(--md-accent-fg-color)}.md-pagination__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-pagination__link svg{fill:currentcolor;color:var(--md-default-fg-color--lighter);display:block;max-height:100%;width:1.2rem}.md-post__back{border-bottom:.05rem solid var(--md-default-fg-color--lightest);margin-bottom:1.2rem;padding-bottom:1.2rem}@media screen and (max-width:76.234375em){.md-post__back{display:none}}[dir=rtl] .md-post__back svg{transform:scaleX(-1)}.md-post__authors{display:flex;flex-direction:column;gap:.6rem;margin:0 .6rem 1.2rem}.md-post .md-post__meta a{transition:color 125ms}.md-post .md-post__meta a:focus,.md-post .md-post__meta a:hover{color:var(--md-accent-fg-color)}.md-post__title{color:var(--md-default-fg-color--light);font-weight:700}.md-post--excerpt{margin-bottom:3.2rem}.md-post--excerpt .md-post__header{align-items:center;display:flex;gap:.6rem;min-height:1.6rem}.md-post--excerpt .md-post__authors{align-items:center;display:inline-flex;flex-direction:row;gap:.2rem;margin:0;min-height:2.4rem}[dir=ltr] .md-post--excerpt .md-post__meta .md-meta__list{margin-right:.4rem}[dir=rtl] .md-post--excerpt .md-post__meta .md-meta__list{margin-left:.4rem}.md-post--excerpt .md-post__content>:first-child{--md-scroll-margin:6rem;margin-top:0}.md-post>.md-nav--secondary{margin:1em 0}.md-profile{align-items:center;display:flex;font-size:.7rem;gap:.6rem;line-height:1.4;width:100%}.md-profile__description{flex-grow:1}.md-content--post{display:flex}@media screen and (max-width:76.234375em){.md-content--post{flex-flow:column-reverse}}.md-content--post>.md-content__inner{min-width:0}@media screen and (min-width:76.25em){[dir=ltr] .md-content--post>.md-content__inner{margin-left:1.2rem}[dir=rtl] .md-content--post>.md-content__inner{margin-right:1.2rem}}@media screen and (max-width:76.234375em){.md-sidebar.md-sidebar--post{padding:0;position:static;width:100%}.md-sidebar.md-sidebar--post .md-sidebar__scrollwrap{overflow:visible}.md-sidebar.md-sidebar--post .md-sidebar__inner{padding:0}.md-sidebar.md-sidebar--post .md-post__meta{margin-left:.6rem;margin-right:.6rem}.md-sidebar.md-sidebar--post .md-nav__item{border:none;display:inline}.md-sidebar.md-sidebar--post .md-nav__list{display:inline-flex;flex-wrap:wrap;gap:.6rem;padding-bottom:.6rem;padding-top:.6rem}.md-sidebar.md-sidebar--post .md-nav__link{padding:0}.md-sidebar.md-sidebar--post .md-nav{height:auto;margin-bottom:0;position:static}}:root{--md-progress-value:0;--md-progress-delay:400ms}.md-progress{background:var(--md-primary-bg-color);height:.075rem;opacity:min(clamp(0,var(--md-progress-value),1),clamp(0,100 - var(--md-progress-value),1));position:fixed;top:0;transform:scaleX(calc(var(--md-progress-value)*1%));transform-origin:left;transition:transform .5s cubic-bezier(.19,1,.22,1),opacity .25s var(--md-progress-delay);width:100%;z-index:4}:root{--md-search-result-icon:url('data:image/svg+xml;charset=utf-8,')}.md-search{position:relative}@media screen and (min-width:60em){.md-search{padding:.2rem 0}}.no-js .md-search{display:none}.md-search__overlay{opacity:0;z-index:1}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__overlay{left:-2.2rem}[dir=rtl] .md-search__overlay{right:-2.2rem}.md-search__overlay{background-color:var(--md-default-bg-color);border-radius:1rem;height:2rem;overflow:hidden;pointer-events:none;position:absolute;top:-1rem;transform-origin:center;transition:transform .3s .1s,opacity .2s .2s;width:2rem}[data-md-toggle=search]:checked~.md-header .md-search__overlay{opacity:1;transition:transform .4s,opacity .1s}}@media screen and (min-width:60em){[dir=ltr] .md-search__overlay{left:0}[dir=rtl] .md-search__overlay{right:0}.md-search__overlay{background-color:#0000008a;cursor:pointer;height:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0}[data-md-toggle=search]:checked~.md-header .md-search__overlay{height:200vh;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@media screen and (max-width:29.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(45)}}@media screen and (min-width:30em) and (max-width:44.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(60)}}@media screen and (min-width:45em) and (max-width:59.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(75)}}.md-search__inner{-webkit-backface-visibility:hidden;backface-visibility:hidden}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__inner{left:0}[dir=rtl] .md-search__inner{right:0}.md-search__inner{height:0;opacity:0;overflow:hidden;position:fixed;top:0;transform:translateX(5%);transition:width 0ms .3s,height 0ms .3s,transform .15s cubic-bezier(.4,0,.2,1) .15s,opacity .15s .15s;width:0;z-index:2}[dir=rtl] .md-search__inner{transform:translateX(-5%)}[data-md-toggle=search]:checked~.md-header .md-search__inner{height:100%;opacity:1;transform:translateX(0);transition:width 0ms 0ms,height 0ms 0ms,transform .15s cubic-bezier(.1,.7,.1,1) .15s,opacity .15s .15s;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__inner{float:right}[dir=rtl] .md-search__inner{float:left}.md-search__inner{padding:.1rem 0;position:relative;transition:width .25s cubic-bezier(.1,.7,.1,1);width:11.7rem}}@media screen and (min-width:60em) and (max-width:76.234375em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:23.4rem}}@media screen and (min-width:76.25em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:34.4rem}}.md-search__form{background-color:var(--md-default-bg-color);box-shadow:0 0 .6rem #0000;height:2.4rem;position:relative;transition:color .25s,background-color .25s;z-index:2}@media screen and (min-width:60em){.md-search__form{background-color:#00000042;border-radius:.1rem;height:1.8rem}.md-search__form:hover{background-color:#ffffff1f}}[data-md-toggle=search]:checked~.md-header .md-search__form{background-color:var(--md-default-bg-color);border-radius:.1rem .1rem 0 0;box-shadow:0 0 .6rem #00000012;color:var(--md-default-fg-color)}[dir=ltr] .md-search__input{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__input{padding-left:2.2rem;padding-right:3.6rem}.md-search__input{background:#0000;font-size:.9rem;height:100%;position:relative;text-overflow:ellipsis;width:100%;z-index:2}.md-search__input::placeholder{transition:color .25s}.md-search__input::placeholder,.md-search__input~.md-search__icon{color:var(--md-default-fg-color--light)}.md-search__input::-ms-clear{display:none}@media screen and (max-width:59.984375em){.md-search__input{font-size:.9rem;height:2.4rem;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__input{padding-left:2.2rem}[dir=rtl] .md-search__input{padding-right:2.2rem}.md-search__input{color:inherit;font-size:.8rem}.md-search__input::placeholder{color:var(--md-primary-bg-color--light)}.md-search__input+.md-search__icon{color:var(--md-primary-bg-color)}[data-md-toggle=search]:checked~.md-header .md-search__input{text-overflow:clip}[data-md-toggle=search]:checked~.md-header .md-search__input+.md-search__icon{color:var(--md-default-fg-color--light)}[data-md-toggle=search]:checked~.md-header .md-search__input::placeholder{color:#0000}}.md-search__icon{cursor:pointer;display:inline-block;height:1.2rem;transition:color .25s,opacity .25s;width:1.2rem}.md-search__icon:hover{opacity:.7}[dir=ltr] .md-search__icon[for=__search]{left:.5rem}[dir=rtl] .md-search__icon[for=__search]{right:.5rem}.md-search__icon[for=__search]{position:absolute;top:.3rem;z-index:2}[dir=rtl] .md-search__icon[for=__search] svg{transform:scaleX(-1)}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__icon[for=__search]{left:.8rem}[dir=rtl] .md-search__icon[for=__search]{right:.8rem}.md-search__icon[for=__search]{top:.6rem}.md-search__icon[for=__search] svg:first-child{display:none}}@media screen and (min-width:60em){.md-search__icon[for=__search]{pointer-events:none}.md-search__icon[for=__search] svg:last-child{display:none}}[dir=ltr] .md-search__options{right:.5rem}[dir=rtl] .md-search__options{left:.5rem}.md-search__options{pointer-events:none;position:absolute;top:.3rem;z-index:2}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__options{right:.8rem}[dir=rtl] .md-search__options{left:.8rem}.md-search__options{top:.6rem}}[dir=ltr] .md-search__options>.md-icon{margin-left:.2rem}[dir=rtl] .md-search__options>.md-icon{margin-right:.2rem}.md-search__options>.md-icon{color:var(--md-default-fg-color--light);opacity:0;transform:scale(.75);transition:transform .15s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-search__options>.md-icon:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon{opacity:1;pointer-events:auto;transform:scale(1)}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon:hover{opacity:.7}[dir=ltr] .md-search__suggest{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__suggest{padding-left:2.2rem;padding-right:3.6rem}.md-search__suggest{align-items:center;color:var(--md-default-fg-color--lighter);display:flex;font-size:.9rem;height:100%;opacity:0;position:absolute;top:0;transition:opacity 50ms;white-space:nowrap;width:100%}@media screen and (min-width:60em){[dir=ltr] .md-search__suggest{padding-left:2.2rem}[dir=rtl] .md-search__suggest{padding-right:2.2rem}.md-search__suggest{font-size:.8rem}}[data-md-toggle=search]:checked~.md-header .md-search__suggest{opacity:1;transition:opacity .3s .1s}[dir=ltr] .md-search__output{border-bottom-left-radius:.1rem}[dir=ltr] .md-search__output,[dir=rtl] .md-search__output{border-bottom-right-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-left-radius:.1rem}.md-search__output{overflow:hidden;position:absolute;width:100%;z-index:1}@media screen and (max-width:59.984375em){.md-search__output{bottom:0;top:2.4rem}}@media screen and (min-width:60em){.md-search__output{opacity:0;top:1.9rem;transition:opacity .4s}[data-md-toggle=search]:checked~.md-header .md-search__output{box-shadow:var(--md-shadow-z3);opacity:1}}.md-search__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);height:100%;overflow-y:auto;touch-action:pan-y}@media (-webkit-max-device-pixel-ratio:1),(max-resolution:1dppx){.md-search__scrollwrap{transform:translateZ(0)}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-search__scrollwrap{width:23.4rem}}@media screen and (min-width:76.25em){.md-search__scrollwrap{width:34.4rem}}@media screen and (min-width:60em){.md-search__scrollwrap{max-height:0;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}[data-md-toggle=search]:checked~.md-header .md-search__scrollwrap{max-height:75vh}.md-search__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-search__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-search__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-search__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}}.md-search-result{color:var(--md-default-fg-color);word-break:break-word}.md-search-result__meta{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.8rem;padding:0 .8rem;scroll-snap-align:start}@media screen and (min-width:60em){[dir=ltr] .md-search-result__meta{padding-left:2.2rem}[dir=rtl] .md-search-result__meta{padding-right:2.2rem}}.md-search-result__list{list-style:none;margin:0;padding:0;-webkit-user-select:none;user-select:none}.md-search-result__item{box-shadow:0 -.05rem var(--md-default-fg-color--lightest)}.md-search-result__item:first-child{box-shadow:none}.md-search-result__link{display:block;outline:none;scroll-snap-align:start;transition:background-color .25s}.md-search-result__link:focus,.md-search-result__link:hover{background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:last-child p:last-child{margin-bottom:.6rem}.md-search-result__more>summary{cursor:pointer;display:block;outline:none;position:sticky;scroll-snap-align:start;top:0;z-index:1}.md-search-result__more>summary::marker{display:none}.md-search-result__more>summary::-webkit-details-marker{display:none}.md-search-result__more>summary>div{color:var(--md-typeset-a-color);font-size:.64rem;padding:.75em .8rem;transition:color .25s,background-color .25s}@media screen and (min-width:60em){[dir=ltr] .md-search-result__more>summary>div{padding-left:2.2rem}[dir=rtl] .md-search-result__more>summary>div{padding-right:2.2rem}}.md-search-result__more>summary:focus>div,.md-search-result__more>summary:hover>div{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more[open]>summary{background-color:var(--md-default-bg-color)}.md-search-result__article{overflow:hidden;padding:0 .8rem;position:relative}@media screen and (min-width:60em){[dir=ltr] .md-search-result__article{padding-left:2.2rem}[dir=rtl] .md-search-result__article{padding-right:2.2rem}}[dir=ltr] .md-search-result__icon{left:0}[dir=rtl] .md-search-result__icon{right:0}.md-search-result__icon{color:var(--md-default-fg-color--light);height:1.2rem;margin:.5rem;position:absolute;width:1.2rem}@media screen and (max-width:59.984375em){.md-search-result__icon{display:none}}.md-search-result__icon:after{background-color:currentcolor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-search-result-icon);mask-image:var(--md-search-result-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-search-result__icon:after{transform:scaleX(-1)}.md-search-result .md-typeset{color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.6}.md-search-result .md-typeset h1{color:var(--md-default-fg-color);font-size:.8rem;font-weight:400;line-height:1.4;margin:.55rem 0}.md-search-result .md-typeset h1 mark{text-decoration:none}.md-search-result .md-typeset h2{color:var(--md-default-fg-color);font-size:.64rem;font-weight:700;line-height:1.6;margin:.5em 0}.md-search-result .md-typeset h2 mark{text-decoration:none}.md-search-result__terms{color:var(--md-default-fg-color);display:block;font-size:.64rem;font-style:italic;margin:.5em 0}.md-search-result mark{background-color:initial;color:var(--md-accent-fg-color);text-decoration:underline}.md-select{position:relative;z-index:1}.md-select__inner{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:50%;margin-top:.2rem;max-height:0;opacity:0;position:absolute;top:calc(100% - .2rem);transform:translate3d(-50%,.3rem,0);transition:transform .25s 375ms,opacity .25s .25s,max-height 0ms .5s}.md-select:focus-within .md-select__inner,.md-select:hover .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select__inner:after{border-bottom:.2rem solid #0000;border-bottom-color:var(--md-default-bg-color);border-left:.2rem solid #0000;border-right:.2rem solid #0000;border-top:0;content:"";height:0;left:50%;margin-left:-.2rem;margin-top:-.2rem;position:absolute;top:0;width:0}.md-select__list{border-radius:.1rem;font-size:.8rem;list-style-type:none;margin:0;max-height:inherit;overflow:auto;padding:0}.md-select__item{line-height:1.8rem}[dir=ltr] .md-select__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-select__link{padding-left:1.2rem;padding-right:.6rem}.md-select__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:background-color .25s,color .25s;width:100%}.md-select__link:focus,.md-select__link:hover{color:var(--md-accent-fg-color)}.md-select__link:focus{background-color:var(--md-default-fg-color--lightest)}.md-sidebar{align-self:flex-start;flex-shrink:0;padding:1.2rem 0;position:sticky;top:2.4rem;width:12.1rem}@media print{.md-sidebar{display:none}}@media screen and (max-width:76.234375em){[dir=ltr] .md-sidebar--primary{left:-12.1rem}[dir=rtl] .md-sidebar--primary{right:-12.1rem}.md-sidebar--primary{background-color:var(--md-default-bg-color);display:block;height:100%;position:fixed;top:0;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),box-shadow .25s;width:12.1rem;z-index:5}[data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{box-shadow:var(--md-shadow-z3);transform:translateX(12.1rem)}[dir=rtl] [data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{transform:translateX(-12.1rem)}.md-sidebar--primary .md-sidebar__scrollwrap{bottom:0;left:0;margin:0;overflow:hidden;position:absolute;right:0;scroll-snap-type:none;top:0}}@media screen and (min-width:76.25em){.md-sidebar{height:0}.no-js .md-sidebar{height:auto}.md-header--lifted~.md-container .md-sidebar{top:4.8rem}}.md-sidebar--secondary{display:none;order:2}@media screen and (min-width:60em){.md-sidebar--secondary{height:0}.no-js .md-sidebar--secondary{height:auto}.md-sidebar--secondary:not([hidden]){display:block}.md-sidebar--secondary .md-sidebar__scrollwrap{touch-action:pan-y}}.md-sidebar__scrollwrap{scrollbar-gutter:stable;-webkit-backface-visibility:hidden;backface-visibility:hidden;margin:0 .2rem;overflow-y:auto;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}.md-sidebar__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-sidebar__scrollwrap:focus-within,.md-sidebar__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb:hover,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}@supports selector(::-webkit-scrollbar){.md-sidebar__scrollwrap{scrollbar-gutter:auto}[dir=ltr] .md-sidebar__inner{padding-right:calc(100% - 11.5rem)}[dir=rtl] .md-sidebar__inner{padding-left:calc(100% - 11.5rem)}}@media screen and (max-width:76.234375em){.md-overlay{background-color:#0000008a;height:0;opacity:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0;z-index:5}[data-md-toggle=drawer]:checked~.md-overlay{height:100%;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@keyframes facts{0%{height:0}to{height:.65rem}}@keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}:root{--md-source-forks-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-repositories-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-stars-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-version-icon:url('data:image/svg+xml;charset=utf-8,')}.md-source{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.65rem;line-height:1.2;outline-color:var(--md-accent-fg-color);transition:opacity .25s;white-space:nowrap}.md-source:hover{opacity:.7}.md-source__icon{display:inline-block;height:2.4rem;vertical-align:middle;width:2rem}[dir=ltr] .md-source__icon svg{margin-left:.6rem}[dir=rtl] .md-source__icon svg{margin-right:.6rem}.md-source__icon svg{margin-top:.6rem}[dir=ltr] .md-source__icon+.md-source__repository{padding-left:2rem}[dir=rtl] .md-source__icon+.md-source__repository{padding-right:2rem}[dir=ltr] .md-source__icon+.md-source__repository{margin-left:-2rem}[dir=rtl] .md-source__icon+.md-source__repository{margin-right:-2rem}[dir=ltr] .md-source__repository{margin-left:.6rem}[dir=rtl] .md-source__repository{margin-right:.6rem}.md-source__repository{display:inline-block;max-width:calc(100% - 1.2rem);overflow:hidden;text-overflow:ellipsis;vertical-align:middle}.md-source__facts{display:flex;font-size:.55rem;gap:.4rem;list-style-type:none;margin:.1rem 0 0;opacity:.75;overflow:hidden;padding:0;width:100%}.md-source__repository--active .md-source__facts{animation:facts .25s ease-in}.md-source__fact{overflow:hidden;text-overflow:ellipsis}.md-source__repository--active .md-source__fact{animation:fact .4s ease-out}[dir=ltr] .md-source__fact:before{margin-right:.1rem}[dir=rtl] .md-source__fact:before{margin-left:.1rem}.md-source__fact:before{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-top;width:.6rem}.md-source__fact:nth-child(1n+2){flex-shrink:0}.md-source__fact--version:before{-webkit-mask-image:var(--md-source-version-icon);mask-image:var(--md-source-version-icon)}.md-source__fact--stars:before{-webkit-mask-image:var(--md-source-stars-icon);mask-image:var(--md-source-stars-icon)}.md-source__fact--forks:before{-webkit-mask-image:var(--md-source-forks-icon);mask-image:var(--md-source-forks-icon)}.md-source__fact--repositories:before{-webkit-mask-image:var(--md-source-repositories-icon);mask-image:var(--md-source-repositories-icon)}.md-source-file{margin:1em 0}[dir=ltr] .md-source-file__fact{margin-right:.6rem}[dir=rtl] .md-source-file__fact{margin-left:.6rem}.md-source-file__fact{align-items:center;color:var(--md-default-fg-color--light);display:inline-flex;font-size:.68rem;gap:.3rem}.md-source-file__fact .md-icon{flex-shrink:0;margin-bottom:.05rem}[dir=ltr] .md-source-file__fact .md-author{float:left}[dir=rtl] .md-source-file__fact .md-author{float:right}.md-source-file__fact .md-author{margin-right:.2rem}.md-source-file__fact svg{width:.9rem}:root{--md-status:url('data:image/svg+xml;charset=utf-8,');--md-status--new:url('data:image/svg+xml;charset=utf-8,');--md-status--deprecated:url('data:image/svg+xml;charset=utf-8,');--md-status--encrypted:url('data:image/svg+xml;charset=utf-8,')}.md-status:after{background-color:var(--md-default-fg-color--light);content:"";display:inline-block;height:1.125em;-webkit-mask-image:var(--md-status);mask-image:var(--md-status);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-bottom;width:1.125em}.md-status:hover:after{background-color:currentcolor}.md-status--new:after{-webkit-mask-image:var(--md-status--new);mask-image:var(--md-status--new)}.md-status--deprecated:after{-webkit-mask-image:var(--md-status--deprecated);mask-image:var(--md-status--deprecated)}.md-status--encrypted:after{-webkit-mask-image:var(--md-status--encrypted);mask-image:var(--md-status--encrypted)}.md-tabs{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);display:block;line-height:1.3;overflow:auto;width:100%;z-index:3}@media print{.md-tabs{display:none}}@media screen and (max-width:76.234375em){.md-tabs{display:none}}.md-tabs[hidden]{pointer-events:none}[dir=ltr] .md-tabs__list{margin-left:.2rem}[dir=rtl] .md-tabs__list{margin-right:.2rem}.md-tabs__list{contain:content;display:flex;list-style:none;margin:0;overflow:auto;padding:0;scrollbar-width:none;white-space:nowrap}.md-tabs__list::-webkit-scrollbar{display:none}.md-tabs__item{height:2.4rem;padding-left:.6rem;padding-right:.6rem}.md-tabs__item--active .md-tabs__link{color:inherit;opacity:1}.md-tabs__link{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:flex;font-size:.7rem;margin-top:.8rem;opacity:.7;outline-color:var(--md-accent-fg-color);outline-offset:.2rem;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .25s}.md-tabs__link:focus,.md-tabs__link:hover{color:inherit;opacity:1}[dir=ltr] .md-tabs__link svg{margin-right:.4rem}[dir=rtl] .md-tabs__link svg{margin-left:.4rem}.md-tabs__link svg{fill:currentcolor;height:1.3em}.md-tabs__item:nth-child(2) .md-tabs__link{transition-delay:20ms}.md-tabs__item:nth-child(3) .md-tabs__link{transition-delay:40ms}.md-tabs__item:nth-child(4) .md-tabs__link{transition-delay:60ms}.md-tabs__item:nth-child(5) .md-tabs__link{transition-delay:80ms}.md-tabs__item:nth-child(6) .md-tabs__link{transition-delay:.1s}.md-tabs__item:nth-child(7) .md-tabs__link{transition-delay:.12s}.md-tabs__item:nth-child(8) .md-tabs__link{transition-delay:.14s}.md-tabs__item:nth-child(9) .md-tabs__link{transition-delay:.16s}.md-tabs__item:nth-child(10) .md-tabs__link{transition-delay:.18s}.md-tabs__item:nth-child(11) .md-tabs__link{transition-delay:.2s}.md-tabs__item:nth-child(12) .md-tabs__link{transition-delay:.22s}.md-tabs__item:nth-child(13) .md-tabs__link{transition-delay:.24s}.md-tabs__item:nth-child(14) .md-tabs__link{transition-delay:.26s}.md-tabs__item:nth-child(15) .md-tabs__link{transition-delay:.28s}.md-tabs__item:nth-child(16) .md-tabs__link{transition-delay:.3s}.md-tabs[hidden] .md-tabs__link{opacity:0;transform:translateY(50%);transition:transform 0ms .1s,opacity .1s}:root{--md-tag-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .md-tags:not([hidden]){display:inline-flex;flex-wrap:wrap;gap:.5em;margin-bottom:.75em;margin-top:-.125em}.md-typeset .md-tag{align-items:center;background:var(--md-default-fg-color--lightest);border-radius:2.4rem;display:inline-flex;font-size:.64rem;font-size:min(.8em,.64rem);font-weight:700;gap:.5em;letter-spacing:normal;line-height:1.6;padding:.3125em .78125em}.md-typeset .md-tag[href]{-webkit-tap-highlight-color:transparent;color:inherit;outline:none;transition:color 125ms,background-color 125ms}.md-typeset .md-tag[href]:focus,.md-typeset .md-tag[href]:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[id]>.md-typeset .md-tag{vertical-align:text-top}.md-typeset .md-tag-icon:before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-tag-icon);mask-image:var(--md-tag-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset .md-tag-icon[href]:focus:before,.md-typeset .md-tag-icon[href]:hover:before{background-color:var(--md-accent-bg-color)}@keyframes pulse{0%{transform:scale(.95)}75%{transform:scale(1)}to{transform:scale(.95)}}:root{--md-annotation-bg-icon:url('data:image/svg+xml;charset=utf-8,');--md-annotation-icon:url('data:image/svg+xml;charset=utf-8,');--md-tooltip-width:20rem}.md-tooltip{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);font-family:var(--md-text-font-family);left:clamp(var(--md-tooltip-0,0rem) + .8rem,var(--md-tooltip-x),100vw + var(--md-tooltip-0,0rem) + .8rem - var(--md-tooltip-width) - 2 * .8rem);max-width:calc(100vw - 1.6rem);opacity:0;position:absolute;top:var(--md-tooltip-y);transform:translateY(-.4rem);transition:transform 0ms .25s,opacity .25s,z-index .25s;width:var(--md-tooltip-width);z-index:0}.md-tooltip--active{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip--inline{font-weight:700;-webkit-user-select:none;user-select:none;width:auto}.md-tooltip--inline:not(.md-tooltip--active){transform:translateY(.2rem) scale(.9)}.md-tooltip--inline .md-tooltip__inner{font-size:.5rem;padding:.2rem .4rem}[hidden]+.md-tooltip--inline{display:none}.focus-visible>.md-tooltip,.md-tooltip:target{outline:var(--md-accent-fg-color) auto}.md-tooltip__inner{font-size:.64rem;padding:.8rem}.md-tooltip__inner.md-typeset>:first-child{margin-top:0}.md-tooltip__inner.md-typeset>:last-child{margin-bottom:0}.md-annotation{font-weight:400;outline:none;vertical-align:text-bottom;white-space:normal}[dir=rtl] .md-annotation{direction:rtl}code .md-annotation{font-family:var(--md-code-font-family);font-size:inherit}.md-annotation:not([hidden]){display:inline-block;line-height:1.25}.md-annotation__index{border-radius:.01px;cursor:pointer;display:inline-block;margin-left:.4ch;margin-right:.4ch;outline:none;overflow:hidden;position:relative;-webkit-user-select:none;user-select:none;vertical-align:text-top;z-index:0}.md-annotation .md-annotation__index{transition:z-index .25s}@media screen{.md-annotation__index{width:2.2ch}[data-md-visible]>.md-annotation__index{animation:pulse 2s infinite}.md-annotation__index:before{background:var(--md-default-bg-color);-webkit-mask-image:var(--md-annotation-bg-icon);mask-image:var(--md-annotation-bg-icon)}.md-annotation__index:after,.md-annotation__index:before{content:"";height:2.2ch;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:-.1ch;width:2.2ch;z-index:-1}.md-annotation__index:after{background-color:var(--md-default-fg-color--lighter);-webkit-mask-image:var(--md-annotation-icon);mask-image:var(--md-annotation-icon);transform:scale(1.0001);transition:background-color .25s,transform .25s}.md-tooltip--active+.md-annotation__index:after{transform:rotate(45deg)}.md-tooltip--active+.md-annotation__index:after,:hover>.md-annotation__index:after{background-color:var(--md-accent-fg-color)}}.md-tooltip--active+.md-annotation__index{animation-play-state:paused;transition-duration:0ms;z-index:2}.md-annotation__index [data-md-annotation-id]{display:inline-block}@media print{.md-annotation__index [data-md-annotation-id]{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);font-weight:700;padding:0 .6ch;white-space:nowrap}.md-annotation__index [data-md-annotation-id]:after{content:attr(data-md-annotation-id)}}.md-typeset .md-annotation-list{counter-reset:xxx;list-style:none}.md-typeset .md-annotation-list li{position:relative}[dir=ltr] .md-typeset .md-annotation-list li:before{left:-2.125em}[dir=rtl] .md-typeset .md-annotation-list li:before{right:-2.125em}.md-typeset .md-annotation-list li:before{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);content:counter(xxx);counter-increment:xxx;font-size:.8875em;font-weight:700;height:2ch;line-height:1.25;min-width:2ch;padding:0 .6ch;position:absolute;text-align:center;top:.25em}[dir=ltr] .md-top{margin-left:50%}[dir=rtl] .md-top{margin-right:50%}.md-top{background-color:var(--md-default-bg-color);border-radius:1.6rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color--light);cursor:pointer;display:block;font-size:.7rem;outline:none;padding:.4rem .8rem;position:fixed;top:3.2rem;transform:translate(-50%);transition:color 125ms,background-color 125ms,transform 125ms cubic-bezier(.4,0,.2,1),opacity 125ms;z-index:2}@media print{.md-top{display:none}}[dir=rtl] .md-top{transform:translate(50%)}.md-top[hidden]{opacity:0;pointer-events:none;transform:translate(-50%,.2rem);transition-duration:0ms}[dir=rtl] .md-top[hidden]{transform:translate(50%,.2rem)}.md-top:focus,.md-top:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top svg{display:inline-block;vertical-align:-.5em}@keyframes hoverfix{0%{pointer-events:none}}:root{--md-version-icon:url('data:image/svg+xml;charset=utf-8,')}.md-version{flex-shrink:0;font-size:.8rem;height:2.4rem}[dir=ltr] .md-version__current{margin-left:1.4rem;margin-right:.4rem}[dir=rtl] .md-version__current{margin-left:.4rem;margin-right:1.4rem}.md-version__current{color:inherit;cursor:pointer;outline:none;position:relative;top:.05rem}[dir=ltr] .md-version__current:after{margin-left:.4rem}[dir=rtl] .md-version__current:after{margin-right:.4rem}.md-version__current:after{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-image:var(--md-version-icon);mask-image:var(--md-version-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.4rem}.md-version__list{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);list-style-type:none;margin:.2rem .8rem;max-height:0;opacity:0;overflow:auto;padding:0;position:absolute;scroll-snap-type:y mandatory;top:.15rem;transition:max-height 0ms .5s,opacity .25s .25s;z-index:3}.md-version:focus-within .md-version__list,.md-version:hover .md-version__list{max-height:10rem;opacity:1;transition:max-height 0ms,opacity .25s}@media (hover:none),(pointer:coarse){.md-version:hover .md-version__list{animation:hoverfix .25s forwards}.md-version:focus-within .md-version__list{animation:none}}.md-version__item{line-height:1.8rem}[dir=ltr] .md-version__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-version__link{padding-left:1.2rem;padding-right:.6rem}.md-version__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:color .25s,background-color .25s;white-space:nowrap;width:100%}.md-version__link:focus,.md-version__link:hover{color:var(--md-accent-fg-color)}.md-version__link:focus{background-color:var(--md-default-fg-color--lightest)}:root{--md-admonition-icon--note:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--abstract:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--info:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--tip:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--success:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--question:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--warning:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--failure:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--danger:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--bug:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--quote:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .admonition,.md-typeset details{background-color:var(--md-admonition-bg-color);border:.075rem solid #448aff;border-radius:.2rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid;transition:box-shadow 125ms}@media print{.md-typeset .admonition,.md-typeset details{box-shadow:none}}.md-typeset .admonition:focus-within,.md-typeset details:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .admonition>*,.md-typeset details>*{box-sizing:border-box}.md-typeset .admonition .admonition,.md-typeset .admonition details,.md-typeset details .admonition,.md-typeset details details{margin-bottom:1em;margin-top:1em}.md-typeset .admonition .md-typeset__scrollwrap,.md-typeset details .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset .admonition .md-typeset__table,.md-typeset details .md-typeset__table{padding:0 .6rem}.md-typeset .admonition>.tabbed-set:only-child,.md-typeset details>.tabbed-set:only-child{margin-top:0}html .md-typeset .admonition>:last-child,html .md-typeset details>:last-child{margin-bottom:.6rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{padding-left:2rem;padding-right:.6rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{padding-left:.6rem;padding-right:2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-left-width:.2rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-right-width:.2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset .admonition-title,.md-typeset summary{background-color:#448aff1a;border:none;font-weight:700;margin:0 -.6rem;padding-bottom:.4rem;padding-top:.4rem;position:relative}html .md-typeset .admonition-title:last-child,html .md-typeset summary:last-child{margin-bottom:0}[dir=ltr] .md-typeset .admonition-title:before,[dir=ltr] .md-typeset summary:before{left:.6rem}[dir=rtl] .md-typeset .admonition-title:before,[dir=rtl] .md-typeset summary:before{right:.6rem}.md-typeset .admonition-title:before,.md-typeset summary:before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset .admonition-title code,.md-typeset summary code{box-shadow:0 0 0 .05rem var(--md-default-fg-color--lightest)}.md-typeset .admonition.note,.md-typeset details.note{border-color:#448aff}.md-typeset .admonition.note:focus-within,.md-typeset details.note:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .note>.admonition-title,.md-typeset .note>summary{background-color:#448aff1a}.md-typeset .note>.admonition-title:before,.md-typeset .note>summary:before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note)}.md-typeset .note>.admonition-title:after,.md-typeset .note>summary:after{color:#448aff}.md-typeset .admonition.abstract,.md-typeset details.abstract{border-color:#00b0ff}.md-typeset .admonition.abstract:focus-within,.md-typeset details.abstract:focus-within{box-shadow:0 0 0 .2rem #00b0ff1a}.md-typeset .abstract>.admonition-title,.md-typeset .abstract>summary{background-color:#00b0ff1a}.md-typeset .abstract>.admonition-title:before,.md-typeset .abstract>summary:before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract)}.md-typeset .abstract>.admonition-title:after,.md-typeset .abstract>summary:after{color:#00b0ff}.md-typeset .admonition.info,.md-typeset details.info{border-color:#00b8d4}.md-typeset .admonition.info:focus-within,.md-typeset details.info:focus-within{box-shadow:0 0 0 .2rem #00b8d41a}.md-typeset .info>.admonition-title,.md-typeset .info>summary{background-color:#00b8d41a}.md-typeset .info>.admonition-title:before,.md-typeset .info>summary:before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info)}.md-typeset .info>.admonition-title:after,.md-typeset .info>summary:after{color:#00b8d4}.md-typeset .admonition.tip,.md-typeset details.tip{border-color:#00bfa5}.md-typeset .admonition.tip:focus-within,.md-typeset details.tip:focus-within{box-shadow:0 0 0 .2rem #00bfa51a}.md-typeset .tip>.admonition-title,.md-typeset .tip>summary{background-color:#00bfa51a}.md-typeset .tip>.admonition-title:before,.md-typeset .tip>summary:before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip)}.md-typeset .tip>.admonition-title:after,.md-typeset .tip>summary:after{color:#00bfa5}.md-typeset .admonition.success,.md-typeset details.success{border-color:#00c853}.md-typeset .admonition.success:focus-within,.md-typeset details.success:focus-within{box-shadow:0 0 0 .2rem #00c8531a}.md-typeset .success>.admonition-title,.md-typeset .success>summary{background-color:#00c8531a}.md-typeset .success>.admonition-title:before,.md-typeset .success>summary:before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success)}.md-typeset .success>.admonition-title:after,.md-typeset .success>summary:after{color:#00c853}.md-typeset .admonition.question,.md-typeset details.question{border-color:#64dd17}.md-typeset .admonition.question:focus-within,.md-typeset details.question:focus-within{box-shadow:0 0 0 .2rem #64dd171a}.md-typeset .question>.admonition-title,.md-typeset .question>summary{background-color:#64dd171a}.md-typeset .question>.admonition-title:before,.md-typeset .question>summary:before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question)}.md-typeset .question>.admonition-title:after,.md-typeset .question>summary:after{color:#64dd17}.md-typeset .admonition.warning,.md-typeset details.warning{border-color:#ff9100}.md-typeset .admonition.warning:focus-within,.md-typeset details.warning:focus-within{box-shadow:0 0 0 .2rem #ff91001a}.md-typeset .warning>.admonition-title,.md-typeset .warning>summary{background-color:#ff91001a}.md-typeset .warning>.admonition-title:before,.md-typeset .warning>summary:before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning)}.md-typeset .warning>.admonition-title:after,.md-typeset .warning>summary:after{color:#ff9100}.md-typeset .admonition.failure,.md-typeset details.failure{border-color:#ff5252}.md-typeset .admonition.failure:focus-within,.md-typeset details.failure:focus-within{box-shadow:0 0 0 .2rem #ff52521a}.md-typeset .failure>.admonition-title,.md-typeset .failure>summary{background-color:#ff52521a}.md-typeset .failure>.admonition-title:before,.md-typeset .failure>summary:before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure)}.md-typeset .failure>.admonition-title:after,.md-typeset .failure>summary:after{color:#ff5252}.md-typeset .admonition.danger,.md-typeset details.danger{border-color:#ff1744}.md-typeset .admonition.danger:focus-within,.md-typeset details.danger:focus-within{box-shadow:0 0 0 .2rem #ff17441a}.md-typeset .danger>.admonition-title,.md-typeset .danger>summary{background-color:#ff17441a}.md-typeset .danger>.admonition-title:before,.md-typeset .danger>summary:before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger)}.md-typeset .danger>.admonition-title:after,.md-typeset .danger>summary:after{color:#ff1744}.md-typeset .admonition.bug,.md-typeset details.bug{border-color:#f50057}.md-typeset .admonition.bug:focus-within,.md-typeset details.bug:focus-within{box-shadow:0 0 0 .2rem #f500571a}.md-typeset .bug>.admonition-title,.md-typeset .bug>summary{background-color:#f500571a}.md-typeset .bug>.admonition-title:before,.md-typeset .bug>summary:before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug)}.md-typeset .bug>.admonition-title:after,.md-typeset .bug>summary:after{color:#f50057}.md-typeset .admonition.example,.md-typeset details.example{border-color:#7c4dff}.md-typeset .admonition.example:focus-within,.md-typeset details.example:focus-within{box-shadow:0 0 0 .2rem #7c4dff1a}.md-typeset .example>.admonition-title,.md-typeset .example>summary{background-color:#7c4dff1a}.md-typeset .example>.admonition-title:before,.md-typeset .example>summary:before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example)}.md-typeset .example>.admonition-title:after,.md-typeset .example>summary:after{color:#7c4dff}.md-typeset .admonition.quote,.md-typeset details.quote{border-color:#9e9e9e}.md-typeset .admonition.quote:focus-within,.md-typeset details.quote:focus-within{box-shadow:0 0 0 .2rem #9e9e9e1a}.md-typeset .quote>.admonition-title,.md-typeset .quote>summary{background-color:#9e9e9e1a}.md-typeset .quote>.admonition-title:before,.md-typeset .quote>summary:before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote)}.md-typeset .quote>.admonition-title:after,.md-typeset .quote>summary:after{color:#9e9e9e}:root{--md-footnotes-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .footnote{color:var(--md-default-fg-color--light);font-size:.64rem}[dir=ltr] .md-typeset .footnote>ol{margin-left:0}[dir=rtl] .md-typeset .footnote>ol{margin-right:0}.md-typeset .footnote>ol>li{transition:color 125ms}.md-typeset .footnote>ol>li:target{color:var(--md-default-fg-color)}.md-typeset .footnote>ol>li:focus-within .footnote-backref{opacity:1;transform:translateX(0);transition:none}.md-typeset .footnote>ol>li:hover .footnote-backref,.md-typeset .footnote>ol>li:target .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li>:first-child{margin-top:0}.md-typeset .footnote-ref{font-size:.75em;font-weight:700}html .md-typeset .footnote-ref{outline-offset:.1rem}.md-typeset [id^="fnref:"]:target>.footnote-ref{outline:auto}.md-typeset .footnote-backref{color:var(--md-typeset-a-color);display:inline-block;font-size:0;opacity:0;transform:translateX(.25rem);transition:color .25s,transform .25s .25s,opacity 125ms .25s;vertical-align:text-bottom}@media print{.md-typeset .footnote-backref{color:var(--md-typeset-a-color);opacity:1;transform:translateX(0)}}[dir=rtl] .md-typeset .footnote-backref{transform:translateX(-.25rem)}.md-typeset .footnote-backref:hover{color:var(--md-accent-fg-color)}.md-typeset .footnote-backref:before{background-color:currentcolor;content:"";display:inline-block;height:.8rem;-webkit-mask-image:var(--md-footnotes-icon);mask-image:var(--md-footnotes-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.8rem}[dir=rtl] .md-typeset .footnote-backref:before svg{transform:scaleX(-1)}[dir=ltr] .md-typeset .headerlink{margin-left:.5rem}[dir=rtl] .md-typeset .headerlink{margin-right:.5rem}.md-typeset .headerlink{color:var(--md-default-fg-color--lighter);display:inline-block;opacity:0;transition:color .25s,opacity 125ms}@media print{.md-typeset .headerlink{display:none}}.md-typeset .headerlink:focus,.md-typeset :hover>.headerlink,.md-typeset :target>.headerlink{opacity:1;transition:color .25s,opacity 125ms}.md-typeset .headerlink:focus,.md-typeset .headerlink:hover,.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset :target{--md-scroll-margin:3.6rem;--md-scroll-offset:0rem;scroll-margin-top:calc(var(--md-scroll-margin) - var(--md-scroll-offset))}@media screen and (min-width:76.25em){.md-header--lifted~.md-container .md-typeset :target{--md-scroll-margin:6rem}}.md-typeset h1:target,.md-typeset h2:target,.md-typeset h3:target{--md-scroll-offset:0.2rem}.md-typeset h4:target{--md-scroll-offset:0.15rem}.md-typeset div.arithmatex{overflow:auto}@media screen and (max-width:44.984375em){.md-typeset div.arithmatex{margin:0 -.8rem}.md-typeset div.arithmatex>*{width:-webkit-min-content;width:min-content}}.md-typeset div.arithmatex>*{margin-left:auto!important;margin-right:auto!important;padding:0 .8rem;touch-action:auto}.md-typeset div.arithmatex>* mjx-container{margin:0!important}.md-typeset div.arithmatex mjx-assistive-mml{height:0}.md-typeset del.critic{background-color:var(--md-typeset-del-color)}.md-typeset del.critic,.md-typeset ins.critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset ins.critic{background-color:var(--md-typeset-ins-color)}.md-typeset .critic.comment{-webkit-box-decoration-break:clone;box-decoration-break:clone;color:var(--md-code-hl-comment-color)}.md-typeset .critic.comment:before{content:"/* "}.md-typeset .critic.comment:after{content:" */"}.md-typeset .critic.block{box-shadow:none;display:block;margin:1em 0;overflow:auto;padding-left:.8rem;padding-right:.8rem}.md-typeset .critic.block>:first-child{margin-top:.5em}.md-typeset .critic.block>:last-child{margin-bottom:.5em}:root{--md-details-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset details{display:flow-root;overflow:visible;padding-top:0}.md-typeset details[open]>summary:after{transform:rotate(90deg)}.md-typeset details:not([open]){box-shadow:none;padding-bottom:0}.md-typeset details:not([open])>summary{border-radius:.1rem}[dir=ltr] .md-typeset summary{padding-right:1.8rem}[dir=rtl] .md-typeset summary{padding-left:1.8rem}[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset summary{cursor:pointer;display:block;min-height:1rem;overflow:hidden}.md-typeset summary.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset summary:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[dir=ltr] .md-typeset summary:after{right:.4rem}[dir=rtl] .md-typeset summary:after{left:.4rem}.md-typeset summary:after{background-color:currentcolor;content:"";height:1rem;-webkit-mask-image:var(--md-details-icon);mask-image:var(--md-details-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;transform:rotate(0deg);transition:transform .25s;width:1rem}[dir=rtl] .md-typeset summary:after{transform:rotate(180deg)}.md-typeset summary::marker{display:none}.md-typeset summary::-webkit-details-marker{display:none}.md-typeset .emojione,.md-typeset .gemoji,.md-typeset .twemoji{--md-icon-size:1.125em;display:inline-flex;height:var(--md-icon-size);vertical-align:text-top}.md-typeset .emojione svg,.md-typeset .gemoji svg,.md-typeset .twemoji svg{fill:currentcolor;max-height:100%;width:var(--md-icon-size)}.md-typeset .lg,.md-typeset .xl,.md-typeset .xxl,.md-typeset .xxxl{vertical-align:text-bottom}.md-typeset .middle{vertical-align:middle}.md-typeset .lg{--md-icon-size:1.5em}.md-typeset .xl{--md-icon-size:2.25em}.md-typeset .xxl{--md-icon-size:3em}.md-typeset .xxxl{--md-icon-size:4em}.highlight .o,.highlight .ow{color:var(--md-code-hl-operator-color)}.highlight .p{color:var(--md-code-hl-punctuation-color)}.highlight .cpf,.highlight .l,.highlight .s,.highlight .s1,.highlight .s2,.highlight .sb,.highlight .sc,.highlight .si,.highlight .ss{color:var(--md-code-hl-string-color)}.highlight .cp,.highlight .se,.highlight .sh,.highlight .sr,.highlight .sx{color:var(--md-code-hl-special-color)}.highlight .il,.highlight .m,.highlight .mb,.highlight .mf,.highlight .mh,.highlight .mi,.highlight .mo{color:var(--md-code-hl-number-color)}.highlight .k,.highlight .kd,.highlight .kn,.highlight .kp,.highlight .kr,.highlight .kt{color:var(--md-code-hl-keyword-color)}.highlight .kc,.highlight .n{color:var(--md-code-hl-name-color)}.highlight .bp,.highlight .nb,.highlight .no{color:var(--md-code-hl-constant-color)}.highlight .nc,.highlight .ne,.highlight .nf,.highlight .nn{color:var(--md-code-hl-function-color)}.highlight .nd,.highlight .ni,.highlight .nl,.highlight .nt{color:var(--md-code-hl-keyword-color)}.highlight .c,.highlight .c1,.highlight .ch,.highlight .cm,.highlight .cs,.highlight .sd{color:var(--md-code-hl-comment-color)}.highlight .na,.highlight .nv,.highlight .vc,.highlight .vg,.highlight .vi{color:var(--md-code-hl-variable-color)}.highlight .ge,.highlight .gh,.highlight .go,.highlight .gp,.highlight .gr,.highlight .gs,.highlight .gt,.highlight .gu{color:var(--md-code-hl-generic-color)}.highlight .gd,.highlight .gi{border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight .gd{background-color:var(--md-typeset-del-color)}.highlight .gi{background-color:var(--md-typeset-ins-color)}.highlight .hll{background-color:var(--md-code-hl-color--light);box-shadow:2px 0 0 0 var(--md-code-hl-color) inset;display:block;margin:0 -1.1764705882em;padding:0 1.1764705882em}.highlight span.filename{background-color:var(--md-code-bg-color);border-bottom:.05rem solid var(--md-default-fg-color--lightest);border-top-left-radius:.1rem;border-top-right-radius:.1rem;display:flow-root;font-size:.85em;font-weight:700;margin-top:1em;padding:.6617647059em 1.1764705882em;position:relative}.highlight span.filename+pre{margin-top:0}.highlight span.filename+pre>code{border-top-left-radius:0;border-top-right-radius:0}.highlight [data-linenos]:before{background-color:var(--md-code-bg-color);box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;color:var(--md-default-fg-color--light);content:attr(data-linenos);float:left;left:-1.1764705882em;margin-left:-1.1764705882em;margin-right:1.1764705882em;padding-left:1.1764705882em;position:sticky;-webkit-user-select:none;user-select:none;z-index:3}.highlight code a[id]{position:absolute;visibility:hidden}.highlight code[data-md-copying] .hll{display:contents}.highlight code[data-md-copying] .md-annotation{display:none}.highlighttable{display:flow-root}.highlighttable tbody,.highlighttable td{display:block;padding:0}.highlighttable tr{display:flex}.highlighttable pre{margin:0}.highlighttable th.filename{flex-grow:1;padding:0;text-align:left}.highlighttable th.filename span.filename{margin-top:0}.highlighttable .linenos{background-color:var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-top-left-radius:.1rem;font-size:.85em;padding:.7720588235em 0 .7720588235em 1.1764705882em;-webkit-user-select:none;user-select:none}.highlighttable .linenodiv{box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;padding-right:.5882352941em}.highlighttable .linenodiv pre{color:var(--md-default-fg-color--light);text-align:right}.highlighttable .code{flex:1;min-width:0}.linenodiv a{color:inherit}.md-typeset .highlighttable{direction:ltr;margin:1em 0}.md-typeset .highlighttable>tbody>tr>.code>div>pre>code{border-bottom-left-radius:0;border-top-left-radius:0}.md-typeset .highlight+.result{border:.05rem solid var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-bottom-right-radius:.1rem;border-top-width:.1rem;margin-top:-1.125em;overflow:visible;padding:0 1em}.md-typeset .highlight+.result:after{clear:both;content:"";display:block}@media screen and (max-width:44.984375em){.md-content__inner>.highlight{margin:1em -.8rem}.md-content__inner>.highlight>.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.code>div>pre>code,.md-content__inner>.highlight>.highlighttable>tbody>tr>.filename span.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.linenos,.md-content__inner>.highlight>pre>code{border-radius:0}.md-content__inner>.highlight+.result{border-left-width:0;border-radius:0;border-right-width:0;margin-left:-.8rem;margin-right:-.8rem}}.md-typeset .keys kbd:after,.md-typeset .keys kbd:before{-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys span{color:var(--md-default-fg-color--light);padding:0 .2em}.md-typeset .keys .key-alt:before,.md-typeset .keys .key-left-alt:before,.md-typeset .keys .key-right-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-command:before,.md-typeset .keys .key-left-command:before,.md-typeset .keys .key-right-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-control:before,.md-typeset .keys .key-left-control:before,.md-typeset .keys .key-right-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-left-meta:before,.md-typeset .keys .key-meta:before,.md-typeset .keys .key-right-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-left-option:before,.md-typeset .keys .key-option:before,.md-typeset .keys .key-right-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-left-shift:before,.md-typeset .keys .key-right-shift:before,.md-typeset .keys .key-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-left-super:before,.md-typeset .keys .key-right-super:before,.md-typeset .keys .key-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-left-windows:before,.md-typeset .keys .key-right-windows:before,.md-typeset .keys .key-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-arrow-down:before{content:"↓";padding-right:.4em}.md-typeset .keys .key-arrow-left:before{content:"←";padding-right:.4em}.md-typeset .keys .key-arrow-right:before{content:"→";padding-right:.4em}.md-typeset .keys .key-arrow-up:before{content:"↑";padding-right:.4em}.md-typeset .keys .key-backspace:before{content:"⌫";padding-right:.4em}.md-typeset .keys .key-backtab:before{content:"⇤";padding-right:.4em}.md-typeset .keys .key-caps-lock:before{content:"⇪";padding-right:.4em}.md-typeset .keys .key-clear:before{content:"⌧";padding-right:.4em}.md-typeset .keys .key-context-menu:before{content:"☰";padding-right:.4em}.md-typeset .keys .key-delete:before{content:"⌦";padding-right:.4em}.md-typeset .keys .key-eject:before{content:"⏏";padding-right:.4em}.md-typeset .keys .key-end:before{content:"⤓";padding-right:.4em}.md-typeset .keys .key-escape:before{content:"⎋";padding-right:.4em}.md-typeset .keys .key-home:before{content:"⤒";padding-right:.4em}.md-typeset .keys .key-insert:before{content:"⎀";padding-right:.4em}.md-typeset .keys .key-page-down:before{content:"⇟";padding-right:.4em}.md-typeset .keys .key-page-up:before{content:"⇞";padding-right:.4em}.md-typeset .keys .key-print-screen:before{content:"⎙";padding-right:.4em}.md-typeset .keys .key-tab:after{content:"⇥";padding-left:.4em}.md-typeset .keys .key-num-enter:after{content:"⌤";padding-left:.4em}.md-typeset .keys .key-enter:after{content:"⏎";padding-left:.4em}:root{--md-tabbed-icon--prev:url('data:image/svg+xml;charset=utf-8,');--md-tabbed-icon--next:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .tabbed-set{border-radius:.1rem;display:flex;flex-flow:column wrap;margin:1em 0;position:relative}.md-typeset .tabbed-set>input{height:0;opacity:0;position:absolute;width:0}.md-typeset .tabbed-set>input:target{--md-scroll-offset:0.625em}.md-typeset .tabbed-set>input.focus-visible~.tabbed-labels:before{background-color:var(--md-accent-fg-color)}.md-typeset .tabbed-labels{-ms-overflow-style:none;box-shadow:0 -.05rem var(--md-default-fg-color--lightest) inset;display:flex;max-width:100%;overflow:auto;scrollbar-width:none}@media print{.md-typeset .tabbed-labels{display:contents}}@media screen{.js .md-typeset .tabbed-labels{position:relative}.js .md-typeset .tabbed-labels:before{background:var(--md-default-fg-color);bottom:0;content:"";display:block;height:2px;left:0;position:absolute;transform:translateX(var(--md-indicator-x));transition:width 225ms,background-color .25s,transform .25s;transition-timing-function:cubic-bezier(.4,0,.2,1);width:var(--md-indicator-width)}}.md-typeset .tabbed-labels::-webkit-scrollbar{display:none}.md-typeset .tabbed-labels>label{border-bottom:.1rem solid #0000;border-radius:.1rem .1rem 0 0;color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;font-size:.64rem;font-weight:700;padding:.78125em 1.25em .625em;scroll-margin-inline-start:1rem;transition:background-color .25s,color .25s;white-space:nowrap;width:auto}@media print{.md-typeset .tabbed-labels>label:first-child{order:1}.md-typeset .tabbed-labels>label:nth-child(2){order:2}.md-typeset .tabbed-labels>label:nth-child(3){order:3}.md-typeset .tabbed-labels>label:nth-child(4){order:4}.md-typeset .tabbed-labels>label:nth-child(5){order:5}.md-typeset .tabbed-labels>label:nth-child(6){order:6}.md-typeset .tabbed-labels>label:nth-child(7){order:7}.md-typeset .tabbed-labels>label:nth-child(8){order:8}.md-typeset .tabbed-labels>label:nth-child(9){order:9}.md-typeset .tabbed-labels>label:nth-child(10){order:10}.md-typeset .tabbed-labels>label:nth-child(11){order:11}.md-typeset .tabbed-labels>label:nth-child(12){order:12}.md-typeset .tabbed-labels>label:nth-child(13){order:13}.md-typeset .tabbed-labels>label:nth-child(14){order:14}.md-typeset .tabbed-labels>label:nth-child(15){order:15}.md-typeset .tabbed-labels>label:nth-child(16){order:16}.md-typeset .tabbed-labels>label:nth-child(17){order:17}.md-typeset .tabbed-labels>label:nth-child(18){order:18}.md-typeset .tabbed-labels>label:nth-child(19){order:19}.md-typeset .tabbed-labels>label:nth-child(20){order:20}}.md-typeset .tabbed-labels>label:hover{color:var(--md-default-fg-color)}.md-typeset .tabbed-labels>label>[href]:first-child{color:inherit}.md-typeset .tabbed-labels--linked>label{padding:0}.md-typeset .tabbed-labels--linked>label>a{display:block;padding:.78125em 1.25em .625em}.md-typeset .tabbed-content{width:100%}@media print{.md-typeset .tabbed-content{display:contents}}.md-typeset .tabbed-block{display:none}@media print{.md-typeset .tabbed-block{display:block}.md-typeset .tabbed-block:first-child{order:1}.md-typeset .tabbed-block:nth-child(2){order:2}.md-typeset .tabbed-block:nth-child(3){order:3}.md-typeset .tabbed-block:nth-child(4){order:4}.md-typeset .tabbed-block:nth-child(5){order:5}.md-typeset .tabbed-block:nth-child(6){order:6}.md-typeset .tabbed-block:nth-child(7){order:7}.md-typeset .tabbed-block:nth-child(8){order:8}.md-typeset .tabbed-block:nth-child(9){order:9}.md-typeset .tabbed-block:nth-child(10){order:10}.md-typeset .tabbed-block:nth-child(11){order:11}.md-typeset .tabbed-block:nth-child(12){order:12}.md-typeset .tabbed-block:nth-child(13){order:13}.md-typeset .tabbed-block:nth-child(14){order:14}.md-typeset .tabbed-block:nth-child(15){order:15}.md-typeset .tabbed-block:nth-child(16){order:16}.md-typeset .tabbed-block:nth-child(17){order:17}.md-typeset .tabbed-block:nth-child(18){order:18}.md-typeset .tabbed-block:nth-child(19){order:19}.md-typeset .tabbed-block:nth-child(20){order:20}}.md-typeset .tabbed-block>.highlight:first-child>pre,.md-typeset .tabbed-block>pre:first-child{margin:0}.md-typeset .tabbed-block>.highlight:first-child>pre>code,.md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child>.filename{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable{margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.filename span.filename,.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.linenos{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.code>div>pre>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child+.result{margin-top:-.125em}.md-typeset .tabbed-block>.tabbed-set{margin:0}.md-typeset .tabbed-button{align-self:center;border-radius:100%;color:var(--md-default-fg-color--light);cursor:pointer;display:block;height:.9rem;margin-top:.1rem;pointer-events:auto;transition:background-color .25s;width:.9rem}.md-typeset .tabbed-button:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .tabbed-button:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-tabbed-icon--prev);mask-image:var(--md-tabbed-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color .25s,transform .25s;width:100%}.md-typeset .tabbed-control{background:linear-gradient(to right,var(--md-default-bg-color) 60%,#0000);display:flex;height:1.9rem;justify-content:start;pointer-events:none;position:absolute;transition:opacity 125ms;width:1.2rem}[dir=rtl] .md-typeset .tabbed-control{transform:rotate(180deg)}.md-typeset .tabbed-control[hidden]{opacity:0}.md-typeset .tabbed-control--next{background:linear-gradient(to left,var(--md-default-bg-color) 60%,#0000);justify-content:end;right:0}.md-typeset .tabbed-control--next .tabbed-button:after{-webkit-mask-image:var(--md-tabbed-icon--next);mask-image:var(--md-tabbed-icon--next)}@media screen and (max-width:44.984375em){[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels{margin:0 -.8rem;max-width:100vw;scroll-padding-inline-start:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels:after{content:""}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-right:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-left:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-right:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{width:2rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-left:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-right:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-left:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{width:2rem}}@media screen{.md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){color:var(--md-default-fg-color)}.md-typeset .no-js .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .no-js .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .no-js .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .no-js .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .no-js .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .no-js .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .no-js .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .no-js .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .no-js .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .no-js .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .no-js .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .no-js .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .no-js .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .no-js .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .no-js .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .no-js .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .no-js .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .no-js .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .no-js .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .no-js .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.no-js .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.no-js .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.no-js .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.no-js .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.no-js .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.no-js .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.no-js .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.no-js .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.no-js .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.no-js .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.no-js .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.no-js .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.no-js .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.no-js .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.no-js .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.no-js .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.no-js .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.no-js .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.no-js .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.no-js .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){border-color:var(--md-default-fg-color)}}.md-typeset .tabbed-set>input:first-child.focus-visible~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10).focus-visible~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11).focus-visible~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12).focus-visible~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13).focus-visible~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14).focus-visible~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15).focus-visible~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16).focus-visible~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17).focus-visible~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18).focus-visible~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19).focus-visible~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2).focus-visible~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20).focus-visible~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3).focus-visible~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4).focus-visible~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5).focus-visible~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6).focus-visible~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7).focus-visible~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8).focus-visible~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9).focus-visible~.tabbed-labels>:nth-child(9){color:var(--md-accent-fg-color)}.md-typeset .tabbed-set>input:first-child:checked~.tabbed-content>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-content>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-content>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-content>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-content>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-content>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-content>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-content>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-content>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-content>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-content>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-content>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-content>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-content>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-content>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-content>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-content>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-content>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-content>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-content>:nth-child(9){display:block}:root{--md-tasklist-icon:url('data:image/svg+xml;charset=utf-8,');--md-tasklist-icon--checked:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .task-list-item{list-style-type:none;position:relative}[dir=ltr] .md-typeset .task-list-item [type=checkbox]{left:-2em}[dir=rtl] .md-typeset .task-list-item [type=checkbox]{right:-2em}.md-typeset .task-list-item [type=checkbox]{position:absolute;top:.45em}.md-typeset .task-list-control [type=checkbox]{opacity:0;z-index:-1}[dir=ltr] .md-typeset .task-list-indicator:before{left:-1.5em}[dir=rtl] .md-typeset .task-list-indicator:before{right:-1.5em}.md-typeset .task-list-indicator:before{background-color:var(--md-default-fg-color--lightest);content:"";height:1.25em;-webkit-mask-image:var(--md-tasklist-icon);mask-image:var(--md-tasklist-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.15em;width:1.25em}.md-typeset [type=checkbox]:checked+.task-list-indicator:before{background-color:#00e676;-webkit-mask-image:var(--md-tasklist-icon--checked);mask-image:var(--md-tasklist-icon--checked)}:root>*{--md-mermaid-font-family:var(--md-text-font-family),sans-serif;--md-mermaid-edge-color:var(--md-code-fg-color);--md-mermaid-node-bg-color:var(--md-accent-fg-color--transparent);--md-mermaid-node-fg-color:var(--md-accent-fg-color);--md-mermaid-label-bg-color:var(--md-default-bg-color);--md-mermaid-label-fg-color:var(--md-code-fg-color);--md-mermaid-sequence-actor-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actor-fg-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-actor-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-actor-line-color:var(--md-default-fg-color--lighter);--md-mermaid-sequence-actorman-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actorman-line-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-box-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-box-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-label-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-label-fg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-loop-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-loop-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-loop-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-message-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-message-line-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-note-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-border-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-number-bg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-number-fg-color:var(--md-accent-bg-color)}.mermaid{line-height:normal;margin:1em 0}.md-typeset .grid{grid-gap:.4rem;display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,16rem),1fr));margin:1em 0}.md-typeset .grid.cards>ol,.md-typeset .grid.cards>ul{display:contents}.md-typeset .grid.cards>ol>li,.md-typeset .grid.cards>ul>li,.md-typeset .grid>.card{border:.05rem solid var(--md-default-fg-color--lightest);border-radius:.1rem;display:block;margin:0;padding:.8rem;transition:border .25s,box-shadow .25s}.md-typeset .grid.cards>ol>li:focus-within,.md-typeset .grid.cards>ol>li:hover,.md-typeset .grid.cards>ul>li:focus-within,.md-typeset .grid.cards>ul>li:hover,.md-typeset .grid>.card:focus-within,.md-typeset .grid>.card:hover{border-color:#0000;box-shadow:var(--md-shadow-z2)}.md-typeset .grid.cards>ol>li>hr,.md-typeset .grid.cards>ul>li>hr,.md-typeset .grid>.card>hr{margin-bottom:1em;margin-top:1em}.md-typeset .grid.cards>ol>li>:first-child,.md-typeset .grid.cards>ul>li>:first-child,.md-typeset .grid>.card>:first-child{margin-top:0}.md-typeset .grid.cards>ol>li>:last-child,.md-typeset .grid.cards>ul>li>:last-child,.md-typeset .grid>.card>:last-child{margin-bottom:0}.md-typeset .grid>*,.md-typeset .grid>.admonition,.md-typeset .grid>.highlight>*,.md-typeset .grid>.highlighttable,.md-typeset .grid>.md-typeset details,.md-typeset .grid>details,.md-typeset .grid>pre{margin-bottom:0;margin-top:0}.md-typeset .grid>.highlight>pre:only-child,.md-typeset .grid>.highlight>pre>code,.md-typeset .grid>.highlighttable,.md-typeset .grid>.highlighttable>tbody,.md-typeset .grid>.highlighttable>tbody>tr,.md-typeset .grid>.highlighttable>tbody>tr>.code,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre>code{height:100%}.md-typeset .grid>.tabbed-set{margin-bottom:0;margin-top:0}@media screen and (min-width:45em){[dir=ltr] .md-typeset .inline{float:left}[dir=rtl] .md-typeset .inline{float:right}[dir=ltr] .md-typeset .inline{margin-right:.8rem}[dir=rtl] .md-typeset .inline{margin-left:.8rem}.md-typeset .inline{margin-bottom:.8rem;margin-top:0;width:11.7rem}[dir=ltr] .md-typeset .inline.end{float:right}[dir=rtl] .md-typeset .inline.end{float:left}[dir=ltr] .md-typeset .inline.end{margin-left:.8rem;margin-right:0}[dir=rtl] .md-typeset .inline.end{margin-left:0;margin-right:.8rem}} \ No newline at end of file diff --git a/1.3.0/assets/stylesheets/main.f2e4d321.min.css.map b/1.3.0/assets/stylesheets/main.f2e4d321.min.css.map deleted file mode 100644 index 63101455..00000000 --- a/1.3.0/assets/stylesheets/main.f2e4d321.min.css.map +++ /dev/null @@ -1 +0,0 @@ -{"version":3,"sources":["src/templates/assets/stylesheets/main/components/_meta.scss","../../../../src/templates/assets/stylesheets/main.scss","src/templates/assets/stylesheets/main/_resets.scss","src/templates/assets/stylesheets/main/_colors.scss","src/templates/assets/stylesheets/main/_icons.scss","src/templates/assets/stylesheets/main/_typeset.scss","src/templates/assets/stylesheets/utilities/_break.scss","src/templates/assets/stylesheets/main/components/_author.scss","src/templates/assets/stylesheets/main/components/_banner.scss","src/templates/assets/stylesheets/main/components/_base.scss","src/templates/assets/stylesheets/main/components/_clipboard.scss","src/templates/assets/stylesheets/main/components/_consent.scss","src/templates/assets/stylesheets/main/components/_content.scss","src/templates/assets/stylesheets/main/components/_dialog.scss","src/templates/assets/stylesheets/main/components/_feedback.scss","src/templates/assets/stylesheets/main/components/_footer.scss","src/templates/assets/stylesheets/main/components/_form.scss","src/templates/assets/stylesheets/main/components/_header.scss","node_modules/material-design-color/material-color.scss","src/templates/assets/stylesheets/main/components/_nav.scss","src/templates/assets/stylesheets/main/components/_pagination.scss","src/templates/assets/stylesheets/main/components/_post.scss","src/templates/assets/stylesheets/main/components/_progress.scss","src/templates/assets/stylesheets/main/components/_search.scss","src/templates/assets/stylesheets/main/components/_select.scss","src/templates/assets/stylesheets/main/components/_sidebar.scss","src/templates/assets/stylesheets/main/components/_source.scss","src/templates/assets/stylesheets/main/components/_status.scss","src/templates/assets/stylesheets/main/components/_tabs.scss","src/templates/assets/stylesheets/main/components/_tag.scss","src/templates/assets/stylesheets/main/components/_tooltip.scss","src/templates/assets/stylesheets/main/components/_top.scss","src/templates/assets/stylesheets/main/components/_version.scss","src/templates/assets/stylesheets/main/extensions/markdown/_admonition.scss","src/templates/assets/stylesheets/main/extensions/markdown/_footnotes.scss","src/templates/assets/stylesheets/main/extensions/markdown/_toc.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_arithmatex.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_critic.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_details.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_emoji.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_highlight.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_keys.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tabbed.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tasklist.scss","src/templates/assets/stylesheets/main/integrations/_mermaid.scss","src/templates/assets/stylesheets/main/modifiers/_grid.scss","src/templates/assets/stylesheets/main/modifiers/_inline.scss"],"names":[],"mappings":"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4DACE,oBhC4wGJ,CgCzwGI,sFACE,gChC2wGN,CgCtwGE,oEACE,0BhCywGJ,CgCtwGI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ChCwwGN,CgCpwGI,gFACE,ahCswGN,CgC3xGE,8DACE,oBhC8xGJ,CgC3xGI,wFACE,gChC6xGN,CgCxxGE,sEACE,0BhC2xGJ,CgCxxGI,oFACE,wBAlBG,CAmBH,sDAAA,CAAA,8ChC0xGN,CgCtxGI,kFACE,ahCwxGN,CgC7yGE,4DACE,oBhCgzGJ,CgC7yGI,sFACE,gChC+yGN,CgC1yGE,oEACE,0BhC6yGJ,CgC1yGI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ChC4yGN,CgCxyGI,gFACE,ahC0yGN,CgC/zGE,4DACE,oBhCk0GJ,CgC/zGI,sFACE,gChCi0GN,CgC5zGE,oEACE,0BhC+zGJ,CgC5zGI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ChC8zGN,CgC1zGI,gFACE,ahC4zGN,CgCj1GE,0DACE,oBhCo1GJ,CgCj1GI,oFACE,gChCm1GN,CgC90GE,kEACE,0BhCi1GJ,CgC90GI,gFACE,wBAlBG,CAmBH,oDAAA,CAAA,4ChCg1GN,CgC50GI,8EACE,ahC80GN,CgCn2GE,oDACE,oBhCs2GJ,CgCn2GI,8EACE,gChCq2GN,CgCh2GE,4DACE,0BhCm2GJ,CgCh2GI,0EACE,wBAlBG,CAmBH,iDAAA,CAAA,yChCk2GN,CgC91GI,wEACE,ahCg2GN,CgCr3GE,4DACE,oBhCw3GJ,CgCr3GI,sFACE,gChCu3GN,CgCl3GE,oEACE,0BhCq3GJ,CgCl3GI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ChCo3GN,CgCh3GI,gFACE,ahCk3GN,CgCv4GE,wDACE,oBhC04GJ,CgCv4GI,kFACE,gChCy4GN,CgCp4GE,gEACE,0BhCu4GJ,CgCp4GI,8EACE,wBAlBG,CAmBH,mDAAA,CAAA,2ChCs4GN,CgCl4GI,4EACE,ahCo4GN,CiCxiHA,MACE,wMjC2iHF,CiCliHE,sBAEE,uCAAA,CADA,gBjCsiHJ,CiCliHI,mCACE,ajCoiHN,CiCriHI,mCACE,cjCoiHN,CiChiHM,4BACE,sBjCkiHR,CiC/hHQ,mCACE,gCjCiiHV,CiC7hHQ,2DACE,SAAA,CAEA,uBAAA,CADA,ejCgiHV,CiC3hHQ,yGACE,SAAA,CACA,uBjC6hHV,CiCzhHQ,yCACE,YjC2hHV,CiCphHE,0BACE,eAAA,CACA,ejCshHJ,CiCnhHI,+BACE,oBjCqhHN,CiChhHE,gDACE,YjCkhHJ,CiC9gHE,8BAIE,+BAAA,CAHA,oBAAA,CAEA,WAAA,CAGA,SAAA,CAKA,4BAAA,CAJA,4DACE,CAHF,0BjCkhHJ,CiCzgHI,aAdF,8BAeI,+BAAA,CACA,SAAA,CACA,uBjC4gHJ,CACF,CiCzgHI,wCACE,6BjC2gHN,CiCvgHI,oCACE,+BjCygHN,CiCrgHI,qCAKE,6BAAA,CADA,UAAA,CAHA,oBAAA,CAEA,YAAA,CAGA,2CAAA,CAAA,mCAAA,CACA,4BAAA,CAAA,oBAAA,CACA,6BAAA,CAAA,qBAAA,CACA,yBAAA,CAAA,iBAAA,CAPA,WjC8gHN,CiCjgHQ,mDACE,oBjCmgHV,CkCjnHE,kCAEE,iBlCunHJ,CkCznHE,kCAEE,kBlCunHJ,CkCznHE,wBAGE,yCAAA,CAFA,oBAAA,CAGA,SAAA,CACA,mClConHJ,CkC/mHI,aAVF,wBAWI,YlCknHJ,CACF,CkC9mHE,6FAEE,SAAA,CACA,mClCgnHJ,CkC1mHE,4FAEE,+BlC4mHJ,CkCxmHE,oBACE,yBAAA,CACA,uBAAA,CAGA,yElCwmHJ,CKz+GI,sC6BrHE,qDACE,uBlCimHN,CACF,CkC5lHE,kEACE,yBlC8lHJ,CkC1lHE,sBACE,0BlC4lHJ,CmCvpHE,2BACE,anC0pHJ,CKr+GI,0C8BtLF,2BAKI,enC0pHJ,CmCvpHI,6BACE,yBAAA,CAAA,iBnCypHN,CACF,CmCrpHI,6BAEE,0BAAA,CAAA,2BAAA,CADA,eAAA,CAEA,iBnCupHN,CmCppHM,2CACE,kBnCspHR,CmChpHI,6CACE,QnCkpHN,CoC9qHE,uBACE,4CpCkrHJ,CoC7qHE,8CAJE,kCAAA,CAAA,0BpCqrHJ,CoCjrHE,uBACE,4CpCgrHJ,CoC3qHE,4BAEE,kCAAA,CAAA,0BAAA,CADA,qCpC8qHJ,CoC1qHI,mCACE,apC4qHN,CoCxqHI,kCACE,apC0qHN,CoCrqHE,0BAKE,eAAA,CAJA,aAAA,CAEA,YAAA,CACA,aAAA,CAFA,kBAAA,CAAA,mBpC0qHJ,CoCpqHI,uCACE,epCsqHN,CoClqHI,sCACE,kBpCoqHN,CqCjtHA,MACE,8LrCotHF,CqC3sHE,oBAGE,iBAAA,CAEA,gBAAA,CADA,arC6sHJ,CqCzsHI,wCACE,uBrC2sHN,CqCvsHI,gCAEE,eAAA,CADA,gBrC0sHN,CqCnsHM,wCACE,mBrCqsHR,CqC/rHE,8BAKE,oBrCmsHJ,CqCxsHE,8BAKE,mBrCmsHJ,CqCxsHE,8BAUE,4BrC8rHJ,CqCxsHE,4DAWE,6BrC6rHJ,CqCxsHE,8BAWE,4BrC6rHJ,CqCxsHE,oBASE,cAAA,CANA,aAAA,CACA,eAAA,CAIA,erCgsHJ,CqC1rHI,kCACE,uCAAA,CACA,oBrC4rHN,CqCxrHI,wCAEE,uCAAA,CADA,YrC2rHN,CqCtrHI,oCASE,WrC4rHN,CqCrsHI,oCASE,UrC4rHN,CqCrsHI,0BAME,6BAAA,CADA,UAAA,CADA,WAAA,CAMA,yCAAA,CAAA,iCAAA,CACA,4BAAA,CAAA,oBAAA,CACA,6BAAA,CAAA,qBAAA,CACA,yBAAA,CAAA,iBAAA,CAZA,iBAAA,CACA,UAAA,CAMA,sBAAA,CADA,yBAAA,CAJA,UrCksHN,CqCrrHM,oCACE,wBrCurHR,CqClrHI,4BACE,YrCorHN,CqC/qHI,4CACE,YrCirHN,CsC3wHE,+DACE,sBAAA,CAEA,mBAAA,CACA,0BAAA,CACA,uBtC6wHJ,CsC1wHI,2EAGE,iBAAA,CADA,eAAA,CADA,yBtC8wHN,CsCvwHE,mEACE,0BtCywHJ,CsCrwHE,oBACE,qBtCuwHJ,CsCnwHE,gBACE,oBtCqwHJ,CsCjwHE,gBACE,qBtCmwHJ,CsC/vHE,iBACE,kBtCiwHJ,CsC7vHE,kBACE,kBtC+vHJ,CuCxyHE,6BACE,sCvC2yHJ,CuCxyHE,cACE,yCvC0yHJ,CuC9xHE,sIACE,oCvCgyHJ,CuCxxHE,2EACE,qCvC0xHJ,CuChxHE,wGACE,oCvCkxHJ,CuCzwHE,yFACE,qCvC2wHJ,CuCtwHE,6BACE,kCvCwwHJ,CuClwHE,6CACE,sCvCowHJ,CuC7vHE,4DACE,sCvC+vHJ,CuCxvHE,4DACE,qCvC0vHJ,CuCjvHE,yFACE,qCvCmvHJ,CuC3uHE,2EACE,sCvC6uHJ,CuCluHE,wHACE,qCvCouHJ,CuC/tHE,8BAGE,mBAAA,CADA,gBAAA,CADA,gBvCmuHJ,CuC9tHE,eACE,4CvCguHJ,CuC7tHE,eACE,4CvC+tHJ,CuC3tHE,gBAIE,+CAAA,CACA,kDAAA,CAJA,aAAA,CAEA,wBAAA,CADA,wBvCguHJ,CuCztHE,yBAOE,wCAAA,CACA,+DAAA,CACA,4BAAA,CACA,6BAAA,CARA,iBAAA,CAGA,eAAA,CACA,eAAA,CAFA,cAAA,CADA,oCAAA,CAFA,iBvCouHJ,CuCxtHI,6BACE,YvC0tHN,CuCvtHM,kCACE,wBAAA,CACA,yBvCytHR,CuCntHE,iCAaE,wCAAA,CACA,+DAAA,CAJA,uCAAA,CACA,0BAAA,CALA,UAAA,CAJA,oBAAA,CAOA,2BAAA,CADA,2BAAA,CADA,2BAAA,CANA,eAAA,CAWA,wBAAA,CAAA,gBAAA,CAPA,SvC4tHJ,CuC1sHE,sBACE,iBAAA,CACA,iBvC4sHJ,CuCpsHI,sCACE,gBvCssHN,CuClsHI,gDACE,YvCosHN,CuC1rHA,gBACE,iBvC6rHF,CuCzrHE,yCACE,aAAA,CACA,SvC2rHJ,CuCtrHE,mBACE,YvCwrHJ,CuCnrHE,oBACE,QvCqrHJ,CuCjrHE,4BACE,WAAA,CACA,SAAA,CACA,evCmrHJ,CuChrHI,0CACE,YvCkrHN,CuC5qHE,yBAKE,wCAAA,CAEA,+BAAA,CADA,4BAAA,CAHA,eAAA,CADA,oDAAA,CAEA,wBAAA,CAAA,gBvCirHJ,CuC1qHE,2BAEE,+DAAA,CADA,2BvC6qHJ,CuCzqHI,+BACE,uCAAA,CACA,gBvC2qHN,CuCtqHE,sBACE,MAAA,CACA,WvCwqHJ,CuCnqHA,aACE,avCsqHF,CuC5pHE,4BAEE,aAAA,CADA,YvCgqHJ,CuC5pHI,wDAEE,2BAAA,CADA,wBvC+pHN,CuCzpHE,+BAKE,2CAAA,CAEA,+BAAA,CADA,gCAAA,CADA,sBAAA,CAHA,mBAAA,CACA,gBAAA,CAFA,avCiqHJ,CuCxpHI,qCAEE,UAAA,CACA,UAAA,CAFA,avC4pHN,CK9xHI,0CkCiJF,8BACE,iBvCipHF,CuCvoHE,wSAGE,evC6oHJ,CuCzoHE,sCAEE,mBAAA,CACA,eAAA,CADA,oBAAA,CADA,kBAAA,CAAA,mBvC6oHJ,CACF,CwCr+HI,yDAIE,+BAAA,CACA,8BAAA,CAFA,aAAA,CADA,QAAA,CADA,iBxC2+HN,CwCn+HI,uBAEE,uCAAA,CADA,cxCs+HN,CwCj7HM,iHAEE,WAlDkB,CAiDlB,kBxC47HR,CwC77HM,6HAEE,WAlDkB,CAiDlB,kBxCw8HR,CwCz8HM,6HAEE,WAlDkB,CAiDlB,kBxCo9HR,CwCr9HM,oHAEE,WAlDkB,CAiDlB,kBxCg+HR,CwCj+HM,0HAEE,WAlDkB,CAiDlB,kBxC4+HR,CwC7+HM,uHAEE,WAlDkB,CAiDlB,kBxCw/HR,CwCz/HM,uHAEE,WAlDkB,CAiDlB,kBxCogIR,CwCrgIM,6HAEE,WAlDkB,CAiDlB,kBxCghIR,CwCjhIM,yCAEE,WAlDkB,CAiDlB,kBxCohIR,CwCrhIM,yCAEE,WAlDkB,CAiDlB,kBxCwhIR,CwCzhIM,0CAEE,WAlDkB,CAiDlB,kBxC4hIR,CwC7hIM,uCAEE,WAlDkB,CAiDlB,kBxCgiIR,CwCjiIM,wCAEE,WAlDkB,CAiDlB,kBxCoiIR,CwCriIM,sCAEE,WAlDkB,CAiDlB,kBxCwiIR,CwCziIM,wCAEE,WAlDkB,CAiDlB,kBxC4iIR,CwC7iIM,oCAEE,WAlDkB,CAiDlB,kBxCgjIR,CwCjjIM,2CAEE,WAlDkB,CAiDlB,kBxCojIR,CwCrjIM,qCAEE,WAlDkB,CAiDlB,kBxCwjIR,CwCzjIM,oCAEE,WAlDkB,CAiDlB,kBxC4jIR,CwC7jIM,kCAEE,WAlDkB,CAiDlB,kBxCgkIR,CwCjkIM,qCAEE,WAlDkB,CAiDlB,kBxCokIR,CwCrkIM,mCAEE,WAlDkB,CAiDlB,kBxCwkIR,CwCzkIM,qCAEE,WAlDkB,CAiDlB,kBxC4kIR,CwC7kIM,wCAEE,WAlDkB,CAiDlB,kBxCglIR,CwCjlIM,sCAEE,WAlDkB,CAiDlB,kBxColIR,CwCrlIM,2CAEE,WAlDkB,CAiDlB,kBxCwlIR,CwC7kIM,iCAEE,WAPkB,CAMlB,iBxCglIR,CwCjlIM,uCAEE,WAPkB,CAMlB,iBxColIR,CwCrlIM,mCAEE,WAPkB,CAMlB,iBxCwlIR,CyC1qIA,MACE,qMAAA,CACA,mMzC6qIF,CyCpqIE,wBAKE,mBAAA,CAHA,YAAA,CACA,qBAAA,CACA,YAAA,CAHA,iBzC2qIJ,CyCjqII,8BAGE,QAAA,CACA,SAAA,CAHA,iBAAA,CACA,OzCqqIN,CyChqIM,qCACE,0BzCkqIR,CyCroIM,kEACE,0CzCuoIR,CyCjoIE,2BAKE,uBAAA,CADA,+DAAA,CAHA,YAAA,CACA,cAAA,CACA,aAAA,CAGA,oBzCmoIJ,CyChoII,aATF,2BAUI,gBzCmoIJ,CACF,CyChoII,cAGE,+BACE,iBzCgoIN,CyC7nIM,sCAQE,qCAAA,CANA,QAAA,CAKA,UAAA,CAHA,aAAA,CAEA,UAAA,CAHA,MAAA,CAFA,iBAAA,CAaA,2CAAA,CALA,2DACE,CAGF,kDAAA,CARA,+BzCqoIR,CACF,CyCvnII,8CACE,YzCynIN,CyCrnII,iCASE,+BAAA,CACA,6BAAA,CAJA,uCAAA,CAEA,cAAA,CAPA,aAAA,CAGA,gBAAA,CACA,eAAA,CAFA,8BAAA,CAWA,+BAAA,CAHA,2CACE,CALF,kBAAA,CALA,UzCioIN,CyClnIM,aAII,6CACE,OzCinIV,CyClnIQ,8CACE,OzConIV,CyCrnIQ,8CACE,OzCunIV,CyCxnIQ,8CACE,OzC0nIV,CyC3nIQ,8CACE,OzC6nIV,CyC9nIQ,8CACE,OzCgoIV,CyCjoIQ,8CACE,OzCmoIV,CyCpoIQ,8CACE,OzCsoIV,CyCvoIQ,8CACE,OzCyoIV,CyC1oIQ,+CACE,QzC4oIV,CyC7oIQ,+CACE,QzC+oIV,CyChpIQ,+CACE,QzCkpIV,CyCnpIQ,+CACE,QzCqpIV,CyCtpIQ,+CACE,QzCwpIV,CyCzpIQ,+CACE,QzC2pIV,CyC5pIQ,+CACE,QzC8pIV,CyC/pIQ,+CACE,QzCiqIV,CyClqIQ,+CACE,QzCoqIV,CyCrqIQ,+CACE,QzCuqIV,CyCxqIQ,+CACE,QzC0qIV,CACF,CyCrqIM,uCACE,gCzCuqIR,CyCnqIM,oDACE,azCqqIR,CyChqII,yCACE,SzCkqIN,CyC9pIM,2CACE,aAAA,CACA,8BzCgqIR,CyC1pIE,4BACE,UzC4pIJ,CyCzpII,aAJF,4BAKI,gBzC4pIJ,CACF,CyCxpIE,0BACE,YzC0pIJ,CyCvpII,aAJF,0BAKI,azC0pIJ,CyCtpIM,sCACE,OzCwpIR,CyCzpIM,uCACE,OzC2pIR,CyC5pIM,uCACE,OzC8pIR,CyC/pIM,uCACE,OzCiqIR,CyClqIM,uCACE,OzCoqIR,CyCrqIM,uCACE,OzCuqIR,CyCxqIM,uCACE,OzC0qIR,CyC3qIM,uCACE,OzC6qIR,CyC9qIM,uCACE,OzCgrIR,CyCjrIM,wCACE,QzCmrIR,CyCprIM,wCACE,QzCsrIR,CyCvrIM,wCACE,QzCyrIR,CyC1rIM,wCACE,QzC4rIR,CyC7rIM,wCACE,QzC+rIR,CyChsIM,wCACE,QzCksIR,CyCnsIM,wCACE,QzCqsIR,CyCtsIM,wCACE,QzCwsIR,CyCzsIM,wCACE,QzC2sIR,CyC5sIM,wCACE,QzC8sIR,CyC/sIM,wCACE,QzCitIR,CACF,CyC3sII,+FAEE,QzC6sIN,CyC1sIM,yGACE,wBAAA,CACA,yBzC6sIR,CyCpsIM,2DAEE,wBAAA,CACA,yBAAA,CAFA,QzCwsIR,CyCjsIM,iEACE,QzCmsIR,CyChsIQ,qLAGE,wBAAA,CACA,yBAAA,CAFA,QzCosIV,CyC9rIQ,6FACE,wBAAA,CACA,yBzCgsIV,CyC3rIM,yDACE,kBzC6rIR,CyCxrII,sCACE,QzC0rIN,CyCrrIE,2BAEE,iBAAA,CAOA,kBAAA,CAHA,uCAAA,CAEA,cAAA,CAPA,aAAA,CAGA,YAAA,CACA,gBAAA,CAEA,mBAAA,CAGA,gCAAA,CAPA,WzC8rIJ,CyCprII,iCAEE,uDAAA,CADA,+BzCurIN,CyClrII,iCAKE,6BAAA,CADA,UAAA,CAHA,aAAA,CAEA,WAAA,CAMA,8CAAA,CAAA,sCAAA,CACA,4BAAA,CAAA,oBAAA,CACA,6BAAA,CAAA,qBAAA,CACA,yBAAA,CAAA,iBAAA,CANA,+CACE,CALF,UzC4rIN,CyC7qIE,4BAOE,yEACE,CANF,YAAA,CAGA,aAAA,CAFA,qBAAA,CAGA,mBAAA,CALA,iBAAA,CAYA,wBAAA,CATA,YzCmrIJ,CyCvqII,sCACE,wBzCyqIN,CyCrqII,oCACE,SzCuqIN,CyCnqII,kCAGE,wEACE,CAFF,mBAAA,CADA,OzCuqIN,CyC7pIM,uDACE,8CAAA,CAAA,sCzC+pIR,CKtyII,0CoCqJF,wDAEE,kBzCupIF,CyCzpIA,wDAEE,mBzCupIF,CyCzpIA,8CAGE,eAAA,CAFA,eAAA,CAGA,iCzCqpIF,CyCjpIE,8DACE,mBzCopIJ,CyCrpIE,8DACE,kBzCopIJ,CyCrpIE,oDAEE,UzCmpIJ,CyC/oIE,8EAEE,kBzCkpIJ,CyCppIE,8EAEE,mBzCkpIJ,CyCppIE,8EAGE,kBzCipIJ,CyCppIE,8EAGE,mBzCipIJ,CyCppIE,oEACE,UzCmpIJ,CyC7oIE,8EAEE,mBzCgpIJ,CyClpIE,8EAEE,kBzCgpIJ,CyClpIE,8EAGE,mBzC+oIJ,CyClpIE,8EAGE,kBzC+oIJ,CyClpIE,oEACE,UzCipIJ,CACF,CyCnoIE,cAHF,olDAII,gCzCsoIF,CyCnoIE,g8GACE,uCzCqoIJ,CACF,CyChoIA,4sDACE,+BzCmoIF,CyC/nIA,wmDACE,azCkoIF,C0CtgJA,MACE,8WAAA,CACA,uX1CygJF,C0ChgJE,4BAEE,oBAAA,CADA,iB1CogJJ,C0C//II,sDAGE,S1CigJN,C0CpgJI,sDAGE,U1CigJN,C0CpgJI,4CACE,iBAAA,CACA,S1CkgJN,C0C5/IE,+CAEE,SAAA,CADA,U1C+/IJ,C0C1/IE,kDAOE,W1CggJJ,C0CvgJE,kDAOE,Y1CggJJ,C0CvgJE,wCAME,qDAAA,CADA,UAAA,CADA,aAAA,CAIA,0CAAA,CAAA,kCAAA,CACA,4BAAA,CAAA,oBAAA,CACA,6BAAA,CAAA,qBAAA,CACA,yBAAA,CAAA,iBAAA,CAVA,iBAAA,CACA,SAAA,CACA,Y1CogJJ,C0Cx/IE,gEACE,wBzB2Wa,CyB1Wb,mDAAA,CAAA,2C1C0/IJ,C2C1iJA,QACE,8DAAA,CAGA,+CAAA,CACA,iEAAA,CACA,oDAAA,CACA,sDAAA,CACA,mDAAA,CAGA,qEAAA,CACA,qEAAA,CACA,wEAAA,CACA,0EAAA,CACA,wEAAA,CACA,yEAAA,CACA,kEAAA,CACA,+DAAA,CACA,oEAAA,CACA,oEAAA,CACA,mEAAA,CACA,gEAAA,CACA,uEAAA,CACA,mEAAA,CACA,qEAAA,CACA,oEAAA,CACA,gEAAA,CACA,wEAAA,CACA,qEAAA,CACA,+D3CyiJF,C2CniJA,SAEE,kBAAA,CADA,Y3CuiJF,C4CzkJE,kBAUE,cAAA,CATA,YAAA,CACA,kEACE,CAQF,Y5CqkJJ,C4CjkJI,sDACE,gB5CmkJN,C4C7jJI,oFAKE,wDAAA,CACA,mBAAA,CAJA,aAAA,CAEA,QAAA,CADA,aAAA,CAIA,sC5C+jJN,C4C1jJM,iOACE,kBAAA,CACA,8B5C6jJR,C4CzjJM,6FACE,iBAAA,CAAA,c5C4jJR,C4CxjJM,2HACE,Y5C2jJR,C4CvjJM,wHACE,e5C0jJR,C4C3iJI,yMAGE,eAAA,CAAA,Y5CmjJN,C4CriJI,ybAOE,W5C2iJN,C4CviJI,8BACE,eAAA,CAAA,Y5CyiJN,CKr+II,mCwChKA,8BACE,U7C6oJJ,C6C9oJE,8BACE,W7C6oJJ,C6C9oJE,8BAGE,kB7C2oJJ,C6C9oJE,8BAGE,iB7C2oJJ,C6C9oJE,oBAKE,mBAAA,CADA,YAAA,CAFA,a7C4oJJ,C6CtoJI,kCACE,W7CyoJN,C6C1oJI,kCACE,U7CyoJN,C6C1oJI,kCAEE,iBAAA,CAAA,c7CwoJN,C6C1oJI,kCAEE,aAAA,CAAA,kB7CwoJN,CACF","file":"main.css"} \ No newline at end of file diff --git a/1.3.0/createdisplaymodes/index.html b/1.3.0/createdisplaymodes/index.html index 42d0fd63..07a05d3f 100644 --- a/1.3.0/createdisplaymodes/index.html +++ b/1.3.0/createdisplaymodes/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1746,6 +1746,8 @@ + + @@ -1863,6 +1865,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/customwebformelements/index.html b/1.3.0/customwebformelements/index.html index 211db5a4..064dc062 100644 --- a/1.3.0/customwebformelements/index.html +++ b/1.3.0/customwebformelements/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1690,6 +1690,8 @@ + + @@ -1845,6 +1847,15 @@ + + +
  • + + + Custom/Local Webform LoD Elements + + +
  • @@ -1907,6 +1918,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + @@ -2824,6 +2856,15 @@ + + +
  • + + + Custom/Local Webform LoD Elements + + +
  • @@ -2919,7 +2960,7 @@

    Archipelago Custom Webform Elements

    -

    In addition to the core elements provided by the Drupal Webform module, Archipelago also deploys a robust set of custom webform elements specific to digital repositories metadata needs and use cases.

    +

    In addition to the core elements provided by the Drupal Webform module, Archipelago also deploys a robust set of custom webform elements specific to digital repositories metadata needs and use cases.

    Linked Data:

    (*found under Composite Elements in "Add Element" menu)

    • +

    Custom/Local Webform LoD Elements

    +

    (*also found under Composite Elements in "Add Element" menu)

    +

    File Upload Elements:

    But wait there's more!

    You can review the coding behind these custom elements here: -https://github.com/esmero/webform_strawberryfield/tree/1.1.0/src/Element

    +https://github.com/esmero/webform_strawberryfield/tree/1.3.0/src/Element

    +
    +

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    +

    Return to the Archipelago Documentation main page.

    @@ -3075,7 +3136,7 @@

    But wait there's more!

    - August 15, 2023 + February 14, 2024 diff --git a/1.3.0/devops/index.html b/1.3.0/devops/index.html index cb46c205..67d8e992 100644 --- a/1.3.0/devops/index.html +++ b/1.3.0/devops/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1753,6 +1753,8 @@ + + @@ -1870,6 +1872,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/documentation_about/index.html b/1.3.0/documentation_about/index.html index f4944c97..16e78e33 100644 --- a/1.3.0/documentation_about/index.html +++ b/1.3.0/documentation_about/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1684,6 +1684,8 @@ + + @@ -1801,6 +1803,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/documentation_features/index.html b/1.3.0/documentation_features/index.html index 50683964..500bb4ad 100644 --- a/1.3.0/documentation_features/index.html +++ b/1.3.0/documentation_features/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1684,6 +1684,8 @@ + + @@ -1801,6 +1803,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/documentation_technical/index.html b/1.3.0/documentation_technical/index.html index 5d554e2b..526ab0d9 100644 --- a/1.3.0/documentation_technical/index.html +++ b/1.3.0/documentation_technical/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1684,6 +1684,8 @@ + + @@ -1801,6 +1803,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/documentation_template/index.html b/1.3.0/documentation_template/index.html index b40602d8..3cbce058 100644 --- a/1.3.0/documentation_template/index.html +++ b/1.3.0/documentation_template/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1684,6 +1684,8 @@ + + @@ -1801,6 +1803,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/documentation_workflow/index.html b/1.3.0/documentation_workflow/index.html index ad86a66e..9431d814 100644 --- a/1.3.0/documentation_workflow/index.html +++ b/1.3.0/documentation_workflow/index.html @@ -18,7 +18,7 @@ - + @@ -26,7 +26,7 @@ - + @@ -1680,6 +1680,8 @@ + + @@ -1797,6 +1799,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/drupal_core_update/index.html b/1.3.0/drupal_core_update/index.html index a5bb2486..4b9d3600 100644 --- a/1.3.0/drupal_core_update/index.html +++ b/1.3.0/drupal_core_update/index.html @@ -18,7 +18,7 @@ - + @@ -26,7 +26,7 @@ - + @@ -1680,6 +1680,8 @@ + + @@ -1797,6 +1799,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/find_and_replace/index.html b/1.3.0/find_and_replace/index.html index bf91a4c9..49fbdf33 100644 --- a/1.3.0/find_and_replace/index.html +++ b/1.3.0/find_and_replace/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1688,6 +1688,8 @@ + + @@ -1805,6 +1807,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/find_and_replace_action_json_patch/index.html b/1.3.0/find_and_replace_action_json_patch/index.html index 5207d26b..e1e1ba8f 100644 --- a/1.3.0/find_and_replace_action_json_patch/index.html +++ b/1.3.0/find_and_replace_action_json_patch/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1688,6 +1688,8 @@ + + @@ -1805,6 +1807,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/find_and_replace_action_text/index.html b/1.3.0/find_and_replace_action_text/index.html index a942b3ed..ea2480cd 100644 --- a/1.3.0/find_and_replace_action_text/index.html +++ b/1.3.0/find_and_replace_action_text/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1688,6 +1688,8 @@ + + @@ -1805,6 +1807,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/find_and_replace_action_webform/index.html b/1.3.0/find_and_replace_action_webform/index.html index 6a9f876f..638c8bb9 100644 --- a/1.3.0/find_and_replace_action_webform/index.html +++ b/1.3.0/find_and_replace_action_webform/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1688,6 +1688,8 @@ + + @@ -1805,6 +1807,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/firstobject/index.html b/1.3.0/firstobject/index.html index 41a4baa0..1a5cc7ef 100644 --- a/1.3.0/firstobject/index.html +++ b/1.3.0/firstobject/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1761,6 +1761,8 @@ + + @@ -1878,6 +1880,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/fragaria/index.html b/1.3.0/fragaria/index.html index e0ba55bb..9581320c 100644 --- a/1.3.0/fragaria/index.html +++ b/1.3.0/fragaria/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1761,6 +1761,8 @@ + + @@ -1878,6 +1880,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/generalqa_minio_logging/index.html b/1.3.0/generalqa_minio_logging/index.html index a09a2204..3a9e2778 100644 --- a/1.3.0/generalqa_minio_logging/index.html +++ b/1.3.0/generalqa_minio_logging/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1700,6 +1700,8 @@ + + @@ -1817,6 +1819,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/generalqa_smtp_configuration/index.html b/1.3.0/generalqa_smtp_configuration/index.html index 7f71a4b5..cdb76e63 100644 --- a/1.3.0/generalqa_smtp_configuration/index.html +++ b/1.3.0/generalqa_smtp_configuration/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1700,6 +1700,8 @@ + + @@ -1817,6 +1819,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/generalqa_twig_modules_configuration/index.html b/1.3.0/generalqa_twig_modules_configuration/index.html index 5b05b317..e7f255b5 100644 --- a/1.3.0/generalqa_twig_modules_configuration/index.html +++ b/1.3.0/generalqa_twig_modules_configuration/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1700,6 +1700,8 @@ + + @@ -1817,6 +1819,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/giveortake/index.html b/1.3.0/giveortake/index.html index 91b7ef83..2807292d 100644 --- a/1.3.0/giveortake/index.html +++ b/1.3.0/giveortake/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1684,6 +1684,8 @@ + + @@ -1801,6 +1803,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/googleapi/index.html b/1.3.0/googleapi/index.html index 6333bcd4..95519d44 100644 --- a/1.3.0/googleapi/index.html +++ b/1.3.0/googleapi/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1686,6 +1686,8 @@ + + @@ -1803,6 +1805,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/images/DefaultArchipelagoWebforms.png b/1.3.0/images/DefaultArchipelagoWebforms.png new file mode 100644 index 0000000000000000000000000000000000000000..919e43bf10e88da4d45228ae9252402bf4abdf0e GIT binary patch literal 315437 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%0A|cQ*Q3-?`l(dQS>I+;r6Hng75LBO7} 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 BGspk{ literal 0 HcmV?d00001 diff --git a/1.3.0/images/WebformAddElement.png b/1.3.0/images/WebformAddElement.png new file mode 100644 index 0000000000000000000000000000000000000000..0da7b91cd0b75e4c2a59a66ff393d9a173d329a1 GIT binary patch literal 34060 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%0Ak+f%b1j8_j|nf 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 a9BUu_Mt}2#3gh8>U)67G-6~ME3i&?<^%KSb literal 0 HcmV?d00001 diff --git a/1.3.0/images/WebformLoDfromCSVaddElement.png b/1.3.0/images/WebformLoDfromCSVaddElement.png new file mode 100644 index 0000000000000000000000000000000000000000..02ff3d54491896e53f41d6c7ef4bdcb3921e0709 GIT binary patch literal 101660 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%0DQVTN06h$8x0nco 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�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 z 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�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 literal 0 HcmV?d00001 diff --git a/1.3.0/images/WebformLoDfromCSVautocompleteSettings.png b/1.3.0/images/WebformLoDfromCSVautocompleteSettings.png new file mode 100644 index 0000000000000000000000000000000000000000..89118ad921c679b889e9aa6a81462cb1a8b47793 GIT binary patch literal 107758 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

    C1 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�Z4ILPrK@qS;VQ=x@V&Tw1Q)h0p02NDa^>5=?f<^9}dfZte{ zVqPKr{+ZxrgCsfY$CF{6Rmrm&-Ltb3yF9I;WIE@kqcs~5YfAdUJ7Q%3u+j;9ZjW{z zJd*+5%q-~ue6>$cKR!agcBYi~^l!!|16ZUu@KDXhBlBQ7;MueqgXd}FKN9|Cdis?? zy&~M}Ig^|iH_-UbxdD6`g2%aVapmrVO!{x(9v$A0ltY%9y(;MTVv5~3nl?L?8Dy~U zrBTyv-1Pt0k{-hf^ZvHc0L9et9EG9wd;OX1OA540qV(+QWvG4kDo;BIsq^_In7~-p>X4{mGM_@2T)Dp@Q@YXe8pTah6Bmo(@6n>U=(E2R7Xdi%i=3w_YD?%VRj7prw1CX_4hB%v9Yo3qup?# zSrl-i4Y8m&fcnc`i<^|;$#u+r!ejDnutoqeyb|4YN8HDMvR6~vHR=pwM?T6*)lc-5 z_m@u5?_XedYYV0Bi2){fJ+eb$d&+Aw6hF&qQCa3X)%rJ{e?Vt0S-(JM@XVJA;kE|> zQqtsf@WNvSHf4iRMG*sL0RK_g^(<-Our6z$DF_Qy}UXk(^3V_{{~ z7(&%ZV5xtdb{1>uBl&VYTT-@)JqQO+-2QO2pw&^jO$9QX?JIoGSk-gRBh7(as6&qU z%bxvYolCj*(KcOnW*%&-?WS-0M6HvPlA^ZIM$Md!LCPmB^Eal!KLx^SlHTVOk zh1DYZQC*%>nMSzKHeo-{lBbO>k-)%x-!q(}(;XTf-_JPp2rcTu|21x{@fh)6yoJU2hO2cXIEz&8SIw^oqlj!%0z2*cP!X0>q-KVA(QcdAGxE zWXn%C3chO~?Pq-jga`llMw!(V|A(f*PYzj+%0X+MDsR386P<=b>pZpW5I(zf79Yqe z=NMNl?|az&XA)Y_SLhT^pV&IWuoo@Mh0*!eB-NcWS`7=T7u(a$UcXW}2*X2;$s zV;#1-T_6*BHK*|0B7)3gLghM}{@3{rLTi^^TcL6;Ak^p_~$_Ha;osoJn-*TpeQi|7s zz-X;T*YU_KK^{HU_Lffba7pA|+eFUVI&-p<%KYB_QzvNexB3w%_4E@wKkf6z=lQ)khOHM#M|YLa!TAxWC_^!;UwAJi3L zN4D6V#B_YrWz}bGrK_vkUL|bX;)qN98gNb^+fCowC*hkyR;-n5vdMHSxBPPzLLz6_L1qcdCt z8e|{`nXS(Uk}F+f`flUQv6>dU3%hU0Y=0r)HfIkgZ2Ji(id3<7%U1^3PENhTUEXX> zOF5hGEe#@rsSJs%gxO9>CXXKWYiZT}3H@8JVc6C_cwpN8!pj)N9R#3%ggP5(HGf0@ zbZQk)DUS~i(=Kg91yiw(j^?pMJ_`U5puj@c^)mj2&SGu(rZcy<-KbzHRU1ZdJm$Fb z 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 VV~Vs*-x&-1D9fwM70H+e{trSFHjw}T literal 0 HcmV?d00001 diff --git a/1.3.0/images/WebformLoDfromCSVgeneralSettings.png b/1.3.0/images/WebformLoDfromCSVgeneralSettings.png new file mode 100644 index 0000000000000000000000000000000000000000..ab10c8579c5a6f3d77cbe236986c81b094ac6514 GIT binary patch literal 87271 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
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/inthewild/index.html b/1.3.0/inthewild/index.html index 4889d448..5525e275 100644 --- a/1.3.0/inthewild/index.html +++ b/1.3.0/inthewild/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1684,6 +1684,8 @@ + + @@ -1801,6 +1803,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/metadata_display_preview/index.html b/1.3.0/metadata_display_preview/index.html index c4e0d995..cf8034d6 100644 --- a/1.3.0/metadata_display_preview/index.html +++ b/1.3.0/metadata_display_preview/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1688,6 +1688,8 @@ + + @@ -1805,6 +1807,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/metadatainarchipelago/index.html b/1.3.0/metadatainarchipelago/index.html index 23736962..58aec235 100644 --- a/1.3.0/metadatainarchipelago/index.html +++ b/1.3.0/metadatainarchipelago/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1891,6 +1891,8 @@ + + @@ -2008,6 +2010,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/metadatatwigs/index.html b/1.3.0/metadatatwigs/index.html index 58e7e9bf..612bb8da 100644 --- a/1.3.0/metadatatwigs/index.html +++ b/1.3.0/metadatatwigs/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1688,6 +1688,8 @@ + + @@ -1805,6 +1807,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/modifyingfileextensionsinwebform/index.html b/1.3.0/modifyingfileextensionsinwebform/index.html index 27d764f3..0ec690d4 100644 --- a/1.3.0/modifyingfileextensionsinwebform/index.html +++ b/1.3.0/modifyingfileextensionsinwebform/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1690,6 +1690,8 @@ + + @@ -1916,6 +1918,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/ourtake/index.html b/1.3.0/ourtake/index.html index 28d9dd56..bd9ba4a1 100644 --- a/1.3.0/ourtake/index.html +++ b/1.3.0/ourtake/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1735,6 +1735,8 @@ + + @@ -1852,6 +1854,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/presentations_events/index.html b/1.3.0/presentations_events/index.html index bd5be8a2..bee23df1 100644 --- a/1.3.0/presentations_events/index.html +++ b/1.3.0/presentations_events/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1684,6 +1684,8 @@ + + @@ -1801,6 +1803,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/search-within-collection/index.html b/1.3.0/search-within-collection/index.html index 377a3a37..092a8fa7 100644 --- a/1.3.0/search-within-collection/index.html +++ b/1.3.0/search-within-collection/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1826,6 +1826,8 @@ + + @@ -1943,6 +1945,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/search/search_index.json b/1.3.0/search/search_index.json index f8489197..4f5b1e37 100644 --- a/1.3.0/search/search_index.json +++ b/1.3.0/search/search_index.json @@ -1 +1 @@ -{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Archipelago Commons Intro","text":"

    Archipelago Commons, or simply Archipelago, is an evolving Open Source Digital Objects Repository / DAM Server Architecture based on the popular CMS Drupal 9/10 and released under GLP V.3 License.

    Archipelago is a mix of deeply integrated custom-coded Drupal modules (made with care by us) and a curated and well-configured Drupal instance, running under a discrete and well-planned set of service containers.

    Archipelago was dreamt as a multi-tenant, distributed, capable system (as its name suggests!) and can live isolated or in flocks of similar deployments, sharing storage, services, or -- even better -- just the discovery layer. Learn more about the different Software Services used by Archipelago.

    Archipelago's primary focus is to serve the greater GLAM community by providing a flexible, consistent, and unified way of describing, storing, linking, exposing metadata and media assets. We respect identities and existing workflows. We endeavor to design Archipelago in ways that empower communities of every size and shape.

    Finally, Archipelago tries to stay humble, slim, and nimble in nature with a small code base full of inline comments and @todos. All of our work is driven by a clear and concise but thoughtful planned technical roadmap --updated in tandem with new releases.

    "},{"location":"AMIviaSpreadsheets/","title":"Ingesting New Digital Objects and Collections using Spreadsheets or Google Sheets","text":"

    Ingesting Only Digital Objects or Both Digital Objects and Collections uses similar processes, with a few key differences. Click here to jump to the Ingesting both Digital Objects and Collections and/or Creative Work Series (Compound) Objects section of this guide page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#ingesting-only-new-digital-objects","title":"Ingesting Only New Digital Objects","text":"

    From either the main Content page or the AMI Sets List page, select the 'Start an AMI set' button to begin.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-1-plugin-selection","title":"Step 1: Plugin Selection","text":"

    Select the Plugin type you will be using from the dropdown menu.

    • Google Sheets Importer

    • Spreadsheet Importer (if using local CSV file)

    *The Remote JSON API Importer and additional remote import source options (for other repository systems) will be covered in separate tutorials following future releases.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-2-operation-and-spreadsheet-source-selection","title":"Step 2: Operation and Spreadsheet Source Selection","text":"

    Select 'Create New ADOs' as the Operation you would like to perform.

    • If using Google Sheets Importer:

      • Enter the ID of your Google Sheet
      • Enter the Cell Range for your Google Sheet

    • If using Spreadsheet Importer:

      • Under the 'Upload your file' section, select 'Choose File' to upload the CSV you will be using. After the file is finished uploading, you will have the option to 'Remove' and select a different file if needed.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-3-data-transformation-selections","title":"Step 3: Data Transformation Selections","text":"

    Select the data transformation approach--how your source data will be transformed into ADO (Archipelago Digital Object) Metadata.

    • You will have 3 options for your data transformation approach:

      1. Direct
        • Columns from your spreadsheet source will be cast directly to ADO metadata (JSON), without transformation/further processing (only intended for use with simple data strings or already JSON-encoded snippets/values).
      2. Custom (Expert Mode)
        • Provides very granular custom data transformation and mapping options
        • Needs to be used if importing Digital Objects and Digital Object Collections at the same time/from same spreadsheet source (see separate instructions below).
      3. Template
        • Columns from your spreadsheet source will be cast to ADO metadata (JSON) using a Twig template setup for JSON output.

    • You will also need to Select which columns contain filenames, entities or URLS where files can be fetched from. Select what columns correspond to the Digital Object types found in your spreadsheet source.

    • Lastly, for this step, you will need to select the destination Fields and Bundles for your New ADOs. If your spreadsheet source only contains Digital Objects, select Strawberry (Descriptive Metadata source) for Digital Object

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-4-global-ado-mappings","title":"Step 4: Global ADO Mappings","text":"

    Select your global ADO mappings.

    • Make sure to select the ismemberof collection membership relationship predicate column if applicable. For AMI source spreadsheets containing only non-Creative Work Series (Compound) Objects, only ismemberof can be mapped properly. To use ispartof relationship setup, please refer to the steps outlined in the separate section below.
    Click to read more about Archipelago's default relationship mappings 
    - `ismemberof` and/or `ispartof` (and/or whatever predicate corresponds with the relationship you are mapping)\n- these columns can be used to connect related objects using the object-to-object relationship that matches your needs\n- in default Archipelago configurations, `ismemberof` is used for Collection Membership and `ispartof` is used for Parent-Child Object Relationships (so a Child ADO would reference the Parent ADO in `ispartof`)\n- these columns can hold 3 types of values\n    - empty (no value)\n    - an integer to connect an object to another object's corresponding row in the same spreadsheet/CSV\n      * Ex: Row 2 corresponds to a Digital Object Collection; for a Digital Object corresponding to Row 3, the 'ismemberof' column contains a value of '2'. The Digital Object in Row 3 would be ingested as a member of the Digital Object Collection in Row 2.\n    - a UUID to connect with an already ingested object\n
    • By default, the option to automatically assigns UUIDs is selected. Keep 'Automatically assign UUID' checked unless your source data already contains UUIDs in a node_uuid column.

    • Under the 'Base ADO mappings', select the label column for ADO Label. This selection is only used as a fail-safe (in case your AMI JSON Ingest Template does not have any mapping for a column to be mapped to the JSON label key, or your source data csv does not contain a label if going Direct for data transformation).

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-5-zip-upload","title":"Step 5: ZIP upload","text":"

    Provide an optional ZIP file containing your assets.

    • You may choose to upload a ZIP file containing all or some of the corresponding files specified in your csv/spreadsheet.

    • The file upload size restrictions specified in your Archipelago instance will apply here (512MB maximum by default).

      • Please note, when creating your ZIP file (in particular, within an OSX environment): only select the folders and files needed, not the top/enclosing folder they are in.
    Click to view screenshot of example ZIP file creation in OSX

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-6-ami-set-confirmation","title":"Step 6: AMI Set Confirmation","text":"

    You will now see a message letting you know that 'Your source data was saved and is available as a CSV at linktotheAMIgenerated.csv

    The message will also let you know that your New AMI Set was created and provide a link to the AMI Set page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-7-ami-set-processing","title":"Step 7: AMI Set Processing","text":"

    Your newly created AMI Set will now need to be Processed.

    If you clicked on the 'see it here' link in Step 6, you will be brought to the AMI Set page for review. You may also select Process from the Operations menu for the AMI set from the main AMI sets page. From the Process page you can review the JSON configuration for your set (determined by your selections in the preceding steps).

    Optional step to review the settings configured in your AMI Set

    You may wish to double check the settings configured in your AMI Set in the Raw Metadata (JSON) on the AMI Set View tab before Processing.

    To Process this set, navigate to the Process tab. You will have multiple options related to the Processing outcome for your AMI Set.

    • Skip ADO processing on missing File : If enabled a referenced missed file or one that can not be processed from the source, remote or local will make AMI skip the affected ROW. Enabled by default for better QA during processing.
    • Desired ADOS Statuses After Process
      • The Statuses you have available will reflect the publication workflow/moderation states (such as Draft, Published, Archived/Unpublished) setup in your Archipelago instance, and the permissions associated your user account.
    • Please review the note about the 'remaining free space on your Drupal temporary filesystem. Please be aware of that before running a batch with large files'. If the amount of remaining free space you see does not seem sufficient for your AMI set processing needs, we recommend contacting your system administrator.

    • Enqueuing and File Processing Options

      • Enqueue but do not process Batch in realtime : Check this to enqueue but not trigger the interactive Batch processing. Cron or any other mechanism you have enabled will do the actual operation. This queue is shared by all AMI Sets in this repository and will be processed on a First-In First-Out basis.
      • Force every File attached to an ADO to be processed in its own Queue item : Warning: This may make your ingest slower. Check this to force every file attached to an ADO to be downloaded and characterized as an independent process. This bypasses the Number of files Global setting that would otherwise trigger this behavior.
      • Re download and reprocess every file : Check this to force every file attached to an ADO to be downloaded and characterized again, even if on a previous Batch run that data was already generated for reuse. IMPORTANT: Needed if e.g the URL of a file is the same but the remote source changed, if you have custom code that modifies the backend naming strategy of files.

    • Select Confirm to continue.

    You will be returned to AMI sets page and see a brief confirmation message regarding the Enqueuing and Processing options you selected.

    If you chose to 'Confirm\" and Process your AMI Set immediately, proceed to Step 9: Processing and ADO Creation.

    If the chose to 'Enqueue' your AMI Set and the Queue operations for your Archipelago instance have been configured, you can simply leave your AMI Set in the Queue for Processing on the preconfigured schedule. Common timing for AMI Set Processes schedules are typically setup to run every three to six hours. Contact your Archipelago Administrators for details about your particular Archipelago's Processing schedule.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-8-queue-manager-push-may-be-restricted-to-administrator-users-only","title":"Step 8: Queue Manager Push (may be restricted to Administrator Users only)","text":"

    If you chose to place your AMI set in the Queue to Process in step 7 and you wish to manually kickstart the Queue Processes, navigate to the Queue Manager found at /admin/config/system/queue-ui. (Be sure to select the Queue Manager under the System section, not the Queue Manager for Hydroponic Service under the Archipelago section).

    To Process your AMI Set immediately from the Queue Manager page, select the checkbox next to the 'AMI Digital Object Ingester Queue Worker'. Keep the Action menu set to Batch Process and click the Apply to selected items button.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-9-processing-and-ado-creation","title":"Step 9: Processing and ADO Creation","text":"

    Your AMI set will now be Processed. You can follow the set's progress through the Processing queues loading screen.

    After your AMI set is Processed, you will receive confirmation messages letting you know your Digital Objects were successfully created.

    From this message, you can click on each ADO title to review the new created Digital Object (or Collection) if you wish. Or, you may proceed to step 10.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-10-review-your-newly-created-digital-objects-directly-or-via-ami-set-report","title":"Step 10: Review your newly created Digital Objects directly or via AMI Set Report","text":"
    • Option 1: Return to the main Content page found at /admin/content and review your newly created Digital Objects. After ensuring that files and metadata elements were mapped correctly, you may choose to change the Status for your Digital Objects to 'Published'.

    • Option 2: Use the AMI Set Report

      • From the main AMI sets page, select Report from the Operations menu for the AMI set you wish to review.

      • This Report will contain information related to the last Processing operation run against your AMI Set.

      • For each Digital Object or Collection row that was Processed, you will see:
        • a datetime stamp
        • one of three level (INFO, WARNING, or ERRORS) applicability
        • a message summarizing the Processing outcome--including a title/label link to the created ADO if successful
        • a details summary containing system information related to the operations.

      • You can use information found in the Reports tab to identify review your created ADOs one-by-one and identify any errors or issues that may have come up during the Process if needed.
    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#ingesting-both-new-digital-objects-and-collections-andor-creative-work-series-compound-objects-in-the-same-spreadsheet","title":"Ingesting Both New Digital Objects and Collections and/or Creative Work Series (Compound) Objects in the same spreadsheet","text":"

    From either the main Content page or the AMI Sets List page, select the 'Start an AMI set' button to begin.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#steps-1-plugin-selection-step-2-operation-and-spreadsheet-source-selection","title":"Steps 1: Plugin Selection & Step 2: Operation and Spreadsheet Source Selection","text":"

    Follow the same instructions found above for Ingesting New Digital Objects.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-3-data-transformation-selections_1","title":"Step 3: Data Transformation Selections","text":"

    To import Digital Objects and Digital Object Collections and/or Creative Work Series (Compound) Objects at the same time/from same spreadsheet source, you will need to select the Custom (Expert Mode) option for your data transformation approach.

    • Custom (Expert Mode)
      • Provides very granular custom data transformation and mapping options

    You will then need to 'Select your Custom Data Transformation and Mapping Options' for each of your Digital Object, Collection, and Creative Work Series (Compound) types.

    • For Collection and Creative Work Series (Compound) objects:

      • Select either the Direct or Template (and corresponding JSON template) option for your data transformation approach.
      • Select the destination Fields and Bundles for Strawberry (Descriptive Metadata source) for Digital Object Collection
        • Use this same destination for your Creative Work Series (Compound) objects
      • You may also wish to Select which columns contain filenames, entities or URLS where files can be fetched from. For most Collection objects, you will likely leave unselected or choose images if you are uploading a thumbnail image for your Collection.

    • For each non-Creative Work Series (Compound) Digital Object type in your spreadsheet source:

      • You will also need to select either the Direct or Template (and corresponding JSON template) option for your data transformation approach.
      • Then Select the destination Fields and Bundles for Strawberry (Descriptive Metadata source) for Digital Object
      • Then select which columns contain filenames, entities or URLS where files can be fetched from. Select what columns correspond to the Digital Object types found in your spreadsheet source.

      • For example, for 'Map' type Digital Objects, you would select the following options (as depicted in this screenshot):

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-4-global-ado-mappings_1","title":"Step 4: Global ADO Mappings","text":"

    Select your global ADO mappings.

    • Make sure to select the applicable relationship predicate columns (such as ismemberof and ispartof).
    Click to read more about Archipelago's default relationship mappings 
    - `ismemberof` and/or `ispartof` (and/or whatever predicate corresponds with the relationship you are mapping)\n- these columns can be used to connect related objects using the object-to-object relationship that matches your needs\n- in default Archipelago configurations, `ismemberof` is used for Collection Membership and `ispartof` is used for Parent-Child Object Relationships (so a Child ADO would reference the Parent ADO in `ispartof`)\n- these columns can hold 3 types of values\n    - empty (no value)\n    - an integer to connect an object to another object's corresponding row in the same spreadsheet/CSV\n      * Ex: Row 2 corresponds to a Digital Object Collection; for a Digital Object corresponding to Row 3, the 'ismemberof' column contains a value of '2'. The Digital Object in Row 3 would be ingested as a member of the Digital Object Collection in Row 2.\n    - a UUID to connect with an already ingested object\n
    • By default, the option to automatically assigns UUIDs is selected. Keep 'Automatically assign UUID' checked unless your source data already contains UUIDs in a node_uuid column.
    • Under the 'Base ADO mappings', select the label column for ADO Label. This selection is only used as a fail-safe (in case your AMI JSON Ingest Template does not have any mapping for a column to be mapped to the JSON label key, or your source data csv does not contain a label if going Direct for data transformation).
    • In order to make sure that Digital Objects containing the corresponding UUID or spreadsheet row number for any corresponding Collections, make sure ismemberof is also selected in the ADO Parent Columns. In order to make sure that Digital Objects containing the corresponding UUID or spreadsheet row number for any corresponding Parent ADOs (Creative Work Series/Compounds), make sure ispartof is also selected in the ADO Parent Columns.

    • Select the corresponding Columns for the Required ADO mappings.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-5-10","title":"Step 5-10:","text":"

    Follow the same instructions found in Steps 5-10 above. As part of step 10, make sure your Digital Objects were ingested into the corresponding Collections you mapped them to in your spreadsheet source. Please note, you will need to Publish the Digital Objects before the Objects will appear in the Collection's View page (whether accessed as a logged-in Admin user or Anonymous/Public user). Celebrate your next AMI success with another fresh coffee, tea, or cookie!

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"CODE_OF_CONDUCT/","title":"Archipelago - code of conduct / anti-harassment policy","text":"

    The Archipelago Commons community and the Metropolitan New York Library Council (METRO) are dedicated to providing a welcoming and positive experience for all participants, whether they are at a formal gathering, in a social setting, or taking part in activities online. This includes any forum, mailing list, wiki, web site, IRC channel, public meeting, conference, workshop/training or private correspondence. The Archipelago community welcomes participation from people all over the world, and these community members bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect.

    This Code of Conduct governs how we behave in public or in private. We expect it to be honored by everyone who represents the project officially or informally, claims affiliation with the project, or participates directly.

    We ask that all community members adhere to the following expectations:

    • METRO and Archipelago have a zero-tolerance policy for verbal, physical, and sexual harassment. Anyone who is asked to stop a hostile or harassing behavior is expected to do so immediately. Here, for reference, are New York State\u2019s requirements.

      Harassment includes: Offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion; sexual or discriminatory images in public spaces; deliberate intimidation; stalking; harassing photography or recording; sustained disruption of talks or other events; inappropriate physical contact; and unwelcome sexual attention.

    • Participation in discussions and activities should be respectful at all times. Please refrain from making inappropriate comments. Create opportunities for all people to speak, exercising tolerance of the perspectives and opinions of others. When we disagree, we do this in a polite and professional manner. We may not always agree. When frustrated, we back away and look for good intentions, not reasons to be more frustrated. When we see a flaw in a contribution, we offer guidance on how to fix it.

    • METRO and Archipelago honor the ability to be anonymous. If a person is going by their handle, a pseudonym, or doesn\u2019t wish to use their name, please respect their wishes and privacy. This also includes \u2018outing\u2019 someone\u2019s workplace, their age, their gender, their real name, etc, without their consent. We take people\u2019s privacy and their comfort very seriously.
    "},{"location":"CODE_OF_CONDUCT/#protocol-for-conflict-resolution","title":"Protocol for Conflict Resolution","text":"

    Participants in METRO and Archipelago communication channels violating this code of conduct may be sanctioned or expelled at the discretion of the organizers of the meeting (if the channel is an in-person event) or the Archipelago Advisory Board (if the channel is online).

    "},{"location":"CODE_OF_CONDUCT/#initial-incident","title":"Initial Incident","text":"

    If you are being harassed, notice that someone else is being harassed, or have any other concerns, and you feel comfortable speaking with the offender, please inform the offender that he/she/they has affected you negatively. Oftentimes, the offending behavior is unintentional, and the accidental offender and offended will resolve the incident by having that initial discussion. Participants asked to stop any harassing behavior are expected to comply immediately.

    "},{"location":"CODE_OF_CONDUCT/#escalation","title":"Escalation","text":"

    If the offender insists that they did not offend, if offender is actively harassing you, or if direct engagement is not a good option for you at this time, then you will need a third party to step in. To report any violation of the following code of conduct or if you have any questions or suggestions about this code of conduct, please contact archipelago-community@metro.org or fill out this form anonymously. This will be sent to leadership at METRO and the advisory board member currently acting as the Code of Conduct liaison. Our enforcement guidelines work in accordance with those published at the Contributor Covenant.

    Upon review, if METRO leadership and the Code of Conduct Liaison determine that the incident constitutes harassment they may take any action they deem appropriate, including warning the offender, expulsion from the meeting or other community channels, or contacting a higher authority such as a representative from the offender's institution.

    These policies draw from many other code of conduct documents, including but not limited to: code4lib, DLF, Islandora, ICG, Samvera, WikimediaNYC, and IDOCE

    "},{"location":"I7solrImporter/","title":"Using the Islandora 7 Solr Importer","text":"

    From either the main Content page or the AMI Sets List page, select the 'Start an AMI set' button to begin.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-1-plugin-selection","title":"Step 1: Plugin Selection","text":"

    Select the Islandora 7 Solr Importer from the dropdown menu.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-2-section-1-solr-server-configuration","title":"Step 2, section 1: Solr Server Configuration","text":"

    You will only have the option to select 'Create New ADOs' as the Operation you would like to perform.

    For the Solr Server Configuration section, you will need to provide all of the following information:

    • PID of the Islandora Collection Members you want to fetch (example: islandora:root)
    • Host of your Solr Server (example: repositorydomain.org)
    • Port (example: 8080)
    • Path (example: /)
      • Note: if your Solr can be found at http://myrepo.com:8080/solr, then the path is always a single \"/\" (as in screenshot depiction below)
    • Type of Solr Deployment
      • Either Single Solr Server (most common) or Solr Cloud Ensemble
    • Core (example: islandora)

    You will also need to select the Starting Row you would like to begin fetching results from, and the Number of Rows to fetch.

    The Starting Row is an offset and defaults to 0, which is the most common (and recommended) approach. For the Total Number of Rows to Fetch, setting this to empty or null will automatically (refresh when selecting 'Next' button at bottom of page) prefill with the real Number Rows found by the Solr Query invoked. If you set this number higher than the actual results we will only fetch what can be fetched.

    For larger collections, you may wish to create multiple/split AMI ingest sets by selecting a specified number of rows.

    • As an example, for a collection of 1500 objects that you wanted to split into three AMI ingests of 500 objects, you would specify the Starting Row as 0 for the first set and Number of Rows as 500. For the second set, your Starting Row would be Row 501; for the third set, 1001). In this example, the Number of Rows would always be 500.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-2-section-2-islandora-mappings","title":"Step 2, section 2: Islandora Mappings","text":"

    In this step you will need to make determinations on how you would like to map your Islandora 7 digital objects to your Archipelago repository and whether or not you would like to fetch additional file datastreams, such as those for thumbnail images, transcripts, OCRs/HOCRs, etc.

    • Selecting \"Collapse Multi Children Objects\" will collapse Children Datastreams into a single ADO with many attached files (single row in the generated AMI set .csv file). Book Pages will be fetched but also the Top Level PDF (if one exists in your Islandora instance).

    • In the Required ADO mappings, you will need to specify which Archipelago type you want to map each Islandora Content Model found in your source collection.

      • For example, for info:fedora/islandora:sp_large_image_cmodel you may want to use Photograph.

    • If you had left \"Collapse Multi Children Objects\" unselected, you will also need to specify the Islandora Content Model to ADO types mapping for possible Children.

    • You can also specify an ADO (Object or Collection) to be used as the Parent of Imported Objects. By selecting an existing ADO (Object or Collection) here using the autocomplete/search, the generated AMI set .csv file will contain an 'ismemberof' column containing the UUID of the selected ADO for every row.

    • Under \"Additional Datastreams to Fetch\", you can select any number and/or combination of extra file datastreams to retrieve from your harvest. Please note that the I7 Importer will fetch every possible datastream that is present in your source I7 repository, but the additional file datastreams referenced may not be associated with actual files for every digital object.

    Language from form itself:

    Additional datastreams to fetch. OBJ datastream will always be fetched. Not all datastreams listed here might be present once your data is fetched.

    • Selection of any additonal datastreams will generate a dropdown menu under \"Where extra datastreams should go.\" Here you will decide the organization and location of those datastreams by selecting one of the two options
      • Organize by mime type e.g TRANSCRIPT will go into the \"texts\" column
      • Each in a separate column based on the datastream neame, TRANSCRIPT will go into the \"transcripts\" column

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-3-data-transformation-selections","title":"Step 3: Data Transformation Selections","text":"

    Select the data transformation approach--how your source data will be transformed into ADO (Archipelago Digital Object) Metadata. As noted in the list below, 'Custom (Expert Mode)' is the recommended choice for AMI sets generated using the Islandora 7 Solr Importer plugin.

    • You will have 3 options for your data transformation approach:

      1. Direct
        • Columns from your spreadsheet source will be cast directly to ADO metadata (JSON), without transformation/further processing (only intended for use with simple data strings).
      2. Custom (Expert Mode) Recommended choice for AMI sets generated using the Islandora 7 Solr Importer plugin
        • Provides very granular custom data transformation and mapping options
        • Needs to be used if importing Digital Objects and Digital Object Collections at the same time/from same spreadsheet source (see separate instructions below).
      3. Template
        • Columns from your spreadsheet source will be cast to ADO metadata (JSON) using a Twig template setup for JSON output.

    • You will also need to Select which columns contain filenames, entities or URLS where files can be fetched from. Select what columns correspond to the Digital Object types found in your spreadsheet source. If you fetched additional file datastreams during Step 2, you will see those columns listed here as well (see screenshot below for examples).

    • Lastly, for this step, you will need to select the destination Fields and Bundles for your New ADOs. If your spreadsheet source only contains Digital Objects, select Strawberry (Descriptive Metadata source) for Digital Object

      • If using Sheet 1 of the Demo AMI Ingest set (found above):
        • Select Template and use the AMI Ingest JSON template that corresponds with your metadata elements.

        • Select images, documents, and audios for the file source/fetching.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-4-global-ado-mappings","title":"Step 4: Global ADO Mappings","text":"

    Select your global ADO mappings.

    • Even if empty (no values), select node_uuid and any relationship predicate columns (such as ismemberof).
    • By default, the option to automatically assigns UUIDs is selected. If you have existing UUIds, unselect this option.
    • Select the corresponding Columns for the Required ADO mappings.

    • If using Sheet 1 of the Demo AMI Ingest set (found above):

      • Select both ismemberof and node_uuid for ADO Parent columns
      • Keep 'Automatically assign UUID' checked
      • Do not select any column for 'Sequence'
      • Select the label column for ADO Label

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-5-zip-upload-and-ami-set-naming","title":"Step 5: ZIP upload and AMI Set naming","text":"

    For standard Spreadsheet or Google Sheets AMI ingests, you would use this step to provide an optional ZIP file containing your assets.

    For your Islandora 7 Solr Importer process, the generated AMI set.csv file will contain the necessary URLs to the corresponding Islandora 7 file datastreams for each object as needed. Select next to skip this ZIP upload step and proceed.

    After you provide a title for your AMI set under \"Please Name your AMI set\", select \"Press to Create Set\"

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-6-ami-set-confirmation","title":"Step 6: AMI Set Confirmation","text":"

    You will now see a message letting your know your \"New AMI Set was created\". You will be able to review the generated .csv file directly from this page under Source Data File.

    While you may immediately select \"Process\" from this AMI Set Confirmation page to use the Islandora 7 Importer generated .csv file as-is to ingest the ADOs in your AMI set, it is strongly recommended that you review the .csv file first. AMI is configured to trim unecessary (for Archipelago) and de-duplicate redundant Solr source data, but you may wish to pare down the sourced data even further and/or conduct general metadata review and cleanup before migrating your content. You will also likely want to make adjustments to your AMI Ingest JSON Template based on your review, depending on the variation of metadata columns/keys found in your source repostiory.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#next-steps","title":"Next Steps","text":"

    To proceed with Processing your AMI Set, click here to be directed to the main Ingesting Digital Objects via Spreadsheets.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"about/","title":"About this Documentation","text":"

    This documentation was generated with Material for MkDocs. The repo/branch is at https://github.com/esmero/archipelago-documentation/tree/1.3.0, and the site is built using the following Github workflow: https://github.com/esmero/archipelago-documentation/blob/1.3.0/.github/workflows/ci.yml.

    ","tags":["Documentation","Contributing"]},{"location":"about/#contributing","title":"Contributing","text":"
    1. First, please see this guide to set up the repo and branch locally and to create an issue and corresponding pull request.
    2. Install mkdocs-material and mike: pip install mkdocs-material mike.
    3. Make changes to local
    4. Run mike delete --all && mike deploy 1.0.0 default && mike set-default 1.0.0 && mike serve to see and test changes.
    5. Follow the above guide to contribute the changes back.
    ","tags":["Documentation","Contributing"]},{"location":"acknowledgments/","title":"Caring & Coding + Fixing","text":"
    • Diego Pino
    • Giancarlo Birello
    • Allison Sherrick
    "},{"location":"acknowledgments/#acknowledgments","title":"Acknowledgments","text":"

    This software is a Metropolitan New York Library Council Open-Source initiative and part of the Archipelago Commons project.

    "},{"location":"acknowledgments/#license","title":"License","text":"

    GPLv3

    "},{"location":"ami_index/","title":"Archipelago Multi-Importer (AMI)","text":"

    Archipelago Multi-Importer (AMI) is a module for batch/bulk/mass ingests of Archipelago digital objects (ADOs) and collections. AMI also enables you to perform batch administrative actions, such as updating, patching/revising, or deleting digital objects and collections. AMI's Solr Importer plugin can be used to create AMI ingests and migrating content from existing Solr-sourcable digital repositories (such as Islandora 7).

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#ami-overview-and-under-the-hood-explanations","title":"AMI Overview and Under-the-Hood Explanations","text":"

    From the desk of Diego Pino

    AMI provides Tabulated data ingest for ADOs with customizable input plugins. Each Spreadsheet (or Google Spreadsheet) goes through a Configuration Multi-step setup and generates at the end an AMI Set. AMI Sets then can be enqueued or directly ingested, its generated Objects purged and reingested again, its source data (generated and enriched with UUIDS) CSV replaced, improved and uploaded again and ingested.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#learn-more-about-metadata-in-archipelago-and-ami","title":"Learn More about Metadata in Archipelago and AMI","text":"

    Please review the Metadata in Archipelago overview to learn about Archipelago's unique approach to metadata and how this applies in the context of AMI set adminstration.

    Click to read the full AMI 0.4.0 (Archipelago - 1.0.0) Pre-Release Notes.","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#setup-steps","title":"Setup Steps","text":"

    AMI has Ingest, Update and Patch capabilities. AMI has a plugin system to fetch data. The data can come from multiple sources and right now CSV/EXCEL or Google Spreadsheets are the ones enabled. It does parent/children validation, makes sure that parents are ingested first, cleans broken relationships, allows arbitrary multi relations to be generated in a single ROW (ismemberof, partOf, etc) pointing to other rows or existing ADOs (via UUIDs) and can process rows directly as JSON or preprocessed via a Metadata Display entity (twig template) capable of producing JSON output. These templates can be configured by \u201ctype\u201d, Articles v/s 3DModel can have different ones. Even which columns contain Files can be configured at that level.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#ami-set-entity","title":"AMI Set Entity","text":"

    Ami Sets are special custom entities that hold an Ingest Strategy generated via the previous Setup steps (as JSON with all it's settings), a CSV with data imported from the original source (with UUIDs prepopulated if they were not provided by the user). These AMI sets are simpler and faster than \u201cbatch sets\u201d because they do not have a single entry per Object to be ingested. All data lives in a CSV. This means the CSV of an AMI set can be corrected and reuploaded. Users can then Process a Set either putting the to be ingested ADOs in the queue and let Hydroponics Service do the rest or directly via Batch on the UI. ADOs generated by a set can also be purged from there. These sets can also be created manually if needed of any of the chosen settings modified anytime. Which AMI set generated the Ingest is also tracked in a newly created ADO\u2019s JSON and any other extra data (or fixed data e.g common Rights statements, or LoD) can be provided by a Twig Template. Ingest is amazingly fast. We monitored Ingest with Remote URL(islandora Datastreams) files of 15Mbytes average at a speed of 2 seconds per Object (including all post processing) continuously for a set of 100+.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#search-and-replace","title":"Search and Replace","text":"

    This module also provides a simple search/replace text VBO action (handles JSON as text) and a full blown JSONPATCH VBO action to batch modify ADOs. The last one is extremely powerful permitting multiple operations at the same time with tests. E.g replace a certain value, add another value, remove another value only if a certain test (e.g \u201ctype\u201d:\u201dArticle\u201d and \u201cdate_of_digital\u201d: \u201c2020-09-09\u201d) matches. If any tests fail the whole operation will be canceled for that ADO. An incomplete \u201cWebform\u201d VBO action is present but not fully functional yet. This one allows you to choose a Webform, a certain element inside that Webform and then find and replace using the same Interface you would see while editing/adding a new ADO via the web form workflow.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#getting-started-with-ami","title":"Getting started with AMI","text":"

    You can access AMI through the AMI Sets tab on the main Content page found at /admin/content or directly at /amiset/list.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#google-sheets-api-configuration","title":"Google Sheets API Configuration","text":"

    If you plan on using the Google Sheets Importer option, you will need to Configure the Google Sheets API.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#example-spreadsheetcsv","title":"Example Spreadsheet/CSV","text":"

    Please refer to or use a fresh/new copy of the Demo Archipelago Digital Objects (ADOs) spreadsheet to import a small set of Digital Objects, using the same assets part of the One-Step Demo content ingest guide.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#example-json-template","title":"Example JSON template","text":"

    This JSON template can be used during the Data Transformation (step 3) of your AMI Import. This particular template corresponds with the metadata elements found in the Default Descriptive Metadata and Default Digital Object Collection webforms shipped with Archipelago 1.0.0.

    Click to view the example 1.0.0 AMI JSON template

    To use this template, copy and paste the JSON below directly into a new Metadata Display, found here for a local http://localhost:8001/metadatadisplay/list or http://yoursite.org/metadatadisplay/list. Select JSON as the 'Primary mime type this Twig Template entity will generate as output' for this new Metadata Display.

      {\n      \"type\": {{ data.type|json_encode|raw }},\n      \"label\": {{ data.label|json_encode|raw }},\n      \"issue_number\": {{ data.issue_number|json_encode|raw }},\n      \"interviewee\": {{ data.interviewee|json_encode|raw }},\n      \"interviewer\": {{ data.interviewer|json_encode|raw }},\n      \"duration\": {{ data.duration|json_encode|raw }},\n      \"website_url\": {{ data.website_url|json_encode|raw }},\n      \"description\": {{ data.description|json_encode|raw }},\n      \"date_created\": {{ data.date_created|json_encode|raw }},\n      \"date_created_edtf\": {{ data.date_created_edtf|json_encode|raw }},\n      \"date_created_free\": {{ data.date_created_free|json_encode|raw }},\n      \"creator\": {{ data.creator|json_encode|raw }},\n      \"creator_lod\": {{ data.creator_lod|json_encode|raw }},\n      \"publisher\": {{ data.publisher|json_encode|raw }},\n      \"language\": {{ data.language|json_encode|raw }},\n      \"ismemberof\": [],\n      \"ispartof\": [],\n      \"sequence_id\": {{ data.sequence_id|json_encode|raw }},  \n      \"owner\": {{ data.owner|json_encode|raw }},\n      \"local_identifier\": {{ data.local_identifier|json_encode|raw }},\n      \"related_item_host_title_info_title\": {{ data.related_item_host_title_info_title|json_encode|raw }},\n      \"related_item_host_display_label\": {{ data.related_item_host_display_label|json_encode|raw }},\n      \"related_item_host_type_of_resource\": {{ data.related_item_host_type_of_resource|json_encode|raw }},\n      \"related_item_host_local_identifier\": {{ data.related_item_host_local_identifier|json_encode|raw }},\n      \"related_item_note\": {{ data.related_item_note|json_encode|raw }},\n      \"related_item_host_location_url\": {{ data.related_item_host_location_url|json_encode|raw }},\n      \"note\": {{ data.note|json_encode|raw }},\n      \"physical_description_note_condition\": {{ data.physical_description_note_condition|json_encode|raw }},\n      \"note_publishinginfo\": {{ data.note_publishinginfo|json_encode|raw }},\n      \"physical_location\": {{ data.physical_location|json_encode|raw }},\n      \"physical_description_extent\": {{ data.physical_description_extent|json_encode|raw }},\n      \"date_published\": {{ data.date_published|json_encode|raw }},\n      \"date_embargo_lift\": {{ data.date_embargo_lift|json_encode|raw }},\n      \"rights_statements\": {{ data.rights_statements|json_encode|raw }},\n      \"rights\": {{ data.rights|json_encode|raw }},\n      \"subject_loc\": {{ data.subject_loc|json_encode|raw }},\n      \"subject_lcnaf_personal_names\": {{ data.subject_lcnaf_personal_names|json_encode|raw }},\n      \"subject_lcnaf_corporate_names\": {{ data.subject_lcnaf_corporate_names|json_encode|raw }},\n      \"subject_lcnaf_geographic_names\": {{ data.subject_lcnaf_geographic_names|json_encode|raw }},\n      \"subject_lcgft_terms\": {{ data.subject_lcgft_terms|json_encode|raw }},\n      \"subject_wikidata\": {{ data.subject_wikidata|json_encode|raw }},\n      \"edm_agent\": {{ data.edm_agent|json_encode|raw }},\n      \"term_aat_getty\": {{ data.term_aat_getty|json_encode|raw }},\n      \"viaf\": {{ data.viaf|json_encode|raw }},\n      \"pubmed_mesh\": {{ data.pubmed_mesh|json_encode|raw }},\n      \"europeana_concepts\": {{ data.europeana_concepts|json_encode|raw }},\n      \"europeana_agents\": {{ data.europeana_agents|json_encode|raw }},\n          \"europeana_places\": {{ data.europeana_places|json_encode|raw }},\n      \"geographic_location\": {{ data.geographic_location|json_encode|raw }},\n      \"subjects_local_personal_names\": {{ data.subjects_local_personal_names|json_encode|raw }},\n      \"subjects_local\": {{ data.subjects_locals|json_encode|raw }},\n      \"audios\": [],\n      \"images\": [],\n      \"models\": [],\n      \"videos\": [],\n      \"documents\": [],\n      \"as:generator\": {\n          \"type\": \"Create\",\n          \"actor\": {\n              \"url\": {{ setURL|json_encode|raw }},\n              \"name\": \"ami\",\n              \"type\": \"Service\"\n          },\n          \"endTime\": \"{{\"now\"|date(\"c\")}}\",\n          \"summary\": \"Generator\",\n          \"@context\": \"https:\\/\\/www.w3.org\\/ns\\/activitystreams\"\n      },\n      \"upload_associated_warcs\": []\n  }\n

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/","title":"Using AMI's Linked Data Reconciliation","text":"

    Archipelago Multi Importer (AMI)'s Linked Data Reconciliation tool can be used to enrich your metadata with Linked Data (LoD). Using this tool, you can map values from your topical/subject metadata elements to your preferred LoD vocabulary source. These mappings can then be transformed via a corresponding Metadata Display (Twig) template to process the values into JSON-formatted metadata for your specified AMI set.

    The aim of this tool is to automize as much of the reconciliation process as feasible within Archipelago. Please be aware that data reconciliation will still be in part a manual and potentially time intensive process.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#important-note-preliminary-pre-requisite-ami-set-configuration","title":"Important Note: Preliminary / Pre-requisite AMI Set Configuration","text":"

    In order to Reconciliate an AMI Set, you will need to have selected the 'Template' or 'Custom' data transformation approach (then also, via 'Template' for your Digital Object or Collection types) during Step 3 : Data Transformation of your AMI Set configuration.

    Your source spreadsheet will also need to contain at least one column containing terms/names (values) you want to reconcile against an LoD Authority Source. Multiple values should be separated by '|@|'.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#step-1-select-the-ami-set-you-will-be-working-with","title":"Step 1: Select the AMI Set you will be working with.","text":"

    From the main AMI Sets List page, click on your AMI Set's Name, or select the 'Edit' option from the Operations menu on the right-hand side of the Sets list.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#step-2-reconcile-lod-tab","title":"Step 2: Reconcile LoD Tab","text":"

    Navigate to the Reconcile LoD tab.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#step-3-lod-reconciling-selections","title":"Step 3: LoD Reconciling Selections","text":"

    From the list of columns from your spreadsheet source, select which columns you want to reconcile against LoD providers.

    Under the LoD Sources section, select how your chosen Columns will be LoD reconciled. - LoD reconcile options will be on the left, LoD Authority Sources will be on the right. - Example: 'local_subjects' will be mapped to 'LoC subjects (LCSH)'

    Full list of potential LoD Authority Sources
    • LoC subjects(LCSH)
    • LoC Name Authority File (LCNAF)
    • LoC Genre/Form Terms (LCGFT)
    • LoC Thesaurus of Graphic Materials (TGN)
    • LoC MARC List for Geographic Areas
    • LoC Relators Vocabulary (Roles)
    • LoC MADS RDF by type:
    • Corporate Name
    • Personal Name
    • Family Name
    • Topic
    • Genre Form
    • Geographic
    • Temporal
    • Extraterrestrial Area
    • VIAF
    • Getty aat Fuzzy / Terms / Exact Label Match
    • Wikidata Q Items

    To preview the values contained in the column(s) you selected, click the 'Inspect cleaned/split up column values' button.

    Tip: This preview step provides you with the opportunity to return to your AMI Set source CSV and make any necessary label/term corrections such as outliers and formatting errors before processing. This can be done multiple times until your source set is fully prepared. If using this workflow, you will tick the 'Re-process only adding new terms/LoD Authority Sources' processing option after replacing your updated source CSV (see screenshot below)

    When ready, there are multiple processing options to select from depending on your current need/workflow. - To process immediately, select 'Process LoD from Source' - To enqueue the batch process, select 'Enqueue but do not process Batch in real time. - To add new data (i.e. terms, LoD Authority Sources) to existing reconciliation (e.g after replacing source CSV data), select 'Re-process only adding new terms/LoD Authority Sources

    Important note: if you have previously run LoD Reconciliation for your AMI set, this action will overwrite any manually corrected LoD on your Processed CSV. Please make sure you have a backup if unsure.

    Depending on the size of your AMI Set, the Reconciliation processing may take a few minutes.

    When the process is finished, you will see a brief confirmation message.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#step-4-edit-reconciled-lod","title":"Step 4: Edit Reconciled LoD","text":"

    Open the 'Edit Reconciled LoD' tab.

    You will see a table (form) containing: - Your Original term values (labels) - The CSV Column Header/Key from the source spreadsheet where the value is found - A Checked option you can use to denote that an LoD mapping has been reviewed/revisioned - The Linked Data Label and URL pairing selected during the LoD reconciliation process

    The results table will show 10 original terms and mappings per page. You can advance through the pages using the page numbers and navigational arrows above and below the table.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#step-5-review-and-edit-your-reconciled-lod-mappings","title":"Step 5: Review and Edit your Reconciled LoD Mappings","text":"

    Review the LoD reconciliation mappings, to make sure the best terms were selected for your metadata.

    • To revise and select a different term mapping, begin by typing in the 'Label' box in the corresponding LoD lookup element. (You can type directly over an incorrect term or within an empty cell if no value was mapped/identified.)
    • Select your preferred term and URL pairing from the list.
    • You can also add or remove multiple mappings using the +/- buttons beside the LoD lookup element.
    • If desired, click the Checked option to mark that the term was reviewed/revisioned.

    As you advance through your review process, it is recommended that you use the 'Save Current LoD Page' at the bottom of each results page as you work. This will preserve the corrections you may have made and update the LoD Reconciled data for your AMI Set within the editing form.

    When you have finished editing/reviewing your data, you must select 'Save all LoD back to CSV File' or else your LoD selections will not be preserved.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#step-6-ami-set-review-and-twig-metadata-display-preparation","title":"Step 6: AMI Set Review and Twig (Metadata Display) Preparation","text":"

    You will now need to make sure that the Metadata Display (Twig) Template you selected to use during your initial AMI Set configuration is setup to Process your LoD mapped Label and URL selections into your Digital Objects and Collections JSON metadata.

    For every JSON key/element in your metadata that you need to process the LoD Reconciled data into, you need to specify in your Template that data for this element will be read from the 'Processed Data' LoD information.

    In the following example Twig snippet, the \"subject_loc\" JSON key will map corresponding values from the 'Processed Data' (data.lod) LoD information into a newly created Digital Object/Collection during the AMI Set Processing.

    \"subject_loc\": {{ data_lod.mods_subject_topic.loc_subjects_thing|json_encode|raw }},\n
    • \"subject_loc\" = destination JSON Key or Property for your LoD values
    • data.lod = directs the Twig template to source from the Processed Data LoD information (instead of the original AMI Source CSV accessed via 'data.xx_property_name')
    • mods.subject.topic = the Column header in the original AMI Source CSV
    • loc_subjects_thing = the Column containing the Label and URI/L pairs in the Processed Data LoD editable Table/Form (and reference CSV)

    The same general pattern can be adapted to apply to different mapping scenarios (original CSV source columns to Reconciled LoD Sources) as needed.

    Full list of Column Options => Corresponding LoD Sources
    • 'loc_subjects_thing' => LoC subjects(LCSH)
    • 'loc_names_thing' => LoC Name Authority File (LCNAF)
    • 'loc_genreForms_thing' => LoC Genre/Form Terms (LCGFT)
    • 'loc_graphicMaterials_thing' => LoC Thesaurus of Graphic Materials (TGN)
    • 'loc_geographicAreas_thing' => LoC MARC List for Geographic Areas
    • 'loc_relators_thing' => LoC Relators Vocabulary (Roles)
    • 'loc_rdftype_CorporateName' => LoC MADS RDF by type: Corporate Name
    • 'loc_rdftype_PersonalName' => LoC MADS RDF by type: Personal Name
    • 'loc_rdftype_FamilyName' => LoC MADS RDF by type: Family Name
    • 'loc_rdftype_Topic' => LoC MADS RDF by type: Topic
    • 'loc_rdftype_GenreForm' => LoC MADS RDF by type: Genre Form
    • 'loc_rdftype_Geographic' => LoC MADS RDF by type: Geographic
    • 'loc_rdftype_Temporal' => LoC MADS RDF by type: Temporal
    • 'loc_rdftype_ExtraterrestrialArea' => LoC MADS RDF by type: Extraterrestrial Area
    • 'viaf_subjects_thing' => VIAF
    • 'getty_aat_fuzzy' => Getty aat Fuzzy
    • 'getty_aat_terms' => Getty aat Terms
    • 'getty_aat_exact' => Getty aat Exact Label Match
    • 'wikidata_subjects_thing' => Wikidata Q Items
    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#next-steps","title":"Next Steps","text":"

    To proceed with Processing your AMI Set, click here to be directed to the main Ingesting Digital Objects via Spreadsheets.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_spreadsheet_overview/","title":"Spreadsheet Formatting Overview","text":"","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_spreadsheet_overview/#spreadsheet-formatting-overview","title":"Spreadsheet Formatting Overview","text":"

    There are multiple ways a spreadsheet/CSV file can be structured to work with AMI, depending on the data transformation and mapping you will be using.

    • For most standard AMI ingests, each Row of your spreadsheet/CSV will correspond to a single Digital Object, Creative Work Series (Compound Object Parent) or Collection.

    • Columns in your spreadsheet/CSV can be mapped to different data (files) and metadata elements (label, description, subjects, etc.).

    • It is recommended that different types of files are placed into separate columns--\"images\", \"documents\", \"models\", \"videos\", \"audios\", \"texts\".

      • Filepaths can point to remote files, to existing files within your docker container, s3 (or other storage type/location that is accessible to Archipelago), and to paths within zip files.
        • Example path for existing file within docker container: /var/www/html/d8content/myAMIimage.jpg
        • Example s3 path: s3://myAMIuploads/myAMIdocument.pdf
        • Example remote filepath: https://dogsaregreat.edu/dogs.tiff
      • Multiple files (of the same type) can be placed in a single cell, separated by a semicolon ( ; ).
      • For Digital Objects comprised of multiple types of files, such as an Oral History Interview with an audio file and a PDF transcript file, you can place different file types within different corresponding columns for the same Row.
      • It is recommended that filepaths are copied/stored as plain (non-hyperlinked) formatted text.

    • Every spreadsheet/CSV file should contain the following Columns:

      • type
        • the Digital Object or Digital Object Collection Type, such as 'Photograph' or 'Collection'
      • label
        • the title of the Digital Object or Collection
      • Soft-requirement node_uuid
        • this can be empty
        • if empty, Archipelago will automatically generate UUIDs
        • can be used with existing UUIDs during migrations
      • Soft-requirement sequence_id for Creative Work Series (compound) children objects
        • this is used to determine the sequence order for children objects within a Creative Work Series (compound) object
        • should be an integer only (ie, '1' and not 'Page 1')
        • if not present, the objects will present in the original ingest order
        • we strongly recommend mapping the correct sequence using 'sequence_id'

    • Recommended Columns:

      • Files as defined above
        • \"images\", \"documents\", \"models\", \"videos\", \"audios\", \"text\"
        • .warc/.wacz files should be placed in a column \"upload_associated_warcs\"
      • ismemberof and/or ispartof (and/or whatever predicate corresponds with the relationship you are mapping)
        • these columns can be used to connect related objects using the object-to-object relationship that matches your needs
        • in default Archipelago configurations, ismemberof is used for Collection Membership and ispartof is used for Parent-Child Object Relationships (so a Child ADO would reference the Parent ADO in ispartof)
        • these columns can hold 3 types of values
          • empty (no value)
          • an integer to connect an object to another object's corresponding row in the same spreadsheet/CSV
          • Ex: Row 2 corresponds to a Digital Object Collection; for a Digital Object corresponding to Row 3, the 'ismemberof' column contains a value of '2'. The Digital Object in Row 3 would be ingested as a member of the Digital Object Collection in Row 2.
          • a UUID to connect with an already ingested object
      • Metadata - for all the rich, detailed information associated with your Digital Objects and Collections
        • Every Column header will become a JSON Key and each cell a JSON value for that Key

        • You can use direct JSON snippets such as:

          [{\"uri\": \"http://id.loc.gov/authorities/subjects/sh95008857\",\"label\": \"Digital libraries\"}]\n
          - If you have an advanced twig template with the necessary logic, you can place data in cells that can be parsed and structured in various ways (such as multiple values separated by semicolons split accordingly, capitalization of values based on defined patterns, etc.)

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_update/","title":"Using AMI's Update Operations","text":"

    Archipelago Multi Importer (AMI)'s Update Operations can be used to Update, Replace, or Append metadata values or files for existing Digital Objects and Collections found in your Archipelago. You can prepare and use AMI Update Sets in different ways using one of three functional operations, depending on your update needs. This guide will provide a general overview of the three main functions and how each operation may be useful.

    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#important-notes-preliminary-pre-requisites","title":"Important Notes: Preliminary / Pre-requisites","text":"

    You need to have existing Digital Objects or Collections (ADOs) in your Archipelago to work with. You should have a prepared AMI Update Set CSV that contains at least the following columns/headers:

    • node_uuid
      • required
      • should contain the values for any existing ADOs you wish to update
      • needs to be a 1:1 match; AMI Update functionality cannot be used to update/change node_uuid values
    • label
      • required
      • contains the corresponding label (title) for your existing ADOs
      • can contain modifications for the label (title) values
    • type
      • optional, only required if using the Custom (Expert Mode) approach for your AMI set configuration or targeting changes for 'type' mappings for your ADOs
      • contains the corresponding type values for your existing ADOs
      • can contain modifications for the type values
      • related to this, AMI Update functionality cannot be used to update/change the underlying Drupal bundle mappings for already-ingested objects. In other words, you cannot use an AMI Update Set to change a Child Object with a 'Page' type originally ingested as a Digital Object -> to a Parent Object with a 'Book' type mapped to the Digital Object Collection/Compound bundle. For these changes, you will need to delete and re-ingest your ADOs, or use an external (not provided in default Archipelagos) Drupal module for bundle/Drupal Content Type changes.
    • additional metadata elements you wish to Update, Replace, or Append values for, such as \"subjects\"
      • optional (but likely pertains to the reason you are Updating your ADOs)
      • follow recommendations and practices described in more below detail
    • files
      • optional
      • on the final 'Process' tab of your AMI Update Set Configuration, if the \"Do not touch existing files\" option is checked, then existing files will be left untouched. It is recommended to always keep this option checked if you are targeting only Metadata updates.

    You should be familiar with the basic mechanics of AMI Set Configuration noted in Steps 1-6.

    Best Practices

    For all AMI Update operations, it is strongly recommended to both:

    1. Before Updating, use the 'Export Archipelago Digital Objects to CSV content item' Action available on the main Content page and the Find and Replace page menus to generate a CSV of your non-modified objects. If something unintended occurs with your Update execution, you could use this CSV of your non-modified objects to restore your objects (or just a field or two) as needed.

    2. Create a small test batch CSV referencing one to two/three ADOs to test the execution of your desired Update actions on before running your larger Update Sets. There is no 'Undo' or 'Revert Changes' button that can be used for an AMI Update Set. You do have the option to 'Revert Revisions' on an object-by-object basis, but that is not ideal for reverting changes that were executing across large batches of ADOs. See the 'Checking Your Changes' documentation section for more information about reviewing and potentially reverting Revisions.

    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#data-transformation-options-for-ami-update-sets","title":"Data Transformation Options for AMI Update Sets","text":"

    As with regular/Create New AMI Sets, you will have to select your preferred Data Tranformation configuration during Step 3 : of your AMI Update Set Configuration.

    • Direct
      • Columns from your spreadsheet source will be cast directly to ADO metadata (JSON), without transformation/further processing (only intended for use with simple data strings or already JSON-encoded snippets/values).
      • This is likely the most common Data Transformation configuration you will use for simple AMI Update Replace and Append Sets.
    • Custom (Expert Mode)
      • Provides very granular custom data transformation and mapping options
      • You will likely only use this Data Transformation configuration for more complex AMI Update Sets when you want to differentiate between Data Transformation setups for Digital Objects and Digital Object Collections/Compound Objects/Creative Work Series (such as passing Digital Objects through 'Template' tranformation, and Collections/Compounds through 'Direct' transformation).
    • Template
      • Columns from your spreadsheet source will be cast to ADO metadata (JSON) using a Twig template setup for JSON output.
      • This is likely the most common Data Transformation configuration you will use for more complex AMI Update Sets. This is the setup you would need to use if you want to use an AMI Update Set with AMI's LoD Reconciliation to update existing ADOs subject metadata with enriched LoD.

    Caution with using Templates for Data Transformation

    If you are planning to use the 'Template' or 'Custom (Export Mode)' data transformation approach for your AMI Update Set configuration, you will need to have prepared your corresponding AMI Ingest Template to account for the specific Update actions you have planned.

    It is important to keep in mind that all of the metadata elements for your existing ADOs metadata may not necessarily be present in your AMI Update Set Source CSV. For example, you may have only prepared your AMI Update Set Source CSV to contain a limited number of headers/columns, such as only those required (node_uuid, label) and one or two metadata elements you wish to update (such as \"subjects\"). If you choose to pass your AMI Update Set through a Twig template, the output after Processing your AMI Update Set may overwrite your existing data if you do not have all of the necessary logic/checks in place to preserve the existing metadata if desired.

    In other words, imagine your twig template contains this statement: 

      \"subjects\": {{ data.subjects|json_encode|raw }}, \n

    Independently of IF your CSV contains \"subjects\" as a header/column, the Twig template will still output an empty \"subjects\", which, when using the \"Replace\" mode will wipe out any existing \"subjects\" in your ADO.

    During any update operation (independently of the functional operation chosen) and IF you are using/passing your CSV through a template, AMI will provide an extra Context key for you to reference in your Twig Template. You can always reference 'dataOriginal.subjects' for example -- all dataOriginal.xx keys will contain the values of the existing metadata for your ADOs. This allows you to make \"smart\" templates that check IF a certain key/values exists, compare the unmodified (and to be modified) ADO(s) with the new data passed, then generate the desired output.

    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#update-set-processing-options","title":"Update Set Processing Options","text":"

    Beginning from Step 7, Processing of your AMI Set Configuration, select the Update operation that best corresponds to your targeted Update scenario.

    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#1-normal-update-operation","title":"1. Normal Update Operation","text":"

    The Normal Update Operation 'will update a complete existing ADO's configured target field with new JSON Content.' This will replace everything in an ADO with new processed data.

    • The Normal update operation is powerful and can overwrite your whole JSON object record if not paired with a template that has all the extra checks/logic needed to preserve existing data if desired (see note of 'Caution with Templates for Data Transformation' above).
    • It is also recommended to only use the Normal Update approach if you need to re-process most of the metadata fields for ADOs.
    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#2-replace-update-operation","title":"2. Replace Update Operation","text":"

    The Replace Update Operation Replace 'will replace JSON keys found in an ADO's configured target field with new JSON content. Not provided ones (fields/JSON keys) will be kept.'

    • If the processed data contains a JSON key that is already in the ADO's metadata to be updated, the values in the AMI Update Set CSV will be used, replacing completely the values found in that key in the existing ADO.
    • The Replace update operation paired with the 'Direct' data transformation is likely the update operation you will use.
    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#common-use-case-scenario-for-replace-updates","title":"Common use case scenario for Replace updates:","text":"
    • You notice a missing or incorrectly processed field in your original AMI Set/ADOs.
    • You create an AMI set that contains only the 'node_uuid', 'label', and one column for the missing field and values.
      • If the values are singular, you do not need to JSON-encode the values in the CSV
      • If the values are multiple, you need to JSON-encode them, formatted as: [\"value1\",\"value2\"]
    • You select the Direct data transformation approach on the AMI configuration.
    • You select the Replace update operation and keep 'Do not touch existing files' checked.
    • With this setup, the new field and values are added to the existing JSON for the impacted ADOs.
    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#3-append-update-operation","title":"3. Append Update Operation","text":"

    The Append update operation 'will append values to existing JSON keys in an ADO's configured target field. New ones (fields/JSON keys) will be added too.'

    • If the processed data contains a key that is already in the ADO\u2019s metadata to be updated, attempts will be made to match the \"source\" type (array, complex object) to add to it. If you have 2 values in a key, and your original/existing data contains a single value, the result will have 3 values (and then it will try to deduplicate too). If the Source data did not contain a key present in the processed data, then it will be added.
    • The Append operation can be very useful, but it should be used with caution if targeting single values versus arrays. AMI will not permit malformed JSON data to be generated. But you need to consider if your Append update tranforms a previously single-value key into a multiple-value array, how this change may impact any references made in you display or other templates, Views throughout your Archipelago.
      • For example, if your Object Description Display template is not setup to check for iterable (multiple value/array) values for a given element, then the multiple values for an updated ADO may not output as expected.
    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#other-process-setup-options","title":"Other Process Setup Options","text":"

    For the other AMI Set Process options and steps, please refer to the information found from Steps 7-10 in this complementary documentation for Create New ADOs AMI Sets. See the 'Checking Your Changes' documentation section for more information about reviewing and potentially reverting Revisions.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"annotations/","title":"Annotations in Archipelago","text":"

    Archipelago extends Annotorius to provide W3C-compliant Web Annotations for Digital Objects. These annotations can be added per image (when multiple), edited for text and shape adjustments, and saved/discarded using the regular Edit mode (bonus track 1: temp storage that persists when you log out and come back in to your session). Archipelago also exposes a full API for WebAnnotations, that keeps track of which Images (referenced in the Strawberryfield @ as:image) were annotated and creates the W3C valid entries inside your Digital Object's JSON @ ap:annotationCollection (bonus track 2: multiple users can annotate the same resource, enabling digital scholarship collaboration opportunities).

    Important Note: For any image-based Digital Objects you would like to apply annotations to, the Digital Object type must be setup to display the image file(s) using the Open SeaDragon viewer. More information about about Managing Display Modes in Archipelago can be found here. Please stay tuned for updates announcing web annotation integration for Mirador 3.

    "},{"location":"annotations/#enabling-annotations","title":"Enabling Annotations","text":"
    1. Navigate to Admin --> Structure --> Content types --> Digital Object --> Manage Display and select the \"Digital Object Full view\" mode. https://yoursite.org/admin/structure/types/manage/digital_object/display/digital_object_viewmode_fullitem
    2. On the \u201cFragola\u201d row, click on the small gear icon on the far right, which will be open the configurations for this display type.
    3. Select the \u201cEnable loading/editing of W3C webAnnotations\u201d option.
      • Learn more about the JSON format of WebAnnotations here: https://www.w3.org/TR/annotation-model/#index-of-json-keys.
    4. Under \"What tool to enable\", select either the Rectangular or Polygon (freehand drawing) tool for your annotation style.
    5. Select the 'Update' button.
    6. Also Save your settings using the button at the bottom of the page.

    You are now ready to get started adding annotations!

    "},{"location":"annotations/#adding-and-saving-annotations","title":"Adding and Saving Annotations","text":"
    1. Navigate to the image-based Digital Object you would like to apply annotations to.
    2. To add a new annotation, select and hold the Shift key. Click and then drag to apply either a Rectangular box or multi-point Polygon shape.
    3. Double click to exit the annotation drawing mode.
    4. Enter the text for your annotation in the pop-up window.
    5. Click the \"Ok\" button when you are ready.
    6. To save your annotation (or annotations if you created multiple), navigate to the main Digital Object \"Edit\" tab, where you will see a message about Unsaved Web Annotation Changes.
    7. Select \"Save\" to preserve your Annotation(s). They will now become part of your Digital Object's JSON, found under the ap:annotationCollection key.
      • Pressing the \"Discard\" button will discard only the unsaved Annotations, and will reload the page.
    "},{"location":"annotations/#editing-and-deleting-annotations","title":"Editing and Deleting Annotations","text":"
    1. Navigate to the image-based Digital Object you would whose annotation(s) you want to edit or delete.
    2. Click within the Annotation and select the downwards arrow in the upper right-hand corner of the pop-up window.
    3. Select either the \"Edit\" option and Edit the Annotation as desired; Or select the \"Delete\" option.
    4. To preserve your editing or deleting actions, navigate to the main Digital Object \"Edit\" tab, where you will see a message about Unsaved Web Annotation Changes. (See screenshot in Step 6 of Adding and saving Annotations above.)
    5. Select \"Save\" to preserve your Annotation(s) edits or deletions. Pressing the \"Discard\" button will discard only the unsaved Annotations changes, and will reload the page.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"archifilepersistencestrategy/","title":"Archipelago's File Persistence Strategy","text":""},{"location":"archifilepersistencestrategy/#how-are-files-for-archipelago-digital-objects-ados-persisted-what-happens-with-those-fishtanks","title":"How are files for Archipelago Digital Objects (ADOs) persisted? (What happens with those fishtanks?)","text":"

    A few Event Subscribers/Data describing logics happen in a certain order:

    1. User Uploads via a webform Element a new File or via Drush/Batch ingest that attaches (via JSONAPI) a file.

    2. If the webform is involved, Archipelago acts quickly and calls directly (before the Node even exists) the file classifier, that will:

      1. Add/complement a as:somefiletype JSON structure into the main ADO SBF JSON, with info about the file, checksums, size, Drupal fids, uuid, etc. This is a heavy function part of the StrawberryfieldFilePersisterService. It does a lot, making use of optimized logic, but may do more in the future to handle too-many/too-big files needs (FYI: solution will be simple, add to a queue and process later).
      2. The most (yes) important info added here is the desired future storage location of the file.

    3. The user finishes the form, saves and and confirms the ADO creation, and finally all the Node events fire.

    4. On presave StrawberryfieldEventPresaveSubscriberAsFileStructureGenerator runs and checks if 2.1 already was processed. This is needed since the user could have triggered an ingest via drush/JSONAPI/Webhooks etc. If all is well (this is a less expensive check) Archipelago continues.

    5. On presave (next) StrawberryfieldEventPresaveSubscriberFilePersister runs, checking all TEMPORARY files described in as:somefiletype and actually copying them to the right \"desired\" location.

    6. And on Save StrawberryfieldEventInsertFileUsageUpdater also marking the file as \"being\" used by a Strawberry driven Node (different Event).

    Note: Anytime we remove directly from the raw JSON a full as:somefiletype structure of a sub-element from an as:structure we force Archipelago to do all the above again, and Archipelago can regenerate technical metadata. This has been used when updating EXIF binaries or even when something went wrong (while testing, but this stuff is safe no worries). Eventually, there will be a BIG red button that does that if you do not like JSON editing.

    Discussions related to Archipelago's file persistence strategy and planned potential strategies can be be found here: Strawberryfield Issues: 107, and here: Strawberryfield Issues: 76. This page will be updated with additional information following future developments.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/","title":"Archipelago-deployment: upgrading Drupal 9 to Drupal 10 (1.1.0 to 1.3.0)","text":"","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#what-is-this-documentation-for","title":"What is this documentation for?","text":"

    If you already have a well-set-up and well-loved Archipelago (1.1.0) running Drupal 9 (D9), this documentation will allow you to update to 1.3.0 on Drupal 10 (D10) without any major issues.

    D9 is no longer supported as of the end of November 2023. D10 has been around for a little while, and even if every module is not supported yet, what you need and want for Archipelago has long been ready for D10. However, Archipelago is still D9 compatible if it's necessary for you to stay back a little longer.

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#requirements","title":"Requirements","text":"
    • An archipelago-deployment local instance 1.1.0 (working, tested) deployed using provided instructions via Docker and running Drupal 9.
    • Basic knowledge and instincts (+ courage) on how to run Terminal Commands, composer and drush.
    • Patience. You can't skip steps here.
    • For shell Commands documented here please copy line by line--not the whole block.
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#backing-up-and-preparing-for-the-upgrade","title":"Backing up and preparing for the upgrade","text":"

    Backups are always going to be your best friends. Archipelago's code, database, and settings are mostly self-contained in your current archipelago-deployment repo folder, and backing up is simple because of that.

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-1","title":"Step 1:","text":"

    On a terminal, cd into your running archipelago-deployment folder and shut down your docker-compose ensemble by running the following:

    docker-compose down\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-2","title":"Step 2:","text":"

    Verify that all containers are actually down. The following command should return an empty listing:

    docker ps\n

    If anything is still running, wait a little longer and run the command again.

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-3","title":"Step 3:","text":"

    Now let's tar.gz the whole ensemble with data and configs. As an example we will save this into your $HOME folder. As a good practice we append the current date (YEAR-MONTH-DAY) to the filename. Here we assume today is October 31st of 2023.

    cd ..\nsudo tar -czvpf $HOME/archipelago-deployment-D9-20231031.tar.gz archipelago-deployment\ncd archipelago-deployment\n

    The process may take a few minutes. Now let's verify that all is there and that the tar.gz is not corrupt.

    tar -tvvf $HOME/archipelago-deployment-D9-20231031.tar.gz\n

    You will see a listing of files, and at the end you will see something like this: Archive Format: POSIX pax interchange format, Compression: gzip. If corrupt (Do you have enough space? Did your ssh connection drop?) you will see the following:

    tar: Unrecognized archive format\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-4","title":"Step 4:","text":"

    Restart your docker-compose ensemble, and wait a little while for all to start.

    docker-compose up -d\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-5","title":"Step 5:","text":"

    Export/backup all of your live Archipelago configurations (this allows you to compare/come back in case you lose something custom during the upgrade).

    docker exec esmero-php mkdir config/backup\ndocker exec esmero-php drush cex --destination=/var/www/html/config/backup\n

    Good. Now it's safe to begin the upgrade process.

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#upgrading-to-130","title":"Upgrading to 1.3.0","text":"","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-1-edit-docker-composeryml","title":"Step 1: Edit docker-composer.yml","text":"

    First we are going to edit your docker-compose.yml file to reference the latest PHP container as needed. Starting in your Archipelago deployment directory location, run the following commands:

    If you have not already, run:

    docker-compose down\n

    Then open your docker-compose.yml file:

    nano docker-compose.yml\n

    Inside your docker-compose.yml file, page down to the php section and change the image section to match exactly as follows:

    image: \"esmero/php-8.1-fpm:1.2.0-multiarch\"\n

    Next page down to the iiif section and change the image section to match exactly as follows:

    image: \"esmero/cantaloupe-s3:6.0.1-multiarch\"\n

    Save your changes.

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-2-docker-pull-and-check","title":"Step 2: docker pull and check","text":"

    Time to fetch the latest branch and update our docker compose and composer dependencies. To pull the images and bring up the ensemble, run:

    docker compose pull\ndocker compose up -d\n

    Give all a little time to start. Please be patient. To ensure all is well, run (more than once if necessary) the following:

    docker ps\n

    You should see something like this:

    CONTAINER ID   IMAGE                                      COMMAND                  CREATED          STATUS          PORTS                              NAMES\n355e13878b7e   nginx                                      \"/docker-entrypoint.\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:8001->80/tcp               esmero-web\n86b685008158  solr:8.11.2                                 \"docker-entrypoint.s\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:8983->8983/tcp             esmero-solr\na8f0d9c6d4a9   esmero/cantaloupe-s3:6.0.1-multiarch       \"sh -c 'java -Dcanta\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:8183->8182/tcp             esmero-cantaloupe\n6642340b2496   mariadb:10.6.12-focal                      \"docker-entrypoint.s\u2026\"   10 minutes ago   Up 10 minutes   3306/tcp                           esmero-db\n0aef7df34037   minio/minio:RELEASE.2022-06-11T19-55-32Z   \"/usr/bin/docker-ent\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:9000-9001->9000-9001/tcp   esmero-minio\n28ee3fb4e7a7   esmero/php-8.1-fpm:1.2.0-multiarch         \"docker-php-entrypoi\u2026\"   10 minutes ago   Up 10 minutes   9000/tcp                           esmero-php\na81c36d51a81   esmero/esmero-nlp:fasttext-multiarch       \"/usr/local/bin/entr\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:6400->6400/tcp             esmero-nlp\n

    Important here is the STATUS column. It needs to be a number that goes up in time every time you run docker ps again (and again).

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-3-updates-for-key-drupal-and-archipelago-modules","title":"Step 3. Updates for key Drupal and Archipelago modules","text":"

    Now we are going to tell composer to update the key Drupal and Archipelago modules.

    First we are going to disable and remove a few minor Drupal modules. Run the following commands (in order):

    docker exec -ti esmero-php bash -c \"drush pm-uninstall fancy_file_delete\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall quickedit\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/fancy_file_delete\"\n

    Now update the versions used for these Drupal modules:

    docker exec -ti esmero-php bash -c \"composer require drupal/jquery_ui_slider:^2 drupal/jquery_ui_effects:^2 drupal/jquery_ui:1.6 drupal/jquery_ui_datepicker:^2 drupal/jquery_ui_touch_punch:^1 drupal/better_exposed_filters:6.0.3 --no-update --with-all-dependencies\"\n

    And now update one other Drupal module and the main Archipelago modules:

    docker exec -ti esmero-php bash -c \"composer require 'drupal/views_bulk_operations:^4.2' 'strawberryfield/strawberryfield:1.3.0.x-dev' 'strawberryfield/webform_strawberryfield:1.3.0.x-dev' 'strawberryfield/format_strawberryfield:1.3.0.x-dev' 'strawberryfield/strawberry_runners:0.7.0.x-dev' 'archipelago/ami:0.7.0.x-dev' --no-update --with-all-dependencies\"\n

    From inside your archipelago-deployment repo folder we are now going to open up file permissions for some of your most protected Drupal files.

    sudo chmod 777 web/sites/default\nsudo chmod 666 web/sites/default/*settings.php\nsudo chmod 666 web/sites/default/*services.yml\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-4-disableremove-additional-drupal-modules-and-loosen-up-dependencies","title":"Step 4: Disable/Remove additional Drupal modules and loosen up dependencies","text":"

    We are going to remove additional select Drupal modules that are not 1.3.0 or D10 compliant.

    Please run each of the following commands separately, in order, and do not skip any commands.

    docker exec -ti esmero-php bash -c \"composer remove symfony/http-kernel symfony/yaml --no-update\"\ndocker exec -ti esmero-php bash -c 'composer remove egulias/email-validator --no-update'\ndocker exec -ti esmero-php bash -c \"composer require drupal/config_inspector:^2 --no-update\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall jsonapi_earlyrendering_workaround\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/jsonapi_earlyrendering_workaround --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/core:^10' 'drupal/core-recommended:^10' 'drupal/core-composer-scaffold:^10' 'drupal/core-project-message:^10' --update-with-dependencies --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/core-dev:^10' --dev --update-with-dependencies --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drush/drush:^12' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/twig_tweak:^2 --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/config_inspector:^2 --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/config_update:2.0.x-dev --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/config_update_ui --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/context:^5.0@RC' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/devel:^5.1' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/sophron --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove fileeye/mimemap --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/imagemagick:^3 --no-update\"  \ndocker exec -ti esmero-php bash -c \"composer remove fileeye/mimemap --no-update\"    \ndocker exec -ti esmero-php bash -c \"composer require 'drupal/imce:^3.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/search_api_attachments:^9.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/search_api_solr:^4.3 solarium/solarium ^6.3 --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/twig_tweak:^3.2' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/webform_entity_handler:^2.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/webformnavigation:^2.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/form_mode_manager --no-update\"\n

    Well done! If you see no issues and all ends in Green colored messages, all is good! Jump to Step 5

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#what-if-all-is-not-ok-and-i-see-red-and-a-lot-of-dependency-explanations","title":"What if all is not OK, and I see red and a lot of dependency explanations?","text":"

    If you have manually installed packages via composer in the past that are NO longer Drupal 10 compatible you may see errors. In that case you need to check each package website's (normally https://www.drupal.org/project/the_module_name) and check if there is a Drupal 10 compatible version.

    If so run:

    docker exec -ti esmero-php bash -c \"composer require drupal/the_module_name:^VERSION_NUMBER_THAT_WORKS_ON_DRUPAL10_ --update-with-dependencies --no-update\" and run **Step 3** again (and again until all is cleared)\n

    If not, try to find a replacement module that does something similar, but in any case you may end up having to remove before proceeding. Give us a ping/slack/google group/open a github ISSUE if you find yourself uncertain about this.

    docker exec -ti esmero-php bash -c \"drush pm-uninstall the_module_name\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/the_module_name --no-update\"\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-5-update-composerjson","title":"Step 5: Update composer.json","text":"

    Now you need to update your composer.json file to include an important patch. Starting in your Archipelago deployment directory location, run the following commands:

    nano composer.json\n

    Inside your composer.json file, page down to the \"patches\" section and change the section to match exactly as follows:

    \"patches\": {\n      \"drupal/form_mode_manager\": {\n       \"D10 compatibility\": \"https://www.drupal.org/files/issues/2023-10-11/3297262-20.patch\"\n      },\n      \"drupal/ds\": {\n       \"https://www.drupal.org/project/ds/issues/3338860\": \"https://www.drupal.org/files/issues/2023-04-04/3338860-5-d10-compatible_0.patch\"\n      }\n    }\n

    Save your changes and then run:

    docker exec -ti esmero-php bash -c \"composer update -W\"\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-6-one-final-round-of-drupal-module-updates","title":"Step 6: One final round of Drupal module updates","text":"

    We will now run a few more updates for additional Drupal modules.

    Please run each of the following commands separately, in order, and do not skip any commands.

    docker exec -ti esmero-php bash -c \"composer require mglaman/composer-drupal-lenient\"\ndocker exec -ti esmero-php bash -c \"composer config --merge --json extra.drupal-lenient.allowed-list '[\\\"drupal/form_mode_manager\\\"]'\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/form_mode_manager:2.x-dev@dev'\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/color:^1.0'\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/hal\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/aggregator\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/ckeditor\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/seven\"\ndocker exec -ti esmero-php bash -c \"composer require archipelago/archipelago_subtheme:1.3.0.x-dev\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/quickedit drupal/classy drupal/stable\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall quickedit\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall hal\"\ndocker exec -ti esmero-php bash -c \"drush pm:install jquery_ui\"\n

    Whew, that's a lot of module updates! Now run one final database update command:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-7-optional-syncs","title":"Step 7: Optional Syncs","text":"

    Optionally, you can sync your new Archipelago 1.3.0 and bring in all the latest configs and settings. For this you have two options (no worries, remember you made a backup!):

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#a-partial-sync-which-will-bring-new-configs-and-update-existing-ones-but-will-not-remove-ones-that-only-exist-in-your-custom-setup-eg-new-webforms-or-view-modes","title":"A Partial Sync, which will bring new configs and update existing ones but will not remove ones that only exist in your custom setup, e.g. new Webforms or View Modes.","text":"
    docker exec esmero-php drush cim -y --partial   \n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#a-complete-sync-which-will-bring-new-things-and-update-existing-but-will-also-remove-all-the-ones-that-are-not-part-of-130-its-a-like-clean-factory-reset","title":"A Complete Sync, which will bring new things and update existing but will also remove all the ones that are not part of 1.3.0. It's a like clean factory reset.","text":"
    docker exec esmero-php drush cim -y\n

    If all goes well here and you see no errors it's time to reindex Solr because there are new Fields. Run the following:

    docker exec esmero-php drush search-api-reindex\ndocker exec esmero-php drush search-api-index\n

    You might see some warnings related to modules dealing with previously non-existent data\u2014no worries, just ignore those.

    If you made it this far you are done with code/devops (are we ever ready?), and that means you should be able to (hopefully) stay in the Drupal 10 realm for a few years!

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-8-update-or-not-your-metadata-display-entities-and-menu-items","title":"Step 8: Update (or not) your Metadata Display Entities and menu items","text":"

    Recommended: If you want to add new templates and menu items 1.3.0 provides, run this:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    Once that is done, you can choose to update all Metadata Displays (twig templates) we ship with new 1.3.0 versions (heavily adjusted IIIF manifests, better Object description template using Macros). Before you do this, we strongly recommend that you first make sure to manually (copy/paste) backup any Twig templates you have modified. If unsure, do not run the command that comes after this warning! You can always manually copy the new templates from the d8content/metadatadisplays folder which contains text versions (again, copy/paste) of each shipped template you can pick and use when you feel ready.

    If you are sure (like really?) you want to overwrite the ones you modified (sure, just checking?), then you can run this:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/update_deployed.sh'\n

    Done! (For realz now)

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-9-or-should-we-say-10","title":"Step 9 (or should we say 10)","text":"

    Please login to your Archipelago and test/check all is working! Enjoy 1.3.0 and Drupal 10. Thanks!

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#need-help-blue-screen-missed-a-step-need-a-hug-and-such","title":"Need help? Blue Screen? Missed a step? Need a hug and such?","text":"

    If you see any issues or errors or need help with a step, please let us know (ASAP!). You can either open an issue in this repository or use the Google Group. We are here to help.

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Sherrick
    • Giancarlo Birello
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-democontent/","title":"Adding Demo Archipelago Digital Objects (ADOs) to your Repository","text":"

    We make this optional since we feel not everyone wants to have Digital Objects from other people using space in their system. Still, if you are new to Archipelago we encourage you to do this. Its a simply way to get started without thinking too much. You can learn and test. Then delete and move over.

    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#prerequisites","title":"Prerequisites","text":"","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#the-new-way-archipelago-100-rc2-or-higher","title":"The new way Archipelago 1.0.0-RC2 or higher.","text":"
    • You installed it either via the Step by Step deployment on OSX, the one for Ubuntu or using your secret powers directly on a VM/Metal/Cloud/EC2 or even a raspberryPI.
    • You followed the guides without being too creative which means you have an jsonapi drupal user and an admin one and you can login and out of your server.
    • You remember your admin user. (If you followed one of the deployment guides, password will be archipelago)
    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#step-1-only-step","title":"Step 1: (only step)","text":"
    • Log into your Archipelago using the admin user.
    • Navigate to Content -> Ami Sets. You will see a single AMI Set already in place.
    • On the Drop Down Menu to the right (The edit Button), press on the little down arrow and choose Process.
    • A new Form will appear. Under DESIRED ADOS STATUSES AFTER PROCESS, change all from Draft to Published, leave Enqueue but do not process Batch in realtime unchecked and press \"Confirm\". The Ingest will start and a progress bar will advance. Once ready a list of Ingest Objects should appear.
    • You are done!
    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#old-way-a-running-archipelago-10-beta3-or-higher","title":"Old way, A running Archipelago 1.0-Beta3 or higher.","text":"
    • You installed it either via the Step by Step deployment on OSX, the one for Ubuntu or using your secret powers directly on a VM/Metal/Cloud/EC2 or even a raspberryPI.
    • You followed the guides without being too creative which means you have a jsonapi drupal user and you can login and out of your server.
    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#step-1-get-the-content","title":"Step 1: Get the content","text":"

    Go into your archipelago-deployment folder and into the d8content folder that is inside it, e.g.

    cd archipelago-deployment/d8content\ngit clone https://github.com/esmero/archipelago-recyclables\n
    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#step-2-ingest-the-objects","title":"Step 2: Ingest the Objects","text":"
    • If running Docker execute:
    docker exec -ti esmero-php bash -c 'd8content/archipelago-recyclables/deploy_ados.sh'\n

    You will see multiple outputs similar to this:

    Files in provided location:\n - anne_001.jpg\n - anne_002.jpg\n - anne_003.jpg\n - anne_004.jpg\n - anne_005.jpg\n - anne_006.jpg\n - anne_007.jpg\n - anne_008.jpg\n - anne_009.jpg\n - anne_010.jpg\nFile anne_001.jpg sucessfully uploaded with Internal Drupal file ID 5\nFile anne_002.jpg sucessfully uploaded with Internal Drupal file ID 6 \nFile anne_003.jpg sucessfully uploaded with Internal Drupal file ID 7\nFile anne_004.jpg sucessfully uploaded with Internal Drupal file ID 8\nFile anne_005.jpg sucessfully uploaded with Internal Drupal file ID 9 \nFile anne_006.jpg sucessfully uploaded with Internal Drupal file ID 10 \nFile anne_007.jpg sucessfully uploaded with Internal Drupal file ID 11 \nFile anne_008.jpg sucessfully uploaded with Internal Drupal file ID 12\nFile anne_009.jpg sucessfully uploaded with Internal Drupal file ID 13 \nFile anne_010.jpg sucessfully uploaded with Internal Drupal file ID 14\nNew Object 'Anne of Green Gables : Chapters 1 and 2' with UUID 9eb28775-d73a-4904-bc79-f0e925075bc5 successfully ingested. Thanks!\n

    The gist here is that if the script says Thanks you are good.

    • If you are not running Docker (You are a unicorn or at least a hacker) you will need to tune/copy/modify the following script: archipelago-deployment/d8content/archipelago-recyclables/deploy_ados.sh

    Inside you will find lines like this one: 

    drush archipelago:jsonapi-ingest /var/www/html/d8content/archipelago-recyclables/ado/0c2dc01a-7dc2-48a9-b4fd-3f82331ec803.json --uuid=0c2dc01a-7dc2-48a9-b4fd-3f82331ec803 --bundle=digital_object --uri=http://esmero-web --files=/var/www/html/d8content/archipelago-recyclables/ado/0c2dc01a-7dc2-48a9-b4fd-3f82331ec803 --user=jsonapi --password=jsonapi --moderation_state=published;\n

    What you want here is to modify/replace the absolute paths that point your demo objects (.json) and their assets (folders with the same name). Basically replace every entry of /var/www/html/d8content/archipelago-recyclables/ with the path to archipelago-recyclables.

    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#need-help-blue-screen-missed-a-step-need-a-hug-another-hug","title":"Need help? Blue Screen? Missed a step? Need a hug? Another Hug?","text":"

    If you have trouble running this or see errors or need help with a step (its only two steps), please let us know (ASAP!). You can either open an issue in this repository or use the Google Group. We are here to help.

    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#caring-coding-fixing","title":"Caring & Coding + Fixing","text":"
    • Diego Pino
    • Giancarlo Birello
    • Allison Lund
    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/","title":"Archipelago-deployment-live: upgrading Drupal 9 to Drupal 10 (1.1.0 to 1.3.0)","text":"","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#what-is-this-documentation-for","title":"What is this documentation for?","text":"

    If you already have a well-set-up and well-loved Archipelago (1.1.0) running Drupal 9 (D9), this documentation will allow you to update to 1.3.0 on Drupal 10 (D10) without any major issues.

    D9 is no longer supported as of the end of November 2023. D10 has been around for a little while, and even if every module is not supported yet, what you need and want for Archipelago has long been ready for D10. However, Archipelago is still D9 (1.2.0) compatible if it's necessary for you to stay back a little longer.

    This documentation is meant to be a guide/helper, not a single-click-magic solution. Why? Because your Drupal environment and your local github branches for this whole project might have diverged really a lot from a vanilla Archipelago base deployment. You might have new templates, custom composer.json, new modules, changed webforms and Views. That is not an Archipelago issue, more like a How do i keep any Drupal instance, YAML files, custom configurations and modules in version control and in sync as i upgrade other parts, issue.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#requirements","title":"Requirements","text":"
    • An archipelago-deployment-live instance 1.1.0 (working, tested) deployed using provided instructions via Docker and running Drupal 9.
    • Basic knowledge, patience and instincts (+ courage) on how to run Terminal Commands, composer and drush.
    • Patience(again). You can't skip steps here.
    • For shell Commands documented here please copy line by line--not the whole block.
    • You are running already version control and know how to git pull/push/merge.
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#backing-up-and-preparing-for-the-upgrade","title":"Backing up and preparing for the upgrade","text":"

    Backups are always going to be your best friends. Archipelago's code, database, and settings are mostly self-contained in your current archipelago-deployment-live repo folder, and backing up is simple because of that.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-1","title":"Step 1:","text":"

    On a terminal, cd into your running archipelago-deployment-live folder, then cd inside the deploy/ec2-docker subfolders and shut down your docker-compose ensemble by running the following:

    docker-compose down\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-2","title":"Step 2:","text":"

    Verify that all containers are actually down. The following command should return an empty listing:

    docker ps\n

    If anything is still running, wait a little longer and run the command again.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-3","title":"Step 3:","text":"

    Now let's tar.gz the whole ensemble with data and configs. We will exclude here the local source caches generated by Cantaloupe. If these or not exist will depend on how custom your deployment is. As an example we will save this into your $HOME folder. As a good practice we append the current date (YEAR-MONTH-DAY) to the filename. Here we assume today is December 12th of 2023.

    We will cd back to the parent folder of your running archipelago-deployment-live folder, so three levels down, assuming you are right now inside archipelago-deployment-live/deploy/ec2-docker

    cd ../../..\nsudo tar --exclude=archipelago-deployment-live/data_storage/iiifcache --exclude=archipelago-deployment-live/data_storage/iiiftmp -czvpf $HOME/archipelago-deployment-D9-20231212.tar.gz archipelago-deployment-live\n

    The process may take a few minutes. Now let's verify that all is there and that the tar.gz is not corrupt.

    tar -tvvf $HOME/archipelago-deployment-D9-20231212.tar.gz\n

    You will see a listing of files, and at the end you will see something like this: Archive Format: POSIX pax interchange format, Compression: gzip. If corrupt (Do you have enough space? Did your ssh connection drop?) you will see the following:

    tar: Unrecognized archive format\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-4","title":"Step 4:","text":"

    cd again into your running archipelago-deployment-live folder, then cd inside the deploy/ec2-docker Restart your docker-compose ensemble, and wait a little while for all to start.

    docker-compose up -d\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-5","title":"Step 5:","text":"

    Export/backup all of your live Archipelago 1.1.0, Drupal 9 configurations (this allows you to compare/come back in case you lose something custom during the upgrade).

    docker exec esmero-php mkdir config/backup\ndocker exec esmero-php drush cex --destination=/var/www/html/config/backup\n

    Good. Now it's safe to begin the upgrade process.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#upgrading-to-130","title":"Upgrading to 1.3.0","text":"","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-1-edit-docker-composeryml","title":"Step 1: Edit docker-composer.yml","text":"

    First we are going to edit your docker-compose.yml file to reference the latest PHP container as needed. Starting in your Archipelago deployment directory location, run the following commands:

    If you have not already, run:

    docker-compose down\n

    Then open your docker-compose.yml file:

    nano docker-compose.yml\n

    Inside your docker-compose.yml file, page down to the php section and change the image section to match exactly as follows:

    image: \"esmero/php-8.1-fpm:1.2.0-multiarch\"\n

    Next page down to the iiif section and change the image section to match exactly as follows:

    image: \"esmero/cantaloupe-s3:6.0.1-multiarch\"\n

    Save your changes.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-2-docker-pull-and-check","title":"Step 2: docker pull and check","text":"

    Time to fetch the latest branch and update our docker compose and composer dependencies. To pull the images and bring up the ensemble, run:

    docker compose pull\ndocker compose up -d\n

    Give all a little time to start. Please be patient. To ensure all is well, run (more than once if necessary) the following:

    docker ps\n

    You should see something like this (your versions might vary):

    CONTAINER ID   IMAGE                                      COMMAND                  CREATED          STATUS          PORTS                              NAMES\n355e13878b7e   nginx                                      \"/docker-entrypoint.\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:8001->80/tcp               esmero-web\n86b685008158   solr:8.11.2                                \"docker-entrypoint.s\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:8983->8983/tcp             esmero-solr\na8f0d9c6d4a9   esmero/cantaloupe-s3:6.0.1-multiarch       \"sh -c 'java -Dcanta\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:8183->8182/tcp             esmero-cantaloupe\n6642340b2496   mariadb:10.6.12-focal                      \"docker-entrypoint.s\u2026\"   10 minutes ago   Up 10 minutes   3306/tcp                           esmero-db\n0aef7df34037   minio/minio:RELEASE.2022-06-11T19-55-32Z   \"/usr/bin/docker-ent\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:9000-9001->9000-9001/tcp   esmero-minio\n28ee3fb4e7a7   esmero/php-8.1-fpm:1.2.0-multiarch         \"docker-php-entrypoi\u2026\"   10 minutes ago   Up 10 minutes   9000/tcp                           esmero-php\na81c36d51a81   esmero/esmero-nlp:fasttext-multiarch       \"/usr/local/bin/entr\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:6400->6400/tcp             esmero-nlp\n

    Important here is the STATUS column. It needs to be a number that goes up in time every time you run docker ps again (and again). Note: We will update from Solr 8.11.2 to Solr 9.1.1 only after we are sure all is running correctly.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-3-updates-for-key-drupal-and-archipelago-modules","title":"Step 3. Updates for key Drupal and Archipelago modules","text":"

    Now we are going to tell composer to update the key Drupal and Archipelago modules.

    First we are going to disable and remove a few minor Drupal modules. Run the following commands (in order):

    docker exec -ti esmero-php bash -c \"drush pm-uninstall fancy_file_delete\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall quickedit\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/fancy_file_delete\"\n

    Now update the versions used for these Drupal modules:

    docker exec -ti esmero-php bash -c \"composer require drupal/jquery_ui_slider:^2 drupal/jquery_ui_effects:^2 drupal/jquery_ui:1.6 drupal/jquery_ui_datepicker:^2 drupal/jquery_ui_touch_punch:^1 drupal/better_exposed_filters:6.0.3 --no-update --with-all-dependencies\"\n

    And now update one other Drupal module and the main Archipelago modules:

    docker exec -ti esmero-php bash -c \"composer require 'drupal/views_bulk_operations:^4.2' 'strawberryfield/strawberryfield:1.3.0.x-dev' 'strawberryfield/webform_strawberryfield:1.3.0.x-dev' 'strawberryfield/format_strawberryfield:1.3.0.x-dev' 'strawberryfield/strawberry_runners:0.7.0.x-dev' 'archipelago/ami:0.7.0.x-dev' --no-update --with-all-dependencies\"\n

    From inside your archipelago-deployment-live repo folder, and inside the drupal subfolder, we are now going to open up file permissions for some of your most protected Drupal files.

    sudo chmod 777 web/sites/default\nsudo chmod 666 web/sites/default/*settings.php\nsudo chmod 666 web/sites/default/*services.yml\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-4-disableremove-for-additional-select-drupal-modules","title":"Step 4: Disable/Remove for additional select Drupal modules","text":"

    We are going to remove additional select Drupal modules that are not 1.3.0 or D10 compliant.

    Please run each of the following commands separately, in order, and do not skip any commands.

    docker exec -ti esmero-php bash -c \"composer remove symfony/http-kernel symfony/yaml --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/config_inspector:^2 --no-update\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall jsonapi_earlyrendering_workaround\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/jsonapi_earlyrendering_workaround --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/core:^10' 'drupal/core-recommended:^10' 'drupal/core-composer-scaffold:^10' 'drupal/core-project-message:^10' --update-with-dependencies --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/core-dev:^10' --dev --update-with-dependencies --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/google_api_client\"\ndocker exec -ti esmero-php bash -c \"composer require 'drush/drush:^12' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/twig_tweak:^2 --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/config_inspector:^2 --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/config_update:2.0.x-dev --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/config_update_ui --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/context:^5.0@RC' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/devel:^5.1' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/sophron --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove fileeye/mimemap --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/imagemagick:^3 --no-update\"  \ndocker exec -ti esmero-php bash -c \"composer remove fileeye/mimemap --no-update\"    \ndocker exec -ti esmero-php bash -c \"composer remove drupal/jsonapi_earlyrendering_workaround --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/imce:^3.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/search_api_attachments:^9.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/twig_tweak:^3.2' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/webform_entity_handler:^2.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/webformnavigation:^2.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/webform_jqueryui_datepicker:^6 --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/rdf --no-update \"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/form_mode_manager --no-update\"\n

    Well done! If you see no issues and all ends in Green colored messages, all is good! Jump to Step 5

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#what-if-all-is-not-ok-and-i-see-red-and-a-lot-of-dependency-explanations","title":"What if all is not OK, and I see red and a lot of dependency explanations?","text":"

    If you have manually installed packages via composer in the past that are NO longer Drupal 10 compatible you may see errors. In that case you need to check each package website's (normally https://www.drupal.org/project/the_module_name) and check if there is a Drupal 10 compatible version.

    If so run:

    docker exec -ti esmero-php bash -c \"composer require 'drupal/the_module_name:^VERSION_NUMBER_THAT_WORKS_ON_DRUPAL10_' --update-with-dependencies --no-update\" and run **Step 3 ** again (and again until all is cleared)\n

    If not, try to find a replacement module that does something similar, but in any case you may end up having to remove before proceeding. Give us a ping/slack/google group/open a github ISSUE if you find yourself uncertain about this.

    docker exec -ti esmero-php bash -c \"drush pm-uninstall the_module_name\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/the_module_name --no-update\"\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-5-update-composerjson","title":"Step 5: Update composer.json","text":"

    Now you need to update your composer.json file to include an important patch. Starting in your Archipelago deployment directory location, run the following commands:

    nano composer.json\n

    Inside your composer.json file, page down to the \"patches\" section and change the section to match exactly as follows:

    \"patches\": {\n      \"drupal/form_mode_manager\": {\n       \"D10 compatibility\": \"https://www.drupal.org/files/issues/2023-11-07/3297262-62-form-mode-manager-D10.patch\"\n      },\n      \"drupal/ds\": {\n       \"https://www.drupal.org/project/ds/issues/3338860\": \"https://www.drupal.org/files/issues/2023-04-04/3338860-5-d10-compatible_0.patch\"\n      }\n    }\n

    Save your changes and then run:

    docker exec -ti esmero-php bash -c \"composer update -W\"\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-6-one-final-round-of-drupal-module-updates","title":"Step 6: One final round of Drupal module updates","text":"

    We will now run a few more updates for additional Drupal modules.

    Please run each of the following commands separately, in order, and do not skip any commands.

    docker exec -ti esmero-php bash -c \"composer require mglaman/composer-drupal-lenient\"\ndocker exec -ti esmero-php bash -c \"composer config --merge --json extra.drupal-lenient.allowed-list '[\\\"drupal/form_mode_manager\\\"]'\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/form_mode_manager:2.x-dev@dev'\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/color:^1.0'\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/hal\"  \ndocker exec -ti esmero-php bash -c \"composer require drupal/aggregator\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/ckeditor\"  \ndocker exec -ti esmero-php bash -c \"composer require drupal/seven\"\ndocker exec -ti esmero-php bash -c \"composer require archipelago/archipelago_subtheme:1.3.0.x-dev\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/classy drupal/stable\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall hal\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall rdf\"\ndocker exec -ti esmero-php bash -c \"drush pm:install jquery_ui\"\ndocker exec -ti esmero-php bash -c \"drush pm:install jquery_ui_effects\"\n

    Whew, that's a lot of module updates! Now run one final database update command:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-7-optional-syncs","title":"Step 7: Optional Syncs","text":"

    Optionally, you can sync your new Archipelago 1.3.0 and bring in all the latest configs and settings. This requires you do fetch, either via git or manually via wget or curl newer configs from https://github.com/esmero/archipelago-deployment-live/tree/1.3.0/drupal/config/sync into the same folder structure/location of your deployment.

    For this you have two options (no worries, remember you made a backup!):

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#a-partial-sync-which-will-bring-new-configs-and-update-existing-ones-but-will-not-remove-ones-that-only-exist-in-your-custom-setup-eg-new-webforms-or-view-modes","title":"A Partial Sync, which will bring new configs and update existing ones but will not remove ones that only exist in your custom setup, e.g. new Webforms or View Modes.","text":"
    docker exec esmero-php drush cim -y --partial\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#a-complete-sync-which-will-bring-new-things-and-update-existing-but-will-also-remove-all-the-ones-that-are-not-part-of-130-its-a-like-clean-factory-reset","title":"A Complete Sync, which will bring new things and update existing but will also remove all the ones that are not part of 1.3.0. It's a like clean factory reset.","text":"
    docker exec esmero-php drush cim -y\n

    If all goes well here and you see no errors it's time to reindex Solr because there are new Fields. Run the following:

    docker exec esmero-php drush search-api-reindex\ndocker exec esmero-php drush search-api-index\n

    You might see some warnings related to modules dealing with previously non-existent data\u2014no worries, just ignore those.

    If you made it this far you are done with code/devops (are we ever ready?), and that means you should be able to (hopefully) stay in the Drupal 10 realm for a few years!

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-8-update-or-not-your-metadata-display-entities-and-menu-items","title":"Step 8: Update (or not) your Metadata Display Entities and menu items","text":"

    Recommended: If you want to add new templates and menu items 1.3.0 provides, you need to fetch everything from this remote https://github.com/esmero/archipelago-deployment-live/tree/1.3.0/drupal/d8content to your local installation into the same folder structure/location and then run:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    Important: If you don't download/sync/git merge (or your prefered method) then the command will add nothing, since you will be running this command against 1.1.0 content.

    Once that is done, you can choose to update all Metadata Displays (twig templates) we ship with new 1.3.0 versions (heavily adjusted IIIF manifests, better Object description template using Macros). Before you do this, we strongly recommend that you first make sure to manually (copy/paste) backup any Twig templates you have modified. If unsure, do not run the command that comes after this warning! You can always manually copy the new templates from the d8content/metadatadisplays folder which contains text versions (again, copy/paste) of each shipped template you can pick and use when you feel ready.

    If you are sure (like really?) you really want to overwrite the ones you modified (sure, just checking?), then you can run this (make sure you edit that file):

    docker exec -ti esmero-php bash -c 'scripts/archipelago/update_deployed.sh'\n

    Done! (For realz now)

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-9","title":"Step 9","text":"

    Please login to your Archipelago and test/check all is working! Enjoy 1.3.0 and Drupal 10. Thanks! Also please keep all your new changes under version control. Check what has changed. git add and git commit -m \"What i changed\" as needed.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-10","title":"Step 10","text":"

    If all looks good and you are not missing any functionality (please be thorough about testing), it is time to Jump to Upgrading to Solr 9.11

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#need-help-blue-screen-missed-a-step-need-a-hug-or-someone-that-listens-to-you-in-silence","title":"Need help? Blue Screen? Missed a step? Need a hug or someone that listens to you in silence?","text":"

    If you see any issues or errors or need help with a step, please let us know (ASAP!). You can either open an issue in this repository or use the Google Group. We are here to help.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Sherrick
    • Giancarlo Birello
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-gitworkflow/","title":"Managing, sheltering, pruning and nurturing your own custom Archipelago","text":"

    Now that you have your base Archipelago Live Deployment running (Do you? If not, go back!) you may be wondering about things like:

    1. What happens when I need to update to the next release?
    2. How do I keep my Drupal and Modules updated in between releases?
    3. Can I add Drupal Modules?
    4. Will a new release overwrite all my customizations?
    5. What things are safe to customize?
    6. How do I keep my very own things in Version Control and safe from others?
    7. And many (many) other similar questions.
    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#1-keep-your-archipelago-under-version-control-via-github","title":"1. Keep your Archipelago under Version Control via Github","text":"

    Archipelagos are living beings. They evolve and become beautiful, closer and closer to your needs. Because of that resetting your particularities on every Archipelago code release is not a good idea, nor even recommended. What you want is to keep your own Drupal Settings\u2014your facets, your themes, your Solr fields, your own modules, and all their configurations\u2014safe and be able to restore all in case something goes wrong.

    The ones we ship with every Release will reset your Archipelago's settings to Factory defaults if applied wildly.

    This is where Github comes in place.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#basic-steps","title":"Basic steps","text":"

    Prerequisites:

    • Have an Archipelago Deployment Live instance running
    • Have Terminal access to your Live Instance
    • Have a Github account
    • Have a personal Github Access Token Created
    • Run git config --global --edit on your Live Instance and Set your user name/email/etc.
    • Note: Opens in Vi! In case of emergency/panic press ESC and type :x to escape and/or run away in terror. To edit Press i and uncomment the lines. Once Done press ESC and type :x to save.
    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#11-start-by-creating-a-git-fork","title":"1.1 Start by creating a Git Fork","text":"

    Let's fork https://github.com/esmero/archipelago-deployment-live under your own Account via the web. Happy Note: Since 2021 also keeping forked branches in sync with the origin can be done via the UI directly.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#12-connect-your-live-instance-terminal","title":"1.2 Connect your Live instance terminal.","text":"

    Move to your repository's base folder, and let's start by adding your New Fork as a secondary Git Origin. Replace in this command yourOwnAccount with (guess what?) your own account:

    git remote add upstream https://github.com/yourOwnAccount/archipelago-deployment-live\n

    Now check if you have two remotes (origin => This repository, upstream => your own fork):

    git remote -v\n

    You will see this:

    origin  https://github.com/esmero/archipelago-deployment-live (fetch)\norigin  https://github.com/esmero/archipelago-deployment-live (push)\nupstream    https://github.com/yourOwnAccount/archipelago-deployment-live (fetch)\nupstream    https://github.com/yourOwnAccount/archipelago-deployment-live (push)\n

    Good!

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#13-now-lets-create-from-your-current-live-instance-a-new-branch","title":"1.3 Now let's create from your current Live Instance a new Branch.","text":"

    We will push this branch into your Fork and it will be all yours to maintain. Please replace yourOwnOrg with any Name you want for this. We like to keep the current Branch name in place after your personal prefix:

    git checkout -b yourOwnOrg-1.0.0-RC3\n

    Good, you now have a new local branch named yourOwnOrg-1.0.0-RC3, and it's time to decide what we are going to push into Github.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#14-push-the-basics","title":"1.4 Push the Basics.","text":"

    By default our deployment strategy (this repository) ignores a few files you want to have in Github. Also, there are things like the Installed Drupal Modules and PHP Libraries (the Source Code), the Database, Caches, your Secrets (.env file), and your Drupal settings.php file. You FOR SURE do not want to have these in Github and are better suited for a private Backup Storage.

    Let's start by pushing what you have (no commits, your new yourOwnOrg-1.0.0-RC3 as it is) to your new Fork. From there on we can add new Commits and files:

    git push upstream yourOwnOrg-1.0.0-RC3\n

    And Git will respond with the following (use your yourOwnAccount personal Github Access Token as password):

    Username for 'https://github.com': yourOwnAccount\nPassword for 'https://yourOwnAccount@github.com': \nTotal 0 (delta 0), reused 0 (delta 0)\nremote: \nremote: Create a pull request for 'yourOwnOrg-1.0.0-RC3' on GitHub by visiting:\nremote:      https://github.com/yourOwnAccount/archipelago-deployment-live/pull/new/yourOwnOrg-1.0.0-RC3\nremote: \nTo https://github.com/yourOwnAccount/archipelago-deployment-live\n * [new branch]      yourOwnOrg-1.0.0-RC3 -> yourOwnOrg-1.0.0-RC3\n
    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#15-first-commit","title":"1.5 First Commit","text":"

    Right now this new Branch (go and check it out at https://github.com/yourOwnAccount/archipelago-deployment-live/tree/yourOwnOrg-1.0.0-RC3) will not differ at all from 1.0.0-RC3. That is OK. To make your Branch unique, what we want is to \"commit\" our changes. How do we do this?

    Let's add our composer.json and composer.lock to our change list. Both of these files are quite personal, and as you add more Drupal Modules, dependencies, or Upgrade your Archipelgo and/or Drupal Core and Modules, all of these corresponding files will change. See the -f? Because our base deployment ignores that file and you want it, we \"Force\" add it. Note: At this stage composer.lock won't be added at all because it's still the same as before. So you can only \"add\" files that have changes.

    git add drupal/composer.json \ngit add -f drupal/composer.lock\n

    Now we can see what is new and will be committed by executing:

    git status\n

    You may see something like this:

    On branch yourOwnOrg-1.0.0-RC3 \nChanges to be committed:\n  (use \"git restore --staged <file>...\" to unstage)\n    new file:   drupal/composer.json\n\nChanges not staged for commit:\n  (use \"git add <file>...\" to update what will be committed)\n  (use \"git restore <file>...\" to discard changes in working directory)\n    modified:   drupal/scripts/archipelago/deploy.sh\n    modified:   drupal/scripts/archipelago/update_deployed.sh\n\nUntracked files:\n  (use \"git add <file>...\" to include in what will be committed)\n    deploy/ec2-docker/docker-compose.yml\n    drupal/.editorconfig\n    drupal/.gitattributes\n

    If you do not want to add each Changes not staged for commit individually (WE recommend you only commit what you need. Be warned and take caution.), you can also issue a git add ., which means add all.

    git add drupal/scripts/archipelago/deploy.sh\ngit add drupal/scripts/archipelago/update_deployed.sh\ngit add deploy/ec2-docker/docker-compose.yml\n

    In this case we are also committing docker-compose.yml, which you may have customized and modified to your domain (See Install Guide Step 3), deploy.sh and update_deployed.sh scripts. If you ever need to avoid tracking certain files at all, you can edit the .gitignore file and add more patterns to it (look at it, it's fun!).

    git commit -m \"Fresh Install of Archipelago for yourOwnOrg\"\n

    If you had your email/user account setup correctly (see Prerequisites) you will see:

    Fresh Install of Archipelago yourOwnOrg\n 4 files changed, 360 insertions(+), 46 deletions(-)\n create mode 100644 deploy/ec2-docker/docker-compose.yml\n create mode 100644 drupal/composer.json\n

    And now finally you can push this back to your Fork:

    git push upstream yourOwnOrg-1.0.0-RC3\n

    And Git will respond with the following (use your yourOwnAccount personal Github Access Token as password):

    Username for 'https://github.com': yourOwnAccount\nPassword for 'https://yourOwnAccount@github.com': \nEnumerating objects: 18, done.\nCounting objects: 100% (18/18), done.\nCompressing objects: 100% (10/10), done.\nWriting objects: 100% (10/10), 2.26 KiB | 2.26 MiB/s, done.\nTotal 10 (delta 5), reused 0 (delta 0)\nremote: Resolving deltas: 100% (5/5), completed with 5 local objects.\nTo https://github.com/yourOwnAccount/archipelago-deployment-live\n   d9fa835..3427ce5  yourOwnOrg-1.0.0-RC3 -> yourOwnOrg-1.0.0-RC3\n

    And done.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#2-keeping-your-archipelago-modules-updated-during-releases","title":"2. Keeping your Archipelago Modules Updated during releases","text":"

    Releases in Archipelago are a bit different to other OSS projects. When a Release is done (let's say 1.0.0-RC2) we freeze the current release branches in every module we provide, package the release, and inmediatelly start with a new Release Cycle (6 months long normally) by creating in each repository a new Set of Branches (for this example 1.0.0-RC3). All new commits, fixes, improvements, features now will ALWAYS go into the Open/on-going new cycle branches (for this example 1.0.0-RC3), and once we are done we do it all over again. We freeze (for this example 1.0.0-RC3), and a new release cycle starts with fresh new \"WIP\" branches (for this example 1.1.0).

    Some Modules like AMI or Strawberry Runners have their independent Version but are released together anyway, e.g. for 1.0.0-RC3 both AMI and Strawberry Runners are 0.2.0. Why? Because work started later than the core Archipelago and also because they are not really CORE. So what happens with main branches? In our project main branches are never experimental. They are always a 1:1 with the latest stable release. So main will contain a full commit of 1.0.0-RC2 until we freeze 1.0.0-RC3 when main gets that code. Over and over. Nice, right?

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#which-modules-belong-to-archipelago-and-follow-a-release-cycle","title":"Which modules belong to Archipelago and follow a release cycle?","text":"

    The following modules are the ones we update on every release:

    • https://github.com/esmero/strawberryfield -> Composer name: strawberryfield/strawberryfield
    • https://github.com/esmero/format_strawberryfield -> Composer name: strawberryfield/format_strawberryfield
    • https://github.com/esmero/webform_strawberryfield -> Composer name: strawberryfield/webform_strawberryfield
    • https://github.com/esmero/ami -> Composer name: archipelago/ami
    • https://github.com/esmero/strawberry_runners -> Composer name: strawberryfield/strawberry_runners

    We also update macro modules that are meant for deployment like this Repository and https://github.com/esmero/archipelago-deployment.

    To keep your Archipelago up to date, especially once you \"go custom\" as described in this Documentation, the process is quite simple, e.g. to fetch latest 1.0.0-RC3 updates during the 1.0.0-RC3 release cycle run:

    docker exec -ti esmero-php bash -c \"composer require strawberryfield/strawberryfield:dev-1.0.0-RC3 strawberryfield/format_strawberryfield:dev-1.0.0-RC3 strawberryfield/webform_strawberryfield:dev-1.0.0-RC3 archipelago/ami:0.2.0.x-dev strawberryfield/strawberry_runners:0.2.0.x-dev strawberryfield/strawberry_runners:0.2.0.x-dev archipelago/archipelago_subtheme:dev-1.0.0-RC3 -W\"\n

    And then run any Database updates that may be needed:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n

    This will bring all the new code and all (except if there are BUGS!) should work as expected.

    Note: Archipelago really tries hard to be as backwards compatible as possible and rarely will you see a non-documented or non-dealt-with deprecation.

    Note 2: We of course recommend always running the Stable (frozen) release, but since code is plastic and fixes will go into a WIP open branch, you should be safe enough to move all modules together.

    You can run these commands any time you need, and while the release is open you will always get the latest code (even if it's always the same branch). Please follow/subscribe to each Module's Github to be aware of changes/issues and improvements.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#3-keeping-your-archipelagos-drupal-contributed-modules-and-core-updated","title":"3. Keeping your Archipelago's Drupal Contributed Modules and Core updated","text":"","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#31-contributed-modules","title":"3.1 Contributed Modules.","text":"

    To keep your Archipelago's Drupal up to date check your Drupal at https://yoursite.org/admin/modules/update. Make sure you check mostly (yes mostly, no need to overreact) for Security Updates. Not every Drupal contributed module (project) keeps backwards compatibility, and we try to test every version we ship (as in this repository's composer.lock files) before releasing. Once you detect a major change/requirement, visit the Project's Changelog Website, and take some time reading it. If you feel confident it's not going to break all, copy the suggested Composer command, e.g. if you visit https://www.drupal.org/project/google_api_client/releases/8.x-3.2 you will see that the update is suggested as:

    Install with Composer: $ composer require 'drupal/google_api_client:^3.2'\n

    Using the same module as an example, before doing any final updates, check your current running version (take note in case you need to revert):

    docker exec -ti esmero-php bash -c \"composer info 'drupal/google_api_client\"\n

    Keep the version around.

    Now let's update, which means using the suggested command translated to our own Docker world like this (notice the -W):

    docker exec -ti esmero-php bash -c \"composer require 'drupal/google_api_client:^3.2 -W\"\n

    And then run any Database updates that may be needed:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n

    This will update that module. Test your website. Depending on what you update, you want to focus first on the functionality it provides, and then create/edit/delete a fictitious Digital Object to ensure it did not add any errors to your most beloved Digital Objects workflows.

    If you see errors or you feel it's not acting as it should, you can revert by doing:

    docker exec -ti esmero-php bash -c \"composer require 'drupal/google_api_client:^VERSION_YOU_KEPT_AROUND -W\"\n

    And then run any Database updates that may be needed:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n

    If this happens we encourage you to please \ud83d\udc4f share your findings with our community/slack/Github ISSUE here.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#31-drupal-core-inside-the-same-major-version","title":"3.1 Drupal Core inside the same major version:","text":"

    This is quite similar to a contributed module but normally involves at least 3 dependencies and of course larger changes.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#exact-version","title":"Exact Version","text":"

    Inside the same major version, e.g. inside Drupal 9, if you are currently running Drupal 9.0.1 and you want to update to an exact latest (as I write 9.2.4):

    docker exec -ti esmero-php bash -c \"composer require drupal/core:9.2.4 drupal/core-dev:9.2.4 drupal/core-composer-scaffold:9.2.4 drupal/core-project-message:9.2.4 --update-with-dependencies\"\n

    Or under Drupal 8, if you are currently running Drupal 8.9.14 and you want to update to an exact latest (as I write 8.9.18):

    docker exec -ti esmero-php bash -c \"composer require drupal/core-dev:8.9.18 drupal/core:8.9.18 drupal/core-composer-scaffold:8.9.18 --update-with-dependencies\"\n

    And then for both cases run any Database updates that may be needed:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n
    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#alternative-major-version","title":"Alternative Major Version","text":"

    If you want to only remember a single command and want to be sure to also get all extra packages for Drupal 9, run:

    docker exec -ti esmero-php bash -c \"composer require drupal/core-dev:^9 drupal/core:^9 drupal/core-composer-scaffold:^9 drupal/core-project-message:^9 -W\"\n

    Or for Drupal 8:

    docker exec -ti esmero-php bash -c \"composer require drupal/core-dev:^8 drupal/core:^8 drupal/core-composer-scaffold:^8 drupal/core-project-message:^8 -W\"\n

    And then for both cases run any Database updates that may be needed:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n

    This will always get you the latest Drupal and dependencies allowed by your composer.json.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#32-drupal-core-between-major-versions","title":"3.2 Drupal Core between major versions:","text":"

    Since major versions may bring larger deprecations, contributed modules will stay behind, and the world (and your database may collapse), we really recommend that you do some tests first (locally) or follow one of our guides. We at Archipelago will always document a larger version update. Currently, the Drupal 8 to Drupal 9 Update is documented in detail here.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback, or open an ISSUE in this Archipelago Deployment Live Repository.

    Return to Archipelago Live Deployment.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-moveToLive/","title":"Moving from archipelago-deployment to archipelago-deployment-live","text":"","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#what-is-this-documentation-for","title":"What is this documentation for?","text":"

    If you have been using/running/populating an instance with Archipelago Digital Objects that was set up using our simpler-to-deploy but harder-to-customize archipelago-deployment strategy and can't wait to move to this one\u2014meant for a larger (and somehow easier to maintain and upgrade on the long run) instance\u2014but (wait!) you do not want to ingest again, set up again, configure users, etc. (You already did that!), this is your documentation.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#what-is-this-documentation-not-for","title":"What is this documentation not for?","text":"

    To install an archipelago-deployment-live from scratch or to keep (forever) syncing between the two deployment options in a quantum phase shifting eternum like a time crystal.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#requirements","title":"Requirements","text":"
    • An instance of Archipelago (working, tested) installed using archipelago-deployment as a basis.
    • Basic knowledge and instincts on how to run Terminal Commands, copy files, run composer, drush, Linux Permissions, and git of course.
    • Patience. You can't skip steps here. Also, Patience again since you may have stretched (good) your current instance to do way more than we thought it could.
    • Time to read the main Documentation of this Repo to have a basic knowledge of how this is deployed. Recommended even if you are not going to deploy one from scratch here.
    • For Shell Commands documented here please copy line by line\u2014not the whole block.
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#differences-between-both-deployments-strategies","title":"Differences between both deployments strategies.","text":"

    In a nutshell: archipelago-deployment-live uses a different folder structure moving configuration storage, data storage outside of your webroot, and allows a much finer control of your settings (safer) and Docker containers. In a nutshell inside the first nutshell: archipelago-deployment-live also ignores more files so keeping customized versions, your own packages, your own settings around, and version controlled is much easier. Lastly: archipelago-deployment-live makes more use of Cloud Services, e.g. so if you have been running min.io as local mounted storage you may now consider moving storage (files) to a cloud service like AWS S3.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#commonalities-between-both-deployment-strategies","title":"Commonalities between both deployment strategies.","text":"

    In a nutshell: Since both run the same code and use the same Docker Containers, the data is actually the same. Everything is just persisted in different places.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#getting-the-new-repo-in-place","title":"Getting the new repo in place","text":"

    First you need to clone this repository and (hopefully) store in the same parent folder to your current archipelago-deployment one. For the purpose of this tutorial we will assume you have archipelago-deployment cloned in this location: $HOME/archipelago-deployment.

    Locate your archipelago-deployment folder in your terminal. Do an ls to make sure you can see the folder (not the content) and run:

    git clone https://github.com/esmero/archipelago-deployment-live\ncd archipelago-deployment-live\ngit checkout 1.0.0-RC3\ncd ..\ncd archipelago-deployment\n

    Now you have side by side $HOME/archipelago_deployment and $HOME/archipelago-deployment-live.

    This will give you the base structure.

    Before touching anything let's start by generating a backup of your current deployment (safety first).

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#backing-up","title":"Backing up","text":"","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-1","title":"Step 1:","text":"

    Shut down your docker-compose ensemble. Inside your original archipelago-deployment folder run this:

    docker-compose down\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-2","title":"Step 2:","text":"

    Verify all containers are actually down:

    docker ps\n

    The following command should return an empty listing. If anything is still running, wait a little longer and run the previous command again.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-3","title":"Step 3:","text":"

    Now let's tar.gz the whole ensemble with data and configs. As an example we will save this into your $HOME folder. As a good practice we append the current date (YEAR-MONTH-DAY) to the filename. Here we assume today is December 1st of 2021:

    sudo tar -czvpf $HOME/archipelago-deployment-backup-20211201.tar.gz ../archipelago-deployment\n

    The process may take a few minutes. Now let's verify that all is there and that the tar.gz is not corrupt:

    tar -tvvf $HOME/archipelago-deployment-backup-20211201.tar.gz \n

    You will see a listing of files. If corrupt (do you have enough space? did your ssh connection drop?) you will see:

    tar: Unrecognized archive format\n

    Done! If you are running a public instance we can allow ourselves to start Docker again to avoid downtime:

    docker-compose up -d\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#the-directory-structures","title":"The directory structures","text":"

    Now that you backed all up we can spend some minutes looking at both directory structures.

    If you observe both deployment strategies side by side you will inmediately notice the most important similarities and also differences:

    archipelago-deployment Live archipelago-deployment 
    .\n\u251c\u2500\u2500 config_storage\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifconfig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 nginxconfig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 nginxconfig_selfcert\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 php-fpm\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 solrconfig\n\u251c\u2500\u2500 data_storage\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 db\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifcache\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiiftmp\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 letsencrypt\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 minio-data\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ngnixcache\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 selfcert\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 solrcore\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 solrlib\n\u251c\u2500\u2500 deploy\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 azure-kubernetes\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ec2-docker\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 kubernetes\n\u251c\u2500\u2500 docs\n\u2514\u2500\u2500 drupal\n\u2502   \u251c\u2500\u2500 config\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 d8content\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 docs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 drush\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 patches\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 persistent\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 private\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 scripts\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 vendor\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 web\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 xdebug\n
    .\n\u251c\u2500\u2500 config\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 sync\n\u251c\u2500\u2500 d8content\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 metadatadisplays\n\u251c\u2500\u2500 docs\n\u251c\u2500\u2500 drush\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Commands\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 sites\n\u251c\u2500\u2500 nginxconfigford8\n\u251c\u2500\u2500 patches\n\u251c\u2500\u2500 persistent\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 db\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifcache\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifconfig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 miniodata\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 solrconfig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 solrcore\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 solrlib\n\u251c\u2500\u2500 private\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 webform\n\u251c\u2500\u2500 scripts\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 archipelago\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 composer\n\u251c\u2500\u2500 vendor\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 archipelago\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 asm89\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 aws\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 behat\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 bin\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 brick\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 chi-teck\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 composer\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 consolidation\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 container-interop\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 cweagans\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 data-values\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 dflydev\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 doctrine\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 drupal\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 drush\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 easyrdf\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 egulias\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 enlightn\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 erusev\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 evenement\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ezyang\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 fabpot\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 fileeye\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 firebase\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 frictionlessdata\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 google\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 graham-campbell\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 grasmash\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 guzzlehttp\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 instaclick\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 jcalderonzumba\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 jean85\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 jmikola\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 justinrainbow\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 laminas\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 league\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 lsolesen\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 maennchen\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 markbaker\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 masterminds\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 mglaman\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 mhor\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 mikey179\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 mixnode\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ml\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 monolog\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 mtdowling\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 myclabs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 nesbot\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 nette\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 nikic\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 paragonie\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 pear\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phar-io\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phenx\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpdocumentor\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phplang\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpmailer\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpoffice\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpoption\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpseclib\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpspec\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpstan\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpunit\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 professional-wiki\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 psr\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 psy\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ralouphie\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ramsey\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 react\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 sebastian\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 seld\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 sirbrillig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 solarium\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 squizlabs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 stack\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 strawberryfield\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 swaggest\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 symfony\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 symfony-cmf\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 theseer\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 twbs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 twig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 typo3\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 vlucas\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 web64\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 webflo\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 webmozart\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 wikibase\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 wikimedia\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 zaporylie\n\u251c\u2500\u2500 web\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 core\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 libraries\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 modules\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 profiles\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 sites\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 themes
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#the-data","title":"The Data","text":"

    Let's start by focusing on the data, in our case the Database, Solr, and File (S3 + Private) storage. Collapsing here a few folders will make this easier to read. Marked with a * are matching folders that contain DB, Solr Core, the S3 min.io data (if you are using local storage) and also Drupal's very own private folder:

    archipelago-deployment Live archipelago-deployment 
    .\n\u251c\u2500\u2500 config_storage\n\u251c\u2500\u2500 data_storage\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * db *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifcache\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiiftmp\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 letsencrypt\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * minio-data *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ngnixcache\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 selfcert\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 solrcore\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 solrlib\n\u251c\u2500\u2500 deploy\n\u251c\u2500\u2500 docs\n\u2514\u2500\u2500 drupal\n\u2502   \u251c\u2500\u2500 config\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 d8content\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 docs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 drush\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 patches\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 persistent\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * private *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 scripts\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 vendor\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 web\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 xdebug\n
    .\n\u251c\u2500\u2500 config\n\u251c\u2500\u2500 d8content\n\u251c\u2500\u2500 docs\n\u251c\u2500\u2500 drush\n\u251c\u2500\u2500 nginxconfigford8\n\u251c\u2500\u2500 patches\n\u251c\u2500\u2500 persistent\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * db *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifcache\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifconfig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * miniodata *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 solrconfig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * solrcore *\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 solrlib\n\u251c\u2500\u2500 * private *\n\u251c\u2500\u2500 scripts\n\u251c\u2500\u2500 vendor\n\u251c\u2500\u2500 web\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#copying-the-data-into-the-new-structure","title":"Copying the Data into the new Structure","text":"

    To do so we need to stop Docker again. This is needed because Databases sometimes keep an open Change Log and Locks in place, and if there is any interaction or cron running, your data may end up corrupted.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-1_1","title":"Step 1:","text":"

    Shut down your docker-compose ensemble. Inside your original archipelago-deployment folder run this:

    docker-compose down\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-2_1","title":"Step 2:","text":"

    Verify all containers are actually down:

    docker ps\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-3_1","title":"Step 3:","text":"

    We will copy DB, min.io (File and ADO storage as files) and Drupal's private (temporary files, caches) folders to its new place:

    sudo cp -rpv persistent/db ../archipelago-deployment-live/data_storage/db\nsudo cp -rpv persistent/solrcore ../archipelago-deployment-live/data_storage/solrcore\nsudo cp -rpv persistent/miniodata ../archipelago-deployment-live/data_storage/minio-data\nsudo cp -rpv private ../archipelago-deployment-live/drupal/private\n

    Running -rpv will copy verbosely and recursively while preserving original permissions.

    Done!

    You can now start docker-compose again:

    docker-compose up -d\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#the-web","title":"The Web","text":"

    Collapsing again a few folders to aid in readability, we can now focus on your actual Drupal/Archipelago Code/Web and settings. To be honest (we are), you can easily reinstall and restore all this via composer, but we can also move folders as a learning experience/time and bandwidth experience. Marked with a * are matching folders you want to copy over:

    archipelago-deployment Live archipelago-deployment 
    .\n\u251c\u2500\u2500 config_storage\n\u251c\u2500\u2500 data_storage\n\u251c\u2500\u2500 deploy\n\u251c\u2500\u2500 docs\n\u2514\u2500\u2500 drupal\n\u2502   \u251c\u2500\u2500 * config *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 d8content\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 docs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 drush\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 patches\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 persistent\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 private\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 scripts\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * vendor *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * web *\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 xdebug\n
    .\n\u251c\u2500\u2500 * config *\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 sync\n\u251c\u2500\u2500 d8content\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 metadatadisplays\n\u251c\u2500\u2500 docs\n\u251c\u2500\u2500 drush\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Commands\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 sites\n\u251c\u2500\u2500 nginxconfigford8\n\u251c\u2500\u2500 patches\n\u251c\u2500\u2500 persistent\n\u251c\u2500\u2500 private\n\u251c\u2500\u2500 scripts\n\u251c\u2500\u2500 * vendor *\n\u251c\u2500\u2500 * web *\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#copying-the-web-into-the-new-structure","title":"Copying the Web into the new Structure","text":"

    No need to stop Docker again. We can do this while your Archipelago is still running.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-1_2","title":"Step 1:","text":"

    We will copy all important folders over. From your archipelago-deployment folder run:

    sudo cp -rpv vendor ../archipelago-deployment-live/drupal/vendor\nsudo cp -rpv web ../archipelago-deployment-live/drupal/web\nsudo cp -rpv config ../archipelago-deployment-live/drupal/config\n

    And also, selectively, a few files we know you are very fond of!

    sudo cp -rpv composer.json ../archipelago-deployment-live/drupal/composer.json\nsudo cp -rpv composer.lock ../archipelago-deployment-live/drupal/composer.lock\n

    Done!

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#ssl-enviromentals-configurations-settings-and-docker","title":"SSL, Enviromentals, Configurations, Settings and Docker","text":"

    We are almost done, but archipelago-deployment-live has a different, safer way of defining SSL Certs, credentials, and global settings for your Archipelago. We will start first by copying settings as they are (most likely not very safe), and then we can update passwords/etc. to make your system better-prepared for the world.

    To learn more about these general settings please read this section of the parent Documentation (who likes duplicated documentation? Nobody.). The gist here is (after reading, please do not skip) that we need to add our service definitions into a .env file.

    Coming from archipelago-deployment means and assumes that you are running AWS Linux 2 using the suggested locations in this document, that you have a vanilla deployment, and that you followed these instructions) so your values for $HOME/archipelago-deployment-live/deploy/ec2-docker/.env will be the following:

    ARCHIPELAGO_ROOT=/home/ec2-user/archipelago-deployment-live\nARCHIPELAGO_EMAIL=your@validemail.org\nARCHIPELAGO_DOMAIN=your.domain.org\nMINIO_ACCESS_KEY=minio\nMINIO_SECRET_KEY=minio123\nMYSQL_ROOT_PASSWORD=esmero-db\nMINIO_BUCKET_MEDIA=archipelago\nMINIO_FOLDER_PREFIX_MEDIA=/\nMINIO_BUCKET_CACHE=archipelago\nMINIO_FOLDER_PREFIX_CACHE=/\n

    If you plan on staying on local storage driven min.io, MINIO_BUCKET_CACHE and MINIO_FOLDER_PREFIX_CACHE are not going to be used. If you are planning on moving your Storage from local to cloud driven please replace with the right values, e.g. AWS IAM keys and Secrets + bucket names and prefixes (folders). Again, refer to the parent Documentation for setting this up.

    Once you have that in place (Double-check. If something goes wrong here we can always fine-tune and fix again.), we need to decide on a new docker-compose file, and you may need to customize it depending on your choices and current and future needs.

    If you already have an SSL certificate, and it's provided by CertBot you can either copy the certs from your current system (will totally depend on your setup since archipelago-deployment does not provide out-of-the-box SSL Certs) to $HOME/archipelago-deployment-live/data_storage/letsencrypt.

    A normal folder structure for that is:

    .\n\u251c\u2500\u2500 accounts\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 acme-v02.api.letsencrypt.org\n\u2502\u00a0\u00a0     \u2514\u2500\u2500 directory\n\u2502\u00a0\u00a0         \u2514\u2500\u2500 cac9f8218ef18e4f11ec053785bbf648\n\u2502\u00a0\u00a0             \u251c\u2500\u2500 meta.json\n\u2502\u00a0\u00a0             \u251c\u2500\u2500 private_key.json\n\u2502\u00a0\u00a0             \u2514\u2500\u2500 regr.json\n\u251c\u2500\u2500 archive\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 your.domain.org\n\u2502\u00a0\u00a0  \u00a0\u00a0 \u251c\u2500\u2500 cert1.pem\n\u2502\u00a0\u00a0  \u00a0\u00a0 \u251c\u2500\u2500 chain1.pem\n\u2502\u00a0\u00a0  \u00a0\u00a0 \u251c\u2500\u2500 fullchain1.pem\n\u2502\u00a0\u00a0  \u00a0\u00a0 \u2514\u2500\u2500 privkey1.pem\n\u2502\u00a0\n\u251c\u2500\u2500 csr\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 0000_csr-certbot.pem\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 0001_csr-certbot.pem\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 0002_csr-certbot.pem\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 0003_csr-certbot.pem\n\u251c\u2500\u2500 keys\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 0000_key-certbot.pem\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 0001_key-certbot.pem\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 0002_key-certbot.pem\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 0003_key-certbot.pem\n\u251c\u2500\u2500 live\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 README\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 your.domain.org\n\u2502\u00a0\u00a0 \u00a0\u00a0 \u251c\u2500\u2500 cert.pem -> ../../archive/your.domain.org/cert1.pem\n\u2502\u00a0\u00a0 \u00a0\u00a0 \u251c\u2500\u2500 chain.pem -> ../../archive/your.domain.org/chain1.pem\n\u2502\u00a0\u00a0 \u00a0\u00a0 \u251c\u2500\u2500 fullchain.pem -> ../../archive/your.domain.org/fullchain1.pem\n\u2502\u00a0\u00a0 \u00a0\u00a0 \u251c\u2500\u2500 privkey.pem -> ../../archive/your.domain.org/privkey1.pem\n\u2502\u00a0\u00a0 \u00a0\u00a0 \u2514\u2500\u2500 README\n\u251c\u2500\u2500 renewal\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 your.domain.org.conf\n\u2502\u00a0\u00a0 \n\u2514\u2500\u2500 renewal-hooks\n    \u251c\u2500\u2500 deploy\n    \u251c\u2500\u2500 post\n    \u2514\u2500\u2500 pre\n

    Or if your SSL cert is up for renewal, you can just let Archipelago request it for you. Renewal will happen auto-magically, and you may never ever need to worry about that in the future.

    Finally, let's adapt the docker-compose file we need to our previous (but still current!) archipelago-deployment reality.

    For x86/AMD, run (for ARM64/Apple M1 please check the parent Documentation):

    cp $home/archipelago-deployment-live/deploy/ec2-docker/docker-compose-aws-s3.yml $home/archipelago-deployment-live/deploy/ec2-docker/docker-compose.yml\nnano $home/archipelago-deployment-live/deploy/ec2-docker/docker-compose.yml\n

    And replace the content with this slightly modified version. Note: we really only changed the lines after this comment: # THIS DIFFERS FROM THE NORMAL ONE....

    # Run docker-compose up -d\n\nversion: '3.5'\nservices:\n  web:\n    container_name: esmero-web\n    image: staticfloat/nginx-certbot\n    restart: always\n    environment:\n      CERTBOT_EMAIL: ${ARCHIPELAGO_EMAIL}\n      ENVSUBST_VARS: FQDN\n      FQDN: ${ARCHIPELAGO_DOMAIN}\n    ports:\n      - \"80:80\"\n      - \"443:443\"\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/config_storage/nginxconfig/conf.d:/etc/nginx/user.conf.d\n      - ${ARCHIPELAGO_ROOT}/config_storage/nginxconfig/certbot_extra_domains:/etc/nginx/certbot/extra_domains:ro\n      - ${ARCHIPELAGO_ROOT}/drupal:/var/www/html:cached\n      - ${ARCHIPELAGO_ROOT}/data_storage/ngnixcache:/var/cache/nginx\n      - ${ARCHIPELAGO_ROOT}/data_storage/letsencrypt:/etc/letsencrypt\n    depends_on:\n      - solr\n      - php\n      - db\n    tty: true\n    networks:\n      - host-net\n      - esmero-net\n  php:\n    container_name: esmero-php\n    restart: always\n    image: \"esmero/php-7.4-fpm:1.0.0-RC2-multiarch\"\n    tty: true\n    networks:\n      - host-net\n      - esmero-net\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/config_storage/php-fpm/www.conf:/usr/local/etc/php-fpm.d/www.conf\n      - ${ARCHIPELAGO_ROOT}/drupal:/var/www/html:cached\n    environment:\n      MINIO_ACCESS_KEY: ${MINIO_ACCESS_KEY}\n      MINIO_SECRET_KEY: ${MINIO_SECRET_KEY}\n      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}\n      MINIO_BUCKET_MEDIA: ${MINIO_BUCKET_MEDIA}\n      MINIO_FOLDER_PREFIX_MEDIA: ${MINIO_FOLDER_PREFIX_MEDIA}\n  solr:\n    container_name: esmero-solr\n    restart: always\n    image: \"solr:8.8.2\"\n    tty: true\n    ports:\n      - \"8983:8983\"\n    networks:\n      - host-net\n      - esmero-net\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/data_storage/solrcore:/var/solr/data\n      - ${ARCHIPELAGO_ROOT}/config_storage/solrconfig:/drupalconfig\n      - ${ARCHIPELAGO_ROOT}/data_storage/solrlib:/opt/solr/contrib/archipelago/lib\n    entrypoint:\n      - docker-entrypoint.sh\n      - solr-precreate\n      - drupal\n      - /drupalconfig\n  db:\n    image: mysql:8.0.22\n    command: mysqld --default-authentication-plugin=mysql_native_password  --max_allowed_packet=256M\n    container_name: esmero-db\n    restart: always\n    environment:\n      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}\n    networks:\n      - host-net\n      - esmero-net\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/data_storage/db:/var/lib/mysql\n  nlp:\n    container_name: esmero-nlp\n    restart: always\n    image: \"esmero/esmero-nlp:1.0\"\n    ports:\n      - \"6400:6400\"\n    networks:\n      - host-net\n      - esmero-net\n  iiif:\n    container_name: esmero-cantaloupe\n    image: \"esmero/cantaloupe-s3:4.1.9RC\"\n    restart: always\n    ports:\n      - \"8183:8182\"\n    networks:\n      - host-net\n      - esmero-net\n    environment:\n      AWS_ACCESS_KEY_ID: ${MINIO_ACCESS_KEY}\n      AWS_SECRET_ACCESS_KEY: ${MINIO_SECRET_KEY}\n      # THIS DIFFERS FROM THE STANDARD ONE AND ENABLES LOCAL FILESYSTEM CACHE INSTEAD OF AWS S3 one\n      CACHE_SERVER_DERIVATIVE: FilesystemCache\n      S3SOURCE_BASICLOOKUPSTRATEGY_BUCKET_NAME: ${MINIO_BUCKET_MEDIA}\n      S3SOURCE_BASICLOOKUPSTRATEGY_PATH_PREFIX: ${MINIO_FOLDER_PREFIX_MEDIA}\n      S3CACHE_BUCKET_NAME: ${MINIO_BUCKET_CACHE} \n      S3CACHE_OBJECT_KEY_PREFIX: ${MINIO_FOLDER_PREFIX_CACHE} \n      XMS: 2g\n      XMX: 4g\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/config_storage/iiifconfig:/etc/cantaloupe\n      - ${ARCHIPELAGO_ROOT}/data_storage/iiifcache:/var/cache/cantaloupe\n      - ${ARCHIPELAGO_ROOT}/data_storage/iiiftmp:/var/cache/cantaloupe_tmp\n  minio:\n    container_name: esmero-minio\n    restart: always\n    image: minio/minio:latest\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/data_storage/minio-data:/data:cached\n    ports:\n      - \"9000:9000\"\n      - \"9001:9001\"\n    networks:\n      - host-net\n      - esmero-net\n    environment:\n      MINIO_HTTP_TRACE: /tmp/minio-log.txt\n      MINIO_ROOT_USER: ${MINIO_ACCESS_KEY}\n      MINIO_ROOT_PASSWORD: ${MINIO_SECRET_KEY}\n      MINIO_ACCESS_KEY: ${MINIO_ACCESS_KEY}\n      MINIO_SECRET_KEY: ${MINIO_SECRET_KEY}\n      # THIS DIFFERS FROM THE STANDARD ONE AND ENABLES LOCAL MINIO INSTEAD OF AWS S3 one \n    command: server /data --console-address \":9001\"\nnetworks:\n  host-net:\n    driver: bridge\n  esmero-net:\n    driver: bridge\n    internal: true\n

    Press CNTRL-X, and you are done. Now the final test!!

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#shutdown-the-old-one-start-the-new-one","title":"Shutdown the old one, start the new one","text":"

    So we are ready. Testing may be a hit-or-miss thing here. Did we cover all the steps? Did a command fail? The good thing is that we can start the new ensemble, and all our old ones will survive. And we can come back over and over until we are ready. Let's try!

    We will start by shutting down the running Docker ensemble:

    cd $HOME/archipelago-deployment\ndocker-compose down\n

    Now let's go to our new deployment. Docker starts here in a different folder:

    cd $HOME/archipelago-deployment-live/deploy/ec2-docker\ndocker-compose up\n

    You may notice that we removed the -d. Why? We want to see all the messages and notice/mark/copy any errors, e.g. did the SSL CERT load correctly? Did the MYSQL import work out? To avoid shutting it down while all starts, please open another Terminal and type:

    docker ps\n

    And look at the up-times. Do you see any Containers restarting (where Created and the Status differ for a lot and Status keeps resetting to 0?)? A healthy deployment will look similar to this:

    CONTAINER ID   IMAGE                                    COMMAND                  CREATED          STATUS         PORTS                                      NAMES\nf794c25db64c   esmero/cantaloupe-s3:4.1.9RC2-arm64      \"sh -c 'java -Dcanta\u2026\"   6 seconds ago    Up 3 seconds   0.0.0.0:8183->8182/tcp                     esmero-cantaloupe\n5b791445720f   jonasal/nginx-certbot                    \"/docker-entrypoint.\u2026\"   6 seconds ago    Up 3 seconds   0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp   esmero-web\ne38fbbd86edf   esmero/esmero-nlp:1.0.1-RC2-arm64        \"/usr/local/bin/entr\u2026\"   11 seconds ago   Up 6 seconds   0.0.0.0:6400->6400/tcp                     esmero-nlp\nc84a0a4d43e9   minio/minio:latest                       \"/usr/bin/docker-ent\u2026\"   11 seconds ago   Up 6 seconds   0.0.0.0:9000-9001->9000-9001/tcp           esmero-minio\n3ec176a960c3   esmero/php-7.4-fpm:1.0.0-RC2-multiarch   \"docker-php-entrypoi\u2026\"   11 seconds ago   Up 6 seconds   9000/tcp                                   esmero-php\ne762ad7ea5e2   solr:8.8.2                               \"docker-entrypoint.s\u2026\"   11 seconds ago   Up 6 seconds   0.0.0.0:8983->8983/tcp                     esmero-solr\n381166d61f8c   mariadb:10.5.10-focal                    \"docker-entrypoint.s\u2026\"   11 seconds ago   Up 6 seconds   3306/tcp      \n

    If you feel that all seems to be fine, open a browser window and visit your website. See if you can log in and see ADOs. If not you can momentarily shut down this new Docker ensemble and restart the older one. Nothing is lost! Then with time and tea/coffee and fresh eyes come back and re-trace your steps. 95% of the issues are incorrect values in the .env file. The other 5% may be on us. If you run into any trouble please get in touch!

    Happy deploying!

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback, or open an ISSUE in this Archipelago Deployment Live Repository.

    Return to Archipelago Live Deployment.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/","title":"Archipelago Deployment Live","text":"

    A Cloud / Local production ready Archipelago Deployment using Docker and soon Kubernetes.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#what-is-this-repo-for","title":"What is this repo for?","text":"

    Running Archipelago Commons on a live public instance using SSL with Blob/Object Storage backend

    • Cloud-based deployment, e.g. AWS/Azure under Linux
    • Self-managed servers running Linux
    • x86/AMD86 or ARM64/v8 CPU architectures
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#what-is-this-repo-not-for","title":"What is this repo not for?","text":"
    • Running your own local/development Archipelago. For that we suggest using https://github.com/esmero/archipelago-deployment
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#requirements","title":"Requirements","text":"","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#minimal-not-recommended-for-production","title":"Minimal (not recommended for production)","text":"
    • 4 Gbytes of RAM (e.g AWS EC2 t3.medium) 2 CPUs, Single SSD Drive of 100 Gbytes
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#base-line-for-production","title":"Base line for production","text":"
    • 8 Gbytes of RAM (AWS EC2 t3.medium) 2 CPUs, Single SSD Drive of 100 Gbytes, optional: one magnetic Drive of 500 Gbytes for Caches/Temp files/Backups.
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#recommended-for-production","title":"Recommended for production","text":"
    • 16 Gbytes of RAM (AWS EC2 m6g.xlarge - Graviton) 4 CPUs, Single SSD Drive of 200 Gbytes, optional: one magnetic Drive of 1TB for Caches/Temp files/Backups.
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#os","title":"OS:","text":"
    • Ubuntu 22.04 /Amazon Linux 2 or Amazon Linux 2023/Debian 10 \"Buster\"/ AlmaLinux (Centos replacement) matching your CPU architecture (of course)
    • Most recent Docker running as a service and docker-compose or docker compose
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#skills-and-the-important-human-aspect","title":"Skills and the important human aspect","text":"
    • Basic Unix/Linux terminal skills and a root/sudo account
    • Docker basics knowledge and how to manage packages in your System
    • Knowledge of how to manage AWS/Azure or any other cloud-based provider for Computing Instances and S3 compatible Object Storage system and the associated permissions credentials to do so.
    • To be patient. Please read everything. Do not skip steps. Do not only copy and paste commands. Explanations give context and might help you troubleshoot issues.

    Basically this guide is meant for humans with basic to medium DevOps background or humans with patience that are willing to troubleshoot, ask, and try again when that background is not (yet) enough. And we are here to help.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#deployment-on-linuxx86amd-system","title":"Deployment on Linux/X86/AMD system","text":"","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-1","title":"Step 1:","text":"

    Deploy your base system

    Make sure your Firewall/AWS Security group has these ports open for everyone to access

    • 443 (NGINX SSL)
    • 80 (NGINX HTTP) And protected/modally open for your own development/testing/administration
    • 8183 (Cantaloupe)
    • 8983 (Solr)
    • 6400 (NLP64)
    • 9001 (Minio)
    • 22 (so you can ssh into your machine)

    Setup your system using your favorite package manager with

    • Docker
    • git
    • htop
    • tree
    • docker-compose or docker compose (V2) if running the most recent docker service. See https://docs.docker.com/compose/migrate/

    e.g. for Amazon Linux 2 (x86/amd64) these steps are tested:

    sudo yum update -y\nsudo amazon-linux-extras install -y docker\nsudo service docker start\nsudo usermod -a -G docker ec2-user\nsudo chkconfig docker on\nsudo systemctl enable docker\nsudo yum install -y git htop tree\nsudo curl -L \"https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)\" -o /usr/local/bin/docker-compose\nsudo chmod +x /usr/local/bin/docker-compose\nsudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose\nsudo reboot\n

    Reboot is needed to allow Docker to take full control over your OS resources.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-2","title":"Step 2:","text":"

    In your location of choice clone this repo

    git clone https://github.com/esmero/archipelago-deployment-live\ncd archipelago-deployment-live\ngit checkout 1.3.0\n
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-3-setup-your-enviromental-variables-for-dockerservices","title":"Step 3. Setup your enviromental variables for Docker/Services","text":"","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#setup-enviromentals","title":"Setup Enviromentals","text":"

    Setup your deployment enviromental variables by copying the template

    cp deploy/ec2-docker/.env.template deploy/ec2-docker/.env\n
    and editing it

    nano deploy/ec2-docker/.env\n

    The content of that file would be similar to this. Note: There are a few extra commented lines at the end only used for: https://docs.archipelago.nyc/1.3.0/security_bots/ if you decide to go that way.

    ARCHIPELAGO_ROOT=/home/ec2-user/archipelago-deployment-live\nARCHIPELAGO_EMAIL=your@validemail.org\nARCHIPELAGO_DOMAIN=your.domain.org\nMINIO_ACCESS_KEY=THE_S3_AZURE_OR_LOCAL_MINIO_KEY\nMINIO_SECRET_KEY=THE_S3_AZURE_OR_LOCAL_MINIO_SECRET\nMYSQL_ROOT_PASSWORD=YOUR_MYSQL_PASSWORD_FOR_ARCHIPELAGO\nMINIO_BUCKET_MEDIA=THE_NAME_OF_YOUR_S3_BUCKET_FOR_PERSISTEN_STORAGE\nMINIO_FOLDER_PREFIX_MEDIA=media/\nMINIO_BUCKET_CACHE=THE_NAME_OF_YOUR_S3_BUCKET_FOR_IIIF_STORAGE\nMINIO_FOLDER_PREFIX_CACHE=iiifcache/\nREDIS_PASSWORD=YOUR_REDIS_PASSWORD\n

    What does each key mean?

    • ARCHIPELAGO_ROOT: the absolute path to your archipelago-deployment-live git repo in your host machine.
    • ARCHIPELAGO_EMAIL: a valid email, will be used to register your SSL Certificate via Certbot.
    • ARCHIPELAGO_DOMAIN: a valid domain name for your repository. This domain will be also used to request your SSL Certificate via Certbot.
    • MINIO_ACCESS_KEY: If you are running a Cloud Service backed S3/Azure Storage this needs to be generated there. The user/IAM owner of this ACCESS KEY needs to have access to read/write the bucket you will configure in this same .env. If running local min.io whatever you set will be used.
    • MINIO_SECRET_KEY: If you are running a Cloud Service backed S3/Azure Storage this needs to generated there. The user/IAM owner of the matching SECRET_KEY needs to have access to read/write the bucket you will configure in this same .env file. If running local min.io whatever you set will be used.
    • MYSQL_ROOT_PASSWORD: The MYSQL 8 or Mariadb 15 password. This password will be used later also during Drupal deployment via drush
    • MINIO_BUCKET_MEDIA: The name of your Persistant Storage Bucket. If using mini.io local we recommend keeping it simple, e.g. archipelago.
    • MINIO_FOLDER_PREFIX_MEDIA: The folder (a prefix really) where your DO Storage and File storage will go inside the MINIO_BUCKET_MEDIA Bucket. media/ is a fine name for this one and common in archipelago deployments. IMPORTANT: Always terminate these with a /.
    • MINIO_BUCKET_CACHE: The name of your IIIF Cache storage Bucket. May be the same as MINIO_BUCKET_MEDIA. If different make sure your your MINIO_ACCESS_KEY and/or IAM role ACL have permission to read write to this one too.
    • MINIO_FOLDER_PREFIX_CACHE: The folder (a prefix really) where Cantaloupe will/can write its iiif caches. iiifcache/ is a lovely name we use a lot. IMPORTANT: Always terminate these with a /.
    • REDIS_PASSWORD: Password for your REDIS (Drupal Cache/Queue storage) if you decide to enable the Drupal REDIS module.

    IMPORTANT NOTE: For AWS EC2. If you selected an IAM role for your server when setting it up/deploying it, min.io will use the AWS EC2-backed internal API to request access to your S3. This means the ROLE itself needs to have read/write access (ACL) to the given Bucket(s) and your key/secrets won't be able to override that. Please do not ignore this note. It will save you a LOT of frustration and coffee. You can also run an EC2 instace without a given IAM and in that case just the ACCESS_KEY/SECRET will matter.

    Now that you know, you also know that these values should not be shared and this .env file should not be committed/kept in version control. Please be careful.

    docker-compose will read this .env and start all services for you based on its content.

    Once you have modified this you are ready for your first big decision.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#running-a-fully-qualified-domain-you-wish-a-validsigned-certificate-for-amdintel-architecture","title":"Running a fully qualified domain you wish a valid/signed certificate for AMD/INTEL Architecture?","text":"

    This means you will use the docker-compose-aws-s3.yml. Do the following:

    cp deploy/ec2-docker/docker-compose-aws-s3.yml deploy/ec2-docker/docker-compose.yml\n
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#running-a-fully-qualified-domain-you-wish-a-validsigned-certificate-for-arm64apple-m1-architecture","title":"Running a fully qualified domain you wish a valid/signed certificate for ARM64/Apple M1 Architecture?","text":"

    This means you will use the docker-compose-aws-s3-arm64.yml. Do the following:

    cp deploy/ec2-docker/docker-compose-aws-s3-arm64.yml deploy/ec2-docker/docker-compose.yml\n
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#optional-expert-extra-domains-does-not-apply-to-arm64apple-m1-architecture","title":"Optional (expert) extra domains (does not apply to ARM64/Apple M1 Architecture):","text":"

    If you have more than a single domain you may create a text file inside config_storage/nginxconfig/certbot_extra_domains/your.domain.org and write for each subdomain there an entry/line.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#or-running-self-signed-optional-and-does-not-apply-to-arm64apple-m1-architecture","title":"OR Running self-signed? (optional and does not apply to ARM64/Apple M1 Architecture):","text":"

    Only if you are not running a fully qualified domain you wish a valid/signed. We really DO not recommend this route. IF you plan on using this deployment for local testing or running on non SSL please go for https://github.com/esmero/archipelago-deployment which delivers the same experience in less than 20 minutes deployment time.

    Generate a self signed Cert

    sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout data_storage/selfcert/private/nginx.key -out data_storage/selfcert/certs/nginx.crt \nsudo openssl dhparam -out data_storage/selfcert/dhparam.pem 4096\ncp deploy/ec2-docker/docker-compose-selfsigned.yml deploy/ec2-docker/docker-compose.yml\n

    Note: Self signed docker-compose.yml file is setup to use min.io with local storage

        volumes:\n      - ${ARCHIPELAGO_ROOT}/data_storage/minio-data:/data:cached\n

    This folder will be created by min.io. If you are using a secondary Drive (e.g. magnetic) you can modify your deploy/ec2-docker/docker-compose.yml to use a folder there, e.g.

        volumes:\n      - /persistentinotherdrive/data_storage/minio-data:/data:cached\n

    Make sure your logged in user can read/write to it.

    NOTE: If you want to use AWS S3 storage for the self signed version replace the minio Service yaml block with this Service Block in your new deploy/ec2-docker/docker-compose.yml. You can mix and match services and even remove all :cached statements for improved R/W volumen performance.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-4-first-run","title":"Step 4. First Run","text":"","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#first-permissions","title":"First Permissions","text":"
    sudo chown 8183:8183 config_storage/iiifconfig/cantaloupe.properties\nsudo chown -R 8183:8183 data_storage/iiifcache\nsudo chown -R 8183:8183 data_storage/iiiftmp\nsudo chown -R 8983:8983 data_storage/solrcore\n
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#actual-first-run","title":"Actual first run","text":"

    Time to spin our docker containers for the first time. We will start all without going into background so log/error checking is easier, especially if you have selected a Valid/Signed Cert choice and also want to be sure S3 keys/access are working.

    cd deploy/ec2-docker\ndocker-compose up\n

    You will see a lot of things happening. Check for errors/problems/clear alerts and give all a minute or so to start. Ok, let's assume your setup managed to request a valid signed SSL cert, you will see a nice message!

    - Congratulations! Your certificate and chain have been saved at:XXXXX\n   Your certificate will expire on 20XX-XX-XX. To obtain a new or\n   tweaked version of this certificate in the future, simply run\n   certbot again. To non-interactively renew *all* of your\n   certificates, run \"certbot renew\"\n

    Archipelago will do that for you whenever it's about to expire so no need to deal with this manually, even when docker-compose restarts.

    Now press CTRL+C. docker-compose will shutdown gracefully. Good!

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-5-deploy-drupal-10","title":"Step 5. Deploy Drupal 10","text":"","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#composer-and-drupal","title":"Composer and Drupal","text":"

    Copy the shipped default composer.default.json to composer.json and composer.default.lock to composer.lock (ONLY if you are installing from scratch):

    cp ../../drupal/composer.default.json ../../drupal/composer.json\ncp ../../drupal/composer.default.lock ../../drupal/composer.lock\n

    Start Docker again

    docker-compose up -d\n

    Wait a few seconds and run:

    docker exec -ti esmero-php bash -c \"chown -R www-data:www-data private\"\ndocker exec -ti esmero-php bash -c \"chown -R www-data:www-data web/sites\"\ndocker exec -ti esmero-php bash -c \"composer install\"\n

    Composer install will take a little while and bring all your PHP libraries.

    Once done, execute our setup script that will prepare your Drupal settings.php and bring some of the .env enviromental variables to the Drupal environment. 

    docker exec -ti esmero-php bash -c 'scripts/archipelago/setup.sh'\n

    And now you can deploy Drupal!

    IMPORTANT: Make sure you replace in the following command inside root:MYSQL_ROOT_PASSWORD the MYSQL_ROOT_PASSWORD string with the value you used/assigned in your .env file for MYSQL_ROOT_PASSWORD. And replace ADMIN_PASSWORD with a password that is safe and you won't forget! That passwords is for your Drupal super user (uid:0).

    docker exec -ti -u www-data esmero-php bash -c \"cd web;../vendor/bin/drush -y si --verbose --existing-config --db-url=mysql://root:MYSQL_ROOT_PASSWORD@esmero-db/drupal --account-name=admin --account-pass=ADMIN_PASSWORD -r=/var/www/html/web --sites-subdir=default --notify=false;drush cr;chown -R www-data:www-data sites;\"\n
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-6-users-and-initial-content","title":"Step 6. Users and initial Content.","text":"

    After installation is done (may take a few) you can install initial users and assign them roles. Copy each line separately. A missing permission will not let you ingest the initial Metadata Displays and AMI set.

    docker exec -ti esmero-php bash -c 'drush ucrt demo --password=\"demo\"; drush urol metadata_pro \"demo\"'\n
    docker exec -ti esmero-php bash -c 'drush ucrt jsonapi --password=\"jsonapi\"; drush urol metadata_api \"jsonapi\"'\n
    docker exec -ti esmero-php bash -c 'drush urol administrator \"admin\"'\n

    Before ingesting the base content we need to make sure we can access your JSON-API on for your new domain. That means we need to change internal urls (https://esmero-web) to the new valid SSL driven ones. This is easy:

    On your host machine (no need to docker exec these ones), replace first in the following command your.domain.org with the domain you setup in your .env file. Go to (cd into) your base git clone folder (Important: YOUR BASE CLONE FOLDER) and then run

     sed -i 's/http:\\/\\/esmero-web/https:\\/\\/your.domain.org/g' drupal/scripts/archipelago/deploy.sh\n sed -i 's/http:\\/\\/esmero-web/https:\\/\\/your.domain.org/g' drupal/scripts/archipelago/update_deployed.sh\n

    Now your deploy.sh and update_deployed.sh are update and ready. Let's ingest some Twig Templates, an AMI Set, menus and a Blocks.

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    IMPORTANT: update_deployed.sh is not needed when deploying for the first time and totally discouraged on a customized Archipelago. If you make modifications to your Twig templates, that command will replace the ones shipped by us with fresh copies overwriting all your modifications. Only run to restore larger errors or when needing to update everything ones with newer versions and you don't care for your own customization. Please read https://docs.archipelago.nyc/1.3.0/utility_scripts/ for more ways of managing exporting/importing Metadata Display Entities (Twig templates).

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-7-set-your-public-iiif-server-url-to-your-actual-domain","title":"Step 7. Set your public IIIF server URL to your actual domain","text":"

    By default archipelago ships with a public facing and an internal facing IIIF Server URLs configured. These urls are used by a number of IIIF enabled viewers and need to be changed to reflect your new reality (a real Domain name and a proxied path!). These settings belong to the strawberryfield/format_strawberryfield module.

    First check your current settings:

    docker exec -ti esmero-php bash -c \"drush config-get format_strawberryfield.iiif_settings\"\n

    You will see the following:

    pub_server_url: 'http://localhost:8183/iiif/2'\nint_server_url: 'http://esmero-cantaloupe:8182/iiif/2'\n

    Let's modify pub_server_url. Replace in the following command your.domain.org with the domain you defined in your .env file. NOTE: We are passing the -y flag to drush avoid that way having to answer \"yes\".

    docker exec -ti esmero-php bash -c \"drush -y config-set format_strawberryfield.iiif_settings pub_server_url https://your.domain.org/cantaloupe/iiif/2\"\n

    Finally Done! Now you can log into your new Archipelago using https and start exploring. Thank you for following this guide!

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#deployment-on-arm64v8graviton-apple-m1-system","title":"Deployment on ARM64/v8(Graviton, Apple M1) system:","text":"

    This applies to AWS m6g and t3g Instances and is documented inline in this guide. Please open an ISSUE in this repository if you run into any problems. Please review https://github.com/esmero/archipelago-deployment-live/blob/1.3.0/deploy/ec2-docker/docker-compose-aws-s3-arm64.yml for more info.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#how-do-i-know-my-architecture","title":"How do I know my Architecture?","text":"

    Run 

    uname -m \n
    • For an x86(64 bit) processor system output will be x86_64
    • For an ARM(64 bit) processor system output will be aarch64
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Lund
    • Giancarlo Birello
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#acknowledgments","title":"Acknowledgments","text":"

    This software is a Metropolitan New York Library Council Open-Source initiative and part of the Archipelago Commons project.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-updatingContainers/","title":"How to update your Docker containers","text":"

    From time to time you may have a need to update the containers themselves. Primarily this is done for security releases.

    ","tags":["Github","Docker","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-updatingContainers/#1-update-docker-composeyml","title":"1. Update docker-compose.yml","text":"

    The first thing you need to do is to edit your docker-compose.yml file and replace the version of the container with the new one you wish to use.

    Navigate to your docker-compose.yml file and open it to edit. On Debian installs it would look like this:

      cd /usr/local/archipelago/deploy/archipelago-deployment-live/deploy/ec2-docker\n  vi docker-compose.yml\n

    You want to change the image line to reflect the name of the new image you wish to use:

    image: esmero/php-7.4-fpm:1.0.0-RC3-multiarch\n

    might become:

    image: esmero/php-8.0-fpm:1.1.0-multiarch\n

    Save your change. If use vi like in the above it would look like this:

      :wq\n
    ","tags":["Github","Docker","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-updatingContainers/#pull-the-new-images","title":"Pull the new image(s)","text":"

    Docker Compose will now allow us to grab the new image(s) while your current system is running:

      docker-compose pull\n
    ","tags":["Github","Docker","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-updatingContainers/#stop-and-restart-the-container","title":"Stop and restart the container","text":"

    It is necesary to stop and start the container or the current image will continue to be used:

      docker-compose stop container-name\n

    Wait for it to stop. Then bring it back up:

    docker-compose up -d \n

    It is important to use the -d flag or you will have your live instance stuck in your terminal. You want it to run in the background. The -d flag stands for detached.

    ","tags":["Github","Docker","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-updatingContainers/#down-and-up","title":"Down and up","text":"

    If you are more comfortable having the all the containers go down and up you can do that with the following:

    docker-compose down\ndocker-compose up\n

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback, or open an ISSUE in this Archipelago Deployment Live Repository.

    Return to Archipelago Live Deployment.

    ","tags":["Github","Docker","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/","title":"Archipelago-deployment-live: upgrading Drupal 8 to Drupal 9 (1.0.0-RC2 to 1.0.0-RC3)","text":"","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#what-is-this-documentation-for","title":"What is this documentation for?","text":"

    If you already have a well-set-up and well-loved Archipelago (RC2 or your own custom version) running Drupal 8 (D8), this documentation will allow you to update to Drupal 9 (D9) without major issues.

    D8 is no longer supported as of the end of November 2021. D9 has been around for a little while and even if every module is not supported yet, what you need and want for Archipelago has long been D9-ready.

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#requirements","title":"Requirements","text":"
    • An archipelago-deployment-live instance 1.0.0-RC2 (working, tested) deployed using provided instructions via Docker and running Drupal 8.
    • Basic knowledge and instincts (+ courage) on how to run Terminal Commands, composer and drush.
    • Patience. You can't skip steps here.
    • For Shell Commands documented here please copy line by line\u2014not the whole block.
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#backing-up-and-preparing-for-the-upgrade","title":"Backing up and preparing for the upgrade","text":"

    Backups are always going to be your best friends. Archipelago's code, database and settings are mostly self-contained in your current archipelago-deployment-live repo folder, and backing up is simple because of that.

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-1","title":"Step 1:","text":"

    Shut down your docker-compose ensemble. Move to your archipelago-deployment-live folder and run this:

    cd deploy/ec2-docker\ndocker-compose down\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-2","title":"Step 2:","text":"

    Verify that all containers are actually down. The following command should return an empty listing. If anything is still running, wait a little longer, and run the following comman again.

    docker ps\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-3","title":"Step 3:","text":"

    Now let's tar.gz the whole ensemble with data and configs. As an example we will save this into your $HOME folder. As a good practice we append the current date (YEAR-MONTH-DAY) to the filename. Here we assume today is December 1st of 2021.

    sudo tar -czvpf $HOME/archipelago-deployment-live-backup-20211201.tar.gz ../../../archipelago-deployment-live\n

    The process may take a few minutes. Now let's verify that all is there and that the tar.gz is not corrupt.

    tar -tvvf $HOME/archipelago-deployment-live-backup-20211201.tar.gz\n

    You will see a listing of files. If corrupt (Do you have enough space? Did your ssh connection drop?) you will see the following:

    tar: Unrecognized archive format\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-4","title":"Step 4:","text":"

    Restart your docker-compose ensemble, and wait a little while for all to start.

    docker-compose up -d\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-5","title":"Step 5:","text":"

    Export/backup all of your live Archipelago configurations (this allows you to compare/come back in case you lose something custom during the upgrade).

    docker exec esmero-php mkdir config/backup\ndocker exec esmero-php drush cex --destination=/var/www/html/config/backup\n

    Good. Now it's safe to begin the upgrade.

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#upgrading-to-100-rc3","title":"Upgrading to 1.0.0-RC3","text":"","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-1_1","title":"Step 1:","text":"

    First we are going to disable modules that are not part of 1.0.0-RC3 or are not yet compatible with D9. Run the following command:

    docker exec esmero-php drush pm-uninstall module_missing_message_fixer markdown webprofiler key_value webform_views\n

    From inside your archipelago-deployment-live repo folder we are going to open up the file permissions for some of your most protected Drupal files.

    cd ../../\nsudo chmod 777 drupal/web/sites/default\nsudo chmod 666 drupal/web/sites/default/*settings.php\nsudo chmod 666 drupal/web/sites/default/*services.yml\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-2_1","title":"Step 2:","text":"

    Time to fetch the 1.0.0-RC3 branch and update our docker-compose and composer dependencies. We are also going to stop the current docker ensemble to update all containers to newer versions:

    cd deploy/ec2-docker\ndocker-compose down\ngit checkout 1.0.0-RC3\n

    Then copy the appropriate docker-compose file for your architecture:

    OSX (macOS)/x86-64 
    cp docker-compose-osx.yml docker-compose.yml\n
    Linux/x86-64/AMD64 
    cp docker-compose-linux.yml docker-compose.yml\n
    OSX (macOS)/Linux/ARM64 
    cp docker-compose-arm64.yml docker-compose.yml\n

    Finally, pull the images, and bring up the ensemble:

    docker compose pull\ndocker compose up -d\n

    Give all a little time to start. The latest min.io adds a new console, and your Solr core and Database need to be upgraded. Please be patient. To ensure all is well, run (more than once if necessary) the following:

    docker ps\n

    You should see something like this:

    CONTAINER ID   IMAGE                                    COMMAND                  CREATED          STATUS          PORTS                                                           NAMES\n867fd2a42134   nginx                                    \"/docker-entrypoint.\u2026\"   32 seconds ago   Up 27 seconds   0.0.0.0:8001->80/tcp, :::8001->80/tcp                           esmero-web\n8663e84a9b48   solr:8.8.2                               \"docker-entrypoint.s\u2026\"   33 seconds ago   Up 30 seconds   0.0.0.0:8983->8983/tcp, :::8983->8983/tcp                       esmero-solr\n9b580fa0088f   minio/minio:latest                       \"/usr/bin/docker-ent\u2026\"   33 seconds ago   Up 28 seconds   0.0.0.0:9000-9001->9000-9001/tcp, :::9000-9001->9000-9001/tcp   esmero-minio\n50e2f41c7b60   esmero/esmero-nlp:1.0                    \"/usr/local/bin/entr\u2026\"   33 seconds ago   Up 30 seconds   0.0.0.0:6400->6400/tcp, :::6400->6400/tcp                       esmero-nlp\n300810fd6f03   esmero/cantaloupe-s3:4.1.9RC             \"sh -c 'java -Dcanta\u2026\"   33 seconds ago   Up 30 seconds   0.0.0.0:8183->8182/tcp, :::8183->8182/tcp                       esmero-cantaloupe\n248e4638ba2a   mysql:8.0.22                             \"docker-entrypoint.s\u2026\"   33 seconds ago   Up 28 seconds   3306/tcp, 33060/tcp                                             esmero-db\n141ace919344   esmero/php-7.4-fpm:1.0.0-RC2-multiarch   \"docker-php-entrypoi\u2026\"   33 seconds ago   Up 28 seconds   9000/tcp                                                        esmero-php\n

    Important here is the STATUS column. It needs to be a number that goes up in time every time you run docker ps again (and again).

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-3_1","title":"Step 3:","text":"

    Now we are going to tell composer to actually fetch the new code and dependencies using the 1.0.0-RC3 provided composer.lock and update the whole Drupal/PHP/JS environment.

    docker exec -ti esmero-php bash -c \"composer install\"\n

    This will fail (sorry!) for a few packages but no worries, they need to be patched and composer is not that smart. So simply run it again:

    docker exec -ti esmero-php bash -c \"composer install\"\n

    Well done! If you see no issues and all ends in a Green colored message all is good! Jump to Step 4

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#what-if-not-all-is-ok-and-i-see-red-and-a-lot-of-dependency-explanations","title":"What if not all is OK and I see red and a lot of dependency explanations?","text":"

    If you have manually installed packages via composer in the past that are NO longer Drupal 9 compatible you may see errors. In that case you need to check each package website's (normally https://www.drupal.org/project/the_module_name) and check if there is a Drupal 9 compatible version.

    If so run:

    docker exec -ti esmero-php bash -c \"composer require 'drupal/the_module_name:^VERSION_NUMBER_THAT_WORKS_ON_DRUPAL9_' --update-with-dependencies --no-update\" and run **Step 3 ** again (and again until all is cleared)\n

    If not: try to find a replacement module that does something simular, but in any case you may end having to remove before proceding. Give us a ping/slack/google group/open a github ISSUE if you find yourself uncertain about this.

    docker exec -ti esmero-php bash -c \"composer remove drupal/the_module_name --no-update\"\ndocker exec -ti esmero-php bash -c \" drush pm-uninstall the_module_name\"\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-4_1","title":"Step 4:","text":"

    We will now ask Drupal to update some internal configs and databases. They will bring you up to date with RC3 settings and D9 particularities.

    docker exec -ti esmero-php bash -c 'scripts/archipelago/setup.sh'\ndocker exec -ti esmero-php bash -c 'drush urol administrator \"admin\"'\ndocker exec -ti esmero-php bash -c \"drush updatedb\"\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-5_1","title":"Step 5:","text":"

    Previously D8 installations had a \"module/profile\" driven installation. Those are no longer used or even exist as part of core, but a profile can't be changed once installed so you have to do the following to avoid Drupal complaining about our new and simpler way of doing things (a small roll back):

    docker exec -ti esmero-php bash -c \"sed -i 's/minimal: 1000/standard: 1000/g' config/sync/core.extension.yml\"\ndocker exec -ti esmero-php bash -c \"sed -i 's/profile: minimal/profile: standard/g' config/sync/core.extension.yml\"\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-6","title":"Step 6:","text":"

    Now you can Sync your new Archipelago 1.0.0-RC3 and bring all the new configs and settings in. For this you have two options (no worries, remember you made a backup!):

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#a-partial-sync-which-will-bring-new-configs-and-update-existing-ones-but-will-not-remove-ones-that-only-exist-in-your-custom-setup-eg-new-webforms-or-view-modes","title":"A Partial Sync, which will bring new configs and update existing ones but will not remove ones that only exist in your custom setup, e.g. new Webforms or View Modes.","text":"
    docker exec esmero-php drush cim -y --partial\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#a-complete-sync-which-will-bring-new-configs-and-update-existing-ones-but-will-also-remove-all-the-ones-that-are-not-part-of-rc3-its-a-like-clean-factory-reset","title":"A Complete Sync, which will bring new configs and update existing ones but will also remove all the ones that are not part of RC3. It's a like clean factory reset.","text":"
    docker exec esmero-php drush cim -y\n

    If all goes well here and you see no errors it's time to reindex Solr because there are new Fields. Run the following:

    docker exec esmero-php drush search-api-reindex\ndocker exec esmero-php drush search-api-index\n

    You might see some warnings related to modules dealing with previously non-existent data\u2014no worries, just ignore those.

    If you made it this far you are done with code/devops (are we ever ready?), and that means you should be able to (hopefully) stay in the Drupal 9 realm for a few years!

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-7-update-or-not-your-metadata-display-entities-and-menu-items","title":"Step 7: Update (or not) your Metadata Display Entities and Menu items.","text":"

    Recommended: If you want to add new templates and menu items 1.0.0-RC3 provides, run this:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    Once that is done, you can choose to update all Metadata Displays (Twig templates) we ship with new 1.0.0-RC3 versions (heavily fixed IIIF manifest, Markdown to HTML for Metadata, better Object descriptions). But before you do this, we really recommend that you first make sure to manually (copy/paste) backup any Twig templates you have modified. If unusure, do not run the command that comes after this warning! You can always manually copy the new templates from the d8content/metadatadisplays folder which contains text versions (again, copy/paste) of each shipped template you can pick and use when you feel ready.

    If you are sure (like really?) you want to overwrite the ones you modified (sure, just checking?), then you can run this:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/update_deployed.sh'\n

    Done! (For realz now)

    Please log into your Archipelago and test/check all is working! Enjoy 1.0.0-RC3 and Drupal 9. Thanks!

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback, or open an ISSUE in this Archipelago Deployment Live Repository.

    Return to Archipelago Live Deployment.

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/","title":"Archipelago-deployment-live: upgrading from 1.0.0-RC3 to 1.0.0","text":"","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#what-is-this-documentation-for","title":"What is this documentation for?","text":"

    If you already have a well-set-up and well-loved Archipelago (RC3 or your own custom version) running Drupal 9, this documentation will allow you to update to 1.0.0 without major issues.

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#requirements","title":"Requirements","text":"
    • An archipelago-deployment-live instance 1.0.0-RC3 (working, tested) deployed using provided instructions via Docker and running Drupal 9.
    • Basic knowledge and instincts (+ courage) on how to run Terminal Commands, composer and drush.
    • Patience. You can't skip steps here.
    • For Shell Commands documented here please copy line by line\u2014not the whole block.
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#backing-up-and-preparing-for-the-upgrade","title":"Backing up and preparing for the upgrade","text":"

    Backups are always going to be your best friends. Archipelago's code, database and settings are mostly self-contained in your current archipelago-deployment-live repo folder, and backing up is simple because of that.

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-1","title":"Step 1:","text":"

    Shut down your docker-compose ensemble. Move to your archipelago-deployment-live folder and run this:

    cd deploy/ec2-docker\ndocker-compose down\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-2","title":"Step 2:","text":"

    Verify that all containers are actually down. The following command should return an empty listing. If anything is still running, wait a little longer, and run the following comman again.

    docker ps\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-3","title":"Step 3:","text":"

    Now let's tar.gz the whole ensemble with data and configs. As an example we will save this into your $HOME folder. As a good practice we append the current date (YEAR-MONTH-DAY) to the filename. Here we assume today is December 1st of 2021.

    sudo tar -czvpf $HOME/archipelago-deployment-live-backup-20220803.tar.gz ../../../archipelago-deployment-live\n

    The process may take a few minutes. Now let's verify that all is there and that the tar.gz is not corrupt.

    tar -tvvf $HOME/archipelago-deployment-live-backup-20220803.tar.gz \n

    You will see a listing of files. If corrupt (Do you have enough space? Did your ssh connection drop?) you will see the following:

    tar: Unrecognized archive format\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-4","title":"Step 4:","text":"

    Restart your docker-compose ensemble, and wait a little while for all to start.

    docker-compose up -d\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-5","title":"Step 5:","text":"

    Export/backup all of your live Archipelago configurations (this allows you to compare/come back in case you lose something custom during the upgrade).

    docker exec esmero-php mkdir config/backup\ndocker exec esmero-php drush cex --destination=/var/www/html/config/backup\n

    Good. Now it's safe to begin the upgrade.

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#upgrading-to-100","title":"Upgrading to 1.0.0","text":"","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-1_1","title":"Step 1:","text":"

    First we are going to disable modules that are not part of 1.0.0 or are not yet compatible with Drupal 9.4.x or higher . Run the following command:

    docker exec esmero-php drush pm-uninstall search_api_solr_defaults entity_reference\n

    From inside your archipelago-deployment-live repo folder we are going to open up the file permissions for some of your most protected Drupal files.

    cd ../../\nsudo chmod 777 drupal/web/sites/default\nsudo chmod 666 drupal/web/sites/default/*settings.php\nsudo chmod 666 drupal/web/sites/default/*services.yml\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-2_1","title":"Step 2:","text":"

    First let's back up our current composer.lock:

    cp drupal/composer.lock drupal/composer.original.lock\n

    Time to fetch the 1.0.0 branch and update our docker-compose and composer dependencies. We are also going to stop the current docker ensemble to update all containers to newer versions:

    cd deploy/ec2-docker\ndocker-compose down\ngit fetch\ngit checkout 1.0.0 \n

    If you decide to enable the Drupal REDIS module, make sure to add the REDIS_PASSWORD variable to your .env file.

    IMPORTANT NOTE: For AWS EC2. If you selected an IAM role for your server when setting it up/deploying it, min.io will use the AWS EC2-backed internal API to request access to your S3. This means the ROLE itself needs to have read/write access (ACL) to the given Bucket(s) and your key/secrets won't be able to override that. Please do not ignore this note. It will save you a LOT of frustration and coffee. You can also run an EC2 instance without a given IAM and in that case just the ACCESS_KEY/SECRET will matter.

    Now that you know, you also know that these values should not be shared and this .env file should not be committed/kept in version control. Please be careful.

    Now let's back up the existing docker-compose file:

    cp docker-compose.yml docker-compose-original.yml\n

    Then copy the appropriate docker-compose file for your architecture:

    Linux/x86-64/AMD64 
    cp docker-compose-aws-s3.yml docker-compose.yml\n
    Linux/ARM64/Apple Silicon (M1 and M2) 
    cp docker-compose-aws-s3-arm64.yml docker-compose.yml\n

    Next, let's review what's changed in case any customizations need to be brought into the new docker-compose configurations:

    git diff --no-index docker-compose-original.yml docker-compose.yml\n

    You should encounter something like the following:

    diff --git a/docker-compose-original.yml b/docker-compose.yml\nindex 6f5b17e..282417f 100644\n--- a/docker-compose-original.yml\n+++ b/docker-compose.yml\n@@ -1,5 +1,5 @@\n # Run docker-compose up -d\n-\n+# Docker file for AMD64/X86 machines\n version: '3.5'\n services:\n   web:\n@@ -23,6 +23,7 @@ services:\n       - solr\n       - php\n       - db\n+      - redis\n     tty: true\n     networks:\n       - host-net\n@@ -30,7 +31,7 @@ services:\n   php:\n     container_name: esmero-php\n     restart: always\n-    image: \"esmero/php-7.4-fpm:1.0.0-RC2-multiarch\"\n+    image: \"esmero/php-8.0-fpm:1.1.0-multiarch\"\n     tty: true\n     networks:\n       - host-net\n@@ -44,10 +45,11 @@ services:\n       MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}\n       MINIO_BUCKET_MEDIA: ${MINIO_BUCKET_MEDIA}\n       MINIO_FOLDER_PREFIX_MEDIA: ${MINIO_FOLDER_PREFIX_MEDIA}\n+      REDIS_PASSWORD: ${REDIS_PASSWORD}\n   solr:\n     container_name: esmero-solr\n     restart: always\n-    image: \"solr:8.8.2\"\n+    image: \"solr:8.11.2\"\n

    As you can see, most of the changes in this example are for new images and a new service/container/environment variable (REDIS), but you may have custom settings for your containers. Review any differences carefully and make adjustments as needed.

    Finally, pull the images:

    docker compose pull \n

    1.0.0 provides a new Cantaloupe that uses different permissions so we need to adapt those. From your current folder (../ec2-deploy) run:

    sudo chown 8183:8183 ../../config_storage/iiifconfig/cantaloupe.properties\nsudo chown -R 8183:8183 ../../data_storage/iiifcache\nsudo chown -R 8183:8183 ../../data_storage/iiiftmp\n

    Time to start the ensemble again

    docker compose up -d\n

    Give all a little time to start. Solr core and Database need to be upgraded, Cantaloupe is new and this brings also Redis for caching. Please be patient. To ensure all is well, run (more than once if necessary) the following:

    docker ps\n

    You should see something like this: e.g if running on ARM64 You should see something like this: 

    CONTAINER ID   IMAGE                                    COMMAND                  CREATED          STATUS          PORTS                                                           NAMES\n4ed2f62e866e   jonasal/nginx-certbot                      \"/docker-entrypoint.\u2026\" 32 seconds ago   Up 27 seconds   0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp   esmero-web\ne6b4383039c3   minio/minio:RELEASE.2022-06-11T19-55-32Z   \"/usr/bin/docker-ent\u2026\" 33 seconds ago   Up 30 seconds   0.0.0.0:9000-9001->9000-9001/tcp, :::9000-9001->9000-9001/tcp              esmero-minio\nf2b6b173b7e2   solr:8.11.2                                \"docker-entrypoint.s\u2026\" 33 seconds ago   Up 28 seconds   0.0.0.0:8983->8983/tcp, :::8983->8983/tcp                                  esmero-solr\na553bf484343   esmero/php-8.0-fpm:1.0.0-multiarch         \"docker-php-entrypoi\u2026\" 33 seconds ago   Up 30 seconds   9000/tcp                                                                   esmero-php\necb47349ae94   esmero/esmero-nlp:fasttext-multiarch       \"/usr/local/bin/entr\u2026\" 33 seconds ago   Up 30 second    0.0.0.0:6400->6400/tcp, :::6400->6400/tcp                                  esmero-nlp\n61272dce034a   redis:6.2-alpine                           \"docker-entrypoint.s\u2026\" 33 seconds ago   Up 28 seconds                                                                              esmero-redis\n0ee9869f809b   esmero/cantaloupe-s3:6.0.0-multiarch       \"sh -c 'java -Dcanta\u2026\" 33 seconds ago   Up 28 seconds   0.0.0.0:8183->8182/tcp, :::8183->8182/tcp                                  esmero-cantaloupe\n131d072567ce   mariadb:10.6.8-focal                       \"docker-entrypoint.s\u2026\" 33 seconds ago   Up 28 seconds   3306/tcp                                                                   esmero-db                                            esmero-php\n

    Important here is the STATUS column. It needs to be a number that goes up in time every time you run docker ps again (and again).

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-3_1","title":"Step 3:","text":"

    Instead of using the provided composer.default.lock out of the box we are going to loosen certain dependencies and bring manually Archipelago modules, all this to make update easier and future upgrades less of a pain.

    First, as a sanity check let's make sure nothing happened to our original composer.lock fileby doing a diff against our backed up file:

    git diff --no-index ../../drupal/composer.original.lock ../../drupal/composer.lock\n

    If all is ok, there should be no output. If there's any output, copy your backed up file back to default:

    cp ../../drupal/composer.original.lock ../../drupal/composer.lock\n

    Finally, we bring over the modules:

    docker exec -ti esmero-php bash -c \"composer require drupal/core:^9 drupal/core-composer-scaffold:^9 drupal/core-project-message:^9 drupal/core-recommended:^9\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/core-dev:^9 --dev\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/tokenuuid:^2\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/facets:^2.0'\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/moderated_content_bulk_publish:^2\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/queue_ui:^3.1\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/jquery_ui_touch_punch:^1.1\"\ndocker exec -ti esmero-php bash -c \"composer require archipelago/ami:0.4.0.x-dev strawberryfield/format_strawberryfield:1.0.0.x-dev strawberryfield/strawberryfield:1.0.0.x-dev strawberryfield/strawberry_runners:0.4.0.x-dev strawberryfield/webform_strawberryfield:1.0.0.x-dev drupal/views_bulk_operations:^4.1\"\n

    Now we are going to tell composer to actually fetch the new code and dependencies using composer.lock and update the whole Drupal/PHP/JS environment.

    docker exec -ti esmero-php bash -c \"composer update -W\"\ndocker exec -ti esmero-php bash -c \"drush cr\"\ndocker exec -ti esmero-php bash -c \"drush en jquery_ui_touch_punch\"\ndocker exec -ti esmero-php bash -c \"drush updatedb\"\n

    Well done! If you see no issues and all ends in a Green colored message all is good! Jump to Step 4

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#what-if-not-all-is-ok-and-i-see-red-and-a-lot-of-dependency-explanations","title":"What if not all is OK and I see red and a lot of dependency explanations?","text":"

    If you have manually installed packages via composer in the past that are NO longer Drupal 9 compatible you may see errors. In that case you need to check each package website's (normally https://www.drupal.org/project/the_module_name) and check if there is a Drupal 9 compatible version.

    If so run:

    docker exec -ti esmero-php bash -c \"composer require 'drupal/the_module_name:^VERSION_NUMBER_THAT_WORKS_ON_DRUPAL9_' --update-with-dependencies --no-update\" and run **Step 3 ** again (and again until all is cleared)\n

    If not: try to find a replacement module that does something simular, but in any case you may end having to remove before proceding. Give us a ping/slack/google group/open a github ISSUE if you find yourself uncertain about this. 

    docker exec -ti esmero-php bash -c \"composer remove drupal/the_module_name --no-update\"\ndocker exec -ti esmero-php bash -c \" drush pm-uninstall the_module_name\"\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-4_1","title":"Step 4:","text":"

    We will now ask Drupal to update some internal configs and databases. They will bring you up to date with 1.0.0 settings and D9 particularities.

    docker exec -ti esmero-php bash -c 'scripts/archipelago/setup.sh'\ndocker exec -ti esmero-php bash -c \"drush updatedb\"\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-5_1","title":"Step 5:","text":"

    Now you can Sync your new Archipelago 1.0.0 and bring all the new configs and settings in. For this you have two options (no worries, remember you made a backup!):

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#a-partial-sync-which-will-bring-new-configs-and-update-existing-ones-but-will-not-remove-ones-that-only-exist-in-your-custom-setup-eg-new-webforms-or-view-modes","title":"A Partial Sync, which will bring new configs and update existing ones but will not remove ones that only exist in your custom setup, e.g. new Webforms or View Modes.","text":"
    docker exec esmero-php drush cim -y --partial\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#a-complete-sync-which-will-bring-new-configs-and-update-existing-ones-but-will-also-remove-all-the-ones-that-are-not-part-of-rc3-its-a-like-clean-factory-reset","title":"A Complete Sync, which will bring new configs and update existing ones but will also remove all the ones that are not part of RC3. It's a like clean factory reset.","text":"
    docker exec esmero-php drush cim -y\n

    If all goes well here and you see no errors it's time to reindex Solr because there are new Fields. Run the following:

    docker exec esmero-php drush search-api-reindex\ndocker exec esmero-php drush search-api-index\n

    You might see some warnings related to modules dealing with previously non-existent data\u2014no worries, just ignore those.

    If you made it this far you are done with code/devops (are we ever ready?), and that means you should be able to (hopefully) stay in the Drupal 9 realm for a few years!

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-7-update-or-not-your-metadata-display-entities-and-menu-items","title":"Step 7: Update (or not) your Metadata Display Entities and Menu items.","text":"

    Recommended: If you want to add new templates and menu items 1.0.0 provides, go to your base Github repo folder, replace in the following commands your.domain.org with the actual domain of your Server and run those individually:

    sed -i 's/http:\\/\\/esmero-web/https:\\/\\/your.domain.org/g' drupal/scripts/archipelago/deploy.sh\n
    sed -i 's/http:\\/\\/esmero-web/https:\\/\\/your.domain.org/g' drupal/scripts/archipelago/update_deployed.sh\n

    Now update your Metadata Display Templates and Blocks

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    Once that is done, you can choose to update all Metadata Displays (Twig templates) we ship with new 1.0.0 versions (heavily fixed IIIF manifest, Markdown to HTML for Metadata, better Object descriptions). But before you do this, we really recommend that you first make sure to manually (copy/paste) backup any Twig templates you have modified. If unusure, do not run the command that comes after this warning! You can always manually copy the new templates from the d8content/metadatadisplays folder which contains text versions (again, copy/paste) of each shipped template you can pick and use when you feel ready.

    If you are sure (like really?) you want to overwrite the ones you modified (sure, just checking?), then you can run this:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/update_deployed.sh'\n

    Done! (For realz now)

    Please log into your Archipelago and test/check all is working! Enjoy 1.0.0. Thanks!

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback, or open an ISSUE in this Archipelago Deployment Live Repository.

    Return to Archipelago Live Deployment.

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-osx/","title":"Installing Archipelago Drupal 10 on OSX (macOS)","text":"","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#about-running-terminal-commands","title":"About running terminal commands","text":"

    This guide assumes you are comfortable enough running terminal (bash) commands on an OSX Computer.

    We made sure that you can copy and paste each of these commands from this guide directly into your terminal.

    You will notice sometimes commands span more than a single line of text. If that is the case, always make sure you copy and paste a single line at a time and press the Enter key afterwards. We suggest also you look at the output.

    If something fails (and we hope it does not) troubleshooting will be much easier if you can share that output when asking for help.

    Happy deploying!

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#osx-macos","title":"OSX (macOS):","text":"
    • Install Docker for Mac
    • For OSX (macOS) Ventura or Higher on Intel (i5/i7) and Apple Silicon Chips (M1/M2/M3) the tested version is: 4.23.0(120376). You may go newer of course.
    • In Preferences -> General: check Use gRPC FUSE for file sharing and restart. Specially if you are using your $HOME folder for deploying, e.g. /Users/username.
    • In Preferences -> Resources: 4 Gbytes of RAM is the recommended minimun and works; 8 Gbytes is faster and snappier.
    • Install Github Desktop.
    • At least 10 Gbytes of free space (to get started).
    • Being able to open a terminal.

    Note: Recent OSX (macOS) and newer Macs ship with 2 annoying things: Apple Cloud Syncing User Folders and (wait for it) Case insensitive File Systems. If you are happy with your shiny new Mac (like i was) we are aware that it's better to deploy anything mounted outside of the /User folder or even better, in an external drive formatted using a Case Sensitive Unix Filesystem (Mac OS Extended (Case-sensitive, Journaled)).

    Note 2: \"Use gRPC FUSE for file sharing\" experience may vary, recent Docker for Mac does it well. In older RC1 ones it was evil. Changing/Disabling it after having installed Archipelago may affect your S3/Minio storage accessibility. Please let us know what your experience on this is.

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#wait-question-do-you-have-a-previous-version-of-archipelago-running","title":"Wait! Question: Do you have a previous version of Archipelago running?","text":"

    If so, let's give that hard working repository a break first. If not, skip to Step 1:

    • Open a terminal (you have that already right?) and go to your previous download/git clone folder and run:
    docker-compose down\ndocker-compose rm\n
    • Can't remember where you downloaded it? Ok. We can deal with that!

    Let's stop the containers gracefully first, run:

    docker stop esmero-web\ndocker stop esmero-solr\ndocker stop esmero-db\ndocker stop esmero-cantaloupe\ndocker stop esmero-php\ndocker stop esmero-minio\ndocker stop esmero-nlp\n

    Now we need to remove them, run:

    docker rm esmero-web\ndocker rm esmero-solr\ndocker rm esmero-db\ndocker rm esmero-cantaloupe\ndocker rm esmero-php\ndocker rm esmero-minio\ndocker rm esmero-nlp\n

    Ok, now we are ready to start. Depending on what type of Chip your Apple uses you have two options:

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-1-intel-docker-deployment-on-intel-chips-apple-machines","title":"Step 1 (Intel): Docker Deployment on Intel Chips Apple Machines","text":"
    git clone https://github.com/esmero/archipelago-deployment.git archipelago-deployment\ncd archipelago-deployment\ngit checkout 1.3.0\ncp docker-compose-osx.yml docker-compose.yml\ndocker-compose pull\ndocker-compose up -d\n
    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-1-m1-docker-deployment-on-apple-silicon-chips-m1","title":"Step 1 (M1): Docker Deployment on Apple Silicon Chips (M1)","text":"
    git clone https://github.com/esmero/archipelago-deployment.git archipelago-deployment\ncd archipelago-deployment\ngit checkout 1.3.0\ncp docker-compose-arm64.yml docker-compose.yml\ndocker-compose pull\ndocker-compose up -d\n

    Note: If you are running on an Intel Apple Machine from an external Drive or a partition/filesystem that is Case Sensitive and is not syncing automatically to Apple Cloud you can also use docker-compose-linux.yml. Note2: docker-compose.yml is git ignored in case you make local adjustments or changes to it.

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-2-set-up-your-minio-s3-bucket","title":"Step 2: Set up your Minio S3 bucket","text":"

    Once all containers are up and running (you can do a docker ps to check), access the minio console at http://localhost:9001 using your most loved Web Browser with the following credentials:

    user:minio\npass:minio123\n

    and once logged in, press on \"Buckets\" (left tools column) and then on \"Create Bucket\" (top right) and under \"Bucket Name\" type archipelago. Leave all other options unchecked for now (you can experiment with those later), and make sure you write archipelago (no spaces, lowercase) and press \"Save\". Done! That is where we will persist all your Files and also your File copies of each Digital Object. You can always go there and explore what Archipelago (well really Strawberryfield does the hard work) has persisted so you can get comfortable with our architecture.

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-3-deploy-drupal-10-and-the-awesome-archipelago-modules","title":"Step 3: Deploy Drupal 10 and the awesome Archipelago Modules","text":"

    The following will run composer inside the esmero-php container to download all dependencies and Drupal Core too:

    docker exec -ti esmero-php bash -c \"composer install\"\n

    Once that command finishes run our setup script:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/setup.sh'\n

    Explanation: That script will append some important configurations to your local web/sites/default/settings.php.

    Note: We say local because your whole Drupal web root (the one you cloned) is also mounted inside the esmero-php and esmero-web containers. So edits to PHP files, for example, can be done without accessing the container directly from your local folder.

    If this is the first time you deploy Drupal using the provided Configurations run:

    docker exec -ti -u www-data esmero-php bash -c \"cd web;../vendor/bin/drush -y si --verbose --existing-config --db-url=mysql://root:esmerodb@esmero-db/drupal --account-name=admin --account-pass=archipelago -r=/var/www/html/web --sites-subdir=default --notify=false;drush cr;chown -R www-data:www-data sites;\"\n

    Note: You will see these warnings:

    [warning] The \"block_content:9aa72fb1-2817-44a7-8fb5-a3eb51166e83\" was not found [warning] The \"block_content:1cdf7155-eb60-4f27-9e5e-64fffe93127a\" was not found [warning] The \"facets_summary_block:advance\" was not found [warning] The \"facets_summary_block:search_page_facet_summary\" was not found

    Nothing to worry about. We will provide the missing part in Step 5.

    Note 2: Please be patient. This step takes since composer 2.0 25-30% longer because of how the most recent Drupal Installation code fetches translations and other resources (see Performed install task). This means progress might look like getting \"stuck\", go and get a coffee/tea and let it run to the end.

    Once finished, this will give you an admin Drupal user with archipelago as password (Change this if running on a public instance!).

    Final Note about Steps 2-3: You don't need to, nor should you do this more than once. You can destroy/stop/update, recreate your Docker containers, and start again (git pull), and your Drupal and Data will persist once you're past the Installation complete message. I repeat, all other containers' data is persisted inside the persistent/ folder contained in this cloned git repository. Drupal and all its code is visible, editable, and stable inside your web/ folder.

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-4-create-a-demo-and-a-jsonapi-user-using-drush-and-assign-your-admin-user-the-administrator-role","title":"Step 4: Create a \"demo \"and a \"jsonapi\" user using drush and assign your \"admin\" user the Administrator Role.","text":"

    docker exec -ti esmero-php bash -c 'drush ucrt demo --password=\"demo\"; drush urol metadata_pro \"demo\"'\n
    docker exec -ti esmero-php bash -c 'drush ucrt jsonapi --password=\"jsonapi\"; drush urol metadata_api \"jsonapi\"'\n
    docker exec -ti esmero-php bash -c 'drush urol administrator \"admin\"'\n

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-5-ingest-some-metadata-displays-to-make-playing-much-more-interactive","title":"Step 5: Ingest some Metadata Displays to make playing much more interactive","text":"

    Archipelago is more fun without having to start writing Metadata Displays (in Twig) before you know what they actually are. Since you should now have a jsonapi user and jsonapi should be enabled, you can use that awesome functionality of D8 to get that done. We have 4 demo Metadata Display Entities that go well with the demo Webform we provided. To do that execute in your shell (copy and paste):

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    Open your most loved Web Browser and point it to http://localhost:8001.

    Note: It can take some time to start the first time (Drupal needs some warming up).

    Also, to make this docker-compose easier to use we are doing something named bind mounting (or similar...) your folders. The good thing is that you can edit files in your machine, and they get updated instantly to docker. The bad thing is that the OSX (macOS) driver runs slower than on Linux. Speed is a huge factor here, but you get the flexibility of changing, backing up, and persisting files without needing a Docker University Degree.

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-6-optional-but-more-fun-if-you-add-content","title":"Step 6: Optional but more fun if you add content","text":"

    One-Step Demo content ingest

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#need-help-blue-screen-missed-a-step-need-a-hug-and-such","title":"Need help? Blue Screen? Missed a step? Need a hug and such?","text":"

    If you see any issues or errors or need help with a step, please let us know (ASAP!). You can either open an issue in this repository or use the Google Group. We are here to help.

    If you like this, let us know!

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Sherrick
    • Giancarlo Birello
    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-readme/","title":"Archipelago Docker Deployment","text":"

    Updated: January 30th 2024

    Previously Updated: October 31st 2023

    This repository serves as bootstrap for a Archipelago 1.3.0 deployment on a localhost for development/testing/customizing via Docker and provides a more unified experience this time:

    • minio.io (latest with Gateway Support) S3/Azure/Local/Remote alternative with Console.
    • Apache Solr 9.1 with the wizardly Solr OCR Highlight library v0.8.4 built by the Developement Team at the Bavarian State Library. Thanks Johannes Baiter and team.
    • MySQL 8.x (amd64/x86)/MariaDB 10.6.x(Arm64/M1/M2/M3)
    • NGINX 11
    • Custom PHP-FPM 8.1 multi architecture, fine-tuned for Drupal 10 , WARC to WACZ processing, Tesseract 5 with JP2 support, PDFAlto and Composer 2.x, Drush 12, etc
    • Natural Language Processing via NLPWEB64 multi architecture with FastText Language detection (Thanks Mike Bennet!)
    • Cantaloupe 6.0.1 Snapshot multi architecture as IIIF2/3 Server with Video Frame extraction and PDF support (with custom fix for tiled PDF)
    • A Skeleton Project setup to run latest Version of Drupal (10.1.x), our new Bootstrap 5 theme and Strawberry Field modules on 1.3.0 & friends on 0.7.0
    • Complete support for Apple Silicon M1 Machines and in general arm64 architecture Chips like Raspberry Pi 4, with specially built arm64 docker containers. The only differences now between deployment strategies is the DB. Blazing fast OCR.

    The skeleton project contains all the pieces needed to run a local deployment of a vanilla Archipelago including (YES!) content provided as an optional feature from archipelago-recyclables

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#starting-from-zero","title":"Starting from ZERO","text":"

    This is the recommended, simplest way for this release. There are a too many, tons of fun new features, Metadata Displays, Webforms, New formatters and Twig extensions, improved viewers, new and improved JS libraries, OpenCV/Face Detection, smarter NLP, File composting, better HUGE import/update capabilities, bug fixes (yes so many) so please try them out. The team has also updated the DEMO AMI set (Content) to showcase metadata/display improvements.

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#macos-intel-or-apple-silicon-m1m2m3","title":"macOS Intel or Apple Silicon M1/M2/M3:","text":"

    Step by Step deployment on macOS

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#ubuntu-1804-or-2004","title":"Ubuntu 18.04 or 20.04:","text":"

    Step by Step deployment on Ubuntu

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#windows-10-or-11","title":"Windows 10 or 11:","text":"

    Step by Step deployment on Windows

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#more-fun-if-you-add-content","title":"More fun if you add content:","text":"

    One-Step Demo content ingest

    If you like it (or not), want new features, or want to be part of making this better (documenting, coding and planning) let us know. Make your voice and opinion be heard, this is a community effort.

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Sherrick
    • Giancarlo Birello
    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#acknowledgments","title":"Acknowledgments","text":"

    This software is a Metropolitan New York Library Council Open-Source initiative and part of the Archipelago Commons project.

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-ubuntu/","title":"Installing Archipelago Drupal 10 on Ubuntu 18.04 or 20.04","text":"","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#about-running-terminal-commands","title":"About running terminal commands","text":"

    This guide assumes you are comfortable enough running terminal (bash) commands on a Linux Computer.

    We made sure that you can copy and paste each of these commands from this guide directly into your terminal.

    You will notice sometimes commands span more than a single line of text. If that is the case, always make sure you copy and paste a single line at a time and press the Enter key afterwards. We suggest you also look at the output.

    If something fails (and we hope it does not) troubleshooting will be much easier if you can share that output when asking for help.

    Happy deploying!

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#prerequisites","title":"Prerequisites","text":"
    • At least 10 Gbytes of free space (to get started)
    • Some basic Unix/Terminal Skills
    • 2-4 Gbytes of RAM (4 Recommended)
    • Install Docker if you don't have it already by running:
    sudo apt install apt-transport-https ca-certificates curl software-properties-common\ncurl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -\nsudo add-apt-repository \"deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable\"\nsudo apt update\nsudo apt-cache policy docker-ce\nsudo apt install docker-ce\nsudo systemctl status docker\n\nsudo usermod -aG docker ${USER}\n

    Log out, and log in again!

    sudo apt install docker-compose\n

    Git tools are included by default in Ubuntu.

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#wait-question-do-you-have-a-previous-version-of-archipelago-running","title":"Wait! Question: Do you have a previous version of Archipelago running?","text":"

    If so, let's give that hard working repository a break first. If not, Step 1:

    • Open a terminal (you have that already right?) and go to your previous download/git clone folder and run:
    docker-compose down\ndocker-compose rm\n
    • Can't remember where you downloaded it? Ok. We can deal with that!

    Let's stop the containers gracefully first, run:

    docker stop esmero-web\ndocker stop esmero-solr\ndocker stop esmero-db\ndocker stop esmero-cantaloupe\ndocker stop esmero-php\ndocker stop esmero-minio\ndocker stop esmero-nlp\n

    Now we need to remove them so we run the following:

    docker rm esmero-web\ndocker rm esmero-solr\ndocker rm esmero-db\ndocker rm esmero-cantaloupe\ndocker rm esmero-php\ndocker rm esmero-minio\ndocker rm esmero-nlp\n

    Ok, now we are ready to start.

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#step-1-deployment","title":"Step 1: Deployment","text":"","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#prefer-to-watch-a-video-to-see-what-its-like-to-install-go-to-our-user-contributed-documentation1","title":"Prefer to watch a video to see what it's like to install? Go to our user contributed documentation[^1]!","text":"","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#important","title":"IMPORTANT","text":"

    If you run docker-compose as root user (using sudo) some enviromental variables, like the current folder used inside the docker-compose.yml to mount the Volumes, will not work and you will see a bunch of errors.

    There are two possible solutions.

    • The best is to add your user to the docker group (so no sudo needed).
    • The second option is to replace every {$PWD} inside your docker-compose.yml with either the full path to your current folder, or with a . and wrap that whole line in double quotes, basically making the paths for volumes relatives.

    Instead of: - ${PWD}:/var/www/html:cached use: - \".:/var/www/html:cached\"

    Now that you got it, let's deploy:

    git clone https://github.com/esmero/archipelago-deployment.git archipelago-deployment\ncd archipelago-deployment\ngit checkout 1.3.0\n
    cp docker-compose-linux.yml docker-compose.yml\ndocker-compose pull\ndocker-compose up -d\n

    Note: docker-compose.yml is git ignored in case you make local adjustments or changes to it.

    You need to make sure Docker can read/write to your local Drive, a.k.a mounted volumes (especially if you decided not to run it as root because we told you so!).

    This means in practice running:

    sudo chown -R 8183:8183 persistent/iiifcache\nsudo chown -R 8983:8983 persistent/solrcore\n

    And then:

    docker exec -ti esmero-php bash -c \"chown -R www-data:www-data private\"\n

    Question: Why is this last command different? Answer: Just a variation. The long answer is that the internal www-data user in that container (Alpine Linux) has uid:82, but on Ubuntu the www-data user has a different one so we let Docker assign the uid from inside instead. In practice you could also run directly sudo chown -R 82:82 private which would only apply to an Alpine use case, which can differ in the future! Does this make sense? No worries if not.

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#step-2-set-up-your-minio-s3-bucket","title":"Step 2: Set up your Minio S3 bucket","text":"

    Once all containers are up and running (you can do a docker ps to check), access http://localhost:9001 using your most loved Web Browser with the following credentials:

    user:minio\npass:minio123\n

    and create a bucket named \"archipelago\". To do so go to the Buckets section in the navigation pane, and click Create Bucket +. Type archipelago under Bucket Name and submit, done! That is where we will persist all your Files and also your File copies of each Digital Object. You can always go there and explore what Archipelago (well really Strawberryfield does the hard work) has persisted so you can get comfortable with our architecture.

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#step-3-deploy-drupal-10-and-the-awesome-archipelago-modules","title":"Step 3: Deploy Drupal 10 and the awesome Archipelago Modules","text":"

    The following will run composer inside the esmero-php container to download all dependencies and Drupal Core too.

    docker exec -ti esmero-php bash -c \"composer install\"\n

    You might see a warning: Do not run Composer as root/super user! See https://getcomposer.org/root for details and the a long list of PHP packages. Don't worry. All is good here. Keep following the instructions! Once that command finishes run our setup script:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/setup.sh'\n

    Explanation: That script will append some important configurations to your local web/sites/default/settings.php.

    Note: We say local because your whole Drupal web root (the one you cloned) is also mounted inside the esmero-php and esmero-web containers. So edits to PHP files, for example, can be done without accessing the container directly from your local folder.

    If this is the first time you're deploying Drupal using the provided Configurations run:

    docker exec -ti -u www-data esmero-php bash -c \"cd web;../vendor/bin/drush -y si --verbose --existing-config --db-url=mysql://root:esmerodb@esmero-db/drupal --account-name=admin --account-pass=archipelago -r=/var/www/html/web --sites-subdir=default --notify=false;drush cr;chown -R www-data:www-data sites;\"\n

    Note: You will see these warnings:

    [warning] The \"block_content:9aa72fb1-2817-44a7-8fb5-a3eb51166e83\" was not found [warning] The \"block_content:1cdf7155-eb60-4f27-9e5e-64fffe93127a\" was not found [warning] The \"facets_summary_block:advance\" was not found [warning] The \"facets_summary_block:search_page_facet_summary\" was not found

    Nothing to worry about. We will provide the missing part in Step 5.

    Note 2: Please be patient. This step takes now 25-30% longer because of how the most recent Drupal Installation code fetches translations and other resources (see Performed install task). This means progress might look like getting \"stuck\", go and get a coffee/tea and let it run to the end.

    Once finished, this will give you an admin Drupal user with archipelago as password (change this if running on a public instance!) and also set the right Docker Container owner for your Drupal installation files.

    Final note about Steps 2-3: You don't need to, nor should you do this more than once. You can destroy/stop/update, recreate your Docker containers, and start again (git pull), and your Drupal and Data will persist once you've passed the Installation complete message. I repeat, all other containers' data is persisted inside the persistent/ folder contained in this cloned git repository. Drupal and all its code is visible, editable, and stable inside your web/ folder.

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#step-4-create-a-demo-and-a-jsonapi-user-using-drush-and-assign-your-admin-user-the-administrator-role","title":"Step 4: Create a \"demo \"and a \"jsonapi\" user using drush and assign your \"admin\" user the Administrator Role.","text":"

    docker exec -ti esmero-php bash -c 'drush ucrt demo --password=\"demo\"; drush urol metadata_pro \"demo\"'\n
    docker exec -ti esmero-php bash -c 'drush ucrt jsonapi --password=\"jsonapi\"; drush urol metadata_api \"jsonapi\"'\n
    docker exec -ti esmero-php bash -c 'drush urol administrator \"admin\"'\n

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#step-5-ingest-some-metadata-displays-to-make-playing-much-more-interactive","title":"Step 5: Ingest some Metadata Displays to make playing much more interactive","text":"

    Archipelago is more fun without having to start writing Metadata Displays (in Twig) before you know what they actually are. Since you should now have a jsonapi user and jsonapi should be enabled, you can use that awesome functionality of D8 to get that done. We have 4 demo Metadata Display Entities that go well with the demo Webform we provided. To do that execute in your shell (copy and paste):

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    You are done! Open your most loved Web Browser and point it to http://localhost:8001

    Note: It can take some time to start the first time (Drupal needs some warming up). The Ubuntu deployment is WAY faster than the OSX deployment because of the way the bind mount volumes are handled by the driver. Our experience is that Archipelago basically reacts instantly!

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#step-6-optional-but-more-fun-if-you-add-content","title":"Step 6: Optional but more fun if you add content","text":"

    One-Step Demo content ingest

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#need-help-blue-screen-missed-a-step-need-a-hug","title":"Need help? Blue Screen? Missed a step? Need a hug?","text":"

    If you see any issues or errors or need help with a step, please let us know (ASAP!). You can either open an issue in this repository or use the Google Group. We are here to help.

    If you like this, let us know!

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#user-contributed-documentation-a-video1","title":"User contributed documentation (A Video!)[^1]:","text":"

    Installing Archipelago on AWS Ubuntu by Zach Spalding: https://youtu.be/RBy7UMxSmyQ

    [^1]: You may find this user contributed tutorial video, which was created for an earlier Archipelago release, to be helpful. Please note that there are significant differences between the executed steps and that you need to follow the current release instructions in order to have a successful deployment.

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Sherrick
    • Giancarlo Birello
    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/","title":"Installing Archipelago Drupal 9 on Windows 10/11","text":"","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#prerequisites","title":"Prerequisites","text":"
    • Windows 11 64-bit: Home or Pro version 21H2 or higher, or Enterprise or Education version 21H2 or higher (see Docker for Windows link below).
    • Windows 10 64-bit: Home or Pro 21H1 (build 19043) or higher, or Enterprise or Education 20H2 (build 19042) or higher (see Docker for Windows link below).
    • Install Ubuntu on WSL 2
    • Install Docker for Windows
    • Install Github for Desktop
    • At least 10 Gbytes of free space (to get started)
    • Some basic Unix/Terminal Skills
    • 4 Gbytes of RAM (8 Recommended)
    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#optional","title":"Optional","text":"
    • Install Github Desktop. Ubuntu comes with Git by default, but for a more full-featured way to work with Github, you can install this application.

    Open the Docker Desktop app. The Docker service should start up automatically with a status showing when the service is up and running.

    Open an Ubuntu Terminal session (type Ubuntu in the Windows Start menu).

    Bring everything up to date: sudo apt update && sudo apt upgrade -y

    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#deployment","title":"Deployment","text":"

    Follow the steps for deployment in Ubuntu.

    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#acknowledgment","title":"Acknowledgment","text":"

    Thanks to Corinne Chatnik for documenting these steps!

    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#need-help-blue-screen-missed-a-step-need-a-hug","title":"Need help? Blue Screen? Missed a step? Need a hug?","text":"

    If you see any issues or errors or need help with a step, please let us know (ASAP!). You can either open an issue in this repository or use the Google Group. We are here to help.

    If you like this, let us know!

    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Lund
    • Giancarlo Birello
    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"createdisplaymodes/","title":"Creating Display Modes for Archipelago Digital Objects","text":"

    We recommend checking out our primer on Display Modes for a broader overview on Form Modes and View Modes for Archipelago Digital Objects (ADOs).

    But how do you create and enable these Display Modes in the first place? Let's find out.

    "},{"location":"createdisplaymodes/#adding-a-new-form-mode","title":"Adding a new Form Mode","text":"

    Why would you want to create a new form mode? One common reason is to create different data entry experiences for users with different roles. Let's create an example form mode called \"Student Webform\" -- we can imagine a deployment where Students need a simplified form for ADO creation. We are going to create a form mode, enable it for Digital Objects, and give it some custom settings that differentiate it from existing form modes.

    1. Navigate to yoursite/admin/structure/display-modes

    2. Click on Form modes. This image shows the basic Form Modes shipped with Archipelago

    3. Click the \"Add Form mode\" button at the top of the page. Then select the \"Content\" entity type from the list. In this example, we ultimately want the form mode to be applied to Archipelago Digital Objects, which is a Content entity type.

    4. Enter the name of your Form Mode and hit save. Here we are entering \"Student Webform\".

    5. Great. Now you will see your new Form mode in the list! Let's put it to use.

    6. Head to yoursite/admin/structure/types/manage/digital_object and click the \"Manage Form Display\" tab. As mentioned above, in this example we want to add a new Form Mode for ADOs, so we are dealing with the Digital Object content type. Scroll to the bottom of this page and look for the \"Custom Display Settings\" area, which is collapsed by default. Expand it, and you should see this.

    7. Enable \"Student Webform\" and hit save! Now scroll back up the page. You'll see it enabled like so.

    8. Now select our new \"Student Webform\" tab. From here, you have many options and can configure input fields as you see fit! To finish out our specific example though, let's finally add our Student Webform to the display. Click on the settings gear icon next to the Descriptive Metadata field.

      You'll see that the default webform named \"Descriptive Metadata\" is entered. To add custom content to this Field Widget, start typing in the autocomplete. This example assumes you've created a webform called Student Webform in yoursite/admin/structure/webform. For info on how to create a new Webform with proper settings, see our Webforms as input guide.

    9. After you've selected your \"Student Webform\" in the Field Widget setting, hit Update, and then Save at the bottom of the page.

    All done! So let's recap. We created a new form mode. We added this form mode to the Manage Form Display > Custom Display Settings options for Digital Objects. And finally we configured the Field Widget for Descriptive Metadata in our new Form Mode to use a new Webform. This last step is arbitrary to this example. We could have enabled or disabled fields, or changed other field widget settings depending on our needs. But configuring different Webforms as Field Widgets for Descriptive Metadata is a common use case in Archipelago.

    Thanks for reading this far! But there is more. We might want to display, in addition to ingest, our ADOs in custom ways. The process for creating new View Modes (the other type of Display Mode) is quite similar to creating new Form Modes, but let's walk through it with another example case.

    "},{"location":"createdisplaymodes/#adding-a-new-view-mode","title":"Adding a new View Mode","text":"

    Why would you want to create a new View Mode? Maybe there is a new type of media you are attaching to ADOs that you want to display using the proper player or tool. Or maybe you want to simplify the ADO display, removing fields from the display page. In this example let's create a new View Mode for ADOs that adds some fields to the display to show the Author and Published date of the object.

    1. Navigate to yoursite/admin/structure/display-modes

    2. Select View modes, and click the \"Add View mode\" at the top of the page.

    3. Select Content as your entity type.

    4. Enter the name of your new View Mode and save. Ours is \"Digital Object with Publishing Information\"

    5. Now let's enable this View mode. Go to yoursite/admin/structure/types/manage/digital_object and click the \"Manage Display\" tab.

    6. Scroll to the bottom of the page and expand the \"Custom Display Settings\" area. You will see our newly created View Mode. Enable it and hit save.

    7. Now scroll back to the page top. You will see \"Digital Object with Publishing Information\" in the list of View Modes, so go ahead and select it.

    8. Scroll down until you see the \"Disabled\" section. This section contains fields that are available to the ADO content type, but are not enabled in this display mode. Let's enable Author and Post date by changing the \"Region\" column dropdown from \"Disabled\" to \"Content\". (To learn more about Regions in Drupal, see here). Basically, this ensures that this field has a home in the page layout. Hit save.

    9. Now, if you want ADOs to use this View Mode for display, there is one last step. You need to select \"Digital Object with Publishing Info\" as the view mode Display Settings when adding new content. This area is located on the right side of the page. See below:

    10. Now, when we view the individual ADO, these new fields have been added to the display.

    All done! This was quite a simple example, but now you are aware of how to customize your own ADO display. It can only get more complex and exciting from here.

    Let's recap. We created a new View Mode. We enabled this View Mode in Manage Display > Custom Display Settings for Digital Objects. We enabled new fields (in this case, just for instruction, the Author and Post date fields) to make our new View Mode unique, and learned about Disabled fields in the process. We selected our new View Mode in the Display Settings area (slightly confusing wording because yes, this is a View Mode, subset of Display Mode) during ADO creation (for more on creating new objects, see this guide).

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"customwebformelements/","title":"Archipelago Custom Webform Elements","text":"

    In addition to the core elements provided by the Drupal Webform module, Archipelago also deploys a robust set of custom webform elements specific to digital repositories metadata needs and use cases.

    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#linked-data","title":"Linked Data:","text":"

    (*found under Composite Elements in \"Add Element\" menu)

    • Library of Congress (LoC) Linked Open data

      • Provides a form element to reconciliate against LoC Headings and similar LoD Sources
      • Able to configure which LoC Autocomplete Source Provider is used:
        • Subjects (LCSH)
        • LC Name Authority File (LCNAF)
        • LC Genre/Form Terms (LCGFT
        • Thesaurus of Graphic Materials (TGN)
        • MARC list for Geographic areas
        • Filter Suggest results by RDF Type
          • Any of the Classes listed here: https://id.loc.gov/ontologies/madsrdf/v1.html

    • Multi LoD Source Agent Items

      • Provides a form element to reconciliate Agents against Multiple sources of Agents

    • Wikidata

      • Provides a form element to reconciliate against Wikidata Items and Agents
        • via Wikidata Action API

    • Getty Vocabulary Term

      • Provides a form element to reconciliate against the Getty Vocabularies

    • VIAF

      • Provides a form element to reconciliate against VIAF (OCLC) Items

    • Location GEOJSON (Nominatim--Open Street Maps)

      • Provides a form element to collect valid location information (address, longitude, latitude, geolocation) using Nominatim/Openstreetmap open API

    • PubMed MeSH Suggest

      • Provides a form element to reconciliate against PubMed MeSH

    • SNAC Constellation Linked Open Data

      • Provides a form element to reconciliate against Social Networks and Archival Context (SNAC)

    • Europeana Entity Suggest

      • Provides a form element to reconciliate against Europeana Entity
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#file-upload-elements","title":"File Upload Elements:","text":"

    • Enhancements for Audio, Document, Image, Video file uploads

      • Backend processing for technical metadata (such as pronom, exif extraction)

    • Import Metadata from a File (such as XML)

      • Provides a form element for uploading, saving a file and parsing the content as metadata/webform submission data.

    • Import Metadata in CSV format from a File

      • Provides a form element for uploading, saving a file and parsing the content as metadata/webform submission data.
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#datetime-elements","title":"Date/Time Elements:","text":"
    • Multi Format Date and Date Range
      • Provides a form element for setting/reading Dates indifferent formats suitable for metadata.
      • Optional EDTF Validation.
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#composite-elements","title":"Composite Elements:","text":"
    • Panorama Tour Builder
      • Provides a form element to build multi-scene Panorama Tour Builder with hotspots
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#computed-elements","title":"Computed Elements:","text":"

    • Computed Metadata Transplant

      • Provides an item that takes source values (not only elements) and distributes them into other places/elements via a twig template

    • Computed Token

      • Provides an item to display computed webform submission values using tokens.

    • Computed Twig

      • Provides an item to display computed webform submission values using Twig
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#but-wait-theres-more","title":"But wait there's more!","text":"

    You can review the coding behind these custom elements here: https://github.com/esmero/webform_strawberryfield/tree/1.1.0/src/Element

    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"devops/","title":"Archipelago Software Services","text":"

    At the core of the Archipelago philosophy is our commitment to both simplicity and flexibility.

    "},{"location":"devops/#under-the-hood-archipelagos-architecture-is","title":"Under the hood, Archipelago's architecture is:","text":"
    • Drupal (CMS)
    • Solr (Search)
    • Cantaloupe (Image Server)
    • S3 Storage (Mini.io or any other S3 flavor)

    Installation is entirely Dockerized and scripted with easy-to-follow directions.

    • Docker containers are as follows:
    Container Purpose Description esmero-web NGNIX Routes calls to esmero-php esmero-php PHP-FPM Has all binaries for postprocessing/exif/ocr/etc. Runs PHP code. esmero-db Database AMD and INTEL processors: MYSQL 8ARM processors: MariaDB esmero-minio Storage S3 API compatible Backend file and ADO as file storage. In a local it will do all the S3 stuff, on a live instance it can server as file routing to AWS S3, Azure Blob Storage, etc. esmero-solr Solr Currently version 8.8.2 esmero-nlp Natural Language Processing NLP64 server for entity extraction, language detection, etc.

    Information related to non-Dockerized installation and configruation can be found here: Traditional Installation Notes

    "},{"location":"devops/#strawberryfield-modules-at-the-heart-of-every-archipelago","title":"Strawberryfield Modules at the heart of every Archipelago:","text":"
    • Strawberryfield
    • Format Strawberryfield
    • Webform Strawberryfield
    • Strawberry Runners
    • Archipelago Multi-Importer (AMI)

    Documentation related to the Strawberryfield modules can be found here: Strawberryfields Forever

    "},{"location":"devops/#archipelago-also-extends-these-powerful-tools","title":"Archipelago also extends these powerful tools:","text":"
    • Annotorius
    • Drupal Webform Module
    • International Image Interoperability Framework (IIIF)
    • Internet Archive BookReader
    • Mirador
    • Pannellum
    • Replayweb.page Webarchive Player
    • Solr OCR Highlighting
    • Twig Templating In Symfony / In Drupal

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"documentation_about/","title":"About This Documentation","text":"

    Documentation is vital to our community, and contributions are welcome, greatly appreciated, and encouraged.

    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_about/#how-to-contribute","title":"How to Contribute","text":"

    Difficulty Level: Moderate\u2013Difficult

    1. Follow the GitHub Workflow.
    2. Check out the examples of additional features.
    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_features/","title":"Additional Documentation Features","text":"

    Below are some examples of features that are currently in use on the site. To explore more visit the Material for MkDocs documentation.

    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_features/#examples","title":"Examples","text":"","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_features/#images","title":"Images","text":"

    Images are located in the docs/images folder. You can add new ones there and link to them by relative path. For example, if you added strawberries_color.png, you would embed it like so:

    Image

    MarkupResult 
    ![New Documentation Image](images/strawberries_color.png)\n

    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_features/#admonitions","title":"Admonitions","text":"

    Question Admonition

    MarkupResult 
    ??? question \"What is a collapsible admonition?\"\n\n    This is a collapsible admonition. It can have a title, and it collapses so as not to interrupt the flow the of the document, but it provides useful information as needed.\n
    What is a collapsible admonition?

    This is a collapsible admonition. It can have a title, and it collapses so as not to interrupt the flow the of the document, but it provides useful information as needed.

    You can read more about admonitions with further examples in the Material for MkDocs documentation.

    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_features/#code-blocks","title":"Code blocks","text":"

    Code block with title and highlighted lines

    MarkupResult 
    ```html+twig title=\"HTML in a TWIG template\" hl_lines=\"8 9 10\"\n{% for image in attribute(data, 'as:image')|slice(0,1) %}\n {% if image[\"flv:exif\"] %}\n   {% set height = image[\"flv:exif\"].ImageHeight%}\n {% else  %}\n   {% set width = 1200 %}\n {% endif %}\n   {% set imageurl =  IIIFserverurl ~ image['url']|replace({'s3://':''})|replace({'private://':''})|url_encode %}\n<a href=\"{{ nodeurl }}\" title=\"{{ data.label }}\" alt=\"{{ data.label }}\">\n<img src=\"{{ imageurl }}/pct:5,5,90,30/,400/0/default.jpg\" class=\"d-block.w-auto\" alt=\"{{ image.name }}\" height=\"400px\" style=\"min-width:1200px\">\n</a> \n{% endfor %}\n```\n
    HTML in a TWIG template
    {% for image in attribute(data, 'as:image')|slice(0,1) %}\n {% if image[\"flv:exif\"] %}\n   {% set height = image[\"flv:exif\"].ImageHeight%}\n {% else  %}\n   {% set width = 1200 %}\n {% endif %}\n   {% set imageurl =  IIIFserverurl ~ image['url']|replace({'s3://':''})|replace({'private://':''})|url_encode %}\n<a href=\"{{ nodeurl }}\" title=\"{{ data.label }}\" alt=\"{{ data.label }}\">\n<img src=\"{{ imageurl }}/pct:5,5,90,30/,400/0/default.jpg\" class=\"d-block.w-auto\" alt=\"{{ image.name }}\" height=\"400px\" style=\"min-width:1200px\">\n</a> \n{% endfor %}\n
    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_features/#quirks","title":"Quirks","text":"

    Because of the use of front matter (the block of YAML at the top that contains settings and data for the file) the markup for a horizontal rule is restricted. To create one you have to use the following:

    Horizontal Rule

    MarkupResult 
    ___\n

    Info

    The above are underscore (_) characters, as opposed to hyphens (-).

    Some of the documentation that is automatically deployed from the repos have special comments that are converted to theme-specific elements via script.

    Front Matter

    Deployment Repo with Front MatterDocumentation Repo with Front Matter 
    <!--documentation\n---\ntitle: \"Adding Demo Archipelago Digital Objects (ADOs) to your Repository\"\ntags:\n  - Archipelago Digital Objects\n  - Demo Content\n---\ndocumentation-->\n
    ---\ntitle: \"Adding Demo Archipelago Digital Objects (ADOs) to your Repository\"\ntags:\n  - Archipelago Digital Objects\n  - Demo Content\n---\n

    Switching Elements

    Deployment Repo with Theme-specific MarkupDocumentation Repo with Theme-specific Markup 
    <!--switch_below\n\n??? info \"OSX (macOS)/x86-64\"\n\n    ```shell\n    cp docker-compose-osx.yml docker-compose.yml\n    ```\n\n??? info \"Linux/x86-64/AMD64\"\n\n    ```shell\n    cp docker-compose-linux.yml docker-compose.yml\n    ```\n\n??? info \"OSX (macOS)/Linux/ARM64\"\n\n    ```shell\n    cp docker-compose-arm64.yml docker-compose.yml\n    ```\n\nswitch_below-->\n\n___\n\nOSX (macOS)/x86-64:\n\n```shell\ncp docker-compose-osx.yml docker-compose.yml\n```\n\n___\n\nLinux/x86-64/AMD64:\n\n```shell\ncp docker-compose-linux.yml docker-compose.yml\n```\n\n___\n\nOSX (macOS)/Linux/ARM64:\n\n```shell\ncp docker-compose-arm64.yml docker-compose.yml\n```\n\n___\n\n<!--switch_above\nswitch_above-->\n
    ??? info \"OSX (macOS)/x86-64\"\n\n    ```shell\n    cp docker-compose-osx.yml docker-compose.yml\n    ```\n\n??? info \"Linux/x86-64/AMD64\"\n\n    ```shell\n    cp docker-compose-linux.yml docker-compose.yml\n    ```\n\n??? info \"OSX (macOS)/Linux/ARM64\"\n\n    ```shell\n    cp docker-compose-arm64.yml docker-compose.yml\n    ```\n\n<!--repo_docs\n\n___\n\nOSX (macOS)/x86-64:\n\n```shell\ncp docker-compose-osx.yml docker-compose.yml\n```\n\n___\n\nLinux/x86-64/AMD64:\n\n```shell\ncp docker-compose-linux.yml docker-compose.yml\n```\n\n___\n\nOSX (macOS)/Linux/ARM64:\n\n```shell\ncp docker-compose-arm64.yml docker-compose.yml\n```\n\n___\n\nrepo_docs-->\n
    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_technical/","title":"Documentation Technical Details","text":"

    Archipelago documentation is generated using the following open source projects:

    • MkDocs generates the static site
    • Material for MkDocs provides the site's theme
    • mike generates the routing for versions
    • Github Actions builds and deploys the files to Github Pages

    To use any advanced features not mentioned in these pages, you can look through the documentation for each of the above projects.

    In addition to the pages added directly via this repository, there are some pages automatically deployed here with GitHub Actions from the following repositories:

    • https://github.com/esmero/archipelago-deployment
    • https://github.com/esmero/archipelago-deployment-live

    Both the main READMEs and documentation in the docs folders for those repositories are prepended with archipelago-deployment and archipelago-deployment-live respectively and copied to the docs folder here with the rest of the documentation. In practice that means those pieces of documentation need to be edited in those repositories directly.

    ","tags":["Documentation"]},{"location":"documentation_template/","title":"Example Documentation Page Title","text":"

    A brief overview of the specific functionality or workflow area that will be covered in your documentation.

    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_template/#stepsguides","title":"Steps/Guides","text":"
    1. Step one example.

    2. Step two example with images:

    3. Step three example with Details section:

      Click to open this Details Section

      More Details in a List

      • Apples
      • Oranges
      • Peaches
      • Pumpkins

    4. Step four example with a simple code block:

      {% for image in attribute(data, 'as:image')|slice(0,1) %}\n {% if image[\"flv:exif\"] %}\n   {% set height = image[\"flv:exif\"].ImageHeight%}\n {% else  %}\n   {% set width = 1200 %}\n {% endif %}\n   {% set imageurl =  IIIFserverurl ~ image['url']|replace({'s3://':''})|replace({'private://':''})|url_encode %}\n<a href=\"{{ nodeurl }}\" title=\"{{ data.label }}\" alt=\"{{ data.label }}\">\n<img src=\"{{ imageurl }}/pct:5,5,90,30/,400/0/default.jpg\" class=\"d-block.w-auto\" alt=\"{{ image.name }}\" height=\"400px\" style=\"min-width:1200px\">\n</a> \n{% endfor %}\n

    5. Step five example with a code block that has a title and highlighted lines:

      HTML in a TWIG template
      {% for image in attribute(data, 'as:image')|slice(0,1) %}\n {% if image[\"flv:exif\"] %}\n   {% set height = image[\"flv:exif\"].ImageHeight%}\n {% else  %}\n   {% set width = 1200 %}\n {% endif %}\n   {% set imageurl =  IIIFserverurl ~ image['url']|replace({'s3://':''})|replace({'private://':''})|url_encode %}\n<a href=\"{{ nodeurl }}\" title=\"{{ data.label }}\" alt=\"{{ data.label }}\">\n<img src=\"{{ imageurl }}/pct:5,5,90,30/,400/0/default.jpg\" class=\"d-block.w-auto\" alt=\"{{ image.name }}\" height=\"400px\" style=\"min-width:1200px\">\n</a> \n{% endfor %}\n

    6. Last Step Example.

    Congratulations! \ud83c\udf89

    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_workflow/","title":"GitHub Workflow","text":"
    1. Find an issue to resolve or create a new issue here.
    2. Fork the documentation repo. If you're not familiar with forking see this guide.
    3. Create an issue branch in your forked repo. For example, if the issue you're resolving is ISSUE-100: 
      git checkout -b ISSUE-100\n
    4. Copy this template to create a new piece of documentation: 
      cp docs/documentation_template.md docs/new_documentation.md\n
    5. Make your changes to the copied markdown file.
    6. If this is new documentation add it to the nav section of the mkdocs.yml configuration file at the root of the repo. For example: 
      nav:\n  - Home: index.md\n  - About Archipelago:\n    - Archipelago's Philosophy & Guiding Principles: ourtake.md\n    - Strawberryfields Forever: strawberryfields.md\n    - Software Services: devops.md\n    - New Documentation: new_documentation.md\n  - Code of Conduct: CODE_OF_CONDUCT.md\n  - Instructions and Guides:\n    - Archipelago-Deployment:\n      - Start: archipelago-deployment-readme.md\n      - Installing Archipelago Drupal 9 on OSX (macOS): archipelago-deployment-osx.md\n      - Installing Archipelago Drupal 9 on Ubuntu 18.04 or 20.04: archipelago-deployment-ubuntu.md\n      - Installing Archipelago Drupal 9 on Windows 10/11: archipelago-deployment-windows.md\n      - Adding Demo Archipelago Digital Objects (ADOs) to your Repository: archipelago-deployment-democontent.md\n...\n

    7. To view the changes locally, first install the Python libraries using the Python package manager pip: 

      pip install mkdocs-material mike git+https://github.com/jldiaz/mkdocs-plugin-tags.git mkdocs-git-revision-date-localized-plugin mkdocs-glightbox\n
      You may need to install Python on your machine. Download Python or use your favorite operating system package manager such as Homebrew.

    8. Now you can build the site locally, e.g. for the documentation using the 1.0.0 branch: 

      mike deploy 1.0.0\nmike set-default 1.0.0\n
      If you create a new branch to match the issue number as in step 3, you would use your branch instead of 1.0.0. For example, a branch of ISSUE-129. 
      mike deploy ISSUE-129\nmike set-default ISSUE-129\n

    9. Start the web server: 
      mike serve\n
    10. Check the results in your browser by going to: http://localhost:8000
    11. If everything looks good, you can push to your forked repo issue branch: 
      git add .\ngit commit -m \"Create new docs with useful information.\"\ngit push origin ISSUE-100\n
    12. Create a pull request and link to the issue by tagging it, e.g. Resolves #100.
    ","tags":["Documentation","Contributing","Examples"]},{"location":"drupal_core_update/","title":"Updating Drupal Core in Archipelago","text":"

    Drupal, the project, puts out new core releases on a regular schedule. Your Archipelago site needs to apply the security updates and possibly minor releases between major core updates. Major core updates will typically coincide with an updated Archipelago stable release.

    Updating core is done via Composer:

    ","tags":["Archipelago-deployment","Archipelago-deployment-live","DevOps","Drupal","Drupal Core"]},{"location":"drupal_core_update/#stepsguides","title":"Steps/Guides","text":"
    1. First you will want to verify Drupal Core will update itself and the dependencies. To do so, you run the following command: 
      docker exec -ti esmero-php bash -c \"composer update \"drupal/core-*:^9\" --with-all-dependencies --dry-run\n
      The --dry-run flag will allow you to see what will be updated. Once you review the updates and are ready to go with the full update, you will run the same command without the dry-run flag.
    2. Update Core and the dependencies: 
      docker exec -ti esmero-php bash -c \"composer update \"drupal/core-*:^9\" --with-all-dependencies\"\n
    3. Sometimes the database needs to be updated after the update of the files. The following command will prompt you to type yes if there are updates to be done, or it will not return anything if no updates are needed: 
      docker exec -ti esmero-php bash -c \"drush updatedb\"\n
    4. Clear the Drupal cache: 
      docker exec -ti esmero-php bash -c \"drush cache:rebuild\"\n
      Occasionally there will be other Drupal modules that Archipelago uses, and they need to be updated at the same time you run a Core update. This is an example of updating Drupal Webform, which was required for moving to Drupal 9.5.x:

    Updating a Drupal module

    1. Use Composer to update a module to a specific release: 
      docker exec -ti esmero-php bash -c \"composer update \"drupal/webform:6.1.4\n
    2. Check for database updates and apply them if necessary: 
      docker exec -ti esmero-php bash -c \"drush updatedb\"\n
      or 
      docker exec -ti esmero-php bash -c \"drush updb\"\n
    3. Clear the cache again: 
      docker exec -ti esmero-php bash -c \"drush cache:rebuild\"\n
      or 
      docker exec -ti esmero-php bash -c \"drush cr\"\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live","DevOps","Drupal","Drupal Core"]},{"location":"find_and_replace/","title":"Advanced Batch Find and Replace","text":"

    Archipelago's Advanced Batch Find and Replace functionality provides different ways for you to efficiently Find/Search and Replace metadata values found in the raw JSON of your Digital Objects and Collections. Advanced Batch Find and Replace makes use of customized Actions that extend Drupal's VBO module to enable these powerful batch metadata replacement Actions in your Archipelago environment.

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#where-to-find","title":"Where to Find","text":"

    In default Archipelagos, you can find Advanced Batch Find and Replace:

    • Through the Tools menu > Advanced Batch Find and Replace
    • Directly at /search-and-replace

    Site Administrator Note
    • The View driving this can be found at /admin/structure/views/view/solr_search_content_with_find_and_replace. The default Facets referenced above can be found at /admin/structure/block/list/archipelago_subtheme in the Sidebar Second section. Please proceed with caution if making any changes to the default configurations for this View or the Facets referenced on this View Page.
    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#main-page-overview","title":"Main Page Overview","text":"

    From the main page (display title 'Search and Replace'), you will see:

    • A Fulltext Search box
    • Dropdown list of available Actions
    • Listing of all the Digital Objects and Collections found in your Archipelago repository
      • Option to Select/deselect all results in this view (all pages) via toggle switch
      • Same toggle switch option beside each individual Object/Collection to select one-at-a-time
      • Expandable \u25ba Raw Metadata (JSON) section beneath each each individual Object/Collection containing the full Raw JSON metadata record for reference
    • Expandable section to show all the Selected items in this view (will be 0 items to start).
      • Individual selections made on different results pages will be preserved in the overall total of Selected items available for preview on this main/top page.

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#default-facets-configured","title":"Default Facets Configured","text":"

    You will also see a listing of a few different default Facets configured to help guide your selection of potential Digital Objects/Collections:

    • Object Type
      • the Archipelago Digital Object/Collection Type
      • JSON key: type
    • JSON keys in your metadata
      • all of the potential JSON keys that are present in your repository
      • includes 'flattened' keys that may not be readily accessible via Webform elements (such as Archipelago-generated technical and administrative keys)
    • Ingest Method Service URL
      • The URL of the Digital Object/Collection Webforms and AMI Sets present in your repository that were used to create Digital Objects/Collections.
      • Please note that using the Find and Replace Webform functionality to update ADOs will cause the original AMI Set URL identified in this Facet to be overwritten and replaced with the specified Webform used during the replacement execution.
    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#available-actions","title":"Available Actions","text":"

    The default options available through the Action dropdown menu include:

    • *Export Archipelago Digital Objects to CSV content item
    • Text based find and replace Metadata for Archipelago Digital Objects content item
    • Webform find-and-replace Metadata for Archipelago Digital Objects content item
    • JSON Patch Metadata for Archipelago Digital Objects content item
    • *Publish Digital Object
    • *Unpublish Digital Object
    • *Change the author of content
    • Trigger Strawberrry Runners process/reprocess for Archipelago Digital Objects content item
    • *Delete selected entities/translations

    * denotes Action options that are also shared with the main Content Page Action Menu You can read more about Strawberry Runners Post-Processing Actions here

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#find-and-replace-specific-actions","title":"Find and Replace Specific Actions","text":"

    After reviewing the 'Important Notes & Workflow Recommendations' below, please see the following separate pages for detailed examples walking through the usage of the three different Find and Replace specific actions.

    • Text Based Find and Replace
      • Enables you to execute simple but powerful text based search and replacement operations.
    • Webform Find and Replace
      • Enables you to search against values found within defined Webform elements to apply metadata replacements with targeted care.
    • JSON Patch Find and Replace
      • Enables you to carry out advanced JSON Patch operations within your metadata.
    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#important-notes-workflow-recommendations","title":"Important Notes & Workflow Recommendations","text":"

    Important Note

    The Actions available through Archipelago's Advanced Batch Find and Replace can potentially have repository-wide effects. It is strongly recommended that you proceed with caution when executing any of the available Actions.

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#simulation-mode","title":"Simulation Mode","text":"

    Before executing any of the available Find and Replace Actions, the best-practice workflow recommendation is to always first run in Simulation Mode:

    • Before the final 'Execute Action' step of your Find and Replace operation, select the option to '\u2611\ufe0f only simulate and debug affected JSON'. This will run a quick check against your Action specifications and the potentially impacted Digital Objects and Collections.
    • You can then double check that the total effected changes shown reflect your intended amount of changes.
      • The total number of changes will always be multipled by a factor of 2, as the Actions count a first step of checking against your data, then the second step of applying the change.
      • If your Action specifications do not match against any JSON metadata values in your specified results, you will also see that no matches were applicable.

    • Once you have reviewed the results of the Simulation Mode and confirmed the simulated results match your intentend amount of changes, proceed with executing the Action you first simulated.
    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#checking-your-changes","title":"Checking Your Changes","text":"

    After applying any of the Find and Replace Actions, you can review the specific changes that were made within the Revision history of the impacted Digital Objects and Collections.

    • Through the Find and Replace page results listing or the main Content page, navigate to the Digital Object/Collection you wish to review.
    • Open the 'Revision' tab.
    • The details for the specific Action executed will be visible. All of the Find and Replace Actions will result in slightly different operation notes within the the Revision history.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace_action_json_patch/","title":"JSON Patch Find and Replace","text":"

    Enables you to carry out advanced JSON Patch operations within your metadata.

    Note

    Please refer to the main Find and Replace documentation page for a general overview of where to find within your Archipelago, a general overview of default options and important notes and workflow recommendations.

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#what-is-a-json-patch-and-when-to-use-it","title":"What is a JSON Patch and when to use it?","text":"

    Before we dive into the mechanics of doing JSON Patching Batch in Archipelago we need to learn what a JSON Patch is and of course when applying this action is useful, possible (or not).

    A JSON Patch is a JSON Document containing precise operations that can heavily modify the structure and values of an existing JSON Document, in this case the RAW JSON found inside a strawberryfield of our ADOs.

    The operations available for modifications of an JSON document are:

    • \u201cadd\u201d
    • \u201cremove\u201d
    • \u201creplace\u201d,
    • \u201cmove\u201d
    • \u201ccopy\u201d

    And there is also one (very important) used to check/validate the existence of values/keys:

    • \u201ctest\u201d

    Even if you can have multiple operations in a single JSON Patch Document, they are always applied as a whole. Means if any of those fail nothing will be applied and in concrete, in our VBO action, no change will be done to your ADO. This in combination with the \u201ctest\u201d operation gives you a lot of safety and a way of discerning/skipping completely a complex set of operations on e.g. a failed \u201dtest\u201d.

    JSON Patch uses JSON Pointers as arguments in all of these operations to target a specific key/value of your JSON.

    Using the following JSON Snippet as example:

    \"subject_lcgft_terms\": [\n    {\n        \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/genreForms\\/gf2017027249\",\n        \"label\": \"Photographs\"\n    }\n]\n

    These JSON Pointers will resolve in the following manner:

    • /subject_lcgft_terms 
    [\n    {\n        \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/genreForms\\/gf2017027249\",\n        \"label\": \"Photographs\"\n    }\n]\n
    • /subject_lcgft_terms/0
    {\n    \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/genreForms\\/gf2017027249\",\n    \"label\": \"Photographs\"\n}\n
    • /subject_lcgft_terms/0/label
    Photographs\n

    AS you can see a JSON Pointer is very precise , allowing you to target complete structures and values but it does not allow Wildcard Operations. Means you can not \"search\" or do loosy comparissons. This very fact limits many times the use case. E.g. if you have a list of terms like this:

    \"terms\": [\n    \"term1\",\n    \"term2\",\n    \"term3\"\n]\n

    and you want to \"test\" for the existence of \"term3\" before applying a change, you would need to know exactly at what position inside the terms Array (Starting from 0) it will/should be found. And that might not be consistent across every ADO.

    So how do we use these pointers in an operation inside a JSON Patch document? Using the same fake \"terms\" JSON snippet the previously listed, operations are written like this:

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#add","title":"add","text":"
    { \"op\": \"add\", \"path\": \"/terms/0\", \"value\": \"term_another\" }\n

    This will add before the first term (in this case \"term1\" ) \"term_another\" as a value.

    At the end

    you can use a dash (-) (e.g. \"/terms/-\") instead of the numeric position of an array entry to denote that the \"value\" needs to be added at the end. This is needed specially for empty lists. You can not target 0 position on an empty array.

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#remove","title":"remove","text":"
    { \"op\": \"remove\", \"path\": \"/terms/1\"}\n

    This will remove the second term (in this case \"term2\" )

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#replace","title":"replace","text":"

    { \"op\": \"replace\", \"path\": \"/terms/1\", \"value\": \"term_again\" }\n
    This will remove the second term (in this case \"term2\" ) and put in its place \"term_again\" as a value. Basically two operationes, \u201cremove\u201c and \u201cadd \u201c in a single step

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#move","title":"move","text":"
    { \"op\": \"move\", \"from\": \"/terms\", \"path\": \"/terms_somewhere_else\"}\n

    This will copy all values inside top JSON key terms into a new top JSON key named terms_somewhere_else and remove then the old terms key.

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#copy","title":"copy","text":"
    { \"op\": \"copy\", \"from\": \"/terms\", \"path\": \"/terms_somewhere_else\"}\n

    Similar to \u201cmove\u201c, it will copy values inside top JSON key terms into a new top JSON key named terms_somewhere_else without removing then the old terms key or its content!

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#test","title":"test","text":"
    { \"op\": \"test\", \"path\": \"/terms/0\", \"value\": \"term1\"}\n

    Finally, \u201ctest\u201c will check if on position 0 of terms there is a value of \"term1\". If not, the test will fail. If a single test fails the whole JSON Patch will be cancelled. Tests can not be concatenated via OR bolean operators. So they always act individually. Two tests with one failing is a failed JSON Patch.

    There is more of course! The Complete documentation can be found here

    So. When to use JSON Patch? There are a few general rules/suggestions:

    • When you can generate one or more precise \u201ctest\u201c operations. If you need to test against data that might exists but its position is not clear, a single JSON Patch will not do the trick. That said you could run the same JSON Patch document against the same set of ADOs more than once modifying slightly the \u201ctest\u201c to cover all variations (check for value at positition 0, then again at position 1, etc)
    • When you need to use data that is already inside the JSON Document and move it around. Sometimes fixing a value, in the sense of putting a static replacement, is not what you need. Other Actions documented will allow you to replace one value with another fixed one. But JSON Patch will allow you to use existing data inside your target JSON and move it/copy it.
    • When you operate on multiple JSON Keys and can target / match complete values. You can not replace a single word inside a value via a JSON Patch. But you can apply multiple precise operations in a single pass.
    • When you need to change data types. e.g. convert a single value into an array.
    • When you need safety. The fact that a single failed \u201ctest\u201c will cancel a whole JSON Patch allows you to operate with safety and ensure the final destination will always be a JSON

    Now that we know what it is and when we should do it, we can make a small exercise. The goal:

    • For all ADO's with json key with value photograph that are member of collection with Node ID 16
      • convert the description key from a single value into an array.
      • add an extra LOD entry
      • Copy a Value into a new Key
    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#step-1-select-the-ados-to-be-modified","title":"Step 1: Select the ADOs to be Modified","text":"

    As with every other VBO action described in our documentation, start by selecting the ADOs you want to modify using the exposed Search Field(s) and/or Facets present in the Search and Replace View found at /search-and-replace .

    Once you have filtered down the list to manageable size, containing at least the ADOs you plan on modifying (but for JSON Patch operation could be more too because you can \u201ctest\u201c and match ), press either on Select / deselect all results in this view to pass all the result (this includes all pages, not only the currently visible one) or go selectively one by one by checking on the toggle found beside each ADO's title. You will see how the number in Selected 0 item in this view increases. Now press Apply to select Items. We will use for this example Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?], an ADO we provide in our DEMO sets.

    Redundant to say, Batch Actions are intended to be used when a modification needs to be applied to more than one item, implying there is a pattern. For single ADOs you can always do this faster directly via the EDIT tab.

    Keep your JSON Patches (and friends) around

    Since JSON Patching involves writing a, sometimes complex, JSON Document, please keep around an Application (or Text File) where you can copy/paste and save your JSON Patches for resuse or future references. Archipelago will not store nor remember between runs the JSON Patch document you submitted. It is also very useful to copy and have at hand the RAW JSON of one of the ADOs you plan to modify as a reference/aid while building the given JSON Patch document.

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#step-2-json-patch-metadata-for-archipelago-digital-objects-action-configuration","title":"Step 2: JSON Patch Metadata for Archipelago Digital Objects Action Configuration","text":"

    The default config JSON Patch form will contain an example JSON Patch set of Commands (Document)

    We are going to replace this one with a valid JSON document. Notice that it does not require a root {} Object wrapper and it is really a list (or array) of operations.

    A bit of repetition but needed to explain the JSON Patch document. You can see on the following Note box how we copyed the RAW JSON of one ADO to be Patched to have a reference while building the JSON PATCH. for the sake of brevity we remove here the longer Image File technical Metadata.

    RAW JSON of Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?] Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?] | before Patching
    {\n    \"note\": \"\",\n    \"type\": \"Photograph\",\n    \"viaf\": \"\",\n    \"label\": \"Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?]\",\n    \"model\": [],\n    \"owner\": \"New-York Historical Society, 170 Central Park West, New York, NY 10024, 212-873-3400.\",\n    \"audios\": [],\n    \"images\": [\n        26\n    ],\n    \"models\": [],\n    \"rights\": \"This digital image may be used for educational or scholarly purposes without restriction. Commercial and other uses of the item are prohibited without prior written permission from the New-York Historical Society. For more information, please visit the New-York Historical Society's Rights and Reproductions Department web page at [http:\\/\\/www.nyhistory.org\\/about\\/rights-reproductions](http:\\/\\/www.nyhistory.org\\/about\\/rights-reproductions).\",\n    \"videos\": [],\n    \"creator\": \"\",\n    \"ap:tasks\": {\n        \"ap:sortfiles\": \"index\"\n    },\n    \"duration\": \"\",\n    \"ispartof\": [],\n    \"language\": \"English\",\n    \"documents\": [],\n    \"edm_agent\": \"\",\n    \"publisher\": \"\",\n    \"ismemberof\": [\n        16\n    ],\n    \"creator_lod\": [\n        {\n            \"name_uri\": \"\",\n            \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/pht\",\n            \"agent_type\": \"personal\",\n            \"name_label\": \"Stonebridge, George Ehler\",\n            \"role_label\": \"Photographer\"\n        }\n    ],\n    \"description\": \"George Ehler Stonebridge (d. 1941) was an amateur photographer who lived and worked in the Bronx, New York. He left little record of himself, but an invaluable one of his surroundings and interests. Stonebridge lived at several locations in the Bronx with his wife Bella, and their three children Grace, George, and William. He worked at the Northern Gaslight Company, although the position he held is unknown. In addition to taking photographs, Stonebridge wrote poetry and prose about his love of the Bronx, his children, and in honor of military victories. Some of Stonebridge's photographs appeared in local papers. In 1898, he was an authorized reporter and photographer for the North Side News; in 1905 he was an authorized reporter for the Bronx Borough Record and Times, and probably took photographs for that paper as well. Stonebridge was fascinated with the subject of military preparedness. Training rituals and staged battles were one of his favorite photographic subjects. His 1898 poem, \\\"Remember the Maine,\\\" celebrates the United States' victory in the Spanish-American War. He was especially proud of soldiers from the Bronx, and photographed historical tablets throughout the Borough commemorating previous military victories. Stonebridge also used his photographs to illustrate lectures. In 1907, he gave several lectures on \\\"The Training of War,\\\" using colored lantern slides.\",\n    \"interviewee\": \"\",\n    \"interviewer\": \"\",\n    \"pubmed_mesh\": null,\n    \"sequence_id\": \"\",\n    \"subject_loc\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/subjects\\/sh85038796\",\n            \"label\": \"Dogs\"\n        }\n    ],\n    \"website_url\": \"\",\n    \"as:generator\": {\n        \"type\": \"Update\",\n        \"actor\": {\n            \"url\": \"http:\\/\\/localhost:8001\\/form\\/descriptive-metadata\",\n            \"name\": \"descriptive_metadata\",\n            \"type\": \"Service\"\n        },\n        \"endTime\": \"2022-12-05T09:19:37-05:00\",\n        \"summary\": \"Generator\",\n        \"@context\": \"https:\\/\\/www.w3.org\\/ns\\/activitystreams\"\n    },\n    \"date_created\": \"1910-01-01\",\n    \"issue_number\": null,\n    \"date_published\": \"\",\n    \"subjects_local\": null,\n    \"term_aat_getty\": \"\",\n    \"ap:entitymapping\": {\n        \"entity:file\": [\n            \"model\",\n            \"audios\",\n            \"images\",\n            \"videos\",\n            \"documents\",\n            \"upload_associated_warcs\"\n        ],\n        \"entity:node\": [\n            \"ispartof\",\n            \"ismemberof\"\n        ]\n    },\n    \"europeana_agents\": \"\",\n    \"europeana_places\": \"\",\n    \"local_identifier\": \"nyhs_PR066_6136\",\n    \"subject_wikidata\": [\n        {\n            \"uri\": \"http:\\/\\/www.wikidata.org\\/entity\\/Q3381576\",\n            \"label\": \"black-and-white photography\"\n        },\n        {\n            \"uri\": \"http:\\/\\/www.wikidata.org\\/entity\\/Q60\",\n            \"label\": \"New York City\"\n        }\n    ],\n    \"date_created_edtf\": \"\",\n    \"date_created_free\": null,\n    \"date_embargo_lift\": null,\n    \"physical_location\": null,\n    \"related_item_note\": null,\n    \"rights_statements\": \"In Copyright - Educational Use Permitted\",\n    \"europeana_concepts\": \"\",\n    \"geographic_location\": {\n        \"lat\": \"40.8466508\",\n        \"lng\": \"-73.8785937\",\n        \"city\": \"New York\",\n        \"state\": \"New York\",\n        \"value\": \"The Bronx, Bronx County, New York, United States\",\n        \"county\": \"\",\n        \"osm_id\": \"9691916\",\n        \"country\": \"United States\",\n        \"category\": \"boundary\",\n        \"locality\": \"\",\n        \"osm_type\": \"relation\",\n        \"postcode\": \"\",\n        \"country_code\": \"us\",\n        \"display_name\": \"The Bronx, Bronx County, New York, United States\",\n        \"neighbourhood\": \"Bronx County\",\n        \"state_district\": \"\"\n    },\n    \"note_publishinginfo\": null,\n    \"subject_lcgft_terms\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/genreForms\\/gf2017027249\",\n            \"label\": \"Photographs\"\n        }\n    ],\n    \"upload_associated_warcs\": [],\n    \"physical_description_extent\": \"\",\n    \"subject_lcnaf_personal_names\": \"\",\n    \"subject_lcnaf_corporate_names\": \"\",\n    \"subjects_local_personal_names\": \"\",\n    \"related_item_host_location_url\": null,\n    \"subject_lcnaf_geographic_names\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/names\\/n81059724\",\n            \"label\": \"Bronx (New York, N.Y.)\"\n        },\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/names\\/n79007751\",\n            \"label\": \"New York (N.Y.)\"\n        }\n    ],\n    \"related_item_host_display_label\": null,\n    \"related_item_host_local_identifier\": null,\n    \"related_item_host_title_info_title\": \"\",\n    \"related_item_host_type_of_resource\": null,\n    \"physical_description_note_condition\": null\n}\n

    Based on our own plan:

    1. Check first if of type photograph and memberof Node ID 16
    { \"op\": \"test\", \"path\": \"/type\", \"value\": \"Photograph\"},\n{ \"op\": \"test\", \"path\": \"/ismemberof\", \"value\": [16]}\n

    Notice that to be really sure we also match the data type, an array with a single value 16 of type integer (makes sense since the Operation is also a JSON and will be evaluated in the same way as the source RAW JSON). This is a precise match. if the ADO belongs to multiple Collections it will fail of course.

    1. Now we are going to convert description key from a single value into an array.
    {\"op\": \"add\",\"path\": \"/temp_description_array\",\"value\": []},\n{\"op\": \"move\",\"from\": \"/description\",\"path\": \"/temp_description_array/-\"},\n{\"op\": \"move\",\"from\": \"/temp_description_array\",\"path\": \"/description\"},\n

    This is a multi step operation. Given that JSON Patch can not \"cast\" types and depends on a given datatype to be present before, e.g. adding a new value to it, we use here a temporary key. Notice that you can not \u201cadd\u201c or \u201cmove\u201c to e.g. the position 0 because the destination array is indeed empty (that will fail). But by using the dash you can command it to put it at the end, which on an empty list is also at the beginning (we are starting to understand this!).

    1. And the extra LOD entry for wikidata, in this case the Q Item for collie (type of herding dog)
    { \"op\": \"add\", \"path\": \"/subject_wikidata/-\", \"value\": {\n        \"uri\": \"https://www.wikidata.org/wiki/Q1196071\",\n        \"label\": \"collie\"\n    }\n}\n
    1. Finally we are going to copy the geographic_location.state value and put it into subjects_local:
    {\"op\": \"remove\", \"path\": \"/subjects_local\"},\n{\"op\": \"add\", \"path\": \"/subjects_local\", \"value\": []},\n{\"op\": \"copy\", \"from\": \"/geographic_location/state\", \"path\": \"/subjects_local/-\"}\n

    Why so many operations? Because initially \"subjects_local\" had a value of null and it is not suited to generate/add to it as a multivalued key because of that. So we need to remove it first, recreate it as an empty list and then we can copy. Pro Note: you could partially rewrite this as replace operation!

    what if subjects_local has data?

    You will lose it! you can add a \u201ctest\u201c or move data instead of recreating. Many choices.

    The final JSON Patch will look like this. Copy it into the Configuration JSON Patch commands form field: 

    [\n    {\"op\": \"test\", \"path\": \"/type\", \"value\": \"Photograph\"},\n    {\"op\": \"test\", \"path\": \"/ismemberof\", \"value\": [16]},\n    {\"op\": \"add\",\"path\": \"/temp_description_array\",\"value\": []},\n    {\"op\": \"move\",\"from\": \"/description\",\"path\": \"/temp_description_array/-\"},\n    {\"op\": \"move\",\"from\": \"/temp_description_array\",\"path\": \"/description\"},\n    {\"op\": \"add\",\"path\": \"/subject_wikidata/-\",\"value\": \n        {\n        \"uri\": \"https://www.wikidata.org/wiki/Q1196071\",\n         \"label\": \"collie\"\n         }\n    },\n    {\"op\": \"remove\", \"path\": \"/subjects_local\"},\n    {\"op\": \"add\", \"path\": \"/subjects_local\", \"value\": []},\n    {\"op\": \"copy\", \"from\": \"/geographic_location/state\", \"path\": \"/subjects_local/-\"}\n]\n
    The inverse process online

    Now that you know (or are starting to understand) the manual process you can also try this online tool that allows you, based on a source and a destination JSON, generate the needed JSON Patch to mutate one JSON into the another. The logic might not be always what you need and most likely it will not take in account that you actually need to move values and will prefer to fix values to be added via an add operation

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#step-3-run-the-json-patch-action-in-simulation-mode","title":"Step 3: Run the JSON Patch Action in simulation mode","text":"

    Ready. Now check the \"only simulate and debug affected JSON\" checkbox. We want to see if we did well but not yet modify any ADOs. Press Apply button. You will get another confirmation screen. Press Execute Action.

    It will run quick (on this example) and you will redirected back on the original Drupal Views of Step 1. If your source ADO is actually the one from our Demo Collection you might see a diff, something very similar to this:

    Text based diff after a successfull Patch
    129d129 < \"description\": \"George Ehler Stonebridge (d. 1941) was an amateur photographer who lived and worked in the Bronx, New York. He left little record of himself, but an invaluable one of his surroundings and interests. Stonebridge lived at several locations in the Bronx with his wife Bella, and their three children Grace, George, and William. He worked at the Northern Gaslight Company, although the position he held is unknown. In addition to taking photographs, Stonebridge wrote poetry and prose about his love of the Bronx, his children, and in honor of military victories. Some of Stonebridge's photographs appeared in local papers. In 1898, he was an authorized reporter and photographer for the North Side News; in 1905 he was an authorized reporter for the Bronx Borough Record and Times, and probably took photographs for that paper as well. Stonebridge was fascinated with the subject of military preparedness. Training rituals and staged battles were one of his favorite photographic subjects. His 1898 poem, \\\"Remember the Maine,\\\" celebrates the United States' victory in the Spanish-American War. He was especially proud of soldiers from the Bronx, and photographed historical tablets throughout the Borough commemorating previous military victories. Stonebridge also used his photographs to illustrate lectures. In 1907, he gave several lectures on \\\"The Training of War,\\\" using colored lantern slides.\", 155d154 < \"subjects_local\": null, 182a180,183 > }, > { > \"uri\": \"https:\\/\\/www.wikidata.org\\/wiki\\/Q1196071\", > \"label\": \"collie\" 236c238,244 < \"physical_description_note_condition\": null --- > \"physical_description_note_condition\": null, > \"description\": [ > \"George Ehler Stonebridge (d. 1941) was an amateur photographer who lived and worked in the Bronx, New York. He left little record of himself, but an invaluable one of his surroundings and interests. Stonebridge lived at several locations in the Bronx with his wife Bella, and their three children Grace, George, and William. He worked at the Northern Gaslight Company, although the position he held is unknown. In addition to taking photographs, Stonebridge wrote poetry and prose about his love of the Bronx, his children, and in honor of military victories. Some of Stonebridge's photographs appeared in local papers. In 1898, he was an authorized reporter and photographer for the North Side News; in 1905 he was an authorized reporter for the Bronx Borough Record and Times, and probably took photographs for that paper as well. Stonebridge was fascinated with the subject of military preparedness. Training rituals and staged battles were one of his favorite photographic subjects. His 1898 poem, \\\"Remember the Maine,\\\" celebrates the United States' victory in the Spanish-American War. He was especially proud of soldiers from the Bronx, and photographed historical tablets throughout the Borough commemorating previous military victories. Stonebridge also used his photographs to illustrate lectures. In 1907, he gave several lectures on \\\"The Training of War,\\\" using colored lantern slides.\" > ], > \"subjects_local\": [ > \"New York\" > ]\n

    Which means your Patch would have been applied!

    In case something went wrong, e.g. any of the operations did not match your source data, you will see a WARNING like this

    Patch could not be applied for Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?]\n
    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#step-4-run-the-json-patch-action-but-for-real","title":"Step 4: Run the JSON Patch Action but for real!","text":"

    Now that actual patching. Repeat from Step 1 to Step 3 but keep \"only simulate and debug affected JSON\" unchecked and follow the steps again. You ADO will be modified and you will get almost no notifications except of an action completed notice (in soothing green). If you check Laddie's ADO RAW json (expand in the same resulting view) it will look now like this

    Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?] JSON after patching
    { \n    \"note\": \"\",\n    \"type\": \"Photograph\",\n    \"viaf\": \"\",\n    \"label\": \"Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?]\",\n    \"model\": [],\n    \"owner\": \"New-York Historical Society, 170 Central Park West, New York, NY 10024, 212-873-3400.\",\n    \"audios\": [],\n    \"images\": [\n        26\n    ],\n    \"models\": [],\n    \"rights\": \"This digital image may be used for educational or scholarly purposes without restriction. Commercial and other uses of the item are prohibited without prior written permission from the New-York Historical Society. For more information, please visit the New-York Historical Society's Rights and Reproductions Department web page at [http:\\/\\/www.nyhistory.org\\/about\\/rights-reproductions](http:\\/\\/www.nyhistory.org\\/about\\/rights-reproductions).\",\n    \"videos\": [],\n    \"creator\": \"\",\n    \"ap:tasks\": {\n        \"ap:sortfiles\": \"index\"\n    },\n    \"duration\": \"\",\n    \"ispartof\": [],\n    \"language\": \"English\",\n    \"documents\": [],\n    \"edm_agent\": \"\",\n    \"publisher\": \"\",\n    \"ismemberof\": [\n        16\n    ],\n    \"creator_lod\": [\n        {\n            \"name_uri\": \"\",\n            \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/pht\",\n            \"agent_type\": \"personal\",\n            \"name_label\": \"Stonebridge, George Ehler\",\n            \"role_label\": \"Photographer\"\n        }\n    ],\n    \"description\": [\n        \"George Ehler Stonebridge (d. 1941) was an amateur photographer who lived and worked in the Bronx, New York. He left little record of himself, but an invaluable one of his surroundings and interests. Stonebridge lived at several locations in the Bronx with his wife Bella, and their three children Grace, George, and William. He worked at the Northern Gaslight Company, although the position he held is unknown. In addition to taking photographs, Stonebridge wrote poetry and prose about his love of the Bronx, his children, and in honor of military victories. Some of Stonebridge's photographs appeared in local papers. In 1898, he was an authorized reporter and photographer for the North Side News; in 1905 he was an authorized reporter for the Bronx Borough Record and Times, and probably took photographs for that paper as well. Stonebridge was fascinated with the subject of military preparedness. Training rituals and staged battles were one of his favorite photographic subjects. His 1898 poem, \\\"Remember the Maine,\\\" celebrates the United States' victory in the Spanish-American War. He was especially proud of soldiers from the Bronx, and photographed historical tablets throughout the Borough commemorating previous military victories. Stonebridge also used his photographs to illustrate lectures. In 1907, he gave several lectures on \\\"The Training of War,\\\" using colored lantern slides.\"\n    ],\n    \"interviewee\": \"\",\n    \"interviewer\": \"\",\n    \"pubmed_mesh\": null,\n    \"sequence_id\": \"\",\n    \"subject_loc\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/subjects\\/sh85038796\",\n            \"label\": \"Dogs\"\n        }\n    ],\n    \"website_url\": \"\",\n    \"as:generator\": {\n        \"type\": \"Update\",\n        \"actor\": {\n            \"url\": \"http:\\/\\/localhost:8001\\/form\\/descriptive-metadata\",\n            \"name\": \"descriptive_metadata\",\n            \"type\": \"Service\"\n        },\n        \"endTime\": \"2022-12-05T09:19:37-05:00\",\n        \"summary\": \"Generator\",\n        \"@context\": \"https:\\/\\/www.w3.org\\/ns\\/activitystreams\"\n    },\n    \"date_created\": \"1910-01-01\",\n    \"issue_number\": null,\n    \"date_published\": \"\",\n    \"subjects_local\": [\n        \"New York\"\n    ],\n    \"term_aat_getty\": \"\",\n    \"ap:entitymapping\": {\n        \"entity:file\": [\n            \"model\",\n            \"audios\",\n            \"images\",\n            \"videos\",\n            \"documents\",\n            \"upload_associated_warcs\"\n        ],\n        \"entity:node\": [\n            \"ispartof\",\n            \"ismemberof\"\n        ]\n    },\n    \"europeana_agents\": \"\",\n    \"europeana_places\": \"\",\n    \"local_identifier\": \"nyhs_PR066_6136\",\n    \"subject_wikidata\": [\n        {\n            \"uri\": \"http:\\/\\/www.wikidata.org\\/entity\\/Q3381576\",\n            \"label\": \"black-and-white photography\"\n        },\n        {\n            \"uri\": \"http:\\/\\/www.wikidata.org\\/entity\\/Q60\",\n            \"label\": \"New York City\"\n        },\n        {\n            \"uri\": \"https:\\/\\/www.wikidata.org\\/wiki\\/Q1196071\",\n            \"label\": \"collie\"\n        }\n    ],\n    \"date_created_edtf\": \"\",\n    \"date_created_free\": null,\n    \"date_embargo_lift\": null,\n    \"physical_location\": null,\n    \"related_item_note\": null,\n    \"rights_statements\": \"In Copyright - Educational Use Permitted\",\n    \"europeana_concepts\": \"\",\n    \"geographic_location\": {\n        \"lat\": \"40.8466508\",\n        \"lng\": \"-73.8785937\",\n        \"city\": \"New York\",\n        \"state\": \"New York\",\n        \"value\": \"The Bronx, Bronx County, New York, United States\",\n        \"county\": \"\",\n        \"osm_id\": \"9691916\",\n        \"country\": \"United States\",\n        \"category\": \"boundary\",\n        \"locality\": \"\",\n        \"osm_type\": \"relation\",\n        \"postcode\": \"\",\n        \"country_code\": \"us\",\n        \"display_name\": \"The Bronx, Bronx County, New York, United States\",\n        \"neighbourhood\": \"Bronx County\",\n        \"state_district\": \"\"\n    },\n    \"note_publishinginfo\": null,\n    \"subject_lcgft_terms\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/genreForms\\/gf2017027249\",\n            \"label\": \"Photographs\"\n        }\n    ],\n    \"upload_associated_warcs\": [],\n    \"physical_description_extent\": \"\",\n    \"subject_lcnaf_personal_names\": \"\",\n    \"subject_lcnaf_corporate_names\": \"\",\n    \"subjects_local_personal_names\": \"\",\n    \"related_item_host_location_url\": null,\n    \"subject_lcnaf_geographic_names\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/names\\/n81059724\",\n            \"label\": \"Bronx (New York, N.Y.)\"\n        },\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/names\\/n79007751\",\n            \"label\": \"New York (N.Y.)\"\n        }\n    ],\n    \"related_item_host_display_label\": null,\n    \"related_item_host_local_identifier\": null,\n    \"related_item_host_title_info_title\": \"\",\n    \"related_item_host_type_of_resource\": null,\n    \"physical_description_note_condition\": null\n}\n

    That is all. Again, keep your JSON Patches safe in a text document, test/try simple things first, look for patterns, look for No-Nos that can become \"tests\" to avoid touching ADOs that do not need to be updated and always remember that the destination type (single value, array or object) of an existing Key might affect your complex logic. Happy Patching!

    Thank you for reading! Please contact us on our\u00a0Archipelago Commons Google Group\u00a0with any questions or feedback.

    Return to the main\u00a0Find and Replace documentation page\u00a0or the\u00a0Archipelago Documentation main page.

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_text/","title":"Text Based Find and Replace","text":"

    The text-based find and replace is case-sensitive and space-sensitive, and while it's the most simple of the actions, it's quite powerful. For this reason it's important to be very precise and target only what's intended. Below are a guide and some examples of use cases for this action.

    Note

    Please refer to the main Find and Replace documentation page for a general overview of where to find within your Archipelago, a general overview of default options and important notes and workflow recommendations.

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace_action_text/#step-by-step-guide","title":"Step-by-Step Guide","text":"
    1. Go to Tools > Advanced Batch Find and Replace.
    2. Identify and/or Filter the Digital Objects (ADOs) that need updates by Searching and/or using the available Facets.
    3. Either select all (includes results that appear on additional pages) by toggling Select / deselect all results (all pages, x total) or toggle the buttons for individual objects.
    4. Expand the \u25ba Raw Metadata (JSON) for some of the objects and double-check that the text being searched is only targeting what is intended and that the replacement text makes sense.
    5. Select Text based find and replace Metadata for Archipelago Digital Objects content item from the Action dropdown.
    6. If selecting objects individually, expand the Selected X items and review the list.
    7. Press the Apply to selected items button (don't worry, nothing will happen yet).
    8. Add the values for search (JSON Search String) and replace (JSON Replacement String).

    9. If you're absolutely certain about the replacement you have targeted, uncheck the 'only simulate and debug affected JSON' option and select Apply.

      only simulate and debug affected JSON

      This option, which is selected by default, will simulate the action and show the list of objects that would be affected, along with the number of modifications for each object and a total number of results processed. For each JSON key and value affected the modifications will count 2:

      1 for the deletion of the current key and value

      +

      1 for the creation of the modified key and value

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace_action_text/#use-cases-and-examples","title":"Use Cases and Examples","text":"

    Replacing a JSON key

    Use Case: A JSON key is currently singular but should be plural.

    JSON key example with empty array value
    ...\n\"myKey\": [],\n...\n
    JSON key example with array values
    ...\n\"myKey\": [\"strawberries\",\"blueberries\",\"blackberries\"],\n...\n

    Follow the steps above and use the following for the search and replace values:

    Search Value
    \"myKey\":\n
    Replace Value
    \"myKeys\":\n

    Tip

    By using quotes and the colon instead of myKey only, we avoid unintentionally replacing other instances of the text within the JSON.

    After applying the changes, we have the following key:

    JSON key example with empty array value after update
    ...\n\"myKeys\": [],\n...\n
    JSON key example with array values after update
    ...\n\"myKeys\": [\"strawberries\",\"blueberries\",\"blackberries\"],\n...\n

    Replacing a JSON value

    Use Case: After a batch ingest, it was discovered that JSON values across ADOs in multiple keys contain the same typo: Agnes Meyerhoff (two fs) instead of Agnes Meyerhof.

    JSON value example with typo
    ...\n\"creator_lod\": [\n    {\n        \"name_uri\": \"\",\n        \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/art\",\n        \"agent_type\": \"personal\",\n        \"name_label\": \"Meyerhoff, Agnes\",\n        \"role_label\": \"Artist\"\n    },\n    {\n        \"name_uri\": \"\",\n        \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/col\",\n        \"agent_type\": \"personal\",\n        \"name_label\": \"Messenger, Maria, , 1849-1937\",\n        \"role_label\": \"Collector\"\n    }\n],\n\"description\": \"Inscription on mount: \\\"Meyerhoff, Agnes \\\\ Frankfurt - a\\/M. \\\\ Inv el-lith \\\\ Painter.\\\" Inscription on verso: \\\"Agnes Meyerhoff \\\\ Frankfurt a\\/M \\\\ inv. [at?] lith. \\\\ [maker in?]\\\".\",\n...\n

    Follow the steps above and use the following for the search and replace values:

    Search Value
    Meyerhoff, Agnes\n
    Replace Value
    Meyerhof, Agnes\n

    After applying the changes, we have the following values:

    JSON values after update
    ...\n\"creator_lod\": [\n    {\n        \"name_uri\": \"\",\n        \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/art\",\n        \"agent_type\": \"personal\",\n        \"name_label\": \"Meyerhof, Agnes\",\n        \"role_label\": \"Artist\"\n    },\n    {\n        \"name_uri\": \"\",\n        \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/col\",\n        \"agent_type\": \"personal\",\n        \"name_label\": \"Messenger, Maria, , 1849-1937\",\n        \"role_label\": \"Collector\"\n    }\n],\n\"description\": \"Inscription on mount: \\\"Meyerhof, Agnes \\\\ Frankfurt - a\\/M. \\\\ Inv el-lith \\\\ Painter.\\\" Inscription on verso: \\\"Agnes Meyerhoff \\\\ Frankfurt a\\/M \\\\ inv. [at?] lith. \\\\ [maker in?]\\\".\",\n...\n

    Replacing a JSON value with escape characters

    Use Case: The URL for a website that appears in multiple keys needs to be updated from http://hubblesite.org to https://hubblesite.org.

    JSON value example with URL after update
    ...\n\"rights\": \"This digital image may be used for educational or scholarly purposes without restriction. Commercial and other uses of the item are prohibited without prior written permission from the NASA and the Space Telescope Science Institute (STScI). For more information, please visit the NASA and the Space Telescope Science Institute's Copyright web page at [http:\\/\\/hubblesite.org\\/copyright](http:\\/\\/hubblesite.org\\/copyright).\",\n...\n\"description\": \"\\\"The largest NASA Hubble Space Telescope image ever assembled, this sweeping bird\u2019s-eye view of a portion of the Andromeda galaxy (M31) is the sharpest large composite image ever taken of our galactic next-door neighbor. Though the galaxy is over 2 million light-years away, The Hubble Space Telescope is powerful enough to resolve individual stars in a 61,000-light-year-long stretch of the galaxy\u2019s pancake-shaped disk. ... The panorama is the product of the Panchromatic Hubble Andromeda Treasury (PHAT) program. Images were obtained from viewing the galaxy in near-ultraviolet, visible, and near-infrared wavelengths, using the Advanced Camera for Surveys and the Wide Field Camera 3 aboard Hubble. This cropped view shows a 48,000-light-year-long stretch of the galaxy in its natural visible-light color, as photographed with Hubble's Advanced Camera for Surveys in red and blue filters July 2010 through October 2013.\\\" -full description available at: [http:\\/\\/hubblesite.org\\/image\\/3476\\/gallery\\/73-phat](http:\\/\\/hubblesite.org\\/image\\/3476\\/gallery\\/73-phat).\",\n...\n

    Follow the steps above and use the following for the search and replace values:

    Search Value
    http://hubblesite.org\n
    Replace Value
    https://hubblesite.org\n

    Note

    You'll notice that the escape characters for the forward slash (\\/), which appear in the raw JSON, do not need to be included in the search or replace values.

    After applying the changes, we have the following values:

    JSON value example with URL after update
    ...\n\"rights\": \"This digital image may be used for educational or scholarly purposes without restriction. Commercial and other uses of the item are prohibited without prior written permission from the NASA and the Space Telescope Science Institute (STScI). For more information, please visit the NASA and the Space Telescope Science Institute's Copyright web page at [https:\\/\\/hubblesite.org\\/copyright](https:\\/\\/hubblesite.org\\/copyright).\",\n...\n\"description\": \"\\\"The largest NASA Hubble Space Telescope image ever assembled, this sweeping bird\u2019s-eye view of a portion of the Andromeda galaxy (M31) is the sharpest large composite image ever taken of our galactic next-door neighbor. Though the galaxy is over 2 million light-years away, The Hubble Space Telescope is powerful enough to resolve individual stars in a 61,000-light-year-long stretch of the galaxy\u2019s pancake-shaped disk. ... The panorama is the product of the Panchromatic Hubble Andromeda Treasury (PHAT) program. Images were obtained from viewing the galaxy in near-ultraviolet, visible, and near-infrared wavelengths, using the Advanced Camera for Surveys and the Wide Field Camera 3 aboard Hubble. This cropped view shows a 48,000-light-year-long stretch of the galaxy in its natural visible-light color, as photographed with Hubble's Advanced Camera for Surveys in red and blue filters July 2010 through October 2013.\\\" -full description available at: [https:\\/\\/hubblesite.org\\/image\\/3476\\/gallery\\/73-phat](https:\\/\\/hubblesite.org\\/image\\/3476\\/gallery\\/73-phat).\",\n...\n

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the main Find and Replace documentation page or the Archipelago Documentation main page.

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace_action_webform/","title":"Webform Find and Replace","text":"

    Webform Find and Replace enables you to search against values found within defined Webform elements to apply metadata replacements with targeted care. Below are a guide and an example use case for this Action.

    Note

    Please refer to the main Find and Replace documentation page for a general overview of where to find within your Archipelago, a general overview of default options and important notes and workflow recommendations.

    ","tags":["Advanced Batch Find and Replace","Webform Find and Replace","Search and Replace"]},{"location":"find_and_replace_action_webform/#important-notes-about-different-webform-elements","title":"Important Notes about Different Webform Elements","text":"

    Maximum Length as Defined by your Webform Element Configuration OR Theme Defaults

    For certain text-based webform element types, the maximum field length (maxlength) defined in your specific webform element configurations will be enforced during Webform Find and Replace operations. If no maximum length is defined, the Admin Theme will enforce a maximum length of 128 characters. Please see our main Webforms documentation for information about configuring webforms in Archipelago.

    Some Complex Webform Elements Not Available

    Please note that some complex webform elements are not available for use with Webform Find and Replace. Any webform element that requires user interactions (such as the Nominatim Open Street Maps lookup/query and selection) is not available for usage. The different file upload webform elements are also not available for use with Webform Find and Replace.

    ","tags":["Advanced Batch Find and Replace","Webform Find and Replace","Search and Replace"]},{"location":"find_and_replace_action_webform/#step-by-step-guide","title":"Step by Step Guide","text":"
    1. Go to Tools > Advanced Batch Find and Replace.
    2. Identify and/or Filter the Digital Objects (ADOs) that need updates by Searching and/or using the available Facets.
    3. If using the 'Ingest Method Service URL' for Faceting, please note that using the Find and Replace Webform functionality to update ADOs will cause the original AMI Set URL identified in this Facet to be overwritten and replaced with the specified Webform used during the replacement execution.
    4. Either select all (includes results that appear on additional pages) by toggling Select / deselect all results (all pages, x total) or toggle the buttons for individual objects.
    5. Expand the \u25ba Raw Metadata (JSON) for some of the objects and double-check that the metadata field and value you are targeting for replacement is present.
    6. Select Webform find-and-replace Metadata for Archipelago Digital Objects content item from the Action dropdown.
    7. If selecting objects individually, expand the Selected X items and review the list.
    8. Press the Apply to selected items button (don't worry, nothing will happen yet).
    9. On the Webform Find and Replace Action Configuration page, you will need to select the configuration options to be applied for your selected ADOs.
    10. From the dropdown:
      1. Select which Webform you want to use
      2. Select which Form element you want to use
      3. Select which value to search for in the [chosen form element] JSON key
      4. Select which value to replace with in the [chosen form element] JSON key
    11. See the Simulation Mode notes here for information about this optional simulation/test mode.
    12. If you're absolutely certain about the replacement you have targeted, uncheck the 'only simulate and debug affected JSON' option and select Apply.
    13. After the operation is executed, check your changes.
    ","tags":["Advanced Batch Find and Replace","Webform Find and Replace","Search and Replace"]},{"location":"find_and_replace_action_webform/#use-case-example","title":"Use Case Example","text":"

    In the following example configuration, for the selected 'Senju no oubashi (Senju great bridge)' object, the Media Type (type JSON key) value of \"Visual Artwork\" will be replaced with the type JSON key value of \"Photograph\".

    • Selection of Single ADO and Webform find-and-replace Action

    • Webform Find and Replace Form

    • Confirmation of Successfully Executed Changes

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the main Find and Replace documentation page or the Archipelago Documentation main page.

    ","tags":["Advanced Batch Find and Replace","Webform Find and Replace","Search and Replace"]},{"location":"firstobject/","title":"Your First Digital Object","text":"

    You followed every Deployment step and you have now a local Archipelago instance. Great!

    So what now? It is time to give your new repository a try and we feel the best way is to start by ingesting a simple Digital Object.

    Note

    This guide will assume Archipelago is running on http://localhost:8001, so if you wizardly deployed everything in a different location, please replace all URIs with your own setup while following this guide.

    "},{"location":"firstobject/#requirements","title":"Requirements","text":"
    • Running Archipelago (http://localhost:8001)
    • 20 minutes of your time.
    • Open Mind.
    "},{"location":"firstobject/#welcome","title":"Welcome!","text":"

    Start by opening http://locahost:8001 in your favourite Web Browser.

    Your Demo deployment will have a fancy Home page with some banners and a small explanation of what Archipelago is and can do. Feel free to read through that now or later.

    Click on Log in in the top left corner and use your demo credentials from the deployment guide.

    • user: demo
    • pass: demo

    (or whatever password you decided was easy for you to remember during the deployment phase)

    Press the Log in button.

    Great, welcome demo user! This users has limited credentials and uses the same global theme as any anonymous user would. Still, demo can create content, so let's use those super powers and give that a try.

    You will see a new Menu item under Tools on the top navigation bar named Add Content. Click it!

    "},{"location":"firstobject/#brief-background","title":"Brief Background","text":"

    As you already know Archipelago is build on Drupal 8/9, a very extensible CMS. In practice that means you have (at least) the same functionality any Drupal deployment has and that is also true for Content Managment.

    Drupal ships by default with a very flexible Content Entity Type named Node. Nodes are used for creating Articles and simple Pages but also in Archipelago as Digital Objects. Drupal has a pretty tight integration with Nodes and that means you get a lot of fun and useful functionality by default by using them.

    Want to know more about Entities?

    An Article and a Digital Object are both of type Nodes, but each one represents a different Content Type. Content Types are also named Bundles. An individual Content, like \"Black and White photograph of a kind Dog\" is named a Content Entity or more specific in this case a Node.

    What have Article and Digital Object Content types in common and what puts the apart?

    • Each Content Type or Bundle has a set of Base Fields and also user configurable set of Fields attached (or bundled together).
      • E.g. Article has a title, a Body and the option to add an image.
      • Digital Object has a title but also a special, very flexible one named Strawberry Field (more about that later).

    • Fields are where you put your data into and also where your data comes from when you expose it to the world.

      • Nodes, as any other Content entity have Base Fields (which means you can't remove or configure them) that are used all over the place. Good examples are the title and also the owner, named uid (you!).
      • Other Fields, specific to a Content Type, can be added and configured per Bundle.
      • A Field Widget is used to input data into a Field.
      • Each field can have a Field Formatter that allows you to setup how it is displayed to the World.
      • A set of Field Formatters (the way you want to show your content formatted to the world) is named a Display Mode. You can have many, create new ones and remove them, but only use one at the time.
      • A set of Field Widgets (the way you want to Create and Edit a Node) is named a Form Mode. You can also have many, create new ones but only use one at the time.

    • Each Content Type can have different Permissions (using the build in User Roles system).

    • Each Content Type can have one or more Display Modes. In Practice this means Display Modes are attached to Content Types.
      • Each display modes can have its own Permissions
    • Each Content Type can have one or more Form Modes. In Practice this means Form Modes are attached to Content Types.
      • Each Form Mode can have its own Permissions.

    There is of course a lot more to Nodes, Content Types, Formatters, Widgets and in general Content Entities but this is a good start to understand what will happen next.

    "},{"location":"firstobject/#adding-content","title":"Adding Content","text":"

    Below you see all the Content Types defined by default in Archipelago. Let's click on Digital Object to get your first Digital Object Node.

    "},{"location":"firstobject/#my-metadata","title":"My Metadata","text":"

    What you see below is a Form Mode in action. A multi-step Webform that will ingest metadata into a field of type Strawberry Field (where all the magic happens) attached to that field using a Webform Field Widget, an editorial/advanced Block on the right side, and a Quick Save button at the bottom for saving the session.

    Let's fill out the form to begin our ingest. We recommend using similar values as the ones shown in the screen capture to make following the tutorial easier.

    Make sure you select Photograph as Media Type and all the fields with a red * are filled up. Then press Move on to next step at the bottom of the webform to load the next step in line.

    "},{"location":"firstobject/#collections","title":"Collections","text":"

    Since this is our first digital object we do not yet have a Digital Object Collection for which My First Digital Object could be a member of. In other words, you can leave Collection Membership blank and click Next: Upload Files.

    Why does this look different than Repository X?

    We assume you come from a world where repositories define different Content types and the shape, the fields and values (Schema) are fixed and set by someone else or at least quite complicated to configure. This is where Archipelago differs and starts to propose its own style. You noticed that there is a single Content Type named Digital Object and you have here a single Web Form. So how does this allow you to have images, sequences, videos, audio, 3D images, etc?

    There are many ways of answering that, Archipelago works under the idea of an (or many) Open Schema(s), and that notion permeates the whole environment. Practical answer and simplest way to explain based on this demo is:

    • The Digital Object is a generic container for any shape of metadata. Metadata is generated either via this Webform-based widget you're currently using, manually (power-user need only) or via APIs. Because of this, Metadata can take any shape to express your needs of Digital Objects and therefore we do not recommend making multiple Digital Object types. However, if you ever do need more Digital Object types, the option is available.
    • The Strawberry field Field Widget allows you to attach any Webform, built using the Webform Module and Webforms can be setup in almost infinite ways. Any field, combo, or style can be used. Multi Step, single step - we made sure they always only touch/modify data they know how to touch, so even a single input element webform would ensure any previous metadata to persist even if not readable by itself (See the potential?). And Each Webform can be also quite smart!
    • The Strawberry field Field Widget will take all your Webform input, process any uploaded files, generate a JSON representation, enrich and complement it with Archipelago specific data and save it for you inside the Strawberry field.

    We will come back to this later.

    "},{"location":"firstobject/#linked-data","title":"Linked Data","text":"

    As the name of this step suggests; you will be adding all your Linked Data elements here. This step showcases some of the autocomplete Linked Data Webform elements we built for Archipelago. We truly believe in Wikidata as an open, honest, source of Linked Open Data and also one where you can contribute back. But we also have LoC autocompletes and Getty.

    Again, enter all fields with a red * and when you are finished, click Move on to next step

    Tip

    When entering a location, place or address you will need to click on the Search OpenStreet Maps button, which is what that big red arrow is pointing to in the screenshot below.

    "},{"location":"firstobject/#upload-files","title":"Upload Files","text":"

    Now we will upload our Photograph. Click Choose Files to open your file selector window and choose which file you would like to ingest.

    Once you've uploaded your file, you will see all the Exif data extracted from the image, like so...

    Once you've mentally digested all of that data, let's go ahead and click Save Metadata.

    Wait! Why only the metadata? I'm ready for this Digital Object to be shared with the world!

    By clicking Save Metadata we are simply persisting all the metadata in the current webform session. The actual ingest of the Object happens when you click Save on the next and final step, Complete.

    "},{"location":"firstobject/#complete","title":"Complete","text":"

    Alright, we've made it. We've added metadata, linked Data, uploaded our files and now... we're ready to save! Go ahead and change the status from Draft to Published and click Save.

    Once you hit save you should see the following green message and your first Archipelago Digital Object!

    Congratulations on creating your first digital object! \ud83c\udf53

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"fragaria/","title":"Fragaria Redirects Module","text":"

    Archipelago's Fragaria Redirect Module is a Drupal 9/10 module that provides dynamic redirect routes matched against existing Search API field values. This module will also provide future Unique IDs (API) integrations and PURLs.

    ","tags":["Fragaria","Redirects"]},{"location":"fragaria/#prerequisites","title":"Prerequisites","text":"

    Before proceeding with the following configuration steps, you need to first create the Strawberry Key Name Provider and Solr Field that corresponds to the Field that will be matched against the variable part of the route exists.

    In other words, if your Digital Objects have a field and value such as:

        \"legacy_PID\": [\n        \"mylegacyrepo:1234\"\n    ],  \n

    You need to make sure the values from the legacy_PID JSON key are indexed (as a Solr/Search API Field) and ready for use as part of the Fragaria Redirects configuration.

    Best Practice

    Your new Solr field should to be of field type \"String\" for a perfect match and best results. Using \"Full Text\" or a related variant Solr field type will allow for a partial match, which might lead multiple original URLs redirecting to the first match in Archipelago.

    ","tags":["Fragaria","Redirects"]},{"location":"fragaria/#fragaria-redirect-entity-configuration","title":"Fragaria Redirect Entity Configuration","text":"

    1. Navigate to /admin/config/archipelago/fragariaredirect.

    2. Select the Add a Redirect Config button.

    3. Enter a label for the Fragaria Redirect Entity you are configuring.

    4. Enter the Prefix (that follows your domain) for the Redirect Route.

      • Do not use node/ or do/ as a Prefix. Even if these will technically work (redirect), using either of these Prefix paths will override your existing Paths defined by Drupal and Archipelago.

    5. If applicable, enter the the Suffixes (that follow the prefix + the variable part) for the Redirect Route.

      • Enter one by line. This configuration option is not required.
      • Check/uncheck the option to Instead of fixed Prefixes add a single {catch_all} variable suffix at the end as needed. Checking this will disable any entered static suffixes.

    6. Select the Search API Index where the Field that will be matched against the variable part of the route exists.

    7. Select the Search API Field that will be matched against the variable part of the route.

    8. If applicable, add static prefixes for to the variable part/argument of the path.

      • Enter one by line. This is useful when the variable part of the ROUTE does not match 1:1 the actual indexed data. e.g the route is /oldrepo/1 and the indexed value is \"namespace:1\". In that case add \"namespace:\" here.

    9. Add static suffixes for to the variable part/argument of the path.

      • Enter one by line. This is useful when the variable part of the ROUTE does not match 1:1 the actual indexed data. e.g the route is /oldrepo/namespace:1 and the indexed value is \"namespace:1-page\". In that case add \"-page\" here.

    10. Select the Type of HTTP redirect to perform.

      • Option 1: Temporary Redirect (forced GET)
      • Option 2: Permanent Redirect

    11. Lastly, select the box next to Is this Fragaria Redirect Route active? to set your Redirect to active, and Save your configuration.

    ","tags":["Fragaria","Redirects"]},{"location":"fragaria/#example-redirects-configuration","title":"Example Redirects Configuration","text":"

    The above example configuration would enable a Temporary redirect from a legacy repository site with a URL of https://mylegacyrepo.edu//mylegacyrepo/object/mylegacyrepo:1234 to your new Archipelago PURL of https://mynewarchipelagorepo.edu/do/mynewADOUUID.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Fragaria","Redirects"]},{"location":"generalqa_minio_logging/","title":"Min.io Logging","text":"

    Q: How can I see my minio (S3) docker container's realtime traffic and requests?

    A: For standard demo deployments, mini.io storage server runs on the esmero-minio docker container. Steps are:

    1. Install the mc binaries (minio client) for your platform following this instructions. e.g for OSX run on your terminal:

      brew install minio/stable/mc\nmc alias set esmero-minio http://localhost:9000 user password\n

      with http://localhost:9000 being your current machines mini.io URL and exposed port, user being your username (defaults to minio) and your original choosen password (defaults to minio123)

    2. Run a trace to watch realtime activity on your terminal:

      mc admin trace -v -a --debug  --insecure --no-color esmero-minio\n

    Note: mc client is also AWS S3 compatible and can be used to move/copy/delete files on the local instance and to/from a remote AWS storage.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"generalqa_smtp_configuration/","title":"SMTP Configuration","text":"

    Q: How can I enable SMTP for Archipelago?

    A: For standard demo deployments, SMTP is not setup to send emails. To enable SMTP:

    1. Enter the following commands in your terminal. Note: make sure docker is running. Optionally, you can verify that all Archipelago containers are present by entering the docker ps command first.

      docker exec -ti esmero-php bash -c 'php -dmemory_limit=-1 /usr/bin/composer require drupal/smtp:^1.0'\ndocker exec -ti esmero-php bash -c 'drush en -y smtp'\n

    2. Check that the SMTP module has been enabled by navigating (as admin user) to the EXTEND module menu item (localhost:8001/admin/modules). You should see \"SMTP Authentication Support\" listed.

    3. Navigate to localhost:8001/admin/config/system/smtp to configure the SMTP settings.

      This screenshot shows settings if a GMAIL account is used.

    4. Save your settings, then test by adding a recipient address in the \u201cSEND TEST E-MAIL\u201d field.

    Note: Depending on your email provider, you may also need to enable \u201cless secure\u201d applications in your account settings (such as here for Google email accounts: https://myaccount.google.com/lesssecureapps)

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"generalqa_twig_modules_configuration/","title":"Twig Modules Configuration","text":"

    Q: When attempting to save a Twig template for a Metadata Display, I receive an error message related to an Unknown \"bamboo_load_entity\" function.

    A: You need to enable the necessary Twig modules.

    1. Navigate to: yoursite/admin/modules

    2. In the \u201cEnter a part of the module name or description\u201d box, enter \u201cbam\u201d to filter for the related Bamboo Twig modules. Alternatively, scroll down to the Bamboo Twig modules section on this page.

    3. Check the box next to each of the following to enable (some may already be enabled):

      • Bamboo Twig
      • Bamboo Twig - Loaders
      • Bamboo Twig - Path & Url
      • Bamboo Twig - Token

    4. Click Install.

    5. After receiving the successful installation confirmation, check to make sure you are now able to save your Twig template without receiving an error message.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"giveortake/","title":"Archipelago Contribution Guide","text":"

    Contributing Documentation

    Looking to contribute documentation? Start here.

    Archipelago welcomes and appreciates any type of contribution, from use cases and needs, questions, documentation, devops and configuration and -- of course -- code, fixes, or new features. To make the process less painful, we recommend you first to read our documentation and deploy a local instance. After that please follow the guidelines below to help you get started.

    Archipelago welcomes, appreciates, and recognizes any and all types of contribution. This includes input on all use cases and needs, questions or answers, documentation, DevOps, and configurations. We also welcome general ideas, thoughts, and even dreams for the future of our repository! Of course, we also invite you to contribute PHP code, including fixes and new features.

    We will be helpful, kind, and open. We encourage discussions and always respect one another's opinions, language, gender, style, backgrounds, origins, and destinations, provided they come from the same root values of respect, as stated here. We support conflict resolution using nothing more than basic common sense. We value diversity in all its shapes, forms, colors, epoches, numbers, and kinds, with or without labels, including in-between and evolving. We always assume we can do better and that you have done a lot. Under this very basic social framework, this is how we hope you can contribute:

    "},{"location":"giveortake/#where-the-wild-things-live","title":"Where The Wild Things Live","text":"

    Archipelago has 5 active GitHub repositories

    • Strawberryfield What? Code: Deals with metadata storage and exposure to Drupal. Events/Subscribers that trigger when content is modified. The way internal pieces of JSON are exposed to the rest of the ecosystem. Core to all of what Archipeleago is as a concept. One of its Drupal forms is a Field.
    • Webform Strawberryfield What? Code: Deals with UI based ingest of content using webforms. How files and media are attached to JSON, how tech md is extracted, and any interaction that happens during the edit and ingest processes via a form. In its Drupal form it provides a Field Widget for Strawberryfield.
    • Format Strawberryfield What? Code: Deals with exposing and transforming the JSON when navigating the site. What is displayed, how it is displayed. Provides templating, metadata display entities via Twig, and direct file downloads. In its Drupal form it provides many field formatters for Strawberryfield` and a content entity for the Twig templates.
    • Archipelago Deployment What? DevOps: Docker-compose deployment strategy, including a full skeleton project with persistence folders for Min.io, DB, Solr, Cantaloupe and Drupal 8. Includes initial deployment configurations, which modules are enabled, how things look in Drupal 8 and some scripts plus the deployment documentation for both OSX and Linux.
    • Archipelago Documentation What? Documentation: This guide and whatever we manage to write to explain Archipelago goes here.
    "},{"location":"giveortake/#questions-answers-and-in-transit-between-both-ends","title":"Questions, Answers and In Transit Between Both Ends","text":"

    We host a community interaction channel, our google group. This is the best place to ask questions and make suggestions that are not specific to a single module, and/or if you would like to contribute to a larger conversation within our community. Discussions work best in this forum (not excluding GitHub of course), and our official announcements are posted there too.

    "},{"location":"giveortake/#documentation-workflow","title":"Documentation Workflow","text":"

    Documentation is an evolving effort, and we need help. This guide lives in GitHub in Archipelago Documentation. Documentation and Development Worklfow both work the same way, so keep reading!

    "},{"location":"giveortake/#development-workflow","title":"Development Workflow","text":"

    Start by reading open ISSUES (so you don't end up redoing what someone else is already working on) and looking at our Roadmap for version 1.0.0. If the solution to your problem is not there or if there is an unchecked element in the roadmap, this is a great opportunity to help by creating a new ISSUE.

    Next, start by opening an GitHub ISSUE in any of the 5 GitHub repositories, depending on what it is you are trying to do.

    Please be concise with the title of your ISSUE so that it is easy to understand. Use Markdown to explain the what, how, etc, of your contribution. Note: Even if something related is already in the works, you can still contribute. Just add your comments on any open ISSUE. Or, if you think you want to contribute with a totally different perspective, feel free to open a new ISSUE anyway. We can always discuss next steps starting from there. Every community has its rhythm and style and our style is just beginning to develop. We are still figuring out what works best for everyone.

    Once you are done and you feel comfortable working to make a change yourself, take note of the ISSUE number (lets name it #issuenumber).

    The gist is:

    • Fork the GitHub repository where you created the ISSUE, decide which branch you want to change.
    • Make a new branch out of that one and name it ISSUE-#issuenumber. E.g if #issuenumber is 6, name your branch ISSUE-6.
    • Make changes in that branch and send a pull request.

    As a best practice, we encourage pull requests to discuss/fix existing code, new code, and documention changes.

    For the full step-by-step workflow, we will use Archipelago Documentation and the 1.0.0 branch as example. The same applies to any of the other repositories: just change the remote urls and use the most current branch name.

    "},{"location":"giveortake/#example-set-up-archipelago-documentation-github-repository","title":"Example: Set Up Archipelago Documentation GitHub Repository","text":"

    Fork the Archipelago Documentation Upstream source repository to your own personal GitHub account (e.g. YOU). Copy the URL of your Archipelago Documentation fork (you will need it for the git clone command below).

    $ git clone https://github.com/YOU/archipelago-documentation\n$ cd archipelago-documentation\n$ git checkout 1.0.0\n
    "},{"location":"giveortake/#set-up-git-remote-as-upstream","title":"Set Up Git Remote As upstream","text":"
    $ git remote add upstream https://github.com/esmero/archipelago-documentation\n$ git fetch upstream\n$ git merge upstream/1.0.0\n...\n
    "},{"location":"giveortake/#create-your-issue-branch","title":"Create Your ISSUE Branch","text":"

    Before making changes, make sure you create a branch using the ISSUE number you created for these contributions.

    $ git checkout -b ISSUE-6\n
    "},{"location":"giveortake/#do-some-clean-up-and-test-locally","title":"Do Some Clean Up and Test Locally","text":"

    After your code changes, make sure

    • If modifying PHP, run phpcs --standard=Drupal yourchanged.file.php. We (try our best to) use Drupal 8 coding standards.
    • If modifying a MARKDOWN file, make sure it renders well (you can use Textmate, Atom, Textile, etc to preview) and that links are not broken.
    • If writing large pieces of code, add PHP Tests. We can help if you don't know how (tell us in the ISSUE). Tests will be enforced starting with the first stable release.
    • If modifying PHP, please test your changes live on your local instance of Archipelago. All non-documentation modules are already inside web/modules/contrib/.
    "},{"location":"giveortake/#commit-changes","title":"Commit Changes","text":"

    After verification, commit your changes. This is very good post on how to write commit messages.

    $ git commit -am 'Fix that Strawberry'\n
    "},{"location":"giveortake/#push-to-the-branch","title":"Push To The Branch","text":"

    Push your locally committed changes to the remote origin (your fork)

    $ git push origin ISSUE-6\n
    "},{"location":"giveortake/#create-a-pull-request","title":"Create A Pull Request","text":"

    Pull requests can be created via GitHub. This document explains in detail how to create one. After your Pull Request gets peer reviewed and approved, it can be merged. Discussion can happen and peers can ask you for modifications, fixes or more information on how to test. We will be respectful. You will be given credit for all your contributions and shown appreciation. There is no wrong and never too little. There could never be too much!

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"googleapi/","title":"Configuration for Google Sheets API","text":"

    To allow the Archipelago Multi Importer (AMI) to read from Google spreadsheets, you first need to configure the Google Sheets API as outlined in the following instructions.

    Please note:

    • Frequent changes to the Google Sheets API specifications may impact the configurations needed.
    • This set of instructions will only work for individuals using Google accounts affiliated with Organizations.
    • Please contact us on our Archipelago Commons Google Group with any questions/issues.
    "},{"location":"googleapi/#generating-google-oauth2-credentials","title":"Generating Google OAuth2 Credentials","text":"

    1. Login to the Google Developer Console. You will see the API & Services Dashboard.

    2. If you have not created Credentials or a Project before, you will need to first create a Project.

      • Recommended Project Name: \"Archipelago Multi Importer\" or \"AMI\".
      • The Organization and Location information should be specific to you and your organization/institution.

    3. Next, click the Create credentials select box and select OAuth client ID

    4. You will now need to Configure the Consent Screen.

    5. On the initial OAuth Consent Screen setup, select Internal for User Type.

    6. Now enter AMI as the App name, and your email address in the User support email. You may also wish to add Authorized domains (bottom of image below) as well.

    7. On the Scopes page, select Add or Remove Scopes. Then either search/filter the API table for the Google Sheets API. Or, under Manually add scopes enter: https://www.googleapis.com/auth/spreadsheets.readonly

    8. After selecting or entering in the Google Sheets API, you should see this listed under Sensitive Scopes.

    9. Review the information on the Summary page, then Save.

    10. You will now be able to Create Oauth client ID. Select Web Application as the Application type

    11. Enter \"AMI\" under 'Name' and add any URIs you will be using below.

      • For using AMI within your local Archipelago environment, enter http://localhost:8001/google_api_client/callback

      • All URIs need to include /google_api_client/callback

    12. After Saving, you will see a message notifying you that the OAuth client was created. You can copy the Client ID and Client Secret directly from this confirmation message into a text editor. You can also access the information from Credentials in the APIs & Services section in the Developer console, where you will have additional options for downloading, copying, and modifying if needed.

    13. On the 'Add Google Api Client account' configuration page, enter the following information using your Client ID and Client Secret. 'Developer Key' is optional. Select Google Sheets API under 'Services' and https://www,googleapis.com/auth/spreadsheets.readonly under 'Scopes'. Check the box for Is Access Type Offline. Select the Save button.

    14. You will now need to Authenticate your AMI Google API Client. Return to the Google API Client Listing page. Under the Operation menu on the right-hand side of the AMI client listing, select Authenticate.

    15. You will be directed to the Google Consent Screen. You may need to login to your corresponding Google Account before proceeding. When loged in, you will see the following screen requesting that AMI is allowed to \"View your Google Spreadsheets\". Click Allow.

    16. On the Google API Client Listing page, your AMI client listing should now have 'Yes' under 'Is Authenticated'. You are now ready to use Google Sheets with AMI! Return to the main AMI documentation page to get started.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"inthewild/","title":"Archipelagos in the Wild \ud83d\uddfa\ufe0f","text":"

    Explore Archipelago instances running free across digital realms.

    Note

    *Please be aware that some of the following Archipelago instances are still brewing and these links may change. Stay tuned for future updates to live production sites when available.

    "},{"location":"inthewild/#metro-archipelago","title":"METRO + Archipelago","text":"

    The Archipelagos listed below are supported by the Digital Services Team at the Metropolitan New York Library Council. \ud83e\uddd1\u200d\ud83c\udf3e \ud83d\udc1d \ud83c\udf53

    • Archipelago Playground and Studio Site

      • METRO's public Archipelago playground to experiment, learn, and evaluate.

    • Barnard College

    • Digital Culture of Metropolitan New York (DCMNY)

    • Empire Archival Discovery Cooperative (EADC) Finding Aid Toolkit

      • Supported by the Southeastern New York Library Resources Council (SENYLRC)

    • Empire Immersive Experiences

      • Supported by the Western New York Library Resources Council (WNYLRC)

    • Frick Collection and Webrecorder Team Web Archives Collaboration

    • Hamilton College Library & IT Services

    • Olin College Library Phoenix Files

      • *Early adopter - live since Summer 2020

    • New York State COVID-19 Personal History Initiative

    • Rensselaer Polytechnic Institute Libraries

    • San Diego State University Libraries Digital Collections

    • Union College Library

    • Western Washington University

      • Migration to Archipelago began Summer 2022; Launch of new site ~Winter 2023/24
    "},{"location":"inthewild/#neighborhood-archipelagos","title":"Neighborhood Archipelagos","text":"

    From all around our beautiful shared world. \ud83c\udfe1 \ud83c\udfeb \ud83c\udfdb\ufe0f

    • Amherst College

      • Migration to Archipelago began Spring 2022

    • Association Montessori Internationale

      • Development of Archipelago environment began Summer 2022; Launch of new site Spring 2024

    • California Revealed

    • Christian Observatory of the Pro Civitate Christiana

    • Consiglio Nazionale delle Ricerche / National Research Council of Italy

      • https://dbopen.ba.cnr.it/
      • https://archiplavit.to.cnr.it/
      • https://vitisgrinzane.ipsp.cnr.it/
      • http://archipelago.byterfly.eu/ \ud83e\udd8b
        • Virtual Tour Santuario Paola

    • University of Edinburgh Libraries

      • Development of Archipelago environment began Summer 2022
    "},{"location":"inthewild/#we-should-be-here","title":"We should be here","text":"

    If you have a public Archipelago instance you'd like to share on this page \ud83c\udfdd\ufe0f\ud83d\udccd, please contact us. We would love to add your great work to this list! \ud83d\udc9a

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"metadata_display_preview/","title":"Metadata Display Preview","text":"

    Archipelago's Metadata Display Preview is a very handy tool for your repository toolkit that enables you to preview the output of your Metadata Display (Twig) Templates (found at /metadatadisplay/list). You can use the Metadata Display Preview to test and check the results of any type of Template (HTML Display, JSON Ingest, IIIF JSON, XML, etc.) against both Archipelago Digital Objects (ADOs) and AMI Sets (rows within).

    Prerequisite Note

    Before diving into Metadata Display (Twig) Template changes, we recommend reading our Twigs in Archipelago documentation overview guide and also our Working with Twig primer.

    ","tags":["Metadata Display","Twig Template","Preview"]},{"location":"metadata_display_preview/#step-by-step","title":"Step-by-Step","text":"

    1. Navigate to the Metadata Display list at /admin/content/metadatadisplay/list (or through the admin menu via Manage > Content > Metadata Displays). From the main Metadata Display List page, you can access all of the different display, rendering, and processing templates found in your Archipelago.

      Selecting a Metadata Display Template

    2. Open and select 'Edit' for the Template you wish to Edit and/or Preview.

      Editing a Metadata Display Template

    3. You will now be able to select either an Archipelago Digital Object (ADO) or AMI Set to Preview. Both selection types will use an autocomplete search (make sure the autocomplete matches fully against your selection before proceeding).

      Archipelago Digital Object (ADO) selection

      AMI Set and Row selection

      For the Row, you can enter either a (CSV row) number

      AMI Set and Row selection

      Or a label found within the Source Data CSV:

    4. After you select your ADO or AMI Set and press the Show Preview button, the fuller Preview section will open up on the right side of the screen. The left side will continue to show the Metadata Display Template you originally selected to Edit.

      Tip

      It is strongly recommended to always select the option to \"Show Preview using native Output Format (e.g. HTML)\".

      Archipelago Digital Object (ADO) selection against an HTML Display template

      AMI Set and Row selection against a JSON Ingest template

    5. To keep track of the JSON keys used in your template select the Show Preview with JSON keys used in this template option before pressing Show Preview. For more details see below.

    6. Within the Preview Section on the right side of the screen:

      • The top section contains full JSON metadata record for the selected digital object or AMI Set + specified row.
      • If previewing against an AMI Set + specified row, the middle section will show the 'Reconciliated LoD' for the selected row if you have used AMI LoD Reconciliation for the selected AMI Set.
      • The bottom section will show the rendered Output from the Template using the metadata from the selected ADO or AMI Set + specified row.

    7. From the Edit + Preview mode, you can:

      • Add and edit additional JSON keys to an HTML-output Display Template, such as subjects from LoD sources, found in your digital objects and collections data.
      • Preview your incoming AMI Sets against your Ingest Template to ensure all your Source Data CSV columns and values are being being mapped properly to their Archipelago destination JSON keys; And make adjustments as needed.
      • Enrich a provided schema-based XML template to incorporate more elements found in your Archipelago environment.
      • And more \ud83e\uddd1\u200d\ud83c\udf73\ud83c\udfa8\ud83c\udfc4

    8. Select the Show Preview button as you make changes to refresh the Preview output and check your work. After saving any changes you may have made to your selected Template, all of the displays/AMI Sets/other outputs that reference this same Template will reflect the changes made.

    ","tags":["Metadata Display","Twig Template","Preview"]},{"location":"metadata_display_preview/#metadata-display-preview-json-key-variables","title":"Metadata Display Preview JSON Key Variables","text":"

    Note

    This feature is available as of strawberryfield/format_strawberryfield:1.2.0.x-dev and archipelago/ami:0.6.0.x-dev. To make use of it before the official 0.6.0/1.2.0 release you can run the following commands:

    1. Alias the next release branches with the current dependency requirement versions: 
      docker exec -ti esmero-php bash -c \"composer require 'archipelago/ami:0.6.0.x-dev as 0.5.0.x-dev' 'strawberryfield/format_strawberryfield:1.2.0.x-dev as 1.1.0.x-dev'\"\n
    2. Then run any database updates: 
      docker exec -ti esmero-php bash -c \"drush updb\"\n
    3. And finally, clear the cache: 
      docker exec -ti esmero-php bash -c \"drush cr\"\n

    When creating or editing a Metadata Display Twig template, you can keep track of the JSON keys being used in the template by enabling the option after selecting an Archipelago Digital Object (ADO) or AMI Set row before pressing Show preview:

    Enable Metadata Display Preview Variables

    The last two tabs in the Preview section above expand to show two tables listing the JSON keys that are used and unused by the template. The used keys are sorted by first instance line number (from the template) and the unused keys are sorted alphabetically.

    Metadata Display Preview Variables Used JSON Keys

    Metadata Display Preview Variables Unused JSON Keys

    The JSON Keys that appear in these tables will vary based on changes to the template and the selected ADO or AMI set row.

    ","tags":["Metadata Display","Twig Template","Preview"]},{"location":"metadata_display_preview/#warnings-and-errors","title":"Warnings and Errors","text":"

    Warnings and Errors encountered during the processing will be shown at the top of the Preview section. A line number (from the template) will be included in the message if available.

    Warning

    A Warning will be generated if output can be rendered, and the output will be displayed below it.

    Error

    An Error will be generated if no output can be rendered, and no output will be displayed.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Metadata Display","Twig Template","Preview"]},{"location":"metadatainarchipelago/","title":"Your JSON, our JSON - RAW Metadata in Archipelago","text":"

    From the desk of Diego Pino

    Archipelago's RAW metadata is stored as JSON and this is core to our architecture. To avoid writing RAW over and over, this document will refer to RAW Metadata simply as Metadata.

    Data and Metadata can be extremely complex and extensive. The use cases that define what Data, Media and Metadata to collect, to catalog and expose, to use during search and discovery or to enable interactive functionality, including questions like \"what public facing schemas, formats and serializations I need or want to be compliant with\" are as diverse and complex as the Metadata driving them.

    But also Metadata, in specific, is plastic and evolving as are use cases. And more over, some Metadata is descriptive and some Metadata is technical and there are other types of Metadata too, e.g Control Metadata.

    Finally Metadata is very close to their generators. Means you and your peers will know, better than any Software Development team, what is needed, useful and, many times also, available given what use case you have, end users needs and resources at hand, your In real life workflows and future expectations.

    "},{"location":"metadatainarchipelago/#reason-behind-using-json","title":"Reason behind using JSON","text":"
    • Complex hierarchical Metadata needs to be machinable (and fast)
    • All types of Metadata might need to be \"easy to access\" while generating output, visualizations, search and discovery.
    • The shape of this Metadata might need to change and adapt in time. Idea that supports Open Schema v/s a highly structured and fixed Schema, e.g Relational database (RDB) for most of the use cases we think Archipelago can cover.
    • JSON is shareable, portable, easy to validate online and offline.
    • JSON is compact.
    • JSON is searchable/filterable using Query Languages like JSONPATH and JMESPATH.
    • JSON is easy to patch and modify in batches.
    • JSON is platform agnostic and has been around for decades and has not changed since then.
    • JSON is typed and allows ordering/sorting of data easily.
    "},{"location":"metadatainarchipelago/#drupal-and-json","title":"Drupal and JSON","text":"

    Drupal, the OSS CMS system Archipelago uses and extends, is RDB driven. This means that Content Types normally follow the idea of an Entity with Fields attached. Each of these Fields becomes then a Database Table and the sum of all these fields living under a Content Type definition, a fixed schema.

    For integration and interoperability reasons with the larger Drupal ecosystem, we inherit in Archipelago the idea of an Entity, in specific, a Content Entity (Node) and Content Type (Bundled fields for a Node). But instead of generating (and encouraging) the use of hundreds of fixed fields to describe your Digital Objects we put all Metadata as JSON, means a JSON BLOB, into a single smart Field of type Strawberry Field. \ud83c\udf53

    We go a long way of making as much as possible flexible and dynamic. This also implies the definition (and separation) of what an Archipelago Digital Object (ADO) is in our Architecture v/s what a general Drupal Content Type (e.g a static page or a blog post) is defined in code as: \"Any Content type that uses a Strawberry Field is an ADO and will be processed as such\". No configuration is needed. In other words, all is a NODE but any node that uses a Strawberry Field gets a different treatment and will be named in Archipelago an ADO.

    One of the challenges of our flexible approach is how to allow Drupal to access the JSON in a way, as native as possible, to generate filtered listings via Drupal Views, free text Search and Faceting. To make this happen Strawberry Field uses a JSON Querying and Exposing as \"Native Field Properties\" logic. Through a special type of Plugin system named Strawberry Key Name Providers and associated Configuration Entities (can be found at /admin/structure/strawberry_keynameprovider), you have control on which keys and values of your JSON are going to be exposed as field properties of any Strawberry Field, allowing Drupal through this to access values in a flat manner and expose them to the Search API natively. The access to the values of any JSON is done via JMESPATH expressions and then transformed either to a list of values or even \"cast\" into more complex data Data types, like an Entity Reference (means a connection to another Entity).

    This gives you a lot of power and control and makes a lot of very heavy operations lighter. You can even plan upfront or evolve these properties in time.

    In other words, you control how storage is mapped to Discovery and this allows Drupal Views to work that way too. Of course this also means traditional SQL based Drupal Views won't have access to these internals (for filtering) given that your JSON data nor the virtual Properties generated via Strawberry Key Name Providers are not accessible as individual RDB tables to generate SQL joins and that is why we heavily depend on the Search API (Solr).

    "},{"location":"metadatainarchipelago/#open-schema-what-is-yours-what-is-archipelagos","title":"Open Schema. What is yours, what is Archipelago's","text":"

    What can you add to an ADO's Strawberry Field? As long as it is valid JSON, Archipelago can store it, display it, transform it and search across it in Archipelago. The way you manage Metadata can be as \"intime\" or \"aligned\" to other schemas as you want. Still, there are a few suggested keys/functional ideas:

    "},{"location":"metadatainarchipelago/#suggested-json-keys","title":"Suggested JSON keys","text":""},{"location":"metadatainarchipelago/#the-type-key","title":"The type key","text":"
    {\n  \"type\": \"Photograph\"\n}\n

    The type JSON key has a semantic and functional importance in Archipelago. Given that we don't use multiple Drupal Content Types to denote the difference between e.g. a Photograph or a Painting (which would also mean you would be stuck with one or other if we did), we use this key's value to allow Archipelago to select/swap View Modes. This approach also allows for your own needs to define what an ADO in real life or digital realm is (the WHAT). This key is also important when doing AMI based batch ingests since many of the mappings and decisions (e.g. what Template to use to transform your CSV or if the Destination Drupal Content Type is going to be a Digital Object or a Digital Object Collection) will depend on this.

    Note: Archipelago does something extra fun too when using type value for View Mode Selection (and this is also a feature of one of the Key Name provider Plugins). It will flatten the JSON first and then fetch all type keys. How does this in practice work?

    {\n    \"type\": \"Photograph\",\n    \"subtypes\": [\n        {\n            \"type\": \"125 film\"\n        },\n        {\n            \"type\": \"Instant film\"\n        }\n    ]  \n}\n

    Means, while doing a View Mode Selection Archipelago will bring all found type key values together and will have ['Photograph', '125 film', 'Instant film'] available as choices, meaning you will be able to make even finer decisions on how to display your ADOs. View Mode selection is based on order or evaluation, means we recommend putting the more specific mappings first.

    "},{"location":"metadatainarchipelago/#the-label-key","title":"The label key","text":"
    {\n    \"label\": \"Black and White Photograph of Cataloger working with JSON\"\n}\n

    Archipelago will use the label key's value to populate the ADO's (Drupal Node) Title. Drupal has a length limit for its native build in Node Entity Title but JSON has not, so in case of more than 255 characters Archipelago will truncate the Title (not the label key's value) adding an ellipsis (...) as suffix.

    "},{"location":"metadatainarchipelago/#archipelago-drupal-entities-integration-keys","title":"Archipelago Drupal Entities integration keys","text":"

    Because of the need of having Technical Metadata, Descriptive Metadata and Semantic Metadata while generating different representations of your JSON via Metadata Display Entities (Twig templates) transformations, we store and characterize Files attached to an ADO as part of the JSON. We also use a set of special keys to map and cast JSON keys and values to Drupal's internal Entities system via their Numeric and/or UUID IDs.

    Through this, Archipelago will also move files between upload locations and permanent storage, execute Technical metadata extraction, keep track of ADO to ADO relationships (e.g ispartof or ismemberof) and emulate what a traditional Drupal Entity Reference field would do without the limitations (speed and immutability) a static RDB definition imposes.

    "},{"location":"metadatainarchipelago/#the-apentitymapping-key","title":"The ap:entitymapping key","text":"
    {\n    \"ap:entitymapping\":{\n        \"entity:file\": [\n            \"model\",\n            \"audios\",\n            \"images\",\n            \"videos\",\n            \"documents\",\n            \"upload_associated_warcs\"\n            ],\n        \"entity:node\": [\n            \"ispartof\",\n            \"ismemberof\"\n        ]\n    }\n}\n

    the ap:entitymapping is a hint for Archipelago. With this key we can treat certain keys and their values as Drupal Numeric Entity IDs instead of semantically unknown values.

    In the presence of the structure exemplified above the following JSON snipped:

        \"images\": [\n        1,\n        2,\n        3\n    ]   \n

    Will tell Archipelago that the JSON key images should be treated as containing Entity IDs for a Drupal Entity of type (entity:file) File. This has many interessting consequences. Archipelago, on edit/update/ingest will try (hard) to get a hold of Files with ID 1, 2 and 3. If in temporary storage Archipelago will move them to its final Permanent Location, will make sure Drupal knows those files are being used by this ADO, will run multiple Technical Metadata Extractions and classify internally the Files, adding everything it could learn from them. In practice, this means that Archipelago will write for you additional structures into the JSON enriching your Metadata.

    Without this structure, the images key would not trigger any logic but will of course still exist and can always still be used as a list of numbers while templating.

    This also implies that for a persisted ADO with those values, if you edit the JSON and delete e.g. the number (integer or string representation of an integer) 3, Archipelago will disconnect the File Entity with ID 3 from this ADO, remove the enriched metadata and mark the File as not being anymore used by this ADO. If nobody else is using the File it will become temporary and eventually be automatically removed from the system, if that is setup at the Drupal - Filesystem - level.

    Using the same example ap:entitymapping structure, the following snippet:

        \"ispartof\": [\n        2000\n    ]   \n

    Will hint to Archipelago on assumed connection between this ADO and another ADO with Drupal Entity ID 2000. This will drive other functionality in Archipelago (semantic), allowing for example a Navigation Breadcrumb to be built using all connections found in its hierarchical path.

    In Archipelago ADO to ADO relationships are normally from Child to Parent and hopefully (but not enforced!) building an Acyclic graph, from leaves to trunk. This will also allow inheritance to happen. This means also that a Parent ADO needs to exist before connecting/relating to it (chicken first). But if it does not, the system will not fail and assume a temporarily broken relationship (egg stays safely intact).

    Entity mapping key also drives a very special compatibility addition to any ADO. Archipelago will populate Native Computed Drupal fields (attached at run time to each ADO) with these values loading and exposing them as Drupal Entities, processing both Files and Node Entities and making them visible outside the scope of a Strawberry Field to the whole CMS.

    The following Computed fields are provided:

    • field_file_drop: Computed Entity Reference Field. Needed also for JSON API level upload of Files to an ADO (Drupal need). It will expose all File Entities referenced in an ADO, independently of the type of the File.
    • field_sbf_nodetonode: Computed Entity Reference Field. It will expose all Nodes (other ADOs) Entities referenced in an ADO, independently of the Content type and/or the semantic predicate (ismemberof, ispartof, etc) used.

    These Fields, because of their native Drupal nature, can be used directly everywhere, e.g. in the Search API to index all related ADOs (or any of their Fields and subproperties, even deeply chained, tree down) without having to specify what predicate is used. Said differently, they act as aggregators, as a generic \"isrelatedto\" property bringing all together.

    "},{"location":"metadatainarchipelago/#the-asas_file_type-keys","title":"The as:{AS_FILE_TYPE} keys","text":"

    As explained in the ap:entitymapping section above, when Archipelago gets hold of a File entity it will enrich your JSON with its extracted data. Archipelago will compute and append to your JSON a set of controlled as:{AS_FILE_TYPE} keys containing a classified File's Metadata. The naming will be automatic based on grouping Files by their Mime Types.

    The possible values for as:{AS_FILE_TYPE} are

    • as:image
    • as:document
    • as:video
    • as:audio
    • as:application
    • as:text
    • as:model
    • as:multipart
    • as:message

    An example for an Image attached to an ADO:

    {\n    \"as:image\": {\n        \"urn:uuid:ef596613-b2e7-444e-865d-efabbf1c59b0\": {\n            \"url\": \"s3:\\/\\/de2\\/image-f6268bde41a39874bc69e57ac70d9764-view-ef596613-b2e7-444e-865d-efabbf1c59b0.jp2\",\n            \"name\": \"f6268bde41a39874bc69e57ac70d9764_view.jp2\",\n            \"tags\": [],\n            \"type\": \"Image\",\n            \"dr:fid\": 7461,\n            \"dr:for\": \"images\",\n            \"dr:uuid\": \"ef596613-b2e7-444e-865d-efabbf1c59b0\",\n            \"checksum\": \"de2862d4accf5165d32cd0c3db7e7123\",\n            \"flv:exif\": {\n                \"FileSize\": \"932 KiB\",\n                \"MIMEType\": \"image\\/jp2\",\n                \"ImageSize\": \"1375x2029\",\n                \"ColorSpace\": \"sRGB\",\n                \"ImageWidth\": 1375,\n                \"ImageHeight\": 2029\n            },\n            \"sequence\": 1,\n            \"flv:pronom\": {\n                \"label\": \"JP2 (JPEG 2000 part 1)\",\n                \"mimetype\": \"image\\/jp2\",\n                \"pronom_id\": \"info:pronom\\/x-fmt\\/392\",\n                \"detection_type\": \"signature\"\n            },\n            \"dr:filesize\": 954064,\n            \"dr:mimetype\": \"image\\/jp2\",\n            \"crypHashFunc\": \"md5\",\n            \"flv:identify\": {\n                \"1\": {\n                    \"width\": \"1375\",\n                    \"format\": \"JP2\",\n                    \"height\": \"2029\",\n                    \"orientation\": \"Undefined\"\n                }\n            }\n        }\n    }\n}\n

    That is a lot of Metadata! But to understand what is happening here, we need to dissect this into more readable chunks. Let's start with the basics from root to leaves of this hierarchy.

    "},{"location":"metadatainarchipelago/#direct-file-level-metadata","title":"Direct File level Metadata","text":"

    Every Classified File inside the as:{AS_FILE_TYPE} key will be contained in a unique URN JSON Object property:

    \"urn:uuid:ef596613-b2e7-444e-865d-efabbf1c59b0\": {}\n

    We use a Property instead of a \"List or Array\" of Technical Metadata because this allows us (at code level) to access quickly from e.g. as:image structure all the data for a File Entity with UUID ef596613-b2e7-444e-865d-efabbf1c59b0 without iterating. (Also now you know what urn:uuid:ef596613-b2e7-444e-865d-efabbf1c59b0 means.)

    Next, inside that property, the following Data provides basic Information about the File so you can access/make decisions when Templating. Notice the duplication of similar data at different levels. Duplication is on purpose and again, allows you to access certain JSON values (or filter) quicker without having to go to other keys or hierarchies to make decisions.

    {\n    \"url\": \"s3:\\/\\/de2\\/image-f6268bde41a39874bc69e57ac70d9764-view-ef596613-b2e7-444e-865d-efabbf1c59b0.jp2\",\n    \"name\": \"Original Name of my Image.jp2\",\n    \"tags\": [],\n    \"type\": \"Image\",\n    \"dr:fid\": 3,\n    \"dr:for\": \"images\",\n    \"dr:uuid\": \"ef596613-b2e7-444e-865d-efabbf1c59b0\",\n    \"crypHashFunc\": \"md5\",\n    \"checksum\": \"de2862d4accf5165d32cd0c3db7e7123\",\n    \"dr:filesize\": 954064,\n    \"dr:mimetype\": \"image\\/jp2\",\n    \"sequence\": 1\n
    • \"url\": Contains the Final Storage location/URI of the File. It's prefixed with the configured Streamwrapper, a functional symbolic link to the underlying complexities of the backend storage. e.g s3:// implies an S3 API backend with a (hidden/abstracted) set of credentials, Bucket and Prefixes inside the bucket. This value is also used in Archipelago's IIIF Cantaloupe Service as the Image id when building a IIIF Image API URL.
    • \"name\": The Original Name of the File. Can be used to give a Download a human readable name or as an internal hint/preservation for you.
    • \"tags\": Unused by default. You can use this for your own logic if needed.
    • \"type\": A redundant (contextual, at this level) key whose value will match {AS_FILE_TYPE} already found at 2 levels before. Allows you to know what File type this is when iterating over this File's data (without having to look back, or on our Code, when dealing with Flattened JSON).
    • \"dr:fid\": The Drupal Entity Numeric ID.
    • \"dr:for\": Where in your JSON (top level key) this File ID was stored (or in other words where you can find the value of \"dr:fid\". All this will match / was be driven of course by ap:entitymapping. Sometimes (try uploading a WARC file and run the queue) this key might contain flv:{ACTIVE_STRAWBERRY_RUNNERS_CONFIG_ID}. This means the File will have been generated by an active Strawberry Runners Processor and not uploaded by you. ACTIVE_STRAWBERRY_RUNNERS_CONFIG_ID will be the Machine name (or ID) of a given Strawberry Runners Processor Configuration Entity.
    • \"dr:uuid\": A redundant (contextual, at this level) key whose value will match the Drupal File entity UUID for this File.
    • \"crypHashFunc\": What Cryptographic function was used for generating the checksum. By default Archipelago will do MD5 (faster but also because S3 APIs use that to ensure upload consistency and E-tag). In the future others can be enabled and made configurable
    • \"checksum\": The Checksum (calculated) of this File via \"crypHashFunc\"
    • \"dr:filesize\": The File size in Bytes.
    • \"dr:mimetype\": The Drupal level infered Mime Type. Archipelago extends this list. This is based on the File Extension.
    • \"sequence\": A number (integer) denoting order of this file relative to other files of the same type inside the JSON. Which default type ordering is used will depend on how the ADO was created/edited, but can be overriden using Control Metadata.
    "},{"location":"metadatainarchipelago/#technical-file-level-metadata","title":"Technical File level Metadata","text":"

    Deeper inside this structure Archipelago will produce Extracted Technical Metadata. Some of this Metadata will be common to every File Type, some will be specific to a subset, like Moving Media or PDFs. What runs and how it runs can be configured at the File Persister Service Settings configuration form found at/admin/config/archipelago/filepersisting. Why there? These are service that run syncroniusly on ADO save (Create/Edit) and in while doing File persistance.

    \"flv:exif\": EXIF Tool extraction for a file. The number of elements that come out might vary, for an Image file it might be normally short, but a PDF might have a very extensive and long list. The above mentioned File Persister Service Settings form allows you to also set a Files Cap Number, that will, once reached, limit and reduce the EXIF. This is very useful if you want to control the size of your complete JSON for any reason you feel that is needed (performance, readability, etc).

    {\n    \"flv:exif\": {\n                \"FileSize\": \"932 KiB\",\n                \"MIMEType\": \"image\\/jp2\",\n                \"ImageSize\": \"1375x2029\",\n                \"ColorSpace\": \"sRGB\",\n                \"ImageWidth\": 1375,\n                \"ImageHeight\": 2029\n            },\n}\n

    \"flv:identify\": Graphics Magic Identity binary will run on every file and format it knows how to run (and will try even on the ones it does not). Will give you data similar to EXIF but processed based on the actual File and not just extracted from the EXIF data found at the header. Notice that the details will be inside a \"1\", \"2\", etc property. This is because Identify might also go deeper and for e.g a Multi Layer Tiff extract different sequences on the same File.

    {\n    \"flv:identify\": {\n                \"1\": {\n                    \"width\": \"1375\",\n                    \"format\": \"JP2\",\n                    \"height\": \"2029\",\n                    \"orientation\": \"Undefined\"\n                }\n            }\n}\n

    \"flv:pronom\": Droid, a File Signature detection tool will find a matching pronom_idfor your File based on https://www.nationalarchives.gov.uk/aboutapps/pronom/droid-signature-files.htm. This detection type is deeper that EXIF or the mime type based on extension, reading from binary data. It allows you to get small differences between formats (even if e.g both are JP2) and thus make decisions like \"Will Cantaloupe IIIF Image Server be able to handle this type?\". This has also positive Digital Preservation consequences.

    {\n    \"flv:pronom\": {\n                \"label\": \"JP2 (JPEG 2000 part 1)\",\n                \"mimetype\": \"image\\/jp2\",\n                \"pronom_id\": \"info:pronom\\/x-fmt\\/392\",\n                \"detection_type\": \"signature\"\n            },\n}\n

    \"flv:mediainfo\": Media Info works on Video and Audio. It goes very detailed into codecs andstreams and the output added to your JSON might look massive. This is also very needed when working with IIIF Manifests and deciding if a certain Video will be able to play natively on a browser or if Cantaloupe IIIF Image Server will be able to extract individual frames as images. This again has positive Digital Preservation consequences. The Following is an example of an MP4 file generated via Quicktime on an Apple MacOS computer.

    {\n    \"flv:mediainfo\": {\n                \"menus\": [],\n                \"audios\": [\n                    {\n                        \"id\": {\n                            \"fullName\": \"1\",\n                            \"shortName\": \"1\"\n                        },\n                        \"count\": \"282\",\n                        \"title\": \"Core Media Audio\",\n                        \"format\": {\n                            \"fullName\": \"AAC LC\",\n                            \"shortName\": \"AAC\"\n                        },\n                        \"bit_rate\": {\n                            \"textValue\": \"85.3 kb\\/s\",\n                            \"absoluteValue\": 85264\n                        },\n                        \"codec_id\": \"mp4a-40-2\",\n                        \"duration\": {\n                            \"milliseconds\": 21215\n                        },\n                        \"channel_s\": {\n                            \"textValue\": \"1 channel\",\n                            \"absoluteValue\": 1\n                        },\n                        \"frame_rate\": {\n                            \"textValue\": \"43.066 FPS (1024 SPF)\",\n                            \"absoluteValue\": 43\n                        },\n                        \"format_info\": \"Advanced Audio Codec Low Complexity\",\n                        \"frame_count\": \"914\",\n                        \"stream_size\": {\n                            \"bit\": 226109\n                        },\n                        \"streamorder\": \"0\",\n                        \"tagged_date\": \"UTC 2017-12-05 17:14:10\",\n                        \"encoded_date\": \"UTC 2017-12-05 17:14:07\",\n                        \"source_delay\": \"-0\",\n                        \"bit_rate_mode\": {\n                            \"fullName\": \"Variable\",\n                            \"shortName\": \"VBR\"\n                        },\n                        \"samples_count\": \"935582\",\n                        \"sampling_rate\": {\n                            \"textValue\": \"44.1 kHz\",\n                            \"absoluteValue\": 44100\n                        },\n                        \"channel_layout\": \"C\",\n                        \"kind_of_stream\": {\n                            \"fullName\": \"Audio\",\n                            \"shortName\": \"Audio\"\n                        },\n                        \"commercial_name\": \"AAC\",\n                        \"source_duration\": [\n                            \"21269\",\n                            \"21 s 269 ms\",\n                            \"21 s 269 ms\",\n                            \"21 s 269 ms\",\n                            \"00:00:21.269\"\n                        ],\n                        \"compression_mode\": {\n                            \"fullName\": \"Lossy\",\n                            \"shortName\": \"Lossy\"\n                        },\n                        \"channel_positions\": {\n                            \"fullName\": \"1\\/0\\/0\",\n                            \"shortName\": \"Front: C\"\n                        },\n                        \"samples_per_frame\": \"1024\",\n                        \"stream_identifier\": \"0\",\n                        \"source_frame_count\": \"916\",\n                        \"source_stream_size\": [\n                            \"226460\",\n                            \"221 KiB (1%)\",\n                            \"221 KiB\",\n                            \"221 KiB\",\n                            \"221 KiB\",\n                            \"221.2 KiB\",\n                            \"221 KiB (1%)\"\n                        ],\n                        \"source_delay_source\": \"Container\",\n                        \"format_additionalfeatures\": \"LC\",\n                        \"proportion_of_this_stream\": \"0.01178\",\n                        \"count_of_stream_of_this_kind\": \"1\",\n                        \"source_streamsize_proportion\": \"0.01180\"\n                    }\n                ],\n                \"images\": [],\n                \"others\": [\n                    {\n                        \"type\": \"meta\",\n                        \"count\": \"188\",\n                        \"duration\": {\n                            \"milliseconds\": 21215\n                        },\n                        \"frame_count\": \"1\",\n                        \"kind_of_stream\": {\n                            \"fullName\": \"Other\",\n                            \"shortName\": \"Other\"\n                        },\n                        \"stream_identifier\": [\n                            \"0\",\n                            \"1\"\n                        ],\n                        \"count_of_stream_of_this_kind\": \"2\"\n                    },\n                    {\n                        \"type\": \"meta\",\n                        \"count\": \"188\",\n                        \"duration\": {\n                            \"milliseconds\": 21215\n                        },\n                        \"frame_count\": \"1\",\n                        \"kind_of_stream\": {\n                            \"fullName\": \"Other\",\n                            \"shortName\": \"Other\"\n                        },\n                        \"stream_identifier\": [\n                            \"1\",\n                            \"2\"\n                        ],\n                        \"count_of_stream_of_this_kind\": \"2\"\n                    }\n                ],\n                \"videos\": [\n                    {\n                        \"id\": {\n                            \"fullName\": \"2\",\n                            \"shortName\": \"2\"\n                        },\n                        \"count\": \"380\",\n                        \"title\": \"Core Media Video\",\n                        \"width\": {\n                            \"textValue\": \"1 280 pixels\",\n                            \"absoluteValue\": 1280\n                        },\n                        \"format\": {\n                            \"fullName\": \"AVC\",\n                            \"shortName\": \"AVC\"\n                        },\n                        \"height\": {\n                            \"textValue\": \"720 pixels\",\n                            \"absoluteValue\": 720\n                        },\n                        \"bit_rate\": {\n                            \"textValue\": \"7 144 kb\\/s\",\n                            \"absoluteValue\": 7144261\n                        },\n                        \"codec_id\": \"avc1\",\n                        \"duration\": {\n                            \"milliseconds\": 21215\n                        },\n                        \"rotation\": \"0.000\",\n                        \"bit_depth\": {\n                            \"textValue\": \"8 bits\",\n                            \"absoluteValue\": 8\n                        },\n                        \"scan_type\": {\n                            \"fullName\": \"Progressive\",\n                            \"shortName\": \"Progressive\"\n                        },\n                        \"format_url\": \"http:\\/\\/developers.videolan.org\\/x264.html\",\n                        \"frame_rate\": {\n                            \"textValue\": \"29.970 (29970\\/1000) FPS\",\n                            \"absoluteValue\": 29\n                        },\n                        \"buffer_size\": \"768000\",\n                        \"color_range\": \"Limited\",\n                        \"color_space\": \"YUV\",\n                        \"format_info\": \"Advanced Video Codec\",\n                        \"frame_count\": \"636\",\n                        \"stream_size\": {\n                            \"bit\": 18951244\n                        },\n                        \"streamorder\": \"1\",\n                        \"tagged_date\": \"UTC 2017-12-05 17:14:10\",\n                        \"encoded_date\": \"UTC 2017-12-05 17:14:07\",\n                        \"bit_rate_mode\": {\n                            \"fullName\": \"Variable\",\n                            \"shortName\": \"VBR\"\n                        },\n                        \"codec_id_info\": \"Advanced Video Coding\",\n                        \"framerate_den\": \"1000\",\n                        \"framerate_num\": \"29970\",\n                        \"sampled_width\": \"1280\",\n                        \"format_profile\": \"Main@L3.1\",\n                        \"kind_of_stream\": {\n                            \"fullName\": \"Video\",\n                            \"shortName\": \"Video\"\n                        },\n                        \"sampled_height\": \"720\",\n                        \"color_primaries\": \"BT.709\",\n                        \"commercial_name\": \"AVC\",\n                        \"format_settings\": \"CABAC \\/ 2 Ref Frames\",\n                        \"frame_rate_mode\": {\n                            \"fullName\": \"Variable\",\n                            \"shortName\": \"VFR\"\n                        },\n                        \"bits_pixel_frame\": \"0.259\",\n                        \"maximum_bit_rate\": {\n                            \"textValue\": \"768 kb\\/s\",\n                            \"absoluteValue\": 768000\n                        },\n                        \"stream_identifier\": \"0\",\n                        \"chroma_subsampling\": [\n                            \"4:2:0\",\n                            \"4:2:0\"\n                        ],\n                        \"maximum_frame_rate\": [\n                            \"30.000\",\n                            \"30.000 FPS\"\n                        ],\n                        \"minimum_frame_rate\": [\n                            \"28.571\",\n                            \"28.571 FPS\"\n                        ],\n                        \"pixel_aspect_ratio\": \"1.000\",\n                        \"colour_range_source\": \"Stream\",\n                        \"format_settings_gop\": \"M=2, N=30\",\n                        \"internet_media_type\": \"video\\/H264\",\n                        \"matrix_coefficients\": \"BT.709\",\n                        \"original_frame_rate\": [\n                            \"25.000\",\n                            \"25.000 FPS\"\n                        ],\n                        \"display_aspect_ratio\": {\n                            \"textValue\": \"16:9\",\n                            \"absoluteValue\": 1.778\n                        },\n                        \"format_settings_cabac\": {\n                            \"fullName\": \"Yes\",\n                            \"shortName\": \"Yes\"\n                        },\n                        \"codec_configuration_box\": \"avcC\",\n                        \"colour_primaries_source\": \"Container \\/ Stream\",\n                        \"transfer_characteristics\": \"BT.709\",\n                        \"proportion_of_this_stream\": \"0.98734\",\n                        \"colour_description_present\": \"Yes\",\n                        \"matrix_coefficients_source\": \"Container \\/ Stream\",\n                        \"count_of_stream_of_this_kind\": \"1\",\n                        \"transfer_characteristics_source\": \"Container \\/ Stream\",\n                        \"format_settings_reference_frames\": [\n                            \"2\",\n                            \"2 frames\"\n                        ],\n                        \"colour_description_present_source\": \"Container \\/ Stream\"\n                    }\n                ],\n                \"general\": {\n                    \"count\": \"336\",\n                    \"format\": {\n                        \"fullName\": \"MPEG-4\",\n                        \"shortName\": \"MPEG-4\"\n                    },\n                    \"codec_id\": [\n                        \"qt  \",\n                        \"qt   0000.00 (qt  )\"\n                    ],\n                    \"datasize\": \"19177730\",\n                    \"duration\": {\n                        \"milliseconds\": 21215\n                    },\n                    \"file_name\": \"c98e7bc52e4bd3fe5681a746f2d9c76f_diego4\",\n                    \"file_size\": {\n                        \"bit\": 19194157\n                    },\n                    \"footersize\": \"0\",\n                    \"frame_rate\": {\n                        \"textValue\": \"29.970 FPS\",\n                        \"absoluteValue\": 29\n                    },\n                    \"headersize\": \"16427\",\n                    \"othercount\": \"2\",\n                    \"folder_name\": \"\\/tmp\\/ami\\/setfiles\\/cb606b13b823eaea784dc77c460f3baf\",\n                    \"frame_count\": \"636\",\n                    \"stream_size\": {\n                        \"bit\": 16804\n                    },\n                    \"tagged_date\": \"UTC 2017-12-05 17:14:10\",\n                    \"audio_codecs\": \"AAC LC\",\n                    \"codec_id_url\": \"http:\\/\\/www.apple.com\\/quicktime\\/download\\/standalone.html\",\n                    \"codecs_video\": \"AVC\",\n                    \"encoded_date\": \"UTC 2017-12-05 17:14:07\",\n                    \"isstreamable\": \"Yes\",\n                    \"complete_name\": \"\\/tmp\\/ami\\/setfiles\\/cb606b13b823eaea784dc77c460f3baf\\/c98e7bc52e4bd3fe5681a746f2d9c76f_diego4.m4v\",\n                    \"file_extension\": \"m4v\",\n                    \"format_profile\": \"QuickTime\",\n                    \"kind_of_stream\": {\n                        \"fullName\": \"General\",\n                        \"shortName\": \"General\"\n                    },\n                    \"codecid_version\": \"0000.00\",\n                    \"commercial_name\": \"MPEG-4\",\n                    \"writing_library\": {\n                        \"fullName\": \"Apple QuickTime\",\n                        \"shortName\": \"Apple QuickTime\"\n                    },\n                    \"overall_bit_rate\": {\n                        \"fullName\": \"7 238 kb\\/s\",\n                        \"shortName\": \"7237957\"\n                    },\n                    \"audio_format_list\": \"AAC LC\",\n                    \"stream_identifier\": \"0\",\n                    \"video_format_list\": \"AVC\",\n                    \"codecid_compatible\": \"qt  \",\n                    \"file_name_extension\": \"c98e7bc52e4bd3fe5681a746f2d9c76f_diego4.m4v\",\n                    \"internet_media_type\": \"video\\/mp4\",\n                    \"encoded_library_name\": \"Apple QuickTime\",\n                    \"comapplequicktimemake\": \"Apple\",\n                    \"overall_bit_rate_mode\": {\n                        \"fullName\": \"Variable\",\n                        \"shortName\": \"VBR\"\n                    },\n                    \"comapplequicktimemodel\": \"iPhone SE\",\n                    \"count_of_audio_streams\": \"1\",\n                    \"count_of_video_streams\": \"1\",\n                    \"comapplequicktimesoftware\": \"10.3.2\",\n                    \"proportion_of_this_stream\": \"0.00088\",\n                    \"audio_format_withhint_list\": \"AAC LC\",\n                    \"video_format_withhint_list\": \"AVC\",\n                    \"file_last_modification_date\": {\n                        \"date\": \"2022-10-19 20:02:32.000000\",\n                        \"timezone\": \"UTC\",\n                        \"timezone_type\": 3\n                    },\n                    \"count_of_stream_of_this_kind\": \"1\",\n                    \"comapplequicktimecreationdate\": \"2017-10-25T16:58:17-0400\",\n                    \"format_extensions_usually_used\": \"braw mov mp4 m4v m4a m4b m4p m4r 3ga 3gpa 3gpp 3gp 3gpp2 3g2 k3g jpm jpx mqv ismv isma ismt f4a f4b f4v\",\n                    \"comapplequicktimelocationiso6709\": \"+40.6145-074.2678+020.977\\/\",\n                    \"file_last_modification_date_local\": {\n                        \"date\": \"2022-10-19 20:02:32.000000\",\n                        \"timezone\": \"America\\/New_York\",\n                        \"timezone_type\": 3\n                    }\n                },\n                \"version\": \"21.09\",\n                \"subtitles\": []\n            }\n        }\n}\n

    \"flv:pdfinfo\": PDF Info will get Page level Information for a PDF or Ghostscript document. The dimensions displayed in the following example are not in pixels but points (resolution independent) and are also used for IIIF generation when deciding at what rasterized pixel size a given PDF document page will be rendered. Same as with flv:identify, the technical metadata will be contained inside a keyed (string but semantically an integer) property. In this particular case each number is a page sequence in the original PDF order.

    {\n    \"flv:pdfinfo\": {\n                \"1\": {\n                    \"width\": \"612\",\n                    \"height\": \"792\",\n                    \"rotation\": \"0\",\n                    \"orientation\": \"TopLeft\"\n                }\n            }\n}\n

    @TODO: add the extra special key used by Strawberry Runners when it attaches a file. e.g WARC to WACZ

    "},{"location":"metadatainarchipelago/#did-you-know","title":"Did you #know?","text":"

    If you delete a whole as:{AS_FILE_TYPE} structure or one of the File level structures (a urn:uuid:{uuid} key and its children), Archipelago will recreate it. If you modify any internal value contained in it, Archipelago will do nothing and will trust you (and if you do strange things like modifying the url something might even fail e.g in a IIIF Metadata Display Entity Twig Template). No data edit there will trigger a modification/moving/deletion of a File (or e.g write back EXIF to be binary). You will have time to revert to a previous revision (version) of the ADO if any manual change was done. So, should you modify/delete this structures? Almost never. Ever. But you might find needs for that someday. Also to be noted. Producing this structure for a large file in S3:// is intensive. It needs to be downloaded to a local path and if the File is a few Gigabytes in size Archipelago might even run out of PHP processing time. If that ever happens you can also copy/paste from a previous revision of the ADO the relevant piece. If archipelago finds it (implied in the previous explanation) it will not have to regenerate it. The AMI module does this in an async/enqueued way to avoid time out issues and can reuse a cached metadata extraction between runs, but when working directly on an ADO via e.g a webform or via RAW edit, take that in account. More work is being done to allow also one on one async File operations and larger uploads via the web.

    "},{"location":"metadatainarchipelago/#the-aptasks-keys","title":"The ap:tasks keys","text":"

    As mentioned briefly before, there is also Control Metadata. What do we mean with that? Control metadata in Archipelago's way of allowing you to give, through metadata, (that you might want to preserve or not) instructions to Archipelago that relate to processing. Let's start with the basic one:

    {\n    \"ap:tasks\": {\n        \"ap:sortfiles\": \"index\"\n    }\n}\n

    \"ap:sortfiles\" key will instruct Archipelago to sort (create a sequence key and a sequential number (integer value) inside each Metadata File entry of a as:{AS_FILE_TYPE} structure. Values can be one of ['natural', 'index', 'manual'] defaulting, if absent or has an invalid value, to natural. - natural: files will be sorted by File Name, the filename key found at the same level of sequence in the previously mentioned as:{AS_FILE_TYPE} structure. a Photograph_1.jpeg will come before a Photograph_10.jpeg. The way a human being naturally would order by name. - index files will be sorted by the order in which they appear inside the upload JSON key (the dr:for key, one of the keys mapped in the ap:entitymapping structure under entity:file explained before. e.g. images:[5, 10 , 1 ], would imply the File Entity with Drupal ID 5 would get \"sequence\": 1, the one with Drupal ID 10 will get \"sequence\": 1, etc. This is the default when ingesting via the AMI module given the need to preserve file order that has/might have unknown names or names you don't have control of (thus natural won't work) coming from e.g a Remote, HTTP/HTTPS location - manual: You can modify the values manually for any sequence key inside as:{AS_FILE_TYPE} structure and those values will stick.

    What do we mean with stick? Well, everytime archipelago gets a change in this \"ap:sortfiles\", e.g a new File is added, a File is deleted, automatic re-sorting will happen. 

    {\n    \"ap:tasks\": {\n        \"ap:forcepost\": true\n    }\n}\n

    \"ap:forcepost\": A boolean. The functionality of this key is provided by the Strawberry Runners Module. Will force Strawberry Runners Post processing for this ADO.

    Each Configured and active Postprocessor provided by the Strawberry Runners module might or not kick in by evaluating a set of rules. If rule evaluates to TRUE, the PostProcessor will generate a certain output., e.g a Solr Indexed Strawberry Flavor Data Source containing OCR, HOCR and NLP metadata for one or more pages of a PDF.

    Everytime a Create or Update operation on an ADO happens, these rules will be evaluated and the Processor will be enqueued as a future task. But at the moment of executing, when the queue workers take one item, a check will be made and if the result of a previous run (e.g HOCR) is already present in the system (e.g in Solr) and it's veryfied to be belonging to the same source, the actual heavyload of processing the PDF will be skipped.

    While testing, coding, doing complex changes in the system (like modifying largely the settings for one processor) or even in the case of an ISSUE (e.g HOCR was wrongly run with a setting that made all look like garbage!) you can instruct Archipelago run again without checks. And again. And again. basically everytime you Save an ADO by setting ap:forcepost to true. This can also be used batch and is already implied (means it does it for you but only once, without modifying the JSON) in the Trigger Strawberrry Runners process/reprocess for Archipelago Digital Objects VBO action we provide.

    In the absence of \"ap:forcepost\" the value is implicitly false, same as setting it explicitly to false.

    {\n    \"ap:tasks\": {\n        \"ap:nopost\": [\n            'pager'\n        ]\n    }\n}\n

    \"ap:nopost\": an array or list of ACTIVE_STRAWBERRY_RUNNERS_CONFIG_ID entries, means Machine names (or IDs) Strawberry Runners Processor Configuration Entities. The functionality of this key is provided by the Strawberry Runners. If not an array it will be ignored. Any value present not matching an active Strawberry Runners Processor Configuration Entity ID will also be ignored. Effectively, any post processors in this list will be skipped for this ADO. This allows a finer grained avoidance of some expensive processing that might lead to unsuable data. E.g a particular Manuscript ADO that Tesseract won't be able to OCR correctly. Adding this key to an ADO that was already processed won't remove existing generated/stored processing.

    {\n    \"ap:tasks\": {\n        \"ap:ami\": {\n            \"metadata_display\": 7\n\n        }\n    }\n}\n

    \"ap:ami\" is a newer key ( as of Archipelago 1.1.0 and AMI 0.5.0) and for now can only contain another single key named \"metadata_display\". The value of this one can be either a single Integer, the Drupal ID of a Metadata Display Entity or a string, the UUID of a Metadata Display Entity. The functionality triggered by this key is provided by the AMI module and will do something extremely powerfull: it will take the complete JSON and process through the Twig or Metadata Display Entity refererenced in its value, IF, and only IF, the output of that template is JSON. This runs before any other event (Archipelago runs a ton of events that validate, enrich, check, etc your ADOs from the moment you SAVE or Create it) and because of that allows you to totally pivot, transform, change RAW data coming into Archipelago, e.g via the JSON:API into the structure you need/want. Said differently, you could push JSON from a totally different system and if the referenced Metadata Display Entity is well written, end with a perfectly aligned JSON matching your internal structure without modifying the INPUT manually. Because Twig is very powerful you can also do cleanups, complex logic, etc. More over, you can transform any existing ADO via Batch by adding this key(s) and values using the JSON Patch VBO action. Once processed and if all went well, meaning the output of the Template is valid JSON, the key itself will be removed. This, to avoid running over and over (invisibly to you) on further operations/edits/etc. This is a one time operation that does not stick. What happens if it does not run well, fails, errors out or the Template referenced does not exist? You get a second change (everyone deserves one), the Original ingested JSON, without transformations is kept. All this is very similar to what the AMI module does via a CSV but in this case its atomic. We know what you are thinking. You can process data twice, via AMI and then at the end pass it again through another template based on a certain logic coming from the first? yes. you can!

    In the future \"ap:ami\" might contain more keys to do more advanced File level actions. Archipelago is being constantly enhanced!

    "},{"location":"metadatainarchipelago/#activity-stream","title":"Activity Stream","text":"

    Archipelago also keeps information about who/how a certain JSON was generated. Depending on how the Ingest/Edit of an ADO happened, this can be automatically generated or added manually (the case for AMI ingests).

    The structure is simple and not accumulative because there is also versioning at the ADO (Drupal) level that allows you to look back if needed.

    {\n     \"as:generator\": {\n        \"type\": \"Update\",\n        \"actor\": {\n            \"url\": \"http:\\/\\/localhost:8001\\/form\\/default-descriptive-metadata-ami\",\n            \"name\": \"default_descriptive_metadata_ami\",\n            \"type\": \"Service\"\n        },\n        \"endTime\": \"2022-03-16T15:51:24-04:00\",\n        \"summary\": \"Generator\",\n        \"@context\": \"https:\\/\\/www.w3.org\\/ns\\/activitystreams\"\n    },\n}\n

    The \"as:generator\" Conforms to the Activity Stream Vocabulary Version 2.0 and keeps track of the last Operation executed on an ADO. Edits and Ingests via the Webform Widget will create this automatically using the Canonical URL of the Webform That generated the content and \"type\" might be either \"Update\" or \"Create\". ADOs that were processed via \"ap:ami\" will have automatically one generated to express the fact that the Original JSON was modified by a Metadata Display Entity. Objects created via AMI and using a Metadata Display Entity can also add via the Twig template syntax the AMI Set ID used to generate the ADO (or Update) allowing the Service URL (\"url\") to be faceted/searched for (e.g show me all objects ingested via AMI Set with ID 4).

    "},{"location":"metadatainarchipelago/#all-the-other-keys-lists-objects-your-metadata","title":"All the other keys, lists, objects. Your Metadata","text":"

    Anything or everything else (including unknow data, future data, upcoming data) belongs to you. How you name it, how you structure, how it evolves is up to you and the functionality and integration you want. That said, as someone (the writer) that enjoys cooking and had to learn the hardway (experimenting and failing sometmes) the basics before doing proper meals for others to enjoy, we suggest you plan on this before inventing the next Open Schema.

    Note: Why the out-of-context Cooking Analogy?

    This idea is deeply embedded in our Architecture. We see Metadata as ingredients. Your JSON is your fridge (or pantry or both). Metadata Display Entities, and their Twig Templates, recipes that allow you to pick and choose Ingredients and your Twig coding skills (and filters, functions, loops and conditionals) your basic cooking skills. This analogy has many consequences:

    • You can plan upfront and have more ingredients (metadata keys and JSON structures) than what you need/know how to cook, your current Recipes allow. Planning for \"your future\" needs and skills (and imagination) is a big part of this
    • Reading, understanding and testing small changes on the existing recipes will give provide you with future skills and the ability to do similar, incremental better, meals before going for something totally new and complex
    • Keeping your Ingredientes RAW and unprocessed is a good idea. You might be tempted to store canned refried beans in the fridge, but that might limit your future options. Maybe try both until you feel more secure, the canned ones AND the dried, single beans too.
    • Your use cases might dictate where you start. You cook visually, starting with a very concrete Meal in mind? (means your plan is to make a certain Caserolle - in a less metaphoricall way, a certain well defined output Schema like MODS 3.7). So you need to be sure you have the ingredients that Schema at least requires and know how (or look and copy, MODS is provided already) to process the data. Or you are into a certain type of food? And want to have the most common ingredientes needed around, you might not know how to make all the different dishes but you for sure know Onions (and cutting those) is needed. This are just 2. So many ways of approaching Cooking.

    The Open Schema you will get from a Vanilla Archipelago already covers many many uses cases and was developed by a caring team of metadata professionals and practitioners working with Archipelago for a while already. It covers LoD and most Description needs for your Whys, Wheres, When, Who/Whom. Some tips:

    • Start by adding new Keys instead of removing existing ones. Existing keys might already be used in your Vanilla Archipelago (in their Processed form) in, e.g the Search API, as Key Name providers (means the target of a JMESPATH query that will be exposed to Drupal as a Field Property), in Views (Filters, Sorting of data). Or in Twig templates (as part of Recipees) that Provide data for Viewers, IIIF V2 and V3, or in your HTML Object Descriptions. Or a Webform configured to Edit/Create new ADOs. All these can be of course modified and adapted, but before spending too much time doing that experiment with adding a new Ingredient and incorporating it to either one of the many Outputs of Archipelago or writing a simple new Recipee that uses it.
    • Not all Metadata needs to be used. Want to keep track of your Workflows? Contextual cataloging data? Notes for other metadata professionals in your team? The command line used to capture a WACZ file? You can add that to your JSON. Might all come handy in the future. You don't need to display it at all if you don't want to.
    • Experiment with the Existing Webforms and Webform Elements. If you need to allow Metadata that is very unique in structure and values (and validation), try first generating the simplest structure via the shipped Webforms and their elements via the UI. If you feel Webform can not handle then maybe you are structuring it in a too complex way. Test adding and editing. Check the \"What if/what ifs\". Is your value correctly a string? Would it be better as a boolean or an integer? Think of the \"i want many values\" v/s this is a single value differences. Because you are in the presence of an OpenSchema you can always change your mind, still better to start on the correct track.
    • Give your keys meaningfull names for you/use case/others: property_1 might be hard to document for you. But original_artifact_in_collection might be better (and denotes semantically the value might be a boolean, true of false). Use plural and singular in your naming to denote that something might contain more than one entry. Try to be generic but assertive. mods_modsinfo_namepart is tempting but is already hinting a single original fixed schema. And you might end using the same value (the who) in Dublin Core, IIIF, schema.org, etc outputs. So mybe author instead? This also leads to: sometimes multiple keys are better than many deeply nested ones where understanding. You can keep authors and contributors in separate keys.
    • Document your keys in the Metadata Display Templates (JSON does not allow comments but also why would you want to document the same in every ADO, would be like writing notes on your Potatoes. The most obvious place to document are your recipees. If adding a new Key add a small note using {# #} explaining why/what it holds. You can also add Help/Extra info when designing your schema via a the Webform. Each element has extra properties to do so and that way you can also explain others (the ones using the Webform to add/edit) what the purpose of your metadata is.
    • Use a (or many) local Archipelago Deployment as your experimental Kitchen

    Do you have your own Kitchen/cooking tips you want to share? We hope you enjoy the learning process and the many choices Archipelago provides.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"metadatatwigs/","title":"Twig Templates and Archipelago","text":"

    Archipelago uses a fast, cached templating system that is core to Drupal, called Twig. In its guts (or its heart?) Archipelago uses this system to transform the close to your needs open schema metadata that lives in every strawberryfield as JSON into close to other one's fixed schema needs metadata. This is quite simple, but it is an essential component of our vision of how a repository should manage metadata.

    "},{"location":"metadatatwigs/#what-is-twig","title":"What is Twig?","text":"

    Twig is a template engine for PHP part of Symfony framework.

    • Twig in Symfony
    • Twig in Drupal
    • A template engine is a processor. It allows you to mix and process templates with data to generate an output document.
      • Template: Some type of static Document (we name this a \u201cFrame\u201d)
      • Data: Your Archipelago Digital Object (ADO) info and your Metadata
      • Processor: Allows you to use a rich and expressive language to pick, check, iterate, transform and output your data inside the Template. We refer to this as \u201ccasting\u201d.
    "},{"location":"metadatatwigs/#where-is-twig-used-in-archipelago","title":"Where is Twig used in Archipelago?","text":"

    This templating system is exposed to Archipelago users through the UI, and is stored in the repository as content. This setup empowers users to fully control how metadata is transformed and published without touching their individual sources or needing to manage hard-coded configurations. We named these readily accessible and powerful templates Metadata Display entities, but they serve more than just display needs.

    Twig drives every Page in a Drupal 8/9/10 environment.

    • Twig templates are normally files (.twig.html) that live in your Code.
    • Modules provide Templates, Themes provide Templates

    Twig drives every aspect of your ADO exposure to the world in Archipelago and even batch Ingest.

    • Strawberryfield Metadata (JSON, your Data) is passed through a Metadata Display Entity which holds:
      • A Twig template (so you do not need to edit Files)
      • A desired output serialization format (the Output Document)
    "},{"location":"metadatatwigs/#twig-templates-as-metadata-display-entities","title":"Twig Templates as Metadata Display Entities","text":"

    Templates or recipes can be shared, exported, ingested, updated, and adapted in many ways. This means you can make changes quickly without having to wait for the next major release of Archipelago or your favorite Metadata Schema Specs Committee\u2019s agreement to implement the next or the last version. This module not only handles metadata but media assets as well. It will extract local or remote URIs and files from your metadata and render them as media viewers: books, 3D models, images, panoramas, A/V, all with IIIF in its soul.

    Metadata Display Entities are used for:

    • Display:
      • ADO landing pages (via Drupal Field Formatter)
      • IIIF or JSON driven viewers (via Drupal Field Formatter and using Exposed Metadata Endpoints)
      • Map Formatter (Drupal Field Formatter)
      • Custom Blocks (Drupal Views)
      • Search Result Displays (Drupal Views)
      • Collection and Creative Work Series (old compound) displays (Drupal Views)
    • Machinable Output
      • Exposed Metadata Endpoints (Standalone URLs to access metadata)
    • Batch Ingest
      • AMI Ingest: To transform your CSV data (one row == DATA) to Strawberry field JSON to generate an ADO
    "},{"location":"metadatatwigs/#twig-templates-shipped-with-archipelago","title":"Twig Templates Shipped with Archipelago","text":"

    Archipelago Ships with:

    • IIIF Manifest V3 for Images (JSON-LD) Metadata Display
    • IIIF Manifest V2 for Images and Documents (JSON-LD) Metadata Display
    • IIIF Manifest V3 for Collections (JSON-LD) Metadata Display
    • IIIF Manifest V3 for Creative Work Series/Compound Objects Parent and Children (JSON-LD) Metadata Displays
    • A General ADO Description (HTML) Metadata Display
    • A Linked Data Display (HTML) Metadata Display
    • GEOJSON (JSON) Metadata Display
    • An AMI (JSON) Ingest Template
    • A Multiple Thumbnails via IIIF and Fontawesome (HTML) Metadata Display
    • A Metadata Abstract for Search Results (HTML) Metadata Display
    • A Simple Dublin Core (XML) Metadata Display
    • MODS 3.7 (XML) Metadata Display
    • A Schema.org (JSON-LD) Metadata Display
    • Carousel (in Bootstrap) for Images (HTML) Metadata Display

    You can find these templates here:

    • On Github:
      • Local Deployment
      • Live/Production Deployment
    • In your local instance: http://localhost:8001/metadatadisplay/list
    • In your live instance: https://yourdomain.org/metadatadisplay/list

    Archipelago (the humans) will keep adding and refining these with every release.

    "},{"location":"metadatatwigs/#instructions-and-examples","title":"Instructions and Examples","text":"

    While a lot of core needs and use cases are covered with the Twig Templates shipped with Archipelago, you may want to add more Input elements to your Webforms, which in turn will generate new JSON Values, which in turn you may want to show/expose to end users.

    Knowing (even if you do not plan to) how to edit or create your own Twig templates is important.

    • This guide covers the Basics of Working With Twig in Archipelago
    • This section contains Full Examples of Common Use Cases
    • This section covers a Recommended Workflow
    • You may also want learn more about what format_strawberryfield can do and what many other possibilities are exposed through our templating system in this guide: Strawberryfield Formatters.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"modifyingfileextensionsinwebform/","title":"Customizing Webforms (Modifying allowable file extensions)","text":"
    • Webform
    • Webform Elements
    • File Extensions
    "},{"location":"modifyingfileextensionsinwebform/#customizing-webforms-modifying-allowable-file-extensions","title":"Customizing Webforms: Modifying allowable file extensions","text":"

    A guide to walk users through how to modify the Webform Descriptive Metadata to allow additional file extensions to be ingested into Archipelago. This is the default Webform with Archipelago by following archipelago-deployment.

    "},{"location":"modifyingfileextensionsinwebform/#context","title":"Context","text":"

    When creating an Archipelago Digital Object (ADO), on Step 4 of the ingest, Attach Files, there is a step during the ingest to upload the files associated with your ADO. There will be a section on the Webform outlining the maximum number of files allowed, the maximum file size allowed, and the allowed file extensions that can be uploaded.

    Let's say we are creating an ADO with the media type DigitalDocument and this ADO contains a data set saved as a csv file, but when we get to Step 4 of the ingest workflow we find that csv is not an allowed file extension. Fortunately, Archipelago has no restrictions on what file extensions can be uploaded, but some use cases will require a little configuring to fit a specific need. This guide will walk users through the steps to modify the default Webform, Descriptive Metadata, to allow additional file extensions to be included during an ingest.

    Prerequisites for following this guide:

    • Running instance of Archipelago (on http://localhost:8001 if you followed the deployment guide verbatim)
    • Admin credentials
    "},{"location":"modifyingfileextensionsinwebform/#lets-begin","title":"Let's begin!","text":""},{"location":"modifyingfileextensionsinwebform/#managing-webforms","title":"Managing Webforms","text":"

    Once logged in as admin, the first thing we need to do is navigate to the Webforms page so we can edit the Webform Descriptive Metadata. Click on Manage, then Structure and when the page loads, scroll down and click Webforms.

    This is where all of the Webforms inside your Archipelago live. For this guide we're going to edit the Webform Descriptive Metadata. Go ahead and click Build under the OPERATIONS column for Descriptive Metadata.

    "},{"location":"modifyingfileextensionsinwebform/#step-3-editing-elements","title":"Step 3: Editing Elements","text":"

    Here we see all of the elements in Descriptive Metadata; Title, Media type, Description, Linked Data elements, etc. The element that we want to edit is Upload Associated Documents as this is the field you will use to upload pdf, doc, rtf, txt, etc. files during the ingest workflow. Click on Edit under the OPERATIONS column.

    A new screen will pop up named Edit Upload Associated Documents element. This is where you can configure the maximum number of values (under ELEMENT SETTINGS), the maximum file size and also edit the allowed file extensions for this element, which is what we'll be doing. The latter both exist under FILE SETTINGS section, highlighted in the screenshot below.

    When you scroll down you'll see the Allowed file extensions field. This is where we will add the csv file extension. Please note: All file extensions are separated by a space; no , or . between the values.

    Once you've added all the file extensions your project needs, scroll down to the bottom of Edit Upload Associated Documents element and click Save.

    This next step is imperative for saving your changes, scroll to the bottom of your elements list page and click Save elements in order to persist all changes made.

    "},{"location":"modifyingfileextensionsinwebform/#complete","title":"Complete","text":"

    Woohoo! Now when you are ingesting a DigitalDocument object, you will be able to add csv files! \ud83c\udf53

    "},{"location":"modifyingfileextensionsinwebform/#recap","title":"Recap","text":"

    When logged in as an admin, we go to Manage > Structure > Webforms and click on Build under the OPERATIONS column of Descriptive Metadata (shortcut: /admin/structure/webform/manage/descriptive_metadata). Then we click on Upload Associated Documents to edit the element, scroll down to the Allowed file extensions field and add csv without . or , separating the values. Click Save at the bottom of the Edit Upload Associated Documents element page and then Save elements at the bottom of the Webform page.

    "},{"location":"modifyingfileextensionsinwebform/#that-was-helpful-but","title":"That was helpful, but...","text":"How do I upload a wav or aiff file for \"MusicRecording\" or an mov file for a \\\"Movie\\\"?

    The steps are virtually the same as what is outlined in this guide! The difference here is that instead of editing Upload Associated Documents, you will need to edit the field element that is associated with your ADO's media type. For example, with Media type MusicRecording, you will edit Upload Audio File, for Movie, will edit Videos.

    How do I know which element in Descriptive Metadata to edit per media type?

    When editing an element inside Descriptive Metadata, at the top of the window Edit Upload Associated Documents element (see Step 3 for a recap on how to get here) there is a tab next to General titled Conditions. Inside of Conditions we have CONDITIONAL LOGIC which is where the Webform is told which Media type needs this element to be visible in the Webform. In the example below, we know that the field element Upload Associated Documents will be visible when DigitalDocument, Thesis and Book are the selected Media type.

    This is also the place you can add new logic or delete present logic by clicking the + or - next to the TRIGGER/VALUE to create new conditionals.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"ourtake/","title":"Archipelago's Philosophy & Guiding Principles","text":"

    Archipelago operates under a different concept than the one we all have become used to in recent times. We like to think this is not done by re-inventing the wheel, but by making sure the road is clean, level, and with fewer obstacles than before. We do this by removing some heavy weight from the top, some unneeded ballast, plus, of course, some well positioned innovations to make the ride enjoyable.

    We also like to say that Archipelago is like a Metadata Synthetizer (LFO anyone?) and we want to give you all the knobs, parameters, inputs and outputs to make the best out of it. Still, you can make \"music\" by just tapping the keyboard.

    To get here we had to do a full stop first. Look around. Questioning everything we knew. Research and test (repeat) and then re-architect slowly on new and old assumptions, and especially new community values.

    "},{"location":"ourtake/#whys-and-whats-of-archipelago","title":"Whys and Whats of Archipelago","text":"

    Because this topic is near and dear to our hearts, we are taking extra care with writing this important document. Please stay tuned for the full, verbose, heartfelt, and detailed long story of Archipelago's origins, development, future hopes and dreams.

    In the meantime, please consider reviewing this presentation created by Archipelago's Lead Architect Diego Pino which captures the essence of Archipelago's philosophy and guiding principles:

    • Archipelago : an empathic Digital Repository Architecture

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"presentations_events/","title":"Archipelago Presentations, Events, and Additional Resources","text":"

    Important General & Internal Recordings Notes

    Please be aware that some of the presentation documents shared above may contain links to older documentation resources that have since changed or are no longer available. We recommend referring to the latest documentation versions available on this site whenever needed.

    METRO's Digital Services Team facilitated many different internal training sessions throughout 2020-2022. If you and your team need access to any of these sessions that were recorded, please contact us. Thank you!

    "},{"location":"presentations_events/#2023","title":"2023","text":"

    • IIIF Search API and Dynamic/evolving Manifest Generation: Facing the Unknown. Diego Alberto Pino Navarro, Allison Sherrick.

      • \ud83d\udcfa Recording available

    • DLF Forum (November 2023)

      • Working and Learning the IIIF Search API in Archipelago. Diego Pino Navarro, Allison Sherrick.
      • Working with Open-Schema JSON in Archipelago. Allison Sherrick, Diego Pino Navarro, Martha Tenney, Joanna DiPasquale, Corinne Chatnik.
      • Slaying the Migration Dragon: Approaches to Navigating an Open Source System Migration. Lisa McFall, Sarah Walden McGowan, Brenden McCarthy, Shay Foley.

    • IIIF Annual Conference (June 2023)

      • Experimental IIIF Kitchen using Archipelago. Pino Navarro, Diego; Sherrick, Allison.
      • Mapping an Engineer Through IIIF. Monger, Jenifer J.; McCarthy, Brenden; Pino Navarro, Diego; Sherrick, Allison.

    • Into Archipelago Commons: Access, Innovation and Community in Modern Archives. Monger, Jenifer J.; McCarthy, Brenden; Corinne Chatnik. (June 2023)

    • Implementing Archipelago: An Innovative, Community Driven, Open-Source Repository. Corinne Chatnik, Union College; Martha Tenney, Barnard College. (June 2023)
    • For the Love of Data and Ourselves: The Bumpy, Technical Road to Modern Archives. Monger, Jenifer J.; McCarthy, Brenden. (January/February 2023)
    "},{"location":"presentations_events/#2022","title":"2022","text":"

    • Archipelago Late 2022 Workshop Series:

      • Session 1 : AMI Essentials and Tricks of the Trade. Pino Navarro, Diego; Sherrick (Lund), Allison; Romabiles, Katie. (November 2022)
        • \ud83c\udfa5 Recording available (registration required)
      • Session 2: Twig Templating and Metadata Display Preview for AMI Ingest. Pino Navarro, Diego; Sherrick (Lund), Allison; Romabiles, Katie; Min, Albert. (December 2022)
        • \ud83c\udfa5 Recording available (registration required)
      • Session 3: AMI Set Processing and Advanced Find + Replace (December 2022)
        • \ud83c\udfa5 Recording available (registration required)

    • McCarthy, B. J. (2022). Archipelago Commons: Using the Archipelago and AMI software to provide access to Rensselaer Polytechnic Institute's engineering drawings, a pilot project. Issues in Science and Technology Librarianship, 101. https://doi.org/10.29173/istl2717

    • Open Perspectives Forum. Monger, Jenifer J.; McCarthy, Brenden. (November 2022)

    • Migration, Collaboration and Innovation with Archipelago Commons. Monger, Jenifer J. (September 2022)

    • \ud83c\udf53 Archipelago 1.0.0 - August 2022 Release Announcement (August 2022) and updated Specs and Features List

    • Open Repositories June 2022

      • Collaborative W3C Web Annotations using Annotorious in Archipelago and computer vision explorations as cataloger aids. Pino Navarro, Diego; Simon, Rainer.
      • Modern Web Archiving with Archipelago and Webrecorder : WACZ, Replay.web and Deep Discovery in Digital Repositories. Pino Navarro, Diego; Kreymer, Ilya.
      • Working with IIIF Manifests in Archipelago. Sherrick (Lund), Allison.

    • Formation of the Archipelago Working Group (April 2022)

      • In the Spring of 2022, METRO supported the creation of a select group of both early adopters and longtime members of the Archipelago community to provide a dedicated space for Archipelago power users to build upon their demonstrated use-explorations, contribute further to the platform and have a direct influence on roadmap code, direction, and timeline. This group will also work on documentation needs, use cases and outreach (including public showcases, trainings/workshops, and other events).
    Archipelago Working Group Members
    • Giancarlo Birello at CNR Italy
    • Jennifer Palmentiero at SENYLRC
    • Brenden McCarthy at RPI
    • Lisa McFall at Hamilton College
    • Megan Tyne at Association Montessori Internationale\u00a0
    • Carl Jones at MIT Libraries
    • Martha Tenney at Barnard College Library
    • David Bass / Max Bronsema at Western Washington University
    • Sarah Walden McGowan at Amherst College
    • Prashanth B at Vipassana Research Institute
    • Ianthe Sutherland at University at Edinburgh
    • Corinne\u00a0Chatnik at Union College
    • Toward Empathetic Digital Repositories: An Interview with Diego Pino Navarro (January 2022)
    "},{"location":"presentations_events/#2021","title":"2021","text":"

    • \ud83c\udf53 Archipelago 1.0.0-RC3 and 1.0.0 Release Announcement - November 2021

    • AMIA Conference Workshop: Building a Web Archive-Capable Digital Repository with Webrecorder and Archipelago. Kreymer, Ilya; Ramirez-Lopez, Lorena; Dickson, Emma; Pino Navarro, Diego; Sherrick (Lund), Allison. (November 2021)

    • Solr Importer AMI Migrations, Showcase and Roundtable. Pino Navarro, Diego; Sherrick (Lund), Allison. (July 2021)

      • Please see latest I7 Solr Importer and AMI LoD Reconciliation documentation.

    • IIIF Annual 2021 Conference:

      • Learning & Working with IIIF in Archipelago - 2021 IIIF Annual Conference. Pino Navarro, Diego; Sherrick (Lund), Allison. (June 2021)
      • Editing a IIIF Manifest in Archipelago. Pino Navarro, Diego; Sherrick (Lund), Allison.

    • June 2021 Open Repositories Conference:

      • Europeana Data Model (EDM) Workflows in Archipelago. Pino Navarro, Diego; Sherrick (Lund), Allison.
        • \ud83d\udcfa Recording available
      • 'Broken for All' Persistent Identifiers Panel Discussion. Kunze, John; Holmes-Wong, Deborah; Rafique, Zahid; Lohnash, Megan; Sherrick (Lund), Allison; Turner, Adrian; McKinley, Matthew.
        • \ud83d\udcfa Recording available

    • WebRecorder + Archipelago Workshop. Pino Navarro, Diego; Sherrick (Lund), Allison; Kreymer, Ilya; Ramirez-Lopez, Lorena; Dickson, Emma. (May 2021)

      • \ud83d\udcfa Recording available

    • Twig Templates and Archipelago. Pino Navarro, Diego; Sherrick (Lund), Allison. (May 2021)

      • Review of the core role Twig templating plays in Archipelago, introduction to the basics of Twig, and demonstration of editing Twig templates in Archipelago to refine metadata displays and AMI ingests.
      • \ud83c\udfa5 Recording available (registration required)

    • \ud83c\udf53Archipelago 1.0.0-RC2 Release Announcement (May 2021) and Archipelago RC2 Specs and Features List

    • Working with Archipelago Multi-Importer (AMI). Pino Navarro, Diego; Sherrick (Lund), Allison. (April 2021)

      • Introduction to AMI, discussion of ingest strategies and options, and demonstration of an AMI ingest.
      • \ud83d\udcfa Recording available

    • Archipelago Digital Objects Repository (an) architecture to last. Pino Navarro, Diego. (DrupalCon North America 2021)

      • \ud83d\udcfa Recording available

    • Metadata, Schemas and Media in Archipelago. Pino Navarro, Diego; Sherrick (Lund), Allison (February 2021)

      • Exploration of the flexible and extensible ways Archipelago manages Metadata, Schemas, and Media.
      • \ud83c\udfa5 Recording available (registration required)

    • Deploying Archipelago 1.0.0-RC1. Pino Navarro, Diego; Sherrick (Lund), Allison. (February 2021)

      • Demonstration of a complete walkthrough of a local Archipelago 1.0.0-RC1 deployment.
      • \ud83c\udfa5 Recording available (registration required)
    "},{"location":"presentations_events/#2020","title":"2020","text":"

    • \ud83c\udf53 Archipelago 1.0.0-RC1 Release Announcement (December 2020)

    • Webforms in Archipelago. Pino Navarro, Diego; Sherrick (Lund), Allison; Palmentiero, Jennifer. (December 2020)

    • IIIF and Archipelago - Community Call. Pino Navarro, Diego. (October 2020)

    • Archipelago : an empathic Digital Repository Architecture (September 2020)

    • \ud83c\udf53 Archipelago 8.x-1.0-beta3 Release Announcement (July 2020)

    "},{"location":"presentations_events/#we-should-be-here","title":"We should be here","text":"

    If you have a public Archipelago presentation, recording, or other resource you'd like to share on this page \ud83c\udfdd\ufe0f\ud83d\udccd, please contact us. We would love to add your great work to this list! \ud83d\udc9a

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"search-within-collection/","title":"How to Add a 'Search Within Collection' Block","text":"

    This guide covers how to add a 'Search Within Collection' Exposed Form Block to the default Archipelago Collection Display Page.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#preamble-prerequisites","title":"Preamble + prerequisites","text":"

    Before diving into any Search and Solr configuration related changes, we strongly recommend that you read our Metadata in Archipelago overview documentation, which provides important context for understanding how the shape of your Archipelago Digital Objects/Collections (ADOs) metadata will inform your Search and Solr options and outcomes. If you don't have the bandwidth to read the (stellar) Metadata in Archipelago documentation, we recommend you read through our in-a-nutshell overview.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-1-open-the-collection-membership-view","title":"Step 1: Open the Collection Membership View","text":"

    Navigate to the Collection Membership view found at:

    • /admin/structure/views/view/collection_membership
    • Through the Structure menu > Views > Collection Membership

    This View is setup to list the member Digital Objects of a Collection and is driven by Solr.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-2-adjust-the-views-advanced-tab-settings","title":"Step 2. Adjust the View's Advanced tab settings","text":"

    Open the 'Advanced' tab settings and change the 'Exposed form in block' to 'Yes'.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-3-add-the-fulltext-search-filter-criteria-for-the-view","title":"Step 3. Add the Fulltext Search Filter Criteria for the View","text":"

    On the left-hand side of the Collection Membership View form, under the 'Filter criteria' section, add and configure the 'Fulltext search' Criteria.

    At the top of the 'Configure filter criterion: Search: Fulltext search' form that opens:

    • Select the option to 'Expose this filter to visitors, to allow them to change it'.

    On the lower section of the form, adust the configuration options as follows:

    • Remove any text from 'Label' or 'Description
    • Operator: select/check 'Contains all of these words'
    • Allow multiple selections : leave unchecked
    • Remember the last selection : leave unchecked
    • Filter identifier: leave default of 'search_api_fulltext'
    • Placeholder: enter 'Search within Collection' (or your preferred text)
    • Search field character limit: set to '128'
    • Expose searched fields : leave unchecked
    • Searched fields : leave all unselected, so \"If no fields are selected, all available fulltext fields will be searched.\"
    • Minimum keyword length : set to '1'

    Select 'Apply' and continue to the next Step.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-4-reviewadjust-options-and-save-the-updated-view","title":"Step 4. Review/adjust options and Save the Updated View","text":"

    Review the changes you made to the Collection Membership View. Optionally further adjust the options if desired. For example, you may choose to change the Submit button text to 'Search' instead of 'Apply'). If you make any further changes select, 'Apply' before exiting.

    'Save' your changes made to the View before proceeding.

    Your updated Collection Membership View should look like the following now:

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-5-place-the-exposed-form-block","title":"Step 5. Place the Exposed Form Block","text":"

    Navigate to the Block Layout found at:

    • /admin/structure/block
    • Through the Structure menu > Block layout

    Select the Archipelago Base Theme (or whatever theme you are using):

    • admin/structure/block/list/archipelago_subtheme

    Navigate to the 'Content' section of the theme and select 'Place Block'.

    Search for the 'Exposed form: collection_membership-block_1' and select 'Place Block'.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-6-configure-the-blocks-settings","title":"Step 6. Configure the Block's Settings:","text":"

    Configure the different settings for the Block.

    You will need to specify both of the following options under the Visibility section:

    • ADO Type: specify Collection (and any other Collection types you may also have such as 'Newspaper')

    • Content type: select 'Digital Object Collection'

    In the top section of the form, we recommend the following settings:

    • Deselect 'Display title'
    • Under Exposed Form element and component Visibility, deselect the following:
      • Show filter components of type select if exposed
      • Show filter components of type checkbox/options if exposed
      • Override Submit button Label

    Select 'Save block' when you are finished configuring the Block's Settings.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-7-position-the-block-and-save","title":"Step 7. Position the Block and Save.","text":"

    Drag to re-order and position the Exposed Form Block to sit above the Collection Membership block in the Content section. This will position the Exposed Form Block above the list of Collection Member Objects on the display pages for Collections.

    After you have positioned the blocks, scroll down to the bottom of the Block layout page and select 'Save blocks'.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-8","title":"Step 8.","text":"

    Navigate to a Collection and test out a Search in the search box that is now in place above the 'Objects in this Collection' listing.

    In this screenshot, you can see a demonstrative Search for 'map' within one of the Archipelago Demo Collections.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#additional-considerations","title":"Additional Considerations","text":"

    You may also wish to pair this 'Search Within Collection' Exposed Form Block with related Facets (setup on the same corresponding collection membership View). You can find follow the step-by-step instructions in our Strawberry Key Name Providers, Solr Field, and Facet Configuration documentation.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search_advanced/","title":"Advanced Search","text":"

    To provide Advanced Search functionality, Archipelago extends a custom Search API based Fulltext Filter for (Drupal) Views. This special 'Search: Advanced Fulltext search' filter is capable of handling multiple inputs with a combination of Boolean Operators, and features additional customizable options for tailoring your Archipelago's Advanced Search setup.

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#default-advanced-search","title":"Default Advanced Search:","text":"

    The default Advanced Search setup shipped with standard Archipelago deployments is intended to serve as an initial blueprint for your own learning and further customizations. Your Archipelago instance, whether you are working in a modified local or production deployment, may not have the same corresponding Solr Fields and/or Facets as present in the default Advanced Search configuration. This guide covers the default Advanced Search Setup, and offers general guidance for customizing to match your desired Advanced Search setup for your unique environment variables (metadata elements/schema found in your JSON data, Keyname combinations, Solr fields, etc.).

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#where-to-find-and-corresponding-configurations","title":"Where to Find and Corresponding Configurations","text":"

    In default Archipelagos, you can find Archipelago's default Advanced Search page:

    • Through the top navigation menu > Advanced Search
    • Directly at /advanced-search

    The default Advanced Search Page includes the following:

    • Advanced Fulltext Search form (more information on the out-of-the-box View settings associated with this form below)
    • Five Facets for narrowing your results (Date of Original, Digital Object Type, Collection Membership, Subjects, and Agents)
    • A Facet Summary section (visible only after selecting Facets)
    • Custom Block containing a Default Advanced Search Note

    The five Facets associated with the default Advanced Search can be found at Administration > Configuration > Search and metadata > Facets under the Facet source - search_api:views_page__advanced_search__page_1.

    The Custom Block containing the Default Advanced Search Note can be found at /admin/content/block or as a Tab on the main Content page.

    The corresponding Facet Blocks and Custom Block can be found at /admin/structure/block/list/archipelago_subtheme in the Sidebar Second section. Please see the this documentation for more information about Keyname Providers, Solr Fields, and Facet Configurations

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#advanced-search-view","title":"Advanced Search View","text":"

    The default Advanced Search View drives the Advanced Search Form. This View can be found at:

    • /admin/structure/views/view/advanced_search
    • Through the Structure menu > Views > Advanced Search

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#configuring-the-filter-criteria-for-the-search-advanced-fulltext-search","title":"Configuring the filter criteria for the 'Search: Advanced Fulltext search'","text":"

    To view or adjust the configurations click on 'Search: Advanced Fulltext search (and)' in the 'Filter criteria section in the View. You will then see the first part of the following configuration form:

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#part-1-of-the-advanced-search-filter-form","title":"Part 1 of the Advanced Search Filter Form","text":"

    Beginning at the top of the form, you will see:

    • Brief note explaining that the Advanced Fulltext search filter can 'Search several or all fulltext fields at once allowing also multiple operator separated entries'
    • Option to 'Expose this filter to visitors, to allow them to change it'
      • checked in default
    • Option to marked as 'Required'
      • unchecked in default
    • Label: Text field to enter Label for this filter
      • set to 'Advanced Fulltext search' in default
    • Description: Text field to enter brief description for this filter.
      • Tokens are allowed in this field. Replacement options can be found in the \"Global replacement patterns\" section, below.
      • empty in default

    You will then see a section for configuring the starting Operator to use for the form:

    • Contains all of these words
      • checked in default
    • Contains any of these words
    • Contains none of these words
    • A note that 'Depending on the parse mode set, some of these options might not work as expected. Please either use \"Multiple words\" as the parse mode or make sure that the filter behaves as expected for multiple words.'
    • An optional starting Value
      • empty in default

    Next is the beginning of the fuller Operator and Additional Options:

    • Option to 'Expose operator'
      • Allow the user to choose the operator
      • checked in default
    • Option to 'Limit the available operators'
      • Limit the available operators to be shown on the exposed filter
      • unchecked checked in default
      • recommended to enable for Classic Mode (see further notes related to Classic Mode below)
    • Operator identifier: Text field to specify 'the URL after the ? to identify this operator'
      • set to 'sbf_advanced_search_api_fulltext_op' in default
    • Option to 'Allow multiple selections' (Enable to allow users to select multiple items)
    • Option to 'Remember the last selection' (Enable to remember the last selection made by the user)
    • Parse mode : dropdown menu to choose how the search keys will be parsed
      • Direct query
      • Single phrase
      • Multiple words *selected by default and strongly recommended to keep
      • Multiple words with EDisMax
      • Multiple words with fuzziness
      • Phrase search with sloppiness Multiple words with sloppiness
    • Filter identifier : Text field to specify what will appear in the URL after the ? to identify this filter
      • Cannot be blank. Only letters, digits and the dot (\".\"), hyphen (\"-\"), underscore (\"_\"), and tilde (\"~\") characters are allowed.
      • set to 'sbf_advanced_search_api_fulltext' in default
    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#part-2-of-the-advanced-search-filter-form","title":"Part 2 of the Advanced Search Filter Form","text":"
    • Placeholder : Text field to enter hint text that appears inside the field when empty
      • empty in default
    • Note about the 'Multiple words' parse mode (selected earlier in the form)
      • The query is interpreted as multiple keywords separated by spaces. Keywords containing spaces may be \"quoted\". Quoted keywords must still be separated by spaces. Keywords can be negated by prepending a minus sign (-) to them.
    • Search field character limit : specify the maximum number of characters to allow as keywords input.
      • set to 128 in default
    • Option to 'Expose searched fields', which allows users to narrow the search to the desired fields.
      • checked in default
    • Searched fields identifier : text field to specify the URL after the ? to identify this searched fields form element.
      • set to 'sbf_advanced_search_api_fulltext_searched_fields' in default
    • Option to have 'Multiple/add more Search Fields'
      • This allows users to add more Search Fields with the same general exposed settings. All identifiers passed by this filter in the URL after the ? will get an incremental suffix.
      • checked in default

    • Max number of Multiple/add more Search Fields the user can expose.

      • The number of additional search Fields with the same general exposed settings the user will be able to expose.
      • set to a value of '4' in default

    • Searched fields

      • Select the fields that will be searched. If no fields are selected, all available fulltext fields will be searched.
      • The options exposed here will be dependent on your configured Solr Fields.
      • Fields selected by default include:
        1. Content > Strawberry (Descriptive Metadata source) > local_identifier
        2. Content > Strawberry (Descriptive Metadata source) > name
        3. Rendered HTML output
        4. Content > Title FullText

    • Min number of Multiple/add more Search Fields the user will see.

      • Number must be less or equal to the max. If not it will cap automatically.
      • The number of search Fields with the same general exposed settings the user will see by default.
      • set to a value of '1' in default

    • Minimum keyword length

      • Minimum length of each word in the search keys. Leave empty to allow all words.
      • empty in default
    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#part-3-of-the-advanced-search-filter-form","title":"Part 3 of the Advanced Search Filter Form","text":"

    In the last part of the form, you will see:

    • Label to be used for the \"add one\" button

      • \"Label to be used for the \"add more\" button. By default it is \"add one\" if left empty
      • empty in default

    • Replacement pattern for user facing Fields.

      • In this text area, you will have the option to supply your preferred user-facing label for your selected search fields.
      • You will see all of the fields available in your Solr.
      • You supply your preferred labels and set the user-facing dropdown ordering for your targeted fields being used.
      • Use a Pipe (|) to separate value from desired label. One per line
      • To adjust the label for a field, replace the text following the pipe (|) symbol in the string to your preferred label.
      • Field label adjustments and order specified selected by default include:
        1. rendered_item|Rendered HTML Output
        2. title|Title (full text)
        3. name_1|Names/Agents
        4. local_identifier|Local Identifier

    • Label to be used for the \"remove one\" button
      • \"Label to be used for the \"add one\" button. By default it is \"remove one\" if left empty
      • set to 'remove' in default
    • Option to 'Expose between search fields operator'
      • Allow the user to choose the operator between Multiple Search Fields (AND/OR)
      • checked in default
    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#classic-mode","title":"Classic Mode","text":"
    • Option to 'Use Classic Mode' : When you select the 'Classic Mode', your Advanced Search form will interact in a way that mimics older catalog search interfaces. This means that:
      • when you add/remove fields, this does not trigger automatic refreshing of the Search results
      • search only triggers on the default Form Filter submit button
      • this mode fully depends on Javascript to get around Views Exposed Filters in forms always submitting on any interaction.
      • unchecked in default

    If you specify to 'Use Classic Mode', you will also see:

    • Option to 'Add a Remove button to every Advanced Search Field combo.'

      • This will allow a user to remove a specific Advanced Search Field/And/or/Text. Only works on Classic Mode.
      • only appears on form when 'Use Classic Mode' is enabled, hidden and unchecked in default
      • strongly recommended to enable for Classic Mode setups

    • Please see above note in Part 1 of the Advanced Search Filter Form to also select the option to 'Limit the available operators' when using Classic Mode.

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#end-of-advanced-search-filter-form","title":"End of Advanced Search Filter Form","text":"

    For both the normal, modern Advanced Search setup and also with Classic Mode enabled, you will also see:

    • Multiple/add more Search Fields operator (AND/OR) fields identifier

      • Text field to specify what will appear in the URL after the ? to identify the operator used in the filter when multiple Search Fields and their extra options are exposed.
      • set to 'sbf_advanced_search_api_fulltext_group_operator' in default

    • You will also see a section for 'Global replacement patterns (for description field only), where you can Brose available tokens for this purpose.

      • No replacement patterns specified for the View Description field in default. Not recommended.
    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#example-query-test","title":"Example Query Test","text":"

    In your local or fresh live Archipelago deployment, populated with the Archipelago Demo Set Objects and Collections, test your Advanced Search setup using the following query: - 'Contains all of these words' + the term 'Art' in the 'Rendered HTML Output' Field - 'OR' operator + 'Contains all of these words' + the term 'Diego' in the 'Names/Agents' field - Select the 'Archipelago Demo Collection' from the Collection Membership Facet

    You should see the following results:

    The corresponding advanced search url should be: - http://localhost:8001/advanced-search?sbf_advanced_search_api_fulltext_op=and&sbf_advanced_search_api_fulltext=Art&sbf_advanced_search_api_fulltext_searched_fields=rendered_item&sbf_advanced_search_api_fulltext_advanced_search_fields_count=2&sbf_advanced_search_api_fulltext_group_operator_1=or&sbf_advanced_search_api_fulltext_op_1=and&sbf_advanced_search_api_fulltext_1=Diego&sbf_advanced_search_api_fulltext_searched_fields_1=name_1&f%5B0%5D=is_member_of_content_title%3AArchipelago+Demo+Collection&op=Search

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_solr_index/","title":"Search and Solr","text":"

    Archipelago's default Search and Solr configurations are intended to cover the most common needs for a typical repository search experience.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"search_solr_index/#preamble-prerequisites","title":"Preamble + prerequisites","text":"

    Before diving into any Search and Solr configuration changes, we strongly recommend that you read our Metadata in Archipelago overview documentation, which provides important context for understanding how the shape of your Archipelago Digital Objects/Collections (ADOs) metadata will inform your Search and Solr options and outcomes.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"search_solr_index/#archipelago-and-solr","title":"Archipelago and Solr","text":"

    Archipelago's latest Release (1.1.0) uses Apache Solr 9.1, which incorporates some major improvements and changes from Solr 8. Please refer to the primary Solr documentation for the most comprehensive and in-depth information about Solr's wide breadth of functionality and configuration options.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"search_solr_index/#ocr-highlights","title":"OCR Highlights","text":"

    Archipelago uses solr-ocrhighlighting v0.8.4, built by the Development Team at the Bavarian State Library. See our Strawberry Runners Post-Processing documentation for more information about configuring page-based HOCR/OCR extraction for image and pdf-based ADOs and options for sending that output to the Search API.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"search_solr_index/#in-a-nutshell-json-data-to-strawberry-keyname-providers-to-solr","title":"In-a-nutshell : JSON data to Strawberry Keyname Providers to Solr","text":"

    If you don't have the bandwidth to read the (stellar) Metadata in Archipelago documentation, focus on the following in-a-nutshell understanding of the way Archipelago's Search and Solr is crafted. Then follow the step-by-step instructions found in Strawberry Key Name Providers, Solr Field, and Facet Configuration to get started customizing your Search setup.

    1. JSON Data for your Archipelago Digital Objects: you need to have your descriptive metadata in JSON keys and values for ADOs and Collections in your Archipelago. Your JSON metadata and (extracted technical) data is the crucial source for Search and Solr.

    2. Strawberry Keyname Providers: you need to have corresponding Strawberry Keyname Providers configured to feed the values from your desired JSON keys to Solr fields. One of the most powerful tools in Archipelago's Search functionality comes from the extensibility of Strawberry Keyname Providers, which can be used to source specific data points from a variety of JSON keys found in your repository.

    More about Strawberry Keyname Providers

    1. Solr Fields: you need to configure your desired Solr Fields to source from the Strawberry Keynames you have configured. By default, Archipelago also provider Solr Fields sourced from your HOCR data and the Rendered HTML output of your ADOs.

    2. *3.5. Drupal Views: for your regular Search, Advanced Search, and potentially other specialized Views, you can configure to search within specific and/or a variety of Solr Fields.

    3. Search Results: your metadata and data, as configured through Keyname Providers and Fields, indexed into your Solr.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"search_solr_index/#excerpted-from-metadata-in-archipelago","title":"Excerpted from Metadata in Archipelago","text":"

    One of the challenges of our flexible approach is how to allow Drupal to access the JSON in a way, as native as possible, to generate filtered listings via Drupal Views, free text Search and Faceting. To make this happen Strawberry Field uses a JSON Querying and Exposing as \"Native Field Properties\" logic. Through a special type of Plugin system named Strawberry Key Name Providers and associated Configuration Entities (can be found at /admin/structure/strawberry_keynameprovider), you have control on which keys and values of your JSON are going to be exposed as field properties of any Strawberry Field, allowing Drupal through this to access values in a flat manner and expose them to the Search API natively. The access to the values of any JSON is done via JMESPATH expressions and then transformed either to a list of values or even \"cast\" into more complex data Data types, like an Entity Reference (means a connection to another Entity). This gives you a lot of power and control and makes a lot of very heavy operations lighter. You can even plan upfront or evolve these properties in time.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"search_solr_index/#instructions-and-guides","title":"Instructions and Guides","text":"
    • Strawberry Key Name Providers, Solr Field, and Facet Configuration
    • Advanced Search
    • How to Add a 'Search Within Collection' Block

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"security_bots/","title":"Managing Bots","text":"

    A public-facing production instance will likely encounter bad bots and other malicious traffic that will consume resources. There are many solutions available that address a variety of different needs, but we provide basic configurations and a Docker image for integrating the NGINX Ultimate Bad Bot & Referrer Blocker.

    Warning

    Before proceeding, please be sure to familiarize yourself with the NGINX Ultimate Bad Bot & Referrer Blocker README.

    ","tags":["Security","Bots"]},{"location":"security_bots/#deployment","title":"Deployment","text":"
    1. Uncomment or add the following docker-compose environment variables, replacing any appropriate values with your own and leaving the blocker and cron disabled to start (see highlighted lines): .env
      MSMTP_ACCOUNT=SMTP_ACCOUNT_NAME\nMSMTP_EMAIL=repositorysupport@metro.org\nMSMTP_HOST=smtp.metro.org\nMSMTP_PASSWORD=YOUR_SMTP_PASSWORD\nMSMTP_PORT=SMTP_PORT\nMSMTP_STARTTLS=on\nNGXBLOCKER_ENABLE=false\nNGXBLOCKER_CRON=00 22 * * *\nNGXBLOCKER_CRON_COMMAND=/usr/local/sbin/update-ngxblocker -x\nNGXBLOCKER_CRON_START=false\n
    2. Uncomment or add the following lines and comment out the line for the original NGINX image: docker-compose.yml
      # Run docker-compose up -d\n# Docker file for Arm64 and Apple M1 machines\nversion: '3.5'\nservices:\n  web:\n    container_name: esmero-web\n    # image: jonasal/nginx-certbot\n    image: esmero/nginx-bot-blocker:1.1.0-multiarch\n    restart: always\n    environment:\n      CERTBOT_EMAIL: ${ARCHIPELAGO_EMAIL}\n      ENVSUBST_VARS: FQDN\n      FQDN: ${ARCHIPELAGO_DOMAIN}\n      NGINX_ENVSUBST_OUTPUT_DIR: /etc/nginx/user_conf.d\n      MSMTP_ACCOUNT: ${MSMTP_ACCOUNT}\n      MSMTP_EMAIL: ${MSMTP_EMAIL}\n      MSMTP_HOST: ${MSMTP_HOST}\n      MSMTP_PASSWORD: ${MSMTP_PASSWORD}\n      MSMTP_PORT: ${MSMTP_PORT}\n      MSMTP_STARTTLS: ${MSMTP_STARTTLS}\n      NGXBLOCKER_CRON: ${NGXBLOCKER_CRON}\n      NGXBLOCKER_CRON_COMMAND: ${NGXBLOCKER_CRON_COMMAND}\n      NGXBLOCKER_CRON_START: ${NGXBLOCKER_CRON_START}\n      NGXBLOCKER_ENABLE: ${NGXBLOCKER_ENABLE}\n    ports:\n      - \"80:80\"\n      - \"443:443\"\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/config_storage/nginxconfig/template:/etc/nginx/templates\n      - ${ARCHIPELAGO_ROOT}/drupal:/var/www/html:cached\n      - ${ARCHIPELAGO_ROOT}/data_storage/ngnixcache:/var/cache/nginx\n      - ${ARCHIPELAGO_ROOT}/data_storage/letsencrypt:/etc/letsencrypt\n      - ${ARCHIPELAGO_ROOT}/config_storage/nginxconfig/bots.d:/etc/nginx/bots.d\n

    3. First pull the new image: 

      docker compose pull\n

      Note

      If using an older version of docker, don't forget the hyphen: 

      docker-compose pull\n

    4. Now bring the Docker ensemble down and up again: 

      docker compose down && docker compose up -d\n

      Note

      If using an older version of docker, don't forget the hyphen: 

      docker-compose down && docker-compose up -d\n

    5. Run the install script for the bot blocker in the default dry run mode and review the output: 

      docker exec -ti esmero-web bash -c \"/usr/local/sbin/install-ngxblocker\"\n

    6. The script will output the changes that are going to be made. Review them carefully and ensure that they are ok to make. Then run the command with the execute flag: 
      docker exec -ti esmero-web bash -c \"/usr/local/sbin/install-ngxblocker -x\"\n
    7. Run the setup script for the bot blocker in the default dry run mode and review the output: 
      docker exec -ti esmero-web bash -c \"/usr/local/sbin/setup-ngxblocker -v /etc/nginx/templates -e .copy\"\n
    8. The script will output the NGINX configuration changes that are going to be made. Review them carefully and ensure that they are ok to make. Then run the command with the execute flag: 
      docker exec -ti esmero-web bash -c \"/usr/local/sbin/setup-ngxblocker -v /etc/nginx/templates -e .copy -x\"\n

    9. Enable the bot blocker and cron (if applicable): .env

      MSMTP_ACCOUNT=SMTP_ACCOUNT_NAME\nMSMTP_EMAIL=repositorysupport@metro.org\nMSMTP_HOST=smtp.metro.org\nMSMTP_PASSWORD=YOUR_SMTP_PASSWORD\nMSMTP_PORT=SMTP_PORT\nMSMTP_STARTTLS=on\nNGXBLOCKER_ENABLE=true\nNGXBLOCKER_CRON=00 22 * * *\nNGXBLOCKER_CRON_COMMAND=/usr/local/sbin/update-ngxblocker -x\nNGXBLOCKER_CRON_START=true\n

      Note

      If MSMTP_EMAIL is blank and cron is enabled the flag for sending email notifications will be skipped.

    10. Bring the Docker ensemble down and back up again: 

      docker compose down && docker compose up -d\n

      Note

      If using an older version of docker, don't forget the hyphen: 

      docker-compose down && docker-compose up -d\n

    11. Test that it is working by following the \"TESTING\" section (STEP 10) in the official documentation: https://github.com/mitchellkrogza/nginx-ultimate-bad-bot-blocker

    ","tags":["Security","Bots"]},{"location":"security_bots/#deployment-with-upgrade","title":"Deployment with Upgrade","text":"

    If looking to use this solution as part of an upgrade (from 1.0.0 to 1.1.0, for example) we recommend coming back to the above steps after successfully completing the upgrade. After the upgrade, you will only need to add the environment variables and docker compose configurations and follow the steps as detailed above.

    ","tags":["Security","Bots"]},{"location":"security_bots/#advanced-configuration","title":"Advanced Configuration","text":"

    Because our Docker containers only persist our mounted files and folders, any advanced configurations may require overriding the files generated by our esmero-web container on boot. For example, the above setup-ngxblocker script is normally responsible for writing the following include lines:

    include /etc/nginx/bots.d/blockbots.conf;\ninclude /etc/nginx/bots.d/ddos.conf;\n

    Because the script is unable to place them in the correct part of our nginx.conf.template file, which in turn generates our nginx.conf file (see Using environment variables in nginx configuration), our own script adds (when NGINXBLOCKER_ENABLE=true) or removes (when NGINXBLOCKER_ENABLE=false) the lines to an empty file, which in turn is statically included in our main nginx.conf.template file. One option provided by setup-ngxblocker is to exclude (-d) the DDOS rule. In our case, we need to manually override the lines in our template file to reproduce this behavior:

    Example

    nginx.conf.template
    upstream cantaloupe {\n  server esmero-cantaloupe:8182;\n}\n\nserver {\n    listen              443 ssl;\n    server_name         ${FQDN};\n    ssl_certificate     /etc/letsencrypt/live/${FQDN}/fullchain.pem;\n    ssl_certificate_key /etc/letsencrypt/live/${FQDN}/privkey.pem;\n    client_max_body_size 1536M; ## Match with PHP from FPM container\n\n    root /var/www/html/web; ## <-- Your only path reference.\n\n    fastcgi_send_timeout 120s;\n    fastcgi_read_timeout 120s;\n    fastcgi_pass_request_headers on;\n\n    fastcgi_buffers 16 16k;\n    fastcgi_buffer_size 32k;\n\n    # Please adapt to your needs\n    proxy_buffers 16 16k;  \n    proxy_buffer_size 16k;\n\n    #include /etc/nginx/conf.d/bots.include;\n    include /etc/nginx/bots.d/blockbots.conf;\n

    Note

    Keep in mind that from this point, when disabling/enabling the bot blocker via the environment variable, you'll also need to uncomment/comment the added line.

    Another more generally applicable approach is to override files that are part of the docker image:

    Example

    Our bash script (setup_bot_blocker.sh) is triggered by and runs just before the startup script (start_nginx_certbot.sh) for the NGINX Certbot image. For any advanced needs involving custom startup behavior, our script can be modified and overwridden:

    1. First, we'll copy the script from the running Docker container onto our host: 
      docker cp esmero-web:/scripts/setup_bot_blocker.sh drupal/scripts/archipelago/\n
    2. Then we mount the file to override the container's file: docker-compose.yml
      # Run docker-compose up -d\n# Docker file for Arm64 and Apple M1 machines\nversion: '3.5'\nservices:\n  web:\n    container_name: esmero-web\n    # image: jonasal/nginx-certbot\n    image: esmero/nginx-bot-blocker:1.1.0-multiarch\n    restart: always\n    environment:\n      CERTBOT_EMAIL: ${ARCHIPELAGO_EMAIL}\n      ENVSUBST_VARS: FQDN\n      FQDN: ${ARCHIPELAGO_DOMAIN}\n      NGINX_ENVSUBST_OUTPUT_DIR: /etc/nginx/user_conf.d\n      MSMTP_ACCOUNT: ${MSMTP_ACCOUNT}\n      MSMTP_EMAIL: ${MSMTP_EMAIL}\n      MSMTP_HOST: ${MSMTP_HOST}\n      MSMTP_PASSWORD: ${MSMTP_PASSWORD}\n      MSMTP_PORT: ${MSMTP_PORT}\n      MSMTP_STARTTLS: ${MSMTP_STARTTLS}\n      NGXBLOCKER_CRON: ${NGXBLOCKER_CRON}\n      NGXBLOCKER_CRON_COMMAND: ${NGXBLOCKER_CRON_COMMAND}\n      NGXBLOCKER_CRON_START: ${NGXBLOCKER_CRON_START}\n      NGXBLOCKER_ENABLE: ${NGXBLOCKER_ENABLE}\n    ports:\n      - \"80:80\"\n      - \"443:443\"\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/config_storage/nginxconfig/template:/etc/nginx/templates\n      - ${ARCHIPELAGO_ROOT}/drupal:/var/www/html:cached\n      - ${ARCHIPELAGO_ROOT}/data_storage/ngnixcache:/var/cache/nginx\n      - ${ARCHIPELAGO_ROOT}/data_storage/letsencrypt:/etc/letsencrypt\n      - ${ARCHIPELAGO_ROOT}/config_storage/nginxconfig/bots.d:/etc/nginx/bots.d\n      - ${ARCHIPELAGO_ROOT}/drupal/scripts/archipelago/setup_bot_blocker.sh:/scripts/setup_bot_blocker.sh\n
    3. Then we modify our script copy (we'll reproduce the same behavior from the previous example but incorporate it into our script): drupal/scripts/archipelago/setup_bot_blocker.sh
      #!/bin/bash\n\nset -e\n\nif [ ! -z \"${MSMTP_EMAIL}\" ]; then\n    envsubst < /root/.msmtprc.template > /root/.msmtprc\nfi\n\nif [ \"${NGXBLOCKER_CRON_START}\" = true ]; then\n    if [ ! -z \"${MSMTP_EMAIL}\" ]; then\n      CRON_COMMAND=\"${NGXBLOCKER_CRON} ${NGXBLOCKER_CRON_COMMAND} -e ${MSMTP_EMAIL}\"\n    else\n      CRON_COMMAND=\"${NGXBLOCKER_CRON} ${NGXBLOCKER_CRON_COMMAND} -n\"\n    fi\n    echo \"${CRON_COMMAND}\" | crontab - &&\n    /etc/init.d/cron start\nfi\n\nif [ ! -f /etc/nginx/templates/bots.include.copy ]; then\n    touch /etc/nginx/templates/bots.include.copy\nfi\nif [ ! -f /etc/nginx/templates/bots.include.template ]; then\n    touch /etc/nginx/templates/bots.include.template\nfi\n\nif [ \"${NGXBLOCKER_ENABLE}\" = true ]; then\n    if [ ! -L /etc/nginx/conf.d/botblocker-nginx-settings.conf ]; then\n        ln -s /etc/nginx/bots_settings_conf.d/botblocker-nginx-settings.conf /etc/nginx/conf.d/botblocker-nginx-settings.conf\n    fi\n    if [ ! -L /etc/nginx/conf.d/globalblacklist.conf ]; then\n        ln -s /etc/nginx/bots_settings_conf.d/globalblacklist.conf /etc/nginx/conf.d/globalblacklist.conf\n    fi\n    if ! grep -q blockbots.conf /etc/nginx/templates/bots.include.copy; then\n        echo \"include /etc/nginx/bots.d/blockbots.conf;\" >> /etc/nginx/templates/bots.include.copy\n    fi\n    #if ! grep -q ddos.conf /etc/nginx/templates/bots.include.copy; then\n    #    echo \"include /etc/nginx/bots.d/ddos.conf;\" >> /etc/nginx/templates/bots.include.copy\n    #fi\n    if ! grep -q blockbots.conf /etc/nginx/user_conf.d/bots.include; then\n        echo \"include /etc/nginx/bots.d/blockbots.conf;\" >> /etc/nginx/user_conf.d/bots.include\n    fi\n    #if ! grep -q ddos.conf /etc/nginx/user_conf.d/bots.include; then\n    #    echo \"include /etc/nginx/bots.d/ddos.conf;\" >> /etc/nginx/user_conf.d/bots.include\n    #fi\n    cp /etc/nginx/templates/bots.include.copy /etc/nginx/templates/bots.include.template\nelse\n    >|/etc/nginx/templates/bots.include.template\n    >|/etc/nginx/user_conf.d/bots.include\n    if [ -L /etc/nginx/conf.d/botblocker-nginx-settings.conf ]; then\n        rm /etc/nginx/conf.d/botblocker-nginx-settings.conf\n    fi\n    if [ -L /etc/nginx/conf.d/globalblacklist.conf ]; then\n        rm /etc/nginx/conf.d/globalblacklist.conf\n    fi\nfi\n
    4. Next we remove the include line from the existing files: 
      docker exec -ti esmero-web bash -c \"sed -i '/include \\/etc\\/nginx\\/bots.d\\/ddos.conf/d' /etc/nginx/templates/bots.include.copy\"\n
      docker exec -ti esmero-web bash -c \"sed -i '/include \\/etc\\/nginx\\/bots.d\\/ddos.conf/d' /etc/nginx/templates/bots.include.template\"\n
      docker exec -ti esmero-web bash -c \"sed -i '/include \\/etc\\/nginx\\/bots.d\\/ddos.conf/d' /etc/nginx/user_conf.d/bots.include\"\n

    5. Finally we bring the Docker ensemble down and back up again to propagate the changes in our container: 

      docker compose down && docker compose up -d\n

      Note

      If using an older version of docker, don't forget the hyphen: 

      docker-compose down && docker-compose up -d\n

    The above is an example of a more complicated customization, but it's a pattern that can be used more generally throughout the Docker containers, i.e.:

    1. Copy the file that needs to be overwridden from the Docker container to the host and make custom changes.
    2. Mount the file from the host to the location within the docker container, e.g.: 
      - ${ARCHIPELAGO_ROOT}/LOCATION_ON_HOST/CUSTOMIZED_FILE_ON_HOST:/LOCATION_IN_DOCKER_CONTAINER/FILE_IN_DOCKER_CONTAINER\n
    3. Bring the Docker ensemble down and bring it up again.
    ","tags":["Security","Bots"]},{"location":"sslsetup/","title":"How to Setup SSL for Docker/Archipelago","text":"

    Work-In-Progress Note This documentation page is still under construction and content may change with future updates. Please use caution when implementing any instructions referenced herein, as there may be missing steps or corresponding configuration files. Thank you for your patience as we continue to update Archipelago's documentation.

    The steps found below describe one potential manual SSL configuration for Archipelago deployments. A git clone deployment option will be available for future releases.

    "},{"location":"sslsetup/#manual-configuration-steps-for-an-ec2-aws-server","title":"Manual Configuration Steps for an EC2 AWS Server","text":"

    This process takes less than 10 minutes of reading YML files and editing a few files (described below) to get SSL running and setup with auto-renewal.

    1. First, configure Certbot, following the instructions found on https://certbot.eff.org.

    2. Inside a /persistent partition, establish the following folder structure. Note: you can keep the existing folder structure if you so choose. A benefit of the following structure is that it decouples the git clone of archipelago-deployment, which is made to be self sustainable and good for coding or smaller deployments.

      [ec2-user@ip-17x-xx-x-xxx persistent]$ ls -lah\ntotal 64K\ndrwxr-xr-x 14 root           root  4.0K Oct  5 23:11 .\ndr-xr-xr-x 19 root           root  275 Dec 15  2019 ..\ndrwxr-xr-x  8       999  999   4096 Oct 13 20:07 db\ndrwxr-xr-x 13 root           root  4.0K Oct  5 23:03 drupal8\ndrwxr-xr-x  5           8183  8183   4.0K Feb 23  2020 iiifcache\ndrwxr-xr-x  2 root           root  4.0K Feb 23  2020 iiifconfig\ndrwxr-xr-x  4 root           root  4.0K Oct  5 22:45 nginx_conf\ndrwxr-xr-x  3 root           root  4.0K Feb 26  2019 solrconfig\ndrwxr-xr-x  3           8983 8983  4.0K Feb 26  2019 solrcore\n

      To get to this point, create a git clone of archipelago deployment and then copy the content of the /persistent out of the repo folder into this structure. The original (or what is left) archipelago-deployment ends inside a drupal8 folder here.

    3. Copy and paste the following to create a local copy of this file:

      docker-compose.yml

      **Be sure to replace youremail@gmail.com with your email address.

       version: '3.5'\n services:\n   web:\n     container_name: esmero-web\n     image: staticfloat/nginx-certbot\n     restart: always\n     environment:\n       CERTBOT_EMAIL: \"youremail@gmail.com\"\n     ports:\n       - \"80:80\"\n       - \"443:443\"\n     volumes:\n       - /persistent/nginx_conf/conf.d:/etc/nginx/user.conf.d:ro\n       - /persistent/nginx_conf/certbot_extra_domains:/etc/nginx/certbot/extra_domains:ro\n       - /persistent/drupal8:/var/www/html:cached\n     depends_on:\n       - solr\n       - php\n     tty: true\n     networks:\n       - host-net\n       - esmero-net\n   php:\n     container_name: esmero-php\n     restart: always\n     image: \"esmero/php-7.3-fpm:latest\"\n     tty: true\n     networks:\n       - host-net\n       - esmero-net\n     volumes:\n       - ${PWD}:/var/www/html:cached\n   solr:\n     container_name: esmero-solr\n     restart: always\n     image: \"solr:7.5.0\"\n     tty: true\n     ports:\n       - \"8983:8983\"\n     networks:\n       - host-net\n       - esmero-net\n     volumes:\n       - /persistent/solrcore:/opt/solr/server/solr/mycores:cached\n       - /persistent/solrconfig:/drupalconfig:cached\n     entrypoint:\n       - docker-entrypoint.sh\n       - solr-precreate\n       - drupal\n       - /drupalconfig\n   # see https://hub.docker.com/_/mysql/\n   db:\n     image: mysql:5.7\n     command: --max_allowed_packet=256M\n     container_name: esmero-db\n     restart: always\n     environment:\n       MYSQL_ROOT_PASSWORD: esmerodb\n     networks:\n       - host-net\n       - esmero-net\n     volumes:\n       - /persistent/db:/var/lib/mysql:cached\n   iiif:\n     container_name: esmero-cantaloupe\n     image: \"esmero/cantaloupe-s3:4.1.6\"\n     restart: always\n     ports:\n       - \"8183:8182\"\n     networks:\n       - host-net\n       - esmero-net\n     volumes:\n       - /persistent/iiifconfig:/etc/cantaloupe\n       - /persistent/iiifcache:/var/cache/cantaloupe\n networks:\n   host-net:\n     driver: bridge\n   esmero-net:\n     driver: bridge\n     internal: true\n

      Note: This file shows how the folders in Step 1 are being used, and how SSL is being automatically deployed and renewed (without any human interaction other than starting the docker-compose and watching the logs).

    4. Now copy and paste the following to create a local copy of this file:

      ngnix.conf

      **Be sure to replace all instances of yoursite.org with your own domain.

       # goes into /persistent/nginx_conf/conf.d/nginx.conf\n upstream cantaloupe {\n  server  esmero-cantaloupe:8182;\n  }\n\n  server {\n    listen              443 ssl;\n    server_name         yoursite.org;\n    ssl_certificate     /etc/letsencrypt/live/yourstie.org/fullchain.pem;\n    ssl_certificate_key /etc/letsencrypt/live/yoursite.org/privkey.pem;\n\n     client_max_body_size 512M; ## Match with PHP from FPM container\n\n    root /var/www/html/web; ## <-- Your only path reference.\n\n    fastcgi_send_timeout 120s;\n    fastcgi_read_timeout 120s;\n    fastcgi_pass_request_headers on;\n\n    fastcgi_buffers 16 16k;\n    fastcgi_buffer_size 32k;\n\n    # Cantaloupe proxypass\n    location /cantaloupe/ {\n       proxy_set_header X-Forwarded-Proto $scheme;\n       proxy_set_header X-Forwarded-Host $host;\n       proxy_set_header X-Forwarded-Port $server_port;\n       proxy_set_header X-Forwarded-Path /cantaloupe/;\n       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n       if ($request_uri ~* \"/cantaloupe/(.*)\") {\n         proxy_pass http://cantaloupe/$1;\n       }\n    }\n\n    location = /favicon.ico {\n        log_not_found off;\n        access_log off;\n    }\n\n    location = /robots.txt {\n        allow all;\n        log_not_found off;\n        access_log off;\n    }\n\n    # Very rarely should these ever be accessed outside of your lan\n    location ~* \\.(txt|log)$ {\n        deny all;\n    }\n\n    location ~ \\..*/.*\\.php$ {\n        return 403;\n    }\n\n    location ~ ^/sites/.*/private/ {\n        return 403;\n    }\n\n    # Allow \"Well-Known URIs\" as per RFC 5785\n    location ~* ^/.well-known/ {\n        allow all;\n    }\n\n    # Block access to \"hidden\" files and directories whose names begin with a\n    # period. This includes directories used by version control systems such\n    # as Subversion or Git to store control files.\n    location ~ (^|/)\\. {\n        return 403;\n    }\n\n    location / {\n        try_files $uri /index.php?$query_string; # For Drupal >= 7\n    }\n\n    location @rewrite {\n        rewrite ^/(.*)$ /index.php?q=$1;\n    }\n\n    # Don't allow direct access to PHP files in the vendor directory.\n    location ~ /vendor/.*\\.php$ {\n        deny all;\n        return 404;\n    }\n\n    # Allow Modules to be updated via UI (still we believe composer is the way)    \n    rewrite ^/core/authorize.php/core/authorize.php(.*)$ /core/authorize.php$1;\n\n    # In Drupal 8, we must also match new paths where the '.php' appears in\n    # the middle, such as update.php/selection. The rule we use is strict,\n    # and only allows this pattern with the update.php front controller.\n    # This allows legacy path aliases in the form of\n    # blog/index.php/legacy-path to continue to route to Drupal nodes. If\n    # you do not have any paths like that, then you might prefer to use a\n    # laxer rule, such as:\n    #   location ~ \\.php(/|$) {\n    # The laxer rule will continue to work if Drupal uses this new URL\n    # pattern with front controllers other than update.php in a future\n    # release.\n    location ~ '\\.php$|^/update.php' {\n        fastcgi_split_path_info ^(.+?\\.php)(|/.*)$;\n        include fastcgi_params;\n        # Block httpoxy attacks. See https://httpoxy.org/.\n        fastcgi_param HTTP_PROXY \"\";\n        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;\n        fastcgi_param PATH_INFO $fastcgi_path_info;\n        fastcgi_param PHP_VALUE \"upload_max_filesize=512M \\n post_max_size=512M\";\n        proxy_read_timeout 900s;\n        fastcgi_intercept_errors on;\n        fastcgi_pass esmero-php:9000;\n    }\n\n     # Fighting with Styles? This little gem is amazing.\n    location ~ ^/sites/.*/files/styles/ { # For Drupal >= 7\n        try_files $uri @rewrite;\n    }\n\n    # Handle private files through Drupal.\n    location ~ ^/system/files/ { # For Drupal >= 7\n        try_files $uri /index.php?$query_string;\n    }\n}\n

    5. Create the following folder:

      /persistent/nginx_conf/conf.d/\n

    6. Place the ngnix.conf file inside the /conf.d/ folder.

    7. Create also this other folder:

      /persistent/nginx_conf/certbot_extra_domains/\n

    8. Inside the /certbot_extra_domains/ folder, create a text file named the same way as your domain (which can/or not contain additional subdomains but needs to exist).

      cat  /persistent/nginx_conf/certbot_extra_domains/yoursite.org\n
      drwxr-xr-x 2 root root 4.0K Oct  5 22:46 .\ndrwxr-xr-x 4 root root 4.0K Oct  5 22:45 ..\n-rw-r--r-- 1 root root   48 Oct  5 22:46 yoursite.org\n

      Optionally, create additional subdomains if needed.

      cat  /persistent/nginx_conf/certbot_extra_domains/yoursite.org\nsubdomain.yoursite.org\nanothersub.yoursite.org\n

    9. Make sure you have edited the docker-compose.yml and ngnix.conf files you created to match your own information. Also make sure to also adjust the paths if you do not want the /persistent approach described in Step 1.

    10. Run the following commands:

      docker -compose up -d\ndocker ps\n

      You should see this:

      b5a04747ee06        staticfloat/nginx-certbot    \"/bin/bash /scripts/\u2026\"   8 days ago          Up 8 days           0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp   esmero-web\n84afae094b57        esmero/php-7.3-fpm:latest    \"docker-php-entrypoi\u2026\"   8 days ago          Up 8 days           9000/tcp                                   esmero-php\n13a9214acfd0        esmero/cantaloupe-s3:4.1.6   \"sh -c 'java -Dcanta\u2026\"   8 days ago          Up 8 days           0.0.0.0:8183->8182/tcp                     esmero-cantaloupe\n044dd5bc7245        mysql:5.7                    \"docker-entrypoint.s\u2026\"   8 days ago          Up 8 days           3306/tcp, 33060/tcp                        esmero-db\n31f4f0f45acc        solr:7.5.0                   \"docker-entrypoint.s\u2026\"   8 days ago          Up 8 days           0.0.0.0:8983->8983/tcp                     esmero-solr\n

    11. SSL has now been configured for your Archipelago instance.

    "},{"location":"sslsetup/#user-contributed-documentation","title":"User contributed documentation:","text":"

    Adding SSL to Archipelago running docker by Zachary Spalding: https://youtu.be/rfH5TLzIRIQ

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"strawberry_key_name_providers/","title":"Strawberry Key Name Providers, Solr Field, and Facet Configuration","text":"

    For an overview of how Strawberry Key Name Providers fit within the context of the rest of Archipelago, please see the Drupal and JSON section in our Metadata in Archipelago overview documentation.

    In order to expose the Strawberry Field JSON keys (and values) for Archipelago Digital Objects (ADOs) to Search/Solr, Views, and Facets, we need to make use of a plugin system called Strawberry Key Name Providers. The following guide covers - Configuring first the Strawberry Key Name Providers - Then configuring the corresponding Solr Fields necessary for Search and Views exposure - Finally, the configuration of Facets and placement of Facet blocks on your theme as needed.

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#creating-a-strawberry-key-name-provider","title":"Creating a Strawberry Key Name Provider","text":"

    1. First, we'll start with an example of a Strawberry Field JSON key that we would like to expose:

      date_created_edtf

      ...\n\"subject_wikidata\": [\n    {\n        \"uri\": \"http:\\/\\/www.wikidata.org\\/entity\\/Q55488\",\n        \"label\": \"railway station\"\n    }\n],\n\"date_created_edtf\": {\n    \"date_to\": \"\",\n    \"date_free\": \"2016~\\/2017~\",\n    \"date_from\": \"\",\n    \"date_type\": \"date_free\"\n},\n\"date_created_free\": null,\n...\n

    2. Next, we are going to create a new Strawberry Key Name Provider by going to Administration > Structure > Strawberry Key Name Providers, pressing the + Add Strawberry Key Name Provider button, filling in the fields as follows, and saving:

      • Label: Date Created EDTF
      • Strawberry Key Name Provider Plugin: JmesPath Strawberry Field Key Name Provider
      • One or more comma separated valid JMESPaths: date_created_edtf.date_free
      • Confirm that the value for Exposed Strawberry Field Property (under the One or more comma separated valid JMESPaths field) is set to date_created_edtf_date_free. This is the Strawberry Field Property that will hold the data coming from the JMESPath Query when evaluated against and ADO's JSON and will be visible as a Strawberry Field Property to Drupal and the Search API. When doing this in a production environment, you might want to change the automatically generated value and assign a simpler one to remember. You can always do this by pressing Edit. But for the purpose of this documentation please keep date_created_edtf_date_free.
      • Is Date?: \u2611
    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#strawberry-key-name-provider-plugins","title":"Strawberry Key Name Provider Plugins","text":"

    You'll notice that there are four plugins, each with different options, available for different use cases. Below you'll find each plugin with examples from the providers that come with a default deployment.

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#entity-reference-jmespath-strawberry-field-key-name-provider","title":"Entity Reference JmesPath Strawberry Field Key Name Provider","text":"

    ismemberof

    One or more comma separated valid JMESPaths: ismemberof

    Entity type: node

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#flavorembedded-json-service-strawberry-field-key-name-provider","title":"Flavor/Embedded JSON Service Strawberry Field Key Name Provider","text":"

    hoCR Service

    Source JSON Key used to read the Service/Flavour: ap:hocr

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#jmespath-strawberry-field-key-name-provider","title":"JmesPath Strawberry Field Key Name Provider","text":"

    Subject Labels

    One or more comma separated valid JMESPaths: subject_loc[*].label, subject_wikidata[*].label, subject_lcnaf_geographic_names[*].label,subject_temporal[*].label, subject_lcgft_terms[*].label, term_aat_getty[*].label, pubmed_mesh[*].label

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#jsonld-strawberry-field-key-name-provider","title":"JSONLD Strawberry Field Key Name Provider","text":"

    Best Practice

    As in the example below, if there are a group of flat and unique keys that you want to expose, we recommend creating one provider with this plugin and using a list of keys instead of creating multiple providers. This Provider will also auto assign Lists of Properties from an external JSON-LD ontology/vocabulary (e.g Schema.org). It uses direct access approach, e.g. type will get all values for any JSON Key named type at any hierarchy level (across the whole JSON document) and it will also use the same exact name (type) for the Exposed Strawberry Field Property.

    schema.org

    Additional keys separated by commas: ismemberof,type,hocr,city,category,country,state,display_name,author,license

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#creating-a-solr-field","title":"Creating a Solr Field","text":"
    1. Go to Administration > Configuration > Search and metadata > Search API > Drupal Content to Solr 9 > Fields.
    2. Press the Add fields button.
    3. Search for the field created above (expand the \ud83c\udf53 Strawberry (Descriptive Metadata source) (field_descriptive_metadata), e.g. for the key mapped above, look for field_descriptive_metadata:date_created_edtf_date_free.
    4. Scroll down after adding to make sure the Type for the field is correct (date for the example in this guide).
    5. Reindex Solr.
      1. Go to Administration > Configuration > Search and metadata > Search API and click on the link to the index for your Drupal data.
      2. Press the Queue all items for reindexing button.
      3. Let cron reindex or press the Index now button.
    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#creating-a-facet","title":"Creating a Facet","text":"
    1. Go to Administration > Configuration > Search and metadata > Facets.
    2. Press the + Add facet button.
    3. Select your facet settings. For the example in this guide, we'll select the following:
      • Facet source: View Solr search content, display Page
      • Field: \ud83c\udf53 Strawberry (Descriptive Metadata source) >> date_created_edtf_date_free (field_descriptive_metadata:date_created_edtf_date_free)
      • Name: \ud83c\udf53 Strawberry (Descriptive Metadata source) >> date_created_edtf_date_free
    4. Save.
    5. Continue with the facet configuration by pressing Edit for the facet we just created and adjusting the many options available as needed. For the example in this guide, we'll adjust the below from the default settings:
      • Facet settings
        • \u2611 Date item processor
          • Date display
            • \ud83d\udd18 Actual date with granularity
          • Granularity
            • \ud83d\udd18 Year
        • URL alias: sbf_date_created_edtf
    6. Save.
    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#creating-a-block-for-the-facet","title":"Creating a Block for the Facet","text":"
    1. Go to Administration > Structure > Block layout.
    2. Select the appropriate theme. For the example in this guide, we'll select Archipelago Base Theme.
    3. Press the Place block button next to the appropriate region. For the example in this guide, we'll be placing the block in the Sidebar second region.
    4. Select your facet from the list. For the example in this guide, we'll select \ud83c\udf53 Strawberry (Descriptive Metadata source) >> date_created_edtf_date_free
    5. Press the Place block button next to the facet. Once the block is added, you can drag and drop it to change its position among the existing blocks and saving.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberryfield-formatters/","title":"Strawberryfield Formatters","text":"

    This documentation will give a brief overview of Archipelago's Strawberryfield Formatters and how they work using the default View mode Digital Object Full View as an example.

    "},{"location":"strawberryfield-formatters/#at-a-glance","title":"At a glance","text":"

    When taking a look at your First Digital Object note that multiple formatters are working together to create this Display ( or View mode). Since \"My First Digital Object\" is a Photograph the Display being used is Digital Object Full View which, by default, uses formatters to:

    • (Red) Create the image viewer where users can zoom in, zoom out, fullscreen and rotate all the images associated with the ADO.
    • (Blue) Display the Object Description and Type of Resource.
    • (Green) Display the Raw JSON Metadata and IIIF Presentation Manifest.

    "},{"location":"strawberryfield-formatters/#in-greater-detail","title":"In Greater Detail","text":"

    When editing an ADO, at the top of the Webform page there is a tab titled Manage display which will take us to where all the Formatters live. Take note that the DISPLAY SETTINGS shown in the screenshot below are using the Default View mode.

    Once the page loads the Default View mode is automatically selected. However, because we are editing an object with the Media type Photograph, we need to edit the View mode Digital Object Full View since it is the Default View mode for this Media type.

    "},{"location":"strawberryfield-formatters/#how-to-find-and-configure-which-view-mode-is-default-per-media-type","title":"How to find and configure which View mode is Default per Media type","text":"

    The ADO Type to View mode Mapping page tells the ADOs which View mode to use by default per Media type. This page can be accessed at yoursite//admin/config/archipelago/viewmode_mapping

    Formatters Shipped with Archipelago
    1. Default
    2. Collection listing
    3. Digital Object Full View
    4. Digital Object with 3D Viewer
    5. Digital Object with A/V Player
    6. Digital Object with Book Reader
    7. Digital Object with Mirador Viewer
    8. Digital Object with Pannellum Panorama
    9. Digital Object with PDF Viewer
    10. Digital Object with Replay.web Webarchive Player
    11. Digital Object with Replay.web Webarchive with Navbars
    12. Digital Object with Video Player
    13. Digital Object with thumbnail and abstract
    Default View Mode Mappings by Media Type JSON (Media) Type View Mode Name 1. Video Digital Object with Video Player 2. 3DModel Digital Object with 3D Viewer 3. Photograph Digital Object Full View 4. Thesis Digital Object with PDF Viewer 5. Panorama Digital Object with Pannellum Panorama 6. Book Digital Object with Book Reader 7. Podcast Digital Object with A/V Player 8. Collection Collection Listing 9. Article Digital Object with PDF Viewer 10. Map Digital Object with Mirador Viewer 11. MusicRecording Digital Object with A/V Player 12. Sculpture Digital Object with 3D Viewer 13. VisualArtwork Digital Object with Video Player 14. Painting Digital Object with Mirador Viewer 15. WebPage Digital Object with Replay.web Webarchive Player 16. PanoramaTour Digital Object with Pannellum Panorama

    There are two sections in Manage display for Digital Object Full View: 1) Content and 2) Disabled. Moving a field into Content means this formatter will be used to the display the ADO in some way. The formatters moved to Disabled are inactive and are subsequently not being used for displaying the ADO.

    There are four fields named \ud83c\udf53Strawberry and each one is a copy of the field \ud83c\udf53Strawberry (Descriptive Metadata source). Since the names of the fields do not imply their function, they have been named Strawberry in four different ways (Italiano, Deutsch, Din\u00e9 Bizaad, and English) in order to organize and help users visually remember which field is doing what for the Display.

    Recall My First Digital Object at beginning of this document where there were 3 sections highlighted in Red, Blue, and Green.

    • In Red (\ud83c\udf53Fragola) there is the Strawberry Field Formatter for IIIF media which takes the image stored in S3 to display the photograph with the image viewer.
    • In Blue (\ud83c\udf53Erdbeere) there is the Strawberry Field Formatter for Custom Metadata Templates which displays the raw JSON metadata using configurable Twig templates. In this example, the default Twig template uses the JSON key type to display the Type of Resource.
    • In Green (\ud83c\udf53Strawberry (Descriptive Metadata)) there is the Strawberry Default Formatter which is used to display the Raw JSON Metadata.

    "},{"location":"strawberryfield-formatters/#at-the-end-of-the-day","title":"At the end of the day","text":"

    The decision for how your metadata is displayed is totally in your control.

    Under the WIDGET column, there is a quick description/overview of what the formatter is doing.

    And by clicking on the gear icon under the OPERATIONS column, all of the options for configuring the formatter are revealed. To use \ud83c\udf53Fragola as an example (the Formatter for IIIF media), we can choose which JSON Key is being used to fetch the IIIF Media URLs (found inside the raw JSON being played with Strawberry Default Formatter), the maximum height and width of the viewer, etc.

    And then with \ud83c\udf53Erdbeere (the Formatter for Custom Metadata Templates) there is the option, among many others, to configure which Twig template the formatter will use for displaying your Metadata.

    More information about Managing Metadata Displays with Twig Templates can be found here.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"strawberryfields/","title":"Strawberryfields Forever","text":""},{"location":"strawberryfields/#what-strawberry-fields-does-why-we-built-it-and-what-issues-it-addresses","title":"What Strawberry fields does, why we built it, and what issues it addresses","text":"

    Archipelago integrates transparently into the Drupal 8 ecosystem using its Core Content Entity System (Nodes), Discovery (Search API) and in general all its Core Components plus a few well maintained external ones.

    By design (and because we think its imperative), Archipelago takes full charge of the metadata layer and associated media assets by implementing a highly configurable, smart Drupal field written in JSON named Strawberryfield that attaches to any content.

    All of JSON's internals, keys, paths, and values are dynamically exposed to the rest of the ecosystem. Strawberryfield even remembers its structure as data evolves by storing JSON paths of every little detail.

    "},{"location":"strawberryfields/#nothing-is-real","title":"Nothing Is Real","text":"

    Archipelago includes additional companion modules, Webform_strawberryfield and Format_strawberryfield that extend the core metadata capabilities of the main Strawberryfield module and allow the same flexibility to be exposed during ingest and viewing of digital objects.

    The in-development Strawberry Runners and AMI modules further extend Archipelago's capabilities. Additional information related to these modules will be made available following initial public releases.

    "},{"location":"strawberryfields/#ingesting","title":"Ingesting","text":"

    Webform Strawberryfield (we had a better name) extends and integrates into the amazing Drupal Webform module to allow Archipelago users to build any possible metadata and media, ingest and edit, workflows directly via the UI using webforms.

    By not having a hardcoded ingest method, Archipelago can be used outside the GLAM community too, as a pure data repository in biological sciences, digital humanities, archives, or even as a mixed, multidisciplinary/cross-domain system.

    We also added WIKIDATA, LoC, Getty, and VIAF authority querying elements to aid in linking to external Linked Open Data sources.

    All these integrations are made to help local needs and community identities to survive the never-ending race for the next metadata schema. They are made to prototype, plan, and grow independently of how metadata will need to be exposed yesterday or tomorrow. And we plan to add more.

    Explore what other features webform_strawberryfield provides to help with ingesting, reading, and interacting with your metadata during that process.

    "},{"location":"strawberryfields/#exposing","title":"Exposing","text":"

    Format Strawberryfield (we had even a better name but...) deals with taking your JSON based metadata and casting, mashing, mixing, exposing, displaying, and transforming it to allow rich interaction for users and other systems with your digital objects.

    In its guts (or heart?), Archipelago does something quite simple but core to our concept of repository: it transforms in realtime the close to your needs open schema metadata that lives in strawberryfield as JSON into close to other one's fixed schema needs metadata; any destination format, using a fast, cached templating system. A templating system that is core to Drupal, called Twig:

    • Twig in Symfony
    • Twig in Drupal

    This templating system is exposed to Archipelago users through the UI and stored side by side in the repository as content (we named them Metadata Display entities, but they not only serve display needs!) so users can fully control how metadata is transformed and published without touching their individual sources.

    Templates or recipes can be shared, exported, ingested, updated, and adapted in many ways. Fast changes are possible without having to wait for the next mayor release of Archipelago or your favorited Metadata Schema Specs Committee agreeing on the next or the last version. Of course, this module not only handles metadata but media assets too, extracting local or remote URIs and files from your metadata and rendering them as media viewers: books, 3D models, images, panoramas, A/V with IIIF in its soul.

    You can learn more about what format_strawberryfield can do and what many other possibilities are exposed through our templating system.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"strawberryrunners/","title":"Strawberry Runners Post-Processing Configuration","text":"

    Archipelago's Strawberry Runners (SBR) module provides provides a set of post-processing capabilities for the JSON based metadata, files and entities that comprise your Archipelago Digital Objects (ADOs). These post-processing actions are based on dispatched events, direct http calls, and invoked webhooks from partner services (such as Min.io, AWS S3 or self-invoked).

    The default Archipelago SBR post-processor configurations include operations that: - perform page-based HOCR/OCR for image and pdf-based ADOs, send the output to the Search API, and use Natural Language Processing to extract entities from the output - extract text from pages within a Webarchives File and send the output to the Search API - convert WARC format Webarchives Files into WACZ format and attach the new WACZ file to the original source ADO to complement the WARC original

    SBR actions can be chained and nested to enable ordered operations, such as first extract individual pages in an ordered sequence and then run HOCR/OCR across the individual pages.

    ","tags":["Strawberry Runners","HOCR","OCR","Post-processing","Background Processing"]},{"location":"strawberryrunners/#strawberry-runners-settings-overview","title":"Strawberry Runners Settings Overview","text":"

    You can access the Strawberry Runners Settings:

    • Through the Manage menu > Configuration > Archipelago > Configure Strawberry Runners Post Processors
    • Directly at /admin/config/archipelago/strawberry_runners

    On the Strawberry Runners Settings page, you will see the Archipelago default post processor configurations (unless modified).

    1. The pager action uses the 'Post processor that extracts/generates Ordered Sequences of files/pages/children using Files present in an ADO' plugin.
    2. Nested one level in, the ocr action uses the 'Post processor that Runs OCR/HORC against files' plugin. The ocr operations will be executed after the completion of the pager operations.
    3. The wacz_page_extractor action uses the 'Post processor that extracts/generates Indexed Page Content from WACZ files in an ADO' plugin.
    4. Nested one level in, the webpage action uses the 'Post processor that Indexes WACZ Frictionless data Search Index to Search API' plugin. The webpage operations will be executed after the completion of the wacz_page_extractor operations.
    5. The warc_to_wacz action uses the 'Post processor that uses a System Binary to process * files' operations.
    ","tags":["Strawberry Runners","HOCR","OCR","Post-processing","Background Processing"]},{"location":"strawberryrunners/#reviewing-and-adjusting-the-default-post-processors","title":"Reviewing and Adjusting the default Post-Processors","text":"

    From the main Strawberry Runner Settings page, you can review and adjust the settings for the default Archipelago configurations by selecting Edit from the `Operations`` menu.

    Please see the following guides for:

    • Adjusting the pager and ocr operations
    • Adjusting the wacz_page_extractor and webpage operations
    • Adjusting the warc_to_wacz operation
    ","tags":["Strawberry Runners","HOCR","OCR","Post-processing","Background Processing"]},{"location":"strawberryrunners/#triggering-post-processing-actions-manually","title":"Triggering Post-Processing Actions Manually","text":"

    After making adjustments to Strawberry Runners Post-Processing configurations, you may want to trigger/re-trigger a particular action manually.

    You can use Archipelago's Find and Replace to first select a specific group of Digital Objects you wish to target for Post-Processing, then select the Trigger Strawberrry Runners process/reprocess for Archipelago Digital Objects content item from the Find and Replace Actions menu.

    ","tags":["Strawberry Runners","HOCR","OCR","Post-processing","Background Processing"]},{"location":"strawberryrunners/#additional-post-processor-operations","title":"Additional Post Processor Operations","text":"

    Archipelago also includes the Post processor that writes/reads Frictionless Data Packages plugin. Please keep a lookout for future documentation related to using this plugin.

    ","tags":["Strawberry Runners","HOCR","OCR","Post-processing","Background Processing"]},{"location":"strawberryrunners_pager_ocr/","title":"Reviewing and adjusting the pager and ocr Post-Processor operations","text":"

    The pager and ocr Post-processor operations are likely the most important pair of Strawberry Runners in your Archipelago.

    As stated on the Strawberry Runners overview page, the pager action uses the 'Post processor that extracts/generates Ordered Sequences of files/pages/children using Files present in an ADO' plugin. Nested one level in, the ocr action uses the 'Post processor that Runs OCR/HORC against files' plugin. The ocr operations will be executed after the completion of the pager operations.

    Common changes you may wish to make for the pager and/or ocr operations include adding or removing particular types of Archipelago Digital Objects to apply these operations to.

    ","tags":["Strawberry Runners","HOCR","OCR","Pager","Post-processing","Background Processing"]},{"location":"strawberryrunners_pager_ocr/#pager-settings","title":"Pager Settings","text":"

    To review or adjust the configurations for the pager operation, select Edit from the Operations menu.

    In the pager settings, you will see the following configuration options:

    1. Label:

      • Label for this Processor; which should be a unique machine-readable name
      • Can only contain lowercase letters, numbers, and underscores
      • We do not recommend changing this Label from the default pager.

    2. Strawberry Runner Post Processor Plugin:

      • The Post processor that extracts/generates Ordered Sequences of files/pages/children using Files present in an ADO should be selected.
      • We do not recommend changing this Plugin selection.

    3. Checkbox to mark this processor plugin as active

      • We recommend keeping this checked as active at all times, but you may wish to temporarily disable this if you are performing certain types of administrative review tasks such as running large test ingests where you plan on deleting the ADOs before a final ingest.
      • If you accidentally uncheck this and need to re-trigger the pager (and corresponding nested ocr action), you can use Archipelago's Find and Replace to first select a specific group of Digital Objects you wish to target for Post-Processing, then select the Trigger Strawberrry Runners process/reprocess for Archipelago Digital Objects content item from the Find and Replace Actions menu.

    4. ADO type(s) to limit this processor to:

      • A single ADO type or a comma delimited list of ado types that qualify to be Processed.
      • Leave empty to apply to all ADOs. If you do not provide any specific ADO types here, the processor will be applied for all ADOs with the JSON keys selected in the next step.
      • Default ADO types specified are: 'Document,Book,Article'
      • You may wish to add additional types of document/multiple-paged type of ADOs to this list that are custom to you Archipelago environment.

    5. The JSON key that contains the desired source files:

      • By default, the as:image and as:document keys are selected.
      • We do not recommend changing this selection.

    6. Mimetypes(s) to limit this Processor to:

      • A single Mimetype type or a comma separated list of mimetypes that qualify to be Processed.
      • Leave empty to apply any file.
      • Default mimetypes are: 'application/pdf,image/tiff,image/jpeg,image/jp2'

    7. Within the ADO's metadata, the JSON key that contains the language in ISO639-3 (3 letter) format to be used for OCR/NLP processing via Tesseract.

      • Default JSON key specified is: 'language_iso639_3'

    8. Please provide a default language in ISO639-3 (3 letter) format. If none is provided we will use 'eng'.

      • Default language specified is: 'eng'

    9. Timeout in seconds for this process.

      • If the process runs out of time it can still be processed again
      • Default selection is: 10

    10. Order or execution in the global chain.

      • Default selection is: 0
    ","tags":["Strawberry Runners","HOCR","OCR","Pager","Post-processing","Background Processing"]},{"location":"strawberryrunners_pager_ocr/#ocr-hocr-settings","title":"OCR / HOCR Settings","text":"

    To review or adjust the configurations for the ocr operation, select Edit from the Operations menu.

    In the pager settings, you will see several different configuration options.

    1. Label:

      • Label for this Processor; which should be a unique machine-readable name
      • Can only contain lowercase letters, numbers, and underscores
      • We do not recommend changing this Label from the default ocr.

    2. Strawberry Runner Post Processor Plugin:

      • The Post processor that Runs OCR/HORC against files should be selected.
      • We do not recommend changing this Plugin selection.

    3. Checkbox to mark this processor plugin as active

      • We recommend keeping this checked as active at all times, but you may wish to temporarily disable this if you are performing certain types of administrative review tasks such as running large test ingests where you plan on deleting the ADOs before a final ingest.
      • If you accidentally uncheck this and need to re-trigger the pager (and corresponding nested ocr action), you can use Archipelago's Find and Replace to first select a specific group of Digital Objects you wish to target for Post-Processing, then select the Trigger Strawberrry Runners process/reprocess for Archipelago Digital Objects content item from the Find and Replace Actions menu.

    4. The type of source data this processor works on:

      • Select from where the source file this processor needs is fetched.
      • Default selection of 'File entities referenced in the as:filetype JSON structure'.
      • You also have the option of selecting 'Full file paths passed by another processor', but we do not recommend using this option as it is less granular in its application.

    5. ADO type(s) to limit this processor to:

      • A single ADO type or a comma delimited list of ado types that qualify to be Processed
      • Leave empty to apply to all ADOs. If you do not provide any specific ADO types here, the processor will be applied for all ADOs with the JSON keys selected in the next step.
      • Default ADO types specified are: 'Document,Book,Article'
      • You may wish to add additional types of document/multiple-paged type of ADOs to this list that are custom to you Archipelago environment.

    6. The JSON key that contains the desired source files:

      • By default, the as:image and as:document keys are selected.
      • We do not recommend changing this selection.

    7. Mimetypes(s) to limit this Processor to:

      • A single Mimetype type or a comma separated list of mimetypes that qualify to be Processed.
      • Leave empty to apply any file.
      • Default mimetypes are: 'application/pdf,image/tiff,image/jpeg,image/jp2'

    Advanced OCR/HOCR Settings

    We do not recommend making changes to the follow settings unless you are the System Administrator.

    1. The system path to the ghostscript (gs) binary that will be executed by this processor.

      • A full system path to the gs binary present in the same environment your PHP runs
      • Default path specified is: '/usr/bin/gs'

    2. Any additional argument your executable binary requires.

      • Any arguments your ghostscript (gs) binary requires to run. Use %file as replacement for the file if the executable requires the filename to be passed under a specific argument. We recommend testing with -r150 (150dpi image extraction) for better performance but -r300 can be also used if source Images in a PDF are small
      • Default argument specified is: -r150 %file

    3. The system path to the Tesseract binary that will be executed by this processor.

      • A full system path to the Tesseract binary present in the same environment your PHP runs
      • Default path specified is: '/usr/bin/tesseract'

    4. Within the ADO's metadata, the JSON key that contains the language in ISO639-3 (3 letter) format to be used for OCR/NLP processing via Tesseract.

      • Default JSON key specified is: 'language_iso639_3'

    1. Please provide a default language in ISO639-3 (3 letter) format. If none is provided we will use 'eng'

      • Default language specified is: 'eng'

    2. Any additional argument for your tesseract binary.

      • Any arguments your binary requires to run. Use %file as replacement for the file that is output by the GS binary. Use %language as replacement for the chosen language.
      • Default arguments specified are: '%file stdout -l %language hocr'

    3. The data/languages folder for Tesseract

      • Absolute path where the Languages are stored in the Server. This will be used in --tessdata-dir
      • Default path specified is: '/usr/share/tessdata'

    4. The system path to the pdfalto binary that will be executed by this processor.

      • A full system path to the pdfalto binary present in the same environment your PHP runs, e.g /usr/local/bin/pdfalto
      • Default path specified is: '/usr/bin/pdfalto'

    5. Any additional argument for your pdfalto binary.

      • Any arguments your binary requires to run. Use %file as replacement for the file that is output by the pdfalto binary.
      • Default arguments specified are: '%file -q

    6. The expected and desired output of this processor.

      • If the output is just data and \"One or more Files\" is selected all data will be dumped into a file and handled as such.
      • Default selection is: 'Data/Values that can be serialized to JSON'
      • Additional optional is to select 'One or more Files', but it is not recommended unless to use this for the default ocr operation since this will alter how the data is incorporated in the Search API (Solr index).

    7. Where and how the output will be used.

      • Default select is: 'In a Search API Document using the Strawberryfield Flavor Data Source (e.g used for HOCR highlight)'
      • Additional option to select 'As Input for another processor Plugin' --which will only have an effect if another Processor is setup to consume this output.

    8. The queue to use for this processor.

      • The primary queue will be execute in realtime while the Secondary will be execute in background
      • Default selection is for the 'Secondary queue in background'

    9. Checkbox to Use NLP (Natural Language Processing) to extract entities from Text

      • If checked Full text will be processed for Natural language Entity extraction using Polyglot.
      • Default option is to have the option checked.

    10. The URL location of your NLP64 server.

      • Defaults to http://esmero-nlp:6400

    11. Which method(NER) to use

      • The NER NLP method to use to extract Agents, Places and Sentiment.
      • Default selection: 'Polyglot (faster)'
      • Alternation selection: 'spaCy (more accurate)'

    12. Timeout in seconds for this process.

      • 900
      • If the process runs out of time it can still be processed again.
    13. Order or execution in the global chain.
      • 0

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the main Strawberry Runners or the Archipelago Documentation main page.

    ","tags":["Strawberry Runners","HOCR","OCR","Pager","Post-processing","Background Processing"]},{"location":"strawberryrunners_wacz_binary/","title":"Reviewing and adjusting the warc_to_wacz Post-Processor operation","text":"

    This page is under construction. Please stay tuned for further updates and thank you for your patience as we continue to brew up more documentation.

    Return to the main Strawberry Runners or the Archipelago Documentation main page.

    ","tags":["Strawberry Runners","WACZ","WARC","Binary","Post-processing","Background Processing"]},{"location":"strawberryrunners_webpage_text/","title":"Reviewing and adjusting the wacz_page_extractor and webpage Post-Processor operations","text":"

    This page is under construction. Please stay tuned for further updates and thank you for your patience as we continue to brew up more documentation.

    Return to the main Strawberry Runners or the Archipelago Documentation main page.

    ","tags":["Strawberry Runners","Fulltext Search","WACZ","Webpage","Post-processing","Background Processing"]},{"location":"traditional-install/","title":"Traditional install","text":""},{"location":"traditional-install/#traditional-installation-notes","title":"Traditional Installation Notes","text":"

    For those who prefer classic approaches to system installation and configuration (instead of Dockerized deployment), this page is reserved for notes, recommendations, and guides.

    • Giancarlo Birello is maintaining and sharing the following documentation:
      • Dev DBOpen: developer site of the DBOPen project
      • Includes an Architecture overview and Step by Step instructions

    Please stay tuned for additional future updates. Thank you!

    Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"twig_extensions/","title":"Twig Extensions","text":"

    One advantage of Drupal's integration of the Twig template engine is the availability of extensions (filters and functions).

    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON","Markdown","HTML"]},{"location":"twig_extensions/#default-twig-extensions-from-symfony","title":"Default Twig Extensions from Symfony","text":"

    The Symfony PHP framework, which is integrated into Drupal Core, provides extensions, which we use in our default templates:

    • Twig Filters from Symfony
    • Twig Functions from Symfony
    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON","Markdown","HTML"]},{"location":"twig_extensions/#default-twig-extensions-from-drupal","title":"Default Twig Extensions from Drupal","text":"

    Additionally, we have some very handy Drupal-specific extensions:

    • Twig Filters from Drupal
    • Twig Functions from Drupal
    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON","Markdown","HTML"]},{"location":"twig_extensions/#default-twig-extensions-from-archipelago","title":"Default Twig Extensions from Archipelago","text":"

    Finally, we have a growing list of extensions that apply to our own specific use cases:

    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON","Markdown","HTML"]},{"location":"twig_extensions/#twig-filters-from-archipelago","title":"Twig Filters from Archipelago","text":"

    edtf_2_human_date

    The edtf_2_human_date filter takes an EDTF date and an optional language code (defaults to English), and converts it to a human-readable format using the EDTF PHP library. The list of language codes is available here.

    Let's start with the following metadata fragment: Metadata Fragment

    ...\n\"subject_wikidata\": \"\",\n\"date_created_edtf\": {\n    \"date_to\": \"\",\n    \"date_free\": \"~1899\",\n    \"date_from\": \"\",\n    \"date_type\": \"date_free\"\n},\n\"date_created_free\": null,\n...\n

    Then we pass the date_free field through the trim filter (as a precaution, in case there's any accidental whitespace), and then we finally hand off the field to our edtf_2_human_date filter: edtf_2_human_date

    {{ data.date_created_edtf.date_free|trim|edtf_2_human_date('en') }}\n\n{# Output: Circa 1899 #}\n

    html_2_markdown

    The html_2_markdown filter, as the name suggests, converts HTML to Markdown.

    We start with this string of HTML: HTML string

    {% set html_string = \"\n  <ul>\n    <li>One thing</li>\n    <li>Another thing</li>\n    <li>The last thing</li>\n  </ul>\n\" %}\n

    Then we pass it to the filter: html_2_markdown

    {{ html_string | html_2_markdown }}\n\n{# Output:\n  - One thing\n  - Another thing\n  - The last thing\n#}\n

    markdown_2_html

    The markdown_2_html filter, as the name suggests, is the reverse of the above and converts Markdown to HTML.

    We start with this string of Markdown: Markdown string

    {% set markdown_string = \"\n  - One thing\n  - Another thing\n  - The last thing\n\" %}\n

    Then we pass it to the filter: markdown_2_html

    {{ markdown_string | markdown_2_html }}\n\n{# Output:\n  <ul>\n    <li>One thing</li>\n    <li>Another thing</li>\n    <li>The last thing</li>\n  </ul>\n#}\n

    sbf_json_decode

    The sbf_json_decode filter decodes a JSON-encoded string.

    We start with this string of JSON string: JSON string

    {% set json_string = \"\n  {\n    \\\"date_to\\\": \\\"\\\",\n    \\\"date_free\\\": \\\"~1899\\\",\n    \\\"date_from\\\": \\\"\\\",\n    \\\"date_type\\\": \\\"date_free\\\"\n  }\n\" %}\n

    Then we pass it to the filter: sbf_json_decode

    {% json_decoded = json_string | sbf_json_decode %}\n\n{{ json_decoded.date_free }}\n{# Output:\n  ~1899\n#}\n

    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON","Markdown","HTML"]},{"location":"twig_extensions/#twig-functions-from-archipelago","title":"Twig Functions from Archipelago","text":"

    clipboard_copy

    The clipboard_copy function, using the clipboard-copy-element library, takes a provided CSS class for the element(s) whose text we'd like to copy, and targets the CSS class of an existing HTML element on the page or generates an HTML element that can be clicked to copy the text to the user's clipboard.

    Usage

    clipboard_copy usage
    {{ clipboard_copy('CSS CLASS','OPTIONAL CSS CLASS(ES)','OPTIONAL TEXT') }}\n

    This function takes three arguments:

    • a CSS class for the element to copy
    • an optional CSS class (the default is clipboard-copy-button) or classes (space-separated) for the copy button if auto-generating or a single, unique class if using your own existing button(s)
    • optional text (the default is Copy to Clipboard) for the copy button if auto-generating

    In the examples below, we want users to be able to copy the text from three different kinds of HTML elements: a div, an input, and an a hyperlink href.

    Copying div element text with auto-generated button

    First we start by giving the div element(s) we'd like to copy a unique class:

    div element text
    <div class=\"csl-bib-body-container chicago-fullnote-bibliography\">\n  <div id=\"copy-csl\" class=\"csl-bib-body\">\n    <div class=\"csl-entry\">\n      New York Botanical Garden. \u201cDescriptive Guide to the Grounds, Buildings and Collections.\u201d\n    </div>\n  </div>\n</div>\n

    Then we pass the class to the function:

    clipboard_copy for div element text
    {{ clipboard_copy('csl-bib-body','','Copy Bibliography Entry') }}\n

    Note

    The class can be attached to parent elements of the element we are ultimately targeting if needed, but any intermediate characters may get caught up in the copied text.

    Or to give the generated button multiple classes (in case they need additional styling):

    clipboard_copy for div element text
    {{ clipboard_copy('csl-bib-body','custom custom-button','Copy Bibliography Entry') }}\n

    The result for the above div example looks as follows:

    The following is the HTML for the auto-generated button with no provided CSS class:

    <button class=\"clipboard-copy-button\">\n  <clipboard-copy for=\"copy-csl\" tabindex=\"0\" role=\"button\">Copy Bibliography Entry</clipboard-copy>\n</button>\n

    And the following is HTML for the auto-generated button with multiple CSS classes provided:

    <button class=\"custom custom-button\">\n  <clipboard-copy for=\"copy-csl\" tabindex=\"0\" role=\"button\">Copy Bibliography Entry</clipboard-copy>\n</button>\n

    Note

    The clipboard-copy-element library requires an element ID. If the element being copied does not have an ID, one will automatically generated and assigned.

    Copying input element value with auto-generated button

    First we start by giving the input element(s) we'd like to copy a unique class:

    input element value
    {% if attribute(data, 'as:image')|length > 0  or attribute(data, 'as:document')|length > 0  %}\n  <h2>\n    <span class=\"align-middle\">Direct Link to Digital Object's IIIF Presentation Manifest V3 </span>\n    <img src=\"https://iiif.io/img/logo-iiif-34x30.png\">\n  </h2>\n  {% set iiifmanifest = nodeurl|render ~ \"/metadata/iiifmanifest/default.jsonld\" %}\n  <input type=\"text\" value=\"{{ iiifmanifest }}\" id=\"iiifmanifest_copy\" size=\"{{ iiifmanifest|length }}\" class=\"col-xs-3 copy-content\">\n{% endif %}\n

    Then we pass the class to the function:

    clipboard_copy for input element value
    {{ clipboard_copy('copy-content','',\"Copy Link to Digital Object's IIIF Presentation Manifest V3\") }}\n

    Or to give the generated button multiple classes (in case they need additional styling):

    clipboard_copy for input element text
    {{ clipboard_copy('copy-content','custom custom-button',\"Copy Link to Digital Object's IIIF Presentation Manifest V3\") }}\n

    The result for the above input example looks as follows:

    The following is the HTML for the auto-generated button with no provided CSS class:

    <button class=\"clipboard-copy-button\">\n  <clipboard-copy for=\"iiifmanifest_copy\" tabindex=\"0\" role=\"button\">Copy Link to Digital Object's IIIF Presentation Manifest V3</clipboard-copy>\n</button>\n

    And the following is HTML for the auto-generated button with multiple CSS classes provided:

    <button class=\"custom custom-button\">\n  <clipboard-copy for=\"iiifmanifest_copy\" tabindex=\"0\" role=\"button\">Copy Link to Digital Object's IIIF Presentation Manifest V3</clipboard-copy>\n</button>\n

    Note

    The clipboard-copy-element library requires an element ID. If the element being copied does not have an ID, one will automatically generated and assigned.

    Copying anchor element hyperlink href with auto-generated button

    First we start by giving the a element(s) we'd like to copy a unique class:

    anchor element hyperlink href
    <a id=\"copy-documentation-id\" class=\"copy-documentation-class row\" href=\"https://docs.archipelago.nyc\">Archipelago Documentation</a>\n

    Then we pass the class to the function:

    clipboard_copy for anchor element hyperlink href
    {{ clipboard_copy('copy-documentation-class','',\"Copy Link to Documentation\") }}\n

    Or to give the generated button multiple classes (in case they need additional styling):

    clipboard_copy for anchor element text
    {{ clipboard_copy('copy-documentation-class','custom custom-button',\"Copy Link to Documentation\") }}\n

    The result for the above anchor example looks as follows:

    The following is the HTML for the auto-generated button with no provided CSS class:

    <button class=\"clipboard-copy-button\">\n  <clipboard-copy for=\"copy-documentation-id\" tabindex=\"0\" role=\"button\">Copy Link to Documentation</clipboard-copy>\n</button>\n

    And the following is HTML for the auto-generated button with multiple CSS classes provided:

    <button class=\"custom custom-button\">\n  <clipboard-copy for=\"copy-documentation-id\" tabindex=\"0\" role=\"button\">Copy Link to Documentation</clipboard-copy>\n</button>\n

    Note

    The clipboard-copy-element library requires an element ID. If the element being copied does not have an ID, one will automatically generated and assigned.

    The above examples automatically generate copy buttons. They can be styled, but if we need more control over the button placement and styling, we can use our own button(s) by ensuring that they meet the following requirements:

    1. A <copy-clipboard> element (this can be hidden) with a for attribute, whose value is the ID of the source element, attached to the element acting as the button.
    2. A class on the existing button that can be targeted. The class must either be unique (if a single button) or the number of elements with the class must match the number of source elements.
    3. A separate class for the copy source(s) with the same requirements as the previous step.
    Copying div element text with custom button

    First we start by giving the div element(s) we'd like to copy a unique class:

    div element text
    <div class=\"csl-bib-body-container chicago-fullnote-bibliography\">\n  <div id=\"copy-csl\" class=\"csl-bib-body\">\n    <div class=\"csl-entry\">\n      New York Botanical Garden. \u201cDescriptive Guide to the Grounds, Buildings and Collections.\u201d\n    </div>\n  </div>\n</div>\n

    Then we generate the button and pass the class to the function:

    clipboard_copy custom button for div element text
    <button class=\"custom-button btn btn-primary btn-sm\">\n  <clipboard-copy for=\"copy-csl\">Copy Text</clipboard-copy>\n</button>\n\n{{ clipboard_copy('csl-bib-body','custom-button','') }}\n

    Note

    The clipboard-copy-element library requires an element ID. If the element being copied does not have an ID, one will automatically generated and assigned.

    Copying input element value with custom button

    First we start by giving the input element(s) we'd like to copy a unique class:

    input element value
    {% if attribute(data, 'as:image')|length > 0  or attribute(data, 'as:document')|length > 0  %}\n  <h2>\n    <span class=\"align-middle\">Direct Link to Digital Object's IIIF Presentation Manifest V3 </span>\n    <img src=\"https://iiif.io/img/logo-iiif-34x30.png\">\n  </h2>\n  {% set iiifmanifest = nodeurl|render ~ \"/metadata/iiifmanifest/default.jsonld\" %}\n  <input type=\"text\" value=\"{{ iiifmanifest }}\" id=\"iiifmanifest_copy\" size=\"{{ iiifmanifest|length }}\" class=\"col-xs-3 copy-content\">\n{% endif %}\n

    Then we generate the button and pass the class to the function:

    clipboard_copy custom button for input element value
    <button class=\"custom-button btn btn-primary btn-sm\">\n  <clipboard-copy for=\"iiifmanifest_copy\">Copy Input</clipboard-copy>\n</button>\n\n{{ clipboard_copy('copy-content','custom-button','') }}\n

    Note

    The clipboard-copy-element library requires an element ID. If the element being copied does not have an ID, one will automatically generated and assigned.

    Copying anchor element with custom button

    First we start by giving the a element(s) we'd like to copy a unique class:

    anchor element hyperlink href
    <a id=\"copy-documentation-id\" class=\"copy-documentation-class row\" href=\"https://docs.archipelago.nyc\">Archipelago Documentation</a>\n

    Then we generate the button and pass the class to the function:

    clipboard_copy custom button for anchor element hyperlink href
    <button class=\"custom-button btn btn-primary btn-sm\">\n  <clipboard-copy for=\"copy-documentation-id\">Copy Link</clipboard-copy>\n</button>\n\n{{ clipboard_copy('copy-documentation-class','custom-button','') }}\n

    Note

    The clipboard-copy-element library requires an element ID. If the element being copied does not have an ID, one will automatically generated and assigned.

    sbf_entity_ids_by_label

    The sbf_entity_ids_by_label function, as the name suggests, provides a Drupal entity ID for the following Drupal entity types:

    • node
    • taxonomy_term
    • group
    • user

    If we start with the user entity jsonapi, we can do the following: sbf_entity_ids_by_label

    {% set jsonapi_user_ids=sbf_entity_ids_by_label('jsonapi','user','') %}\n\n{% for jsonapi_user_id in jsonapi_user_ids %}\n  {{ jsonapi_user_id }}\n{% endfor %}\n\n{# Output:\n  3\n#}\n

    As you can see above, the sbf_entity_ids_by_label function takes three arguments:

    • the entity label
    • the entity type (see above for supported types)
    • an optional entity bundle

    We then loop through the returned result, which is an array of IDs (in this case, just a single one).

    sbf_search_api

    The sbf_search_api function executes a search API query against a specified index.

    sbf_search_api
    {% set search_results=sbf_search_api('default_solr_index','strawberry',[],{'status':1},[]) %}\n{% set labels=search_results['results']['13']['fields']['label_2'] %}\n<ul>\n  {% for label in labels %}\n    <li>{{ label }}</li>\n  {% endfor %}\n</ul>\n

    As you can see above, the sbf_search_api function takes eight arguments:

    • The machine name of the Search API index to search against (string)
    • A full text term to search (string)
    • An array of full text fields to search the term against. If empty all will be used. (array)
    • The fields => filters to match against (associative array)
    • The fields to facet (array)
    • The fields to sort against (associative array)
    • Offset for the results (int)

    For this example we end up with the following output:

    • JPEG File Interchange Format
    • Organic farming--United States
    • Strawberries
    • Strawberry Field at Thorpes Organic Family Farm
    • organic agriculture
    • strawberries
    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON","Markdown","HTML"]},{"location":"twig_recipe_cards/","title":"Twig Recipe Cards for Common Use Cases","text":"

    The Twig Recipe Cards below reference common Metadata transformation, display, or other use cases/needs you may have in your own Archipelago repository.

    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON"]},{"location":"twig_recipe_cards/#getting-started-working-with-twig-in-archipelago","title":"Getting Started Working with Twig in Archipelago","text":"

    We recommend reading through our main Metadata Display Preview and Twigs in Archipelago documentation overview guides, and also our Working with Twig primer before diving into applying any of these recipes in your own Archipelago.

    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON"]},{"location":"twig_recipe_cards/#ami-ingest-template-adaptations-common-use-cases-and-twig-recipe-cards","title":"AMI Ingest Template Adaptations -- Common Use Cases and Twig Recipe Cards:","text":"

    Use Case #1: I used AMI LoD Reconciliation to reconciliate the values in my AMI Set Source CSV mods_subject_topic column against both LCSH and Wikidata. I would like to map the reconciliated values into the Archipelago default subject_loc and subject_wikidata JSON keys.

    Twig Recipe Card for Use Case #1:

      {#- LCSH -#}\n    {% if data.mods_subject_topic|length > 0 %}\n    \"subject_loc\": {{ data_lod.mods_subject_topic.loc_subjects_thing|json_encode|raw }},\n    {% endif %}\n  {#- Wikidata -#}     \n    {% set subject_wikidata = [] %}\n    {% for source, reconciliated in data_lod %}\n      {% if (('subject' in source) or ('genre' in source)) and reconciliated.wikidata_subjects_thing and reconciliated.wikidata_subjects_thing|length > 0 %}\n         {% set subject_wikidata = subject_wikidata|merge(reconciliated.wikidata_subjects_thing) %}\n      {% endif %}\n    {% endfor %}  \n

    Use Case #2: I have both columns containing a mods_subject_authority_lcsh_topic (labels) and corresponding mods_subject_authority_lcsh_valueuri (URIs) data in my AMI Set Source Data CSV that I would like to pair and map into the Archipelago default subject_loc JSON key.

    Twig Recipe Card for Use Case #2:

    {%- if data['mods_subject_authority_lcsh_topic'] is defined and not empty -%}\n    {% set subjects = data[\"mods_subject_authority_lcsh_topic\"] is iterable ? data[\"mods_subject_authority_lcsh_topic\"] : data[\"mods_subject_authority_lcsh_topic\"]|split('|@|') %} \n    {% set subject_uris = data[\"mods_subject_authority_lcsh_valueuri\"] is defined ? data[\"mods_subject_authority_lcsh_valueuri\"] : '' %} \n    {% set subject_uris_list = subject_uris is iterable ? subject_uris : subject_uris|split('|@|') %}\n    \"subject_loc\": [\n        {% for subject in subjects %}\n        {\n            \"uri\": {{ subject_uris_list[loop.index0]|default('')|json_encode|raw }},\n            \"label\": {{ subject|json_encode|raw }}\n        }\n        {{ not loop.last ? ',' : '' }}\n        {% endfor %}\n    ],\n{%- endif -%}\n

    Use case #3: I have dc.creator and dc.contributor columns in my AMI Set Source Data CSV with simple JSON-encoded values (e.g. source column cells contain [\"Name 1, Name 2\"]) that I would like to map to the Archipelago default creator_lod JSON key.

    Twig Recipe Card for Use Case #3:

    {% if data['dc.creator']|length > 0 or data['dc.contributor']|length > 0 %}\n    {% set total_creators = (data[\"dc.creator\"]|length) + (data[\"dc.contributor\"]|length) %}\n    {% set current_creator = 0 %}                \n    \"creator_lod\": [\n        {% for creator in data[\"dc.creator\"] %}\n            {% set current_creator = current_creator + 1 %}\n            {% set creator_source = data[\"dc.creator\"][loop.index0] %}\n        {\n            \"name_uri\": null,\n            \"agent_type\": null,\n            \"name_label\": {{ creator|json_encode|raw }},\n            \"role_label\": \"Creator\",\n            \"role_uri\": \"http://id.loc.gov/vocabulary/relators/cre\"\n        }\n        {{ current_creator != total_creators ? ',' : '' }}\n        {% endfor %}\n        {% for creator in data[\"dc.contributor\"] %}\n            {% set current_creator = current_creator + 1 %}\n            {% set creator_source = data[\"dc.contributor\"][loop.index0] %}\n        {\n            \"name_uri\": null,\n            \"agent_type\": null,\n            \"name_label\": {{ creator|json_encode|raw }},\n            \"role_label\": \"Contributor\",\n            \"role_uri\": \"http://id.loc.gov/vocabulary/relators/ctb\"\n        }\n        {{ current_creator != total_creators ? ',' : '' }}\n        {% endfor %}   \n ],\n{% endif %}  \n
    Use Case #4: I have a mix of different columns containing Creator/Contributor/Other-Role-Types Name values with or without corresponding URI values that I would like to map to the default Archipelago creator_lod JSON key.

    Twig Recipe Card for Use Case #4:

    Click to view the full Recipe Card 
    {#- START Names from LoD and MODS CSV with/without URIS. -#} \n    {# Updated August 26th 2022, by Diego Pino. New checks/logic for mods_name_type_role_composed_or_more_namepart\n    - Check first IF for a given namepart there is already reconciliaton. \n    - IF not i check if there is a matching valueuri, \n    - If not leave the URL empty and use the value in the namepart (label) only?\n    - Only check/use mods_name_corporate/personal_namepart field IF there are no other fields\n    - That specify Roles. Since normally in ISLANDORA that field (no role) is a Catch all names one\n    - And in that case USE creator as the default ROLE\n    #}\n    {%~ set creator_lod = [] -%} \n    {# Used to keep track of parts after the type (corporate, etc) that are no roles\n     but authority properties. Add more if you find them #}\n    {%  set roles_that_are_no_roles = ['authority_naf','authority_marcrelator',''] %}\n    {# Used to keep track of the ones that are reconciled already #}\n    {%- set name_has_creator_lod = [] -%}\n    {%- for key,value in data_lod -%}\n      {%- if key starts with 'mods_name_' and key ends with '_namepart' -%}\n      {# If there is mods_name_SOMETHING_namepart in data_lod we keep track so we \n      do not try afterwards to use that Sources KEY from the CSV.\n      #}\n        {%- set name_has_creator_lod = name_has_creator_lod|merge([key]) -%}\n      {# Now we remove 'mods_name_' and '_namepart' #}\n        {%- set name_type_and_role = key|replace({'mods_name_':'', '_namepart':''}) -%}\n      {# We will only target personal or corporate. If any of those are missing we skip? #}\n        {% set name_type = null %}\n        {%- if name_type_and_role starts with 'personal_' -%}\n           {% set name_type = 'personal' %}\n        {%- elseif name_type_and_role starts with 'corporate_' -%}\n           {%- set name_type = 'corporate' -%}\n        {%- endif -%}\n        {%- if name_type is not empty -%}\n        {#- Now we remove 'type', e.g 'corporate_' -#}\n          {%- set name_role = name_type_and_role|replace({(name_type ~ '_'):''}) -%}\n          {# in case the name_role contains one of roles_that_are_no_roles, e.g\n          something like `creator_authority_marcrelator` we remove that #}\n          {% for role_that_is_no_role in roles_that_are_no_roles %}\n             {%- set name_role = name_role|replace({(role_that_is_no_role):''}) -%}\n          {% endfor %}\n          {# After removing all what can not be a role if we end with an empty #}\n          {% if name_role|trim|length == 0 %}\n             {%- set name_role = \"creator\" %}\n          {% else %}\n            {%- set name_role = name_role|replace({'\\\\/':'//' , '_':' '})|trim -%}\n          {% endif %}\n        {#- we iterate over all possible vocabularies and fetch the reconciliated names from them (if any) -#}\n          {%- for approach, names in value -%} \n        {#- if there are actually name pairs (name and uri) that were reconciliated we use them -#}\n            {%- if names|length > 0 -%}\n              {#- we call the ami_lod_reconcile twig extension with the role label using the LoC Relators endpoint in english and get 1 result -#}\n              {%- set role_uri = ami_lod_reconcile(name_role|lower|capitalize,'loc;relators;thing','en',1) -%}\n              {#- for each found name pair in a list of possible LoD reconciliated elements we generate the final structure that goes into \"creator_lod\" json key -#}\n              {%- for name in names -%} \n                {%- set creator_lod = creator_lod|merge([{'role_label': name_role|lower|capitalize, 'role_uri': role_uri[0].uri, \"agent_type\": name_type, \"name_label\": name.label, \"name_uri\": name.uri}]) -%}     \n             {%- endfor -%}\n            {%- endif -%}\n          {%- endfor -%}\n        {% endif -%}\n      {%- endif -%} \n    {%- endfor -%}\n    {# Now go for the RAW CSV data for names #}\n    {%- for key,value in data -%}\n    {# here we skip values previoulsy fetched from LoD and stored in name_has_creator_lod #}\n      {%- if key not in name_has_creator_lod and key starts with 'mods_name_' and key ends with '_namepart' -%}\n      {# If there is mods_name_SOMETHING_namepart in data_lod we keep track so we \n      do not try afterwards to use that Sources KEY from the CSV.\n      #}\n        {%- set name_has_creator_lod = name_has_creator_lod|merge([key]) -%}\n      {# Now we remove 'mods_name_' and '_namepart' #}\n        {%- set name_type_and_role = key|replace({'mods_name_':'', '_namepart':''}) -%}\n      {# We will only target personal or corporate. If any of those are missing we skip? #}\n        {%- set name_type = null -%}\n        {%- if name_type_and_role starts with 'personal_' -%}\n           {%- set name_type = 'personal' -%}\n        {%- elseif name_type_and_role starts with 'corporate_' -%}\n           {%- set name_type = 'corporate' -%}\n        {%- endif -%}\n        {% if name_type is not empty %}\n        {# Now we remove 'type', e.g 'corporate_' #}\n          {%- set name_role = name_type_and_role|replace({(name_type ~ '_'):''}) -%}\n          {# in case the name_role contains one of roles_that_are_no_roles, e.g\n          something like `creator_authority_marcrelator` we remove that #}\n          {% for role_that_is_no_role in roles_that_are_no_roles %}\n             {%- set name_role = name_role|replace({(role_that_is_no_role):''}) -%}\n          {% endfor %}\n          {# After removing all what can not be a role if we end with an empty #}\n          {% if name_role|trim|length == 0 %}\n             {%- set name_role = \"creator\" %}\n          {% else %}\n            {%- set name_role = name_role|replace({'\\\\/':'//' , '_':' '})|trim -%}\n          {% endif %}\n          {# Now we check if there is a corresponding _valueuri for this #}\n          {% set name_uris = [] %}\n          {%- if data[('mods_name_' ~ name_type_and_role ~ '_valueuri')] is not empty \n          and data[('mods_name_' ~ name_type_and_role ~ '_valueuri')] != '' -%}\n            {%- set name_uris = data[('mods_name_' ~ name_type_and_role ~ '_valueuri')]|split('|@|') -%}\n          {%- endif -%}\n          {%- set role_uri = ami_lod_reconcile(name_role|lower|capitalize,'loc;relators;thing','en',1) -%}\n        {#- we split and iterate over the value of the mods_name key -#}\n        {# NOTE. THIS IS TARGETING Anything after the year 1000, or 2000 #}\n          {%- for index,name in value|replace({'|@|1':', 1', '|@|2':', 2', '|@|-':', -'})|split('|@|') -%}\n            {%- if name is not empty and name|trim != '' -%}\n              {%- set name_uri = null -%}\n              {# Here we can check if one of the names IS not a name (e.g a year? #}\n              {#- we call the ami_lod_reconcile twig extension with the role label using the LoC Relators endpoint in english and get 1 result -#}\n              {%- if name_uris[index] is defined and name_uris[index] is not empty -%}\n                 {%- set name_uri = name_uris[index] -%}\n              {%- endif -%}\n              {%- set creator_lod = creator_lod|merge([{'role_label': name_role|lower|capitalize, 'role_uri': role_uri[0].uri, \"agent_type\": name_type, \"name_label\": name, \"name_uri\": name_uri}]) -%}\n            {%- endif -%}\n          {%- endfor -%}\n        {%- endif -%}\n      {%- endif -%}\n    {%- endfor ~%}\n    {# Use reduce filter + other logic for depulicating #}\n    {% set creator_lod = creator_lod|reduce((unique, item) => item in unique ? unique : unique|merge([item]), []) %}\n    \"creator_lod\": {{ creator_lod|json_encode|raw -}},\n    {#- END Names from LoD and MODS CSV with/without URIS. -#}\n

    Use Case #5: I have geographic location information that I would like to reconciliate against Nominatim and map into the default Archipelago 'geographic_location' key. I have AMI Source Data CSVs which contain values/labels and some which contain coordinates.

    Twig Recipe Card for Use Case #5 with variation notes:

    {#- <-- Geographic Info and terms:\n  Includes options for geographic info for:\n  - Nominatim lookup by value/label\n  - Nominatim lookup by coordinates \n  -#}\n    {#- use value for Nominatim search -#}\n    {% if data.mods_subject_geographic|length > 0 %}\n      {% set nominatim_from_label = ami_lod_reconcile(data.mods_subject_geographic,'nominatim;thing;search','en') -%}\n    \"geographic_location\": {{ nominatim_from_label|json_encode|raw }},\n    {% endif %}\n    {#- use coordinates for Nominatim search, if provided -#}\n    {% if data.mods_subject_cartographics_coordinates|length > 0 %}\n      {% set nominatim_from_coordinates = ami_lod_reconcile(data.mods_subject_cartographics_coordinates,'nominatim;thing;reverse','en') -%}\n    \"geographic_location\": {{ nominatim_from_coordinates|json_encode|raw }},\n    {% endif %}\n{#- Geographic Info and terms --> #}  \n

    Use Case #6: I have date values in a dc.date column that contain instances of 'circa' or 'Circa' where I would like to replace with the EDTF-friendly '~' instead and map to the Archipelago default 'date_created_edtf' JSON key.

    Twig Recipe Card for Use Case #6: 

        {% if data['dc.date'] is defined %}\n        {% set datecleaned = data['dc.date']|replace({\"circa \":\"~\", \"Circa \":\"~\"}) %}\n        \"date_created_edtf\": {\n        \"date_to\": \"\",\n        \"date_free\": {{ datecleaned|json_encode|raw }},\n        \"date_from\": \"\",\n        \"date_type\": \"date_free\"\n        },        \n    {% endif %}\n

    More recipe cards will be added over time. Please see our Archipelago Contribution Guide to learn about contributing your own recipe card or other documentation.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON"]},{"location":"utility_scripts/","title":"Utility Scripts","text":"

    If you've already followed deployment guides for archipelago-deployment and archipelago-deployment-live, you may have used some shell scripts that archipelago provides. The scripts are available in the scripts/archipelago/ and drupal/scripts/archipelago/ folders respectively.

    ","tags":["Bash","Scripts","DevOps"]},{"location":"utility_scripts/#importexport-metadata-display-twig-templates","title":"Import/Export Metadata Display Twig Templates","text":"

    Metadata Display Entity Twig Templates can be exported out of and imported into both local and remote deployments with the following script: import_export.sh. The script can be run interactively or non-interactively.

    Docker host vs. Docker container

    Because the script uses the Docker .env file for the JSONAPI user and URL by default, we recommend running this directly on the host.

    ","tags":["Bash","Scripts","DevOps"]},{"location":"utility_scripts/#interactive-mode","title":"Interactive Mode","text":"

    Running the script interactively will guide you through a number of prompts to configure and import or export to an existing folder or to one which will be created.

    ./import_export.sh -n\n
    ","tags":["Bash","Scripts","DevOps"]},{"location":"utility_scripts/#non-interactive-mode","title":"Non-interactive Mode","text":"

    To run the command non-interactively provide the required and optional parameters with the necessary arguments as needed.

    Options for Non-interactive Mode

    -i or -e (required)

    \u00a0\u00a0\u00a0\u00a0Import or export, respectively, Metadata Entity Display Twig Templates from a local folder.

    -s path (required)

    \u00a0\u00a0\u00a0\u00a0The absolute path of the local folder to export to or import from.

    -j path/filename (only required if the .env file containing the JSONAPI user and password is in a non-standard location)

    \u00a0\u00a0\u00a0\u00a0The absolute path to the .env file containing the JSONAPI user and password.

    -d url (required if URL is not in .env file or importing to or exporting from a remote deployment)

    \u00a0\u00a0\u00a0\u00a0The URL of the archipelago deployment.

    -k (optional)

    \u00a0\u00a0\u00a0\u00a0Keep any existing files ending with .json in the specified folder (the default is to delete) before exporting.

    JSONAPI User

    The JSONAPI user credentials, by default, will be read from the .env files in the following locations (relative to the root of the deployment):

    Deployment File Location archipelago-deployment-live ./deploy/ec2-user/.env archipelago-deployment ./.env

    A separate file can also be passed as an argument using the -j option.

    .env
    JSONAPI_USER=jsonapi\nJSONAPI_PASSWORD=jsonapi\n

    Exporting from local archipelago-deployment-live

    ./import_export.sh -e -s /home/ec2-user/metadatadisplay_export\n
    After logging into the archipelago-deployment-live host, the above command will delete any files with the .json extension if the destination folder exists. Otherwise, the folder will be created. The JSON user credentials and domain from the .env file will then be used to download the files so please make sure these are set.

    Exporting from local archipelago-deployment

    ./import_export.sh -e -s /home/user/metadatadisplay_export -d http://localhost:8001\n
    This will work the same way as the above example, but the URL is passed as an argument in this case since the .env file will not contain (in most cases) the domain. As above, the JSON user credentials will have to be set in the .env file.

    Exporting from remote archipelago-deployment-live

    ./import_export.sh -e -s /home/user/metadatadisplay_export -d https://archipelago.nyc\n
    This is essentially the same as the example directly above, except that in this case the JSON user credentials in the .env file will have to be set to the ones used to access the remote instance.

    Importing locally into archipelago-deployment-live

    ./import_export.sh -i -s /home/user/metadatadisplay_import\n
    This is essentially the same as the first example above, except that the import option (-i) is used. The folder name is changed for the sake of example, but you can use the same folder that was used for exporting.

    Importing locally into archipelago-deployment

    ./import_export.sh -i -s /home/user/metadatadisplay_import -d http://localhost:8001\n
    As in the example directly above, this corresponds to the example for exporting with a local archipelago-deployment instance, except that the import option (-i) is used.

    Importing from local instance into remote archipelago-deployment-live

    ./import_export.sh -i -s /home/user/metadatadisplay_import -d https://archipelago.nyc\n
    In this example, the locally exported files are being imported into a remote instance. As in the above examples with remote instances, the JSON user credentials need to be set in the .env file to those with access to the remote instance.

    ","tags":["Bash","Scripts","DevOps"]},{"location":"utility_scripts/#automatic-deployment-script","title":"Automatic Deployment Script","text":"

    If you're frequently deploying locally with archipelago-deployment, you may want to use the automated deployment script available at scripts/archipelago/devops/auto_deploy.sh. The script is interactive and can be called from the root of the deployment, e.g. /home/user/archipelago-deployment/:

    Automatic Deployment

    scripts/archipelago/devops/auto_deploy.sh

    Follow the prompts and select your options to complete the deployment.

    ","tags":["Bash","Scripts","DevOps"]},{"location":"webforms/","title":"Webforms in Archipelago","text":"

    The Webform Strawberryfield module provides Drupal Webform ( == awesome piece of code) integrations for StrawberryField so you can really have control over your Metadata ingests. These custom elements provide Drupal Webform integrations for Archipelago\u2019s StrawberryField so you can have fine grained and detailed control over your Metadata ingests and edits.

    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"webforms/#instructions-and-guides","title":"Instructions and Guides","text":"
    • How to Create a Webform as an Input Method for Archipelago Digital Objects (ADO)
    • Customizing Webforms: Modifying allowable file extensions
    • Archipelago Custom Webform Elements
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"webforms/#examples","title":"Examples","text":"

    Use these webforms or their elements to create a custom webform for your own repository/project needs

    • Archipelago Default Deployment Webforms

      • Descriptive Metadata

        • Corresponding Schema.org Type Options

      • Digital Object Collection

        • Corresponding Schema.org Type Options

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"webformsasinput/","title":"How to Create a Webform as an Input Method for Archipelago Digital Objects (ADO) / Primer on Display Modes","text":"

    Drupal 8/9 provides a lot of out-of-the-box functionality to setup the way Content Entities (Nodes or in our case ADOs) are exposed to users with the proper credentials. That functionality lives under the \"Display Modes\" and can be accessed at yoursite/admin/structure/display-modes.

    In a few quick words, The Display Mode Concept covers: formatting your Content Entities and their associated Fields so when a user lands on a Content Page, they are displayed in a certain, hopefully pleasing, way and also how users with proper Credentials can fill inputs/edit values for each field a Content Entity provides.

    First, formatting output (basically building the front facing page for each content entity) is done by a View Mode. Second, defining how/what input method you are going to use to create or edit Content entities, is handled by a Form Mode. Both Modes, are, in Drupal Lingo, Configuration Entities, they provide things you can configure, you can name them and reuse them and those configurations can all be exported and reimported using YAML files. Also both Modes the following in common:

    • Drupal always provides a \"default\" one that can not be deleted.
    • You can create new ones.
    • You can apply permissions to them.
    • All Modes work on \"fields\", means the tiny little input/output pieces that are either part of a Content Entity or attached to them (the title, the Body, and in our case a Strawberryfield (SBF),
    • They Provide Config/setting options for each Field.
    • They are always associated to Content Types/Bundles. Means all Nodes of the same Content type will share the same modes.

    The main difference, other than their purpose (Output v/s Input) is that, on View Modes, the settings you apply to each field are associated to \"Formatters\" and on Form Modes, the settings you apply to each field are connected to \"Widgets\".

    So, resuming, this is what lives under the Concept of a \"Display Mode\":

    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#view-mode","title":"View Mode","text":"
    • Each field attached to a Content Entity can have a Formatter applied and most of them have configuration options.
    • Formatters do one thing right: they take the raw, stored value and make it \"visible\" inside Drupal.
    • Which formatters are available will depend on the \"type\" of field the Content Entity has.
      • E.g A Node title/Label will have a Title formatter with the option of just displaying a text or a text with a link to the entity.
      • More Complex and fun Fields, like the ones of type SBF will provide a large list of possible Formatters, like IIIF driven viewers, Video formatters, Metadata Display (Twig template driven) ones, etc. This is because a SBF type of field has much more than just a text value, it contains a full graph of metadata and properties, inclusive links to Files and provenance metadata.
    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#form-mode","title":"Form Mode","text":"
    • Each field attached to a Content Entity can have a Widget applied and most of them have configuration options.
    • Widgets do one thing right: they expose some type of Form/UI interaction that allows a user to input data into the Entity, under that specific field. And of course they make sure that what you input is validated and saved (if good) correctly.

    • Which Widgets are available will depend on the \"type\" of field the Content Entity has.

      • Example: A Node Title will have a single Text Input with some options, like the size of the Textfield used to feed it.
      • More Complex and fun fields, like the ones of type SBF (strawberryfield), will provide a larger list of possible Widgets, ranging from raw JSON input (which you could select if your data was already in the right format) to the reason we are reading this: Webform driven Widgets. These Widgets include:
        • ones the webform_strawberryfield Drupal module provides
        • ones that use an existing Webform (which are also Entitites!) which either 1) you created or 2) we provided as a setting

      If you chose a widget other than the raw JSON, the widget will take the raw JSON to build, massage and enrich the data so that it can be presented in a visual format by the SBF. This is because a SBF type of field has much more than just a text value. It contains a full graph of metadata and properties, inclusive links to Files and provenance metadata, which for example allows us to use an Upload field directly in the attached/configured webform. - Form modes also have an additional benefit. Each one can have fine grained permissions. That way you can have many different Form Modes, but allow only certain ones to be visible, or usable by users of a given Drupal Role.

    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#i-think-i-get-thisbut-how-can-i-use-this-knowledge-now","title":"I think i get this...but how can i use this knowledge now?","text":"

    Good question! So, to enable, configure, and customize these Display Modes you have to navigate to your Content Type Configuration page in your running Archipelago. This is found at /admin/structure/types. Note: the way things are named in Drupal can be confusing to even the most deeply committed Drupal user, so bear in mind some terms will change. Feel free to read and re-read.

    You can see that for every existent Content Type, there is a drop down menu with options:

    • Manage Display: will lead you to configuration page where you can setup each View Mode and its settings for a given Content Type
    • Manage Form Display: will lead you to configuration page where you can setup each View Mode and its settings for a given Content Type
    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#manage-display","title":"Manage Display","text":"

    On the top you will see all your View Modes Listed, with the Default one selected and expanded. The Table that follows has one row per Field attached/part of this Content Type. Some of the fields are part of the Content Type itself, in this case Digital Object (bundled) and some other ones are common to every Content Entity derived from a Node. The \"Field\" column contains each field name (not their type, reason why you don't see Strawberry Field there!) but we can tell you right now that there is one, named \"Descriptive Metadata\", that is of SBF type.

    Wait! Which are the fields in my Content Type?

    How do we know that the field named \"Descriptive Metadata\" is a Strawberryfield? Well, we set-up the Digital Object Content Type for you that way, but also you can know what we know by pressing on \"Manage fields\" Tab on the top (don't forget to come back to \"Manage display\", afterwards!)

    Also Surprise: You Content Entity has really really just 2 fields! And that, friends, is one of the secret ingredients of Archipelago. All goes into a Single Field. But wait: i see more fields in my Manage Display table. Why? Well. Some of them are base fields, part of what a Drupal Node is: base field means you can not remove them, they are part of the Definition itself. One obvious one is the Title.

    But there are also some fields very particular to Archipelago: You can see there are also ones named \"Formatter Object Metadata\", \"Media\" and one named \"Static Media\"!. Where does come from? Those are also Strawberryfields. It sounds confusing but it is really simple. They are really not \"fields\" in the sense of having different data than \"Descriptive Metadata\". Those are In Memory, realtime, copies of the \"Descriptive Metadata\" SBF field and are there to overcome one limitation of Drupal 8:

    Each Field can have a single \"Formatter\" setup per field.

    But we want to re-usue the JSON data to show a Viewer, Show Metadata as HTML directly on the ADO/NODE landing page, and we want also to, for example, format sometimes images as Thumbnails and not using a IIIF viewer only. This CopyFields (Legal term) have also a nice Performance advantage. Drupal needs to fetch only once the data from the real Field, \"Descriptive Metadata\", from the database. And then just makes the data available in real time to its copies. That makes all fast, very very fast! And of course flexible. As you dig more into Archipelago you will see the benefits of this approach. Finally, if you need to, you can make more CopyFields. But the reality is, there is a single, only one, SBF in each Digital Object and its named \"Descriptive Metadata\".

    You can also simply not care about the type and trust the UI. It will just show Formatters that are right for each type and expose Configuration options (and a little abstract of the current ones) under the Widget Column. Operations Columns allows you to setup each Widget. Widget term here is a bit confusing. These are not really Widget in terms of Data Input, but in terms of \"Configuration\" Input. But D8/9 is evolving and its getting better. Those settings apply always only to the current View Mode.

    You can play with this, experiment and change some settings to get more comfortable. We humbly propose you that you complete this info with the official Drupal 8 Documentation and also apply custom settings to your own, custom View Mode so you don't end changing base, expected functionality while you are still learning.

    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#manage-form-display","title":"Manage Form Display","text":"

    On the top you will see all your Form Modes Listed, with the Default one selected and expanded. The Table that follows has one row per Field attached/partof this Content Type. The list of fields here is shorter, the SBF CopyFields are not present because all data goes really only into real fields. Also some other, display only ones (means you can not modify them) will not appear here. Again, Some of the fields are part of the Content Type itself, in this case Digital Object (bundled) and some other ones are common to every Content Entity derived from a Node. \"Field\" column contains each field name and the Widget Column allows you to select what type of Input you are going to use to feed it on Ingest/edit. On the right you will see again a little gear, that allows you to configure the settings for a particular Widget. Those settings apply always only to the current Form Mode.

    So. The one we want to understand is the one attached to the \"Descriptive Metadata\" field. Currently one named \"Strawberryfield webform based input with inline rendering\". There are other two. But let's start with this. Press on the Gear to the right on the same row.

    AS you can see there are not too many options. But, the main, first Text input is an Autocomplete field that will resolve against your existing Webforms. So, guess what. If you want to use your own Webform to feed a SBF, what do you do? You type the name, let the autocomplete work, select the right Webform, maybe your own custom one, and the you press \"Update\". Once that is done you need to \"Save\" your Form Mode (hint, button at the bottom of the page).

    We wish life was that easy (and it will once we are done with refining Drupal's UI) but for now there are some extra things you need to do to make sure the Webform, your custom one, can speak JSON. The default one you get named also \"Descriptive Metadata (descriptive_metadata)\", same as the field, is already setup to be used. Means if you create a new Webform by Copying that one, you can start using it inmediately. But if you created one from scratch (Different tutorial) you need to setup some settings.

    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#setting-up-a-webform-to-talk-strawberryfield","title":"Setting up a Webform to talk Strawberryfield","text":"

    Navigate to your Webform Managment form at /admin/structure/webform

    If you already created a Webform (different tutorial on how to do that) you will see your own named one in that list. I created for the purpose of this documentation one named \"Diego Test\" (Hi, i'm Diego..) and on the most right Column, \"Operations\" you will haven an Drop Down Menu. On your own Webform row, press on \"Settings\".

    First time, this can be a little bit intimitading. We recommend going baby steps since the Webform Module is a very powerful one but also exposes you to a lot (and sometimes too many) options. Even more, if you are new to Webforms, we recomment you to copy the \"Descriptive Metadata\" Webform we provided first, and make small changes to it (starting by naming it your own way!) so you can see how that affects your workflow and experience, and how that interacts with the created metadata. The Webform Module provides testing and building capabilities, so you have a Playground there before actually ingesting ADOs. Copying it will also make all the needed settings for SBF interaction to be moved over, so your work will be much easier.

    But we know you did not do that (where is the fun there right?). So lets setup one from scratch.

    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#general-settings","title":"General Settings","text":"

    Gist here is (look at the screenshot and copy the settings):

    • GENERAL Settings: Check \"Disable saving of submissions\" option. You won't need this form to generate a Native Webform Submission entry.
    • AJAX Settings: Check \"use ajax\" option. We want people to have the experience of staying in a single page while the create a new ADO via a Multi Step Webform Workflow.
    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#confirmation-settings","title":"Confirmation Settings","text":"

    Gist here is (again, look at the screenshot and copy the settings):

    • Select \"Inline Confirmation\". You don't want Webform to send your user to another page while they are still ingesting their ADOs.
    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#handler","title":"Handler","text":"

    The glue, the piece of resistance. The handler is the one that knows how to talk to a SBF. In simple words, the handler (any handler) provides functionality that does something with a Webform Submission. The one that you want to select here, is the \"Strawberryfield harvester\" handler. Add it, name it whatever you like (or copy what you see in the screenshot) and make sure you select, if running using our deployment strategy, \"S3 File System\" as the option for \"Permanent Destination for uploaded files\". The wording is tricky there, its not really Permanent, since that is handled by Archipelago, but more to Temporary, while working in ingesting an Object, destination for the Webform. Its not really wrong neither. Its permanent for the Webform, but we have better plans for the files and metadata!

    Save your settings. And you are ready to roll. That webform can now be used as a Setting for any of the StrawberryField Widgets that use Webforms.

    Finally (the real finally). Archipelago encourages at least one Field/JSON key to be present always. One with \"type\" as key value. So make sure that your Custom Webform has that one.

    There are two ways of doing that:

    • You can copy how it is setup from the provided Webform's Elements, from the main Descriptive Metadata Webform and then add one \"select\" element to yours using the same \"type\" \"key\".Important in Archipelago is always the key value since that is what builds the JSON for your metadata. The Description can be any, but for UI consistency you could want to keep it the same across all your webforms.

    • Or, advanced, you can use the import/export capabilities (Webforms are just YAML files!) and export/copy your custom one as text, add the following element before or after some existing elements there

       type:\n      '#type': select\n      '#title': 'Media Type'\n      '#options': schema_org_creative_works\n      '#required': true\n      '#label_attributes':\n        class:\n          - custom-form-input-heading\n

      And then reimport.

      Having a \"type\" value will make your life easier. You don't need it, but everything works smoother that way.

      Since you have a single Content Type named Digital Object, having a Webform field that has as key \"type\", which leads to a \"type\" JSON key, allows you to discern the Nature of your Digital Object, book or Podcast, Image or 3D and do smart, nice things with them.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"workingtwigs/","title":"Working with Twig in Archipelago","text":"

    The following information can also be found in this Presentation from the \"Twig Templates and Archipelago\" Spring 2021 Workshop:

    • Twig Templates and Archipelago
    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#prerequisites-with-food-analogy","title":"Prerequisites (with food analogy)","text":"
    1. Know your Data/Metadata. What do I have?
      • What do I have in my Fridge? Do I have Tofu? Do I have Peppermint ? One Bunch?
    2. Know your final desired output Document: MODS, HTML, GEOJSON, etc.
      • What are you going to cook ? Do you have a picture of the Curry ? Have you ever had Curry ?
    3. Know your Twig Basics
      • How to cut and dice , steam and saut\u00e9
    4. Do not be afraid
      • You can\u2019t get burned here and Ingredients do not expire!
    5. Ask for help. Slack/Google Groups/Postcards
      • Seeing others cook helps and also motivates. Others may share some spices.
    6. Use and Share your findings!
      • Eat what you cook. Share with friends and family.

    Note

    All examples shown below are using the following JSON snipped from Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?].

    Click to view image of the JSON snippet.

    Click to view this snippet as JSON. 
    {\n    \"type\": \"Photograph\",\n    \"label\": \"Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?]\",\n    \"owner\": \"New-York Historical Society, 170 Central Park West, New York, NY 10024, 212-873-3400.\",\n    \"rights\": \"This digital image may be used for educational or scholarly purposes without restriction. Commercial and other uses of the item are prohibited without prior written permission from the New-York Historical Society. For more information, please visit the New-York Historical Society's Rights and Reproductions Department web page at http:\\/\\/www.nyhistory.org\\/about\\/rights-reproductions\",\n    \"language\": [\n        \"English\"\n    ],\n    \"documents\": [],\n    \"publisher\": \"\",\n    \"ismemberof\": \"111\",\n    \"creator_lod\": [\n        {\n            \"name_uri\": \"\",\n            \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/pht\",\n            \"agent_type\": \"personal\",\n            \"name_label\": \"Stonebridge, George Ehler\",\n            \"role_label\": \"Photographer\"\n        }\n    ],\n    \"description\": \"George Ehler Stonebridge (d. 1941) was an amateur photographer who lived and worked in the Bronx, New York.\",\n    \"subject_loc\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/subjects\\/sh85038796\",\n            \"label\": \"Dogs\"\n        }\n    ],\n    \"date_created\": \"1910-01-01\"\n}\n
    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#first-know-your-data","title":"First: Know Your Data","text":"

    Understanding the basic structure of your JSON data.

    1. Single JSON Value.

      • For \"type\": \"Photograph\"
        • \"type\" = JSON Key or Property
        • \"Photograph\" = Single JSON Value (string)

    2. Multiple JSON Values (Array of Enumeration of Strings)

      - For \"language\": [\"English\",\"Spanish\"] - \"language\" = JSON Key or Property - \"[\"English\",\"Spanish\"]\" = Multiple JSON Values (Array of Enumeration of Strings)

    3. Multiple JSON Values (Array of Enumeration of Objects)

      • For \"subject_loc\":[{\"uri\":\"http://..\",\"label\":\"Dogs\"},{\"uri\":\"http://..\",\"label\":\"Pets\"}]
        • \"subject_loc\" = JSON Key or Property
        • [{\"uri\":\"http://..\",\"label\":\"Dogs\"},{\"uri\":\"http://..\",\"label\":\"Pets\"}] =
          • Object with two JSON Keys. Each one with a single Value
          • Multiple JSON Values (Array of Enumeration of Objects)
    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#getting-started-with-the-twig-language-in-archipelago","title":"Getting Started with the Twig Language in Archipelago","text":"

    • Data is known as Context in Twig Lingo.

    • All your JSON Strawberryfield Metadata is accessible inside a Variable named data in your twig template.

    • You can access the values by using data DOT Property (attribute) Name.

      • In the Laddie the Dog example shown above (originally):
        • data.type will contain \"Photograph\"
        • data.language will contain [ \"English\" ]
        • data.language[0] will contain \"English\"
          • 0 means first entry in an Array or Enumeration
        • data.subject_loc will contain [{ \"uri\":\"http://..\",\"label\": \"Dog\" }]
        • data.subject_loc.uri will contain \"http://..\"
        • data.subject_loc.label will contain \"Dog\"

    Note

    You also have access to other info in your context node: such asnode.id is the Drupal ID of your Current ADO; Also is_front, language, is_admin, logged_in; and more!

    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#twig-statements-and-printing","title":"Twig Statements and Printing","text":"

    Twig for Template Designers

    https://twig.symfony.com/doc/3.x/templates.html

    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#simple-examples-using-printing-statements","title":"Simple examples using Printing Statements","text":"

    Single JSON Value Example

    Twig template
    Hello I am a {{ data.type }} and very happy to meet you\n
    Rendered output
    Hello I am a Photograph and very happy to meet you\n

    Multiple JSON Values Example

    Twig template
    Hello I was classified as \"{{ data.subject_loc[0].label }}\" and very happy to meet you\n
    Rendered output
    Hello I was classified as \"Dogs\" and very happy to meet you\n
    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#twig-statements-and-executing","title":"Twig Statements and Executing","text":"

    If in Twig

    https://twig.symfony.com/doc/3.x/tags/if.html

    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#rendered-output-based-upon-different-twig-conditionals-operators-tests-assignments-and-filters","title":"Rendered Output based upon different Twig conditionals, operators, tests, assignments, and filters","text":"

    Conditionals, Operator, and Test Usage

    Twig Template
    {% if data.subject_loc is defined %}\nHey I have a Subject Key\n{% else %}\nUps no Subject Key\n{% endif %}\n
    Rendered Output
    Hello I was classified as \"Dogs\" and very happy to meet you\n
    • if/else are conditionals
    • is is an operator
    • defined is a test

    Loop Usage

    Twig Template
    {% for key, subject in data.subject_loc %}\n* Subject {{ subject.label }} found at position {{ key }}\n{% endfor %}\n
    Rendered Output
    * Subject Dogs found at position 0\n
    • for is a loop
    • Inside the loop you have access to key, subject

    Assignment, Filter, and Loop Usage

    Twig Template
    {% for subject in data.subject_loc %}\n{% set label_lowercase = subject.label|lower %}\nMy lower case Subject is {{ label_lowercase }}\n{% endfor %}\n
    Rendered Output
    `My lower case Subject is dogs`\n
    • set is an assignment
    • | is a pipe, used after a value to apply a filter.
    • lower is a filter
    • Inside the loop you have have access to subject and label_lowercase

    Loop Scope

    Twig Template
    {% for subject in data.subject_loc %}\n  {% set label_lowercase = subject.label|lower %}\nMy lower case Subject is {{ label_lowercase }}\n{% endfor %}\n{# \n The below won\u2019t display because it was assigned inside \n The For Loop\n#}\n{{ label_lowercase }}\n
    Rendered Output
    `My lower case Subject is dogs`\n
    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#full-examples-for-common-uses-cases","title":"Full Examples for Common Uses Cases:","text":"

    Use Case #1

    I have multiple LoD Subjects and want to display them in my page as a clickable ordered list but I\u2019m a safe/careful person.

    Twig Example for Use Case #1
    {% if data.subject_loc is iterable and data.subject_loc is not empty %}\n<h2>My Subjects</h2>\n<ul>\n   {% for subject in data.subject_loc %}\n   <li>\n      <a href=\"{{ subject.uri }}\" title=\"{{ subject.label|capitalize }}\" target=\"_blank\">\n      {{ subject.label }}\n      </a>\n   </li> \n   {% endfor %}\n</ul>\n{% endif %}\n

    Use Case #2

    I have sometimes a publication date. I want to show it in beautiful human readable language.

    Twig Example for Use Case #2
    {% if data.date_published is not empty %}\n<h2>Date {{ data.label }} was published:</h2>\n<p>\n{{ data.date_published|date(\"F jS \\\\o\\\\f Y \\\\a\\\\t g:ia\") }}\n</p>\n{% endif %}\n

    About date

    • date() is a function
    • It uses a \u201cDate Format Pattern\u201d as argument.

    Use Case #3 (Full Curry)

    {# May 4th 2021 @dpino: I have sometimes a user provided creation date. I want to show it in beautiful human readable language but fallback to automatic date if absent. I also want in the last case to show it was either \u201ccreated\u201d or \u201cupdated\u201d. #}

        \"as:generator\": {\n        \"type\": \"Update\",\n        \"actor\": {\n            \"url\": \"https:\\/\\/archipelago.nyc\\/form\\/descriptive-metadata\",\n            \"name\": \"descriptive_metadata\",\n            \"type\": \"Service\"\n        },\n        \"endTime\": \"2021-03-17T13:24:01-04:00\",\n        \"summary\": \"Generator\",\n        \"@context\": \"https:\\/\\/www.w3.org\\/ns\\/activitystreams\"\n    }\n
    Twig Example for Use Case #3
    {% if data.date_created is not empty %}\n<h2>Date {{ data.label }} was created:</h2>\n<p>\n  {{ data.date_created|date(\"F jS \\\\o\\\\f Y \\\\a\\\\t g:ia\") }}\n</p>\n{% else %}\n<h2>Date {{ data.label }} was {{ attribute(data, 'as:generator').type|lower }}d  in this repository:</h2>\n<p>\n  {{  attribute(data, 'as:generator').endTime|date(\"F jS \\\\o\\\\f Y \\\\a\\\\t g:ia\") }}\n</p>\n{% endif %}\n
    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#a-recommended-workflow","title":"A Recommended Workflow","text":"

    You want to create a New Metadata Display (HTML) or a new (XML) Schema based format?

    1. Get yourself an example document (Frame). If HTML copy the source. If XML copy the full XML. (Cmd+C or Ctrl+C)
    2. Create a new Metadata Display Entity. Copy the content (text) of your Frame into the Edit window. (Cmd+V or Ctrl+V)
    3. Select an existing (as complete as possible) ADO to use as preview, press Preview.
    4. Put your nice glasses on. What do you see? What data in your Frame do you have in your ADO (data)?
    5. Start nimble. Select the data.label info and check where your Frame uses a Title or a Label. Remove that text (Cmd+X or Ctrl+X) and replace with a {{ data.label }}. Press Preview. Do you see your title?
    6. Keep doing 5, over and over. Leave complex values for the end. (e.g data.subject_loc)
    7. Document your changes. {# I added this because .. #}
    8. Save.

    Once the Template is in place you can use it in a Formatter, as Endpoint, in your Search Results or just keep it around until you and the world are ready!

    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#and-now-its-your-turn","title":"And now it's your turn!","text":"

    We hope you found the information presented here to be helpful in getting started working with Twigs in Archipelago. Click here to return to the main Twigs in Archipelago documentation. Happy Twigging!

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"xdebug/","title":"Debugging PHP in Archipelago","text":"

    This document describes how to enable Xdebug for local PHP development using the PHPStorm IDE and a docker container running the Archipelago esmero-php:development image. It involves interacting with the esmero/archipelago-docker-images repo and the esmero/archipelago-deployment repo.

    "},{"location":"xdebug/#part-1-docker","title":"Part 1: Docker","text":"

    1. Run the following commands from your /archipelago-deployment directory:

      docker-compose down \\ docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d

      This version of docker-compose up uses an override file to modify our services. docker-compose.dev.yml we now have an extra PHP container called esmero-php-debug.

      To stop the containers in the future, run docker-compose -f docker-compose.yml -f docker-compose.dev.yml down.

      (To make these commands easier to remember, consider making bash aliases in your .bashrc file.) (If you are running your development on a Linux system, you may need to make a modification to your xdebug configuration file on the esmero-php-dev container. See appendix at the bottom of this page.)

      So we have reloaded the containers and now you are ready for Part 2.

    "},{"location":"xdebug/#part-2-phpstorm","title":"Part 2: PHPStorm","text":"

    1. In PHPStorm, open your archipelago-deployment project.

    2. Go to Preferences > Languages & Frameworks > PHP > Debug or Settings > PHP > Servers. In this window there is an Xdebug section. Use these settings:

      • Debug port: 9003. (do NOT use the default, 9000)
      • Can accept external connections: yes, select checkbox
      • (optional) Break at first line in PHP scripts: uncheck. If you leave this selected, you will have to manually step through a breakpoint from Drupal's main index.php file on every request, which is quite annoying. However, leaving this box checked can be useful for making sure the connection is working at first, before you have set any internal breakpoints.

      Your settings should look like this. Hit APPLY and OK.

    3. Go to Preferences > Languages & Frameworks > PHP > Servers. We will create a new server here. Use these settings:

      • Name: docker-debug-server
      • Host: localhost
      • Port: 8001
      • Use path mappings: yes, select the checkbox
      • Under project files, select the top-level archipelago-deployment directory in the File/Directory column.
      • In the Absolute path on the server add /var/www/html

      Hit APPLY and OK and close the window.

    4. Go to Run > Edit Configurations. Hit the + Button to create a new PHP Remote Debug. Name whatever you want, I called mine Archipelago. Use these settings:

      • Filter debug connection by IDE Key: yes, select the checkbox
      • Server: select docker-debug-server from dropdown (we created this in step 3)
      • IDE Key: archipelago (this matches the key set in our container)

    5. Note: If you try to validate your connection, it will fail. But that's ok.

    6. Validate your connection. With Run > Edit Configurations still open, you can hit the link that says \"Validate\". Use these settings in the following validation window:

      • Path to create validation script <your local path>/archipelago-deployment/web
      • Url to validation script: http://localhost:8001

      Hit VALIDATE. You should get a series of green check marks. If you get a warning about missing php.ini file, that is OK, our file has a different name in the container (xdebug.ini) and is still being read correctly.

    "},{"location":"xdebug/#set-up-browser-integration","title":"Set up Browser Integration","text":"

    1. We have had success using the XDebug Helper extension in Chrome. Once you have the extension installed, right-click on the bug icon in the top right of your chrome browser window and select \"Options\" to configure the IDE key. Under \"IDE\", select \"Other\", and in the text box, enter \"archipelago\"

    "},{"location":"xdebug/#actually-debugging","title":"Actually Debugging!","text":"

    1. Hit the button (top right bar of PHPStorm) that looks like a telephone, for Start Listening for PHP Debug Connections.

    2. Now, you can use Run > Debug and select the Archipelago named configuration that we created in the previous steps. The debugging console will appear. It will say it is waiting for incoming connection from 'archipelago' .

    3. Right now the debugging session is not enabled. Browse to localhost:8001. Click on the gray XDebug Helper icon at the top right of your window and select the green \"Debug\" button. This will tell chrome to set the xdebug session key when you reload the page.

    4. Now set a breakpoint in your code, and refresh the page. If you have breakpoints set, either manually, or from leaving \"Break at first line in PHP scripts\" checked, you should have output now in the debugger.

    5. If you are done actively debugging, it is best to click the green XDebug Helper icon and select \"Disable\". This will greatly improve speed and performance for your app in development. When you need to debug, just turn on debugging using the XDebug Helper button again.

    6. If you would like to see the output of your xdebug logs, run the following script: docker exec -ti esmero-php bash -c 'tail -f /tmp/xdebug.log > /proc/1/fd/2'

    Then, you can use the typical docker logs command on the esmero-php container, and you will see the xdebug output: docker logs esmero-php -f

    Xdebug makes accessing variables in Drupal kind of great. Many possibilities, including debugging for Twig templates. Happy debugging!

    "},{"location":"xdebug/#appendix-xdebug-on-a-linux-host","title":"Appendix: XDebug on a linux host","text":"

    If you are developing on a linux machine, you may need to make a change to the xdebug configuration file.

    1. Create a new file in the /archipelago-deployment/xdebug folder called xdebug.ini and enter the following text: 
      zend_extension=xdebug\n\n[xdebug]\nxdebug.mode=develop,debug\nxdebug.discover_client_host = 1\nxdebug.start_with_request=yes\n
    2. Make a bind mount to this file in your docker-compose.dev.yml file: 
        php-debug:\n  ...\n    volumes:\n  - ${PWD}:/var/www/html:cached\n    # Bind mount custom xdebug configuration file...\n  - ${PWD}/xdebug/xdebug.ini:/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini\n
    3. Restart your docker containers using the method described at the top of this page.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "}]} \ No newline at end of file +{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Archipelago Commons Intro","text":"

    Archipelago Commons, or simply Archipelago, is an evolving Open Source Digital Objects Repository / DAM Server Architecture based on the popular CMS Drupal 9/10 and released under GLP V.3 License.

    Archipelago is a mix of deeply integrated custom-coded Drupal modules (made with care by us) and a curated and well-configured Drupal instance, running under a discrete and well-planned set of service containers.

    Archipelago was dreamt as a multi-tenant, distributed, capable system (as its name suggests!) and can live isolated or in flocks of similar deployments, sharing storage, services, or -- even better -- just the discovery layer. Learn more about the different Software Services used by Archipelago.

    Archipelago's primary focus is to serve the greater GLAM community by providing a flexible, consistent, and unified way of describing, storing, linking, exposing metadata and media assets. We respect identities and existing workflows. We endeavor to design Archipelago in ways that empower communities of every size and shape.

    Finally, Archipelago tries to stay humble, slim, and nimble in nature with a small code base full of inline comments and @todos. All of our work is driven by a clear and concise but thoughtful planned technical roadmap --updated in tandem with new releases.

    "},{"location":"AMIviaSpreadsheets/","title":"Ingesting New Digital Objects and Collections using Spreadsheets or Google Sheets","text":"

    Ingesting Only Digital Objects or Both Digital Objects and Collections uses similar processes, with a few key differences. Click here to jump to the Ingesting both Digital Objects and Collections and/or Creative Work Series (Compound) Objects section of this guide page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#ingesting-only-new-digital-objects","title":"Ingesting Only New Digital Objects","text":"

    From either the main Content page or the AMI Sets List page, select the 'Start an AMI set' button to begin.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-1-plugin-selection","title":"Step 1: Plugin Selection","text":"

    Select the Plugin type you will be using from the dropdown menu.

    • Google Sheets Importer

    • Spreadsheet Importer (if using local CSV file)

    *The Remote JSON API Importer and additional remote import source options (for other repository systems) will be covered in separate tutorials following future releases.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-2-operation-and-spreadsheet-source-selection","title":"Step 2: Operation and Spreadsheet Source Selection","text":"

    Select 'Create New ADOs' as the Operation you would like to perform.

    • If using Google Sheets Importer:

      • Enter the ID of your Google Sheet
      • Enter the Cell Range for your Google Sheet

    • If using Spreadsheet Importer:

      • Under the 'Upload your file' section, select 'Choose File' to upload the CSV you will be using. After the file is finished uploading, you will have the option to 'Remove' and select a different file if needed.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-3-data-transformation-selections","title":"Step 3: Data Transformation Selections","text":"

    Select the data transformation approach--how your source data will be transformed into ADO (Archipelago Digital Object) Metadata.

    • You will have 3 options for your data transformation approach:

      1. Direct
        • Columns from your spreadsheet source will be cast directly to ADO metadata (JSON), without transformation/further processing (only intended for use with simple data strings or already JSON-encoded snippets/values).
      2. Custom (Expert Mode)
        • Provides very granular custom data transformation and mapping options
        • Needs to be used if importing Digital Objects and Digital Object Collections at the same time/from same spreadsheet source (see separate instructions below).
      3. Template
        • Columns from your spreadsheet source will be cast to ADO metadata (JSON) using a Twig template setup for JSON output.

    • You will also need to Select which columns contain filenames, entities or URLS where files can be fetched from. Select what columns correspond to the Digital Object types found in your spreadsheet source.

    • Lastly, for this step, you will need to select the destination Fields and Bundles for your New ADOs. If your spreadsheet source only contains Digital Objects, select Strawberry (Descriptive Metadata source) for Digital Object

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-4-global-ado-mappings","title":"Step 4: Global ADO Mappings","text":"

    Select your global ADO mappings.

    • Make sure to select the ismemberof collection membership relationship predicate column if applicable. For AMI source spreadsheets containing only non-Creative Work Series (Compound) Objects, only ismemberof can be mapped properly. To use ispartof relationship setup, please refer to the steps outlined in the separate section below.
    Click to read more about Archipelago's default relationship mappings 
    - `ismemberof` and/or `ispartof` (and/or whatever predicate corresponds with the relationship you are mapping)\n- these columns can be used to connect related objects using the object-to-object relationship that matches your needs\n- in default Archipelago configurations, `ismemberof` is used for Collection Membership and `ispartof` is used for Parent-Child Object Relationships (so a Child ADO would reference the Parent ADO in `ispartof`)\n- these columns can hold 3 types of values\n    - empty (no value)\n    - an integer to connect an object to another object's corresponding row in the same spreadsheet/CSV\n      * Ex: Row 2 corresponds to a Digital Object Collection; for a Digital Object corresponding to Row 3, the 'ismemberof' column contains a value of '2'. The Digital Object in Row 3 would be ingested as a member of the Digital Object Collection in Row 2.\n    - a UUID to connect with an already ingested object\n
    • By default, the option to automatically assigns UUIDs is selected. Keep 'Automatically assign UUID' checked unless your source data already contains UUIDs in a node_uuid column.

    • Under the 'Base ADO mappings', select the label column for ADO Label. This selection is only used as a fail-safe (in case your AMI JSON Ingest Template does not have any mapping for a column to be mapped to the JSON label key, or your source data csv does not contain a label if going Direct for data transformation).

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-5-zip-upload","title":"Step 5: ZIP upload","text":"

    Provide an optional ZIP file containing your assets.

    • You may choose to upload a ZIP file containing all or some of the corresponding files specified in your csv/spreadsheet.

    • The file upload size restrictions specified in your Archipelago instance will apply here (512MB maximum by default).

      • Please note, when creating your ZIP file (in particular, within an OSX environment): only select the folders and files needed, not the top/enclosing folder they are in.
    Click to view screenshot of example ZIP file creation in OSX

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-6-ami-set-confirmation","title":"Step 6: AMI Set Confirmation","text":"

    You will now see a message letting you know that 'Your source data was saved and is available as a CSV at linktotheAMIgenerated.csv

    The message will also let you know that your New AMI Set was created and provide a link to the AMI Set page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-7-ami-set-processing","title":"Step 7: AMI Set Processing","text":"

    Your newly created AMI Set will now need to be Processed.

    If you clicked on the 'see it here' link in Step 6, you will be brought to the AMI Set page for review. You may also select Process from the Operations menu for the AMI set from the main AMI sets page. From the Process page you can review the JSON configuration for your set (determined by your selections in the preceding steps).

    Optional step to review the settings configured in your AMI Set

    You may wish to double check the settings configured in your AMI Set in the Raw Metadata (JSON) on the AMI Set View tab before Processing.

    To Process this set, navigate to the Process tab. You will have multiple options related to the Processing outcome for your AMI Set.

    • Skip ADO processing on missing File : If enabled a referenced missed file or one that can not be processed from the source, remote or local will make AMI skip the affected ROW. Enabled by default for better QA during processing.
    • Desired ADOS Statuses After Process
      • The Statuses you have available will reflect the publication workflow/moderation states (such as Draft, Published, Archived/Unpublished) setup in your Archipelago instance, and the permissions associated your user account.
    • Please review the note about the 'remaining free space on your Drupal temporary filesystem. Please be aware of that before running a batch with large files'. If the amount of remaining free space you see does not seem sufficient for your AMI set processing needs, we recommend contacting your system administrator.

    • Enqueuing and File Processing Options

      • Enqueue but do not process Batch in realtime : Check this to enqueue but not trigger the interactive Batch processing. Cron or any other mechanism you have enabled will do the actual operation. This queue is shared by all AMI Sets in this repository and will be processed on a First-In First-Out basis.
      • Force every File attached to an ADO to be processed in its own Queue item : Warning: This may make your ingest slower. Check this to force every file attached to an ADO to be downloaded and characterized as an independent process. This bypasses the Number of files Global setting that would otherwise trigger this behavior.
      • Re download and reprocess every file : Check this to force every file attached to an ADO to be downloaded and characterized again, even if on a previous Batch run that data was already generated for reuse. IMPORTANT: Needed if e.g the URL of a file is the same but the remote source changed, if you have custom code that modifies the backend naming strategy of files.

    • Select Confirm to continue.

    You will be returned to AMI sets page and see a brief confirmation message regarding the Enqueuing and Processing options you selected.

    If you chose to 'Confirm\" and Process your AMI Set immediately, proceed to Step 9: Processing and ADO Creation.

    If the chose to 'Enqueue' your AMI Set and the Queue operations for your Archipelago instance have been configured, you can simply leave your AMI Set in the Queue for Processing on the preconfigured schedule. Common timing for AMI Set Processes schedules are typically setup to run every three to six hours. Contact your Archipelago Administrators for details about your particular Archipelago's Processing schedule.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-8-queue-manager-push-may-be-restricted-to-administrator-users-only","title":"Step 8: Queue Manager Push (may be restricted to Administrator Users only)","text":"

    If you chose to place your AMI set in the Queue to Process in step 7 and you wish to manually kickstart the Queue Processes, navigate to the Queue Manager found at /admin/config/system/queue-ui. (Be sure to select the Queue Manager under the System section, not the Queue Manager for Hydroponic Service under the Archipelago section).

    To Process your AMI Set immediately from the Queue Manager page, select the checkbox next to the 'AMI Digital Object Ingester Queue Worker'. Keep the Action menu set to Batch Process and click the Apply to selected items button.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-9-processing-and-ado-creation","title":"Step 9: Processing and ADO Creation","text":"

    Your AMI set will now be Processed. You can follow the set's progress through the Processing queues loading screen.

    After your AMI set is Processed, you will receive confirmation messages letting you know your Digital Objects were successfully created.

    From this message, you can click on each ADO title to review the new created Digital Object (or Collection) if you wish. Or, you may proceed to step 10.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-10-review-your-newly-created-digital-objects-directly-or-via-ami-set-report","title":"Step 10: Review your newly created Digital Objects directly or via AMI Set Report","text":"
    • Option 1: Return to the main Content page found at /admin/content and review your newly created Digital Objects. After ensuring that files and metadata elements were mapped correctly, you may choose to change the Status for your Digital Objects to 'Published'.

    • Option 2: Use the AMI Set Report

      • From the main AMI sets page, select Report from the Operations menu for the AMI set you wish to review.

      • This Report will contain information related to the last Processing operation run against your AMI Set.

      • For each Digital Object or Collection row that was Processed, you will see:
        • a datetime stamp
        • one of three level (INFO, WARNING, or ERRORS) applicability
        • a message summarizing the Processing outcome--including a title/label link to the created ADO if successful
        • a details summary containing system information related to the operations.

      • You can use information found in the Reports tab to identify review your created ADOs one-by-one and identify any errors or issues that may have come up during the Process if needed.
    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#ingesting-both-new-digital-objects-and-collections-andor-creative-work-series-compound-objects-in-the-same-spreadsheet","title":"Ingesting Both New Digital Objects and Collections and/or Creative Work Series (Compound) Objects in the same spreadsheet","text":"

    From either the main Content page or the AMI Sets List page, select the 'Start an AMI set' button to begin.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#steps-1-plugin-selection-step-2-operation-and-spreadsheet-source-selection","title":"Steps 1: Plugin Selection & Step 2: Operation and Spreadsheet Source Selection","text":"

    Follow the same instructions found above for Ingesting New Digital Objects.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-3-data-transformation-selections_1","title":"Step 3: Data Transformation Selections","text":"

    To import Digital Objects and Digital Object Collections and/or Creative Work Series (Compound) Objects at the same time/from same spreadsheet source, you will need to select the Custom (Expert Mode) option for your data transformation approach.

    • Custom (Expert Mode)
      • Provides very granular custom data transformation and mapping options

    You will then need to 'Select your Custom Data Transformation and Mapping Options' for each of your Digital Object, Collection, and Creative Work Series (Compound) types.

    • For Collection and Creative Work Series (Compound) objects:

      • Select either the Direct or Template (and corresponding JSON template) option for your data transformation approach.
      • Select the destination Fields and Bundles for Strawberry (Descriptive Metadata source) for Digital Object Collection
        • Use this same destination for your Creative Work Series (Compound) objects
      • You may also wish to Select which columns contain filenames, entities or URLS where files can be fetched from. For most Collection objects, you will likely leave unselected or choose images if you are uploading a thumbnail image for your Collection.

    • For each non-Creative Work Series (Compound) Digital Object type in your spreadsheet source:

      • You will also need to select either the Direct or Template (and corresponding JSON template) option for your data transformation approach.
      • Then Select the destination Fields and Bundles for Strawberry (Descriptive Metadata source) for Digital Object
      • Then select which columns contain filenames, entities or URLS where files can be fetched from. Select what columns correspond to the Digital Object types found in your spreadsheet source.

      • For example, for 'Map' type Digital Objects, you would select the following options (as depicted in this screenshot):

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-4-global-ado-mappings_1","title":"Step 4: Global ADO Mappings","text":"

    Select your global ADO mappings.

    • Make sure to select the applicable relationship predicate columns (such as ismemberof and ispartof).
    Click to read more about Archipelago's default relationship mappings 
    - `ismemberof` and/or `ispartof` (and/or whatever predicate corresponds with the relationship you are mapping)\n- these columns can be used to connect related objects using the object-to-object relationship that matches your needs\n- in default Archipelago configurations, `ismemberof` is used for Collection Membership and `ispartof` is used for Parent-Child Object Relationships (so a Child ADO would reference the Parent ADO in `ispartof`)\n- these columns can hold 3 types of values\n    - empty (no value)\n    - an integer to connect an object to another object's corresponding row in the same spreadsheet/CSV\n      * Ex: Row 2 corresponds to a Digital Object Collection; for a Digital Object corresponding to Row 3, the 'ismemberof' column contains a value of '2'. The Digital Object in Row 3 would be ingested as a member of the Digital Object Collection in Row 2.\n    - a UUID to connect with an already ingested object\n
    • By default, the option to automatically assigns UUIDs is selected. Keep 'Automatically assign UUID' checked unless your source data already contains UUIDs in a node_uuid column.
    • Under the 'Base ADO mappings', select the label column for ADO Label. This selection is only used as a fail-safe (in case your AMI JSON Ingest Template does not have any mapping for a column to be mapped to the JSON label key, or your source data csv does not contain a label if going Direct for data transformation).
    • In order to make sure that Digital Objects containing the corresponding UUID or spreadsheet row number for any corresponding Collections, make sure ismemberof is also selected in the ADO Parent Columns. In order to make sure that Digital Objects containing the corresponding UUID or spreadsheet row number for any corresponding Parent ADOs (Creative Work Series/Compounds), make sure ispartof is also selected in the ADO Parent Columns.

    • Select the corresponding Columns for the Required ADO mappings.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"AMIviaSpreadsheets/#step-5-10","title":"Step 5-10:","text":"

    Follow the same instructions found in Steps 5-10 above. As part of step 10, make sure your Digital Objects were ingested into the corresponding Collections you mapped them to in your spreadsheet source. Please note, you will need to Publish the Digital Objects before the Objects will appear in the Collection's View page (whether accessed as a logged-in Admin user or Anonymous/Public user). Celebrate your next AMI success with another fresh coffee, tea, or cookie!

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"CODE_OF_CONDUCT/","title":"Archipelago - code of conduct / anti-harassment policy","text":"

    The Archipelago Commons community and the Metropolitan New York Library Council (METRO) are dedicated to providing a welcoming and positive experience for all participants, whether they are at a formal gathering, in a social setting, or taking part in activities online. This includes any forum, mailing list, wiki, web site, IRC channel, public meeting, conference, workshop/training or private correspondence. The Archipelago community welcomes participation from people all over the world, and these community members bring with them a wide variety of professional, personal and social backgrounds; whatever these may be, we treat colleagues with dignity and respect.

    This Code of Conduct governs how we behave in public or in private. We expect it to be honored by everyone who represents the project officially or informally, claims affiliation with the project, or participates directly.

    We ask that all community members adhere to the following expectations:

    • METRO and Archipelago have a zero-tolerance policy for verbal, physical, and sexual harassment. Anyone who is asked to stop a hostile or harassing behavior is expected to do so immediately. Here, for reference, are New York State\u2019s requirements.

      Harassment includes: Offensive verbal comments related to sex, gender, ethnicity, nationality, socioeconomic status, sexual orientation, disability, physical appearance, body size, age, race, religion; sexual or discriminatory images in public spaces; deliberate intimidation; stalking; harassing photography or recording; sustained disruption of talks or other events; inappropriate physical contact; and unwelcome sexual attention.

    • Participation in discussions and activities should be respectful at all times. Please refrain from making inappropriate comments. Create opportunities for all people to speak, exercising tolerance of the perspectives and opinions of others. When we disagree, we do this in a polite and professional manner. We may not always agree. When frustrated, we back away and look for good intentions, not reasons to be more frustrated. When we see a flaw in a contribution, we offer guidance on how to fix it.

    • METRO and Archipelago honor the ability to be anonymous. If a person is going by their handle, a pseudonym, or doesn\u2019t wish to use their name, please respect their wishes and privacy. This also includes \u2018outing\u2019 someone\u2019s workplace, their age, their gender, their real name, etc, without their consent. We take people\u2019s privacy and their comfort very seriously.
    "},{"location":"CODE_OF_CONDUCT/#protocol-for-conflict-resolution","title":"Protocol for Conflict Resolution","text":"

    Participants in METRO and Archipelago communication channels violating this code of conduct may be sanctioned or expelled at the discretion of the organizers of the meeting (if the channel is an in-person event) or the Archipelago Advisory Board (if the channel is online).

    "},{"location":"CODE_OF_CONDUCT/#initial-incident","title":"Initial Incident","text":"

    If you are being harassed, notice that someone else is being harassed, or have any other concerns, and you feel comfortable speaking with the offender, please inform the offender that he/she/they has affected you negatively. Oftentimes, the offending behavior is unintentional, and the accidental offender and offended will resolve the incident by having that initial discussion. Participants asked to stop any harassing behavior are expected to comply immediately.

    "},{"location":"CODE_OF_CONDUCT/#escalation","title":"Escalation","text":"

    If the offender insists that they did not offend, if offender is actively harassing you, or if direct engagement is not a good option for you at this time, then you will need a third party to step in. To report any violation of the following code of conduct or if you have any questions or suggestions about this code of conduct, please contact archipelago-community@metro.org or fill out this form anonymously. This will be sent to leadership at METRO and the advisory board member currently acting as the Code of Conduct liaison. Our enforcement guidelines work in accordance with those published at the Contributor Covenant.

    Upon review, if METRO leadership and the Code of Conduct Liaison determine that the incident constitutes harassment they may take any action they deem appropriate, including warning the offender, expulsion from the meeting or other community channels, or contacting a higher authority such as a representative from the offender's institution.

    These policies draw from many other code of conduct documents, including but not limited to: code4lib, DLF, Islandora, ICG, Samvera, WikimediaNYC, and IDOCE

    "},{"location":"I7solrImporter/","title":"Using the Islandora 7 Solr Importer","text":"

    From either the main Content page or the AMI Sets List page, select the 'Start an AMI set' button to begin.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-1-plugin-selection","title":"Step 1: Plugin Selection","text":"

    Select the Islandora 7 Solr Importer from the dropdown menu.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-2-section-1-solr-server-configuration","title":"Step 2, section 1: Solr Server Configuration","text":"

    You will only have the option to select 'Create New ADOs' as the Operation you would like to perform.

    For the Solr Server Configuration section, you will need to provide all of the following information:

    • PID of the Islandora Collection Members you want to fetch (example: islandora:root)
    • Host of your Solr Server (example: repositorydomain.org)
    • Port (example: 8080)
    • Path (example: /)
      • Note: if your Solr can be found at http://myrepo.com:8080/solr, then the path is always a single \"/\" (as in screenshot depiction below)
    • Type of Solr Deployment
      • Either Single Solr Server (most common) or Solr Cloud Ensemble
    • Core (example: islandora)

    You will also need to select the Starting Row you would like to begin fetching results from, and the Number of Rows to fetch.

    The Starting Row is an offset and defaults to 0, which is the most common (and recommended) approach. For the Total Number of Rows to Fetch, setting this to empty or null will automatically (refresh when selecting 'Next' button at bottom of page) prefill with the real Number Rows found by the Solr Query invoked. If you set this number higher than the actual results we will only fetch what can be fetched.

    For larger collections, you may wish to create multiple/split AMI ingest sets by selecting a specified number of rows.

    • As an example, for a collection of 1500 objects that you wanted to split into three AMI ingests of 500 objects, you would specify the Starting Row as 0 for the first set and Number of Rows as 500. For the second set, your Starting Row would be Row 501; for the third set, 1001). In this example, the Number of Rows would always be 500.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-2-section-2-islandora-mappings","title":"Step 2, section 2: Islandora Mappings","text":"

    In this step you will need to make determinations on how you would like to map your Islandora 7 digital objects to your Archipelago repository and whether or not you would like to fetch additional file datastreams, such as those for thumbnail images, transcripts, OCRs/HOCRs, etc.

    • Selecting \"Collapse Multi Children Objects\" will collapse Children Datastreams into a single ADO with many attached files (single row in the generated AMI set .csv file). Book Pages will be fetched but also the Top Level PDF (if one exists in your Islandora instance).

    • In the Required ADO mappings, you will need to specify which Archipelago type you want to map each Islandora Content Model found in your source collection.

      • For example, for info:fedora/islandora:sp_large_image_cmodel you may want to use Photograph.

    • If you had left \"Collapse Multi Children Objects\" unselected, you will also need to specify the Islandora Content Model to ADO types mapping for possible Children.

    • You can also specify an ADO (Object or Collection) to be used as the Parent of Imported Objects. By selecting an existing ADO (Object or Collection) here using the autocomplete/search, the generated AMI set .csv file will contain an 'ismemberof' column containing the UUID of the selected ADO for every row.

    • Under \"Additional Datastreams to Fetch\", you can select any number and/or combination of extra file datastreams to retrieve from your harvest. Please note that the I7 Importer will fetch every possible datastream that is present in your source I7 repository, but the additional file datastreams referenced may not be associated with actual files for every digital object.

    Language from form itself:

    Additional datastreams to fetch. OBJ datastream will always be fetched. Not all datastreams listed here might be present once your data is fetched.

    • Selection of any additonal datastreams will generate a dropdown menu under \"Where extra datastreams should go.\" Here you will decide the organization and location of those datastreams by selecting one of the two options
      • Organize by mime type e.g TRANSCRIPT will go into the \"texts\" column
      • Each in a separate column based on the datastream neame, TRANSCRIPT will go into the \"transcripts\" column

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-3-data-transformation-selections","title":"Step 3: Data Transformation Selections","text":"

    Select the data transformation approach--how your source data will be transformed into ADO (Archipelago Digital Object) Metadata. As noted in the list below, 'Custom (Expert Mode)' is the recommended choice for AMI sets generated using the Islandora 7 Solr Importer plugin.

    • You will have 3 options for your data transformation approach:

      1. Direct
        • Columns from your spreadsheet source will be cast directly to ADO metadata (JSON), without transformation/further processing (only intended for use with simple data strings).
      2. Custom (Expert Mode) Recommended choice for AMI sets generated using the Islandora 7 Solr Importer plugin
        • Provides very granular custom data transformation and mapping options
        • Needs to be used if importing Digital Objects and Digital Object Collections at the same time/from same spreadsheet source (see separate instructions below).
      3. Template
        • Columns from your spreadsheet source will be cast to ADO metadata (JSON) using a Twig template setup for JSON output.

    • You will also need to Select which columns contain filenames, entities or URLS where files can be fetched from. Select what columns correspond to the Digital Object types found in your spreadsheet source. If you fetched additional file datastreams during Step 2, you will see those columns listed here as well (see screenshot below for examples).

    • Lastly, for this step, you will need to select the destination Fields and Bundles for your New ADOs. If your spreadsheet source only contains Digital Objects, select Strawberry (Descriptive Metadata source) for Digital Object

      • If using Sheet 1 of the Demo AMI Ingest set (found above):
        • Select Template and use the AMI Ingest JSON template that corresponds with your metadata elements.

        • Select images, documents, and audios for the file source/fetching.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-4-global-ado-mappings","title":"Step 4: Global ADO Mappings","text":"

    Select your global ADO mappings.

    • Even if empty (no values), select node_uuid and any relationship predicate columns (such as ismemberof).
    • By default, the option to automatically assigns UUIDs is selected. If you have existing UUIds, unselect this option.
    • Select the corresponding Columns for the Required ADO mappings.

    • If using Sheet 1 of the Demo AMI Ingest set (found above):

      • Select both ismemberof and node_uuid for ADO Parent columns
      • Keep 'Automatically assign UUID' checked
      • Do not select any column for 'Sequence'
      • Select the label column for ADO Label

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-5-zip-upload-and-ami-set-naming","title":"Step 5: ZIP upload and AMI Set naming","text":"

    For standard Spreadsheet or Google Sheets AMI ingests, you would use this step to provide an optional ZIP file containing your assets.

    For your Islandora 7 Solr Importer process, the generated AMI set.csv file will contain the necessary URLs to the corresponding Islandora 7 file datastreams for each object as needed. Select next to skip this ZIP upload step and proceed.

    After you provide a title for your AMI set under \"Please Name your AMI set\", select \"Press to Create Set\"

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#step-6-ami-set-confirmation","title":"Step 6: AMI Set Confirmation","text":"

    You will now see a message letting your know your \"New AMI Set was created\". You will be able to review the generated .csv file directly from this page under Source Data File.

    While you may immediately select \"Process\" from this AMI Set Confirmation page to use the Islandora 7 Importer generated .csv file as-is to ingest the ADOs in your AMI set, it is strongly recommended that you review the .csv file first. AMI is configured to trim unecessary (for Archipelago) and de-duplicate redundant Solr source data, but you may wish to pare down the sourced data even further and/or conduct general metadata review and cleanup before migrating your content. You will also likely want to make adjustments to your AMI Ingest JSON Template based on your review, depending on the variation of metadata columns/keys found in your source repostiory.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"I7solrImporter/#next-steps","title":"Next Steps","text":"

    To proceed with Processing your AMI Set, click here to be directed to the main Ingesting Digital Objects via Spreadsheets.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"about/","title":"About this Documentation","text":"

    This documentation was generated with Material for MkDocs. The repo/branch is at https://github.com/esmero/archipelago-documentation/tree/1.3.0, and the site is built using the following Github workflow: https://github.com/esmero/archipelago-documentation/blob/1.3.0/.github/workflows/ci.yml.

    ","tags":["Documentation","Contributing"]},{"location":"about/#contributing","title":"Contributing","text":"
    1. First, please see this guide to set up the repo and branch locally and to create an issue and corresponding pull request.
    2. Install mkdocs-material and mike: pip install mkdocs-material mike.
    3. Make changes to local
    4. Run mike delete --all && mike deploy 1.0.0 default && mike set-default 1.0.0 && mike serve to see and test changes.
    5. Follow the above guide to contribute the changes back.
    ","tags":["Documentation","Contributing"]},{"location":"acknowledgments/","title":"Caring & Coding + Fixing","text":"
    • Diego Pino
    • Giancarlo Birello
    • Allison Sherrick
    "},{"location":"acknowledgments/#acknowledgments","title":"Acknowledgments","text":"

    This software is a Metropolitan New York Library Council Open-Source initiative and part of the Archipelago Commons project.

    "},{"location":"acknowledgments/#license","title":"License","text":"

    GPLv3

    "},{"location":"ami_index/","title":"Archipelago Multi-Importer (AMI)","text":"

    Archipelago Multi-Importer (AMI) is a module for batch/bulk/mass ingests of Archipelago digital objects (ADOs) and collections. AMI also enables you to perform batch administrative actions, such as updating, patching/revising, or deleting digital objects and collections. AMI's Solr Importer plugin can be used to create AMI ingests and migrating content from existing Solr-sourcable digital repositories (such as Islandora 7).

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#ami-overview-and-under-the-hood-explanations","title":"AMI Overview and Under-the-Hood Explanations","text":"

    From the desk of Diego Pino

    AMI provides Tabulated data ingest for ADOs with customizable input plugins. Each Spreadsheet (or Google Spreadsheet) goes through a Configuration Multi-step setup and generates at the end an AMI Set. AMI Sets then can be enqueued or directly ingested, its generated Objects purged and reingested again, its source data (generated and enriched with UUIDS) CSV replaced, improved and uploaded again and ingested.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#learn-more-about-metadata-in-archipelago-and-ami","title":"Learn More about Metadata in Archipelago and AMI","text":"

    Please review the Metadata in Archipelago overview to learn about Archipelago's unique approach to metadata and how this applies in the context of AMI set adminstration.

    Click to read the full AMI 0.4.0 (Archipelago - 1.0.0) Pre-Release Notes.","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#setup-steps","title":"Setup Steps","text":"

    AMI has Ingest, Update and Patch capabilities. AMI has a plugin system to fetch data. The data can come from multiple sources and right now CSV/EXCEL or Google Spreadsheets are the ones enabled. It does parent/children validation, makes sure that parents are ingested first, cleans broken relationships, allows arbitrary multi relations to be generated in a single ROW (ismemberof, partOf, etc) pointing to other rows or existing ADOs (via UUIDs) and can process rows directly as JSON or preprocessed via a Metadata Display entity (twig template) capable of producing JSON output. These templates can be configured by \u201ctype\u201d, Articles v/s 3DModel can have different ones. Even which columns contain Files can be configured at that level.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#ami-set-entity","title":"AMI Set Entity","text":"

    Ami Sets are special custom entities that hold an Ingest Strategy generated via the previous Setup steps (as JSON with all it's settings), a CSV with data imported from the original source (with UUIDs prepopulated if they were not provided by the user). These AMI sets are simpler and faster than \u201cbatch sets\u201d because they do not have a single entry per Object to be ingested. All data lives in a CSV. This means the CSV of an AMI set can be corrected and reuploaded. Users can then Process a Set either putting the to be ingested ADOs in the queue and let Hydroponics Service do the rest or directly via Batch on the UI. ADOs generated by a set can also be purged from there. These sets can also be created manually if needed of any of the chosen settings modified anytime. Which AMI set generated the Ingest is also tracked in a newly created ADO\u2019s JSON and any other extra data (or fixed data e.g common Rights statements, or LoD) can be provided by a Twig Template. Ingest is amazingly fast. We monitored Ingest with Remote URL(islandora Datastreams) files of 15Mbytes average at a speed of 2 seconds per Object (including all post processing) continuously for a set of 100+.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#search-and-replace","title":"Search and Replace","text":"

    This module also provides a simple search/replace text VBO action (handles JSON as text) and a full blown JSONPATCH VBO action to batch modify ADOs. The last one is extremely powerful permitting multiple operations at the same time with tests. E.g replace a certain value, add another value, remove another value only if a certain test (e.g \u201ctype\u201d:\u201dArticle\u201d and \u201cdate_of_digital\u201d: \u201c2020-09-09\u201d) matches. If any tests fail the whole operation will be canceled for that ADO. An incomplete \u201cWebform\u201d VBO action is present but not fully functional yet. This one allows you to choose a Webform, a certain element inside that Webform and then find and replace using the same Interface you would see while editing/adding a new ADO via the web form workflow.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#getting-started-with-ami","title":"Getting started with AMI","text":"

    You can access AMI through the AMI Sets tab on the main Content page found at /admin/content or directly at /amiset/list.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#google-sheets-api-configuration","title":"Google Sheets API Configuration","text":"

    If you plan on using the Google Sheets Importer option, you will need to Configure the Google Sheets API.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#example-spreadsheetcsv","title":"Example Spreadsheet/CSV","text":"

    Please refer to or use a fresh/new copy of the Demo Archipelago Digital Objects (ADOs) spreadsheet to import a small set of Digital Objects, using the same assets part of the One-Step Demo content ingest guide.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_index/#example-json-template","title":"Example JSON template","text":"

    This JSON template can be used during the Data Transformation (step 3) of your AMI Import. This particular template corresponds with the metadata elements found in the Default Descriptive Metadata and Default Digital Object Collection webforms shipped with Archipelago 1.0.0.

    Click to view the example 1.0.0 AMI JSON template

    To use this template, copy and paste the JSON below directly into a new Metadata Display, found here for a local http://localhost:8001/metadatadisplay/list or http://yoursite.org/metadatadisplay/list. Select JSON as the 'Primary mime type this Twig Template entity will generate as output' for this new Metadata Display.

      {\n      \"type\": {{ data.type|json_encode|raw }},\n      \"label\": {{ data.label|json_encode|raw }},\n      \"issue_number\": {{ data.issue_number|json_encode|raw }},\n      \"interviewee\": {{ data.interviewee|json_encode|raw }},\n      \"interviewer\": {{ data.interviewer|json_encode|raw }},\n      \"duration\": {{ data.duration|json_encode|raw }},\n      \"website_url\": {{ data.website_url|json_encode|raw }},\n      \"description\": {{ data.description|json_encode|raw }},\n      \"date_created\": {{ data.date_created|json_encode|raw }},\n      \"date_created_edtf\": {{ data.date_created_edtf|json_encode|raw }},\n      \"date_created_free\": {{ data.date_created_free|json_encode|raw }},\n      \"creator\": {{ data.creator|json_encode|raw }},\n      \"creator_lod\": {{ data.creator_lod|json_encode|raw }},\n      \"publisher\": {{ data.publisher|json_encode|raw }},\n      \"language\": {{ data.language|json_encode|raw }},\n      \"ismemberof\": [],\n      \"ispartof\": [],\n      \"sequence_id\": {{ data.sequence_id|json_encode|raw }},  \n      \"owner\": {{ data.owner|json_encode|raw }},\n      \"local_identifier\": {{ data.local_identifier|json_encode|raw }},\n      \"related_item_host_title_info_title\": {{ data.related_item_host_title_info_title|json_encode|raw }},\n      \"related_item_host_display_label\": {{ data.related_item_host_display_label|json_encode|raw }},\n      \"related_item_host_type_of_resource\": {{ data.related_item_host_type_of_resource|json_encode|raw }},\n      \"related_item_host_local_identifier\": {{ data.related_item_host_local_identifier|json_encode|raw }},\n      \"related_item_note\": {{ data.related_item_note|json_encode|raw }},\n      \"related_item_host_location_url\": {{ data.related_item_host_location_url|json_encode|raw }},\n      \"note\": {{ data.note|json_encode|raw }},\n      \"physical_description_note_condition\": {{ data.physical_description_note_condition|json_encode|raw }},\n      \"note_publishinginfo\": {{ data.note_publishinginfo|json_encode|raw }},\n      \"physical_location\": {{ data.physical_location|json_encode|raw }},\n      \"physical_description_extent\": {{ data.physical_description_extent|json_encode|raw }},\n      \"date_published\": {{ data.date_published|json_encode|raw }},\n      \"date_embargo_lift\": {{ data.date_embargo_lift|json_encode|raw }},\n      \"rights_statements\": {{ data.rights_statements|json_encode|raw }},\n      \"rights\": {{ data.rights|json_encode|raw }},\n      \"subject_loc\": {{ data.subject_loc|json_encode|raw }},\n      \"subject_lcnaf_personal_names\": {{ data.subject_lcnaf_personal_names|json_encode|raw }},\n      \"subject_lcnaf_corporate_names\": {{ data.subject_lcnaf_corporate_names|json_encode|raw }},\n      \"subject_lcnaf_geographic_names\": {{ data.subject_lcnaf_geographic_names|json_encode|raw }},\n      \"subject_lcgft_terms\": {{ data.subject_lcgft_terms|json_encode|raw }},\n      \"subject_wikidata\": {{ data.subject_wikidata|json_encode|raw }},\n      \"edm_agent\": {{ data.edm_agent|json_encode|raw }},\n      \"term_aat_getty\": {{ data.term_aat_getty|json_encode|raw }},\n      \"viaf\": {{ data.viaf|json_encode|raw }},\n      \"pubmed_mesh\": {{ data.pubmed_mesh|json_encode|raw }},\n      \"europeana_concepts\": {{ data.europeana_concepts|json_encode|raw }},\n      \"europeana_agents\": {{ data.europeana_agents|json_encode|raw }},\n          \"europeana_places\": {{ data.europeana_places|json_encode|raw }},\n      \"geographic_location\": {{ data.geographic_location|json_encode|raw }},\n      \"subjects_local_personal_names\": {{ data.subjects_local_personal_names|json_encode|raw }},\n      \"subjects_local\": {{ data.subjects_locals|json_encode|raw }},\n      \"audios\": [],\n      \"images\": [],\n      \"models\": [],\n      \"videos\": [],\n      \"documents\": [],\n      \"as:generator\": {\n          \"type\": \"Create\",\n          \"actor\": {\n              \"url\": {{ setURL|json_encode|raw }},\n              \"name\": \"ami\",\n              \"type\": \"Service\"\n          },\n          \"endTime\": \"{{\"now\"|date(\"c\")}}\",\n          \"summary\": \"Generator\",\n          \"@context\": \"https:\\/\\/www.w3.org\\/ns\\/activitystreams\"\n      },\n      \"upload_associated_warcs\": []\n  }\n

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/","title":"Using AMI's Linked Data Reconciliation","text":"

    Archipelago Multi Importer (AMI)'s Linked Data Reconciliation tool can be used to enrich your metadata with Linked Data (LoD). Using this tool, you can map values from your topical/subject metadata elements to your preferred LoD vocabulary source. These mappings can then be transformed via a corresponding Metadata Display (Twig) template to process the values into JSON-formatted metadata for your specified AMI set.

    The aim of this tool is to automize as much of the reconciliation process as feasible within Archipelago. Please be aware that data reconciliation will still be in part a manual and potentially time intensive process.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#important-note-preliminary-pre-requisite-ami-set-configuration","title":"Important Note: Preliminary / Pre-requisite AMI Set Configuration","text":"

    In order to Reconciliate an AMI Set, you will need to have selected the 'Template' or 'Custom' data transformation approach (then also, via 'Template' for your Digital Object or Collection types) during Step 3 : Data Transformation of your AMI Set configuration.

    Your source spreadsheet will also need to contain at least one column containing terms/names (values) you want to reconcile against an LoD Authority Source. Multiple values should be separated by '|@|'.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#step-1-select-the-ami-set-you-will-be-working-with","title":"Step 1: Select the AMI Set you will be working with.","text":"

    From the main AMI Sets List page, click on your AMI Set's Name, or select the 'Edit' option from the Operations menu on the right-hand side of the Sets list.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#step-2-reconcile-lod-tab","title":"Step 2: Reconcile LoD Tab","text":"

    Navigate to the Reconcile LoD tab.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#step-3-lod-reconciling-selections","title":"Step 3: LoD Reconciling Selections","text":"

    From the list of columns from your spreadsheet source, select which columns you want to reconcile against LoD providers.

    Under the LoD Sources section, select how your chosen Columns will be LoD reconciled. - LoD reconcile options will be on the left, LoD Authority Sources will be on the right. - Example: 'local_subjects' will be mapped to 'LoC subjects (LCSH)'

    Full list of potential LoD Authority Sources
    • LoC subjects(LCSH)
    • LoC Name Authority File (LCNAF)
    • LoC Genre/Form Terms (LCGFT)
    • LoC Thesaurus of Graphic Materials (TGN)
    • LoC MARC List for Geographic Areas
    • LoC Relators Vocabulary (Roles)
    • LoC MADS RDF by type:
    • Corporate Name
    • Personal Name
    • Family Name
    • Topic
    • Genre Form
    • Geographic
    • Temporal
    • Extraterrestrial Area
    • VIAF
    • Getty aat Fuzzy / Terms / Exact Label Match
    • Wikidata Q Items

    To preview the values contained in the column(s) you selected, click the 'Inspect cleaned/split up column values' button.

    Tip: This preview step provides you with the opportunity to return to your AMI Set source CSV and make any necessary label/term corrections such as outliers and formatting errors before processing. This can be done multiple times until your source set is fully prepared. If using this workflow, you will tick the 'Re-process only adding new terms/LoD Authority Sources' processing option after replacing your updated source CSV (see screenshot below)

    When ready, there are multiple processing options to select from depending on your current need/workflow. - To process immediately, select 'Process LoD from Source' - To enqueue the batch process, select 'Enqueue but do not process Batch in real time. - To add new data (i.e. terms, LoD Authority Sources) to existing reconciliation (e.g after replacing source CSV data), select 'Re-process only adding new terms/LoD Authority Sources

    Important note: if you have previously run LoD Reconciliation for your AMI set, this action will overwrite any manually corrected LoD on your Processed CSV. Please make sure you have a backup if unsure.

    Depending on the size of your AMI Set, the Reconciliation processing may take a few minutes.

    When the process is finished, you will see a brief confirmation message.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#step-4-edit-reconciled-lod","title":"Step 4: Edit Reconciled LoD","text":"

    Open the 'Edit Reconciled LoD' tab.

    You will see a table (form) containing: - Your Original term values (labels) - The CSV Column Header/Key from the source spreadsheet where the value is found - A Checked option you can use to denote that an LoD mapping has been reviewed/revisioned - The Linked Data Label and URL pairing selected during the LoD reconciliation process

    The results table will show 10 original terms and mappings per page. You can advance through the pages using the page numbers and navigational arrows above and below the table.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#step-5-review-and-edit-your-reconciled-lod-mappings","title":"Step 5: Review and Edit your Reconciled LoD Mappings","text":"

    Review the LoD reconciliation mappings, to make sure the best terms were selected for your metadata.

    • To revise and select a different term mapping, begin by typing in the 'Label' box in the corresponding LoD lookup element. (You can type directly over an incorrect term or within an empty cell if no value was mapped/identified.)
    • Select your preferred term and URL pairing from the list.
    • You can also add or remove multiple mappings using the +/- buttons beside the LoD lookup element.
    • If desired, click the Checked option to mark that the term was reviewed/revisioned.

    As you advance through your review process, it is recommended that you use the 'Save Current LoD Page' at the bottom of each results page as you work. This will preserve the corrections you may have made and update the LoD Reconciled data for your AMI Set within the editing form.

    When you have finished editing/reviewing your data, you must select 'Save all LoD back to CSV File' or else your LoD selections will not be preserved.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#step-6-ami-set-review-and-twig-metadata-display-preparation","title":"Step 6: AMI Set Review and Twig (Metadata Display) Preparation","text":"

    You will now need to make sure that the Metadata Display (Twig) Template you selected to use during your initial AMI Set configuration is setup to Process your LoD mapped Label and URL selections into your Digital Objects and Collections JSON metadata.

    For every JSON key/element in your metadata that you need to process the LoD Reconciled data into, you need to specify in your Template that data for this element will be read from the 'Processed Data' LoD information.

    In the following example Twig snippet, the \"subject_loc\" JSON key will map corresponding values from the 'Processed Data' (data.lod) LoD information into a newly created Digital Object/Collection during the AMI Set Processing.

    \"subject_loc\": {{ data_lod.mods_subject_topic.loc_subjects_thing|json_encode|raw }},\n
    • \"subject_loc\" = destination JSON Key or Property for your LoD values
    • data.lod = directs the Twig template to source from the Processed Data LoD information (instead of the original AMI Source CSV accessed via 'data.xx_property_name')
    • mods.subject.topic = the Column header in the original AMI Source CSV
    • loc_subjects_thing = the Column containing the Label and URI/L pairs in the Processed Data LoD editable Table/Form (and reference CSV)

    The same general pattern can be adapted to apply to different mapping scenarios (original CSV source columns to Reconciled LoD Sources) as needed.

    Full list of Column Options => Corresponding LoD Sources
    • 'loc_subjects_thing' => LoC subjects(LCSH)
    • 'loc_names_thing' => LoC Name Authority File (LCNAF)
    • 'loc_genreForms_thing' => LoC Genre/Form Terms (LCGFT)
    • 'loc_graphicMaterials_thing' => LoC Thesaurus of Graphic Materials (TGN)
    • 'loc_geographicAreas_thing' => LoC MARC List for Geographic Areas
    • 'loc_relators_thing' => LoC Relators Vocabulary (Roles)
    • 'loc_rdftype_CorporateName' => LoC MADS RDF by type: Corporate Name
    • 'loc_rdftype_PersonalName' => LoC MADS RDF by type: Personal Name
    • 'loc_rdftype_FamilyName' => LoC MADS RDF by type: Family Name
    • 'loc_rdftype_Topic' => LoC MADS RDF by type: Topic
    • 'loc_rdftype_GenreForm' => LoC MADS RDF by type: Genre Form
    • 'loc_rdftype_Geographic' => LoC MADS RDF by type: Geographic
    • 'loc_rdftype_Temporal' => LoC MADS RDF by type: Temporal
    • 'loc_rdftype_ExtraterrestrialArea' => LoC MADS RDF by type: Extraterrestrial Area
    • 'viaf_subjects_thing' => VIAF
    • 'getty_aat_fuzzy' => Getty aat Fuzzy
    • 'getty_aat_terms' => Getty aat Terms
    • 'getty_aat_exact' => Getty aat Exact Label Match
    • 'wikidata_subjects_thing' => Wikidata Q Items
    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_lod_rec/#next-steps","title":"Next Steps","text":"

    To proceed with Processing your AMI Set, click here to be directed to the main Ingesting Digital Objects via Spreadsheets.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_spreadsheet_overview/","title":"Spreadsheet Formatting Overview","text":"","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_spreadsheet_overview/#spreadsheet-formatting-overview","title":"Spreadsheet Formatting Overview","text":"

    There are multiple ways a spreadsheet/CSV file can be structured to work with AMI, depending on the data transformation and mapping you will be using.

    • For most standard AMI ingests, each Row of your spreadsheet/CSV will correspond to a single Digital Object, Creative Work Series (Compound Object Parent) or Collection.

    • Columns in your spreadsheet/CSV can be mapped to different data (files) and metadata elements (label, description, subjects, etc.).

    • It is recommended that different types of files are placed into separate columns--\"images\", \"documents\", \"models\", \"videos\", \"audios\", \"texts\".

      • Filepaths can point to remote files, to existing files within your docker container, s3 (or other storage type/location that is accessible to Archipelago), and to paths within zip files.
        • Example path for existing file within docker container: /var/www/html/d8content/myAMIimage.jpg
        • Example s3 path: s3://myAMIuploads/myAMIdocument.pdf
        • Example remote filepath: https://dogsaregreat.edu/dogs.tiff
      • Multiple files (of the same type) can be placed in a single cell, separated by a semicolon ( ; ).
      • For Digital Objects comprised of multiple types of files, such as an Oral History Interview with an audio file and a PDF transcript file, you can place different file types within different corresponding columns for the same Row.
      • It is recommended that filepaths are copied/stored as plain (non-hyperlinked) formatted text.

    • Every spreadsheet/CSV file should contain the following Columns:

      • type
        • the Digital Object or Digital Object Collection Type, such as 'Photograph' or 'Collection'
      • label
        • the title of the Digital Object or Collection
      • Soft-requirement node_uuid
        • this can be empty
        • if empty, Archipelago will automatically generate UUIDs
        • can be used with existing UUIDs during migrations
      • Soft-requirement sequence_id for Creative Work Series (compound) children objects
        • this is used to determine the sequence order for children objects within a Creative Work Series (compound) object
        • should be an integer only (ie, '1' and not 'Page 1')
        • if not present, the objects will present in the original ingest order
        • we strongly recommend mapping the correct sequence using 'sequence_id'

    • Recommended Columns:

      • Files as defined above
        • \"images\", \"documents\", \"models\", \"videos\", \"audios\", \"text\"
        • .warc/.wacz files should be placed in a column \"upload_associated_warcs\"
      • ismemberof and/or ispartof (and/or whatever predicate corresponds with the relationship you are mapping)
        • these columns can be used to connect related objects using the object-to-object relationship that matches your needs
        • in default Archipelago configurations, ismemberof is used for Collection Membership and ispartof is used for Parent-Child Object Relationships (so a Child ADO would reference the Parent ADO in ispartof)
        • these columns can hold 3 types of values
          • empty (no value)
          • an integer to connect an object to another object's corresponding row in the same spreadsheet/CSV
          • Ex: Row 2 corresponds to a Digital Object Collection; for a Digital Object corresponding to Row 3, the 'ismemberof' column contains a value of '2'. The Digital Object in Row 3 would be ingested as a member of the Digital Object Collection in Row 2.
          • a UUID to connect with an already ingested object
      • Metadata - for all the rich, detailed information associated with your Digital Objects and Collections
        • Every Column header will become a JSON Key and each cell a JSON value for that Key

        • You can use direct JSON snippets such as:

          [{\"uri\": \"http://id.loc.gov/authorities/subjects/sh95008857\",\"label\": \"Digital libraries\"}]\n
          - If you have an advanced twig template with the necessary logic, you can place data in cells that can be parsed and structured in various ways (such as multiple values separated by semicolons split accordingly, capitalization of values based on defined patterns, etc.)

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["AMI","Archipelago Multi Importer"]},{"location":"ami_update/","title":"Using AMI's Update Operations","text":"

    Archipelago Multi Importer (AMI)'s Update Operations can be used to Update, Replace, or Append metadata values or files for existing Digital Objects and Collections found in your Archipelago. You can prepare and use AMI Update Sets in different ways using one of three functional operations, depending on your update needs. This guide will provide a general overview of the three main functions and how each operation may be useful.

    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#important-notes-preliminary-pre-requisites","title":"Important Notes: Preliminary / Pre-requisites","text":"

    You need to have existing Digital Objects or Collections (ADOs) in your Archipelago to work with. You should have a prepared AMI Update Set CSV that contains at least the following columns/headers:

    • node_uuid
      • required
      • should contain the values for any existing ADOs you wish to update
      • needs to be a 1:1 match; AMI Update functionality cannot be used to update/change node_uuid values
    • label
      • required
      • contains the corresponding label (title) for your existing ADOs
      • can contain modifications for the label (title) values
    • type
      • optional, only required if using the Custom (Expert Mode) approach for your AMI set configuration or targeting changes for 'type' mappings for your ADOs
      • contains the corresponding type values for your existing ADOs
      • can contain modifications for the type values
      • related to this, AMI Update functionality cannot be used to update/change the underlying Drupal bundle mappings for already-ingested objects. In other words, you cannot use an AMI Update Set to change a Child Object with a 'Page' type originally ingested as a Digital Object -> to a Parent Object with a 'Book' type mapped to the Digital Object Collection/Compound bundle. For these changes, you will need to delete and re-ingest your ADOs, or use an external (not provided in default Archipelagos) Drupal module for bundle/Drupal Content Type changes.
    • additional metadata elements you wish to Update, Replace, or Append values for, such as \"subjects\"
      • optional (but likely pertains to the reason you are Updating your ADOs)
      • follow recommendations and practices described in more below detail
    • files
      • optional
      • on the final 'Process' tab of your AMI Update Set Configuration, if the \"Do not touch existing files\" option is checked, then existing files will be left untouched. It is recommended to always keep this option checked if you are targeting only Metadata updates.

    You should be familiar with the basic mechanics of AMI Set Configuration noted in Steps 1-6.

    Best Practices

    For all AMI Update operations, it is strongly recommended to both:

    1. Before Updating, use the 'Export Archipelago Digital Objects to CSV content item' Action available on the main Content page and the Find and Replace page menus to generate a CSV of your non-modified objects. If something unintended occurs with your Update execution, you could use this CSV of your non-modified objects to restore your objects (or just a field or two) as needed.

    2. Create a small test batch CSV referencing one to two/three ADOs to test the execution of your desired Update actions on before running your larger Update Sets. There is no 'Undo' or 'Revert Changes' button that can be used for an AMI Update Set. You do have the option to 'Revert Revisions' on an object-by-object basis, but that is not ideal for reverting changes that were executing across large batches of ADOs. See the 'Checking Your Changes' documentation section for more information about reviewing and potentially reverting Revisions.

    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#data-transformation-options-for-ami-update-sets","title":"Data Transformation Options for AMI Update Sets","text":"

    As with regular/Create New AMI Sets, you will have to select your preferred Data Tranformation configuration during Step 3 : of your AMI Update Set Configuration.

    • Direct
      • Columns from your spreadsheet source will be cast directly to ADO metadata (JSON), without transformation/further processing (only intended for use with simple data strings or already JSON-encoded snippets/values).
      • This is likely the most common Data Transformation configuration you will use for simple AMI Update Replace and Append Sets.
    • Custom (Expert Mode)
      • Provides very granular custom data transformation and mapping options
      • You will likely only use this Data Transformation configuration for more complex AMI Update Sets when you want to differentiate between Data Transformation setups for Digital Objects and Digital Object Collections/Compound Objects/Creative Work Series (such as passing Digital Objects through 'Template' tranformation, and Collections/Compounds through 'Direct' transformation).
    • Template
      • Columns from your spreadsheet source will be cast to ADO metadata (JSON) using a Twig template setup for JSON output.
      • This is likely the most common Data Transformation configuration you will use for more complex AMI Update Sets. This is the setup you would need to use if you want to use an AMI Update Set with AMI's LoD Reconciliation to update existing ADOs subject metadata with enriched LoD.

    Caution with using Templates for Data Transformation

    If you are planning to use the 'Template' or 'Custom (Export Mode)' data transformation approach for your AMI Update Set configuration, you will need to have prepared your corresponding AMI Ingest Template to account for the specific Update actions you have planned.

    It is important to keep in mind that all of the metadata elements for your existing ADOs metadata may not necessarily be present in your AMI Update Set Source CSV. For example, you may have only prepared your AMI Update Set Source CSV to contain a limited number of headers/columns, such as only those required (node_uuid, label) and one or two metadata elements you wish to update (such as \"subjects\"). If you choose to pass your AMI Update Set through a Twig template, the output after Processing your AMI Update Set may overwrite your existing data if you do not have all of the necessary logic/checks in place to preserve the existing metadata if desired.

    In other words, imagine your twig template contains this statement: 

      \"subjects\": {{ data.subjects|json_encode|raw }}, \n

    Independently of IF your CSV contains \"subjects\" as a header/column, the Twig template will still output an empty \"subjects\", which, when using the \"Replace\" mode will wipe out any existing \"subjects\" in your ADO.

    During any update operation (independently of the functional operation chosen) and IF you are using/passing your CSV through a template, AMI will provide an extra Context key for you to reference in your Twig Template. You can always reference 'dataOriginal.subjects' for example -- all dataOriginal.xx keys will contain the values of the existing metadata for your ADOs. This allows you to make \"smart\" templates that check IF a certain key/values exists, compare the unmodified (and to be modified) ADO(s) with the new data passed, then generate the desired output.

    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#update-set-processing-options","title":"Update Set Processing Options","text":"

    Beginning from Step 7, Processing of your AMI Set Configuration, select the Update operation that best corresponds to your targeted Update scenario.

    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#1-normal-update-operation","title":"1. Normal Update Operation","text":"

    The Normal Update Operation 'will update a complete existing ADO's configured target field with new JSON Content.' This will replace everything in an ADO with new processed data.

    • The Normal update operation is powerful and can overwrite your whole JSON object record if not paired with a template that has all the extra checks/logic needed to preserve existing data if desired (see note of 'Caution with Templates for Data Transformation' above).
    • It is also recommended to only use the Normal Update approach if you need to re-process most of the metadata fields for ADOs.
    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#2-replace-update-operation","title":"2. Replace Update Operation","text":"

    The Replace Update Operation Replace 'will replace JSON keys found in an ADO's configured target field with new JSON content. Not provided ones (fields/JSON keys) will be kept.'

    • If the processed data contains a JSON key that is already in the ADO's metadata to be updated, the values in the AMI Update Set CSV will be used, replacing completely the values found in that key in the existing ADO.
    • The Replace update operation paired with the 'Direct' data transformation is likely the update operation you will use.
    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#common-use-case-scenario-for-replace-updates","title":"Common use case scenario for Replace updates:","text":"
    • You notice a missing or incorrectly processed field in your original AMI Set/ADOs.
    • You create an AMI set that contains only the 'node_uuid', 'label', and one column for the missing field and values.
      • If the values are singular, you do not need to JSON-encode the values in the CSV
      • If the values are multiple, you need to JSON-encode them, formatted as: [\"value1\",\"value2\"]
    • You select the Direct data transformation approach on the AMI configuration.
    • You select the Replace update operation and keep 'Do not touch existing files' checked.
    • With this setup, the new field and values are added to the existing JSON for the impacted ADOs.
    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#3-append-update-operation","title":"3. Append Update Operation","text":"

    The Append update operation 'will append values to existing JSON keys in an ADO's configured target field. New ones (fields/JSON keys) will be added too.'

    • If the processed data contains a key that is already in the ADO\u2019s metadata to be updated, attempts will be made to match the \"source\" type (array, complex object) to add to it. If you have 2 values in a key, and your original/existing data contains a single value, the result will have 3 values (and then it will try to deduplicate too). If the Source data did not contain a key present in the processed data, then it will be added.
    • The Append operation can be very useful, but it should be used with caution if targeting single values versus arrays. AMI will not permit malformed JSON data to be generated. But you need to consider if your Append update tranforms a previously single-value key into a multiple-value array, how this change may impact any references made in you display or other templates, Views throughout your Archipelago.
      • For example, if your Object Description Display template is not setup to check for iterable (multiple value/array) values for a given element, then the multiple values for an updated ADO may not output as expected.
    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"ami_update/#other-process-setup-options","title":"Other Process Setup Options","text":"

    For the other AMI Set Process options and steps, please refer to the information found from Steps 7-10 in this complementary documentation for Create New ADOs AMI Sets. See the 'Checking Your Changes' documentation section for more information about reviewing and potentially reverting Revisions.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["AMI","Archipelago Multi Importer","AMI Update Sets","Update","Replace","Append"]},{"location":"annotations/","title":"Annotations in Archipelago","text":"

    Archipelago extends Annotorius to provide W3C-compliant Web Annotations for Digital Objects. These annotations can be added per image (when multiple), edited for text and shape adjustments, and saved/discarded using the regular Edit mode (bonus track 1: temp storage that persists when you log out and come back in to your session). Archipelago also exposes a full API for WebAnnotations, that keeps track of which Images (referenced in the Strawberryfield @ as:image) were annotated and creates the W3C valid entries inside your Digital Object's JSON @ ap:annotationCollection (bonus track 2: multiple users can annotate the same resource, enabling digital scholarship collaboration opportunities).

    Important Note: For any image-based Digital Objects you would like to apply annotations to, the Digital Object type must be setup to display the image file(s) using the Open SeaDragon viewer. More information about about Managing Display Modes in Archipelago can be found here. Please stay tuned for updates announcing web annotation integration for Mirador 3.

    "},{"location":"annotations/#enabling-annotations","title":"Enabling Annotations","text":"
    1. Navigate to Admin --> Structure --> Content types --> Digital Object --> Manage Display and select the \"Digital Object Full view\" mode. https://yoursite.org/admin/structure/types/manage/digital_object/display/digital_object_viewmode_fullitem
    2. On the \u201cFragola\u201d row, click on the small gear icon on the far right, which will be open the configurations for this display type.
    3. Select the \u201cEnable loading/editing of W3C webAnnotations\u201d option.
      • Learn more about the JSON format of WebAnnotations here: https://www.w3.org/TR/annotation-model/#index-of-json-keys.
    4. Under \"What tool to enable\", select either the Rectangular or Polygon (freehand drawing) tool for your annotation style.
    5. Select the 'Update' button.
    6. Also Save your settings using the button at the bottom of the page.

    You are now ready to get started adding annotations!

    "},{"location":"annotations/#adding-and-saving-annotations","title":"Adding and Saving Annotations","text":"
    1. Navigate to the image-based Digital Object you would like to apply annotations to.
    2. To add a new annotation, select and hold the Shift key. Click and then drag to apply either a Rectangular box or multi-point Polygon shape.
    3. Double click to exit the annotation drawing mode.
    4. Enter the text for your annotation in the pop-up window.
    5. Click the \"Ok\" button when you are ready.
    6. To save your annotation (or annotations if you created multiple), navigate to the main Digital Object \"Edit\" tab, where you will see a message about Unsaved Web Annotation Changes.
    7. Select \"Save\" to preserve your Annotation(s). They will now become part of your Digital Object's JSON, found under the ap:annotationCollection key.
      • Pressing the \"Discard\" button will discard only the unsaved Annotations, and will reload the page.
    "},{"location":"annotations/#editing-and-deleting-annotations","title":"Editing and Deleting Annotations","text":"
    1. Navigate to the image-based Digital Object you would whose annotation(s) you want to edit or delete.
    2. Click within the Annotation and select the downwards arrow in the upper right-hand corner of the pop-up window.
    3. Select either the \"Edit\" option and Edit the Annotation as desired; Or select the \"Delete\" option.
    4. To preserve your editing or deleting actions, navigate to the main Digital Object \"Edit\" tab, where you will see a message about Unsaved Web Annotation Changes. (See screenshot in Step 6 of Adding and saving Annotations above.)
    5. Select \"Save\" to preserve your Annotation(s) edits or deletions. Pressing the \"Discard\" button will discard only the unsaved Annotations changes, and will reload the page.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"archifilepersistencestrategy/","title":"Archipelago's File Persistence Strategy","text":""},{"location":"archifilepersistencestrategy/#how-are-files-for-archipelago-digital-objects-ados-persisted-what-happens-with-those-fishtanks","title":"How are files for Archipelago Digital Objects (ADOs) persisted? (What happens with those fishtanks?)","text":"

    A few Event Subscribers/Data describing logics happen in a certain order:

    1. User Uploads via a webform Element a new File or via Drush/Batch ingest that attaches (via JSONAPI) a file.

    2. If the webform is involved, Archipelago acts quickly and calls directly (before the Node even exists) the file classifier, that will:

      1. Add/complement a as:somefiletype JSON structure into the main ADO SBF JSON, with info about the file, checksums, size, Drupal fids, uuid, etc. This is a heavy function part of the StrawberryfieldFilePersisterService. It does a lot, making use of optimized logic, but may do more in the future to handle too-many/too-big files needs (FYI: solution will be simple, add to a queue and process later).
      2. The most (yes) important info added here is the desired future storage location of the file.

    3. The user finishes the form, saves and and confirms the ADO creation, and finally all the Node events fire.

    4. On presave StrawberryfieldEventPresaveSubscriberAsFileStructureGenerator runs and checks if 2.1 already was processed. This is needed since the user could have triggered an ingest via drush/JSONAPI/Webhooks etc. If all is well (this is a less expensive check) Archipelago continues.

    5. On presave (next) StrawberryfieldEventPresaveSubscriberFilePersister runs, checking all TEMPORARY files described in as:somefiletype and actually copying them to the right \"desired\" location.

    6. And on Save StrawberryfieldEventInsertFileUsageUpdater also marking the file as \"being\" used by a Strawberry driven Node (different Event).

    Note: Anytime we remove directly from the raw JSON a full as:somefiletype structure of a sub-element from an as:structure we force Archipelago to do all the above again, and Archipelago can regenerate technical metadata. This has been used when updating EXIF binaries or even when something went wrong (while testing, but this stuff is safe no worries). Eventually, there will be a BIG red button that does that if you do not like JSON editing.

    Discussions related to Archipelago's file persistence strategy and planned potential strategies can be be found here: Strawberryfield Issues: 107, and here: Strawberryfield Issues: 76. This page will be updated with additional information following future developments.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/","title":"Archipelago-deployment: upgrading Drupal 9 to Drupal 10 (1.1.0 to 1.3.0)","text":"","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#what-is-this-documentation-for","title":"What is this documentation for?","text":"

    If you already have a well-set-up and well-loved Archipelago (1.1.0) running Drupal 9 (D9), this documentation will allow you to update to 1.3.0 on Drupal 10 (D10) without any major issues.

    D9 is no longer supported as of the end of November 2023. D10 has been around for a little while, and even if every module is not supported yet, what you need and want for Archipelago has long been ready for D10. However, Archipelago is still D9 compatible if it's necessary for you to stay back a little longer.

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#requirements","title":"Requirements","text":"
    • An archipelago-deployment local instance 1.1.0 (working, tested) deployed using provided instructions via Docker and running Drupal 9.
    • Basic knowledge and instincts (+ courage) on how to run Terminal Commands, composer and drush.
    • Patience. You can't skip steps here.
    • For shell Commands documented here please copy line by line--not the whole block.
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#backing-up-and-preparing-for-the-upgrade","title":"Backing up and preparing for the upgrade","text":"

    Backups are always going to be your best friends. Archipelago's code, database, and settings are mostly self-contained in your current archipelago-deployment repo folder, and backing up is simple because of that.

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-1","title":"Step 1:","text":"

    On a terminal, cd into your running archipelago-deployment folder and shut down your docker-compose ensemble by running the following:

    docker-compose down\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-2","title":"Step 2:","text":"

    Verify that all containers are actually down. The following command should return an empty listing:

    docker ps\n

    If anything is still running, wait a little longer and run the command again.

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-3","title":"Step 3:","text":"

    Now let's tar.gz the whole ensemble with data and configs. As an example we will save this into your $HOME folder. As a good practice we append the current date (YEAR-MONTH-DAY) to the filename. Here we assume today is October 31st of 2023.

    cd ..\nsudo tar -czvpf $HOME/archipelago-deployment-D9-20231031.tar.gz archipelago-deployment\ncd archipelago-deployment\n

    The process may take a few minutes. Now let's verify that all is there and that the tar.gz is not corrupt.

    tar -tvvf $HOME/archipelago-deployment-D9-20231031.tar.gz\n

    You will see a listing of files, and at the end you will see something like this: Archive Format: POSIX pax interchange format, Compression: gzip. If corrupt (Do you have enough space? Did your ssh connection drop?) you will see the following:

    tar: Unrecognized archive format\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-4","title":"Step 4:","text":"

    Restart your docker-compose ensemble, and wait a little while for all to start.

    docker-compose up -d\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-5","title":"Step 5:","text":"

    Export/backup all of your live Archipelago configurations (this allows you to compare/come back in case you lose something custom during the upgrade).

    docker exec esmero-php mkdir config/backup\ndocker exec esmero-php drush cex --destination=/var/www/html/config/backup\n

    Good. Now it's safe to begin the upgrade process.

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#upgrading-to-130","title":"Upgrading to 1.3.0","text":"","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-1-edit-docker-composeryml","title":"Step 1: Edit docker-composer.yml","text":"

    First we are going to edit your docker-compose.yml file to reference the latest PHP container as needed. Starting in your Archipelago deployment directory location, run the following commands:

    If you have not already, run:

    docker-compose down\n

    Then open your docker-compose.yml file:

    nano docker-compose.yml\n

    Inside your docker-compose.yml file, page down to the php section and change the image section to match exactly as follows:

    image: \"esmero/php-8.1-fpm:1.2.0-multiarch\"\n

    Next page down to the iiif section and change the image section to match exactly as follows:

    image: \"esmero/cantaloupe-s3:6.0.1-multiarch\"\n

    Save your changes.

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-2-docker-pull-and-check","title":"Step 2: docker pull and check","text":"

    Time to fetch the latest branch and update our docker compose and composer dependencies. To pull the images and bring up the ensemble, run:

    docker compose pull\ndocker compose up -d\n

    Give all a little time to start. Please be patient. To ensure all is well, run (more than once if necessary) the following:

    docker ps\n

    You should see something like this:

    CONTAINER ID   IMAGE                                      COMMAND                  CREATED          STATUS          PORTS                              NAMES\n355e13878b7e   nginx                                      \"/docker-entrypoint.\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:8001->80/tcp               esmero-web\n86b685008158  solr:8.11.2                                 \"docker-entrypoint.s\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:8983->8983/tcp             esmero-solr\na8f0d9c6d4a9   esmero/cantaloupe-s3:6.0.1-multiarch       \"sh -c 'java -Dcanta\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:8183->8182/tcp             esmero-cantaloupe\n6642340b2496   mariadb:10.6.12-focal                      \"docker-entrypoint.s\u2026\"   10 minutes ago   Up 10 minutes   3306/tcp                           esmero-db\n0aef7df34037   minio/minio:RELEASE.2022-06-11T19-55-32Z   \"/usr/bin/docker-ent\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:9000-9001->9000-9001/tcp   esmero-minio\n28ee3fb4e7a7   esmero/php-8.1-fpm:1.2.0-multiarch         \"docker-php-entrypoi\u2026\"   10 minutes ago   Up 10 minutes   9000/tcp                           esmero-php\na81c36d51a81   esmero/esmero-nlp:fasttext-multiarch       \"/usr/local/bin/entr\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:6400->6400/tcp             esmero-nlp\n

    Important here is the STATUS column. It needs to be a number that goes up in time every time you run docker ps again (and again).

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-3-updates-for-key-drupal-and-archipelago-modules","title":"Step 3. Updates for key Drupal and Archipelago modules","text":"

    Now we are going to tell composer to update the key Drupal and Archipelago modules.

    First we are going to disable and remove a few minor Drupal modules. Run the following commands (in order):

    docker exec -ti esmero-php bash -c \"drush pm-uninstall fancy_file_delete\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall quickedit\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/fancy_file_delete\"\n

    Now update the versions used for these Drupal modules:

    docker exec -ti esmero-php bash -c \"composer require drupal/jquery_ui_slider:^2 drupal/jquery_ui_effects:^2 drupal/jquery_ui:1.6 drupal/jquery_ui_datepicker:^2 drupal/jquery_ui_touch_punch:^1 drupal/better_exposed_filters:6.0.3 --no-update --with-all-dependencies\"\n

    And now update one other Drupal module and the main Archipelago modules:

    docker exec -ti esmero-php bash -c \"composer require 'drupal/views_bulk_operations:^4.2' 'strawberryfield/strawberryfield:1.3.0.x-dev' 'strawberryfield/webform_strawberryfield:1.3.0.x-dev' 'strawberryfield/format_strawberryfield:1.3.0.x-dev' 'strawberryfield/strawberry_runners:0.7.0.x-dev' 'archipelago/ami:0.7.0.x-dev' --no-update --with-all-dependencies\"\n

    From inside your archipelago-deployment repo folder we are now going to open up file permissions for some of your most protected Drupal files.

    sudo chmod 777 web/sites/default\nsudo chmod 666 web/sites/default/*settings.php\nsudo chmod 666 web/sites/default/*services.yml\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-4-disableremove-additional-drupal-modules-and-loosen-up-dependencies","title":"Step 4: Disable/Remove additional Drupal modules and loosen up dependencies","text":"

    We are going to remove additional select Drupal modules that are not 1.3.0 or D10 compliant.

    Please run each of the following commands separately, in order, and do not skip any commands.

    docker exec -ti esmero-php bash -c \"composer remove symfony/http-kernel symfony/yaml --no-update\"\ndocker exec -ti esmero-php bash -c 'composer remove egulias/email-validator --no-update'\ndocker exec -ti esmero-php bash -c \"composer require drupal/config_inspector:^2 --no-update\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall jsonapi_earlyrendering_workaround\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/jsonapi_earlyrendering_workaround --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/core:^10' 'drupal/core-recommended:^10' 'drupal/core-composer-scaffold:^10' 'drupal/core-project-message:^10' --update-with-dependencies --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/core-dev:^10' --dev --update-with-dependencies --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drush/drush:^12' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/twig_tweak:^2 --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/config_inspector:^2 --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/config_update:2.0.x-dev --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/config_update_ui --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/context:^5.0@RC' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/devel:^5.1' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/sophron --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove fileeye/mimemap --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/imagemagick:^3 --no-update\"  \ndocker exec -ti esmero-php bash -c \"composer remove fileeye/mimemap --no-update\"    \ndocker exec -ti esmero-php bash -c \"composer require 'drupal/imce:^3.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/search_api_attachments:^9.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/search_api_solr:^4.3 solarium/solarium ^6.3 --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/twig_tweak:^3.2' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/webform_entity_handler:^2.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/webformnavigation:^2.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/form_mode_manager --no-update\"\n

    Well done! If you see no issues and all ends in Green colored messages, all is good! Jump to Step 5

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#what-if-all-is-not-ok-and-i-see-red-and-a-lot-of-dependency-explanations","title":"What if all is not OK, and I see red and a lot of dependency explanations?","text":"

    If you have manually installed packages via composer in the past that are NO longer Drupal 10 compatible you may see errors. In that case you need to check each package website's (normally https://www.drupal.org/project/the_module_name) and check if there is a Drupal 10 compatible version.

    If so run:

    docker exec -ti esmero-php bash -c \"composer require drupal/the_module_name:^VERSION_NUMBER_THAT_WORKS_ON_DRUPAL10_ --update-with-dependencies --no-update\" and run **Step 3** again (and again until all is cleared)\n

    If not, try to find a replacement module that does something similar, but in any case you may end up having to remove before proceeding. Give us a ping/slack/google group/open a github ISSUE if you find yourself uncertain about this.

    docker exec -ti esmero-php bash -c \"drush pm-uninstall the_module_name\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/the_module_name --no-update\"\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-5-update-composerjson","title":"Step 5: Update composer.json","text":"

    Now you need to update your composer.json file to include an important patch. Starting in your Archipelago deployment directory location, run the following commands:

    nano composer.json\n

    Inside your composer.json file, page down to the \"patches\" section and change the section to match exactly as follows:

    \"patches\": {\n      \"drupal/form_mode_manager\": {\n       \"D10 compatibility\": \"https://www.drupal.org/files/issues/2023-10-11/3297262-20.patch\"\n      },\n      \"drupal/ds\": {\n       \"https://www.drupal.org/project/ds/issues/3338860\": \"https://www.drupal.org/files/issues/2023-04-04/3338860-5-d10-compatible_0.patch\"\n      }\n    }\n

    Save your changes and then run:

    docker exec -ti esmero-php bash -c \"composer update -W\"\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-6-one-final-round-of-drupal-module-updates","title":"Step 6: One final round of Drupal module updates","text":"

    We will now run a few more updates for additional Drupal modules.

    Please run each of the following commands separately, in order, and do not skip any commands.

    docker exec -ti esmero-php bash -c \"composer require mglaman/composer-drupal-lenient\"\ndocker exec -ti esmero-php bash -c \"composer config --merge --json extra.drupal-lenient.allowed-list '[\\\"drupal/form_mode_manager\\\"]'\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/form_mode_manager:2.x-dev@dev'\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/color:^1.0'\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/hal\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/aggregator\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/ckeditor\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/seven\"\ndocker exec -ti esmero-php bash -c \"composer require archipelago/archipelago_subtheme:1.3.0.x-dev\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/quickedit drupal/classy drupal/stable\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall quickedit\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall hal\"\ndocker exec -ti esmero-php bash -c \"drush pm:install jquery_ui\"\n

    Whew, that's a lot of module updates! Now run one final database update command:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-7-optional-syncs","title":"Step 7: Optional Syncs","text":"

    Optionally, you can sync your new Archipelago 1.3.0 and bring in all the latest configs and settings. For this you have two options (no worries, remember you made a backup!):

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#a-partial-sync-which-will-bring-new-configs-and-update-existing-ones-but-will-not-remove-ones-that-only-exist-in-your-custom-setup-eg-new-webforms-or-view-modes","title":"A Partial Sync, which will bring new configs and update existing ones but will not remove ones that only exist in your custom setup, e.g. new Webforms or View Modes.","text":"
    docker exec esmero-php drush cim -y --partial   \n
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#a-complete-sync-which-will-bring-new-things-and-update-existing-but-will-also-remove-all-the-ones-that-are-not-part-of-130-its-a-like-clean-factory-reset","title":"A Complete Sync, which will bring new things and update existing but will also remove all the ones that are not part of 1.3.0. It's a like clean factory reset.","text":"
    docker exec esmero-php drush cim -y\n

    If all goes well here and you see no errors it's time to reindex Solr because there are new Fields. Run the following:

    docker exec esmero-php drush search-api-reindex\ndocker exec esmero-php drush search-api-index\n

    You might see some warnings related to modules dealing with previously non-existent data\u2014no worries, just ignore those.

    If you made it this far you are done with code/devops (are we ever ready?), and that means you should be able to (hopefully) stay in the Drupal 10 realm for a few years!

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-8-update-or-not-your-metadata-display-entities-and-menu-items","title":"Step 8: Update (or not) your Metadata Display Entities and menu items","text":"

    Recommended: If you want to add new templates and menu items 1.3.0 provides, run this:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    Once that is done, you can choose to update all Metadata Displays (twig templates) we ship with new 1.3.0 versions (heavily adjusted IIIF manifests, better Object description template using Macros). Before you do this, we strongly recommend that you first make sure to manually (copy/paste) backup any Twig templates you have modified. If unsure, do not run the command that comes after this warning! You can always manually copy the new templates from the d8content/metadatadisplays folder which contains text versions (again, copy/paste) of each shipped template you can pick and use when you feel ready.

    If you are sure (like really?) you want to overwrite the ones you modified (sure, just checking?), then you can run this:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/update_deployed.sh'\n

    Done! (For realz now)

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#step-9-or-should-we-say-10","title":"Step 9 (or should we say 10)","text":"

    Please login to your Archipelago and test/check all is working! Enjoy 1.3.0 and Drupal 10. Thanks!

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#need-help-blue-screen-missed-a-step-need-a-hug-and-such","title":"Need help? Blue Screen? Missed a step? Need a hug and such?","text":"

    If you see any issues or errors or need help with a step, please let us know (ASAP!). You can either open an issue in this repository or use the Google Group. We are here to help.

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Sherrick
    • Giancarlo Birello
    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-UpgradeDrupalD9toD10/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-democontent/","title":"Adding Demo Archipelago Digital Objects (ADOs) to your Repository","text":"

    We make this optional since we feel not everyone wants to have Digital Objects from other people using space in their system. Still, if you are new to Archipelago we encourage you to do this. Its a simply way to get started without thinking too much. You can learn and test. Then delete and move over.

    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#prerequisites","title":"Prerequisites","text":"","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#the-new-way-archipelago-100-rc2-or-higher","title":"The new way Archipelago 1.0.0-RC2 or higher.","text":"
    • You installed it either via the Step by Step deployment on OSX, the one for Ubuntu or using your secret powers directly on a VM/Metal/Cloud/EC2 or even a raspberryPI.
    • You followed the guides without being too creative which means you have an jsonapi drupal user and an admin one and you can login and out of your server.
    • You remember your admin user. (If you followed one of the deployment guides, password will be archipelago)
    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#step-1-only-step","title":"Step 1: (only step)","text":"
    • Log into your Archipelago using the admin user.
    • Navigate to Content -> Ami Sets. You will see a single AMI Set already in place.
    • On the Drop Down Menu to the right (The edit Button), press on the little down arrow and choose Process.
    • A new Form will appear. Under DESIRED ADOS STATUSES AFTER PROCESS, change all from Draft to Published, leave Enqueue but do not process Batch in realtime unchecked and press \"Confirm\". The Ingest will start and a progress bar will advance. Once ready a list of Ingest Objects should appear.
    • You are done!
    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#old-way-a-running-archipelago-10-beta3-or-higher","title":"Old way, A running Archipelago 1.0-Beta3 or higher.","text":"
    • You installed it either via the Step by Step deployment on OSX, the one for Ubuntu or using your secret powers directly on a VM/Metal/Cloud/EC2 or even a raspberryPI.
    • You followed the guides without being too creative which means you have a jsonapi drupal user and you can login and out of your server.
    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#step-1-get-the-content","title":"Step 1: Get the content","text":"

    Go into your archipelago-deployment folder and into the d8content folder that is inside it, e.g.

    cd archipelago-deployment/d8content\ngit clone https://github.com/esmero/archipelago-recyclables\n
    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#step-2-ingest-the-objects","title":"Step 2: Ingest the Objects","text":"
    • If running Docker execute:
    docker exec -ti esmero-php bash -c 'd8content/archipelago-recyclables/deploy_ados.sh'\n

    You will see multiple outputs similar to this:

    Files in provided location:\n - anne_001.jpg\n - anne_002.jpg\n - anne_003.jpg\n - anne_004.jpg\n - anne_005.jpg\n - anne_006.jpg\n - anne_007.jpg\n - anne_008.jpg\n - anne_009.jpg\n - anne_010.jpg\nFile anne_001.jpg sucessfully uploaded with Internal Drupal file ID 5\nFile anne_002.jpg sucessfully uploaded with Internal Drupal file ID 6 \nFile anne_003.jpg sucessfully uploaded with Internal Drupal file ID 7\nFile anne_004.jpg sucessfully uploaded with Internal Drupal file ID 8\nFile anne_005.jpg sucessfully uploaded with Internal Drupal file ID 9 \nFile anne_006.jpg sucessfully uploaded with Internal Drupal file ID 10 \nFile anne_007.jpg sucessfully uploaded with Internal Drupal file ID 11 \nFile anne_008.jpg sucessfully uploaded with Internal Drupal file ID 12\nFile anne_009.jpg sucessfully uploaded with Internal Drupal file ID 13 \nFile anne_010.jpg sucessfully uploaded with Internal Drupal file ID 14\nNew Object 'Anne of Green Gables : Chapters 1 and 2' with UUID 9eb28775-d73a-4904-bc79-f0e925075bc5 successfully ingested. Thanks!\n

    The gist here is that if the script says Thanks you are good.

    • If you are not running Docker (You are a unicorn or at least a hacker) you will need to tune/copy/modify the following script: archipelago-deployment/d8content/archipelago-recyclables/deploy_ados.sh

    Inside you will find lines like this one: 

    drush archipelago:jsonapi-ingest /var/www/html/d8content/archipelago-recyclables/ado/0c2dc01a-7dc2-48a9-b4fd-3f82331ec803.json --uuid=0c2dc01a-7dc2-48a9-b4fd-3f82331ec803 --bundle=digital_object --uri=http://esmero-web --files=/var/www/html/d8content/archipelago-recyclables/ado/0c2dc01a-7dc2-48a9-b4fd-3f82331ec803 --user=jsonapi --password=jsonapi --moderation_state=published;\n

    What you want here is to modify/replace the absolute paths that point your demo objects (.json) and their assets (folders with the same name). Basically replace every entry of /var/www/html/d8content/archipelago-recyclables/ with the path to archipelago-recyclables.

    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#need-help-blue-screen-missed-a-step-need-a-hug-another-hug","title":"Need help? Blue Screen? Missed a step? Need a hug? Another Hug?","text":"

    If you have trouble running this or see errors or need help with a step (its only two steps), please let us know (ASAP!). You can either open an issue in this repository or use the Google Group. We are here to help.

    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#caring-coding-fixing","title":"Caring & Coding + Fixing","text":"
    • Diego Pino
    • Giancarlo Birello
    • Allison Lund
    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-democontent/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago Digital Objects","Demo Content"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/","title":"Archipelago-deployment-live: upgrading Drupal 9 to Drupal 10 (1.1.0 to 1.3.0)","text":"","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#what-is-this-documentation-for","title":"What is this documentation for?","text":"

    If you already have a well-set-up and well-loved Archipelago (1.1.0) running Drupal 9 (D9), this documentation will allow you to update to 1.3.0 on Drupal 10 (D10) without any major issues.

    D9 is no longer supported as of the end of November 2023. D10 has been around for a little while, and even if every module is not supported yet, what you need and want for Archipelago has long been ready for D10. However, Archipelago is still D9 (1.2.0) compatible if it's necessary for you to stay back a little longer.

    This documentation is meant to be a guide/helper, not a single-click-magic solution. Why? Because your Drupal environment and your local github branches for this whole project might have diverged really a lot from a vanilla Archipelago base deployment. You might have new templates, custom composer.json, new modules, changed webforms and Views. That is not an Archipelago issue, more like a How do i keep any Drupal instance, YAML files, custom configurations and modules in version control and in sync as i upgrade other parts, issue.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#requirements","title":"Requirements","text":"
    • An archipelago-deployment-live instance 1.1.0 (working, tested) deployed using provided instructions via Docker and running Drupal 9.
    • Basic knowledge, patience and instincts (+ courage) on how to run Terminal Commands, composer and drush.
    • Patience(again). You can't skip steps here.
    • For shell Commands documented here please copy line by line--not the whole block.
    • You are running already version control and know how to git pull/push/merge.
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#backing-up-and-preparing-for-the-upgrade","title":"Backing up and preparing for the upgrade","text":"

    Backups are always going to be your best friends. Archipelago's code, database, and settings are mostly self-contained in your current archipelago-deployment-live repo folder, and backing up is simple because of that.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-1","title":"Step 1:","text":"

    On a terminal, cd into your running archipelago-deployment-live folder, then cd inside the deploy/ec2-docker subfolders and shut down your docker-compose ensemble by running the following:

    docker-compose down\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-2","title":"Step 2:","text":"

    Verify that all containers are actually down. The following command should return an empty listing:

    docker ps\n

    If anything is still running, wait a little longer and run the command again.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-3","title":"Step 3:","text":"

    Now let's tar.gz the whole ensemble with data and configs. We will exclude here the local source caches generated by Cantaloupe. If these or not exist will depend on how custom your deployment is. As an example we will save this into your $HOME folder. As a good practice we append the current date (YEAR-MONTH-DAY) to the filename. Here we assume today is December 12th of 2023.

    We will cd back to the parent folder of your running archipelago-deployment-live folder, so three levels down, assuming you are right now inside archipelago-deployment-live/deploy/ec2-docker

    cd ../../..\nsudo tar --exclude=archipelago-deployment-live/data_storage/iiifcache --exclude=archipelago-deployment-live/data_storage/iiiftmp -czvpf $HOME/archipelago-deployment-D9-20231212.tar.gz archipelago-deployment-live\n

    The process may take a few minutes. Now let's verify that all is there and that the tar.gz is not corrupt.

    tar -tvvf $HOME/archipelago-deployment-D9-20231212.tar.gz\n

    You will see a listing of files, and at the end you will see something like this: Archive Format: POSIX pax interchange format, Compression: gzip. If corrupt (Do you have enough space? Did your ssh connection drop?) you will see the following:

    tar: Unrecognized archive format\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-4","title":"Step 4:","text":"

    cd again into your running archipelago-deployment-live folder, then cd inside the deploy/ec2-docker Restart your docker-compose ensemble, and wait a little while for all to start.

    docker-compose up -d\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-5","title":"Step 5:","text":"

    Export/backup all of your live Archipelago 1.1.0, Drupal 9 configurations (this allows you to compare/come back in case you lose something custom during the upgrade).

    docker exec esmero-php mkdir config/backup\ndocker exec esmero-php drush cex --destination=/var/www/html/config/backup\n

    Good. Now it's safe to begin the upgrade process.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#upgrading-to-130","title":"Upgrading to 1.3.0","text":"","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-1-edit-docker-composeryml","title":"Step 1: Edit docker-composer.yml","text":"

    First we are going to edit your docker-compose.yml file to reference the latest PHP container as needed. Starting in your Archipelago deployment directory location, run the following commands:

    If you have not already, run:

    docker-compose down\n

    Then open your docker-compose.yml file:

    nano docker-compose.yml\n

    Inside your docker-compose.yml file, page down to the php section and change the image section to match exactly as follows:

    image: \"esmero/php-8.1-fpm:1.2.0-multiarch\"\n

    Next page down to the iiif section and change the image section to match exactly as follows:

    image: \"esmero/cantaloupe-s3:6.0.1-multiarch\"\n

    Save your changes.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-2-docker-pull-and-check","title":"Step 2: docker pull and check","text":"

    Time to fetch the latest branch and update our docker compose and composer dependencies. To pull the images and bring up the ensemble, run:

    docker compose pull\ndocker compose up -d\n

    Give all a little time to start. Please be patient. To ensure all is well, run (more than once if necessary) the following:

    docker ps\n

    You should see something like this (your versions might vary):

    CONTAINER ID   IMAGE                                      COMMAND                  CREATED          STATUS          PORTS                              NAMES\n355e13878b7e   nginx                                      \"/docker-entrypoint.\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:8001->80/tcp               esmero-web\n86b685008158   solr:8.11.2                                \"docker-entrypoint.s\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:8983->8983/tcp             esmero-solr\na8f0d9c6d4a9   esmero/cantaloupe-s3:6.0.1-multiarch       \"sh -c 'java -Dcanta\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:8183->8182/tcp             esmero-cantaloupe\n6642340b2496   mariadb:10.6.12-focal                      \"docker-entrypoint.s\u2026\"   10 minutes ago   Up 10 minutes   3306/tcp                           esmero-db\n0aef7df34037   minio/minio:RELEASE.2022-06-11T19-55-32Z   \"/usr/bin/docker-ent\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:9000-9001->9000-9001/tcp   esmero-minio\n28ee3fb4e7a7   esmero/php-8.1-fpm:1.2.0-multiarch         \"docker-php-entrypoi\u2026\"   10 minutes ago   Up 10 minutes   9000/tcp                           esmero-php\na81c36d51a81   esmero/esmero-nlp:fasttext-multiarch       \"/usr/local/bin/entr\u2026\"   10 minutes ago   Up 10 minutes   0.0.0.0:6400->6400/tcp             esmero-nlp\n

    Important here is the STATUS column. It needs to be a number that goes up in time every time you run docker ps again (and again). Note: We will update from Solr 8.11.2 to Solr 9.1.1 only after we are sure all is running correctly.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-3-updates-for-key-drupal-and-archipelago-modules","title":"Step 3. Updates for key Drupal and Archipelago modules","text":"

    Now we are going to tell composer to update the key Drupal and Archipelago modules.

    First we are going to disable and remove a few minor Drupal modules. Run the following commands (in order):

    docker exec -ti esmero-php bash -c \"drush pm-uninstall fancy_file_delete\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall quickedit\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/fancy_file_delete\"\n

    Now update the versions used for these Drupal modules:

    docker exec -ti esmero-php bash -c \"composer require drupal/jquery_ui_slider:^2 drupal/jquery_ui_effects:^2 drupal/jquery_ui:1.6 drupal/jquery_ui_datepicker:^2 drupal/jquery_ui_touch_punch:^1 drupal/better_exposed_filters:6.0.3 --no-update --with-all-dependencies\"\n

    And now update one other Drupal module and the main Archipelago modules:

    docker exec -ti esmero-php bash -c \"composer require 'drupal/views_bulk_operations:^4.2' 'strawberryfield/strawberryfield:1.3.0.x-dev' 'strawberryfield/webform_strawberryfield:1.3.0.x-dev' 'strawberryfield/format_strawberryfield:1.3.0.x-dev' 'strawberryfield/strawberry_runners:0.7.0.x-dev' 'archipelago/ami:0.7.0.x-dev' --no-update --with-all-dependencies\"\n

    From inside your archipelago-deployment-live repo folder, and inside the drupal subfolder, we are now going to open up file permissions for some of your most protected Drupal files.

    sudo chmod 777 web/sites/default\nsudo chmod 666 web/sites/default/*settings.php\nsudo chmod 666 web/sites/default/*services.yml\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-4-disableremove-for-additional-select-drupal-modules","title":"Step 4: Disable/Remove for additional select Drupal modules","text":"

    We are going to remove additional select Drupal modules that are not 1.3.0 or D10 compliant.

    Please run each of the following commands separately, in order, and do not skip any commands.

    docker exec -ti esmero-php bash -c \"composer remove symfony/http-kernel symfony/yaml --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/config_inspector:^2 --no-update\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall jsonapi_earlyrendering_workaround\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/jsonapi_earlyrendering_workaround --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/core:^10' 'drupal/core-recommended:^10' 'drupal/core-composer-scaffold:^10' 'drupal/core-project-message:^10' --update-with-dependencies --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/core-dev:^10' --dev --update-with-dependencies --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/google_api_client\"\ndocker exec -ti esmero-php bash -c \"composer require 'drush/drush:^12' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/twig_tweak:^2 --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/config_inspector:^2 --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/config_update:2.0.x-dev --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/config_update_ui --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/context:^5.0@RC' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/devel:^5.1' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/sophron --no-update\"\ndocker exec -ti esmero-php bash -c \"composer remove fileeye/mimemap --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/imagemagick:^3 --no-update\"  \ndocker exec -ti esmero-php bash -c \"composer remove fileeye/mimemap --no-update\"    \ndocker exec -ti esmero-php bash -c \"composer remove drupal/jsonapi_earlyrendering_workaround --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/imce:^3.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/search_api_attachments:^9.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/twig_tweak:^3.2' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/webform_entity_handler:^2.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/webformnavigation:^2.0' --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/webform_jqueryui_datepicker:^6 --no-update\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/rdf --no-update \"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/form_mode_manager --no-update\"\n

    Well done! If you see no issues and all ends in Green colored messages, all is good! Jump to Step 5

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#what-if-all-is-not-ok-and-i-see-red-and-a-lot-of-dependency-explanations","title":"What if all is not OK, and I see red and a lot of dependency explanations?","text":"

    If you have manually installed packages via composer in the past that are NO longer Drupal 10 compatible you may see errors. In that case you need to check each package website's (normally https://www.drupal.org/project/the_module_name) and check if there is a Drupal 10 compatible version.

    If so run:

    docker exec -ti esmero-php bash -c \"composer require 'drupal/the_module_name:^VERSION_NUMBER_THAT_WORKS_ON_DRUPAL10_' --update-with-dependencies --no-update\" and run **Step 3 ** again (and again until all is cleared)\n

    If not, try to find a replacement module that does something similar, but in any case you may end up having to remove before proceeding. Give us a ping/slack/google group/open a github ISSUE if you find yourself uncertain about this.

    docker exec -ti esmero-php bash -c \"drush pm-uninstall the_module_name\"\ndocker exec -ti esmero-php bash -c \"composer remove drupal/the_module_name --no-update\"\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-5-update-composerjson","title":"Step 5: Update composer.json","text":"

    Now you need to update your composer.json file to include an important patch. Starting in your Archipelago deployment directory location, run the following commands:

    nano composer.json\n

    Inside your composer.json file, page down to the \"patches\" section and change the section to match exactly as follows:

    \"patches\": {\n      \"drupal/form_mode_manager\": {\n       \"D10 compatibility\": \"https://www.drupal.org/files/issues/2023-11-07/3297262-62-form-mode-manager-D10.patch\"\n      },\n      \"drupal/ds\": {\n       \"https://www.drupal.org/project/ds/issues/3338860\": \"https://www.drupal.org/files/issues/2023-04-04/3338860-5-d10-compatible_0.patch\"\n      }\n    }\n

    Save your changes and then run:

    docker exec -ti esmero-php bash -c \"composer update -W\"\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-6-one-final-round-of-drupal-module-updates","title":"Step 6: One final round of Drupal module updates","text":"

    We will now run a few more updates for additional Drupal modules.

    Please run each of the following commands separately, in order, and do not skip any commands.

    docker exec -ti esmero-php bash -c \"composer require mglaman/composer-drupal-lenient\"\ndocker exec -ti esmero-php bash -c \"composer config --merge --json extra.drupal-lenient.allowed-list '[\\\"drupal/form_mode_manager\\\"]'\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/form_mode_manager:2.x-dev@dev'\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/color:^1.0'\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/hal\"  \ndocker exec -ti esmero-php bash -c \"composer require drupal/aggregator\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/ckeditor\"  \ndocker exec -ti esmero-php bash -c \"composer require drupal/seven\"\ndocker exec -ti esmero-php bash -c \"composer require archipelago/archipelago_subtheme:1.3.0.x-dev\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/classy drupal/stable\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall hal\"\ndocker exec -ti esmero-php bash -c \"drush pm:uninstall rdf\"\ndocker exec -ti esmero-php bash -c \"drush pm:install jquery_ui\"\ndocker exec -ti esmero-php bash -c \"drush pm:install jquery_ui_effects\"\n

    Whew, that's a lot of module updates! Now run one final database update command:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-7-optional-syncs","title":"Step 7: Optional Syncs","text":"

    Optionally, you can sync your new Archipelago 1.3.0 and bring in all the latest configs and settings. This requires you do fetch, either via git or manually via wget or curl newer configs from https://github.com/esmero/archipelago-deployment-live/tree/1.3.0/drupal/config/sync into the same folder structure/location of your deployment.

    For this you have two options (no worries, remember you made a backup!):

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#a-partial-sync-which-will-bring-new-configs-and-update-existing-ones-but-will-not-remove-ones-that-only-exist-in-your-custom-setup-eg-new-webforms-or-view-modes","title":"A Partial Sync, which will bring new configs and update existing ones but will not remove ones that only exist in your custom setup, e.g. new Webforms or View Modes.","text":"
    docker exec esmero-php drush cim -y --partial\n
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#a-complete-sync-which-will-bring-new-things-and-update-existing-but-will-also-remove-all-the-ones-that-are-not-part-of-130-its-a-like-clean-factory-reset","title":"A Complete Sync, which will bring new things and update existing but will also remove all the ones that are not part of 1.3.0. It's a like clean factory reset.","text":"
    docker exec esmero-php drush cim -y\n

    If all goes well here and you see no errors it's time to reindex Solr because there are new Fields. Run the following:

    docker exec esmero-php drush search-api-reindex\ndocker exec esmero-php drush search-api-index\n

    You might see some warnings related to modules dealing with previously non-existent data\u2014no worries, just ignore those.

    If you made it this far you are done with code/devops (are we ever ready?), and that means you should be able to (hopefully) stay in the Drupal 10 realm for a few years!

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-8-update-or-not-your-metadata-display-entities-and-menu-items","title":"Step 8: Update (or not) your Metadata Display Entities and menu items","text":"

    Recommended: If you want to add new templates and menu items 1.3.0 provides, you need to fetch everything from this remote https://github.com/esmero/archipelago-deployment-live/tree/1.3.0/drupal/d8content to your local installation into the same folder structure/location and then run:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    Important: If you don't download/sync/git merge (or your prefered method) then the command will add nothing, since you will be running this command against 1.1.0 content.

    Once that is done, you can choose to update all Metadata Displays (twig templates) we ship with new 1.3.0 versions (heavily adjusted IIIF manifests, better Object description template using Macros). Before you do this, we strongly recommend that you first make sure to manually (copy/paste) backup any Twig templates you have modified. If unsure, do not run the command that comes after this warning! You can always manually copy the new templates from the d8content/metadatadisplays folder which contains text versions (again, copy/paste) of each shipped template you can pick and use when you feel ready.

    If you are sure (like really?) you really want to overwrite the ones you modified (sure, just checking?), then you can run this (make sure you edit that file):

    docker exec -ti esmero-php bash -c 'scripts/archipelago/update_deployed.sh'\n

    Done! (For realz now)

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-9","title":"Step 9","text":"

    Please login to your Archipelago and test/check all is working! Enjoy 1.3.0 and Drupal 10. Thanks! Also please keep all your new changes under version control. Check what has changed. git add and git commit -m \"What i changed\" as needed.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#step-10","title":"Step 10","text":"

    If all looks good and you are not missing any functionality (please be thorough about testing), it is time to Jump to Upgrading to Solr 9.11

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#need-help-blue-screen-missed-a-step-need-a-hug-or-someone-that-listens-to-you-in-silence","title":"Need help? Blue Screen? Missed a step? Need a hug or someone that listens to you in silence?","text":"

    If you see any issues or errors or need help with a step, please let us know (ASAP!). You can either open an issue in this repository or use the Google Group. We are here to help.

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Sherrick
    • Giancarlo Birello
    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-UpgradeDrupalD9toD10/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment-live","Drupal 9","Drupal 10"]},{"location":"archipelago-deployment-live-gitworkflow/","title":"Managing, sheltering, pruning and nurturing your own custom Archipelago","text":"

    Now that you have your base Archipelago Live Deployment running (Do you? If not, go back!) you may be wondering about things like:

    1. What happens when I need to update to the next release?
    2. How do I keep my Drupal and Modules updated in between releases?
    3. Can I add Drupal Modules?
    4. Will a new release overwrite all my customizations?
    5. What things are safe to customize?
    6. How do I keep my very own things in Version Control and safe from others?
    7. And many (many) other similar questions.
    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#1-keep-your-archipelago-under-version-control-via-github","title":"1. Keep your Archipelago under Version Control via Github","text":"

    Archipelagos are living beings. They evolve and become beautiful, closer and closer to your needs. Because of that resetting your particularities on every Archipelago code release is not a good idea, nor even recommended. What you want is to keep your own Drupal Settings\u2014your facets, your themes, your Solr fields, your own modules, and all their configurations\u2014safe and be able to restore all in case something goes wrong.

    The ones we ship with every Release will reset your Archipelago's settings to Factory defaults if applied wildly.

    This is where Github comes in place.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#basic-steps","title":"Basic steps","text":"

    Prerequisites:

    • Have an Archipelago Deployment Live instance running
    • Have Terminal access to your Live Instance
    • Have a Github account
    • Have a personal Github Access Token Created
    • Run git config --global --edit on your Live Instance and Set your user name/email/etc.
    • Note: Opens in Vi! In case of emergency/panic press ESC and type :x to escape and/or run away in terror. To edit Press i and uncomment the lines. Once Done press ESC and type :x to save.
    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#11-start-by-creating-a-git-fork","title":"1.1 Start by creating a Git Fork","text":"

    Let's fork https://github.com/esmero/archipelago-deployment-live under your own Account via the web. Happy Note: Since 2021 also keeping forked branches in sync with the origin can be done via the UI directly.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#12-connect-your-live-instance-terminal","title":"1.2 Connect your Live instance terminal.","text":"

    Move to your repository's base folder, and let's start by adding your New Fork as a secondary Git Origin. Replace in this command yourOwnAccount with (guess what?) your own account:

    git remote add upstream https://github.com/yourOwnAccount/archipelago-deployment-live\n

    Now check if you have two remotes (origin => This repository, upstream => your own fork):

    git remote -v\n

    You will see this:

    origin  https://github.com/esmero/archipelago-deployment-live (fetch)\norigin  https://github.com/esmero/archipelago-deployment-live (push)\nupstream    https://github.com/yourOwnAccount/archipelago-deployment-live (fetch)\nupstream    https://github.com/yourOwnAccount/archipelago-deployment-live (push)\n

    Good!

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#13-now-lets-create-from-your-current-live-instance-a-new-branch","title":"1.3 Now let's create from your current Live Instance a new Branch.","text":"

    We will push this branch into your Fork and it will be all yours to maintain. Please replace yourOwnOrg with any Name you want for this. We like to keep the current Branch name in place after your personal prefix:

    git checkout -b yourOwnOrg-1.0.0-RC3\n

    Good, you now have a new local branch named yourOwnOrg-1.0.0-RC3, and it's time to decide what we are going to push into Github.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#14-push-the-basics","title":"1.4 Push the Basics.","text":"

    By default our deployment strategy (this repository) ignores a few files you want to have in Github. Also, there are things like the Installed Drupal Modules and PHP Libraries (the Source Code), the Database, Caches, your Secrets (.env file), and your Drupal settings.php file. You FOR SURE do not want to have these in Github and are better suited for a private Backup Storage.

    Let's start by pushing what you have (no commits, your new yourOwnOrg-1.0.0-RC3 as it is) to your new Fork. From there on we can add new Commits and files:

    git push upstream yourOwnOrg-1.0.0-RC3\n

    And Git will respond with the following (use your yourOwnAccount personal Github Access Token as password):

    Username for 'https://github.com': yourOwnAccount\nPassword for 'https://yourOwnAccount@github.com': \nTotal 0 (delta 0), reused 0 (delta 0)\nremote: \nremote: Create a pull request for 'yourOwnOrg-1.0.0-RC3' on GitHub by visiting:\nremote:      https://github.com/yourOwnAccount/archipelago-deployment-live/pull/new/yourOwnOrg-1.0.0-RC3\nremote: \nTo https://github.com/yourOwnAccount/archipelago-deployment-live\n * [new branch]      yourOwnOrg-1.0.0-RC3 -> yourOwnOrg-1.0.0-RC3\n
    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#15-first-commit","title":"1.5 First Commit","text":"

    Right now this new Branch (go and check it out at https://github.com/yourOwnAccount/archipelago-deployment-live/tree/yourOwnOrg-1.0.0-RC3) will not differ at all from 1.0.0-RC3. That is OK. To make your Branch unique, what we want is to \"commit\" our changes. How do we do this?

    Let's add our composer.json and composer.lock to our change list. Both of these files are quite personal, and as you add more Drupal Modules, dependencies, or Upgrade your Archipelgo and/or Drupal Core and Modules, all of these corresponding files will change. See the -f? Because our base deployment ignores that file and you want it, we \"Force\" add it. Note: At this stage composer.lock won't be added at all because it's still the same as before. So you can only \"add\" files that have changes.

    git add drupal/composer.json \ngit add -f drupal/composer.lock\n

    Now we can see what is new and will be committed by executing:

    git status\n

    You may see something like this:

    On branch yourOwnOrg-1.0.0-RC3 \nChanges to be committed:\n  (use \"git restore --staged <file>...\" to unstage)\n    new file:   drupal/composer.json\n\nChanges not staged for commit:\n  (use \"git add <file>...\" to update what will be committed)\n  (use \"git restore <file>...\" to discard changes in working directory)\n    modified:   drupal/scripts/archipelago/deploy.sh\n    modified:   drupal/scripts/archipelago/update_deployed.sh\n\nUntracked files:\n  (use \"git add <file>...\" to include in what will be committed)\n    deploy/ec2-docker/docker-compose.yml\n    drupal/.editorconfig\n    drupal/.gitattributes\n

    If you do not want to add each Changes not staged for commit individually (WE recommend you only commit what you need. Be warned and take caution.), you can also issue a git add ., which means add all.

    git add drupal/scripts/archipelago/deploy.sh\ngit add drupal/scripts/archipelago/update_deployed.sh\ngit add deploy/ec2-docker/docker-compose.yml\n

    In this case we are also committing docker-compose.yml, which you may have customized and modified to your domain (See Install Guide Step 3), deploy.sh and update_deployed.sh scripts. If you ever need to avoid tracking certain files at all, you can edit the .gitignore file and add more patterns to it (look at it, it's fun!).

    git commit -m \"Fresh Install of Archipelago for yourOwnOrg\"\n

    If you had your email/user account setup correctly (see Prerequisites) you will see:

    Fresh Install of Archipelago yourOwnOrg\n 4 files changed, 360 insertions(+), 46 deletions(-)\n create mode 100644 deploy/ec2-docker/docker-compose.yml\n create mode 100644 drupal/composer.json\n

    And now finally you can push this back to your Fork:

    git push upstream yourOwnOrg-1.0.0-RC3\n

    And Git will respond with the following (use your yourOwnAccount personal Github Access Token as password):

    Username for 'https://github.com': yourOwnAccount\nPassword for 'https://yourOwnAccount@github.com': \nEnumerating objects: 18, done.\nCounting objects: 100% (18/18), done.\nCompressing objects: 100% (10/10), done.\nWriting objects: 100% (10/10), 2.26 KiB | 2.26 MiB/s, done.\nTotal 10 (delta 5), reused 0 (delta 0)\nremote: Resolving deltas: 100% (5/5), completed with 5 local objects.\nTo https://github.com/yourOwnAccount/archipelago-deployment-live\n   d9fa835..3427ce5  yourOwnOrg-1.0.0-RC3 -> yourOwnOrg-1.0.0-RC3\n

    And done.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#2-keeping-your-archipelago-modules-updated-during-releases","title":"2. Keeping your Archipelago Modules Updated during releases","text":"

    Releases in Archipelago are a bit different to other OSS projects. When a Release is done (let's say 1.0.0-RC2) we freeze the current release branches in every module we provide, package the release, and inmediatelly start with a new Release Cycle (6 months long normally) by creating in each repository a new Set of Branches (for this example 1.0.0-RC3). All new commits, fixes, improvements, features now will ALWAYS go into the Open/on-going new cycle branches (for this example 1.0.0-RC3), and once we are done we do it all over again. We freeze (for this example 1.0.0-RC3), and a new release cycle starts with fresh new \"WIP\" branches (for this example 1.1.0).

    Some Modules like AMI or Strawberry Runners have their independent Version but are released together anyway, e.g. for 1.0.0-RC3 both AMI and Strawberry Runners are 0.2.0. Why? Because work started later than the core Archipelago and also because they are not really CORE. So what happens with main branches? In our project main branches are never experimental. They are always a 1:1 with the latest stable release. So main will contain a full commit of 1.0.0-RC2 until we freeze 1.0.0-RC3 when main gets that code. Over and over. Nice, right?

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#which-modules-belong-to-archipelago-and-follow-a-release-cycle","title":"Which modules belong to Archipelago and follow a release cycle?","text":"

    The following modules are the ones we update on every release:

    • https://github.com/esmero/strawberryfield -> Composer name: strawberryfield/strawberryfield
    • https://github.com/esmero/format_strawberryfield -> Composer name: strawberryfield/format_strawberryfield
    • https://github.com/esmero/webform_strawberryfield -> Composer name: strawberryfield/webform_strawberryfield
    • https://github.com/esmero/ami -> Composer name: archipelago/ami
    • https://github.com/esmero/strawberry_runners -> Composer name: strawberryfield/strawberry_runners

    We also update macro modules that are meant for deployment like this Repository and https://github.com/esmero/archipelago-deployment.

    To keep your Archipelago up to date, especially once you \"go custom\" as described in this Documentation, the process is quite simple, e.g. to fetch latest 1.0.0-RC3 updates during the 1.0.0-RC3 release cycle run:

    docker exec -ti esmero-php bash -c \"composer require strawberryfield/strawberryfield:dev-1.0.0-RC3 strawberryfield/format_strawberryfield:dev-1.0.0-RC3 strawberryfield/webform_strawberryfield:dev-1.0.0-RC3 archipelago/ami:0.2.0.x-dev strawberryfield/strawberry_runners:0.2.0.x-dev strawberryfield/strawberry_runners:0.2.0.x-dev archipelago/archipelago_subtheme:dev-1.0.0-RC3 -W\"\n

    And then run any Database updates that may be needed:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n

    This will bring all the new code and all (except if there are BUGS!) should work as expected.

    Note: Archipelago really tries hard to be as backwards compatible as possible and rarely will you see a non-documented or non-dealt-with deprecation.

    Note 2: We of course recommend always running the Stable (frozen) release, but since code is plastic and fixes will go into a WIP open branch, you should be safe enough to move all modules together.

    You can run these commands any time you need, and while the release is open you will always get the latest code (even if it's always the same branch). Please follow/subscribe to each Module's Github to be aware of changes/issues and improvements.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#3-keeping-your-archipelagos-drupal-contributed-modules-and-core-updated","title":"3. Keeping your Archipelago's Drupal Contributed Modules and Core updated","text":"","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#31-contributed-modules","title":"3.1 Contributed Modules.","text":"

    To keep your Archipelago's Drupal up to date check your Drupal at https://yoursite.org/admin/modules/update. Make sure you check mostly (yes mostly, no need to overreact) for Security Updates. Not every Drupal contributed module (project) keeps backwards compatibility, and we try to test every version we ship (as in this repository's composer.lock files) before releasing. Once you detect a major change/requirement, visit the Project's Changelog Website, and take some time reading it. If you feel confident it's not going to break all, copy the suggested Composer command, e.g. if you visit https://www.drupal.org/project/google_api_client/releases/8.x-3.2 you will see that the update is suggested as:

    Install with Composer: $ composer require 'drupal/google_api_client:^3.2'\n

    Using the same module as an example, before doing any final updates, check your current running version (take note in case you need to revert):

    docker exec -ti esmero-php bash -c \"composer info 'drupal/google_api_client\"\n

    Keep the version around.

    Now let's update, which means using the suggested command translated to our own Docker world like this (notice the -W):

    docker exec -ti esmero-php bash -c \"composer require 'drupal/google_api_client:^3.2 -W\"\n

    And then run any Database updates that may be needed:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n

    This will update that module. Test your website. Depending on what you update, you want to focus first on the functionality it provides, and then create/edit/delete a fictitious Digital Object to ensure it did not add any errors to your most beloved Digital Objects workflows.

    If you see errors or you feel it's not acting as it should, you can revert by doing:

    docker exec -ti esmero-php bash -c \"composer require 'drupal/google_api_client:^VERSION_YOU_KEPT_AROUND -W\"\n

    And then run any Database updates that may be needed:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n

    If this happens we encourage you to please \ud83d\udc4f share your findings with our community/slack/Github ISSUE here.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#31-drupal-core-inside-the-same-major-version","title":"3.1 Drupal Core inside the same major version:","text":"

    This is quite similar to a contributed module but normally involves at least 3 dependencies and of course larger changes.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#exact-version","title":"Exact Version","text":"

    Inside the same major version, e.g. inside Drupal 9, if you are currently running Drupal 9.0.1 and you want to update to an exact latest (as I write 9.2.4):

    docker exec -ti esmero-php bash -c \"composer require drupal/core:9.2.4 drupal/core-dev:9.2.4 drupal/core-composer-scaffold:9.2.4 drupal/core-project-message:9.2.4 --update-with-dependencies\"\n

    Or under Drupal 8, if you are currently running Drupal 8.9.14 and you want to update to an exact latest (as I write 8.9.18):

    docker exec -ti esmero-php bash -c \"composer require drupal/core-dev:8.9.18 drupal/core:8.9.18 drupal/core-composer-scaffold:8.9.18 --update-with-dependencies\"\n

    And then for both cases run any Database updates that may be needed:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n
    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#alternative-major-version","title":"Alternative Major Version","text":"

    If you want to only remember a single command and want to be sure to also get all extra packages for Drupal 9, run:

    docker exec -ti esmero-php bash -c \"composer require drupal/core-dev:^9 drupal/core:^9 drupal/core-composer-scaffold:^9 drupal/core-project-message:^9 -W\"\n

    Or for Drupal 8:

    docker exec -ti esmero-php bash -c \"composer require drupal/core-dev:^8 drupal/core:^8 drupal/core-composer-scaffold:^8 drupal/core-project-message:^8 -W\"\n

    And then for both cases run any Database updates that may be needed:

    docker exec -ti esmero-php bash -c \"drush updatedb\"\n

    This will always get you the latest Drupal and dependencies allowed by your composer.json.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-gitworkflow/#32-drupal-core-between-major-versions","title":"3.2 Drupal Core between major versions:","text":"

    Since major versions may bring larger deprecations, contributed modules will stay behind, and the world (and your database may collapse), we really recommend that you do some tests first (locally) or follow one of our guides. We at Archipelago will always document a larger version update. Currently, the Drupal 8 to Drupal 9 Update is documented in detail here.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback, or open an ISSUE in this Archipelago Deployment Live Repository.

    Return to Archipelago Live Deployment.

    ","tags":["Github"]},{"location":"archipelago-deployment-live-moveToLive/","title":"Moving from archipelago-deployment to archipelago-deployment-live","text":"","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#what-is-this-documentation-for","title":"What is this documentation for?","text":"

    If you have been using/running/populating an instance with Archipelago Digital Objects that was set up using our simpler-to-deploy but harder-to-customize archipelago-deployment strategy and can't wait to move to this one\u2014meant for a larger (and somehow easier to maintain and upgrade on the long run) instance\u2014but (wait!) you do not want to ingest again, set up again, configure users, etc. (You already did that!), this is your documentation.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#what-is-this-documentation-not-for","title":"What is this documentation not for?","text":"

    To install an archipelago-deployment-live from scratch or to keep (forever) syncing between the two deployment options in a quantum phase shifting eternum like a time crystal.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#requirements","title":"Requirements","text":"
    • An instance of Archipelago (working, tested) installed using archipelago-deployment as a basis.
    • Basic knowledge and instincts on how to run Terminal Commands, copy files, run composer, drush, Linux Permissions, and git of course.
    • Patience. You can't skip steps here. Also, Patience again since you may have stretched (good) your current instance to do way more than we thought it could.
    • Time to read the main Documentation of this Repo to have a basic knowledge of how this is deployed. Recommended even if you are not going to deploy one from scratch here.
    • For Shell Commands documented here please copy line by line\u2014not the whole block.
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#differences-between-both-deployments-strategies","title":"Differences between both deployments strategies.","text":"

    In a nutshell: archipelago-deployment-live uses a different folder structure moving configuration storage, data storage outside of your webroot, and allows a much finer control of your settings (safer) and Docker containers. In a nutshell inside the first nutshell: archipelago-deployment-live also ignores more files so keeping customized versions, your own packages, your own settings around, and version controlled is much easier. Lastly: archipelago-deployment-live makes more use of Cloud Services, e.g. so if you have been running min.io as local mounted storage you may now consider moving storage (files) to a cloud service like AWS S3.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#commonalities-between-both-deployment-strategies","title":"Commonalities between both deployment strategies.","text":"

    In a nutshell: Since both run the same code and use the same Docker Containers, the data is actually the same. Everything is just persisted in different places.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#getting-the-new-repo-in-place","title":"Getting the new repo in place","text":"

    First you need to clone this repository and (hopefully) store in the same parent folder to your current archipelago-deployment one. For the purpose of this tutorial we will assume you have archipelago-deployment cloned in this location: $HOME/archipelago-deployment.

    Locate your archipelago-deployment folder in your terminal. Do an ls to make sure you can see the folder (not the content) and run:

    git clone https://github.com/esmero/archipelago-deployment-live\ncd archipelago-deployment-live\ngit checkout 1.0.0-RC3\ncd ..\ncd archipelago-deployment\n

    Now you have side by side $HOME/archipelago_deployment and $HOME/archipelago-deployment-live.

    This will give you the base structure.

    Before touching anything let's start by generating a backup of your current deployment (safety first).

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#backing-up","title":"Backing up","text":"","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-1","title":"Step 1:","text":"

    Shut down your docker-compose ensemble. Inside your original archipelago-deployment folder run this:

    docker-compose down\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-2","title":"Step 2:","text":"

    Verify all containers are actually down:

    docker ps\n

    The following command should return an empty listing. If anything is still running, wait a little longer and run the previous command again.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-3","title":"Step 3:","text":"

    Now let's tar.gz the whole ensemble with data and configs. As an example we will save this into your $HOME folder. As a good practice we append the current date (YEAR-MONTH-DAY) to the filename. Here we assume today is December 1st of 2021:

    sudo tar -czvpf $HOME/archipelago-deployment-backup-20211201.tar.gz ../archipelago-deployment\n

    The process may take a few minutes. Now let's verify that all is there and that the tar.gz is not corrupt:

    tar -tvvf $HOME/archipelago-deployment-backup-20211201.tar.gz \n

    You will see a listing of files. If corrupt (do you have enough space? did your ssh connection drop?) you will see:

    tar: Unrecognized archive format\n

    Done! If you are running a public instance we can allow ourselves to start Docker again to avoid downtime:

    docker-compose up -d\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#the-directory-structures","title":"The directory structures","text":"

    Now that you backed all up we can spend some minutes looking at both directory structures.

    If you observe both deployment strategies side by side you will inmediately notice the most important similarities and also differences:

    archipelago-deployment Live archipelago-deployment 
    .\n\u251c\u2500\u2500 config_storage\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifconfig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 nginxconfig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 nginxconfig_selfcert\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 php-fpm\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 solrconfig\n\u251c\u2500\u2500 data_storage\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 db\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifcache\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiiftmp\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 letsencrypt\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 minio-data\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ngnixcache\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 selfcert\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 solrcore\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 solrlib\n\u251c\u2500\u2500 deploy\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 azure-kubernetes\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ec2-docker\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 kubernetes\n\u251c\u2500\u2500 docs\n\u2514\u2500\u2500 drupal\n\u2502   \u251c\u2500\u2500 config\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 d8content\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 docs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 drush\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 patches\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 persistent\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 private\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 scripts\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 vendor\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 web\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 xdebug\n
    .\n\u251c\u2500\u2500 config\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 sync\n\u251c\u2500\u2500 d8content\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 metadatadisplays\n\u251c\u2500\u2500 docs\n\u251c\u2500\u2500 drush\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Commands\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 sites\n\u251c\u2500\u2500 nginxconfigford8\n\u251c\u2500\u2500 patches\n\u251c\u2500\u2500 persistent\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 db\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifcache\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifconfig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 miniodata\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 solrconfig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 solrcore\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 solrlib\n\u251c\u2500\u2500 private\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 webform\n\u251c\u2500\u2500 scripts\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 archipelago\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 composer\n\u251c\u2500\u2500 vendor\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 archipelago\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 asm89\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 aws\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 behat\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 bin\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 brick\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 chi-teck\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 composer\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 consolidation\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 container-interop\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 cweagans\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 data-values\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 dflydev\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 doctrine\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 drupal\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 drush\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 easyrdf\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 egulias\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 enlightn\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 erusev\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 evenement\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ezyang\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 fabpot\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 fileeye\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 firebase\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 frictionlessdata\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 google\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 graham-campbell\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 grasmash\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 guzzlehttp\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 instaclick\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 jcalderonzumba\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 jean85\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 jmikola\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 justinrainbow\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 laminas\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 league\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 lsolesen\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 maennchen\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 markbaker\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 masterminds\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 mglaman\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 mhor\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 mikey179\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 mixnode\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ml\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 monolog\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 mtdowling\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 myclabs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 nesbot\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 nette\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 nikic\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 paragonie\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 pear\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phar-io\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phenx\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpdocumentor\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phplang\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpmailer\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpoffice\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpoption\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpseclib\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpspec\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpstan\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 phpunit\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 professional-wiki\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 psr\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 psy\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ralouphie\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ramsey\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 react\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 sebastian\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 seld\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 sirbrillig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 solarium\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 squizlabs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 stack\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 strawberryfield\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 swaggest\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 symfony\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 symfony-cmf\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 theseer\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 twbs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 twig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 typo3\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 vlucas\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 web64\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 webflo\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 webmozart\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 wikibase\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 wikimedia\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 zaporylie\n\u251c\u2500\u2500 web\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 core\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 libraries\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 modules\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 profiles\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 sites\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 themes
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#the-data","title":"The Data","text":"

    Let's start by focusing on the data, in our case the Database, Solr, and File (S3 + Private) storage. Collapsing here a few folders will make this easier to read. Marked with a * are matching folders that contain DB, Solr Core, the S3 min.io data (if you are using local storage) and also Drupal's very own private folder:

    archipelago-deployment Live archipelago-deployment 
    .\n\u251c\u2500\u2500 config_storage\n\u251c\u2500\u2500 data_storage\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * db *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifcache\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiiftmp\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 letsencrypt\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * minio-data *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 ngnixcache\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 selfcert\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 solrcore\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 solrlib\n\u251c\u2500\u2500 deploy\n\u251c\u2500\u2500 docs\n\u2514\u2500\u2500 drupal\n\u2502   \u251c\u2500\u2500 config\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 d8content\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 docs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 drush\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 patches\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 persistent\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * private *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 scripts\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 vendor\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 web\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 xdebug\n
    .\n\u251c\u2500\u2500 config\n\u251c\u2500\u2500 d8content\n\u251c\u2500\u2500 docs\n\u251c\u2500\u2500 drush\n\u251c\u2500\u2500 nginxconfigford8\n\u251c\u2500\u2500 patches\n\u251c\u2500\u2500 persistent\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * db *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifcache\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 iiifconfig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * miniodata *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 solrconfig\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * solrcore *\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 solrlib\n\u251c\u2500\u2500 * private *\n\u251c\u2500\u2500 scripts\n\u251c\u2500\u2500 vendor\n\u251c\u2500\u2500 web\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#copying-the-data-into-the-new-structure","title":"Copying the Data into the new Structure","text":"

    To do so we need to stop Docker again. This is needed because Databases sometimes keep an open Change Log and Locks in place, and if there is any interaction or cron running, your data may end up corrupted.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-1_1","title":"Step 1:","text":"

    Shut down your docker-compose ensemble. Inside your original archipelago-deployment folder run this:

    docker-compose down\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-2_1","title":"Step 2:","text":"

    Verify all containers are actually down:

    docker ps\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-3_1","title":"Step 3:","text":"

    We will copy DB, min.io (File and ADO storage as files) and Drupal's private (temporary files, caches) folders to its new place:

    sudo cp -rpv persistent/db ../archipelago-deployment-live/data_storage/db\nsudo cp -rpv persistent/solrcore ../archipelago-deployment-live/data_storage/solrcore\nsudo cp -rpv persistent/miniodata ../archipelago-deployment-live/data_storage/minio-data\nsudo cp -rpv private ../archipelago-deployment-live/drupal/private\n

    Running -rpv will copy verbosely and recursively while preserving original permissions.

    Done!

    You can now start docker-compose again:

    docker-compose up -d\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#the-web","title":"The Web","text":"

    Collapsing again a few folders to aid in readability, we can now focus on your actual Drupal/Archipelago Code/Web and settings. To be honest (we are), you can easily reinstall and restore all this via composer, but we can also move folders as a learning experience/time and bandwidth experience. Marked with a * are matching folders you want to copy over:

    archipelago-deployment Live archipelago-deployment 
    .\n\u251c\u2500\u2500 config_storage\n\u251c\u2500\u2500 data_storage\n\u251c\u2500\u2500 deploy\n\u251c\u2500\u2500 docs\n\u2514\u2500\u2500 drupal\n\u2502   \u251c\u2500\u2500 * config *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 d8content\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 docs\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 drush\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 patches\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 persistent\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 private\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 scripts\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * vendor *\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 * web *\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 xdebug\n
    .\n\u251c\u2500\u2500 * config *\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 sync\n\u251c\u2500\u2500 d8content\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 metadatadisplays\n\u251c\u2500\u2500 docs\n\u251c\u2500\u2500 drush\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 Commands\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 sites\n\u251c\u2500\u2500 nginxconfigford8\n\u251c\u2500\u2500 patches\n\u251c\u2500\u2500 persistent\n\u251c\u2500\u2500 private\n\u251c\u2500\u2500 scripts\n\u251c\u2500\u2500 * vendor *\n\u251c\u2500\u2500 * web *\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#copying-the-web-into-the-new-structure","title":"Copying the Web into the new Structure","text":"

    No need to stop Docker again. We can do this while your Archipelago is still running.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#step-1_2","title":"Step 1:","text":"

    We will copy all important folders over. From your archipelago-deployment folder run:

    sudo cp -rpv vendor ../archipelago-deployment-live/drupal/vendor\nsudo cp -rpv web ../archipelago-deployment-live/drupal/web\nsudo cp -rpv config ../archipelago-deployment-live/drupal/config\n

    And also, selectively, a few files we know you are very fond of!

    sudo cp -rpv composer.json ../archipelago-deployment-live/drupal/composer.json\nsudo cp -rpv composer.lock ../archipelago-deployment-live/drupal/composer.lock\n

    Done!

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#ssl-enviromentals-configurations-settings-and-docker","title":"SSL, Enviromentals, Configurations, Settings and Docker","text":"

    We are almost done, but archipelago-deployment-live has a different, safer way of defining SSL Certs, credentials, and global settings for your Archipelago. We will start first by copying settings as they are (most likely not very safe), and then we can update passwords/etc. to make your system better-prepared for the world.

    To learn more about these general settings please read this section of the parent Documentation (who likes duplicated documentation? Nobody.). The gist here is (after reading, please do not skip) that we need to add our service definitions into a .env file.

    Coming from archipelago-deployment means and assumes that you are running AWS Linux 2 using the suggested locations in this document, that you have a vanilla deployment, and that you followed these instructions) so your values for $HOME/archipelago-deployment-live/deploy/ec2-docker/.env will be the following:

    ARCHIPELAGO_ROOT=/home/ec2-user/archipelago-deployment-live\nARCHIPELAGO_EMAIL=your@validemail.org\nARCHIPELAGO_DOMAIN=your.domain.org\nMINIO_ACCESS_KEY=minio\nMINIO_SECRET_KEY=minio123\nMYSQL_ROOT_PASSWORD=esmero-db\nMINIO_BUCKET_MEDIA=archipelago\nMINIO_FOLDER_PREFIX_MEDIA=/\nMINIO_BUCKET_CACHE=archipelago\nMINIO_FOLDER_PREFIX_CACHE=/\n

    If you plan on staying on local storage driven min.io, MINIO_BUCKET_CACHE and MINIO_FOLDER_PREFIX_CACHE are not going to be used. If you are planning on moving your Storage from local to cloud driven please replace with the right values, e.g. AWS IAM keys and Secrets + bucket names and prefixes (folders). Again, refer to the parent Documentation for setting this up.

    Once you have that in place (Double-check. If something goes wrong here we can always fine-tune and fix again.), we need to decide on a new docker-compose file, and you may need to customize it depending on your choices and current and future needs.

    If you already have an SSL certificate, and it's provided by CertBot you can either copy the certs from your current system (will totally depend on your setup since archipelago-deployment does not provide out-of-the-box SSL Certs) to $HOME/archipelago-deployment-live/data_storage/letsencrypt.

    A normal folder structure for that is:

    .\n\u251c\u2500\u2500 accounts\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 acme-v02.api.letsencrypt.org\n\u2502\u00a0\u00a0     \u2514\u2500\u2500 directory\n\u2502\u00a0\u00a0         \u2514\u2500\u2500 cac9f8218ef18e4f11ec053785bbf648\n\u2502\u00a0\u00a0             \u251c\u2500\u2500 meta.json\n\u2502\u00a0\u00a0             \u251c\u2500\u2500 private_key.json\n\u2502\u00a0\u00a0             \u2514\u2500\u2500 regr.json\n\u251c\u2500\u2500 archive\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 your.domain.org\n\u2502\u00a0\u00a0  \u00a0\u00a0 \u251c\u2500\u2500 cert1.pem\n\u2502\u00a0\u00a0  \u00a0\u00a0 \u251c\u2500\u2500 chain1.pem\n\u2502\u00a0\u00a0  \u00a0\u00a0 \u251c\u2500\u2500 fullchain1.pem\n\u2502\u00a0\u00a0  \u00a0\u00a0 \u2514\u2500\u2500 privkey1.pem\n\u2502\u00a0\n\u251c\u2500\u2500 csr\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 0000_csr-certbot.pem\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 0001_csr-certbot.pem\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 0002_csr-certbot.pem\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 0003_csr-certbot.pem\n\u251c\u2500\u2500 keys\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 0000_key-certbot.pem\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 0001_key-certbot.pem\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 0002_key-certbot.pem\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 0003_key-certbot.pem\n\u251c\u2500\u2500 live\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 README\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 your.domain.org\n\u2502\u00a0\u00a0 \u00a0\u00a0 \u251c\u2500\u2500 cert.pem -> ../../archive/your.domain.org/cert1.pem\n\u2502\u00a0\u00a0 \u00a0\u00a0 \u251c\u2500\u2500 chain.pem -> ../../archive/your.domain.org/chain1.pem\n\u2502\u00a0\u00a0 \u00a0\u00a0 \u251c\u2500\u2500 fullchain.pem -> ../../archive/your.domain.org/fullchain1.pem\n\u2502\u00a0\u00a0 \u00a0\u00a0 \u251c\u2500\u2500 privkey.pem -> ../../archive/your.domain.org/privkey1.pem\n\u2502\u00a0\u00a0 \u00a0\u00a0 \u2514\u2500\u2500 README\n\u251c\u2500\u2500 renewal\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 your.domain.org.conf\n\u2502\u00a0\u00a0 \n\u2514\u2500\u2500 renewal-hooks\n    \u251c\u2500\u2500 deploy\n    \u251c\u2500\u2500 post\n    \u2514\u2500\u2500 pre\n

    Or if your SSL cert is up for renewal, you can just let Archipelago request it for you. Renewal will happen auto-magically, and you may never ever need to worry about that in the future.

    Finally, let's adapt the docker-compose file we need to our previous (but still current!) archipelago-deployment reality.

    For x86/AMD, run (for ARM64/Apple M1 please check the parent Documentation):

    cp $home/archipelago-deployment-live/deploy/ec2-docker/docker-compose-aws-s3.yml $home/archipelago-deployment-live/deploy/ec2-docker/docker-compose.yml\nnano $home/archipelago-deployment-live/deploy/ec2-docker/docker-compose.yml\n

    And replace the content with this slightly modified version. Note: we really only changed the lines after this comment: # THIS DIFFERS FROM THE NORMAL ONE....

    # Run docker-compose up -d\n\nversion: '3.5'\nservices:\n  web:\n    container_name: esmero-web\n    image: staticfloat/nginx-certbot\n    restart: always\n    environment:\n      CERTBOT_EMAIL: ${ARCHIPELAGO_EMAIL}\n      ENVSUBST_VARS: FQDN\n      FQDN: ${ARCHIPELAGO_DOMAIN}\n    ports:\n      - \"80:80\"\n      - \"443:443\"\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/config_storage/nginxconfig/conf.d:/etc/nginx/user.conf.d\n      - ${ARCHIPELAGO_ROOT}/config_storage/nginxconfig/certbot_extra_domains:/etc/nginx/certbot/extra_domains:ro\n      - ${ARCHIPELAGO_ROOT}/drupal:/var/www/html:cached\n      - ${ARCHIPELAGO_ROOT}/data_storage/ngnixcache:/var/cache/nginx\n      - ${ARCHIPELAGO_ROOT}/data_storage/letsencrypt:/etc/letsencrypt\n    depends_on:\n      - solr\n      - php\n      - db\n    tty: true\n    networks:\n      - host-net\n      - esmero-net\n  php:\n    container_name: esmero-php\n    restart: always\n    image: \"esmero/php-7.4-fpm:1.0.0-RC2-multiarch\"\n    tty: true\n    networks:\n      - host-net\n      - esmero-net\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/config_storage/php-fpm/www.conf:/usr/local/etc/php-fpm.d/www.conf\n      - ${ARCHIPELAGO_ROOT}/drupal:/var/www/html:cached\n    environment:\n      MINIO_ACCESS_KEY: ${MINIO_ACCESS_KEY}\n      MINIO_SECRET_KEY: ${MINIO_SECRET_KEY}\n      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}\n      MINIO_BUCKET_MEDIA: ${MINIO_BUCKET_MEDIA}\n      MINIO_FOLDER_PREFIX_MEDIA: ${MINIO_FOLDER_PREFIX_MEDIA}\n  solr:\n    container_name: esmero-solr\n    restart: always\n    image: \"solr:8.8.2\"\n    tty: true\n    ports:\n      - \"8983:8983\"\n    networks:\n      - host-net\n      - esmero-net\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/data_storage/solrcore:/var/solr/data\n      - ${ARCHIPELAGO_ROOT}/config_storage/solrconfig:/drupalconfig\n      - ${ARCHIPELAGO_ROOT}/data_storage/solrlib:/opt/solr/contrib/archipelago/lib\n    entrypoint:\n      - docker-entrypoint.sh\n      - solr-precreate\n      - drupal\n      - /drupalconfig\n  db:\n    image: mysql:8.0.22\n    command: mysqld --default-authentication-plugin=mysql_native_password  --max_allowed_packet=256M\n    container_name: esmero-db\n    restart: always\n    environment:\n      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}\n    networks:\n      - host-net\n      - esmero-net\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/data_storage/db:/var/lib/mysql\n  nlp:\n    container_name: esmero-nlp\n    restart: always\n    image: \"esmero/esmero-nlp:1.0\"\n    ports:\n      - \"6400:6400\"\n    networks:\n      - host-net\n      - esmero-net\n  iiif:\n    container_name: esmero-cantaloupe\n    image: \"esmero/cantaloupe-s3:4.1.9RC\"\n    restart: always\n    ports:\n      - \"8183:8182\"\n    networks:\n      - host-net\n      - esmero-net\n    environment:\n      AWS_ACCESS_KEY_ID: ${MINIO_ACCESS_KEY}\n      AWS_SECRET_ACCESS_KEY: ${MINIO_SECRET_KEY}\n      # THIS DIFFERS FROM THE STANDARD ONE AND ENABLES LOCAL FILESYSTEM CACHE INSTEAD OF AWS S3 one\n      CACHE_SERVER_DERIVATIVE: FilesystemCache\n      S3SOURCE_BASICLOOKUPSTRATEGY_BUCKET_NAME: ${MINIO_BUCKET_MEDIA}\n      S3SOURCE_BASICLOOKUPSTRATEGY_PATH_PREFIX: ${MINIO_FOLDER_PREFIX_MEDIA}\n      S3CACHE_BUCKET_NAME: ${MINIO_BUCKET_CACHE} \n      S3CACHE_OBJECT_KEY_PREFIX: ${MINIO_FOLDER_PREFIX_CACHE} \n      XMS: 2g\n      XMX: 4g\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/config_storage/iiifconfig:/etc/cantaloupe\n      - ${ARCHIPELAGO_ROOT}/data_storage/iiifcache:/var/cache/cantaloupe\n      - ${ARCHIPELAGO_ROOT}/data_storage/iiiftmp:/var/cache/cantaloupe_tmp\n  minio:\n    container_name: esmero-minio\n    restart: always\n    image: minio/minio:latest\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/data_storage/minio-data:/data:cached\n    ports:\n      - \"9000:9000\"\n      - \"9001:9001\"\n    networks:\n      - host-net\n      - esmero-net\n    environment:\n      MINIO_HTTP_TRACE: /tmp/minio-log.txt\n      MINIO_ROOT_USER: ${MINIO_ACCESS_KEY}\n      MINIO_ROOT_PASSWORD: ${MINIO_SECRET_KEY}\n      MINIO_ACCESS_KEY: ${MINIO_ACCESS_KEY}\n      MINIO_SECRET_KEY: ${MINIO_SECRET_KEY}\n      # THIS DIFFERS FROM THE STANDARD ONE AND ENABLES LOCAL MINIO INSTEAD OF AWS S3 one \n    command: server /data --console-address \":9001\"\nnetworks:\n  host-net:\n    driver: bridge\n  esmero-net:\n    driver: bridge\n    internal: true\n

    Press CNTRL-X, and you are done. Now the final test!!

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-moveToLive/#shutdown-the-old-one-start-the-new-one","title":"Shutdown the old one, start the new one","text":"

    So we are ready. Testing may be a hit-or-miss thing here. Did we cover all the steps? Did a command fail? The good thing is that we can start the new ensemble, and all our old ones will survive. And we can come back over and over until we are ready. Let's try!

    We will start by shutting down the running Docker ensemble:

    cd $HOME/archipelago-deployment\ndocker-compose down\n

    Now let's go to our new deployment. Docker starts here in a different folder:

    cd $HOME/archipelago-deployment-live/deploy/ec2-docker\ndocker-compose up\n

    You may notice that we removed the -d. Why? We want to see all the messages and notice/mark/copy any errors, e.g. did the SSL CERT load correctly? Did the MYSQL import work out? To avoid shutting it down while all starts, please open another Terminal and type:

    docker ps\n

    And look at the up-times. Do you see any Containers restarting (where Created and the Status differ for a lot and Status keeps resetting to 0?)? A healthy deployment will look similar to this:

    CONTAINER ID   IMAGE                                    COMMAND                  CREATED          STATUS         PORTS                                      NAMES\nf794c25db64c   esmero/cantaloupe-s3:4.1.9RC2-arm64      \"sh -c 'java -Dcanta\u2026\"   6 seconds ago    Up 3 seconds   0.0.0.0:8183->8182/tcp                     esmero-cantaloupe\n5b791445720f   jonasal/nginx-certbot                    \"/docker-entrypoint.\u2026\"   6 seconds ago    Up 3 seconds   0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp   esmero-web\ne38fbbd86edf   esmero/esmero-nlp:1.0.1-RC2-arm64        \"/usr/local/bin/entr\u2026\"   11 seconds ago   Up 6 seconds   0.0.0.0:6400->6400/tcp                     esmero-nlp\nc84a0a4d43e9   minio/minio:latest                       \"/usr/bin/docker-ent\u2026\"   11 seconds ago   Up 6 seconds   0.0.0.0:9000-9001->9000-9001/tcp           esmero-minio\n3ec176a960c3   esmero/php-7.4-fpm:1.0.0-RC2-multiarch   \"docker-php-entrypoi\u2026\"   11 seconds ago   Up 6 seconds   9000/tcp                                   esmero-php\ne762ad7ea5e2   solr:8.8.2                               \"docker-entrypoint.s\u2026\"   11 seconds ago   Up 6 seconds   0.0.0.0:8983->8983/tcp                     esmero-solr\n381166d61f8c   mariadb:10.5.10-focal                    \"docker-entrypoint.s\u2026\"   11 seconds ago   Up 6 seconds   3306/tcp      \n

    If you feel that all seems to be fine, open a browser window and visit your website. See if you can log in and see ADOs. If not you can momentarily shut down this new Docker ensemble and restart the older one. Nothing is lost! Then with time and tea/coffee and fresh eyes come back and re-trace your steps. 95% of the issues are incorrect values in the .env file. The other 5% may be on us. If you run into any trouble please get in touch!

    Happy deploying!

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback, or open an ISSUE in this Archipelago Deployment Live Repository.

    Return to Archipelago Live Deployment.

    ","tags":["Archipelago-deployment","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/","title":"Archipelago Deployment Live","text":"

    A Cloud / Local production ready Archipelago Deployment using Docker and soon Kubernetes.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#what-is-this-repo-for","title":"What is this repo for?","text":"

    Running Archipelago Commons on a live public instance using SSL with Blob/Object Storage backend

    • Cloud-based deployment, e.g. AWS/Azure under Linux
    • Self-managed servers running Linux
    • x86/AMD86 or ARM64/v8 CPU architectures
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#what-is-this-repo-not-for","title":"What is this repo not for?","text":"
    • Running your own local/development Archipelago. For that we suggest using https://github.com/esmero/archipelago-deployment
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#requirements","title":"Requirements","text":"","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#minimal-not-recommended-for-production","title":"Minimal (not recommended for production)","text":"
    • 4 Gbytes of RAM (e.g AWS EC2 t3.medium) 2 CPUs, Single SSD Drive of 100 Gbytes
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#base-line-for-production","title":"Base line for production","text":"
    • 8 Gbytes of RAM (AWS EC2 t3.medium) 2 CPUs, Single SSD Drive of 100 Gbytes, optional: one magnetic Drive of 500 Gbytes for Caches/Temp files/Backups.
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#recommended-for-production","title":"Recommended for production","text":"
    • 16 Gbytes of RAM (AWS EC2 m6g.xlarge - Graviton) 4 CPUs, Single SSD Drive of 200 Gbytes, optional: one magnetic Drive of 1TB for Caches/Temp files/Backups.
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#os","title":"OS:","text":"
    • Ubuntu 22.04 /Amazon Linux 2 or Amazon Linux 2023/Debian 10 \"Buster\"/ AlmaLinux (Centos replacement) matching your CPU architecture (of course)
    • Most recent Docker running as a service and docker-compose or docker compose
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#skills-and-the-important-human-aspect","title":"Skills and the important human aspect","text":"
    • Basic Unix/Linux terminal skills and a root/sudo account
    • Docker basics knowledge and how to manage packages in your System
    • Knowledge of how to manage AWS/Azure or any other cloud-based provider for Computing Instances and S3 compatible Object Storage system and the associated permissions credentials to do so.
    • To be patient. Please read everything. Do not skip steps. Do not only copy and paste commands. Explanations give context and might help you troubleshoot issues.

    Basically this guide is meant for humans with basic to medium DevOps background or humans with patience that are willing to troubleshoot, ask, and try again when that background is not (yet) enough. And we are here to help.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#deployment-on-linuxx86amd-system","title":"Deployment on Linux/X86/AMD system","text":"","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-1","title":"Step 1:","text":"

    Deploy your base system

    Make sure your Firewall/AWS Security group has these ports open for everyone to access

    • 443 (NGINX SSL)
    • 80 (NGINX HTTP) And protected/modally open for your own development/testing/administration
    • 8183 (Cantaloupe)
    • 8983 (Solr)
    • 6400 (NLP64)
    • 9001 (Minio)
    • 22 (so you can ssh into your machine)

    Setup your system using your favorite package manager with

    • Docker
    • git
    • htop
    • tree
    • docker-compose or docker compose (V2) if running the most recent docker service. See https://docs.docker.com/compose/migrate/

    e.g. for Amazon Linux 2 (x86/amd64) these steps are tested:

    sudo yum update -y\nsudo amazon-linux-extras install -y docker\nsudo service docker start\nsudo usermod -a -G docker ec2-user\nsudo chkconfig docker on\nsudo systemctl enable docker\nsudo yum install -y git htop tree\nsudo curl -L \"https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)\" -o /usr/local/bin/docker-compose\nsudo chmod +x /usr/local/bin/docker-compose\nsudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose\nsudo reboot\n

    Reboot is needed to allow Docker to take full control over your OS resources.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-2","title":"Step 2:","text":"

    In your location of choice clone this repo

    git clone https://github.com/esmero/archipelago-deployment-live\ncd archipelago-deployment-live\ngit checkout 1.3.0\n
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-3-setup-your-enviromental-variables-for-dockerservices","title":"Step 3. Setup your enviromental variables for Docker/Services","text":"","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#setup-enviromentals","title":"Setup Enviromentals","text":"

    Setup your deployment enviromental variables by copying the template

    cp deploy/ec2-docker/.env.template deploy/ec2-docker/.env\n
    and editing it

    nano deploy/ec2-docker/.env\n

    The content of that file would be similar to this. Note: There are a few extra commented lines at the end only used for: https://docs.archipelago.nyc/1.3.0/security_bots/ if you decide to go that way.

    ARCHIPELAGO_ROOT=/home/ec2-user/archipelago-deployment-live\nARCHIPELAGO_EMAIL=your@validemail.org\nARCHIPELAGO_DOMAIN=your.domain.org\nMINIO_ACCESS_KEY=THE_S3_AZURE_OR_LOCAL_MINIO_KEY\nMINIO_SECRET_KEY=THE_S3_AZURE_OR_LOCAL_MINIO_SECRET\nMYSQL_ROOT_PASSWORD=YOUR_MYSQL_PASSWORD_FOR_ARCHIPELAGO\nMINIO_BUCKET_MEDIA=THE_NAME_OF_YOUR_S3_BUCKET_FOR_PERSISTEN_STORAGE\nMINIO_FOLDER_PREFIX_MEDIA=media/\nMINIO_BUCKET_CACHE=THE_NAME_OF_YOUR_S3_BUCKET_FOR_IIIF_STORAGE\nMINIO_FOLDER_PREFIX_CACHE=iiifcache/\nREDIS_PASSWORD=YOUR_REDIS_PASSWORD\n

    What does each key mean?

    • ARCHIPELAGO_ROOT: the absolute path to your archipelago-deployment-live git repo in your host machine.
    • ARCHIPELAGO_EMAIL: a valid email, will be used to register your SSL Certificate via Certbot.
    • ARCHIPELAGO_DOMAIN: a valid domain name for your repository. This domain will be also used to request your SSL Certificate via Certbot.
    • MINIO_ACCESS_KEY: If you are running a Cloud Service backed S3/Azure Storage this needs to be generated there. The user/IAM owner of this ACCESS KEY needs to have access to read/write the bucket you will configure in this same .env. If running local min.io whatever you set will be used.
    • MINIO_SECRET_KEY: If you are running a Cloud Service backed S3/Azure Storage this needs to generated there. The user/IAM owner of the matching SECRET_KEY needs to have access to read/write the bucket you will configure in this same .env file. If running local min.io whatever you set will be used.
    • MYSQL_ROOT_PASSWORD: The MYSQL 8 or Mariadb 15 password. This password will be used later also during Drupal deployment via drush
    • MINIO_BUCKET_MEDIA: The name of your Persistant Storage Bucket. If using mini.io local we recommend keeping it simple, e.g. archipelago.
    • MINIO_FOLDER_PREFIX_MEDIA: The folder (a prefix really) where your DO Storage and File storage will go inside the MINIO_BUCKET_MEDIA Bucket. media/ is a fine name for this one and common in archipelago deployments. IMPORTANT: Always terminate these with a /.
    • MINIO_BUCKET_CACHE: The name of your IIIF Cache storage Bucket. May be the same as MINIO_BUCKET_MEDIA. If different make sure your your MINIO_ACCESS_KEY and/or IAM role ACL have permission to read write to this one too.
    • MINIO_FOLDER_PREFIX_CACHE: The folder (a prefix really) where Cantaloupe will/can write its iiif caches. iiifcache/ is a lovely name we use a lot. IMPORTANT: Always terminate these with a /.
    • REDIS_PASSWORD: Password for your REDIS (Drupal Cache/Queue storage) if you decide to enable the Drupal REDIS module.

    IMPORTANT NOTE: For AWS EC2. If you selected an IAM role for your server when setting it up/deploying it, min.io will use the AWS EC2-backed internal API to request access to your S3. This means the ROLE itself needs to have read/write access (ACL) to the given Bucket(s) and your key/secrets won't be able to override that. Please do not ignore this note. It will save you a LOT of frustration and coffee. You can also run an EC2 instace without a given IAM and in that case just the ACCESS_KEY/SECRET will matter.

    Now that you know, you also know that these values should not be shared and this .env file should not be committed/kept in version control. Please be careful.

    docker-compose will read this .env and start all services for you based on its content.

    Once you have modified this you are ready for your first big decision.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#running-a-fully-qualified-domain-you-wish-a-validsigned-certificate-for-amdintel-architecture","title":"Running a fully qualified domain you wish a valid/signed certificate for AMD/INTEL Architecture?","text":"

    This means you will use the docker-compose-aws-s3.yml. Do the following:

    cp deploy/ec2-docker/docker-compose-aws-s3.yml deploy/ec2-docker/docker-compose.yml\n
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#running-a-fully-qualified-domain-you-wish-a-validsigned-certificate-for-arm64apple-m1-architecture","title":"Running a fully qualified domain you wish a valid/signed certificate for ARM64/Apple M1 Architecture?","text":"

    This means you will use the docker-compose-aws-s3-arm64.yml. Do the following:

    cp deploy/ec2-docker/docker-compose-aws-s3-arm64.yml deploy/ec2-docker/docker-compose.yml\n
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#optional-expert-extra-domains-does-not-apply-to-arm64apple-m1-architecture","title":"Optional (expert) extra domains (does not apply to ARM64/Apple M1 Architecture):","text":"

    If you have more than a single domain you may create a text file inside config_storage/nginxconfig/certbot_extra_domains/your.domain.org and write for each subdomain there an entry/line.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#or-running-self-signed-optional-and-does-not-apply-to-arm64apple-m1-architecture","title":"OR Running self-signed? (optional and does not apply to ARM64/Apple M1 Architecture):","text":"

    Only if you are not running a fully qualified domain you wish a valid/signed. We really DO not recommend this route. IF you plan on using this deployment for local testing or running on non SSL please go for https://github.com/esmero/archipelago-deployment which delivers the same experience in less than 20 minutes deployment time.

    Generate a self signed Cert

    sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout data_storage/selfcert/private/nginx.key -out data_storage/selfcert/certs/nginx.crt \nsudo openssl dhparam -out data_storage/selfcert/dhparam.pem 4096\ncp deploy/ec2-docker/docker-compose-selfsigned.yml deploy/ec2-docker/docker-compose.yml\n

    Note: Self signed docker-compose.yml file is setup to use min.io with local storage

        volumes:\n      - ${ARCHIPELAGO_ROOT}/data_storage/minio-data:/data:cached\n

    This folder will be created by min.io. If you are using a secondary Drive (e.g. magnetic) you can modify your deploy/ec2-docker/docker-compose.yml to use a folder there, e.g.

        volumes:\n      - /persistentinotherdrive/data_storage/minio-data:/data:cached\n

    Make sure your logged in user can read/write to it.

    NOTE: If you want to use AWS S3 storage for the self signed version replace the minio Service yaml block with this Service Block in your new deploy/ec2-docker/docker-compose.yml. You can mix and match services and even remove all :cached statements for improved R/W volumen performance.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-4-first-run","title":"Step 4. First Run","text":"","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#first-permissions","title":"First Permissions","text":"
    sudo chown 8183:8183 config_storage/iiifconfig/cantaloupe.properties\nsudo chown -R 8183:8183 data_storage/iiifcache\nsudo chown -R 8183:8183 data_storage/iiiftmp\nsudo chown -R 8983:8983 data_storage/solrcore\n
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#actual-first-run","title":"Actual first run","text":"

    Time to spin our docker containers for the first time. We will start all without going into background so log/error checking is easier, especially if you have selected a Valid/Signed Cert choice and also want to be sure S3 keys/access are working.

    cd deploy/ec2-docker\ndocker-compose up\n

    You will see a lot of things happening. Check for errors/problems/clear alerts and give all a minute or so to start. Ok, let's assume your setup managed to request a valid signed SSL cert, you will see a nice message!

    - Congratulations! Your certificate and chain have been saved at:XXXXX\n   Your certificate will expire on 20XX-XX-XX. To obtain a new or\n   tweaked version of this certificate in the future, simply run\n   certbot again. To non-interactively renew *all* of your\n   certificates, run \"certbot renew\"\n

    Archipelago will do that for you whenever it's about to expire so no need to deal with this manually, even when docker-compose restarts.

    Now press CTRL+C. docker-compose will shutdown gracefully. Good!

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-5-deploy-drupal-10","title":"Step 5. Deploy Drupal 10","text":"","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#composer-and-drupal","title":"Composer and Drupal","text":"

    Copy the shipped default composer.default.json to composer.json and composer.default.lock to composer.lock (ONLY if you are installing from scratch):

    cp ../../drupal/composer.default.json ../../drupal/composer.json\ncp ../../drupal/composer.default.lock ../../drupal/composer.lock\n

    Start Docker again

    docker-compose up -d\n

    Wait a few seconds and run:

    docker exec -ti esmero-php bash -c \"chown -R www-data:www-data private\"\ndocker exec -ti esmero-php bash -c \"chown -R www-data:www-data web/sites\"\ndocker exec -ti esmero-php bash -c \"composer install\"\n

    Composer install will take a little while and bring all your PHP libraries.

    Once done, execute our setup script that will prepare your Drupal settings.php and bring some of the .env enviromental variables to the Drupal environment. 

    docker exec -ti esmero-php bash -c 'scripts/archipelago/setup.sh'\n

    And now you can deploy Drupal!

    IMPORTANT: Make sure you replace in the following command inside root:MYSQL_ROOT_PASSWORD the MYSQL_ROOT_PASSWORD string with the value you used/assigned in your .env file for MYSQL_ROOT_PASSWORD. And replace ADMIN_PASSWORD with a password that is safe and you won't forget! That passwords is for your Drupal super user (uid:0).

    docker exec -ti -u www-data esmero-php bash -c \"cd web;../vendor/bin/drush -y si --verbose --existing-config --db-url=mysql://root:MYSQL_ROOT_PASSWORD@esmero-db/drupal --account-name=admin --account-pass=ADMIN_PASSWORD -r=/var/www/html/web --sites-subdir=default --notify=false;drush cr;chown -R www-data:www-data sites;\"\n
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-6-users-and-initial-content","title":"Step 6. Users and initial Content.","text":"

    After installation is done (may take a few) you can install initial users and assign them roles. Copy each line separately. A missing permission will not let you ingest the initial Metadata Displays and AMI set.

    docker exec -ti esmero-php bash -c 'drush ucrt demo --password=\"demo\"; drush urol metadata_pro \"demo\"'\n
    docker exec -ti esmero-php bash -c 'drush ucrt jsonapi --password=\"jsonapi\"; drush urol metadata_api \"jsonapi\"'\n
    docker exec -ti esmero-php bash -c 'drush urol administrator \"admin\"'\n

    Before ingesting the base content we need to make sure we can access your JSON-API on for your new domain. That means we need to change internal urls (https://esmero-web) to the new valid SSL driven ones. This is easy:

    On your host machine (no need to docker exec these ones), replace first in the following command your.domain.org with the domain you setup in your .env file. Go to (cd into) your base git clone folder (Important: YOUR BASE CLONE FOLDER) and then run

     sed -i 's/http:\\/\\/esmero-web/https:\\/\\/your.domain.org/g' drupal/scripts/archipelago/deploy.sh\n sed -i 's/http:\\/\\/esmero-web/https:\\/\\/your.domain.org/g' drupal/scripts/archipelago/update_deployed.sh\n

    Now your deploy.sh and update_deployed.sh are update and ready. Let's ingest some Twig Templates, an AMI Set, menus and a Blocks.

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    IMPORTANT: update_deployed.sh is not needed when deploying for the first time and totally discouraged on a customized Archipelago. If you make modifications to your Twig templates, that command will replace the ones shipped by us with fresh copies overwriting all your modifications. Only run to restore larger errors or when needing to update everything ones with newer versions and you don't care for your own customization. Please read https://docs.archipelago.nyc/1.3.0/utility_scripts/ for more ways of managing exporting/importing Metadata Display Entities (Twig templates).

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#step-7-set-your-public-iiif-server-url-to-your-actual-domain","title":"Step 7. Set your public IIIF server URL to your actual domain","text":"

    By default archipelago ships with a public facing and an internal facing IIIF Server URLs configured. These urls are used by a number of IIIF enabled viewers and need to be changed to reflect your new reality (a real Domain name and a proxied path!). These settings belong to the strawberryfield/format_strawberryfield module.

    First check your current settings:

    docker exec -ti esmero-php bash -c \"drush config-get format_strawberryfield.iiif_settings\"\n

    You will see the following:

    pub_server_url: 'http://localhost:8183/iiif/2'\nint_server_url: 'http://esmero-cantaloupe:8182/iiif/2'\n

    Let's modify pub_server_url. Replace in the following command your.domain.org with the domain you defined in your .env file. NOTE: We are passing the -y flag to drush avoid that way having to answer \"yes\".

    docker exec -ti esmero-php bash -c \"drush -y config-set format_strawberryfield.iiif_settings pub_server_url https://your.domain.org/cantaloupe/iiif/2\"\n

    Finally Done! Now you can log into your new Archipelago using https and start exploring. Thank you for following this guide!

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#deployment-on-arm64v8graviton-apple-m1-system","title":"Deployment on ARM64/v8(Graviton, Apple M1) system:","text":"

    This applies to AWS m6g and t3g Instances and is documented inline in this guide. Please open an ISSUE in this repository if you run into any problems. Please review https://github.com/esmero/archipelago-deployment-live/blob/1.3.0/deploy/ec2-docker/docker-compose-aws-s3-arm64.yml for more info.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#how-do-i-know-my-architecture","title":"How do I know my Architecture?","text":"

    Run 

    uname -m \n
    • For an x86(64 bit) processor system output will be x86_64
    • For an ARM(64 bit) processor system output will be aarch64
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Lund
    • Giancarlo Birello
    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#acknowledgments","title":"Acknowledgments","text":"

    This software is a Metropolitan New York Library Council Open-Source initiative and part of the Archipelago Commons project.

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-readme/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-updatingContainers/","title":"How to update your Docker containers","text":"

    From time to time you may have a need to update the containers themselves. Primarily this is done for security releases.

    ","tags":["Github","Docker","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-updatingContainers/#1-update-docker-composeyml","title":"1. Update docker-compose.yml","text":"

    The first thing you need to do is to edit your docker-compose.yml file and replace the version of the container with the new one you wish to use.

    Navigate to your docker-compose.yml file and open it to edit. On Debian installs it would look like this:

      cd /usr/local/archipelago/deploy/archipelago-deployment-live/deploy/ec2-docker\n  vi docker-compose.yml\n

    You want to change the image line to reflect the name of the new image you wish to use:

    image: esmero/php-7.4-fpm:1.0.0-RC3-multiarch\n

    might become:

    image: esmero/php-8.0-fpm:1.1.0-multiarch\n

    Save your change. If use vi like in the above it would look like this:

      :wq\n
    ","tags":["Github","Docker","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-updatingContainers/#pull-the-new-images","title":"Pull the new image(s)","text":"

    Docker Compose will now allow us to grab the new image(s) while your current system is running:

      docker-compose pull\n
    ","tags":["Github","Docker","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-updatingContainers/#stop-and-restart-the-container","title":"Stop and restart the container","text":"

    It is necesary to stop and start the container or the current image will continue to be used:

      docker-compose stop container-name\n

    Wait for it to stop. Then bring it back up:

    docker-compose up -d \n

    It is important to use the -d flag or you will have your live instance stuck in your terminal. You want it to run in the background. The -d flag stands for detached.

    ","tags":["Github","Docker","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-updatingContainers/#down-and-up","title":"Down and up","text":"

    If you are more comfortable having the all the containers go down and up you can do that with the following:

    docker-compose down\ndocker-compose up\n

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback, or open an ISSUE in this Archipelago Deployment Live Repository.

    Return to Archipelago Live Deployment.

    ","tags":["Github","Docker","Archipelago-deployment-live"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/","title":"Archipelago-deployment-live: upgrading Drupal 8 to Drupal 9 (1.0.0-RC2 to 1.0.0-RC3)","text":"","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#what-is-this-documentation-for","title":"What is this documentation for?","text":"

    If you already have a well-set-up and well-loved Archipelago (RC2 or your own custom version) running Drupal 8 (D8), this documentation will allow you to update to Drupal 9 (D9) without major issues.

    D8 is no longer supported as of the end of November 2021. D9 has been around for a little while and even if every module is not supported yet, what you need and want for Archipelago has long been D9-ready.

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#requirements","title":"Requirements","text":"
    • An archipelago-deployment-live instance 1.0.0-RC2 (working, tested) deployed using provided instructions via Docker and running Drupal 8.
    • Basic knowledge and instincts (+ courage) on how to run Terminal Commands, composer and drush.
    • Patience. You can't skip steps here.
    • For Shell Commands documented here please copy line by line\u2014not the whole block.
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#backing-up-and-preparing-for-the-upgrade","title":"Backing up and preparing for the upgrade","text":"

    Backups are always going to be your best friends. Archipelago's code, database and settings are mostly self-contained in your current archipelago-deployment-live repo folder, and backing up is simple because of that.

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-1","title":"Step 1:","text":"

    Shut down your docker-compose ensemble. Move to your archipelago-deployment-live folder and run this:

    cd deploy/ec2-docker\ndocker-compose down\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-2","title":"Step 2:","text":"

    Verify that all containers are actually down. The following command should return an empty listing. If anything is still running, wait a little longer, and run the following comman again.

    docker ps\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-3","title":"Step 3:","text":"

    Now let's tar.gz the whole ensemble with data and configs. As an example we will save this into your $HOME folder. As a good practice we append the current date (YEAR-MONTH-DAY) to the filename. Here we assume today is December 1st of 2021.

    sudo tar -czvpf $HOME/archipelago-deployment-live-backup-20211201.tar.gz ../../../archipelago-deployment-live\n

    The process may take a few minutes. Now let's verify that all is there and that the tar.gz is not corrupt.

    tar -tvvf $HOME/archipelago-deployment-live-backup-20211201.tar.gz\n

    You will see a listing of files. If corrupt (Do you have enough space? Did your ssh connection drop?) you will see the following:

    tar: Unrecognized archive format\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-4","title":"Step 4:","text":"

    Restart your docker-compose ensemble, and wait a little while for all to start.

    docker-compose up -d\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-5","title":"Step 5:","text":"

    Export/backup all of your live Archipelago configurations (this allows you to compare/come back in case you lose something custom during the upgrade).

    docker exec esmero-php mkdir config/backup\ndocker exec esmero-php drush cex --destination=/var/www/html/config/backup\n

    Good. Now it's safe to begin the upgrade.

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#upgrading-to-100-rc3","title":"Upgrading to 1.0.0-RC3","text":"","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-1_1","title":"Step 1:","text":"

    First we are going to disable modules that are not part of 1.0.0-RC3 or are not yet compatible with D9. Run the following command:

    docker exec esmero-php drush pm-uninstall module_missing_message_fixer markdown webprofiler key_value webform_views\n

    From inside your archipelago-deployment-live repo folder we are going to open up the file permissions for some of your most protected Drupal files.

    cd ../../\nsudo chmod 777 drupal/web/sites/default\nsudo chmod 666 drupal/web/sites/default/*settings.php\nsudo chmod 666 drupal/web/sites/default/*services.yml\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-2_1","title":"Step 2:","text":"

    Time to fetch the 1.0.0-RC3 branch and update our docker-compose and composer dependencies. We are also going to stop the current docker ensemble to update all containers to newer versions:

    cd deploy/ec2-docker\ndocker-compose down\ngit checkout 1.0.0-RC3\n

    Then copy the appropriate docker-compose file for your architecture:

    OSX (macOS)/x86-64 
    cp docker-compose-osx.yml docker-compose.yml\n
    Linux/x86-64/AMD64 
    cp docker-compose-linux.yml docker-compose.yml\n
    OSX (macOS)/Linux/ARM64 
    cp docker-compose-arm64.yml docker-compose.yml\n

    Finally, pull the images, and bring up the ensemble:

    docker compose pull\ndocker compose up -d\n

    Give all a little time to start. The latest min.io adds a new console, and your Solr core and Database need to be upgraded. Please be patient. To ensure all is well, run (more than once if necessary) the following:

    docker ps\n

    You should see something like this:

    CONTAINER ID   IMAGE                                    COMMAND                  CREATED          STATUS          PORTS                                                           NAMES\n867fd2a42134   nginx                                    \"/docker-entrypoint.\u2026\"   32 seconds ago   Up 27 seconds   0.0.0.0:8001->80/tcp, :::8001->80/tcp                           esmero-web\n8663e84a9b48   solr:8.8.2                               \"docker-entrypoint.s\u2026\"   33 seconds ago   Up 30 seconds   0.0.0.0:8983->8983/tcp, :::8983->8983/tcp                       esmero-solr\n9b580fa0088f   minio/minio:latest                       \"/usr/bin/docker-ent\u2026\"   33 seconds ago   Up 28 seconds   0.0.0.0:9000-9001->9000-9001/tcp, :::9000-9001->9000-9001/tcp   esmero-minio\n50e2f41c7b60   esmero/esmero-nlp:1.0                    \"/usr/local/bin/entr\u2026\"   33 seconds ago   Up 30 seconds   0.0.0.0:6400->6400/tcp, :::6400->6400/tcp                       esmero-nlp\n300810fd6f03   esmero/cantaloupe-s3:4.1.9RC             \"sh -c 'java -Dcanta\u2026\"   33 seconds ago   Up 30 seconds   0.0.0.0:8183->8182/tcp, :::8183->8182/tcp                       esmero-cantaloupe\n248e4638ba2a   mysql:8.0.22                             \"docker-entrypoint.s\u2026\"   33 seconds ago   Up 28 seconds   3306/tcp, 33060/tcp                                             esmero-db\n141ace919344   esmero/php-7.4-fpm:1.0.0-RC2-multiarch   \"docker-php-entrypoi\u2026\"   33 seconds ago   Up 28 seconds   9000/tcp                                                        esmero-php\n

    Important here is the STATUS column. It needs to be a number that goes up in time every time you run docker ps again (and again).

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-3_1","title":"Step 3:","text":"

    Now we are going to tell composer to actually fetch the new code and dependencies using the 1.0.0-RC3 provided composer.lock and update the whole Drupal/PHP/JS environment.

    docker exec -ti esmero-php bash -c \"composer install\"\n

    This will fail (sorry!) for a few packages but no worries, they need to be patched and composer is not that smart. So simply run it again:

    docker exec -ti esmero-php bash -c \"composer install\"\n

    Well done! If you see no issues and all ends in a Green colored message all is good! Jump to Step 4

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#what-if-not-all-is-ok-and-i-see-red-and-a-lot-of-dependency-explanations","title":"What if not all is OK and I see red and a lot of dependency explanations?","text":"

    If you have manually installed packages via composer in the past that are NO longer Drupal 9 compatible you may see errors. In that case you need to check each package website's (normally https://www.drupal.org/project/the_module_name) and check if there is a Drupal 9 compatible version.

    If so run:

    docker exec -ti esmero-php bash -c \"composer require 'drupal/the_module_name:^VERSION_NUMBER_THAT_WORKS_ON_DRUPAL9_' --update-with-dependencies --no-update\" and run **Step 3 ** again (and again until all is cleared)\n

    If not: try to find a replacement module that does something simular, but in any case you may end having to remove before proceding. Give us a ping/slack/google group/open a github ISSUE if you find yourself uncertain about this.

    docker exec -ti esmero-php bash -c \"composer remove drupal/the_module_name --no-update\"\ndocker exec -ti esmero-php bash -c \" drush pm-uninstall the_module_name\"\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-4_1","title":"Step 4:","text":"

    We will now ask Drupal to update some internal configs and databases. They will bring you up to date with RC3 settings and D9 particularities.

    docker exec -ti esmero-php bash -c 'scripts/archipelago/setup.sh'\ndocker exec -ti esmero-php bash -c 'drush urol administrator \"admin\"'\ndocker exec -ti esmero-php bash -c \"drush updatedb\"\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-5_1","title":"Step 5:","text":"

    Previously D8 installations had a \"module/profile\" driven installation. Those are no longer used or even exist as part of core, but a profile can't be changed once installed so you have to do the following to avoid Drupal complaining about our new and simpler way of doing things (a small roll back):

    docker exec -ti esmero-php bash -c \"sed -i 's/minimal: 1000/standard: 1000/g' config/sync/core.extension.yml\"\ndocker exec -ti esmero-php bash -c \"sed -i 's/profile: minimal/profile: standard/g' config/sync/core.extension.yml\"\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-6","title":"Step 6:","text":"

    Now you can Sync your new Archipelago 1.0.0-RC3 and bring all the new configs and settings in. For this you have two options (no worries, remember you made a backup!):

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#a-partial-sync-which-will-bring-new-configs-and-update-existing-ones-but-will-not-remove-ones-that-only-exist-in-your-custom-setup-eg-new-webforms-or-view-modes","title":"A Partial Sync, which will bring new configs and update existing ones but will not remove ones that only exist in your custom setup, e.g. new Webforms or View Modes.","text":"
    docker exec esmero-php drush cim -y --partial\n
    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#a-complete-sync-which-will-bring-new-configs-and-update-existing-ones-but-will-also-remove-all-the-ones-that-are-not-part-of-rc3-its-a-like-clean-factory-reset","title":"A Complete Sync, which will bring new configs and update existing ones but will also remove all the ones that are not part of RC3. It's a like clean factory reset.","text":"
    docker exec esmero-php drush cim -y\n

    If all goes well here and you see no errors it's time to reindex Solr because there are new Fields. Run the following:

    docker exec esmero-php drush search-api-reindex\ndocker exec esmero-php drush search-api-index\n

    You might see some warnings related to modules dealing with previously non-existent data\u2014no worries, just ignore those.

    If you made it this far you are done with code/devops (are we ever ready?), and that means you should be able to (hopefully) stay in the Drupal 9 realm for a few years!

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromD8ToD9/#step-7-update-or-not-your-metadata-display-entities-and-menu-items","title":"Step 7: Update (or not) your Metadata Display Entities and Menu items.","text":"

    Recommended: If you want to add new templates and menu items 1.0.0-RC3 provides, run this:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    Once that is done, you can choose to update all Metadata Displays (Twig templates) we ship with new 1.0.0-RC3 versions (heavily fixed IIIF manifest, Markdown to HTML for Metadata, better Object descriptions). But before you do this, we really recommend that you first make sure to manually (copy/paste) backup any Twig templates you have modified. If unusure, do not run the command that comes after this warning! You can always manually copy the new templates from the d8content/metadatadisplays folder which contains text versions (again, copy/paste) of each shipped template you can pick and use when you feel ready.

    If you are sure (like really?) you want to overwrite the ones you modified (sure, just checking?), then you can run this:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/update_deployed.sh'\n

    Done! (For realz now)

    Please log into your Archipelago and test/check all is working! Enjoy 1.0.0-RC3 and Drupal 9. Thanks!

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback, or open an ISSUE in this Archipelago Deployment Live Repository.

    Return to Archipelago Live Deployment.

    ","tags":["Archipelago-deployment-live","Drupal 8","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/","title":"Archipelago-deployment-live: upgrading from 1.0.0-RC3 to 1.0.0","text":"","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#what-is-this-documentation-for","title":"What is this documentation for?","text":"

    If you already have a well-set-up and well-loved Archipelago (RC3 or your own custom version) running Drupal 9, this documentation will allow you to update to 1.0.0 without major issues.

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#requirements","title":"Requirements","text":"
    • An archipelago-deployment-live instance 1.0.0-RC3 (working, tested) deployed using provided instructions via Docker and running Drupal 9.
    • Basic knowledge and instincts (+ courage) on how to run Terminal Commands, composer and drush.
    • Patience. You can't skip steps here.
    • For Shell Commands documented here please copy line by line\u2014not the whole block.
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#backing-up-and-preparing-for-the-upgrade","title":"Backing up and preparing for the upgrade","text":"

    Backups are always going to be your best friends. Archipelago's code, database and settings are mostly self-contained in your current archipelago-deployment-live repo folder, and backing up is simple because of that.

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-1","title":"Step 1:","text":"

    Shut down your docker-compose ensemble. Move to your archipelago-deployment-live folder and run this:

    cd deploy/ec2-docker\ndocker-compose down\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-2","title":"Step 2:","text":"

    Verify that all containers are actually down. The following command should return an empty listing. If anything is still running, wait a little longer, and run the following comman again.

    docker ps\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-3","title":"Step 3:","text":"

    Now let's tar.gz the whole ensemble with data and configs. As an example we will save this into your $HOME folder. As a good practice we append the current date (YEAR-MONTH-DAY) to the filename. Here we assume today is December 1st of 2021.

    sudo tar -czvpf $HOME/archipelago-deployment-live-backup-20220803.tar.gz ../../../archipelago-deployment-live\n

    The process may take a few minutes. Now let's verify that all is there and that the tar.gz is not corrupt.

    tar -tvvf $HOME/archipelago-deployment-live-backup-20220803.tar.gz \n

    You will see a listing of files. If corrupt (Do you have enough space? Did your ssh connection drop?) you will see the following:

    tar: Unrecognized archive format\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-4","title":"Step 4:","text":"

    Restart your docker-compose ensemble, and wait a little while for all to start.

    docker-compose up -d\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-5","title":"Step 5:","text":"

    Export/backup all of your live Archipelago configurations (this allows you to compare/come back in case you lose something custom during the upgrade).

    docker exec esmero-php mkdir config/backup\ndocker exec esmero-php drush cex --destination=/var/www/html/config/backup\n

    Good. Now it's safe to begin the upgrade.

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#upgrading-to-100","title":"Upgrading to 1.0.0","text":"","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-1_1","title":"Step 1:","text":"

    First we are going to disable modules that are not part of 1.0.0 or are not yet compatible with Drupal 9.4.x or higher . Run the following command:

    docker exec esmero-php drush pm-uninstall search_api_solr_defaults entity_reference\n

    From inside your archipelago-deployment-live repo folder we are going to open up the file permissions for some of your most protected Drupal files.

    cd ../../\nsudo chmod 777 drupal/web/sites/default\nsudo chmod 666 drupal/web/sites/default/*settings.php\nsudo chmod 666 drupal/web/sites/default/*services.yml\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-2_1","title":"Step 2:","text":"

    First let's back up our current composer.lock:

    cp drupal/composer.lock drupal/composer.original.lock\n

    Time to fetch the 1.0.0 branch and update our docker-compose and composer dependencies. We are also going to stop the current docker ensemble to update all containers to newer versions:

    cd deploy/ec2-docker\ndocker-compose down\ngit fetch\ngit checkout 1.0.0 \n

    If you decide to enable the Drupal REDIS module, make sure to add the REDIS_PASSWORD variable to your .env file.

    IMPORTANT NOTE: For AWS EC2. If you selected an IAM role for your server when setting it up/deploying it, min.io will use the AWS EC2-backed internal API to request access to your S3. This means the ROLE itself needs to have read/write access (ACL) to the given Bucket(s) and your key/secrets won't be able to override that. Please do not ignore this note. It will save you a LOT of frustration and coffee. You can also run an EC2 instance without a given IAM and in that case just the ACCESS_KEY/SECRET will matter.

    Now that you know, you also know that these values should not be shared and this .env file should not be committed/kept in version control. Please be careful.

    Now let's back up the existing docker-compose file:

    cp docker-compose.yml docker-compose-original.yml\n

    Then copy the appropriate docker-compose file for your architecture:

    Linux/x86-64/AMD64 
    cp docker-compose-aws-s3.yml docker-compose.yml\n
    Linux/ARM64/Apple Silicon (M1 and M2) 
    cp docker-compose-aws-s3-arm64.yml docker-compose.yml\n

    Next, let's review what's changed in case any customizations need to be brought into the new docker-compose configurations:

    git diff --no-index docker-compose-original.yml docker-compose.yml\n

    You should encounter something like the following:

    diff --git a/docker-compose-original.yml b/docker-compose.yml\nindex 6f5b17e..282417f 100644\n--- a/docker-compose-original.yml\n+++ b/docker-compose.yml\n@@ -1,5 +1,5 @@\n # Run docker-compose up -d\n-\n+# Docker file for AMD64/X86 machines\n version: '3.5'\n services:\n   web:\n@@ -23,6 +23,7 @@ services:\n       - solr\n       - php\n       - db\n+      - redis\n     tty: true\n     networks:\n       - host-net\n@@ -30,7 +31,7 @@ services:\n   php:\n     container_name: esmero-php\n     restart: always\n-    image: \"esmero/php-7.4-fpm:1.0.0-RC2-multiarch\"\n+    image: \"esmero/php-8.0-fpm:1.1.0-multiarch\"\n     tty: true\n     networks:\n       - host-net\n@@ -44,10 +45,11 @@ services:\n       MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}\n       MINIO_BUCKET_MEDIA: ${MINIO_BUCKET_MEDIA}\n       MINIO_FOLDER_PREFIX_MEDIA: ${MINIO_FOLDER_PREFIX_MEDIA}\n+      REDIS_PASSWORD: ${REDIS_PASSWORD}\n   solr:\n     container_name: esmero-solr\n     restart: always\n-    image: \"solr:8.8.2\"\n+    image: \"solr:8.11.2\"\n

    As you can see, most of the changes in this example are for new images and a new service/container/environment variable (REDIS), but you may have custom settings for your containers. Review any differences carefully and make adjustments as needed.

    Finally, pull the images:

    docker compose pull \n

    1.0.0 provides a new Cantaloupe that uses different permissions so we need to adapt those. From your current folder (../ec2-deploy) run:

    sudo chown 8183:8183 ../../config_storage/iiifconfig/cantaloupe.properties\nsudo chown -R 8183:8183 ../../data_storage/iiifcache\nsudo chown -R 8183:8183 ../../data_storage/iiiftmp\n

    Time to start the ensemble again

    docker compose up -d\n

    Give all a little time to start. Solr core and Database need to be upgraded, Cantaloupe is new and this brings also Redis for caching. Please be patient. To ensure all is well, run (more than once if necessary) the following:

    docker ps\n

    You should see something like this: e.g if running on ARM64 You should see something like this: 

    CONTAINER ID   IMAGE                                    COMMAND                  CREATED          STATUS          PORTS                                                           NAMES\n4ed2f62e866e   jonasal/nginx-certbot                      \"/docker-entrypoint.\u2026\" 32 seconds ago   Up 27 seconds   0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp   esmero-web\ne6b4383039c3   minio/minio:RELEASE.2022-06-11T19-55-32Z   \"/usr/bin/docker-ent\u2026\" 33 seconds ago   Up 30 seconds   0.0.0.0:9000-9001->9000-9001/tcp, :::9000-9001->9000-9001/tcp              esmero-minio\nf2b6b173b7e2   solr:8.11.2                                \"docker-entrypoint.s\u2026\" 33 seconds ago   Up 28 seconds   0.0.0.0:8983->8983/tcp, :::8983->8983/tcp                                  esmero-solr\na553bf484343   esmero/php-8.0-fpm:1.0.0-multiarch         \"docker-php-entrypoi\u2026\" 33 seconds ago   Up 30 seconds   9000/tcp                                                                   esmero-php\necb47349ae94   esmero/esmero-nlp:fasttext-multiarch       \"/usr/local/bin/entr\u2026\" 33 seconds ago   Up 30 second    0.0.0.0:6400->6400/tcp, :::6400->6400/tcp                                  esmero-nlp\n61272dce034a   redis:6.2-alpine                           \"docker-entrypoint.s\u2026\" 33 seconds ago   Up 28 seconds                                                                              esmero-redis\n0ee9869f809b   esmero/cantaloupe-s3:6.0.0-multiarch       \"sh -c 'java -Dcanta\u2026\" 33 seconds ago   Up 28 seconds   0.0.0.0:8183->8182/tcp, :::8183->8182/tcp                                  esmero-cantaloupe\n131d072567ce   mariadb:10.6.8-focal                       \"docker-entrypoint.s\u2026\" 33 seconds ago   Up 28 seconds   3306/tcp                                                                   esmero-db                                            esmero-php\n

    Important here is the STATUS column. It needs to be a number that goes up in time every time you run docker ps again (and again).

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-3_1","title":"Step 3:","text":"

    Instead of using the provided composer.default.lock out of the box we are going to loosen certain dependencies and bring manually Archipelago modules, all this to make update easier and future upgrades less of a pain.

    First, as a sanity check let's make sure nothing happened to our original composer.lock fileby doing a diff against our backed up file:

    git diff --no-index ../../drupal/composer.original.lock ../../drupal/composer.lock\n

    If all is ok, there should be no output. If there's any output, copy your backed up file back to default:

    cp ../../drupal/composer.original.lock ../../drupal/composer.lock\n

    Finally, we bring over the modules:

    docker exec -ti esmero-php bash -c \"composer require drupal/core:^9 drupal/core-composer-scaffold:^9 drupal/core-project-message:^9 drupal/core-recommended:^9\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/core-dev:^9 --dev\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/tokenuuid:^2\"\ndocker exec -ti esmero-php bash -c \"composer require 'drupal/facets:^2.0'\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/moderated_content_bulk_publish:^2\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/queue_ui:^3.1\"\ndocker exec -ti esmero-php bash -c \"composer require drupal/jquery_ui_touch_punch:^1.1\"\ndocker exec -ti esmero-php bash -c \"composer require archipelago/ami:0.4.0.x-dev strawberryfield/format_strawberryfield:1.0.0.x-dev strawberryfield/strawberryfield:1.0.0.x-dev strawberryfield/strawberry_runners:0.4.0.x-dev strawberryfield/webform_strawberryfield:1.0.0.x-dev drupal/views_bulk_operations:^4.1\"\n

    Now we are going to tell composer to actually fetch the new code and dependencies using composer.lock and update the whole Drupal/PHP/JS environment.

    docker exec -ti esmero-php bash -c \"composer update -W\"\ndocker exec -ti esmero-php bash -c \"drush cr\"\ndocker exec -ti esmero-php bash -c \"drush en jquery_ui_touch_punch\"\ndocker exec -ti esmero-php bash -c \"drush updatedb\"\n

    Well done! If you see no issues and all ends in a Green colored message all is good! Jump to Step 4

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#what-if-not-all-is-ok-and-i-see-red-and-a-lot-of-dependency-explanations","title":"What if not all is OK and I see red and a lot of dependency explanations?","text":"

    If you have manually installed packages via composer in the past that are NO longer Drupal 9 compatible you may see errors. In that case you need to check each package website's (normally https://www.drupal.org/project/the_module_name) and check if there is a Drupal 9 compatible version.

    If so run:

    docker exec -ti esmero-php bash -c \"composer require 'drupal/the_module_name:^VERSION_NUMBER_THAT_WORKS_ON_DRUPAL9_' --update-with-dependencies --no-update\" and run **Step 3 ** again (and again until all is cleared)\n

    If not: try to find a replacement module that does something simular, but in any case you may end having to remove before proceding. Give us a ping/slack/google group/open a github ISSUE if you find yourself uncertain about this. 

    docker exec -ti esmero-php bash -c \"composer remove drupal/the_module_name --no-update\"\ndocker exec -ti esmero-php bash -c \" drush pm-uninstall the_module_name\"\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-4_1","title":"Step 4:","text":"

    We will now ask Drupal to update some internal configs and databases. They will bring you up to date with 1.0.0 settings and D9 particularities.

    docker exec -ti esmero-php bash -c 'scripts/archipelago/setup.sh'\ndocker exec -ti esmero-php bash -c \"drush updatedb\"\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-5_1","title":"Step 5:","text":"

    Now you can Sync your new Archipelago 1.0.0 and bring all the new configs and settings in. For this you have two options (no worries, remember you made a backup!):

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#a-partial-sync-which-will-bring-new-configs-and-update-existing-ones-but-will-not-remove-ones-that-only-exist-in-your-custom-setup-eg-new-webforms-or-view-modes","title":"A Partial Sync, which will bring new configs and update existing ones but will not remove ones that only exist in your custom setup, e.g. new Webforms or View Modes.","text":"
    docker exec esmero-php drush cim -y --partial\n
    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#a-complete-sync-which-will-bring-new-configs-and-update-existing-ones-but-will-also-remove-all-the-ones-that-are-not-part-of-rc3-its-a-like-clean-factory-reset","title":"A Complete Sync, which will bring new configs and update existing ones but will also remove all the ones that are not part of RC3. It's a like clean factory reset.","text":"
    docker exec esmero-php drush cim -y\n

    If all goes well here and you see no errors it's time to reindex Solr because there are new Fields. Run the following:

    docker exec esmero-php drush search-api-reindex\ndocker exec esmero-php drush search-api-index\n

    You might see some warnings related to modules dealing with previously non-existent data\u2014no worries, just ignore those.

    If you made it this far you are done with code/devops (are we ever ready?), and that means you should be able to (hopefully) stay in the Drupal 9 realm for a few years!

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-live-upgradeFromRC3/#step-7-update-or-not-your-metadata-display-entities-and-menu-items","title":"Step 7: Update (or not) your Metadata Display Entities and Menu items.","text":"

    Recommended: If you want to add new templates and menu items 1.0.0 provides, go to your base Github repo folder, replace in the following commands your.domain.org with the actual domain of your Server and run those individually:

    sed -i 's/http:\\/\\/esmero-web/https:\\/\\/your.domain.org/g' drupal/scripts/archipelago/deploy.sh\n
    sed -i 's/http:\\/\\/esmero-web/https:\\/\\/your.domain.org/g' drupal/scripts/archipelago/update_deployed.sh\n

    Now update your Metadata Display Templates and Blocks

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    Once that is done, you can choose to update all Metadata Displays (Twig templates) we ship with new 1.0.0 versions (heavily fixed IIIF manifest, Markdown to HTML for Metadata, better Object descriptions). But before you do this, we really recommend that you first make sure to manually (copy/paste) backup any Twig templates you have modified. If unusure, do not run the command that comes after this warning! You can always manually copy the new templates from the d8content/metadatadisplays folder which contains text versions (again, copy/paste) of each shipped template you can pick and use when you feel ready.

    If you are sure (like really?) you want to overwrite the ones you modified (sure, just checking?), then you can run this:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/update_deployed.sh'\n

    Done! (For realz now)

    Please log into your Archipelago and test/check all is working! Enjoy 1.0.0. Thanks!

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback, or open an ISSUE in this Archipelago Deployment Live Repository.

    Return to Archipelago Live Deployment.

    ","tags":["Archipelago-deployment-live","Drupal 9"]},{"location":"archipelago-deployment-osx/","title":"Installing Archipelago Drupal 10 on OSX (macOS)","text":"","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#about-running-terminal-commands","title":"About running terminal commands","text":"

    This guide assumes you are comfortable enough running terminal (bash) commands on an OSX Computer.

    We made sure that you can copy and paste each of these commands from this guide directly into your terminal.

    You will notice sometimes commands span more than a single line of text. If that is the case, always make sure you copy and paste a single line at a time and press the Enter key afterwards. We suggest also you look at the output.

    If something fails (and we hope it does not) troubleshooting will be much easier if you can share that output when asking for help.

    Happy deploying!

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#osx-macos","title":"OSX (macOS):","text":"
    • Install Docker for Mac
    • For OSX (macOS) Ventura or Higher on Intel (i5/i7) and Apple Silicon Chips (M1/M2/M3) the tested version is: 4.23.0(120376). You may go newer of course.
    • In Preferences -> General: check Use gRPC FUSE for file sharing and restart. Specially if you are using your $HOME folder for deploying, e.g. /Users/username.
    • In Preferences -> Resources: 4 Gbytes of RAM is the recommended minimun and works; 8 Gbytes is faster and snappier.
    • Install Github Desktop.
    • At least 10 Gbytes of free space (to get started).
    • Being able to open a terminal.

    Note: Recent OSX (macOS) and newer Macs ship with 2 annoying things: Apple Cloud Syncing User Folders and (wait for it) Case insensitive File Systems. If you are happy with your shiny new Mac (like i was) we are aware that it's better to deploy anything mounted outside of the /User folder or even better, in an external drive formatted using a Case Sensitive Unix Filesystem (Mac OS Extended (Case-sensitive, Journaled)).

    Note 2: \"Use gRPC FUSE for file sharing\" experience may vary, recent Docker for Mac does it well. In older RC1 ones it was evil. Changing/Disabling it after having installed Archipelago may affect your S3/Minio storage accessibility. Please let us know what your experience on this is.

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#wait-question-do-you-have-a-previous-version-of-archipelago-running","title":"Wait! Question: Do you have a previous version of Archipelago running?","text":"

    If so, let's give that hard working repository a break first. If not, skip to Step 1:

    • Open a terminal (you have that already right?) and go to your previous download/git clone folder and run:
    docker-compose down\ndocker-compose rm\n
    • Can't remember where you downloaded it? Ok. We can deal with that!

    Let's stop the containers gracefully first, run:

    docker stop esmero-web\ndocker stop esmero-solr\ndocker stop esmero-db\ndocker stop esmero-cantaloupe\ndocker stop esmero-php\ndocker stop esmero-minio\ndocker stop esmero-nlp\n

    Now we need to remove them, run:

    docker rm esmero-web\ndocker rm esmero-solr\ndocker rm esmero-db\ndocker rm esmero-cantaloupe\ndocker rm esmero-php\ndocker rm esmero-minio\ndocker rm esmero-nlp\n

    Ok, now we are ready to start. Depending on what type of Chip your Apple uses you have two options:

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-1-intel-docker-deployment-on-intel-chips-apple-machines","title":"Step 1 (Intel): Docker Deployment on Intel Chips Apple Machines","text":"
    git clone https://github.com/esmero/archipelago-deployment.git archipelago-deployment\ncd archipelago-deployment\ngit checkout 1.3.0\ncp docker-compose-osx.yml docker-compose.yml\ndocker-compose pull\ndocker-compose up -d\n
    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-1-m1-docker-deployment-on-apple-silicon-chips-m1","title":"Step 1 (M1): Docker Deployment on Apple Silicon Chips (M1)","text":"
    git clone https://github.com/esmero/archipelago-deployment.git archipelago-deployment\ncd archipelago-deployment\ngit checkout 1.3.0\ncp docker-compose-arm64.yml docker-compose.yml\ndocker-compose pull\ndocker-compose up -d\n

    Note: If you are running on an Intel Apple Machine from an external Drive or a partition/filesystem that is Case Sensitive and is not syncing automatically to Apple Cloud you can also use docker-compose-linux.yml. Note2: docker-compose.yml is git ignored in case you make local adjustments or changes to it.

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-2-set-up-your-minio-s3-bucket","title":"Step 2: Set up your Minio S3 bucket","text":"

    Once all containers are up and running (you can do a docker ps to check), access the minio console at http://localhost:9001 using your most loved Web Browser with the following credentials:

    user:minio\npass:minio123\n

    and once logged in, press on \"Buckets\" (left tools column) and then on \"Create Bucket\" (top right) and under \"Bucket Name\" type archipelago. Leave all other options unchecked for now (you can experiment with those later), and make sure you write archipelago (no spaces, lowercase) and press \"Save\". Done! That is where we will persist all your Files and also your File copies of each Digital Object. You can always go there and explore what Archipelago (well really Strawberryfield does the hard work) has persisted so you can get comfortable with our architecture.

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-3-deploy-drupal-10-and-the-awesome-archipelago-modules","title":"Step 3: Deploy Drupal 10 and the awesome Archipelago Modules","text":"

    The following will run composer inside the esmero-php container to download all dependencies and Drupal Core too:

    docker exec -ti esmero-php bash -c \"composer install\"\n

    Once that command finishes run our setup script:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/setup.sh'\n

    Explanation: That script will append some important configurations to your local web/sites/default/settings.php.

    Note: We say local because your whole Drupal web root (the one you cloned) is also mounted inside the esmero-php and esmero-web containers. So edits to PHP files, for example, can be done without accessing the container directly from your local folder.

    If this is the first time you deploy Drupal using the provided Configurations run:

    docker exec -ti -u www-data esmero-php bash -c \"cd web;../vendor/bin/drush -y si --verbose --existing-config --db-url=mysql://root:esmerodb@esmero-db/drupal --account-name=admin --account-pass=archipelago -r=/var/www/html/web --sites-subdir=default --notify=false;drush cr;chown -R www-data:www-data sites;\"\n

    Note: You will see these warnings:

    [warning] The \"block_content:9aa72fb1-2817-44a7-8fb5-a3eb51166e83\" was not found [warning] The \"block_content:1cdf7155-eb60-4f27-9e5e-64fffe93127a\" was not found [warning] The \"facets_summary_block:advance\" was not found [warning] The \"facets_summary_block:search_page_facet_summary\" was not found

    Nothing to worry about. We will provide the missing part in Step 5.

    Note 2: Please be patient. This step takes since composer 2.0 25-30% longer because of how the most recent Drupal Installation code fetches translations and other resources (see Performed install task). This means progress might look like getting \"stuck\", go and get a coffee/tea and let it run to the end.

    Once finished, this will give you an admin Drupal user with archipelago as password (Change this if running on a public instance!).

    Final Note about Steps 2-3: You don't need to, nor should you do this more than once. You can destroy/stop/update, recreate your Docker containers, and start again (git pull), and your Drupal and Data will persist once you're past the Installation complete message. I repeat, all other containers' data is persisted inside the persistent/ folder contained in this cloned git repository. Drupal and all its code is visible, editable, and stable inside your web/ folder.

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-4-create-a-demo-and-a-jsonapi-user-using-drush-and-assign-your-admin-user-the-administrator-role","title":"Step 4: Create a \"demo \"and a \"jsonapi\" user using drush and assign your \"admin\" user the Administrator Role.","text":"

    docker exec -ti esmero-php bash -c 'drush ucrt demo --password=\"demo\"; drush urol metadata_pro \"demo\"'\n
    docker exec -ti esmero-php bash -c 'drush ucrt jsonapi --password=\"jsonapi\"; drush urol metadata_api \"jsonapi\"'\n
    docker exec -ti esmero-php bash -c 'drush urol administrator \"admin\"'\n

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-5-ingest-some-metadata-displays-to-make-playing-much-more-interactive","title":"Step 5: Ingest some Metadata Displays to make playing much more interactive","text":"

    Archipelago is more fun without having to start writing Metadata Displays (in Twig) before you know what they actually are. Since you should now have a jsonapi user and jsonapi should be enabled, you can use that awesome functionality of D8 to get that done. We have 4 demo Metadata Display Entities that go well with the demo Webform we provided. To do that execute in your shell (copy and paste):

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    Open your most loved Web Browser and point it to http://localhost:8001.

    Note: It can take some time to start the first time (Drupal needs some warming up).

    Also, to make this docker-compose easier to use we are doing something named bind mounting (or similar...) your folders. The good thing is that you can edit files in your machine, and they get updated instantly to docker. The bad thing is that the OSX (macOS) driver runs slower than on Linux. Speed is a huge factor here, but you get the flexibility of changing, backing up, and persisting files without needing a Docker University Degree.

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#step-6-optional-but-more-fun-if-you-add-content","title":"Step 6: Optional but more fun if you add content","text":"

    One-Step Demo content ingest

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#need-help-blue-screen-missed-a-step-need-a-hug-and-such","title":"Need help? Blue Screen? Missed a step? Need a hug and such?","text":"

    If you see any issues or errors or need help with a step, please let us know (ASAP!). You can either open an issue in this repository or use the Google Group. We are here to help.

    If you like this, let us know!

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Sherrick
    • Giancarlo Birello
    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-osx/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment","Drupal 10","macOS","OSX"]},{"location":"archipelago-deployment-readme/","title":"Archipelago Docker Deployment","text":"

    Updated: January 30th 2024

    Previously Updated: October 31st 2023

    This repository serves as bootstrap for a Archipelago 1.3.0 deployment on a localhost for development/testing/customizing via Docker and provides a more unified experience this time:

    • minio.io (latest with Gateway Support) S3/Azure/Local/Remote alternative with Console.
    • Apache Solr 9.1 with the wizardly Solr OCR Highlight library v0.8.4 built by the Developement Team at the Bavarian State Library. Thanks Johannes Baiter and team.
    • MySQL 8.x (amd64/x86)/MariaDB 10.6.x(Arm64/M1/M2/M3)
    • NGINX 11
    • Custom PHP-FPM 8.1 multi architecture, fine-tuned for Drupal 10 , WARC to WACZ processing, Tesseract 5 with JP2 support, PDFAlto and Composer 2.x, Drush 12, etc
    • Natural Language Processing via NLPWEB64 multi architecture with FastText Language detection (Thanks Mike Bennet!)
    • Cantaloupe 6.0.1 Snapshot multi architecture as IIIF2/3 Server with Video Frame extraction and PDF support (with custom fix for tiled PDF)
    • A Skeleton Project setup to run latest Version of Drupal (10.1.x), our new Bootstrap 5 theme and Strawberry Field modules on 1.3.0 & friends on 0.7.0
    • Complete support for Apple Silicon M1 Machines and in general arm64 architecture Chips like Raspberry Pi 4, with specially built arm64 docker containers. The only differences now between deployment strategies is the DB. Blazing fast OCR.

    The skeleton project contains all the pieces needed to run a local deployment of a vanilla Archipelago including (YES!) content provided as an optional feature from archipelago-recyclables

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#starting-from-zero","title":"Starting from ZERO","text":"

    This is the recommended, simplest way for this release. There are a too many, tons of fun new features, Metadata Displays, Webforms, New formatters and Twig extensions, improved viewers, new and improved JS libraries, OpenCV/Face Detection, smarter NLP, File composting, better HUGE import/update capabilities, bug fixes (yes so many) so please try them out. The team has also updated the DEMO AMI set (Content) to showcase metadata/display improvements.

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#macos-intel-or-apple-silicon-m1m2m3","title":"macOS Intel or Apple Silicon M1/M2/M3:","text":"

    Step by Step deployment on macOS

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#ubuntu-1804-or-2004","title":"Ubuntu 18.04 or 20.04:","text":"

    Step by Step deployment on Ubuntu

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#windows-10-or-11","title":"Windows 10 or 11:","text":"

    Step by Step deployment on Windows

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#more-fun-if-you-add-content","title":"More fun if you add content:","text":"

    One-Step Demo content ingest

    If you like it (or not), want new features, or want to be part of making this better (documenting, coding and planning) let us know. Make your voice and opinion be heard, this is a community effort.

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Sherrick
    • Giancarlo Birello
    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#acknowledgments","title":"Acknowledgments","text":"

    This software is a Metropolitan New York Library Council Open-Source initiative and part of the Archipelago Commons project.

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-readme/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment","Drupal 10","Docker"]},{"location":"archipelago-deployment-ubuntu/","title":"Installing Archipelago Drupal 10 on Ubuntu 18.04 or 20.04","text":"","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#about-running-terminal-commands","title":"About running terminal commands","text":"

    This guide assumes you are comfortable enough running terminal (bash) commands on a Linux Computer.

    We made sure that you can copy and paste each of these commands from this guide directly into your terminal.

    You will notice sometimes commands span more than a single line of text. If that is the case, always make sure you copy and paste a single line at a time and press the Enter key afterwards. We suggest you also look at the output.

    If something fails (and we hope it does not) troubleshooting will be much easier if you can share that output when asking for help.

    Happy deploying!

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#prerequisites","title":"Prerequisites","text":"
    • At least 10 Gbytes of free space (to get started)
    • Some basic Unix/Terminal Skills
    • 2-4 Gbytes of RAM (4 Recommended)
    • Install Docker if you don't have it already by running:
    sudo apt install apt-transport-https ca-certificates curl software-properties-common\ncurl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -\nsudo add-apt-repository \"deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable\"\nsudo apt update\nsudo apt-cache policy docker-ce\nsudo apt install docker-ce\nsudo systemctl status docker\n\nsudo usermod -aG docker ${USER}\n

    Log out, and log in again!

    sudo apt install docker-compose\n

    Git tools are included by default in Ubuntu.

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#wait-question-do-you-have-a-previous-version-of-archipelago-running","title":"Wait! Question: Do you have a previous version of Archipelago running?","text":"

    If so, let's give that hard working repository a break first. If not, Step 1:

    • Open a terminal (you have that already right?) and go to your previous download/git clone folder and run:
    docker-compose down\ndocker-compose rm\n
    • Can't remember where you downloaded it? Ok. We can deal with that!

    Let's stop the containers gracefully first, run:

    docker stop esmero-web\ndocker stop esmero-solr\ndocker stop esmero-db\ndocker stop esmero-cantaloupe\ndocker stop esmero-php\ndocker stop esmero-minio\ndocker stop esmero-nlp\n

    Now we need to remove them so we run the following:

    docker rm esmero-web\ndocker rm esmero-solr\ndocker rm esmero-db\ndocker rm esmero-cantaloupe\ndocker rm esmero-php\ndocker rm esmero-minio\ndocker rm esmero-nlp\n

    Ok, now we are ready to start.

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#step-1-deployment","title":"Step 1: Deployment","text":"","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#prefer-to-watch-a-video-to-see-what-its-like-to-install-go-to-our-user-contributed-documentation1","title":"Prefer to watch a video to see what it's like to install? Go to our user contributed documentation[^1]!","text":"","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#important","title":"IMPORTANT","text":"

    If you run docker-compose as root user (using sudo) some enviromental variables, like the current folder used inside the docker-compose.yml to mount the Volumes, will not work and you will see a bunch of errors.

    There are two possible solutions.

    • The best is to add your user to the docker group (so no sudo needed).
    • The second option is to replace every {$PWD} inside your docker-compose.yml with either the full path to your current folder, or with a . and wrap that whole line in double quotes, basically making the paths for volumes relatives.

    Instead of: - ${PWD}:/var/www/html:cached use: - \".:/var/www/html:cached\"

    Now that you got it, let's deploy:

    git clone https://github.com/esmero/archipelago-deployment.git archipelago-deployment\ncd archipelago-deployment\ngit checkout 1.3.0\n
    cp docker-compose-linux.yml docker-compose.yml\ndocker-compose pull\ndocker-compose up -d\n

    Note: docker-compose.yml is git ignored in case you make local adjustments or changes to it.

    You need to make sure Docker can read/write to your local Drive, a.k.a mounted volumes (especially if you decided not to run it as root because we told you so!).

    This means in practice running:

    sudo chown -R 8183:8183 persistent/iiifcache\nsudo chown -R 8983:8983 persistent/solrcore\n

    And then:

    docker exec -ti esmero-php bash -c \"chown -R www-data:www-data private\"\n

    Question: Why is this last command different? Answer: Just a variation. The long answer is that the internal www-data user in that container (Alpine Linux) has uid:82, but on Ubuntu the www-data user has a different one so we let Docker assign the uid from inside instead. In practice you could also run directly sudo chown -R 82:82 private which would only apply to an Alpine use case, which can differ in the future! Does this make sense? No worries if not.

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#step-2-set-up-your-minio-s3-bucket","title":"Step 2: Set up your Minio S3 bucket","text":"

    Once all containers are up and running (you can do a docker ps to check), access http://localhost:9001 using your most loved Web Browser with the following credentials:

    user:minio\npass:minio123\n

    and create a bucket named \"archipelago\". To do so go to the Buckets section in the navigation pane, and click Create Bucket +. Type archipelago under Bucket Name and submit, done! That is where we will persist all your Files and also your File copies of each Digital Object. You can always go there and explore what Archipelago (well really Strawberryfield does the hard work) has persisted so you can get comfortable with our architecture.

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#step-3-deploy-drupal-10-and-the-awesome-archipelago-modules","title":"Step 3: Deploy Drupal 10 and the awesome Archipelago Modules","text":"

    The following will run composer inside the esmero-php container to download all dependencies and Drupal Core too.

    docker exec -ti esmero-php bash -c \"composer install\"\n

    You might see a warning: Do not run Composer as root/super user! See https://getcomposer.org/root for details and the a long list of PHP packages. Don't worry. All is good here. Keep following the instructions! Once that command finishes run our setup script:

    docker exec -ti esmero-php bash -c 'scripts/archipelago/setup.sh'\n

    Explanation: That script will append some important configurations to your local web/sites/default/settings.php.

    Note: We say local because your whole Drupal web root (the one you cloned) is also mounted inside the esmero-php and esmero-web containers. So edits to PHP files, for example, can be done without accessing the container directly from your local folder.

    If this is the first time you're deploying Drupal using the provided Configurations run:

    docker exec -ti -u www-data esmero-php bash -c \"cd web;../vendor/bin/drush -y si --verbose --existing-config --db-url=mysql://root:esmerodb@esmero-db/drupal --account-name=admin --account-pass=archipelago -r=/var/www/html/web --sites-subdir=default --notify=false;drush cr;chown -R www-data:www-data sites;\"\n

    Note: You will see these warnings:

    [warning] The \"block_content:9aa72fb1-2817-44a7-8fb5-a3eb51166e83\" was not found [warning] The \"block_content:1cdf7155-eb60-4f27-9e5e-64fffe93127a\" was not found [warning] The \"facets_summary_block:advance\" was not found [warning] The \"facets_summary_block:search_page_facet_summary\" was not found

    Nothing to worry about. We will provide the missing part in Step 5.

    Note 2: Please be patient. This step takes now 25-30% longer because of how the most recent Drupal Installation code fetches translations and other resources (see Performed install task). This means progress might look like getting \"stuck\", go and get a coffee/tea and let it run to the end.

    Once finished, this will give you an admin Drupal user with archipelago as password (change this if running on a public instance!) and also set the right Docker Container owner for your Drupal installation files.

    Final note about Steps 2-3: You don't need to, nor should you do this more than once. You can destroy/stop/update, recreate your Docker containers, and start again (git pull), and your Drupal and Data will persist once you've passed the Installation complete message. I repeat, all other containers' data is persisted inside the persistent/ folder contained in this cloned git repository. Drupal and all its code is visible, editable, and stable inside your web/ folder.

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#step-4-create-a-demo-and-a-jsonapi-user-using-drush-and-assign-your-admin-user-the-administrator-role","title":"Step 4: Create a \"demo \"and a \"jsonapi\" user using drush and assign your \"admin\" user the Administrator Role.","text":"

    docker exec -ti esmero-php bash -c 'drush ucrt demo --password=\"demo\"; drush urol metadata_pro \"demo\"'\n
    docker exec -ti esmero-php bash -c 'drush ucrt jsonapi --password=\"jsonapi\"; drush urol metadata_api \"jsonapi\"'\n
    docker exec -ti esmero-php bash -c 'drush urol administrator \"admin\"'\n

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#step-5-ingest-some-metadata-displays-to-make-playing-much-more-interactive","title":"Step 5: Ingest some Metadata Displays to make playing much more interactive","text":"

    Archipelago is more fun without having to start writing Metadata Displays (in Twig) before you know what they actually are. Since you should now have a jsonapi user and jsonapi should be enabled, you can use that awesome functionality of D8 to get that done. We have 4 demo Metadata Display Entities that go well with the demo Webform we provided. To do that execute in your shell (copy and paste):

    docker exec -ti esmero-php bash -c 'scripts/archipelago/deploy.sh'\n

    You are done! Open your most loved Web Browser and point it to http://localhost:8001

    Note: It can take some time to start the first time (Drupal needs some warming up). The Ubuntu deployment is WAY faster than the OSX deployment because of the way the bind mount volumes are handled by the driver. Our experience is that Archipelago basically reacts instantly!

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#step-6-optional-but-more-fun-if-you-add-content","title":"Step 6: Optional but more fun if you add content","text":"

    One-Step Demo content ingest

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#need-help-blue-screen-missed-a-step-need-a-hug","title":"Need help? Blue Screen? Missed a step? Need a hug?","text":"

    If you see any issues or errors or need help with a step, please let us know (ASAP!). You can either open an issue in this repository or use the Google Group. We are here to help.

    If you like this, let us know!

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#user-contributed-documentation-a-video1","title":"User contributed documentation (A Video!)[^1]:","text":"

    Installing Archipelago on AWS Ubuntu by Zach Spalding: https://youtu.be/RBy7UMxSmyQ

    [^1]: You may find this user contributed tutorial video, which was created for an earlier Archipelago release, to be helpful. Please note that there are significant differences between the executed steps and that you need to follow the current release instructions in order to have a successful deployment.

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Sherrick
    • Giancarlo Birello
    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-ubuntu/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment","Drupal 10","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/","title":"Installing Archipelago Drupal 9 on Windows 10/11","text":"","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#prerequisites","title":"Prerequisites","text":"
    • Windows 11 64-bit: Home or Pro version 21H2 or higher, or Enterprise or Education version 21H2 or higher (see Docker for Windows link below).
    • Windows 10 64-bit: Home or Pro 21H1 (build 19043) or higher, or Enterprise or Education 20H2 (build 19042) or higher (see Docker for Windows link below).
    • Install Ubuntu on WSL 2
    • Install Docker for Windows
    • Install Github for Desktop
    • At least 10 Gbytes of free space (to get started)
    • Some basic Unix/Terminal Skills
    • 4 Gbytes of RAM (8 Recommended)
    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#optional","title":"Optional","text":"
    • Install Github Desktop. Ubuntu comes with Git by default, but for a more full-featured way to work with Github, you can install this application.

    Open the Docker Desktop app. The Docker service should start up automatically with a status showing when the service is up and running.

    Open an Ubuntu Terminal session (type Ubuntu in the Windows Start menu).

    Bring everything up to date: sudo apt update && sudo apt upgrade -y

    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#deployment","title":"Deployment","text":"

    Follow the steps for deployment in Ubuntu.

    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#acknowledgment","title":"Acknowledgment","text":"

    Thanks to Corinne Chatnik for documenting these steps!

    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#need-help-blue-screen-missed-a-step-need-a-hug","title":"Need help? Blue Screen? Missed a step? Need a hug?","text":"

    If you see any issues or errors or need help with a step, please let us know (ASAP!). You can either open an issue in this repository or use the Google Group. We are here to help.

    If you like this, let us know!

    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#caring-coding-fixing-testing","title":"Caring & Coding + Fixing + Testing","text":"
    • Diego Pino
    • Allison Lund
    • Giancarlo Birello
    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"archipelago-deployment-windows/#license","title":"License","text":"

    GPLv3

    ","tags":["Archipelago-deployment","Drupal 10","Windows","Ubuntu 18.04","Ubuntu 20.04"]},{"location":"createdisplaymodes/","title":"Creating Display Modes for Archipelago Digital Objects","text":"

    We recommend checking out our primer on Display Modes for a broader overview on Form Modes and View Modes for Archipelago Digital Objects (ADOs).

    But how do you create and enable these Display Modes in the first place? Let's find out.

    "},{"location":"createdisplaymodes/#adding-a-new-form-mode","title":"Adding a new Form Mode","text":"

    Why would you want to create a new form mode? One common reason is to create different data entry experiences for users with different roles. Let's create an example form mode called \"Student Webform\" -- we can imagine a deployment where Students need a simplified form for ADO creation. We are going to create a form mode, enable it for Digital Objects, and give it some custom settings that differentiate it from existing form modes.

    1. Navigate to yoursite/admin/structure/display-modes

    2. Click on Form modes. This image shows the basic Form Modes shipped with Archipelago

    3. Click the \"Add Form mode\" button at the top of the page. Then select the \"Content\" entity type from the list. In this example, we ultimately want the form mode to be applied to Archipelago Digital Objects, which is a Content entity type.

    4. Enter the name of your Form Mode and hit save. Here we are entering \"Student Webform\".

    5. Great. Now you will see your new Form mode in the list! Let's put it to use.

    6. Head to yoursite/admin/structure/types/manage/digital_object and click the \"Manage Form Display\" tab. As mentioned above, in this example we want to add a new Form Mode for ADOs, so we are dealing with the Digital Object content type. Scroll to the bottom of this page and look for the \"Custom Display Settings\" area, which is collapsed by default. Expand it, and you should see this.

    7. Enable \"Student Webform\" and hit save! Now scroll back up the page. You'll see it enabled like so.

    8. Now select our new \"Student Webform\" tab. From here, you have many options and can configure input fields as you see fit! To finish out our specific example though, let's finally add our Student Webform to the display. Click on the settings gear icon next to the Descriptive Metadata field.

      You'll see that the default webform named \"Descriptive Metadata\" is entered. To add custom content to this Field Widget, start typing in the autocomplete. This example assumes you've created a webform called Student Webform in yoursite/admin/structure/webform. For info on how to create a new Webform with proper settings, see our Webforms as input guide.

    9. After you've selected your \"Student Webform\" in the Field Widget setting, hit Update, and then Save at the bottom of the page.

    All done! So let's recap. We created a new form mode. We added this form mode to the Manage Form Display > Custom Display Settings options for Digital Objects. And finally we configured the Field Widget for Descriptive Metadata in our new Form Mode to use a new Webform. This last step is arbitrary to this example. We could have enabled or disabled fields, or changed other field widget settings depending on our needs. But configuring different Webforms as Field Widgets for Descriptive Metadata is a common use case in Archipelago.

    Thanks for reading this far! But there is more. We might want to display, in addition to ingest, our ADOs in custom ways. The process for creating new View Modes (the other type of Display Mode) is quite similar to creating new Form Modes, but let's walk through it with another example case.

    "},{"location":"createdisplaymodes/#adding-a-new-view-mode","title":"Adding a new View Mode","text":"

    Why would you want to create a new View Mode? Maybe there is a new type of media you are attaching to ADOs that you want to display using the proper player or tool. Or maybe you want to simplify the ADO display, removing fields from the display page. In this example let's create a new View Mode for ADOs that adds some fields to the display to show the Author and Published date of the object.

    1. Navigate to yoursite/admin/structure/display-modes

    2. Select View modes, and click the \"Add View mode\" at the top of the page.

    3. Select Content as your entity type.

    4. Enter the name of your new View Mode and save. Ours is \"Digital Object with Publishing Information\"

    5. Now let's enable this View mode. Go to yoursite/admin/structure/types/manage/digital_object and click the \"Manage Display\" tab.

    6. Scroll to the bottom of the page and expand the \"Custom Display Settings\" area. You will see our newly created View Mode. Enable it and hit save.

    7. Now scroll back to the page top. You will see \"Digital Object with Publishing Information\" in the list of View Modes, so go ahead and select it.

    8. Scroll down until you see the \"Disabled\" section. This section contains fields that are available to the ADO content type, but are not enabled in this display mode. Let's enable Author and Post date by changing the \"Region\" column dropdown from \"Disabled\" to \"Content\". (To learn more about Regions in Drupal, see here). Basically, this ensures that this field has a home in the page layout. Hit save.

    9. Now, if you want ADOs to use this View Mode for display, there is one last step. You need to select \"Digital Object with Publishing Info\" as the view mode Display Settings when adding new content. This area is located on the right side of the page. See below:

    10. Now, when we view the individual ADO, these new fields have been added to the display.

    All done! This was quite a simple example, but now you are aware of how to customize your own ADO display. It can only get more complex and exciting from here.

    Let's recap. We created a new View Mode. We enabled this View Mode in Manage Display > Custom Display Settings for Digital Objects. We enabled new fields (in this case, just for instruction, the Author and Post date fields) to make our new View Mode unique, and learned about Disabled fields in the process. We selected our new View Mode in the Display Settings area (slightly confusing wording because yes, this is a View Mode, subset of Display Mode) during ADO creation (for more on creating new objects, see this guide).

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"customwebformelements/","title":"Archipelago Custom Webform Elements","text":"

    In addition to the core elements provided by the Drupal Webform module, Archipelago also deploys a robust set of custom webform elements specific to digital repositories metadata needs and use cases.

    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#linked-data","title":"Linked Data:","text":"

    (*found under Composite Elements in \"Add Element\" menu)

    • Library of Congress (LoC) Linked Open data

      • Provides a form element to reconciliate against LoC Headings and similar LoD Sources
      • Able to configure which LoC Autocomplete Source Provider is used:
        • Subjects (LCSH)
        • LC Name Authority File (LCNAF)
        • LC Genre/Form Terms (LCGFT
        • Thesaurus of Graphic Materials (TGN)
        • MARC list for Geographic areas
        • Filter Suggest results by RDF Type
          • Any of the Classes listed here: https://id.loc.gov/ontologies/madsrdf/v1.html

    • Multi LoD Source Agent Items

      • Provides a form element to reconciliate Agents against Multiple sources of Agents

    • Wikidata

      • Provides a form element to reconciliate against Wikidata Items and Agents
        • via Wikidata Action API

    • Getty Vocabulary Term

      • Provides a form element to reconciliate against the Getty Vocabularies

    • VIAF

      • Provides a form element to reconciliate against VIAF (OCLC) Items

    • Location GEOJSON (Nominatim--Open Street Maps)

      • Provides a form element to collect valid location information (address, longitude, latitude, geolocation) using Nominatim/Openstreetmap open API

    • PubMed MeSH Suggest

      • Provides a form element to reconciliate against PubMed MeSH

    • SNAC Constellation Linked Open Data

      • Provides a form element to reconciliate against Social Networks and Archival Context (SNAC)

    • Europeana Entity Suggest

      • Provides a form element to reconciliate against Europeana Entity
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#customlocal-webform-lod-elements","title":"Custom/Local Webform LoD Elements","text":"

    (*also found under Composite Elements in \"Add Element\" menu)

    • Webform Options LoD suggest

      • Provides a form element autocomplete labels/urls(values) from Webform Options.

    • Webform LoD from CSV attached to an ADO suggest

      • Provides a form element autocomplete labels/urls(values) from a CSV attached to a Digital Object.
      • Documentation Guide found here: Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest'
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#file-upload-elements","title":"File Upload Elements:","text":"

    • Enhancements for Audio, Document, Image, Video file uploads

      • Backend processing for technical metadata (such as pronom, exif extraction)

    • Import Metadata from a File (such as XML)

      • Provides a form element for uploading, saving a file and parsing the content as metadata/webform submission data.

    • Import Metadata in CSV format from a File

      • Provides a form element for uploading, saving a file and parsing the content as metadata/webform submission data.
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#datetime-elements","title":"Date/Time Elements:","text":"
    • Multi Format Date and Date Range
      • Provides a form element for setting/reading Dates indifferent formats suitable for metadata.
      • Optional EDTF Validation.
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#composite-elements","title":"Composite Elements:","text":"
    • Panorama Tour Builder
      • Provides a form element to build multi-scene Panorama Tour Builder with hotspots
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#computed-elements","title":"Computed Elements:","text":"

    • Computed Metadata Transplant

      • Provides an item that takes source values (not only elements) and distributes them into other places/elements via a twig template

    • Computed Token

      • Provides an item to display computed webform submission values using tokens.

    • Computed Twig

      • Provides an item to display computed webform submission values using Twig
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"customwebformelements/#but-wait-theres-more","title":"But wait there's more!","text":"

    You can review the coding behind these custom elements here: https://github.com/esmero/webform_strawberryfield/tree/1.3.0/src/Element

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"devops/","title":"Archipelago Software Services","text":"

    At the core of the Archipelago philosophy is our commitment to both simplicity and flexibility.

    "},{"location":"devops/#under-the-hood-archipelagos-architecture-is","title":"Under the hood, Archipelago's architecture is:","text":"
    • Drupal (CMS)
    • Solr (Search)
    • Cantaloupe (Image Server)
    • S3 Storage (Mini.io or any other S3 flavor)

    Installation is entirely Dockerized and scripted with easy-to-follow directions.

    • Docker containers are as follows:
    Container Purpose Description esmero-web NGNIX Routes calls to esmero-php esmero-php PHP-FPM Has all binaries for postprocessing/exif/ocr/etc. Runs PHP code. esmero-db Database AMD and INTEL processors: MYSQL 8ARM processors: MariaDB esmero-minio Storage S3 API compatible Backend file and ADO as file storage. In a local it will do all the S3 stuff, on a live instance it can server as file routing to AWS S3, Azure Blob Storage, etc. esmero-solr Solr Currently version 8.8.2 esmero-nlp Natural Language Processing NLP64 server for entity extraction, language detection, etc.

    Information related to non-Dockerized installation and configruation can be found here: Traditional Installation Notes

    "},{"location":"devops/#strawberryfield-modules-at-the-heart-of-every-archipelago","title":"Strawberryfield Modules at the heart of every Archipelago:","text":"
    • Strawberryfield
    • Format Strawberryfield
    • Webform Strawberryfield
    • Strawberry Runners
    • Archipelago Multi-Importer (AMI)

    Documentation related to the Strawberryfield modules can be found here: Strawberryfields Forever

    "},{"location":"devops/#archipelago-also-extends-these-powerful-tools","title":"Archipelago also extends these powerful tools:","text":"
    • Annotorius
    • Drupal Webform Module
    • International Image Interoperability Framework (IIIF)
    • Internet Archive BookReader
    • Mirador
    • Pannellum
    • Replayweb.page Webarchive Player
    • Solr OCR Highlighting
    • Twig Templating In Symfony / In Drupal

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"documentation_about/","title":"About This Documentation","text":"

    Documentation is vital to our community, and contributions are welcome, greatly appreciated, and encouraged.

    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_about/#how-to-contribute","title":"How to Contribute","text":"

    Difficulty Level: Moderate\u2013Difficult

    1. Follow the GitHub Workflow.
    2. Check out the examples of additional features.
    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_features/","title":"Additional Documentation Features","text":"

    Below are some examples of features that are currently in use on the site. To explore more visit the Material for MkDocs documentation.

    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_features/#examples","title":"Examples","text":"","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_features/#images","title":"Images","text":"

    Images are located in the docs/images folder. You can add new ones there and link to them by relative path. For example, if you added strawberries_color.png, you would embed it like so:

    Image

    MarkupResult 
    ![New Documentation Image](images/strawberries_color.png)\n

    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_features/#admonitions","title":"Admonitions","text":"

    Question Admonition

    MarkupResult 
    ??? question \"What is a collapsible admonition?\"\n\n    This is a collapsible admonition. It can have a title, and it collapses so as not to interrupt the flow the of the document, but it provides useful information as needed.\n
    What is a collapsible admonition?

    This is a collapsible admonition. It can have a title, and it collapses so as not to interrupt the flow the of the document, but it provides useful information as needed.

    You can read more about admonitions with further examples in the Material for MkDocs documentation.

    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_features/#code-blocks","title":"Code blocks","text":"

    Code block with title and highlighted lines

    MarkupResult 
    ```html+twig title=\"HTML in a TWIG template\" hl_lines=\"8 9 10\"\n{% for image in attribute(data, 'as:image')|slice(0,1) %}\n {% if image[\"flv:exif\"] %}\n   {% set height = image[\"flv:exif\"].ImageHeight%}\n {% else  %}\n   {% set width = 1200 %}\n {% endif %}\n   {% set imageurl =  IIIFserverurl ~ image['url']|replace({'s3://':''})|replace({'private://':''})|url_encode %}\n<a href=\"{{ nodeurl }}\" title=\"{{ data.label }}\" alt=\"{{ data.label }}\">\n<img src=\"{{ imageurl }}/pct:5,5,90,30/,400/0/default.jpg\" class=\"d-block.w-auto\" alt=\"{{ image.name }}\" height=\"400px\" style=\"min-width:1200px\">\n</a> \n{% endfor %}\n```\n
    HTML in a TWIG template
    {% for image in attribute(data, 'as:image')|slice(0,1) %}\n {% if image[\"flv:exif\"] %}\n   {% set height = image[\"flv:exif\"].ImageHeight%}\n {% else  %}\n   {% set width = 1200 %}\n {% endif %}\n   {% set imageurl =  IIIFserverurl ~ image['url']|replace({'s3://':''})|replace({'private://':''})|url_encode %}\n<a href=\"{{ nodeurl }}\" title=\"{{ data.label }}\" alt=\"{{ data.label }}\">\n<img src=\"{{ imageurl }}/pct:5,5,90,30/,400/0/default.jpg\" class=\"d-block.w-auto\" alt=\"{{ image.name }}\" height=\"400px\" style=\"min-width:1200px\">\n</a> \n{% endfor %}\n
    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_features/#quirks","title":"Quirks","text":"

    Because of the use of front matter (the block of YAML at the top that contains settings and data for the file) the markup for a horizontal rule is restricted. To create one you have to use the following:

    Horizontal Rule

    MarkupResult 
    ___\n

    Info

    The above are underscore (_) characters, as opposed to hyphens (-).

    Some of the documentation that is automatically deployed from the repos have special comments that are converted to theme-specific elements via script.

    Front Matter

    Deployment Repo with Front MatterDocumentation Repo with Front Matter 
    <!--documentation\n---\ntitle: \"Adding Demo Archipelago Digital Objects (ADOs) to your Repository\"\ntags:\n  - Archipelago Digital Objects\n  - Demo Content\n---\ndocumentation-->\n
    ---\ntitle: \"Adding Demo Archipelago Digital Objects (ADOs) to your Repository\"\ntags:\n  - Archipelago Digital Objects\n  - Demo Content\n---\n

    Switching Elements

    Deployment Repo with Theme-specific MarkupDocumentation Repo with Theme-specific Markup 
    <!--switch_below\n\n??? info \"OSX (macOS)/x86-64\"\n\n    ```shell\n    cp docker-compose-osx.yml docker-compose.yml\n    ```\n\n??? info \"Linux/x86-64/AMD64\"\n\n    ```shell\n    cp docker-compose-linux.yml docker-compose.yml\n    ```\n\n??? info \"OSX (macOS)/Linux/ARM64\"\n\n    ```shell\n    cp docker-compose-arm64.yml docker-compose.yml\n    ```\n\nswitch_below-->\n\n___\n\nOSX (macOS)/x86-64:\n\n```shell\ncp docker-compose-osx.yml docker-compose.yml\n```\n\n___\n\nLinux/x86-64/AMD64:\n\n```shell\ncp docker-compose-linux.yml docker-compose.yml\n```\n\n___\n\nOSX (macOS)/Linux/ARM64:\n\n```shell\ncp docker-compose-arm64.yml docker-compose.yml\n```\n\n___\n\n<!--switch_above\nswitch_above-->\n
    ??? info \"OSX (macOS)/x86-64\"\n\n    ```shell\n    cp docker-compose-osx.yml docker-compose.yml\n    ```\n\n??? info \"Linux/x86-64/AMD64\"\n\n    ```shell\n    cp docker-compose-linux.yml docker-compose.yml\n    ```\n\n??? info \"OSX (macOS)/Linux/ARM64\"\n\n    ```shell\n    cp docker-compose-arm64.yml docker-compose.yml\n    ```\n\n<!--repo_docs\n\n___\n\nOSX (macOS)/x86-64:\n\n```shell\ncp docker-compose-osx.yml docker-compose.yml\n```\n\n___\n\nLinux/x86-64/AMD64:\n\n```shell\ncp docker-compose-linux.yml docker-compose.yml\n```\n\n___\n\nOSX (macOS)/Linux/ARM64:\n\n```shell\ncp docker-compose-arm64.yml docker-compose.yml\n```\n\n___\n\nrepo_docs-->\n
    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_technical/","title":"Documentation Technical Details","text":"

    Archipelago documentation is generated using the following open source projects:

    • MkDocs generates the static site
    • Material for MkDocs provides the site's theme
    • mike generates the routing for versions
    • Github Actions builds and deploys the files to Github Pages

    To use any advanced features not mentioned in these pages, you can look through the documentation for each of the above projects.

    In addition to the pages added directly via this repository, there are some pages automatically deployed here with GitHub Actions from the following repositories:

    • https://github.com/esmero/archipelago-deployment
    • https://github.com/esmero/archipelago-deployment-live

    Both the main READMEs and documentation in the docs folders for those repositories are prepended with archipelago-deployment and archipelago-deployment-live respectively and copied to the docs folder here with the rest of the documentation. In practice that means those pieces of documentation need to be edited in those repositories directly.

    ","tags":["Documentation"]},{"location":"documentation_template/","title":"Example Documentation Page Title","text":"

    A brief overview of the specific functionality or workflow area that will be covered in your documentation.

    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_template/#stepsguides","title":"Steps/Guides","text":"
    1. Step one example.

    2. Step two example with images:

    3. Step three example with Details section:

      Click to open this Details Section

      More Details in a List

      • Apples
      • Oranges
      • Peaches
      • Pumpkins

    4. Step four example with a simple code block:

      {% for image in attribute(data, 'as:image')|slice(0,1) %}\n {% if image[\"flv:exif\"] %}\n   {% set height = image[\"flv:exif\"].ImageHeight%}\n {% else  %}\n   {% set width = 1200 %}\n {% endif %}\n   {% set imageurl =  IIIFserverurl ~ image['url']|replace({'s3://':''})|replace({'private://':''})|url_encode %}\n<a href=\"{{ nodeurl }}\" title=\"{{ data.label }}\" alt=\"{{ data.label }}\">\n<img src=\"{{ imageurl }}/pct:5,5,90,30/,400/0/default.jpg\" class=\"d-block.w-auto\" alt=\"{{ image.name }}\" height=\"400px\" style=\"min-width:1200px\">\n</a> \n{% endfor %}\n

    5. Step five example with a code block that has a title and highlighted lines:

      HTML in a TWIG template
      {% for image in attribute(data, 'as:image')|slice(0,1) %}\n {% if image[\"flv:exif\"] %}\n   {% set height = image[\"flv:exif\"].ImageHeight%}\n {% else  %}\n   {% set width = 1200 %}\n {% endif %}\n   {% set imageurl =  IIIFserverurl ~ image['url']|replace({'s3://':''})|replace({'private://':''})|url_encode %}\n<a href=\"{{ nodeurl }}\" title=\"{{ data.label }}\" alt=\"{{ data.label }}\">\n<img src=\"{{ imageurl }}/pct:5,5,90,30/,400/0/default.jpg\" class=\"d-block.w-auto\" alt=\"{{ image.name }}\" height=\"400px\" style=\"min-width:1200px\">\n</a> \n{% endfor %}\n

    6. Last Step Example.

    Congratulations! \ud83c\udf89

    ","tags":["Documentation","Contributing","Examples"]},{"location":"documentation_workflow/","title":"GitHub Workflow","text":"
    1. Find an issue to resolve or create a new issue here.
    2. Fork the documentation repo. If you're not familiar with forking see this guide.
    3. Create an issue branch in your forked repo. For example, if the issue you're resolving is ISSUE-100: 
      git checkout -b ISSUE-100\n
    4. Copy this template to create a new piece of documentation: 
      cp docs/documentation_template.md docs/new_documentation.md\n
    5. Make your changes to the copied markdown file.
    6. If this is new documentation add it to the nav section of the mkdocs.yml configuration file at the root of the repo. For example: 
      nav:\n  - Home: index.md\n  - About Archipelago:\n    - Archipelago's Philosophy & Guiding Principles: ourtake.md\n    - Strawberryfields Forever: strawberryfields.md\n    - Software Services: devops.md\n    - New Documentation: new_documentation.md\n  - Code of Conduct: CODE_OF_CONDUCT.md\n  - Instructions and Guides:\n    - Archipelago-Deployment:\n      - Start: archipelago-deployment-readme.md\n      - Installing Archipelago Drupal 9 on OSX (macOS): archipelago-deployment-osx.md\n      - Installing Archipelago Drupal 9 on Ubuntu 18.04 or 20.04: archipelago-deployment-ubuntu.md\n      - Installing Archipelago Drupal 9 on Windows 10/11: archipelago-deployment-windows.md\n      - Adding Demo Archipelago Digital Objects (ADOs) to your Repository: archipelago-deployment-democontent.md\n...\n

    7. To view the changes locally, first install the Python libraries using the Python package manager pip: 

      pip install mkdocs-material mike git+https://github.com/jldiaz/mkdocs-plugin-tags.git mkdocs-git-revision-date-localized-plugin mkdocs-glightbox\n
      You may need to install Python on your machine. Download Python or use your favorite operating system package manager such as Homebrew.

    8. Now you can build the site locally, e.g. for the documentation using the 1.0.0 branch: 

      mike deploy 1.0.0\nmike set-default 1.0.0\n
      If you create a new branch to match the issue number as in step 3, you would use your branch instead of 1.0.0. For example, a branch of ISSUE-129. 
      mike deploy ISSUE-129\nmike set-default ISSUE-129\n

    9. Start the web server: 
      mike serve\n
    10. Check the results in your browser by going to: http://localhost:8000
    11. If everything looks good, you can push to your forked repo issue branch: 
      git add .\ngit commit -m \"Create new docs with useful information.\"\ngit push origin ISSUE-100\n
    12. Create a pull request and link to the issue by tagging it, e.g. Resolves #100.
    ","tags":["Documentation","Contributing","Examples"]},{"location":"drupal_core_update/","title":"Updating Drupal Core in Archipelago","text":"

    Drupal, the project, puts out new core releases on a regular schedule. Your Archipelago site needs to apply the security updates and possibly minor releases between major core updates. Major core updates will typically coincide with an updated Archipelago stable release.

    Updating core is done via Composer:

    ","tags":["Archipelago-deployment","Archipelago-deployment-live","DevOps","Drupal","Drupal Core"]},{"location":"drupal_core_update/#stepsguides","title":"Steps/Guides","text":"
    1. First you will want to verify Drupal Core will update itself and the dependencies. To do so, you run the following command: 
      docker exec -ti esmero-php bash -c \"composer update \"drupal/core-*:^9\" --with-all-dependencies --dry-run\n
      The --dry-run flag will allow you to see what will be updated. Once you review the updates and are ready to go with the full update, you will run the same command without the dry-run flag.
    2. Update Core and the dependencies: 
      docker exec -ti esmero-php bash -c \"composer update \"drupal/core-*:^9\" --with-all-dependencies\"\n
    3. Sometimes the database needs to be updated after the update of the files. The following command will prompt you to type yes if there are updates to be done, or it will not return anything if no updates are needed: 
      docker exec -ti esmero-php bash -c \"drush updatedb\"\n
    4. Clear the Drupal cache: 
      docker exec -ti esmero-php bash -c \"drush cache:rebuild\"\n
      Occasionally there will be other Drupal modules that Archipelago uses, and they need to be updated at the same time you run a Core update. This is an example of updating Drupal Webform, which was required for moving to Drupal 9.5.x:

    Updating a Drupal module

    1. Use Composer to update a module to a specific release: 
      docker exec -ti esmero-php bash -c \"composer update \"drupal/webform:6.1.4\n
    2. Check for database updates and apply them if necessary: 
      docker exec -ti esmero-php bash -c \"drush updatedb\"\n
      or 
      docker exec -ti esmero-php bash -c \"drush updb\"\n
    3. Clear the cache again: 
      docker exec -ti esmero-php bash -c \"drush cache:rebuild\"\n
      or 
      docker exec -ti esmero-php bash -c \"drush cr\"\n
    ","tags":["Archipelago-deployment","Archipelago-deployment-live","DevOps","Drupal","Drupal Core"]},{"location":"find_and_replace/","title":"Advanced Batch Find and Replace","text":"

    Archipelago's Advanced Batch Find and Replace functionality provides different ways for you to efficiently Find/Search and Replace metadata values found in the raw JSON of your Digital Objects and Collections. Advanced Batch Find and Replace makes use of customized Actions that extend Drupal's VBO module to enable these powerful batch metadata replacement Actions in your Archipelago environment.

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#where-to-find","title":"Where to Find","text":"

    In default Archipelagos, you can find Advanced Batch Find and Replace:

    • Through the Tools menu > Advanced Batch Find and Replace
    • Directly at /search-and-replace

    Site Administrator Note
    • The View driving this can be found at /admin/structure/views/view/solr_search_content_with_find_and_replace. The default Facets referenced above can be found at /admin/structure/block/list/archipelago_subtheme in the Sidebar Second section. Please proceed with caution if making any changes to the default configurations for this View or the Facets referenced on this View Page.
    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#main-page-overview","title":"Main Page Overview","text":"

    From the main page (display title 'Search and Replace'), you will see:

    • A Fulltext Search box
    • Dropdown list of available Actions
    • Listing of all the Digital Objects and Collections found in your Archipelago repository
      • Option to Select/deselect all results in this view (all pages) via toggle switch
      • Same toggle switch option beside each individual Object/Collection to select one-at-a-time
      • Expandable \u25ba Raw Metadata (JSON) section beneath each each individual Object/Collection containing the full Raw JSON metadata record for reference
    • Expandable section to show all the Selected items in this view (will be 0 items to start).
      • Individual selections made on different results pages will be preserved in the overall total of Selected items available for preview on this main/top page.

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#default-facets-configured","title":"Default Facets Configured","text":"

    You will also see a listing of a few different default Facets configured to help guide your selection of potential Digital Objects/Collections:

    • Object Type
      • the Archipelago Digital Object/Collection Type
      • JSON key: type
    • JSON keys in your metadata
      • all of the potential JSON keys that are present in your repository
      • includes 'flattened' keys that may not be readily accessible via Webform elements (such as Archipelago-generated technical and administrative keys)
    • Ingest Method Service URL
      • The URL of the Digital Object/Collection Webforms and AMI Sets present in your repository that were used to create Digital Objects/Collections.
      • Please note that using the Find and Replace Webform functionality to update ADOs will cause the original AMI Set URL identified in this Facet to be overwritten and replaced with the specified Webform used during the replacement execution.
    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#available-actions","title":"Available Actions","text":"

    The default options available through the Action dropdown menu include:

    • *Export Archipelago Digital Objects to CSV content item
    • Text based find and replace Metadata for Archipelago Digital Objects content item
    • Webform find-and-replace Metadata for Archipelago Digital Objects content item
    • JSON Patch Metadata for Archipelago Digital Objects content item
    • *Publish Digital Object
    • *Unpublish Digital Object
    • *Change the author of content
    • Trigger Strawberrry Runners process/reprocess for Archipelago Digital Objects content item
    • *Delete selected entities/translations

    * denotes Action options that are also shared with the main Content Page Action Menu You can read more about Strawberry Runners Post-Processing Actions here

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#find-and-replace-specific-actions","title":"Find and Replace Specific Actions","text":"

    After reviewing the 'Important Notes & Workflow Recommendations' below, please see the following separate pages for detailed examples walking through the usage of the three different Find and Replace specific actions.

    • Text Based Find and Replace
      • Enables you to execute simple but powerful text based search and replacement operations.
    • Webform Find and Replace
      • Enables you to search against values found within defined Webform elements to apply metadata replacements with targeted care.
    • JSON Patch Find and Replace
      • Enables you to carry out advanced JSON Patch operations within your metadata.
    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#important-notes-workflow-recommendations","title":"Important Notes & Workflow Recommendations","text":"

    Important Note

    The Actions available through Archipelago's Advanced Batch Find and Replace can potentially have repository-wide effects. It is strongly recommended that you proceed with caution when executing any of the available Actions.

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#simulation-mode","title":"Simulation Mode","text":"

    Before executing any of the available Find and Replace Actions, the best-practice workflow recommendation is to always first run in Simulation Mode:

    • Before the final 'Execute Action' step of your Find and Replace operation, select the option to '\u2611\ufe0f only simulate and debug affected JSON'. This will run a quick check against your Action specifications and the potentially impacted Digital Objects and Collections.
    • You can then double check that the total effected changes shown reflect your intended amount of changes.
      • The total number of changes will always be multipled by a factor of 2, as the Actions count a first step of checking against your data, then the second step of applying the change.
      • If your Action specifications do not match against any JSON metadata values in your specified results, you will also see that no matches were applicable.

    • Once you have reviewed the results of the Simulation Mode and confirmed the simulated results match your intentend amount of changes, proceed with executing the Action you first simulated.
    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace/#checking-your-changes","title":"Checking Your Changes","text":"

    After applying any of the Find and Replace Actions, you can review the specific changes that were made within the Revision history of the impacted Digital Objects and Collections.

    • Through the Find and Replace page results listing or the main Content page, navigate to the Digital Object/Collection you wish to review.
    • Open the 'Revision' tab.
    • The details for the specific Action executed will be visible. All of the Find and Replace Actions will result in slightly different operation notes within the the Revision history.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace_action_json_patch/","title":"JSON Patch Find and Replace","text":"

    Enables you to carry out advanced JSON Patch operations within your metadata.

    Note

    Please refer to the main Find and Replace documentation page for a general overview of where to find within your Archipelago, a general overview of default options and important notes and workflow recommendations.

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#what-is-a-json-patch-and-when-to-use-it","title":"What is a JSON Patch and when to use it?","text":"

    Before we dive into the mechanics of doing JSON Patching Batch in Archipelago we need to learn what a JSON Patch is and of course when applying this action is useful, possible (or not).

    A JSON Patch is a JSON Document containing precise operations that can heavily modify the structure and values of an existing JSON Document, in this case the RAW JSON found inside a strawberryfield of our ADOs.

    The operations available for modifications of an JSON document are:

    • \u201cadd\u201d
    • \u201cremove\u201d
    • \u201creplace\u201d,
    • \u201cmove\u201d
    • \u201ccopy\u201d

    And there is also one (very important) used to check/validate the existence of values/keys:

    • \u201ctest\u201d

    Even if you can have multiple operations in a single JSON Patch Document, they are always applied as a whole. Means if any of those fail nothing will be applied and in concrete, in our VBO action, no change will be done to your ADO. This in combination with the \u201ctest\u201d operation gives you a lot of safety and a way of discerning/skipping completely a complex set of operations on e.g. a failed \u201dtest\u201d.

    JSON Patch uses JSON Pointers as arguments in all of these operations to target a specific key/value of your JSON.

    Using the following JSON Snippet as example:

    \"subject_lcgft_terms\": [\n    {\n        \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/genreForms\\/gf2017027249\",\n        \"label\": \"Photographs\"\n    }\n]\n

    These JSON Pointers will resolve in the following manner:

    • /subject_lcgft_terms 
    [\n    {\n        \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/genreForms\\/gf2017027249\",\n        \"label\": \"Photographs\"\n    }\n]\n
    • /subject_lcgft_terms/0
    {\n    \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/genreForms\\/gf2017027249\",\n    \"label\": \"Photographs\"\n}\n
    • /subject_lcgft_terms/0/label
    Photographs\n

    AS you can see a JSON Pointer is very precise , allowing you to target complete structures and values but it does not allow Wildcard Operations. Means you can not \"search\" or do loosy comparissons. This very fact limits many times the use case. E.g. if you have a list of terms like this:

    \"terms\": [\n    \"term1\",\n    \"term2\",\n    \"term3\"\n]\n

    and you want to \"test\" for the existence of \"term3\" before applying a change, you would need to know exactly at what position inside the terms Array (Starting from 0) it will/should be found. And that might not be consistent across every ADO.

    So how do we use these pointers in an operation inside a JSON Patch document? Using the same fake \"terms\" JSON snippet the previously listed, operations are written like this:

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#add","title":"add","text":"
    { \"op\": \"add\", \"path\": \"/terms/0\", \"value\": \"term_another\" }\n

    This will add before the first term (in this case \"term1\" ) \"term_another\" as a value.

    At the end

    you can use a dash (-) (e.g. \"/terms/-\") instead of the numeric position of an array entry to denote that the \"value\" needs to be added at the end. This is needed specially for empty lists. You can not target 0 position on an empty array.

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#remove","title":"remove","text":"
    { \"op\": \"remove\", \"path\": \"/terms/1\"}\n

    This will remove the second term (in this case \"term2\" )

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#replace","title":"replace","text":"

    { \"op\": \"replace\", \"path\": \"/terms/1\", \"value\": \"term_again\" }\n
    This will remove the second term (in this case \"term2\" ) and put in its place \"term_again\" as a value. Basically two operationes, \u201cremove\u201c and \u201cadd \u201c in a single step

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#move","title":"move","text":"
    { \"op\": \"move\", \"from\": \"/terms\", \"path\": \"/terms_somewhere_else\"}\n

    This will copy all values inside top JSON key terms into a new top JSON key named terms_somewhere_else and remove then the old terms key.

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#copy","title":"copy","text":"
    { \"op\": \"copy\", \"from\": \"/terms\", \"path\": \"/terms_somewhere_else\"}\n

    Similar to \u201cmove\u201c, it will copy values inside top JSON key terms into a new top JSON key named terms_somewhere_else without removing then the old terms key or its content!

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#test","title":"test","text":"
    { \"op\": \"test\", \"path\": \"/terms/0\", \"value\": \"term1\"}\n

    Finally, \u201ctest\u201c will check if on position 0 of terms there is a value of \"term1\". If not, the test will fail. If a single test fails the whole JSON Patch will be cancelled. Tests can not be concatenated via OR bolean operators. So they always act individually. Two tests with one failing is a failed JSON Patch.

    There is more of course! The Complete documentation can be found here

    So. When to use JSON Patch? There are a few general rules/suggestions:

    • When you can generate one or more precise \u201ctest\u201c operations. If you need to test against data that might exists but its position is not clear, a single JSON Patch will not do the trick. That said you could run the same JSON Patch document against the same set of ADOs more than once modifying slightly the \u201ctest\u201c to cover all variations (check for value at positition 0, then again at position 1, etc)
    • When you need to use data that is already inside the JSON Document and move it around. Sometimes fixing a value, in the sense of putting a static replacement, is not what you need. Other Actions documented will allow you to replace one value with another fixed one. But JSON Patch will allow you to use existing data inside your target JSON and move it/copy it.
    • When you operate on multiple JSON Keys and can target / match complete values. You can not replace a single word inside a value via a JSON Patch. But you can apply multiple precise operations in a single pass.
    • When you need to change data types. e.g. convert a single value into an array.
    • When you need safety. The fact that a single failed \u201ctest\u201c will cancel a whole JSON Patch allows you to operate with safety and ensure the final destination will always be a JSON

    Now that we know what it is and when we should do it, we can make a small exercise. The goal:

    • For all ADO's with json key with value photograph that are member of collection with Node ID 16
      • convert the description key from a single value into an array.
      • add an extra LOD entry
      • Copy a Value into a new Key
    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#step-1-select-the-ados-to-be-modified","title":"Step 1: Select the ADOs to be Modified","text":"

    As with every other VBO action described in our documentation, start by selecting the ADOs you want to modify using the exposed Search Field(s) and/or Facets present in the Search and Replace View found at /search-and-replace .

    Once you have filtered down the list to manageable size, containing at least the ADOs you plan on modifying (but for JSON Patch operation could be more too because you can \u201ctest\u201c and match ), press either on Select / deselect all results in this view to pass all the result (this includes all pages, not only the currently visible one) or go selectively one by one by checking on the toggle found beside each ADO's title. You will see how the number in Selected 0 item in this view increases. Now press Apply to select Items. We will use for this example Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?], an ADO we provide in our DEMO sets.

    Redundant to say, Batch Actions are intended to be used when a modification needs to be applied to more than one item, implying there is a pattern. For single ADOs you can always do this faster directly via the EDIT tab.

    Keep your JSON Patches (and friends) around

    Since JSON Patching involves writing a, sometimes complex, JSON Document, please keep around an Application (or Text File) where you can copy/paste and save your JSON Patches for resuse or future references. Archipelago will not store nor remember between runs the JSON Patch document you submitted. It is also very useful to copy and have at hand the RAW JSON of one of the ADOs you plan to modify as a reference/aid while building the given JSON Patch document.

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#step-2-json-patch-metadata-for-archipelago-digital-objects-action-configuration","title":"Step 2: JSON Patch Metadata for Archipelago Digital Objects Action Configuration","text":"

    The default config JSON Patch form will contain an example JSON Patch set of Commands (Document)

    We are going to replace this one with a valid JSON document. Notice that it does not require a root {} Object wrapper and it is really a list (or array) of operations.

    A bit of repetition but needed to explain the JSON Patch document. You can see on the following Note box how we copyed the RAW JSON of one ADO to be Patched to have a reference while building the JSON PATCH. for the sake of brevity we remove here the longer Image File technical Metadata.

    RAW JSON of Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?] Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?] | before Patching
    {\n    \"note\": \"\",\n    \"type\": \"Photograph\",\n    \"viaf\": \"\",\n    \"label\": \"Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?]\",\n    \"model\": [],\n    \"owner\": \"New-York Historical Society, 170 Central Park West, New York, NY 10024, 212-873-3400.\",\n    \"audios\": [],\n    \"images\": [\n        26\n    ],\n    \"models\": [],\n    \"rights\": \"This digital image may be used for educational or scholarly purposes without restriction. Commercial and other uses of the item are prohibited without prior written permission from the New-York Historical Society. For more information, please visit the New-York Historical Society's Rights and Reproductions Department web page at [http:\\/\\/www.nyhistory.org\\/about\\/rights-reproductions](http:\\/\\/www.nyhistory.org\\/about\\/rights-reproductions).\",\n    \"videos\": [],\n    \"creator\": \"\",\n    \"ap:tasks\": {\n        \"ap:sortfiles\": \"index\"\n    },\n    \"duration\": \"\",\n    \"ispartof\": [],\n    \"language\": \"English\",\n    \"documents\": [],\n    \"edm_agent\": \"\",\n    \"publisher\": \"\",\n    \"ismemberof\": [\n        16\n    ],\n    \"creator_lod\": [\n        {\n            \"name_uri\": \"\",\n            \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/pht\",\n            \"agent_type\": \"personal\",\n            \"name_label\": \"Stonebridge, George Ehler\",\n            \"role_label\": \"Photographer\"\n        }\n    ],\n    \"description\": \"George Ehler Stonebridge (d. 1941) was an amateur photographer who lived and worked in the Bronx, New York. He left little record of himself, but an invaluable one of his surroundings and interests. Stonebridge lived at several locations in the Bronx with his wife Bella, and their three children Grace, George, and William. He worked at the Northern Gaslight Company, although the position he held is unknown. In addition to taking photographs, Stonebridge wrote poetry and prose about his love of the Bronx, his children, and in honor of military victories. Some of Stonebridge's photographs appeared in local papers. In 1898, he was an authorized reporter and photographer for the North Side News; in 1905 he was an authorized reporter for the Bronx Borough Record and Times, and probably took photographs for that paper as well. Stonebridge was fascinated with the subject of military preparedness. Training rituals and staged battles were one of his favorite photographic subjects. His 1898 poem, \\\"Remember the Maine,\\\" celebrates the United States' victory in the Spanish-American War. He was especially proud of soldiers from the Bronx, and photographed historical tablets throughout the Borough commemorating previous military victories. Stonebridge also used his photographs to illustrate lectures. In 1907, he gave several lectures on \\\"The Training of War,\\\" using colored lantern slides.\",\n    \"interviewee\": \"\",\n    \"interviewer\": \"\",\n    \"pubmed_mesh\": null,\n    \"sequence_id\": \"\",\n    \"subject_loc\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/subjects\\/sh85038796\",\n            \"label\": \"Dogs\"\n        }\n    ],\n    \"website_url\": \"\",\n    \"as:generator\": {\n        \"type\": \"Update\",\n        \"actor\": {\n            \"url\": \"http:\\/\\/localhost:8001\\/form\\/descriptive-metadata\",\n            \"name\": \"descriptive_metadata\",\n            \"type\": \"Service\"\n        },\n        \"endTime\": \"2022-12-05T09:19:37-05:00\",\n        \"summary\": \"Generator\",\n        \"@context\": \"https:\\/\\/www.w3.org\\/ns\\/activitystreams\"\n    },\n    \"date_created\": \"1910-01-01\",\n    \"issue_number\": null,\n    \"date_published\": \"\",\n    \"subjects_local\": null,\n    \"term_aat_getty\": \"\",\n    \"ap:entitymapping\": {\n        \"entity:file\": [\n            \"model\",\n            \"audios\",\n            \"images\",\n            \"videos\",\n            \"documents\",\n            \"upload_associated_warcs\"\n        ],\n        \"entity:node\": [\n            \"ispartof\",\n            \"ismemberof\"\n        ]\n    },\n    \"europeana_agents\": \"\",\n    \"europeana_places\": \"\",\n    \"local_identifier\": \"nyhs_PR066_6136\",\n    \"subject_wikidata\": [\n        {\n            \"uri\": \"http:\\/\\/www.wikidata.org\\/entity\\/Q3381576\",\n            \"label\": \"black-and-white photography\"\n        },\n        {\n            \"uri\": \"http:\\/\\/www.wikidata.org\\/entity\\/Q60\",\n            \"label\": \"New York City\"\n        }\n    ],\n    \"date_created_edtf\": \"\",\n    \"date_created_free\": null,\n    \"date_embargo_lift\": null,\n    \"physical_location\": null,\n    \"related_item_note\": null,\n    \"rights_statements\": \"In Copyright - Educational Use Permitted\",\n    \"europeana_concepts\": \"\",\n    \"geographic_location\": {\n        \"lat\": \"40.8466508\",\n        \"lng\": \"-73.8785937\",\n        \"city\": \"New York\",\n        \"state\": \"New York\",\n        \"value\": \"The Bronx, Bronx County, New York, United States\",\n        \"county\": \"\",\n        \"osm_id\": \"9691916\",\n        \"country\": \"United States\",\n        \"category\": \"boundary\",\n        \"locality\": \"\",\n        \"osm_type\": \"relation\",\n        \"postcode\": \"\",\n        \"country_code\": \"us\",\n        \"display_name\": \"The Bronx, Bronx County, New York, United States\",\n        \"neighbourhood\": \"Bronx County\",\n        \"state_district\": \"\"\n    },\n    \"note_publishinginfo\": null,\n    \"subject_lcgft_terms\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/genreForms\\/gf2017027249\",\n            \"label\": \"Photographs\"\n        }\n    ],\n    \"upload_associated_warcs\": [],\n    \"physical_description_extent\": \"\",\n    \"subject_lcnaf_personal_names\": \"\",\n    \"subject_lcnaf_corporate_names\": \"\",\n    \"subjects_local_personal_names\": \"\",\n    \"related_item_host_location_url\": null,\n    \"subject_lcnaf_geographic_names\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/names\\/n81059724\",\n            \"label\": \"Bronx (New York, N.Y.)\"\n        },\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/names\\/n79007751\",\n            \"label\": \"New York (N.Y.)\"\n        }\n    ],\n    \"related_item_host_display_label\": null,\n    \"related_item_host_local_identifier\": null,\n    \"related_item_host_title_info_title\": \"\",\n    \"related_item_host_type_of_resource\": null,\n    \"physical_description_note_condition\": null\n}\n

    Based on our own plan:

    1. Check first if of type photograph and memberof Node ID 16
    { \"op\": \"test\", \"path\": \"/type\", \"value\": \"Photograph\"},\n{ \"op\": \"test\", \"path\": \"/ismemberof\", \"value\": [16]}\n

    Notice that to be really sure we also match the data type, an array with a single value 16 of type integer (makes sense since the Operation is also a JSON and will be evaluated in the same way as the source RAW JSON). This is a precise match. if the ADO belongs to multiple Collections it will fail of course.

    1. Now we are going to convert description key from a single value into an array.
    {\"op\": \"add\",\"path\": \"/temp_description_array\",\"value\": []},\n{\"op\": \"move\",\"from\": \"/description\",\"path\": \"/temp_description_array/-\"},\n{\"op\": \"move\",\"from\": \"/temp_description_array\",\"path\": \"/description\"},\n

    This is a multi step operation. Given that JSON Patch can not \"cast\" types and depends on a given datatype to be present before, e.g. adding a new value to it, we use here a temporary key. Notice that you can not \u201cadd\u201c or \u201cmove\u201c to e.g. the position 0 because the destination array is indeed empty (that will fail). But by using the dash you can command it to put it at the end, which on an empty list is also at the beginning (we are starting to understand this!).

    1. And the extra LOD entry for wikidata, in this case the Q Item for collie (type of herding dog)
    { \"op\": \"add\", \"path\": \"/subject_wikidata/-\", \"value\": {\n        \"uri\": \"https://www.wikidata.org/wiki/Q1196071\",\n        \"label\": \"collie\"\n    }\n}\n
    1. Finally we are going to copy the geographic_location.state value and put it into subjects_local:
    {\"op\": \"remove\", \"path\": \"/subjects_local\"},\n{\"op\": \"add\", \"path\": \"/subjects_local\", \"value\": []},\n{\"op\": \"copy\", \"from\": \"/geographic_location/state\", \"path\": \"/subjects_local/-\"}\n

    Why so many operations? Because initially \"subjects_local\" had a value of null and it is not suited to generate/add to it as a multivalued key because of that. So we need to remove it first, recreate it as an empty list and then we can copy. Pro Note: you could partially rewrite this as replace operation!

    what if subjects_local has data?

    You will lose it! you can add a \u201ctest\u201c or move data instead of recreating. Many choices.

    The final JSON Patch will look like this. Copy it into the Configuration JSON Patch commands form field: 

    [\n    {\"op\": \"test\", \"path\": \"/type\", \"value\": \"Photograph\"},\n    {\"op\": \"test\", \"path\": \"/ismemberof\", \"value\": [16]},\n    {\"op\": \"add\",\"path\": \"/temp_description_array\",\"value\": []},\n    {\"op\": \"move\",\"from\": \"/description\",\"path\": \"/temp_description_array/-\"},\n    {\"op\": \"move\",\"from\": \"/temp_description_array\",\"path\": \"/description\"},\n    {\"op\": \"add\",\"path\": \"/subject_wikidata/-\",\"value\": \n        {\n        \"uri\": \"https://www.wikidata.org/wiki/Q1196071\",\n         \"label\": \"collie\"\n         }\n    },\n    {\"op\": \"remove\", \"path\": \"/subjects_local\"},\n    {\"op\": \"add\", \"path\": \"/subjects_local\", \"value\": []},\n    {\"op\": \"copy\", \"from\": \"/geographic_location/state\", \"path\": \"/subjects_local/-\"}\n]\n
    The inverse process online

    Now that you know (or are starting to understand) the manual process you can also try this online tool that allows you, based on a source and a destination JSON, generate the needed JSON Patch to mutate one JSON into the another. The logic might not be always what you need and most likely it will not take in account that you actually need to move values and will prefer to fix values to be added via an add operation

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#step-3-run-the-json-patch-action-in-simulation-mode","title":"Step 3: Run the JSON Patch Action in simulation mode","text":"

    Ready. Now check the \"only simulate and debug affected JSON\" checkbox. We want to see if we did well but not yet modify any ADOs. Press Apply button. You will get another confirmation screen. Press Execute Action.

    It will run quick (on this example) and you will redirected back on the original Drupal Views of Step 1. If your source ADO is actually the one from our Demo Collection you might see a diff, something very similar to this:

    Text based diff after a successfull Patch
    129d129 < \"description\": \"George Ehler Stonebridge (d. 1941) was an amateur photographer who lived and worked in the Bronx, New York. He left little record of himself, but an invaluable one of his surroundings and interests. Stonebridge lived at several locations in the Bronx with his wife Bella, and their three children Grace, George, and William. He worked at the Northern Gaslight Company, although the position he held is unknown. In addition to taking photographs, Stonebridge wrote poetry and prose about his love of the Bronx, his children, and in honor of military victories. Some of Stonebridge's photographs appeared in local papers. In 1898, he was an authorized reporter and photographer for the North Side News; in 1905 he was an authorized reporter for the Bronx Borough Record and Times, and probably took photographs for that paper as well. Stonebridge was fascinated with the subject of military preparedness. Training rituals and staged battles were one of his favorite photographic subjects. His 1898 poem, \\\"Remember the Maine,\\\" celebrates the United States' victory in the Spanish-American War. He was especially proud of soldiers from the Bronx, and photographed historical tablets throughout the Borough commemorating previous military victories. Stonebridge also used his photographs to illustrate lectures. In 1907, he gave several lectures on \\\"The Training of War,\\\" using colored lantern slides.\", 155d154 < \"subjects_local\": null, 182a180,183 > }, > { > \"uri\": \"https:\\/\\/www.wikidata.org\\/wiki\\/Q1196071\", > \"label\": \"collie\" 236c238,244 < \"physical_description_note_condition\": null --- > \"physical_description_note_condition\": null, > \"description\": [ > \"George Ehler Stonebridge (d. 1941) was an amateur photographer who lived and worked in the Bronx, New York. He left little record of himself, but an invaluable one of his surroundings and interests. Stonebridge lived at several locations in the Bronx with his wife Bella, and their three children Grace, George, and William. He worked at the Northern Gaslight Company, although the position he held is unknown. In addition to taking photographs, Stonebridge wrote poetry and prose about his love of the Bronx, his children, and in honor of military victories. Some of Stonebridge's photographs appeared in local papers. In 1898, he was an authorized reporter and photographer for the North Side News; in 1905 he was an authorized reporter for the Bronx Borough Record and Times, and probably took photographs for that paper as well. Stonebridge was fascinated with the subject of military preparedness. Training rituals and staged battles were one of his favorite photographic subjects. His 1898 poem, \\\"Remember the Maine,\\\" celebrates the United States' victory in the Spanish-American War. He was especially proud of soldiers from the Bronx, and photographed historical tablets throughout the Borough commemorating previous military victories. Stonebridge also used his photographs to illustrate lectures. In 1907, he gave several lectures on \\\"The Training of War,\\\" using colored lantern slides.\" > ], > \"subjects_local\": [ > \"New York\" > ]\n

    Which means your Patch would have been applied!

    In case something went wrong, e.g. any of the operations did not match your source data, you will see a WARNING like this

    Patch could not be applied for Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?]\n
    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_json_patch/#step-4-run-the-json-patch-action-but-for-real","title":"Step 4: Run the JSON Patch Action but for real!","text":"

    Now that actual patching. Repeat from Step 1 to Step 3 but keep \"only simulate and debug affected JSON\" unchecked and follow the steps again. You ADO will be modified and you will get almost no notifications except of an action completed notice (in soothing green). If you check Laddie's ADO RAW json (expand in the same resulting view) it will look now like this

    Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?] JSON after patching
    { \n    \"note\": \"\",\n    \"type\": \"Photograph\",\n    \"viaf\": \"\",\n    \"label\": \"Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?]\",\n    \"model\": [],\n    \"owner\": \"New-York Historical Society, 170 Central Park West, New York, NY 10024, 212-873-3400.\",\n    \"audios\": [],\n    \"images\": [\n        26\n    ],\n    \"models\": [],\n    \"rights\": \"This digital image may be used for educational or scholarly purposes without restriction. Commercial and other uses of the item are prohibited without prior written permission from the New-York Historical Society. For more information, please visit the New-York Historical Society's Rights and Reproductions Department web page at [http:\\/\\/www.nyhistory.org\\/about\\/rights-reproductions](http:\\/\\/www.nyhistory.org\\/about\\/rights-reproductions).\",\n    \"videos\": [],\n    \"creator\": \"\",\n    \"ap:tasks\": {\n        \"ap:sortfiles\": \"index\"\n    },\n    \"duration\": \"\",\n    \"ispartof\": [],\n    \"language\": \"English\",\n    \"documents\": [],\n    \"edm_agent\": \"\",\n    \"publisher\": \"\",\n    \"ismemberof\": [\n        16\n    ],\n    \"creator_lod\": [\n        {\n            \"name_uri\": \"\",\n            \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/pht\",\n            \"agent_type\": \"personal\",\n            \"name_label\": \"Stonebridge, George Ehler\",\n            \"role_label\": \"Photographer\"\n        }\n    ],\n    \"description\": [\n        \"George Ehler Stonebridge (d. 1941) was an amateur photographer who lived and worked in the Bronx, New York. He left little record of himself, but an invaluable one of his surroundings and interests. Stonebridge lived at several locations in the Bronx with his wife Bella, and their three children Grace, George, and William. He worked at the Northern Gaslight Company, although the position he held is unknown. In addition to taking photographs, Stonebridge wrote poetry and prose about his love of the Bronx, his children, and in honor of military victories. Some of Stonebridge's photographs appeared in local papers. In 1898, he was an authorized reporter and photographer for the North Side News; in 1905 he was an authorized reporter for the Bronx Borough Record and Times, and probably took photographs for that paper as well. Stonebridge was fascinated with the subject of military preparedness. Training rituals and staged battles were one of his favorite photographic subjects. His 1898 poem, \\\"Remember the Maine,\\\" celebrates the United States' victory in the Spanish-American War. He was especially proud of soldiers from the Bronx, and photographed historical tablets throughout the Borough commemorating previous military victories. Stonebridge also used his photographs to illustrate lectures. In 1907, he gave several lectures on \\\"The Training of War,\\\" using colored lantern slides.\"\n    ],\n    \"interviewee\": \"\",\n    \"interviewer\": \"\",\n    \"pubmed_mesh\": null,\n    \"sequence_id\": \"\",\n    \"subject_loc\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/subjects\\/sh85038796\",\n            \"label\": \"Dogs\"\n        }\n    ],\n    \"website_url\": \"\",\n    \"as:generator\": {\n        \"type\": \"Update\",\n        \"actor\": {\n            \"url\": \"http:\\/\\/localhost:8001\\/form\\/descriptive-metadata\",\n            \"name\": \"descriptive_metadata\",\n            \"type\": \"Service\"\n        },\n        \"endTime\": \"2022-12-05T09:19:37-05:00\",\n        \"summary\": \"Generator\",\n        \"@context\": \"https:\\/\\/www.w3.org\\/ns\\/activitystreams\"\n    },\n    \"date_created\": \"1910-01-01\",\n    \"issue_number\": null,\n    \"date_published\": \"\",\n    \"subjects_local\": [\n        \"New York\"\n    ],\n    \"term_aat_getty\": \"\",\n    \"ap:entitymapping\": {\n        \"entity:file\": [\n            \"model\",\n            \"audios\",\n            \"images\",\n            \"videos\",\n            \"documents\",\n            \"upload_associated_warcs\"\n        ],\n        \"entity:node\": [\n            \"ispartof\",\n            \"ismemberof\"\n        ]\n    },\n    \"europeana_agents\": \"\",\n    \"europeana_places\": \"\",\n    \"local_identifier\": \"nyhs_PR066_6136\",\n    \"subject_wikidata\": [\n        {\n            \"uri\": \"http:\\/\\/www.wikidata.org\\/entity\\/Q3381576\",\n            \"label\": \"black-and-white photography\"\n        },\n        {\n            \"uri\": \"http:\\/\\/www.wikidata.org\\/entity\\/Q60\",\n            \"label\": \"New York City\"\n        },\n        {\n            \"uri\": \"https:\\/\\/www.wikidata.org\\/wiki\\/Q1196071\",\n            \"label\": \"collie\"\n        }\n    ],\n    \"date_created_edtf\": \"\",\n    \"date_created_free\": null,\n    \"date_embargo_lift\": null,\n    \"physical_location\": null,\n    \"related_item_note\": null,\n    \"rights_statements\": \"In Copyright - Educational Use Permitted\",\n    \"europeana_concepts\": \"\",\n    \"geographic_location\": {\n        \"lat\": \"40.8466508\",\n        \"lng\": \"-73.8785937\",\n        \"city\": \"New York\",\n        \"state\": \"New York\",\n        \"value\": \"The Bronx, Bronx County, New York, United States\",\n        \"county\": \"\",\n        \"osm_id\": \"9691916\",\n        \"country\": \"United States\",\n        \"category\": \"boundary\",\n        \"locality\": \"\",\n        \"osm_type\": \"relation\",\n        \"postcode\": \"\",\n        \"country_code\": \"us\",\n        \"display_name\": \"The Bronx, Bronx County, New York, United States\",\n        \"neighbourhood\": \"Bronx County\",\n        \"state_district\": \"\"\n    },\n    \"note_publishinginfo\": null,\n    \"subject_lcgft_terms\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/genreForms\\/gf2017027249\",\n            \"label\": \"Photographs\"\n        }\n    ],\n    \"upload_associated_warcs\": [],\n    \"physical_description_extent\": \"\",\n    \"subject_lcnaf_personal_names\": \"\",\n    \"subject_lcnaf_corporate_names\": \"\",\n    \"subjects_local_personal_names\": \"\",\n    \"related_item_host_location_url\": null,\n    \"subject_lcnaf_geographic_names\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/names\\/n81059724\",\n            \"label\": \"Bronx (New York, N.Y.)\"\n        },\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/names\\/n79007751\",\n            \"label\": \"New York (N.Y.)\"\n        }\n    ],\n    \"related_item_host_display_label\": null,\n    \"related_item_host_local_identifier\": null,\n    \"related_item_host_title_info_title\": \"\",\n    \"related_item_host_type_of_resource\": null,\n    \"physical_description_note_condition\": null\n}\n

    That is all. Again, keep your JSON Patches safe in a text document, test/try simple things first, look for patterns, look for No-Nos that can become \"tests\" to avoid touching ADOs that do not need to be updated and always remember that the destination type (single value, array or object) of an existing Key might affect your complex logic. Happy Patching!

    Thank you for reading! Please contact us on our\u00a0Archipelago Commons Google Group\u00a0with any questions or feedback.

    Return to the main\u00a0Find and Replace documentation page\u00a0or the\u00a0Archipelago Documentation main page.

    ","tags":["Advanced Batch Find and Replace","JSON Patch Find and Replace","Search and Replace","JSON Patch","JSON Pointer"]},{"location":"find_and_replace_action_text/","title":"Text Based Find and Replace","text":"

    The text-based find and replace is case-sensitive and space-sensitive, and while it's the most simple of the actions, it's quite powerful. For this reason it's important to be very precise and target only what's intended. Below are a guide and some examples of use cases for this action.

    Note

    Please refer to the main Find and Replace documentation page for a general overview of where to find within your Archipelago, a general overview of default options and important notes and workflow recommendations.

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace_action_text/#step-by-step-guide","title":"Step-by-Step Guide","text":"
    1. Go to Tools > Advanced Batch Find and Replace.
    2. Identify and/or Filter the Digital Objects (ADOs) that need updates by Searching and/or using the available Facets.
    3. Either select all (includes results that appear on additional pages) by toggling Select / deselect all results (all pages, x total) or toggle the buttons for individual objects.
    4. Expand the \u25ba Raw Metadata (JSON) for some of the objects and double-check that the text being searched is only targeting what is intended and that the replacement text makes sense.
    5. Select Text based find and replace Metadata for Archipelago Digital Objects content item from the Action dropdown.
    6. If selecting objects individually, expand the Selected X items and review the list.
    7. Press the Apply to selected items button (don't worry, nothing will happen yet).
    8. Add the values for search (JSON Search String) and replace (JSON Replacement String).

    9. If you're absolutely certain about the replacement you have targeted, uncheck the 'only simulate and debug affected JSON' option and select Apply.

      only simulate and debug affected JSON

      This option, which is selected by default, will simulate the action and show the list of objects that would be affected, along with the number of modifications for each object and a total number of results processed. For each JSON key and value affected the modifications will count 2:

      1 for the deletion of the current key and value

      +

      1 for the creation of the modified key and value

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace_action_text/#use-cases-and-examples","title":"Use Cases and Examples","text":"

    Replacing a JSON key

    Use Case: A JSON key is currently singular but should be plural.

    JSON key example with empty array value
    ...\n\"myKey\": [],\n...\n
    JSON key example with array values
    ...\n\"myKey\": [\"strawberries\",\"blueberries\",\"blackberries\"],\n...\n

    Follow the steps above and use the following for the search and replace values:

    Search Value
    \"myKey\":\n
    Replace Value
    \"myKeys\":\n

    Tip

    By using quotes and the colon instead of myKey only, we avoid unintentionally replacing other instances of the text within the JSON.

    After applying the changes, we have the following key:

    JSON key example with empty array value after update
    ...\n\"myKeys\": [],\n...\n
    JSON key example with array values after update
    ...\n\"myKeys\": [\"strawberries\",\"blueberries\",\"blackberries\"],\n...\n

    Replacing a JSON value

    Use Case: After a batch ingest, it was discovered that JSON values across ADOs in multiple keys contain the same typo: Agnes Meyerhoff (two fs) instead of Agnes Meyerhof.

    JSON value example with typo
    ...\n\"creator_lod\": [\n    {\n        \"name_uri\": \"\",\n        \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/art\",\n        \"agent_type\": \"personal\",\n        \"name_label\": \"Meyerhoff, Agnes\",\n        \"role_label\": \"Artist\"\n    },\n    {\n        \"name_uri\": \"\",\n        \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/col\",\n        \"agent_type\": \"personal\",\n        \"name_label\": \"Messenger, Maria, , 1849-1937\",\n        \"role_label\": \"Collector\"\n    }\n],\n\"description\": \"Inscription on mount: \\\"Meyerhoff, Agnes \\\\ Frankfurt - a\\/M. \\\\ Inv el-lith \\\\ Painter.\\\" Inscription on verso: \\\"Agnes Meyerhoff \\\\ Frankfurt a\\/M \\\\ inv. [at?] lith. \\\\ [maker in?]\\\".\",\n...\n

    Follow the steps above and use the following for the search and replace values:

    Search Value
    Meyerhoff, Agnes\n
    Replace Value
    Meyerhof, Agnes\n

    After applying the changes, we have the following values:

    JSON values after update
    ...\n\"creator_lod\": [\n    {\n        \"name_uri\": \"\",\n        \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/art\",\n        \"agent_type\": \"personal\",\n        \"name_label\": \"Meyerhof, Agnes\",\n        \"role_label\": \"Artist\"\n    },\n    {\n        \"name_uri\": \"\",\n        \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/col\",\n        \"agent_type\": \"personal\",\n        \"name_label\": \"Messenger, Maria, , 1849-1937\",\n        \"role_label\": \"Collector\"\n    }\n],\n\"description\": \"Inscription on mount: \\\"Meyerhof, Agnes \\\\ Frankfurt - a\\/M. \\\\ Inv el-lith \\\\ Painter.\\\" Inscription on verso: \\\"Agnes Meyerhoff \\\\ Frankfurt a\\/M \\\\ inv. [at?] lith. \\\\ [maker in?]\\\".\",\n...\n

    Replacing a JSON value with escape characters

    Use Case: The URL for a website that appears in multiple keys needs to be updated from http://hubblesite.org to https://hubblesite.org.

    JSON value example with URL after update
    ...\n\"rights\": \"This digital image may be used for educational or scholarly purposes without restriction. Commercial and other uses of the item are prohibited without prior written permission from the NASA and the Space Telescope Science Institute (STScI). For more information, please visit the NASA and the Space Telescope Science Institute's Copyright web page at [http:\\/\\/hubblesite.org\\/copyright](http:\\/\\/hubblesite.org\\/copyright).\",\n...\n\"description\": \"\\\"The largest NASA Hubble Space Telescope image ever assembled, this sweeping bird\u2019s-eye view of a portion of the Andromeda galaxy (M31) is the sharpest large composite image ever taken of our galactic next-door neighbor. Though the galaxy is over 2 million light-years away, The Hubble Space Telescope is powerful enough to resolve individual stars in a 61,000-light-year-long stretch of the galaxy\u2019s pancake-shaped disk. ... The panorama is the product of the Panchromatic Hubble Andromeda Treasury (PHAT) program. Images were obtained from viewing the galaxy in near-ultraviolet, visible, and near-infrared wavelengths, using the Advanced Camera for Surveys and the Wide Field Camera 3 aboard Hubble. This cropped view shows a 48,000-light-year-long stretch of the galaxy in its natural visible-light color, as photographed with Hubble's Advanced Camera for Surveys in red and blue filters July 2010 through October 2013.\\\" -full description available at: [http:\\/\\/hubblesite.org\\/image\\/3476\\/gallery\\/73-phat](http:\\/\\/hubblesite.org\\/image\\/3476\\/gallery\\/73-phat).\",\n...\n

    Follow the steps above and use the following for the search and replace values:

    Search Value
    http://hubblesite.org\n
    Replace Value
    https://hubblesite.org\n

    Note

    You'll notice that the escape characters for the forward slash (\\/), which appear in the raw JSON, do not need to be included in the search or replace values.

    After applying the changes, we have the following values:

    JSON value example with URL after update
    ...\n\"rights\": \"This digital image may be used for educational or scholarly purposes without restriction. Commercial and other uses of the item are prohibited without prior written permission from the NASA and the Space Telescope Science Institute (STScI). For more information, please visit the NASA and the Space Telescope Science Institute's Copyright web page at [https:\\/\\/hubblesite.org\\/copyright](https:\\/\\/hubblesite.org\\/copyright).\",\n...\n\"description\": \"\\\"The largest NASA Hubble Space Telescope image ever assembled, this sweeping bird\u2019s-eye view of a portion of the Andromeda galaxy (M31) is the sharpest large composite image ever taken of our galactic next-door neighbor. Though the galaxy is over 2 million light-years away, The Hubble Space Telescope is powerful enough to resolve individual stars in a 61,000-light-year-long stretch of the galaxy\u2019s pancake-shaped disk. ... The panorama is the product of the Panchromatic Hubble Andromeda Treasury (PHAT) program. Images were obtained from viewing the galaxy in near-ultraviolet, visible, and near-infrared wavelengths, using the Advanced Camera for Surveys and the Wide Field Camera 3 aboard Hubble. This cropped view shows a 48,000-light-year-long stretch of the galaxy in its natural visible-light color, as photographed with Hubble's Advanced Camera for Surveys in red and blue filters July 2010 through October 2013.\\\" -full description available at: [https:\\/\\/hubblesite.org\\/image\\/3476\\/gallery\\/73-phat](https:\\/\\/hubblesite.org\\/image\\/3476\\/gallery\\/73-phat).\",\n...\n

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the main Find and Replace documentation page or the Archipelago Documentation main page.

    ","tags":["Advanced Batch Find and Replace","Advanced Find and Replace","Find and Replace","Search and Replace","Metadata","Review"]},{"location":"find_and_replace_action_webform/","title":"Webform Find and Replace","text":"

    Webform Find and Replace enables you to search against values found within defined Webform elements to apply metadata replacements with targeted care. Below are a guide and an example use case for this Action.

    Note

    Please refer to the main Find and Replace documentation page for a general overview of where to find within your Archipelago, a general overview of default options and important notes and workflow recommendations.

    ","tags":["Advanced Batch Find and Replace","Webform Find and Replace","Search and Replace"]},{"location":"find_and_replace_action_webform/#important-notes-about-different-webform-elements","title":"Important Notes about Different Webform Elements","text":"

    Maximum Length as Defined by your Webform Element Configuration OR Theme Defaults

    For certain text-based webform element types, the maximum field length (maxlength) defined in your specific webform element configurations will be enforced during Webform Find and Replace operations. If no maximum length is defined, the Admin Theme will enforce a maximum length of 128 characters. Please see our main Webforms documentation for information about configuring webforms in Archipelago.

    Some Complex Webform Elements Not Available

    Please note that some complex webform elements are not available for use with Webform Find and Replace. Any webform element that requires user interactions (such as the Nominatim Open Street Maps lookup/query and selection) is not available for usage. The different file upload webform elements are also not available for use with Webform Find and Replace.

    ","tags":["Advanced Batch Find and Replace","Webform Find and Replace","Search and Replace"]},{"location":"find_and_replace_action_webform/#step-by-step-guide","title":"Step by Step Guide","text":"
    1. Go to Tools > Advanced Batch Find and Replace.
    2. Identify and/or Filter the Digital Objects (ADOs) that need updates by Searching and/or using the available Facets.
    3. If using the 'Ingest Method Service URL' for Faceting, please note that using the Find and Replace Webform functionality to update ADOs will cause the original AMI Set URL identified in this Facet to be overwritten and replaced with the specified Webform used during the replacement execution.
    4. Either select all (includes results that appear on additional pages) by toggling Select / deselect all results (all pages, x total) or toggle the buttons for individual objects.
    5. Expand the \u25ba Raw Metadata (JSON) for some of the objects and double-check that the metadata field and value you are targeting for replacement is present.
    6. Select Webform find-and-replace Metadata for Archipelago Digital Objects content item from the Action dropdown.
    7. If selecting objects individually, expand the Selected X items and review the list.
    8. Press the Apply to selected items button (don't worry, nothing will happen yet).
    9. On the Webform Find and Replace Action Configuration page, you will need to select the configuration options to be applied for your selected ADOs.
    10. From the dropdown:
      1. Select which Webform you want to use
      2. Select which Form element you want to use
      3. Select which value to search for in the [chosen form element] JSON key
      4. Select which value to replace with in the [chosen form element] JSON key
    11. See the Simulation Mode notes here for information about this optional simulation/test mode.
    12. If you're absolutely certain about the replacement you have targeted, uncheck the 'only simulate and debug affected JSON' option and select Apply.
    13. After the operation is executed, check your changes.
    ","tags":["Advanced Batch Find and Replace","Webform Find and Replace","Search and Replace"]},{"location":"find_and_replace_action_webform/#use-case-example","title":"Use Case Example","text":"

    In the following example configuration, for the selected 'Senju no oubashi (Senju great bridge)' object, the Media Type (type JSON key) value of \"Visual Artwork\" will be replaced with the type JSON key value of \"Photograph\".

    • Selection of Single ADO and Webform find-and-replace Action

    • Webform Find and Replace Form

    • Confirmation of Successfully Executed Changes

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the main Find and Replace documentation page or the Archipelago Documentation main page.

    ","tags":["Advanced Batch Find and Replace","Webform Find and Replace","Search and Replace"]},{"location":"firstobject/","title":"Your First Digital Object","text":"

    You followed every Deployment step and you have now a local Archipelago instance. Great!

    So what now? It is time to give your new repository a try and we feel the best way is to start by ingesting a simple Digital Object.

    Note

    This guide will assume Archipelago is running on http://localhost:8001, so if you wizardly deployed everything in a different location, please replace all URIs with your own setup while following this guide.

    "},{"location":"firstobject/#requirements","title":"Requirements","text":"
    • Running Archipelago (http://localhost:8001)
    • 20 minutes of your time.
    • Open Mind.
    "},{"location":"firstobject/#welcome","title":"Welcome!","text":"

    Start by opening http://locahost:8001 in your favourite Web Browser.

    Your Demo deployment will have a fancy Home page with some banners and a small explanation of what Archipelago is and can do. Feel free to read through that now or later.

    Click on Log in in the top left corner and use your demo credentials from the deployment guide.

    • user: demo
    • pass: demo

    (or whatever password you decided was easy for you to remember during the deployment phase)

    Press the Log in button.

    Great, welcome demo user! This users has limited credentials and uses the same global theme as any anonymous user would. Still, demo can create content, so let's use those super powers and give that a try.

    You will see a new Menu item under Tools on the top navigation bar named Add Content. Click it!

    "},{"location":"firstobject/#brief-background","title":"Brief Background","text":"

    As you already know Archipelago is build on Drupal 8/9, a very extensible CMS. In practice that means you have (at least) the same functionality any Drupal deployment has and that is also true for Content Managment.

    Drupal ships by default with a very flexible Content Entity Type named Node. Nodes are used for creating Articles and simple Pages but also in Archipelago as Digital Objects. Drupal has a pretty tight integration with Nodes and that means you get a lot of fun and useful functionality by default by using them.

    Want to know more about Entities?

    An Article and a Digital Object are both of type Nodes, but each one represents a different Content Type. Content Types are also named Bundles. An individual Content, like \"Black and White photograph of a kind Dog\" is named a Content Entity or more specific in this case a Node.

    What have Article and Digital Object Content types in common and what puts the apart?

    • Each Content Type or Bundle has a set of Base Fields and also user configurable set of Fields attached (or bundled together).
      • E.g. Article has a title, a Body and the option to add an image.
      • Digital Object has a title but also a special, very flexible one named Strawberry Field (more about that later).

    • Fields are where you put your data into and also where your data comes from when you expose it to the world.

      • Nodes, as any other Content entity have Base Fields (which means you can't remove or configure them) that are used all over the place. Good examples are the title and also the owner, named uid (you!).
      • Other Fields, specific to a Content Type, can be added and configured per Bundle.
      • A Field Widget is used to input data into a Field.
      • Each field can have a Field Formatter that allows you to setup how it is displayed to the World.
      • A set of Field Formatters (the way you want to show your content formatted to the world) is named a Display Mode. You can have many, create new ones and remove them, but only use one at the time.
      • A set of Field Widgets (the way you want to Create and Edit a Node) is named a Form Mode. You can also have many, create new ones but only use one at the time.

    • Each Content Type can have different Permissions (using the build in User Roles system).

    • Each Content Type can have one or more Display Modes. In Practice this means Display Modes are attached to Content Types.
      • Each display modes can have its own Permissions
    • Each Content Type can have one or more Form Modes. In Practice this means Form Modes are attached to Content Types.
      • Each Form Mode can have its own Permissions.

    There is of course a lot more to Nodes, Content Types, Formatters, Widgets and in general Content Entities but this is a good start to understand what will happen next.

    "},{"location":"firstobject/#adding-content","title":"Adding Content","text":"

    Below you see all the Content Types defined by default in Archipelago. Let's click on Digital Object to get your first Digital Object Node.

    "},{"location":"firstobject/#my-metadata","title":"My Metadata","text":"

    What you see below is a Form Mode in action. A multi-step Webform that will ingest metadata into a field of type Strawberry Field (where all the magic happens) attached to that field using a Webform Field Widget, an editorial/advanced Block on the right side, and a Quick Save button at the bottom for saving the session.

    Let's fill out the form to begin our ingest. We recommend using similar values as the ones shown in the screen capture to make following the tutorial easier.

    Make sure you select Photograph as Media Type and all the fields with a red * are filled up. Then press Move on to next step at the bottom of the webform to load the next step in line.

    "},{"location":"firstobject/#collections","title":"Collections","text":"

    Since this is our first digital object we do not yet have a Digital Object Collection for which My First Digital Object could be a member of. In other words, you can leave Collection Membership blank and click Next: Upload Files.

    Why does this look different than Repository X?

    We assume you come from a world where repositories define different Content types and the shape, the fields and values (Schema) are fixed and set by someone else or at least quite complicated to configure. This is where Archipelago differs and starts to propose its own style. You noticed that there is a single Content Type named Digital Object and you have here a single Web Form. So how does this allow you to have images, sequences, videos, audio, 3D images, etc?

    There are many ways of answering that, Archipelago works under the idea of an (or many) Open Schema(s), and that notion permeates the whole environment. Practical answer and simplest way to explain based on this demo is:

    • The Digital Object is a generic container for any shape of metadata. Metadata is generated either via this Webform-based widget you're currently using, manually (power-user need only) or via APIs. Because of this, Metadata can take any shape to express your needs of Digital Objects and therefore we do not recommend making multiple Digital Object types. However, if you ever do need more Digital Object types, the option is available.
    • The Strawberry field Field Widget allows you to attach any Webform, built using the Webform Module and Webforms can be setup in almost infinite ways. Any field, combo, or style can be used. Multi Step, single step - we made sure they always only touch/modify data they know how to touch, so even a single input element webform would ensure any previous metadata to persist even if not readable by itself (See the potential?). And Each Webform can be also quite smart!
    • The Strawberry field Field Widget will take all your Webform input, process any uploaded files, generate a JSON representation, enrich and complement it with Archipelago specific data and save it for you inside the Strawberry field.

    We will come back to this later.

    "},{"location":"firstobject/#linked-data","title":"Linked Data","text":"

    As the name of this step suggests; you will be adding all your Linked Data elements here. This step showcases some of the autocomplete Linked Data Webform elements we built for Archipelago. We truly believe in Wikidata as an open, honest, source of Linked Open Data and also one where you can contribute back. But we also have LoC autocompletes and Getty.

    Again, enter all fields with a red * and when you are finished, click Move on to next step

    Tip

    When entering a location, place or address you will need to click on the Search OpenStreet Maps button, which is what that big red arrow is pointing to in the screenshot below.

    "},{"location":"firstobject/#upload-files","title":"Upload Files","text":"

    Now we will upload our Photograph. Click Choose Files to open your file selector window and choose which file you would like to ingest.

    Once you've uploaded your file, you will see all the Exif data extracted from the image, like so...

    Once you've mentally digested all of that data, let's go ahead and click Save Metadata.

    Wait! Why only the metadata? I'm ready for this Digital Object to be shared with the world!

    By clicking Save Metadata we are simply persisting all the metadata in the current webform session. The actual ingest of the Object happens when you click Save on the next and final step, Complete.

    "},{"location":"firstobject/#complete","title":"Complete","text":"

    Alright, we've made it. We've added metadata, linked Data, uploaded our files and now... we're ready to save! Go ahead and change the status from Draft to Published and click Save.

    Once you hit save you should see the following green message and your first Archipelago Digital Object!

    Congratulations on creating your first digital object! \ud83c\udf53

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"fragaria/","title":"Fragaria Redirects Module","text":"

    Archipelago's Fragaria Redirect Module is a Drupal 9/10 module that provides dynamic redirect routes matched against existing Search API field values. This module will also provide future Unique IDs (API) integrations and PURLs.

    ","tags":["Fragaria","Redirects"]},{"location":"fragaria/#prerequisites","title":"Prerequisites","text":"

    Before proceeding with the following configuration steps, you need to first create the Strawberry Key Name Provider and Solr Field that corresponds to the Field that will be matched against the variable part of the route exists.

    In other words, if your Digital Objects have a field and value such as:

        \"legacy_PID\": [\n        \"mylegacyrepo:1234\"\n    ],  \n

    You need to make sure the values from the legacy_PID JSON key are indexed (as a Solr/Search API Field) and ready for use as part of the Fragaria Redirects configuration.

    Best Practice

    Your new Solr field should to be of field type \"String\" for a perfect match and best results. Using \"Full Text\" or a related variant Solr field type will allow for a partial match, which might lead multiple original URLs redirecting to the first match in Archipelago.

    ","tags":["Fragaria","Redirects"]},{"location":"fragaria/#fragaria-redirect-entity-configuration","title":"Fragaria Redirect Entity Configuration","text":"

    1. Navigate to /admin/config/archipelago/fragariaredirect.

    2. Select the Add a Redirect Config button.

    3. Enter a label for the Fragaria Redirect Entity you are configuring.

    4. Enter the Prefix (that follows your domain) for the Redirect Route.

      • Do not use node/ or do/ as a Prefix. Even if these will technically work (redirect), using either of these Prefix paths will override your existing Paths defined by Drupal and Archipelago.

    5. If applicable, enter the the Suffixes (that follow the prefix + the variable part) for the Redirect Route.

      • Enter one by line. This configuration option is not required.
      • Check/uncheck the option to Instead of fixed Prefixes add a single {catch_all} variable suffix at the end as needed. Checking this will disable any entered static suffixes.

    6. Select the Search API Index where the Field that will be matched against the variable part of the route exists.

    7. Select the Search API Field that will be matched against the variable part of the route.

    8. If applicable, add static prefixes for to the variable part/argument of the path.

      • Enter one by line. This is useful when the variable part of the ROUTE does not match 1:1 the actual indexed data. e.g the route is /oldrepo/1 and the indexed value is \"namespace:1\". In that case add \"namespace:\" here.

    9. Add static suffixes for to the variable part/argument of the path.

      • Enter one by line. This is useful when the variable part of the ROUTE does not match 1:1 the actual indexed data. e.g the route is /oldrepo/namespace:1 and the indexed value is \"namespace:1-page\". In that case add \"-page\" here.

    10. Select the Type of HTTP redirect to perform.

      • Option 1: Temporary Redirect (forced GET)
      • Option 2: Permanent Redirect

    11. Lastly, select the box next to Is this Fragaria Redirect Route active? to set your Redirect to active, and Save your configuration.

    ","tags":["Fragaria","Redirects"]},{"location":"fragaria/#example-redirects-configuration","title":"Example Redirects Configuration","text":"

    The above example configuration would enable a Temporary redirect from a legacy repository site with a URL of https://mylegacyrepo.edu//mylegacyrepo/object/mylegacyrepo:1234 to your new Archipelago PURL of https://mynewarchipelagorepo.edu/do/mynewADOUUID.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Fragaria","Redirects"]},{"location":"generalqa_minio_logging/","title":"Min.io Logging","text":"

    Q: How can I see my minio (S3) docker container's realtime traffic and requests?

    A: For standard demo deployments, mini.io storage server runs on the esmero-minio docker container. Steps are:

    1. Install the mc binaries (minio client) for your platform following this instructions. e.g for OSX run on your terminal:

      brew install minio/stable/mc\nmc alias set esmero-minio http://localhost:9000 user password\n

      with http://localhost:9000 being your current machines mini.io URL and exposed port, user being your username (defaults to minio) and your original choosen password (defaults to minio123)

    2. Run a trace to watch realtime activity on your terminal:

      mc admin trace -v -a --debug  --insecure --no-color esmero-minio\n

    Note: mc client is also AWS S3 compatible and can be used to move/copy/delete files on the local instance and to/from a remote AWS storage.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"generalqa_smtp_configuration/","title":"SMTP Configuration","text":"

    Q: How can I enable SMTP for Archipelago?

    A: For standard demo deployments, SMTP is not setup to send emails. To enable SMTP:

    1. Enter the following commands in your terminal. Note: make sure docker is running. Optionally, you can verify that all Archipelago containers are present by entering the docker ps command first.

      docker exec -ti esmero-php bash -c 'php -dmemory_limit=-1 /usr/bin/composer require drupal/smtp:^1.0'\ndocker exec -ti esmero-php bash -c 'drush en -y smtp'\n

    2. Check that the SMTP module has been enabled by navigating (as admin user) to the EXTEND module menu item (localhost:8001/admin/modules). You should see \"SMTP Authentication Support\" listed.

    3. Navigate to localhost:8001/admin/config/system/smtp to configure the SMTP settings.

      This screenshot shows settings if a GMAIL account is used.

    4. Save your settings, then test by adding a recipient address in the \u201cSEND TEST E-MAIL\u201d field.

    Note: Depending on your email provider, you may also need to enable \u201cless secure\u201d applications in your account settings (such as here for Google email accounts: https://myaccount.google.com/lesssecureapps)

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"generalqa_twig_modules_configuration/","title":"Twig Modules Configuration","text":"

    Q: When attempting to save a Twig template for a Metadata Display, I receive an error message related to an Unknown \"bamboo_load_entity\" function.

    A: You need to enable the necessary Twig modules.

    1. Navigate to: yoursite/admin/modules

    2. In the \u201cEnter a part of the module name or description\u201d box, enter \u201cbam\u201d to filter for the related Bamboo Twig modules. Alternatively, scroll down to the Bamboo Twig modules section on this page.

    3. Check the box next to each of the following to enable (some may already be enabled):

      • Bamboo Twig
      • Bamboo Twig - Loaders
      • Bamboo Twig - Path & Url
      • Bamboo Twig - Token

    4. Click Install.

    5. After receiving the successful installation confirmation, check to make sure you are now able to save your Twig template without receiving an error message.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"giveortake/","title":"Archipelago Contribution Guide","text":"

    Contributing Documentation

    Looking to contribute documentation? Start here.

    Archipelago welcomes and appreciates any type of contribution, from use cases and needs, questions, documentation, devops and configuration and -- of course -- code, fixes, or new features. To make the process less painful, we recommend you first to read our documentation and deploy a local instance. After that please follow the guidelines below to help you get started.

    Archipelago welcomes, appreciates, and recognizes any and all types of contribution. This includes input on all use cases and needs, questions or answers, documentation, DevOps, and configurations. We also welcome general ideas, thoughts, and even dreams for the future of our repository! Of course, we also invite you to contribute PHP code, including fixes and new features.

    We will be helpful, kind, and open. We encourage discussions and always respect one another's opinions, language, gender, style, backgrounds, origins, and destinations, provided they come from the same root values of respect, as stated here. We support conflict resolution using nothing more than basic common sense. We value diversity in all its shapes, forms, colors, epoches, numbers, and kinds, with or without labels, including in-between and evolving. We always assume we can do better and that you have done a lot. Under this very basic social framework, this is how we hope you can contribute:

    "},{"location":"giveortake/#where-the-wild-things-live","title":"Where The Wild Things Live","text":"

    Archipelago has 5 active GitHub repositories

    • Strawberryfield What? Code: Deals with metadata storage and exposure to Drupal. Events/Subscribers that trigger when content is modified. The way internal pieces of JSON are exposed to the rest of the ecosystem. Core to all of what Archipeleago is as a concept. One of its Drupal forms is a Field.
    • Webform Strawberryfield What? Code: Deals with UI based ingest of content using webforms. How files and media are attached to JSON, how tech md is extracted, and any interaction that happens during the edit and ingest processes via a form. In its Drupal form it provides a Field Widget for Strawberryfield.
    • Format Strawberryfield What? Code: Deals with exposing and transforming the JSON when navigating the site. What is displayed, how it is displayed. Provides templating, metadata display entities via Twig, and direct file downloads. In its Drupal form it provides many field formatters for Strawberryfield` and a content entity for the Twig templates.
    • Archipelago Deployment What? DevOps: Docker-compose deployment strategy, including a full skeleton project with persistence folders for Min.io, DB, Solr, Cantaloupe and Drupal 8. Includes initial deployment configurations, which modules are enabled, how things look in Drupal 8 and some scripts plus the deployment documentation for both OSX and Linux.
    • Archipelago Documentation What? Documentation: This guide and whatever we manage to write to explain Archipelago goes here.
    "},{"location":"giveortake/#questions-answers-and-in-transit-between-both-ends","title":"Questions, Answers and In Transit Between Both Ends","text":"

    We host a community interaction channel, our google group. This is the best place to ask questions and make suggestions that are not specific to a single module, and/or if you would like to contribute to a larger conversation within our community. Discussions work best in this forum (not excluding GitHub of course), and our official announcements are posted there too.

    "},{"location":"giveortake/#documentation-workflow","title":"Documentation Workflow","text":"

    Documentation is an evolving effort, and we need help. This guide lives in GitHub in Archipelago Documentation. Documentation and Development Worklfow both work the same way, so keep reading!

    "},{"location":"giveortake/#development-workflow","title":"Development Workflow","text":"

    Start by reading open ISSUES (so you don't end up redoing what someone else is already working on) and looking at our Roadmap for version 1.0.0. If the solution to your problem is not there or if there is an unchecked element in the roadmap, this is a great opportunity to help by creating a new ISSUE.

    Next, start by opening an GitHub ISSUE in any of the 5 GitHub repositories, depending on what it is you are trying to do.

    Please be concise with the title of your ISSUE so that it is easy to understand. Use Markdown to explain the what, how, etc, of your contribution. Note: Even if something related is already in the works, you can still contribute. Just add your comments on any open ISSUE. Or, if you think you want to contribute with a totally different perspective, feel free to open a new ISSUE anyway. We can always discuss next steps starting from there. Every community has its rhythm and style and our style is just beginning to develop. We are still figuring out what works best for everyone.

    Once you are done and you feel comfortable working to make a change yourself, take note of the ISSUE number (lets name it #issuenumber).

    The gist is:

    • Fork the GitHub repository where you created the ISSUE, decide which branch you want to change.
    • Make a new branch out of that one and name it ISSUE-#issuenumber. E.g if #issuenumber is 6, name your branch ISSUE-6.
    • Make changes in that branch and send a pull request.

    As a best practice, we encourage pull requests to discuss/fix existing code, new code, and documention changes.

    For the full step-by-step workflow, we will use Archipelago Documentation and the 1.0.0 branch as example. The same applies to any of the other repositories: just change the remote urls and use the most current branch name.

    "},{"location":"giveortake/#example-set-up-archipelago-documentation-github-repository","title":"Example: Set Up Archipelago Documentation GitHub Repository","text":"

    Fork the Archipelago Documentation Upstream source repository to your own personal GitHub account (e.g. YOU). Copy the URL of your Archipelago Documentation fork (you will need it for the git clone command below).

    $ git clone https://github.com/YOU/archipelago-documentation\n$ cd archipelago-documentation\n$ git checkout 1.0.0\n
    "},{"location":"giveortake/#set-up-git-remote-as-upstream","title":"Set Up Git Remote As upstream","text":"
    $ git remote add upstream https://github.com/esmero/archipelago-documentation\n$ git fetch upstream\n$ git merge upstream/1.0.0\n...\n
    "},{"location":"giveortake/#create-your-issue-branch","title":"Create Your ISSUE Branch","text":"

    Before making changes, make sure you create a branch using the ISSUE number you created for these contributions.

    $ git checkout -b ISSUE-6\n
    "},{"location":"giveortake/#do-some-clean-up-and-test-locally","title":"Do Some Clean Up and Test Locally","text":"

    After your code changes, make sure

    • If modifying PHP, run phpcs --standard=Drupal yourchanged.file.php. We (try our best to) use Drupal 8 coding standards.
    • If modifying a MARKDOWN file, make sure it renders well (you can use Textmate, Atom, Textile, etc to preview) and that links are not broken.
    • If writing large pieces of code, add PHP Tests. We can help if you don't know how (tell us in the ISSUE). Tests will be enforced starting with the first stable release.
    • If modifying PHP, please test your changes live on your local instance of Archipelago. All non-documentation modules are already inside web/modules/contrib/.
    "},{"location":"giveortake/#commit-changes","title":"Commit Changes","text":"

    After verification, commit your changes. This is very good post on how to write commit messages.

    $ git commit -am 'Fix that Strawberry'\n
    "},{"location":"giveortake/#push-to-the-branch","title":"Push To The Branch","text":"

    Push your locally committed changes to the remote origin (your fork)

    $ git push origin ISSUE-6\n
    "},{"location":"giveortake/#create-a-pull-request","title":"Create A Pull Request","text":"

    Pull requests can be created via GitHub. This document explains in detail how to create one. After your Pull Request gets peer reviewed and approved, it can be merged. Discussion can happen and peers can ask you for modifications, fixes or more information on how to test. We will be respectful. You will be given credit for all your contributions and shown appreciation. There is no wrong and never too little. There could never be too much!

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"googleapi/","title":"Configuration for Google Sheets API","text":"

    To allow the Archipelago Multi Importer (AMI) to read from Google spreadsheets, you first need to configure the Google Sheets API as outlined in the following instructions.

    Please note:

    • Frequent changes to the Google Sheets API specifications may impact the configurations needed.
    • This set of instructions will only work for individuals using Google accounts affiliated with Organizations.
    • Please contact us on our Archipelago Commons Google Group with any questions/issues.
    "},{"location":"googleapi/#generating-google-oauth2-credentials","title":"Generating Google OAuth2 Credentials","text":"

    1. Login to the Google Developer Console. You will see the API & Services Dashboard.

    2. If you have not created Credentials or a Project before, you will need to first create a Project.

      • Recommended Project Name: \"Archipelago Multi Importer\" or \"AMI\".
      • The Organization and Location information should be specific to you and your organization/institution.

    3. Next, click the Create credentials select box and select OAuth client ID

    4. You will now need to Configure the Consent Screen.

    5. On the initial OAuth Consent Screen setup, select Internal for User Type.

    6. Now enter AMI as the App name, and your email address in the User support email. You may also wish to add Authorized domains (bottom of image below) as well.

    7. On the Scopes page, select Add or Remove Scopes. Then either search/filter the API table for the Google Sheets API. Or, under Manually add scopes enter: https://www.googleapis.com/auth/spreadsheets.readonly

    8. After selecting or entering in the Google Sheets API, you should see this listed under Sensitive Scopes.

    9. Review the information on the Summary page, then Save.

    10. You will now be able to Create Oauth client ID. Select Web Application as the Application type

    11. Enter \"AMI\" under 'Name' and add any URIs you will be using below.

      • For using AMI within your local Archipelago environment, enter http://localhost:8001/google_api_client/callback

      • All URIs need to include /google_api_client/callback

    12. After Saving, you will see a message notifying you that the OAuth client was created. You can copy the Client ID and Client Secret directly from this confirmation message into a text editor. You can also access the information from Credentials in the APIs & Services section in the Developer console, where you will have additional options for downloading, copying, and modifying if needed.

    13. On the 'Add Google Api Client account' configuration page, enter the following information using your Client ID and Client Secret. 'Developer Key' is optional. Select Google Sheets API under 'Services' and https://www,googleapis.com/auth/spreadsheets.readonly under 'Scopes'. Check the box for Is Access Type Offline. Select the Save button.

    14. You will now need to Authenticate your AMI Google API Client. Return to the Google API Client Listing page. Under the Operation menu on the right-hand side of the AMI client listing, select Authenticate.

    15. You will be directed to the Google Consent Screen. You may need to login to your corresponding Google Account before proceeding. When loged in, you will see the following screen requesting that AMI is allowed to \"View your Google Spreadsheets\". Click Allow.

    16. On the Google API Client Listing page, your AMI client listing should now have 'Yes' under 'Is Authenticated'. You are now ready to use Google Sheets with AMI! Return to the main AMI documentation page to get started.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"inthewild/","title":"Archipelagos in the Wild \ud83d\uddfa\ufe0f","text":"

    Explore Archipelago instances running free across digital realms.

    Note

    *Please be aware that some of the following Archipelago instances are still brewing and these links may change. Stay tuned for future updates to live production sites when available.

    "},{"location":"inthewild/#metro-archipelago","title":"METRO + Archipelago","text":"

    The Archipelagos listed below are supported by the Digital Services Team at the Metropolitan New York Library Council. \ud83e\uddd1\u200d\ud83c\udf3e \ud83d\udc1d \ud83c\udf53

    • Archipelago Playground and Studio Site

      • METRO's public Archipelago playground to experiment, learn, and evaluate.

    • Barnard College

    • Digital Culture of Metropolitan New York (DCMNY)

    • Empire Archival Discovery Cooperative (EADC) Finding Aid Toolkit

      • Supported by the Southeastern New York Library Resources Council (SENYLRC)

    • Empire Immersive Experiences

      • Supported by the Western New York Library Resources Council (WNYLRC)

    • Frick Collection and Webrecorder Team Web Archives Collaboration

    • Hamilton College Library & IT Services

    • Olin College Library Phoenix Files

      • *Early adopter - live since Summer 2020

    • New York State COVID-19 Personal History Initiative

    • Rensselaer Polytechnic Institute Libraries

    • San Diego State University Libraries Digital Collections

    • Union College Library

    • Western Washington University

      • Migration to Archipelago began Summer 2022; Launch of new site ~Winter 2023/24
    "},{"location":"inthewild/#neighborhood-archipelagos","title":"Neighborhood Archipelagos","text":"

    From all around our beautiful shared world. \ud83c\udfe1 \ud83c\udfeb \ud83c\udfdb\ufe0f

    • Amherst College

      • Migration to Archipelago began Spring 2022

    • Association Montessori Internationale

      • Development of Archipelago environment began Summer 2022; Launch of new site Spring 2024

    • California Revealed

    • Christian Observatory of the Pro Civitate Christiana

    • Consiglio Nazionale delle Ricerche / National Research Council of Italy

      • https://dbopen.ba.cnr.it/
      • https://archiplavit.to.cnr.it/
      • https://vitisgrinzane.ipsp.cnr.it/
      • http://archipelago.byterfly.eu/ \ud83e\udd8b
        • Virtual Tour Santuario Paola

    • University of Edinburgh Libraries

      • Development of Archipelago environment began Summer 2022
    "},{"location":"inthewild/#we-should-be-here","title":"We should be here","text":"

    If you have a public Archipelago instance you'd like to share on this page \ud83c\udfdd\ufe0f\ud83d\udccd, please contact us. We would love to add your great work to this list! \ud83d\udc9a

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"metadata_display_preview/","title":"Metadata Display Preview","text":"

    Archipelago's Metadata Display Preview is a very handy tool for your repository toolkit that enables you to preview the output of your Metadata Display (Twig) Templates (found at /metadatadisplay/list). You can use the Metadata Display Preview to test and check the results of any type of Template (HTML Display, JSON Ingest, IIIF JSON, XML, etc.) against both Archipelago Digital Objects (ADOs) and AMI Sets (rows within).

    Prerequisite Note

    Before diving into Metadata Display (Twig) Template changes, we recommend reading our Twigs in Archipelago documentation overview guide and also our Working with Twig primer.

    ","tags":["Metadata Display","Twig Template","Preview"]},{"location":"metadata_display_preview/#step-by-step","title":"Step-by-Step","text":"

    1. Navigate to the Metadata Display list at /admin/content/metadatadisplay/list (or through the admin menu via Manage > Content > Metadata Displays). From the main Metadata Display List page, you can access all of the different display, rendering, and processing templates found in your Archipelago.

      Selecting a Metadata Display Template

    2. Open and select 'Edit' for the Template you wish to Edit and/or Preview.

      Editing a Metadata Display Template

    3. You will now be able to select either an Archipelago Digital Object (ADO) or AMI Set to Preview. Both selection types will use an autocomplete search (make sure the autocomplete matches fully against your selection before proceeding).

      Archipelago Digital Object (ADO) selection

      AMI Set and Row selection

      For the Row, you can enter either a (CSV row) number

      AMI Set and Row selection

      Or a label found within the Source Data CSV:

    4. After you select your ADO or AMI Set and press the Show Preview button, the fuller Preview section will open up on the right side of the screen. The left side will continue to show the Metadata Display Template you originally selected to Edit.

      Tip

      It is strongly recommended to always select the option to \"Show Preview using native Output Format (e.g. HTML)\".

      Archipelago Digital Object (ADO) selection against an HTML Display template

      AMI Set and Row selection against a JSON Ingest template

    5. To keep track of the JSON keys used in your template select the Show Preview with JSON keys used in this template option before pressing Show Preview. For more details see below.

    6. Within the Preview Section on the right side of the screen:

      • The top section contains full JSON metadata record for the selected digital object or AMI Set + specified row.
      • If previewing against an AMI Set + specified row, the middle section will show the 'Reconciliated LoD' for the selected row if you have used AMI LoD Reconciliation for the selected AMI Set.
      • The bottom section will show the rendered Output from the Template using the metadata from the selected ADO or AMI Set + specified row.

    7. From the Edit + Preview mode, you can:

      • Add and edit additional JSON keys to an HTML-output Display Template, such as subjects from LoD sources, found in your digital objects and collections data.
      • Preview your incoming AMI Sets against your Ingest Template to ensure all your Source Data CSV columns and values are being being mapped properly to their Archipelago destination JSON keys; And make adjustments as needed.
      • Enrich a provided schema-based XML template to incorporate more elements found in your Archipelago environment.
      • And more \ud83e\uddd1\u200d\ud83c\udf73\ud83c\udfa8\ud83c\udfc4

    8. Select the Show Preview button as you make changes to refresh the Preview output and check your work. After saving any changes you may have made to your selected Template, all of the displays/AMI Sets/other outputs that reference this same Template will reflect the changes made.

    ","tags":["Metadata Display","Twig Template","Preview"]},{"location":"metadata_display_preview/#metadata-display-preview-json-key-variables","title":"Metadata Display Preview JSON Key Variables","text":"

    Note

    This feature is available as of strawberryfield/format_strawberryfield:1.2.0.x-dev and archipelago/ami:0.6.0.x-dev. To make use of it before the official 0.6.0/1.2.0 release you can run the following commands:

    1. Alias the next release branches with the current dependency requirement versions: 
      docker exec -ti esmero-php bash -c \"composer require 'archipelago/ami:0.6.0.x-dev as 0.5.0.x-dev' 'strawberryfield/format_strawberryfield:1.2.0.x-dev as 1.1.0.x-dev'\"\n
    2. Then run any database updates: 
      docker exec -ti esmero-php bash -c \"drush updb\"\n
    3. And finally, clear the cache: 
      docker exec -ti esmero-php bash -c \"drush cr\"\n

    When creating or editing a Metadata Display Twig template, you can keep track of the JSON keys being used in the template by enabling the option after selecting an Archipelago Digital Object (ADO) or AMI Set row before pressing Show preview:

    Enable Metadata Display Preview Variables

    The last two tabs in the Preview section above expand to show two tables listing the JSON keys that are used and unused by the template. The used keys are sorted by first instance line number (from the template) and the unused keys are sorted alphabetically.

    Metadata Display Preview Variables Used JSON Keys

    Metadata Display Preview Variables Unused JSON Keys

    The JSON Keys that appear in these tables will vary based on changes to the template and the selected ADO or AMI set row.

    ","tags":["Metadata Display","Twig Template","Preview"]},{"location":"metadata_display_preview/#warnings-and-errors","title":"Warnings and Errors","text":"

    Warnings and Errors encountered during the processing will be shown at the top of the Preview section. A line number (from the template) will be included in the message if available.

    Warning

    A Warning will be generated if output can be rendered, and the output will be displayed below it.

    Error

    An Error will be generated if no output can be rendered, and no output will be displayed.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Metadata Display","Twig Template","Preview"]},{"location":"metadatainarchipelago/","title":"Your JSON, our JSON - RAW Metadata in Archipelago","text":"

    From the desk of Diego Pino

    Archipelago's RAW metadata is stored as JSON and this is core to our architecture. To avoid writing RAW over and over, this document will refer to RAW Metadata simply as Metadata.

    Data and Metadata can be extremely complex and extensive. The use cases that define what Data, Media and Metadata to collect, to catalog and expose, to use during search and discovery or to enable interactive functionality, including questions like \"what public facing schemas, formats and serializations I need or want to be compliant with\" are as diverse and complex as the Metadata driving them.

    But also Metadata, in specific, is plastic and evolving as are use cases. And more over, some Metadata is descriptive and some Metadata is technical and there are other types of Metadata too, e.g Control Metadata.

    Finally Metadata is very close to their generators. Means you and your peers will know, better than any Software Development team, what is needed, useful and, many times also, available given what use case you have, end users needs and resources at hand, your In real life workflows and future expectations.

    "},{"location":"metadatainarchipelago/#reason-behind-using-json","title":"Reason behind using JSON","text":"
    • Complex hierarchical Metadata needs to be machinable (and fast)
    • All types of Metadata might need to be \"easy to access\" while generating output, visualizations, search and discovery.
    • The shape of this Metadata might need to change and adapt in time. Idea that supports Open Schema v/s a highly structured and fixed Schema, e.g Relational database (RDB) for most of the use cases we think Archipelago can cover.
    • JSON is shareable, portable, easy to validate online and offline.
    • JSON is compact.
    • JSON is searchable/filterable using Query Languages like JSONPATH and JMESPATH.
    • JSON is easy to patch and modify in batches.
    • JSON is platform agnostic and has been around for decades and has not changed since then.
    • JSON is typed and allows ordering/sorting of data easily.
    "},{"location":"metadatainarchipelago/#drupal-and-json","title":"Drupal and JSON","text":"

    Drupal, the OSS CMS system Archipelago uses and extends, is RDB driven. This means that Content Types normally follow the idea of an Entity with Fields attached. Each of these Fields becomes then a Database Table and the sum of all these fields living under a Content Type definition, a fixed schema.

    For integration and interoperability reasons with the larger Drupal ecosystem, we inherit in Archipelago the idea of an Entity, in specific, a Content Entity (Node) and Content Type (Bundled fields for a Node). But instead of generating (and encouraging) the use of hundreds of fixed fields to describe your Digital Objects we put all Metadata as JSON, means a JSON BLOB, into a single smart Field of type Strawberry Field. \ud83c\udf53

    We go a long way of making as much as possible flexible and dynamic. This also implies the definition (and separation) of what an Archipelago Digital Object (ADO) is in our Architecture v/s what a general Drupal Content Type (e.g a static page or a blog post) is defined in code as: \"Any Content type that uses a Strawberry Field is an ADO and will be processed as such\". No configuration is needed. In other words, all is a NODE but any node that uses a Strawberry Field gets a different treatment and will be named in Archipelago an ADO.

    One of the challenges of our flexible approach is how to allow Drupal to access the JSON in a way, as native as possible, to generate filtered listings via Drupal Views, free text Search and Faceting. To make this happen Strawberry Field uses a JSON Querying and Exposing as \"Native Field Properties\" logic. Through a special type of Plugin system named Strawberry Key Name Providers and associated Configuration Entities (can be found at /admin/structure/strawberry_keynameprovider), you have control on which keys and values of your JSON are going to be exposed as field properties of any Strawberry Field, allowing Drupal through this to access values in a flat manner and expose them to the Search API natively. The access to the values of any JSON is done via JMESPATH expressions and then transformed either to a list of values or even \"cast\" into more complex data Data types, like an Entity Reference (means a connection to another Entity).

    This gives you a lot of power and control and makes a lot of very heavy operations lighter. You can even plan upfront or evolve these properties in time.

    In other words, you control how storage is mapped to Discovery and this allows Drupal Views to work that way too. Of course this also means traditional SQL based Drupal Views won't have access to these internals (for filtering) given that your JSON data nor the virtual Properties generated via Strawberry Key Name Providers are not accessible as individual RDB tables to generate SQL joins and that is why we heavily depend on the Search API (Solr).

    "},{"location":"metadatainarchipelago/#open-schema-what-is-yours-what-is-archipelagos","title":"Open Schema. What is yours, what is Archipelago's","text":"

    What can you add to an ADO's Strawberry Field? As long as it is valid JSON, Archipelago can store it, display it, transform it and search across it in Archipelago. The way you manage Metadata can be as \"intime\" or \"aligned\" to other schemas as you want. Still, there are a few suggested keys/functional ideas:

    "},{"location":"metadatainarchipelago/#suggested-json-keys","title":"Suggested JSON keys","text":""},{"location":"metadatainarchipelago/#the-type-key","title":"The type key","text":"
    {\n  \"type\": \"Photograph\"\n}\n

    The type JSON key has a semantic and functional importance in Archipelago. Given that we don't use multiple Drupal Content Types to denote the difference between e.g. a Photograph or a Painting (which would also mean you would be stuck with one or other if we did), we use this key's value to allow Archipelago to select/swap View Modes. This approach also allows for your own needs to define what an ADO in real life or digital realm is (the WHAT). This key is also important when doing AMI based batch ingests since many of the mappings and decisions (e.g. what Template to use to transform your CSV or if the Destination Drupal Content Type is going to be a Digital Object or a Digital Object Collection) will depend on this.

    Note: Archipelago does something extra fun too when using type value for View Mode Selection (and this is also a feature of one of the Key Name provider Plugins). It will flatten the JSON first and then fetch all type keys. How does this in practice work?

    {\n    \"type\": \"Photograph\",\n    \"subtypes\": [\n        {\n            \"type\": \"125 film\"\n        },\n        {\n            \"type\": \"Instant film\"\n        }\n    ]  \n}\n

    Means, while doing a View Mode Selection Archipelago will bring all found type key values together and will have ['Photograph', '125 film', 'Instant film'] available as choices, meaning you will be able to make even finer decisions on how to display your ADOs. View Mode selection is based on order or evaluation, means we recommend putting the more specific mappings first.

    "},{"location":"metadatainarchipelago/#the-label-key","title":"The label key","text":"
    {\n    \"label\": \"Black and White Photograph of Cataloger working with JSON\"\n}\n

    Archipelago will use the label key's value to populate the ADO's (Drupal Node) Title. Drupal has a length limit for its native build in Node Entity Title but JSON has not, so in case of more than 255 characters Archipelago will truncate the Title (not the label key's value) adding an ellipsis (...) as suffix.

    "},{"location":"metadatainarchipelago/#archipelago-drupal-entities-integration-keys","title":"Archipelago Drupal Entities integration keys","text":"

    Because of the need of having Technical Metadata, Descriptive Metadata and Semantic Metadata while generating different representations of your JSON via Metadata Display Entities (Twig templates) transformations, we store and characterize Files attached to an ADO as part of the JSON. We also use a set of special keys to map and cast JSON keys and values to Drupal's internal Entities system via their Numeric and/or UUID IDs.

    Through this, Archipelago will also move files between upload locations and permanent storage, execute Technical metadata extraction, keep track of ADO to ADO relationships (e.g ispartof or ismemberof) and emulate what a traditional Drupal Entity Reference field would do without the limitations (speed and immutability) a static RDB definition imposes.

    "},{"location":"metadatainarchipelago/#the-apentitymapping-key","title":"The ap:entitymapping key","text":"
    {\n    \"ap:entitymapping\":{\n        \"entity:file\": [\n            \"model\",\n            \"audios\",\n            \"images\",\n            \"videos\",\n            \"documents\",\n            \"upload_associated_warcs\"\n            ],\n        \"entity:node\": [\n            \"ispartof\",\n            \"ismemberof\"\n        ]\n    }\n}\n

    the ap:entitymapping is a hint for Archipelago. With this key we can treat certain keys and their values as Drupal Numeric Entity IDs instead of semantically unknown values.

    In the presence of the structure exemplified above the following JSON snipped:

        \"images\": [\n        1,\n        2,\n        3\n    ]   \n

    Will tell Archipelago that the JSON key images should be treated as containing Entity IDs for a Drupal Entity of type (entity:file) File. This has many interessting consequences. Archipelago, on edit/update/ingest will try (hard) to get a hold of Files with ID 1, 2 and 3. If in temporary storage Archipelago will move them to its final Permanent Location, will make sure Drupal knows those files are being used by this ADO, will run multiple Technical Metadata Extractions and classify internally the Files, adding everything it could learn from them. In practice, this means that Archipelago will write for you additional structures into the JSON enriching your Metadata.

    Without this structure, the images key would not trigger any logic but will of course still exist and can always still be used as a list of numbers while templating.

    This also implies that for a persisted ADO with those values, if you edit the JSON and delete e.g. the number (integer or string representation of an integer) 3, Archipelago will disconnect the File Entity with ID 3 from this ADO, remove the enriched metadata and mark the File as not being anymore used by this ADO. If nobody else is using the File it will become temporary and eventually be automatically removed from the system, if that is setup at the Drupal - Filesystem - level.

    Using the same example ap:entitymapping structure, the following snippet:

        \"ispartof\": [\n        2000\n    ]   \n

    Will hint to Archipelago on assumed connection between this ADO and another ADO with Drupal Entity ID 2000. This will drive other functionality in Archipelago (semantic), allowing for example a Navigation Breadcrumb to be built using all connections found in its hierarchical path.

    In Archipelago ADO to ADO relationships are normally from Child to Parent and hopefully (but not enforced!) building an Acyclic graph, from leaves to trunk. This will also allow inheritance to happen. This means also that a Parent ADO needs to exist before connecting/relating to it (chicken first). But if it does not, the system will not fail and assume a temporarily broken relationship (egg stays safely intact).

    Entity mapping key also drives a very special compatibility addition to any ADO. Archipelago will populate Native Computed Drupal fields (attached at run time to each ADO) with these values loading and exposing them as Drupal Entities, processing both Files and Node Entities and making them visible outside the scope of a Strawberry Field to the whole CMS.

    The following Computed fields are provided:

    • field_file_drop: Computed Entity Reference Field. Needed also for JSON API level upload of Files to an ADO (Drupal need). It will expose all File Entities referenced in an ADO, independently of the type of the File.
    • field_sbf_nodetonode: Computed Entity Reference Field. It will expose all Nodes (other ADOs) Entities referenced in an ADO, independently of the Content type and/or the semantic predicate (ismemberof, ispartof, etc) used.

    These Fields, because of their native Drupal nature, can be used directly everywhere, e.g. in the Search API to index all related ADOs (or any of their Fields and subproperties, even deeply chained, tree down) without having to specify what predicate is used. Said differently, they act as aggregators, as a generic \"isrelatedto\" property bringing all together.

    "},{"location":"metadatainarchipelago/#the-asas_file_type-keys","title":"The as:{AS_FILE_TYPE} keys","text":"

    As explained in the ap:entitymapping section above, when Archipelago gets hold of a File entity it will enrich your JSON with its extracted data. Archipelago will compute and append to your JSON a set of controlled as:{AS_FILE_TYPE} keys containing a classified File's Metadata. The naming will be automatic based on grouping Files by their Mime Types.

    The possible values for as:{AS_FILE_TYPE} are

    • as:image
    • as:document
    • as:video
    • as:audio
    • as:application
    • as:text
    • as:model
    • as:multipart
    • as:message

    An example for an Image attached to an ADO:

    {\n    \"as:image\": {\n        \"urn:uuid:ef596613-b2e7-444e-865d-efabbf1c59b0\": {\n            \"url\": \"s3:\\/\\/de2\\/image-f6268bde41a39874bc69e57ac70d9764-view-ef596613-b2e7-444e-865d-efabbf1c59b0.jp2\",\n            \"name\": \"f6268bde41a39874bc69e57ac70d9764_view.jp2\",\n            \"tags\": [],\n            \"type\": \"Image\",\n            \"dr:fid\": 7461,\n            \"dr:for\": \"images\",\n            \"dr:uuid\": \"ef596613-b2e7-444e-865d-efabbf1c59b0\",\n            \"checksum\": \"de2862d4accf5165d32cd0c3db7e7123\",\n            \"flv:exif\": {\n                \"FileSize\": \"932 KiB\",\n                \"MIMEType\": \"image\\/jp2\",\n                \"ImageSize\": \"1375x2029\",\n                \"ColorSpace\": \"sRGB\",\n                \"ImageWidth\": 1375,\n                \"ImageHeight\": 2029\n            },\n            \"sequence\": 1,\n            \"flv:pronom\": {\n                \"label\": \"JP2 (JPEG 2000 part 1)\",\n                \"mimetype\": \"image\\/jp2\",\n                \"pronom_id\": \"info:pronom\\/x-fmt\\/392\",\n                \"detection_type\": \"signature\"\n            },\n            \"dr:filesize\": 954064,\n            \"dr:mimetype\": \"image\\/jp2\",\n            \"crypHashFunc\": \"md5\",\n            \"flv:identify\": {\n                \"1\": {\n                    \"width\": \"1375\",\n                    \"format\": \"JP2\",\n                    \"height\": \"2029\",\n                    \"orientation\": \"Undefined\"\n                }\n            }\n        }\n    }\n}\n

    That is a lot of Metadata! But to understand what is happening here, we need to dissect this into more readable chunks. Let's start with the basics from root to leaves of this hierarchy.

    "},{"location":"metadatainarchipelago/#direct-file-level-metadata","title":"Direct File level Metadata","text":"

    Every Classified File inside the as:{AS_FILE_TYPE} key will be contained in a unique URN JSON Object property:

    \"urn:uuid:ef596613-b2e7-444e-865d-efabbf1c59b0\": {}\n

    We use a Property instead of a \"List or Array\" of Technical Metadata because this allows us (at code level) to access quickly from e.g. as:image structure all the data for a File Entity with UUID ef596613-b2e7-444e-865d-efabbf1c59b0 without iterating. (Also now you know what urn:uuid:ef596613-b2e7-444e-865d-efabbf1c59b0 means.)

    Next, inside that property, the following Data provides basic Information about the File so you can access/make decisions when Templating. Notice the duplication of similar data at different levels. Duplication is on purpose and again, allows you to access certain JSON values (or filter) quicker without having to go to other keys or hierarchies to make decisions.

    {\n    \"url\": \"s3:\\/\\/de2\\/image-f6268bde41a39874bc69e57ac70d9764-view-ef596613-b2e7-444e-865d-efabbf1c59b0.jp2\",\n    \"name\": \"Original Name of my Image.jp2\",\n    \"tags\": [],\n    \"type\": \"Image\",\n    \"dr:fid\": 3,\n    \"dr:for\": \"images\",\n    \"dr:uuid\": \"ef596613-b2e7-444e-865d-efabbf1c59b0\",\n    \"crypHashFunc\": \"md5\",\n    \"checksum\": \"de2862d4accf5165d32cd0c3db7e7123\",\n    \"dr:filesize\": 954064,\n    \"dr:mimetype\": \"image\\/jp2\",\n    \"sequence\": 1\n
    • \"url\": Contains the Final Storage location/URI of the File. It's prefixed with the configured Streamwrapper, a functional symbolic link to the underlying complexities of the backend storage. e.g s3:// implies an S3 API backend with a (hidden/abstracted) set of credentials, Bucket and Prefixes inside the bucket. This value is also used in Archipelago's IIIF Cantaloupe Service as the Image id when building a IIIF Image API URL.
    • \"name\": The Original Name of the File. Can be used to give a Download a human readable name or as an internal hint/preservation for you.
    • \"tags\": Unused by default. You can use this for your own logic if needed.
    • \"type\": A redundant (contextual, at this level) key whose value will match {AS_FILE_TYPE} already found at 2 levels before. Allows you to know what File type this is when iterating over this File's data (without having to look back, or on our Code, when dealing with Flattened JSON).
    • \"dr:fid\": The Drupal Entity Numeric ID.
    • \"dr:for\": Where in your JSON (top level key) this File ID was stored (or in other words where you can find the value of \"dr:fid\". All this will match / was be driven of course by ap:entitymapping. Sometimes (try uploading a WARC file and run the queue) this key might contain flv:{ACTIVE_STRAWBERRY_RUNNERS_CONFIG_ID}. This means the File will have been generated by an active Strawberry Runners Processor and not uploaded by you. ACTIVE_STRAWBERRY_RUNNERS_CONFIG_ID will be the Machine name (or ID) of a given Strawberry Runners Processor Configuration Entity.
    • \"dr:uuid\": A redundant (contextual, at this level) key whose value will match the Drupal File entity UUID for this File.
    • \"crypHashFunc\": What Cryptographic function was used for generating the checksum. By default Archipelago will do MD5 (faster but also because S3 APIs use that to ensure upload consistency and E-tag). In the future others can be enabled and made configurable
    • \"checksum\": The Checksum (calculated) of this File via \"crypHashFunc\"
    • \"dr:filesize\": The File size in Bytes.
    • \"dr:mimetype\": The Drupal level infered Mime Type. Archipelago extends this list. This is based on the File Extension.
    • \"sequence\": A number (integer) denoting order of this file relative to other files of the same type inside the JSON. Which default type ordering is used will depend on how the ADO was created/edited, but can be overriden using Control Metadata.
    "},{"location":"metadatainarchipelago/#technical-file-level-metadata","title":"Technical File level Metadata","text":"

    Deeper inside this structure Archipelago will produce Extracted Technical Metadata. Some of this Metadata will be common to every File Type, some will be specific to a subset, like Moving Media or PDFs. What runs and how it runs can be configured at the File Persister Service Settings configuration form found at/admin/config/archipelago/filepersisting. Why there? These are service that run syncroniusly on ADO save (Create/Edit) and in while doing File persistance.

    \"flv:exif\": EXIF Tool extraction for a file. The number of elements that come out might vary, for an Image file it might be normally short, but a PDF might have a very extensive and long list. The above mentioned File Persister Service Settings form allows you to also set a Files Cap Number, that will, once reached, limit and reduce the EXIF. This is very useful if you want to control the size of your complete JSON for any reason you feel that is needed (performance, readability, etc).

    {\n    \"flv:exif\": {\n                \"FileSize\": \"932 KiB\",\n                \"MIMEType\": \"image\\/jp2\",\n                \"ImageSize\": \"1375x2029\",\n                \"ColorSpace\": \"sRGB\",\n                \"ImageWidth\": 1375,\n                \"ImageHeight\": 2029\n            },\n}\n

    \"flv:identify\": Graphics Magic Identity binary will run on every file and format it knows how to run (and will try even on the ones it does not). Will give you data similar to EXIF but processed based on the actual File and not just extracted from the EXIF data found at the header. Notice that the details will be inside a \"1\", \"2\", etc property. This is because Identify might also go deeper and for e.g a Multi Layer Tiff extract different sequences on the same File.

    {\n    \"flv:identify\": {\n                \"1\": {\n                    \"width\": \"1375\",\n                    \"format\": \"JP2\",\n                    \"height\": \"2029\",\n                    \"orientation\": \"Undefined\"\n                }\n            }\n}\n

    \"flv:pronom\": Droid, a File Signature detection tool will find a matching pronom_idfor your File based on https://www.nationalarchives.gov.uk/aboutapps/pronom/droid-signature-files.htm. This detection type is deeper that EXIF or the mime type based on extension, reading from binary data. It allows you to get small differences between formats (even if e.g both are JP2) and thus make decisions like \"Will Cantaloupe IIIF Image Server be able to handle this type?\". This has also positive Digital Preservation consequences.

    {\n    \"flv:pronom\": {\n                \"label\": \"JP2 (JPEG 2000 part 1)\",\n                \"mimetype\": \"image\\/jp2\",\n                \"pronom_id\": \"info:pronom\\/x-fmt\\/392\",\n                \"detection_type\": \"signature\"\n            },\n}\n

    \"flv:mediainfo\": Media Info works on Video and Audio. It goes very detailed into codecs andstreams and the output added to your JSON might look massive. This is also very needed when working with IIIF Manifests and deciding if a certain Video will be able to play natively on a browser or if Cantaloupe IIIF Image Server will be able to extract individual frames as images. This again has positive Digital Preservation consequences. The Following is an example of an MP4 file generated via Quicktime on an Apple MacOS computer.

    {\n    \"flv:mediainfo\": {\n                \"menus\": [],\n                \"audios\": [\n                    {\n                        \"id\": {\n                            \"fullName\": \"1\",\n                            \"shortName\": \"1\"\n                        },\n                        \"count\": \"282\",\n                        \"title\": \"Core Media Audio\",\n                        \"format\": {\n                            \"fullName\": \"AAC LC\",\n                            \"shortName\": \"AAC\"\n                        },\n                        \"bit_rate\": {\n                            \"textValue\": \"85.3 kb\\/s\",\n                            \"absoluteValue\": 85264\n                        },\n                        \"codec_id\": \"mp4a-40-2\",\n                        \"duration\": {\n                            \"milliseconds\": 21215\n                        },\n                        \"channel_s\": {\n                            \"textValue\": \"1 channel\",\n                            \"absoluteValue\": 1\n                        },\n                        \"frame_rate\": {\n                            \"textValue\": \"43.066 FPS (1024 SPF)\",\n                            \"absoluteValue\": 43\n                        },\n                        \"format_info\": \"Advanced Audio Codec Low Complexity\",\n                        \"frame_count\": \"914\",\n                        \"stream_size\": {\n                            \"bit\": 226109\n                        },\n                        \"streamorder\": \"0\",\n                        \"tagged_date\": \"UTC 2017-12-05 17:14:10\",\n                        \"encoded_date\": \"UTC 2017-12-05 17:14:07\",\n                        \"source_delay\": \"-0\",\n                        \"bit_rate_mode\": {\n                            \"fullName\": \"Variable\",\n                            \"shortName\": \"VBR\"\n                        },\n                        \"samples_count\": \"935582\",\n                        \"sampling_rate\": {\n                            \"textValue\": \"44.1 kHz\",\n                            \"absoluteValue\": 44100\n                        },\n                        \"channel_layout\": \"C\",\n                        \"kind_of_stream\": {\n                            \"fullName\": \"Audio\",\n                            \"shortName\": \"Audio\"\n                        },\n                        \"commercial_name\": \"AAC\",\n                        \"source_duration\": [\n                            \"21269\",\n                            \"21 s 269 ms\",\n                            \"21 s 269 ms\",\n                            \"21 s 269 ms\",\n                            \"00:00:21.269\"\n                        ],\n                        \"compression_mode\": {\n                            \"fullName\": \"Lossy\",\n                            \"shortName\": \"Lossy\"\n                        },\n                        \"channel_positions\": {\n                            \"fullName\": \"1\\/0\\/0\",\n                            \"shortName\": \"Front: C\"\n                        },\n                        \"samples_per_frame\": \"1024\",\n                        \"stream_identifier\": \"0\",\n                        \"source_frame_count\": \"916\",\n                        \"source_stream_size\": [\n                            \"226460\",\n                            \"221 KiB (1%)\",\n                            \"221 KiB\",\n                            \"221 KiB\",\n                            \"221 KiB\",\n                            \"221.2 KiB\",\n                            \"221 KiB (1%)\"\n                        ],\n                        \"source_delay_source\": \"Container\",\n                        \"format_additionalfeatures\": \"LC\",\n                        \"proportion_of_this_stream\": \"0.01178\",\n                        \"count_of_stream_of_this_kind\": \"1\",\n                        \"source_streamsize_proportion\": \"0.01180\"\n                    }\n                ],\n                \"images\": [],\n                \"others\": [\n                    {\n                        \"type\": \"meta\",\n                        \"count\": \"188\",\n                        \"duration\": {\n                            \"milliseconds\": 21215\n                        },\n                        \"frame_count\": \"1\",\n                        \"kind_of_stream\": {\n                            \"fullName\": \"Other\",\n                            \"shortName\": \"Other\"\n                        },\n                        \"stream_identifier\": [\n                            \"0\",\n                            \"1\"\n                        ],\n                        \"count_of_stream_of_this_kind\": \"2\"\n                    },\n                    {\n                        \"type\": \"meta\",\n                        \"count\": \"188\",\n                        \"duration\": {\n                            \"milliseconds\": 21215\n                        },\n                        \"frame_count\": \"1\",\n                        \"kind_of_stream\": {\n                            \"fullName\": \"Other\",\n                            \"shortName\": \"Other\"\n                        },\n                        \"stream_identifier\": [\n                            \"1\",\n                            \"2\"\n                        ],\n                        \"count_of_stream_of_this_kind\": \"2\"\n                    }\n                ],\n                \"videos\": [\n                    {\n                        \"id\": {\n                            \"fullName\": \"2\",\n                            \"shortName\": \"2\"\n                        },\n                        \"count\": \"380\",\n                        \"title\": \"Core Media Video\",\n                        \"width\": {\n                            \"textValue\": \"1 280 pixels\",\n                            \"absoluteValue\": 1280\n                        },\n                        \"format\": {\n                            \"fullName\": \"AVC\",\n                            \"shortName\": \"AVC\"\n                        },\n                        \"height\": {\n                            \"textValue\": \"720 pixels\",\n                            \"absoluteValue\": 720\n                        },\n                        \"bit_rate\": {\n                            \"textValue\": \"7 144 kb\\/s\",\n                            \"absoluteValue\": 7144261\n                        },\n                        \"codec_id\": \"avc1\",\n                        \"duration\": {\n                            \"milliseconds\": 21215\n                        },\n                        \"rotation\": \"0.000\",\n                        \"bit_depth\": {\n                            \"textValue\": \"8 bits\",\n                            \"absoluteValue\": 8\n                        },\n                        \"scan_type\": {\n                            \"fullName\": \"Progressive\",\n                            \"shortName\": \"Progressive\"\n                        },\n                        \"format_url\": \"http:\\/\\/developers.videolan.org\\/x264.html\",\n                        \"frame_rate\": {\n                            \"textValue\": \"29.970 (29970\\/1000) FPS\",\n                            \"absoluteValue\": 29\n                        },\n                        \"buffer_size\": \"768000\",\n                        \"color_range\": \"Limited\",\n                        \"color_space\": \"YUV\",\n                        \"format_info\": \"Advanced Video Codec\",\n                        \"frame_count\": \"636\",\n                        \"stream_size\": {\n                            \"bit\": 18951244\n                        },\n                        \"streamorder\": \"1\",\n                        \"tagged_date\": \"UTC 2017-12-05 17:14:10\",\n                        \"encoded_date\": \"UTC 2017-12-05 17:14:07\",\n                        \"bit_rate_mode\": {\n                            \"fullName\": \"Variable\",\n                            \"shortName\": \"VBR\"\n                        },\n                        \"codec_id_info\": \"Advanced Video Coding\",\n                        \"framerate_den\": \"1000\",\n                        \"framerate_num\": \"29970\",\n                        \"sampled_width\": \"1280\",\n                        \"format_profile\": \"Main@L3.1\",\n                        \"kind_of_stream\": {\n                            \"fullName\": \"Video\",\n                            \"shortName\": \"Video\"\n                        },\n                        \"sampled_height\": \"720\",\n                        \"color_primaries\": \"BT.709\",\n                        \"commercial_name\": \"AVC\",\n                        \"format_settings\": \"CABAC \\/ 2 Ref Frames\",\n                        \"frame_rate_mode\": {\n                            \"fullName\": \"Variable\",\n                            \"shortName\": \"VFR\"\n                        },\n                        \"bits_pixel_frame\": \"0.259\",\n                        \"maximum_bit_rate\": {\n                            \"textValue\": \"768 kb\\/s\",\n                            \"absoluteValue\": 768000\n                        },\n                        \"stream_identifier\": \"0\",\n                        \"chroma_subsampling\": [\n                            \"4:2:0\",\n                            \"4:2:0\"\n                        ],\n                        \"maximum_frame_rate\": [\n                            \"30.000\",\n                            \"30.000 FPS\"\n                        ],\n                        \"minimum_frame_rate\": [\n                            \"28.571\",\n                            \"28.571 FPS\"\n                        ],\n                        \"pixel_aspect_ratio\": \"1.000\",\n                        \"colour_range_source\": \"Stream\",\n                        \"format_settings_gop\": \"M=2, N=30\",\n                        \"internet_media_type\": \"video\\/H264\",\n                        \"matrix_coefficients\": \"BT.709\",\n                        \"original_frame_rate\": [\n                            \"25.000\",\n                            \"25.000 FPS\"\n                        ],\n                        \"display_aspect_ratio\": {\n                            \"textValue\": \"16:9\",\n                            \"absoluteValue\": 1.778\n                        },\n                        \"format_settings_cabac\": {\n                            \"fullName\": \"Yes\",\n                            \"shortName\": \"Yes\"\n                        },\n                        \"codec_configuration_box\": \"avcC\",\n                        \"colour_primaries_source\": \"Container \\/ Stream\",\n                        \"transfer_characteristics\": \"BT.709\",\n                        \"proportion_of_this_stream\": \"0.98734\",\n                        \"colour_description_present\": \"Yes\",\n                        \"matrix_coefficients_source\": \"Container \\/ Stream\",\n                        \"count_of_stream_of_this_kind\": \"1\",\n                        \"transfer_characteristics_source\": \"Container \\/ Stream\",\n                        \"format_settings_reference_frames\": [\n                            \"2\",\n                            \"2 frames\"\n                        ],\n                        \"colour_description_present_source\": \"Container \\/ Stream\"\n                    }\n                ],\n                \"general\": {\n                    \"count\": \"336\",\n                    \"format\": {\n                        \"fullName\": \"MPEG-4\",\n                        \"shortName\": \"MPEG-4\"\n                    },\n                    \"codec_id\": [\n                        \"qt  \",\n                        \"qt   0000.00 (qt  )\"\n                    ],\n                    \"datasize\": \"19177730\",\n                    \"duration\": {\n                        \"milliseconds\": 21215\n                    },\n                    \"file_name\": \"c98e7bc52e4bd3fe5681a746f2d9c76f_diego4\",\n                    \"file_size\": {\n                        \"bit\": 19194157\n                    },\n                    \"footersize\": \"0\",\n                    \"frame_rate\": {\n                        \"textValue\": \"29.970 FPS\",\n                        \"absoluteValue\": 29\n                    },\n                    \"headersize\": \"16427\",\n                    \"othercount\": \"2\",\n                    \"folder_name\": \"\\/tmp\\/ami\\/setfiles\\/cb606b13b823eaea784dc77c460f3baf\",\n                    \"frame_count\": \"636\",\n                    \"stream_size\": {\n                        \"bit\": 16804\n                    },\n                    \"tagged_date\": \"UTC 2017-12-05 17:14:10\",\n                    \"audio_codecs\": \"AAC LC\",\n                    \"codec_id_url\": \"http:\\/\\/www.apple.com\\/quicktime\\/download\\/standalone.html\",\n                    \"codecs_video\": \"AVC\",\n                    \"encoded_date\": \"UTC 2017-12-05 17:14:07\",\n                    \"isstreamable\": \"Yes\",\n                    \"complete_name\": \"\\/tmp\\/ami\\/setfiles\\/cb606b13b823eaea784dc77c460f3baf\\/c98e7bc52e4bd3fe5681a746f2d9c76f_diego4.m4v\",\n                    \"file_extension\": \"m4v\",\n                    \"format_profile\": \"QuickTime\",\n                    \"kind_of_stream\": {\n                        \"fullName\": \"General\",\n                        \"shortName\": \"General\"\n                    },\n                    \"codecid_version\": \"0000.00\",\n                    \"commercial_name\": \"MPEG-4\",\n                    \"writing_library\": {\n                        \"fullName\": \"Apple QuickTime\",\n                        \"shortName\": \"Apple QuickTime\"\n                    },\n                    \"overall_bit_rate\": {\n                        \"fullName\": \"7 238 kb\\/s\",\n                        \"shortName\": \"7237957\"\n                    },\n                    \"audio_format_list\": \"AAC LC\",\n                    \"stream_identifier\": \"0\",\n                    \"video_format_list\": \"AVC\",\n                    \"codecid_compatible\": \"qt  \",\n                    \"file_name_extension\": \"c98e7bc52e4bd3fe5681a746f2d9c76f_diego4.m4v\",\n                    \"internet_media_type\": \"video\\/mp4\",\n                    \"encoded_library_name\": \"Apple QuickTime\",\n                    \"comapplequicktimemake\": \"Apple\",\n                    \"overall_bit_rate_mode\": {\n                        \"fullName\": \"Variable\",\n                        \"shortName\": \"VBR\"\n                    },\n                    \"comapplequicktimemodel\": \"iPhone SE\",\n                    \"count_of_audio_streams\": \"1\",\n                    \"count_of_video_streams\": \"1\",\n                    \"comapplequicktimesoftware\": \"10.3.2\",\n                    \"proportion_of_this_stream\": \"0.00088\",\n                    \"audio_format_withhint_list\": \"AAC LC\",\n                    \"video_format_withhint_list\": \"AVC\",\n                    \"file_last_modification_date\": {\n                        \"date\": \"2022-10-19 20:02:32.000000\",\n                        \"timezone\": \"UTC\",\n                        \"timezone_type\": 3\n                    },\n                    \"count_of_stream_of_this_kind\": \"1\",\n                    \"comapplequicktimecreationdate\": \"2017-10-25T16:58:17-0400\",\n                    \"format_extensions_usually_used\": \"braw mov mp4 m4v m4a m4b m4p m4r 3ga 3gpa 3gpp 3gp 3gpp2 3g2 k3g jpm jpx mqv ismv isma ismt f4a f4b f4v\",\n                    \"comapplequicktimelocationiso6709\": \"+40.6145-074.2678+020.977\\/\",\n                    \"file_last_modification_date_local\": {\n                        \"date\": \"2022-10-19 20:02:32.000000\",\n                        \"timezone\": \"America\\/New_York\",\n                        \"timezone_type\": 3\n                    }\n                },\n                \"version\": \"21.09\",\n                \"subtitles\": []\n            }\n        }\n}\n

    \"flv:pdfinfo\": PDF Info will get Page level Information for a PDF or Ghostscript document. The dimensions displayed in the following example are not in pixels but points (resolution independent) and are also used for IIIF generation when deciding at what rasterized pixel size a given PDF document page will be rendered. Same as with flv:identify, the technical metadata will be contained inside a keyed (string but semantically an integer) property. In this particular case each number is a page sequence in the original PDF order.

    {\n    \"flv:pdfinfo\": {\n                \"1\": {\n                    \"width\": \"612\",\n                    \"height\": \"792\",\n                    \"rotation\": \"0\",\n                    \"orientation\": \"TopLeft\"\n                }\n            }\n}\n

    @TODO: add the extra special key used by Strawberry Runners when it attaches a file. e.g WARC to WACZ

    "},{"location":"metadatainarchipelago/#did-you-know","title":"Did you #know?","text":"

    If you delete a whole as:{AS_FILE_TYPE} structure or one of the File level structures (a urn:uuid:{uuid} key and its children), Archipelago will recreate it. If you modify any internal value contained in it, Archipelago will do nothing and will trust you (and if you do strange things like modifying the url something might even fail e.g in a IIIF Metadata Display Entity Twig Template). No data edit there will trigger a modification/moving/deletion of a File (or e.g write back EXIF to be binary). You will have time to revert to a previous revision (version) of the ADO if any manual change was done. So, should you modify/delete this structures? Almost never. Ever. But you might find needs for that someday. Also to be noted. Producing this structure for a large file in S3:// is intensive. It needs to be downloaded to a local path and if the File is a few Gigabytes in size Archipelago might even run out of PHP processing time. If that ever happens you can also copy/paste from a previous revision of the ADO the relevant piece. If archipelago finds it (implied in the previous explanation) it will not have to regenerate it. The AMI module does this in an async/enqueued way to avoid time out issues and can reuse a cached metadata extraction between runs, but when working directly on an ADO via e.g a webform or via RAW edit, take that in account. More work is being done to allow also one on one async File operations and larger uploads via the web.

    "},{"location":"metadatainarchipelago/#the-aptasks-keys","title":"The ap:tasks keys","text":"

    As mentioned briefly before, there is also Control Metadata. What do we mean with that? Control metadata in Archipelago's way of allowing you to give, through metadata, (that you might want to preserve or not) instructions to Archipelago that relate to processing. Let's start with the basic one:

    {\n    \"ap:tasks\": {\n        \"ap:sortfiles\": \"index\"\n    }\n}\n

    \"ap:sortfiles\" key will instruct Archipelago to sort (create a sequence key and a sequential number (integer value) inside each Metadata File entry of a as:{AS_FILE_TYPE} structure. Values can be one of ['natural', 'index', 'manual'] defaulting, if absent or has an invalid value, to natural. - natural: files will be sorted by File Name, the filename key found at the same level of sequence in the previously mentioned as:{AS_FILE_TYPE} structure. a Photograph_1.jpeg will come before a Photograph_10.jpeg. The way a human being naturally would order by name. - index files will be sorted by the order in which they appear inside the upload JSON key (the dr:for key, one of the keys mapped in the ap:entitymapping structure under entity:file explained before. e.g. images:[5, 10 , 1 ], would imply the File Entity with Drupal ID 5 would get \"sequence\": 1, the one with Drupal ID 10 will get \"sequence\": 1, etc. This is the default when ingesting via the AMI module given the need to preserve file order that has/might have unknown names or names you don't have control of (thus natural won't work) coming from e.g a Remote, HTTP/HTTPS location - manual: You can modify the values manually for any sequence key inside as:{AS_FILE_TYPE} structure and those values will stick.

    What do we mean with stick? Well, everytime archipelago gets a change in this \"ap:sortfiles\", e.g a new File is added, a File is deleted, automatic re-sorting will happen. 

    {\n    \"ap:tasks\": {\n        \"ap:forcepost\": true\n    }\n}\n

    \"ap:forcepost\": A boolean. The functionality of this key is provided by the Strawberry Runners Module. Will force Strawberry Runners Post processing for this ADO.

    Each Configured and active Postprocessor provided by the Strawberry Runners module might or not kick in by evaluating a set of rules. If rule evaluates to TRUE, the PostProcessor will generate a certain output., e.g a Solr Indexed Strawberry Flavor Data Source containing OCR, HOCR and NLP metadata for one or more pages of a PDF.

    Everytime a Create or Update operation on an ADO happens, these rules will be evaluated and the Processor will be enqueued as a future task. But at the moment of executing, when the queue workers take one item, a check will be made and if the result of a previous run (e.g HOCR) is already present in the system (e.g in Solr) and it's veryfied to be belonging to the same source, the actual heavyload of processing the PDF will be skipped.

    While testing, coding, doing complex changes in the system (like modifying largely the settings for one processor) or even in the case of an ISSUE (e.g HOCR was wrongly run with a setting that made all look like garbage!) you can instruct Archipelago run again without checks. And again. And again. basically everytime you Save an ADO by setting ap:forcepost to true. This can also be used batch and is already implied (means it does it for you but only once, without modifying the JSON) in the Trigger Strawberrry Runners process/reprocess for Archipelago Digital Objects VBO action we provide.

    In the absence of \"ap:forcepost\" the value is implicitly false, same as setting it explicitly to false.

    {\n    \"ap:tasks\": {\n        \"ap:nopost\": [\n            'pager'\n        ]\n    }\n}\n

    \"ap:nopost\": an array or list of ACTIVE_STRAWBERRY_RUNNERS_CONFIG_ID entries, means Machine names (or IDs) Strawberry Runners Processor Configuration Entities. The functionality of this key is provided by the Strawberry Runners. If not an array it will be ignored. Any value present not matching an active Strawberry Runners Processor Configuration Entity ID will also be ignored. Effectively, any post processors in this list will be skipped for this ADO. This allows a finer grained avoidance of some expensive processing that might lead to unsuable data. E.g a particular Manuscript ADO that Tesseract won't be able to OCR correctly. Adding this key to an ADO that was already processed won't remove existing generated/stored processing.

    {\n    \"ap:tasks\": {\n        \"ap:ami\": {\n            \"metadata_display\": 7\n\n        }\n    }\n}\n

    \"ap:ami\" is a newer key ( as of Archipelago 1.1.0 and AMI 0.5.0) and for now can only contain another single key named \"metadata_display\". The value of this one can be either a single Integer, the Drupal ID of a Metadata Display Entity or a string, the UUID of a Metadata Display Entity. The functionality triggered by this key is provided by the AMI module and will do something extremely powerfull: it will take the complete JSON and process through the Twig or Metadata Display Entity refererenced in its value, IF, and only IF, the output of that template is JSON. This runs before any other event (Archipelago runs a ton of events that validate, enrich, check, etc your ADOs from the moment you SAVE or Create it) and because of that allows you to totally pivot, transform, change RAW data coming into Archipelago, e.g via the JSON:API into the structure you need/want. Said differently, you could push JSON from a totally different system and if the referenced Metadata Display Entity is well written, end with a perfectly aligned JSON matching your internal structure without modifying the INPUT manually. Because Twig is very powerful you can also do cleanups, complex logic, etc. More over, you can transform any existing ADO via Batch by adding this key(s) and values using the JSON Patch VBO action. Once processed and if all went well, meaning the output of the Template is valid JSON, the key itself will be removed. This, to avoid running over and over (invisibly to you) on further operations/edits/etc. This is a one time operation that does not stick. What happens if it does not run well, fails, errors out or the Template referenced does not exist? You get a second change (everyone deserves one), the Original ingested JSON, without transformations is kept. All this is very similar to what the AMI module does via a CSV but in this case its atomic. We know what you are thinking. You can process data twice, via AMI and then at the end pass it again through another template based on a certain logic coming from the first? yes. you can!

    In the future \"ap:ami\" might contain more keys to do more advanced File level actions. Archipelago is being constantly enhanced!

    "},{"location":"metadatainarchipelago/#activity-stream","title":"Activity Stream","text":"

    Archipelago also keeps information about who/how a certain JSON was generated. Depending on how the Ingest/Edit of an ADO happened, this can be automatically generated or added manually (the case for AMI ingests).

    The structure is simple and not accumulative because there is also versioning at the ADO (Drupal) level that allows you to look back if needed.

    {\n     \"as:generator\": {\n        \"type\": \"Update\",\n        \"actor\": {\n            \"url\": \"http:\\/\\/localhost:8001\\/form\\/default-descriptive-metadata-ami\",\n            \"name\": \"default_descriptive_metadata_ami\",\n            \"type\": \"Service\"\n        },\n        \"endTime\": \"2022-03-16T15:51:24-04:00\",\n        \"summary\": \"Generator\",\n        \"@context\": \"https:\\/\\/www.w3.org\\/ns\\/activitystreams\"\n    },\n}\n

    The \"as:generator\" Conforms to the Activity Stream Vocabulary Version 2.0 and keeps track of the last Operation executed on an ADO. Edits and Ingests via the Webform Widget will create this automatically using the Canonical URL of the Webform That generated the content and \"type\" might be either \"Update\" or \"Create\". ADOs that were processed via \"ap:ami\" will have automatically one generated to express the fact that the Original JSON was modified by a Metadata Display Entity. Objects created via AMI and using a Metadata Display Entity can also add via the Twig template syntax the AMI Set ID used to generate the ADO (or Update) allowing the Service URL (\"url\") to be faceted/searched for (e.g show me all objects ingested via AMI Set with ID 4).

    "},{"location":"metadatainarchipelago/#all-the-other-keys-lists-objects-your-metadata","title":"All the other keys, lists, objects. Your Metadata","text":"

    Anything or everything else (including unknow data, future data, upcoming data) belongs to you. How you name it, how you structure, how it evolves is up to you and the functionality and integration you want. That said, as someone (the writer) that enjoys cooking and had to learn the hardway (experimenting and failing sometmes) the basics before doing proper meals for others to enjoy, we suggest you plan on this before inventing the next Open Schema.

    Note: Why the out-of-context Cooking Analogy?

    This idea is deeply embedded in our Architecture. We see Metadata as ingredients. Your JSON is your fridge (or pantry or both). Metadata Display Entities, and their Twig Templates, recipes that allow you to pick and choose Ingredients and your Twig coding skills (and filters, functions, loops and conditionals) your basic cooking skills. This analogy has many consequences:

    • You can plan upfront and have more ingredients (metadata keys and JSON structures) than what you need/know how to cook, your current Recipes allow. Planning for \"your future\" needs and skills (and imagination) is a big part of this
    • Reading, understanding and testing small changes on the existing recipes will give provide you with future skills and the ability to do similar, incremental better, meals before going for something totally new and complex
    • Keeping your Ingredientes RAW and unprocessed is a good idea. You might be tempted to store canned refried beans in the fridge, but that might limit your future options. Maybe try both until you feel more secure, the canned ones AND the dried, single beans too.
    • Your use cases might dictate where you start. You cook visually, starting with a very concrete Meal in mind? (means your plan is to make a certain Caserolle - in a less metaphoricall way, a certain well defined output Schema like MODS 3.7). So you need to be sure you have the ingredients that Schema at least requires and know how (or look and copy, MODS is provided already) to process the data. Or you are into a certain type of food? And want to have the most common ingredientes needed around, you might not know how to make all the different dishes but you for sure know Onions (and cutting those) is needed. This are just 2. So many ways of approaching Cooking.

    The Open Schema you will get from a Vanilla Archipelago already covers many many uses cases and was developed by a caring team of metadata professionals and practitioners working with Archipelago for a while already. It covers LoD and most Description needs for your Whys, Wheres, When, Who/Whom. Some tips:

    • Start by adding new Keys instead of removing existing ones. Existing keys might already be used in your Vanilla Archipelago (in their Processed form) in, e.g the Search API, as Key Name providers (means the target of a JMESPATH query that will be exposed to Drupal as a Field Property), in Views (Filters, Sorting of data). Or in Twig templates (as part of Recipees) that Provide data for Viewers, IIIF V2 and V3, or in your HTML Object Descriptions. Or a Webform configured to Edit/Create new ADOs. All these can be of course modified and adapted, but before spending too much time doing that experiment with adding a new Ingredient and incorporating it to either one of the many Outputs of Archipelago or writing a simple new Recipee that uses it.
    • Not all Metadata needs to be used. Want to keep track of your Workflows? Contextual cataloging data? Notes for other metadata professionals in your team? The command line used to capture a WACZ file? You can add that to your JSON. Might all come handy in the future. You don't need to display it at all if you don't want to.
    • Experiment with the Existing Webforms and Webform Elements. If you need to allow Metadata that is very unique in structure and values (and validation), try first generating the simplest structure via the shipped Webforms and their elements via the UI. If you feel Webform can not handle then maybe you are structuring it in a too complex way. Test adding and editing. Check the \"What if/what ifs\". Is your value correctly a string? Would it be better as a boolean or an integer? Think of the \"i want many values\" v/s this is a single value differences. Because you are in the presence of an OpenSchema you can always change your mind, still better to start on the correct track.
    • Give your keys meaningfull names for you/use case/others: property_1 might be hard to document for you. But original_artifact_in_collection might be better (and denotes semantically the value might be a boolean, true of false). Use plural and singular in your naming to denote that something might contain more than one entry. Try to be generic but assertive. mods_modsinfo_namepart is tempting but is already hinting a single original fixed schema. And you might end using the same value (the who) in Dublin Core, IIIF, schema.org, etc outputs. So mybe author instead? This also leads to: sometimes multiple keys are better than many deeply nested ones where understanding. You can keep authors and contributors in separate keys.
    • Document your keys in the Metadata Display Templates (JSON does not allow comments but also why would you want to document the same in every ADO, would be like writing notes on your Potatoes. The most obvious place to document are your recipees. If adding a new Key add a small note using {# #} explaining why/what it holds. You can also add Help/Extra info when designing your schema via a the Webform. Each element has extra properties to do so and that way you can also explain others (the ones using the Webform to add/edit) what the purpose of your metadata is.
    • Use a (or many) local Archipelago Deployment as your experimental Kitchen

    Do you have your own Kitchen/cooking tips you want to share? We hope you enjoy the learning process and the many choices Archipelago provides.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"metadatatwigs/","title":"Twig Templates and Archipelago","text":"

    Archipelago uses a fast, cached templating system that is core to Drupal, called Twig. In its guts (or its heart?) Archipelago uses this system to transform the close to your needs open schema metadata that lives in every strawberryfield as JSON into close to other one's fixed schema needs metadata. This is quite simple, but it is an essential component of our vision of how a repository should manage metadata.

    "},{"location":"metadatatwigs/#what-is-twig","title":"What is Twig?","text":"

    Twig is a template engine for PHP part of Symfony framework.

    • Twig in Symfony
    • Twig in Drupal
    • A template engine is a processor. It allows you to mix and process templates with data to generate an output document.
      • Template: Some type of static Document (we name this a \u201cFrame\u201d)
      • Data: Your Archipelago Digital Object (ADO) info and your Metadata
      • Processor: Allows you to use a rich and expressive language to pick, check, iterate, transform and output your data inside the Template. We refer to this as \u201ccasting\u201d.
    "},{"location":"metadatatwigs/#where-is-twig-used-in-archipelago","title":"Where is Twig used in Archipelago?","text":"

    This templating system is exposed to Archipelago users through the UI, and is stored in the repository as content. This setup empowers users to fully control how metadata is transformed and published without touching their individual sources or needing to manage hard-coded configurations. We named these readily accessible and powerful templates Metadata Display entities, but they serve more than just display needs.

    Twig drives every Page in a Drupal 8/9/10 environment.

    • Twig templates are normally files (.twig.html) that live in your Code.
    • Modules provide Templates, Themes provide Templates

    Twig drives every aspect of your ADO exposure to the world in Archipelago and even batch Ingest.

    • Strawberryfield Metadata (JSON, your Data) is passed through a Metadata Display Entity which holds:
      • A Twig template (so you do not need to edit Files)
      • A desired output serialization format (the Output Document)
    "},{"location":"metadatatwigs/#twig-templates-as-metadata-display-entities","title":"Twig Templates as Metadata Display Entities","text":"

    Templates or recipes can be shared, exported, ingested, updated, and adapted in many ways. This means you can make changes quickly without having to wait for the next major release of Archipelago or your favorite Metadata Schema Specs Committee\u2019s agreement to implement the next or the last version. This module not only handles metadata but media assets as well. It will extract local or remote URIs and files from your metadata and render them as media viewers: books, 3D models, images, panoramas, A/V, all with IIIF in its soul.

    Metadata Display Entities are used for:

    • Display:
      • ADO landing pages (via Drupal Field Formatter)
      • IIIF or JSON driven viewers (via Drupal Field Formatter and using Exposed Metadata Endpoints)
      • Map Formatter (Drupal Field Formatter)
      • Custom Blocks (Drupal Views)
      • Search Result Displays (Drupal Views)
      • Collection and Creative Work Series (old compound) displays (Drupal Views)
    • Machinable Output
      • Exposed Metadata Endpoints (Standalone URLs to access metadata)
    • Batch Ingest
      • AMI Ingest: To transform your CSV data (one row == DATA) to Strawberry field JSON to generate an ADO
    "},{"location":"metadatatwigs/#twig-templates-shipped-with-archipelago","title":"Twig Templates Shipped with Archipelago","text":"

    Archipelago Ships with:

    • IIIF Manifest V3 for Images (JSON-LD) Metadata Display
    • IIIF Manifest V2 for Images and Documents (JSON-LD) Metadata Display
    • IIIF Manifest V3 for Collections (JSON-LD) Metadata Display
    • IIIF Manifest V3 for Creative Work Series/Compound Objects Parent and Children (JSON-LD) Metadata Displays
    • A General ADO Description (HTML) Metadata Display
    • A Linked Data Display (HTML) Metadata Display
    • GEOJSON (JSON) Metadata Display
    • An AMI (JSON) Ingest Template
    • A Multiple Thumbnails via IIIF and Fontawesome (HTML) Metadata Display
    • A Metadata Abstract for Search Results (HTML) Metadata Display
    • A Simple Dublin Core (XML) Metadata Display
    • MODS 3.7 (XML) Metadata Display
    • A Schema.org (JSON-LD) Metadata Display
    • Carousel (in Bootstrap) for Images (HTML) Metadata Display

    You can find these templates here:

    • On Github:
      • Local Deployment
      • Live/Production Deployment
    • In your local instance: http://localhost:8001/metadatadisplay/list
    • In your live instance: https://yourdomain.org/metadatadisplay/list

    Archipelago (the humans) will keep adding and refining these with every release.

    "},{"location":"metadatatwigs/#instructions-and-examples","title":"Instructions and Examples","text":"

    While a lot of core needs and use cases are covered with the Twig Templates shipped with Archipelago, you may want to add more Input elements to your Webforms, which in turn will generate new JSON Values, which in turn you may want to show/expose to end users.

    Knowing (even if you do not plan to) how to edit or create your own Twig templates is important.

    • This guide covers the Basics of Working With Twig in Archipelago
    • This section contains Full Examples of Common Use Cases
    • This section covers a Recommended Workflow
    • You may also want learn more about what format_strawberryfield can do and what many other possibilities are exposed through our templating system in this guide: Strawberryfield Formatters.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"modifyingfileextensionsinwebform/","title":"Customizing Webforms (Modifying allowable file extensions)","text":"
    • Webform
    • Webform Elements
    • File Extensions
    "},{"location":"modifyingfileextensionsinwebform/#customizing-webforms-modifying-allowable-file-extensions","title":"Customizing Webforms: Modifying allowable file extensions","text":"

    A guide to walk users through how to modify the Webform Descriptive Metadata to allow additional file extensions to be ingested into Archipelago. This is the default Webform with Archipelago by following archipelago-deployment.

    "},{"location":"modifyingfileextensionsinwebform/#context","title":"Context","text":"

    When creating an Archipelago Digital Object (ADO), on Step 4 of the ingest, Attach Files, there is a step during the ingest to upload the files associated with your ADO. There will be a section on the Webform outlining the maximum number of files allowed, the maximum file size allowed, and the allowed file extensions that can be uploaded.

    Let's say we are creating an ADO with the media type DigitalDocument and this ADO contains a data set saved as a csv file, but when we get to Step 4 of the ingest workflow we find that csv is not an allowed file extension. Fortunately, Archipelago has no restrictions on what file extensions can be uploaded, but some use cases will require a little configuring to fit a specific need. This guide will walk users through the steps to modify the default Webform, Descriptive Metadata, to allow additional file extensions to be included during an ingest.

    Prerequisites for following this guide:

    • Running instance of Archipelago (on http://localhost:8001 if you followed the deployment guide verbatim)
    • Admin credentials
    "},{"location":"modifyingfileextensionsinwebform/#lets-begin","title":"Let's begin!","text":""},{"location":"modifyingfileextensionsinwebform/#managing-webforms","title":"Managing Webforms","text":"

    Once logged in as admin, the first thing we need to do is navigate to the Webforms page so we can edit the Webform Descriptive Metadata. Click on Manage, then Structure and when the page loads, scroll down and click Webforms.

    This is where all of the Webforms inside your Archipelago live. For this guide we're going to edit the Webform Descriptive Metadata. Go ahead and click Build under the OPERATIONS column for Descriptive Metadata.

    "},{"location":"modifyingfileextensionsinwebform/#step-3-editing-elements","title":"Step 3: Editing Elements","text":"

    Here we see all of the elements in Descriptive Metadata; Title, Media type, Description, Linked Data elements, etc. The element that we want to edit is Upload Associated Documents as this is the field you will use to upload pdf, doc, rtf, txt, etc. files during the ingest workflow. Click on Edit under the OPERATIONS column.

    A new screen will pop up named Edit Upload Associated Documents element. This is where you can configure the maximum number of values (under ELEMENT SETTINGS), the maximum file size and also edit the allowed file extensions for this element, which is what we'll be doing. The latter both exist under FILE SETTINGS section, highlighted in the screenshot below.

    When you scroll down you'll see the Allowed file extensions field. This is where we will add the csv file extension. Please note: All file extensions are separated by a space; no , or . between the values.

    Once you've added all the file extensions your project needs, scroll down to the bottom of Edit Upload Associated Documents element and click Save.

    This next step is imperative for saving your changes, scroll to the bottom of your elements list page and click Save elements in order to persist all changes made.

    "},{"location":"modifyingfileextensionsinwebform/#complete","title":"Complete","text":"

    Woohoo! Now when you are ingesting a DigitalDocument object, you will be able to add csv files! \ud83c\udf53

    "},{"location":"modifyingfileextensionsinwebform/#recap","title":"Recap","text":"

    When logged in as an admin, we go to Manage > Structure > Webforms and click on Build under the OPERATIONS column of Descriptive Metadata (shortcut: /admin/structure/webform/manage/descriptive_metadata). Then we click on Upload Associated Documents to edit the element, scroll down to the Allowed file extensions field and add csv without . or , separating the values. Click Save at the bottom of the Edit Upload Associated Documents element page and then Save elements at the bottom of the Webform page.

    "},{"location":"modifyingfileextensionsinwebform/#that-was-helpful-but","title":"That was helpful, but...","text":"How do I upload a wav or aiff file for \"MusicRecording\" or an mov file for a \\\"Movie\\\"?

    The steps are virtually the same as what is outlined in this guide! The difference here is that instead of editing Upload Associated Documents, you will need to edit the field element that is associated with your ADO's media type. For example, with Media type MusicRecording, you will edit Upload Audio File, for Movie, will edit Videos.

    How do I know which element in Descriptive Metadata to edit per media type?

    When editing an element inside Descriptive Metadata, at the top of the window Edit Upload Associated Documents element (see Step 3 for a recap on how to get here) there is a tab next to General titled Conditions. Inside of Conditions we have CONDITIONAL LOGIC which is where the Webform is told which Media type needs this element to be visible in the Webform. In the example below, we know that the field element Upload Associated Documents will be visible when DigitalDocument, Thesis and Book are the selected Media type.

    This is also the place you can add new logic or delete present logic by clicking the + or - next to the TRIGGER/VALUE to create new conditionals.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"ourtake/","title":"Archipelago's Philosophy & Guiding Principles","text":"

    Archipelago operates under a different concept than the one we all have become used to in recent times. We like to think this is not done by re-inventing the wheel, but by making sure the road is clean, level, and with fewer obstacles than before. We do this by removing some heavy weight from the top, some unneeded ballast, plus, of course, some well positioned innovations to make the ride enjoyable.

    We also like to say that Archipelago is like a Metadata Synthetizer (LFO anyone?) and we want to give you all the knobs, parameters, inputs and outputs to make the best out of it. Still, you can make \"music\" by just tapping the keyboard.

    To get here we had to do a full stop first. Look around. Questioning everything we knew. Research and test (repeat) and then re-architect slowly on new and old assumptions, and especially new community values.

    "},{"location":"ourtake/#whys-and-whats-of-archipelago","title":"Whys and Whats of Archipelago","text":"

    Because this topic is near and dear to our hearts, we are taking extra care with writing this important document. Please stay tuned for the full, verbose, heartfelt, and detailed long story of Archipelago's origins, development, future hopes and dreams.

    In the meantime, please consider reviewing this presentation created by Archipelago's Lead Architect Diego Pino which captures the essence of Archipelago's philosophy and guiding principles:

    • Archipelago : an empathic Digital Repository Architecture

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"presentations_events/","title":"Archipelago Presentations, Events, and Additional Resources","text":"

    Important General & Internal Recordings Notes

    Please be aware that some of the presentation documents shared above may contain links to older documentation resources that have since changed or are no longer available. We recommend referring to the latest documentation versions available on this site whenever needed.

    METRO's Digital Services Team facilitated many different internal training sessions throughout 2020-2022. If you and your team need access to any of these sessions that were recorded, please contact us. Thank you!

    "},{"location":"presentations_events/#2023","title":"2023","text":"

    • IIIF Search API and Dynamic/evolving Manifest Generation: Facing the Unknown. Diego Alberto Pino Navarro, Allison Sherrick.

      • \ud83d\udcfa Recording available

    • DLF Forum (November 2023)

      • Working and Learning the IIIF Search API in Archipelago. Diego Pino Navarro, Allison Sherrick.
      • Working with Open-Schema JSON in Archipelago. Allison Sherrick, Diego Pino Navarro, Martha Tenney, Joanna DiPasquale, Corinne Chatnik.
      • Slaying the Migration Dragon: Approaches to Navigating an Open Source System Migration. Lisa McFall, Sarah Walden McGowan, Brenden McCarthy, Shay Foley.

    • IIIF Annual Conference (June 2023)

      • Experimental IIIF Kitchen using Archipelago. Pino Navarro, Diego; Sherrick, Allison.
      • Mapping an Engineer Through IIIF. Monger, Jenifer J.; McCarthy, Brenden; Pino Navarro, Diego; Sherrick, Allison.

    • Into Archipelago Commons: Access, Innovation and Community in Modern Archives. Monger, Jenifer J.; McCarthy, Brenden; Corinne Chatnik. (June 2023)

    • Implementing Archipelago: An Innovative, Community Driven, Open-Source Repository. Corinne Chatnik, Union College; Martha Tenney, Barnard College. (June 2023)
    • For the Love of Data and Ourselves: The Bumpy, Technical Road to Modern Archives. Monger, Jenifer J.; McCarthy, Brenden. (January/February 2023)
    "},{"location":"presentations_events/#2022","title":"2022","text":"

    • Archipelago Late 2022 Workshop Series:

      • Session 1 : AMI Essentials and Tricks of the Trade. Pino Navarro, Diego; Sherrick (Lund), Allison; Romabiles, Katie. (November 2022)
        • \ud83c\udfa5 Recording available (registration required)
      • Session 2: Twig Templating and Metadata Display Preview for AMI Ingest. Pino Navarro, Diego; Sherrick (Lund), Allison; Romabiles, Katie; Min, Albert. (December 2022)
        • \ud83c\udfa5 Recording available (registration required)
      • Session 3: AMI Set Processing and Advanced Find + Replace (December 2022)
        • \ud83c\udfa5 Recording available (registration required)

    • McCarthy, B. J. (2022). Archipelago Commons: Using the Archipelago and AMI software to provide access to Rensselaer Polytechnic Institute's engineering drawings, a pilot project. Issues in Science and Technology Librarianship, 101. https://doi.org/10.29173/istl2717

    • Open Perspectives Forum. Monger, Jenifer J.; McCarthy, Brenden. (November 2022)

    • Migration, Collaboration and Innovation with Archipelago Commons. Monger, Jenifer J. (September 2022)

    • \ud83c\udf53 Archipelago 1.0.0 - August 2022 Release Announcement (August 2022) and updated Specs and Features List

    • Open Repositories June 2022

      • Collaborative W3C Web Annotations using Annotorious in Archipelago and computer vision explorations as cataloger aids. Pino Navarro, Diego; Simon, Rainer.
      • Modern Web Archiving with Archipelago and Webrecorder : WACZ, Replay.web and Deep Discovery in Digital Repositories. Pino Navarro, Diego; Kreymer, Ilya.
      • Working with IIIF Manifests in Archipelago. Sherrick (Lund), Allison.

    • Formation of the Archipelago Working Group (April 2022)

      • In the Spring of 2022, METRO supported the creation of a select group of both early adopters and longtime members of the Archipelago community to provide a dedicated space for Archipelago power users to build upon their demonstrated use-explorations, contribute further to the platform and have a direct influence on roadmap code, direction, and timeline. This group will also work on documentation needs, use cases and outreach (including public showcases, trainings/workshops, and other events).
    Archipelago Working Group Members
    • Giancarlo Birello at CNR Italy
    • Jennifer Palmentiero at SENYLRC
    • Brenden McCarthy at RPI
    • Lisa McFall at Hamilton College
    • Megan Tyne at Association Montessori Internationale\u00a0
    • Carl Jones at MIT Libraries
    • Martha Tenney at Barnard College Library
    • David Bass / Max Bronsema at Western Washington University
    • Sarah Walden McGowan at Amherst College
    • Prashanth B at Vipassana Research Institute
    • Ianthe Sutherland at University at Edinburgh
    • Corinne\u00a0Chatnik at Union College
    • Toward Empathetic Digital Repositories: An Interview with Diego Pino Navarro (January 2022)
    "},{"location":"presentations_events/#2021","title":"2021","text":"

    • \ud83c\udf53 Archipelago 1.0.0-RC3 and 1.0.0 Release Announcement - November 2021

    • AMIA Conference Workshop: Building a Web Archive-Capable Digital Repository with Webrecorder and Archipelago. Kreymer, Ilya; Ramirez-Lopez, Lorena; Dickson, Emma; Pino Navarro, Diego; Sherrick (Lund), Allison. (November 2021)

    • Solr Importer AMI Migrations, Showcase and Roundtable. Pino Navarro, Diego; Sherrick (Lund), Allison. (July 2021)

      • Please see latest I7 Solr Importer and AMI LoD Reconciliation documentation.

    • IIIF Annual 2021 Conference:

      • Learning & Working with IIIF in Archipelago - 2021 IIIF Annual Conference. Pino Navarro, Diego; Sherrick (Lund), Allison. (June 2021)
      • Editing a IIIF Manifest in Archipelago. Pino Navarro, Diego; Sherrick (Lund), Allison.

    • June 2021 Open Repositories Conference:

      • Europeana Data Model (EDM) Workflows in Archipelago. Pino Navarro, Diego; Sherrick (Lund), Allison.
        • \ud83d\udcfa Recording available
      • 'Broken for All' Persistent Identifiers Panel Discussion. Kunze, John; Holmes-Wong, Deborah; Rafique, Zahid; Lohnash, Megan; Sherrick (Lund), Allison; Turner, Adrian; McKinley, Matthew.
        • \ud83d\udcfa Recording available

    • WebRecorder + Archipelago Workshop. Pino Navarro, Diego; Sherrick (Lund), Allison; Kreymer, Ilya; Ramirez-Lopez, Lorena; Dickson, Emma. (May 2021)

      • \ud83d\udcfa Recording available

    • Twig Templates and Archipelago. Pino Navarro, Diego; Sherrick (Lund), Allison. (May 2021)

      • Review of the core role Twig templating plays in Archipelago, introduction to the basics of Twig, and demonstration of editing Twig templates in Archipelago to refine metadata displays and AMI ingests.
      • \ud83c\udfa5 Recording available (registration required)

    • \ud83c\udf53Archipelago 1.0.0-RC2 Release Announcement (May 2021) and Archipelago RC2 Specs and Features List

    • Working with Archipelago Multi-Importer (AMI). Pino Navarro, Diego; Sherrick (Lund), Allison. (April 2021)

      • Introduction to AMI, discussion of ingest strategies and options, and demonstration of an AMI ingest.
      • \ud83d\udcfa Recording available

    • Archipelago Digital Objects Repository (an) architecture to last. Pino Navarro, Diego. (DrupalCon North America 2021)

      • \ud83d\udcfa Recording available

    • Metadata, Schemas and Media in Archipelago. Pino Navarro, Diego; Sherrick (Lund), Allison (February 2021)

      • Exploration of the flexible and extensible ways Archipelago manages Metadata, Schemas, and Media.
      • \ud83c\udfa5 Recording available (registration required)

    • Deploying Archipelago 1.0.0-RC1. Pino Navarro, Diego; Sherrick (Lund), Allison. (February 2021)

      • Demonstration of a complete walkthrough of a local Archipelago 1.0.0-RC1 deployment.
      • \ud83c\udfa5 Recording available (registration required)
    "},{"location":"presentations_events/#2020","title":"2020","text":"

    • \ud83c\udf53 Archipelago 1.0.0-RC1 Release Announcement (December 2020)

    • Webforms in Archipelago. Pino Navarro, Diego; Sherrick (Lund), Allison; Palmentiero, Jennifer. (December 2020)

    • IIIF and Archipelago - Community Call. Pino Navarro, Diego. (October 2020)

    • Archipelago : an empathic Digital Repository Architecture (September 2020)

    • \ud83c\udf53 Archipelago 8.x-1.0-beta3 Release Announcement (July 2020)

    "},{"location":"presentations_events/#we-should-be-here","title":"We should be here","text":"

    If you have a public Archipelago presentation, recording, or other resource you'd like to share on this page \ud83c\udfdd\ufe0f\ud83d\udccd, please contact us. We would love to add your great work to this list! \ud83d\udc9a

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"search-within-collection/","title":"How to Add a 'Search Within Collection' Block","text":"

    This guide covers how to add a 'Search Within Collection' Exposed Form Block to the default Archipelago Collection Display Page.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#preamble-prerequisites","title":"Preamble + prerequisites","text":"

    Before diving into any Search and Solr configuration related changes, we strongly recommend that you read our Metadata in Archipelago overview documentation, which provides important context for understanding how the shape of your Archipelago Digital Objects/Collections (ADOs) metadata will inform your Search and Solr options and outcomes. If you don't have the bandwidth to read the (stellar) Metadata in Archipelago documentation, we recommend you read through our in-a-nutshell overview.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-1-open-the-collection-membership-view","title":"Step 1: Open the Collection Membership View","text":"

    Navigate to the Collection Membership view found at:

    • /admin/structure/views/view/collection_membership
    • Through the Structure menu > Views > Collection Membership

    This View is setup to list the member Digital Objects of a Collection and is driven by Solr.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-2-adjust-the-views-advanced-tab-settings","title":"Step 2. Adjust the View's Advanced tab settings","text":"

    Open the 'Advanced' tab settings and change the 'Exposed form in block' to 'Yes'.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-3-add-the-fulltext-search-filter-criteria-for-the-view","title":"Step 3. Add the Fulltext Search Filter Criteria for the View","text":"

    On the left-hand side of the Collection Membership View form, under the 'Filter criteria' section, add and configure the 'Fulltext search' Criteria.

    At the top of the 'Configure filter criterion: Search: Fulltext search' form that opens:

    • Select the option to 'Expose this filter to visitors, to allow them to change it'.

    On the lower section of the form, adust the configuration options as follows:

    • Remove any text from 'Label' or 'Description
    • Operator: select/check 'Contains all of these words'
    • Allow multiple selections : leave unchecked
    • Remember the last selection : leave unchecked
    • Filter identifier: leave default of 'search_api_fulltext'
    • Placeholder: enter 'Search within Collection' (or your preferred text)
    • Search field character limit: set to '128'
    • Expose searched fields : leave unchecked
    • Searched fields : leave all unselected, so \"If no fields are selected, all available fulltext fields will be searched.\"
    • Minimum keyword length : set to '1'

    Select 'Apply' and continue to the next Step.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-4-reviewadjust-options-and-save-the-updated-view","title":"Step 4. Review/adjust options and Save the Updated View","text":"

    Review the changes you made to the Collection Membership View. Optionally further adjust the options if desired. For example, you may choose to change the Submit button text to 'Search' instead of 'Apply'). If you make any further changes select, 'Apply' before exiting.

    'Save' your changes made to the View before proceeding.

    Your updated Collection Membership View should look like the following now:

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-5-place-the-exposed-form-block","title":"Step 5. Place the Exposed Form Block","text":"

    Navigate to the Block Layout found at:

    • /admin/structure/block
    • Through the Structure menu > Block layout

    Select the Archipelago Base Theme (or whatever theme you are using):

    • admin/structure/block/list/archipelago_subtheme

    Navigate to the 'Content' section of the theme and select 'Place Block'.

    Search for the 'Exposed form: collection_membership-block_1' and select 'Place Block'.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-6-configure-the-blocks-settings","title":"Step 6. Configure the Block's Settings:","text":"

    Configure the different settings for the Block.

    You will need to specify both of the following options under the Visibility section:

    • ADO Type: specify Collection (and any other Collection types you may also have such as 'Newspaper')

    • Content type: select 'Digital Object Collection'

    In the top section of the form, we recommend the following settings:

    • Deselect 'Display title'
    • Under Exposed Form element and component Visibility, deselect the following:
      • Show filter components of type select if exposed
      • Show filter components of type checkbox/options if exposed
      • Override Submit button Label

    Select 'Save block' when you are finished configuring the Block's Settings.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-7-position-the-block-and-save","title":"Step 7. Position the Block and Save.","text":"

    Drag to re-order and position the Exposed Form Block to sit above the Collection Membership block in the Content section. This will position the Exposed Form Block above the list of Collection Member Objects on the display pages for Collections.

    After you have positioned the blocks, scroll down to the bottom of the Block layout page and select 'Save blocks'.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#step-8","title":"Step 8.","text":"

    Navigate to a Collection and test out a Search in the search box that is now in place above the 'Objects in this Collection' listing.

    In this screenshot, you can see a demonstrative Search for 'map' within one of the Archipelago Demo Collections.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search-within-collection/#additional-considerations","title":"Additional Considerations","text":"

    You may also wish to pair this 'Search Within Collection' Exposed Form Block with related Facets (setup on the same corresponding collection membership View). You can find follow the step-by-step instructions in our Strawberry Key Name Providers, Solr Field, and Facet Configuration documentation.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Search","Search Within","Collections","Views","Exposed Forms","Blocks"]},{"location":"search_advanced/","title":"Advanced Search","text":"

    To provide Advanced Search functionality, Archipelago extends a custom Search API based Fulltext Filter for (Drupal) Views. This special 'Search: Advanced Fulltext search' filter is capable of handling multiple inputs with a combination of Boolean Operators, and features additional customizable options for tailoring your Archipelago's Advanced Search setup.

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#default-advanced-search","title":"Default Advanced Search:","text":"

    The default Advanced Search setup shipped with standard Archipelago deployments is intended to serve as an initial blueprint for your own learning and further customizations. Your Archipelago instance, whether you are working in a modified local or production deployment, may not have the same corresponding Solr Fields and/or Facets as present in the default Advanced Search configuration. This guide covers the default Advanced Search Setup, and offers general guidance for customizing to match your desired Advanced Search setup for your unique environment variables (metadata elements/schema found in your JSON data, Keyname combinations, Solr fields, etc.).

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#where-to-find-and-corresponding-configurations","title":"Where to Find and Corresponding Configurations","text":"

    In default Archipelagos, you can find Archipelago's default Advanced Search page:

    • Through the top navigation menu > Advanced Search
    • Directly at /advanced-search

    The default Advanced Search Page includes the following:

    • Advanced Fulltext Search form (more information on the out-of-the-box View settings associated with this form below)
    • Five Facets for narrowing your results (Date of Original, Digital Object Type, Collection Membership, Subjects, and Agents)
    • A Facet Summary section (visible only after selecting Facets)
    • Custom Block containing a Default Advanced Search Note

    The five Facets associated with the default Advanced Search can be found at Administration > Configuration > Search and metadata > Facets under the Facet source - search_api:views_page__advanced_search__page_1.

    The Custom Block containing the Default Advanced Search Note can be found at /admin/content/block or as a Tab on the main Content page.

    The corresponding Facet Blocks and Custom Block can be found at /admin/structure/block/list/archipelago_subtheme in the Sidebar Second section. Please see the this documentation for more information about Keyname Providers, Solr Fields, and Facet Configurations

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#advanced-search-view","title":"Advanced Search View","text":"

    The default Advanced Search View drives the Advanced Search Form. This View can be found at:

    • /admin/structure/views/view/advanced_search
    • Through the Structure menu > Views > Advanced Search

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#configuring-the-filter-criteria-for-the-search-advanced-fulltext-search","title":"Configuring the filter criteria for the 'Search: Advanced Fulltext search'","text":"

    To view or adjust the configurations click on 'Search: Advanced Fulltext search (and)' in the 'Filter criteria section in the View. You will then see the first part of the following configuration form:

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#part-1-of-the-advanced-search-filter-form","title":"Part 1 of the Advanced Search Filter Form","text":"

    Beginning at the top of the form, you will see:

    • Brief note explaining that the Advanced Fulltext search filter can 'Search several or all fulltext fields at once allowing also multiple operator separated entries'
    • Option to 'Expose this filter to visitors, to allow them to change it'
      • checked in default
    • Option to marked as 'Required'
      • unchecked in default
    • Label: Text field to enter Label for this filter
      • set to 'Advanced Fulltext search' in default
    • Description: Text field to enter brief description for this filter.
      • Tokens are allowed in this field. Replacement options can be found in the \"Global replacement patterns\" section, below.
      • empty in default

    You will then see a section for configuring the starting Operator to use for the form:

    • Contains all of these words
      • checked in default
    • Contains any of these words
    • Contains none of these words
    • A note that 'Depending on the parse mode set, some of these options might not work as expected. Please either use \"Multiple words\" as the parse mode or make sure that the filter behaves as expected for multiple words.'
    • An optional starting Value
      • empty in default

    Next is the beginning of the fuller Operator and Additional Options:

    • Option to 'Expose operator'
      • Allow the user to choose the operator
      • checked in default
    • Option to 'Limit the available operators'
      • Limit the available operators to be shown on the exposed filter
      • unchecked checked in default
      • recommended to enable for Classic Mode (see further notes related to Classic Mode below)
    • Operator identifier: Text field to specify 'the URL after the ? to identify this operator'
      • set to 'sbf_advanced_search_api_fulltext_op' in default
    • Option to 'Allow multiple selections' (Enable to allow users to select multiple items)
    • Option to 'Remember the last selection' (Enable to remember the last selection made by the user)
    • Parse mode : dropdown menu to choose how the search keys will be parsed
      • Direct query
      • Single phrase
      • Multiple words *selected by default and strongly recommended to keep
      • Multiple words with EDisMax
      • Multiple words with fuzziness
      • Phrase search with sloppiness Multiple words with sloppiness
    • Filter identifier : Text field to specify what will appear in the URL after the ? to identify this filter
      • Cannot be blank. Only letters, digits and the dot (\".\"), hyphen (\"-\"), underscore (\"_\"), and tilde (\"~\") characters are allowed.
      • set to 'sbf_advanced_search_api_fulltext' in default
    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#part-2-of-the-advanced-search-filter-form","title":"Part 2 of the Advanced Search Filter Form","text":"
    • Placeholder : Text field to enter hint text that appears inside the field when empty
      • empty in default
    • Note about the 'Multiple words' parse mode (selected earlier in the form)
      • The query is interpreted as multiple keywords separated by spaces. Keywords containing spaces may be \"quoted\". Quoted keywords must still be separated by spaces. Keywords can be negated by prepending a minus sign (-) to them.
    • Search field character limit : specify the maximum number of characters to allow as keywords input.
      • set to 128 in default
    • Option to 'Expose searched fields', which allows users to narrow the search to the desired fields.
      • checked in default
    • Searched fields identifier : text field to specify the URL after the ? to identify this searched fields form element.
      • set to 'sbf_advanced_search_api_fulltext_searched_fields' in default
    • Option to have 'Multiple/add more Search Fields'
      • This allows users to add more Search Fields with the same general exposed settings. All identifiers passed by this filter in the URL after the ? will get an incremental suffix.
      • checked in default

    • Max number of Multiple/add more Search Fields the user can expose.

      • The number of additional search Fields with the same general exposed settings the user will be able to expose.
      • set to a value of '4' in default

    • Searched fields

      • Select the fields that will be searched. If no fields are selected, all available fulltext fields will be searched.
      • The options exposed here will be dependent on your configured Solr Fields.
      • Fields selected by default include:
        1. Content > Strawberry (Descriptive Metadata source) > local_identifier
        2. Content > Strawberry (Descriptive Metadata source) > name
        3. Rendered HTML output
        4. Content > Title FullText

    • Min number of Multiple/add more Search Fields the user will see.

      • Number must be less or equal to the max. If not it will cap automatically.
      • The number of search Fields with the same general exposed settings the user will see by default.
      • set to a value of '1' in default

    • Minimum keyword length

      • Minimum length of each word in the search keys. Leave empty to allow all words.
      • empty in default
    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#part-3-of-the-advanced-search-filter-form","title":"Part 3 of the Advanced Search Filter Form","text":"

    In the last part of the form, you will see:

    • Label to be used for the \"add one\" button

      • \"Label to be used for the \"add more\" button. By default it is \"add one\" if left empty
      • empty in default

    • Replacement pattern for user facing Fields.

      • In this text area, you will have the option to supply your preferred user-facing label for your selected search fields.
      • You will see all of the fields available in your Solr.
      • You supply your preferred labels and set the user-facing dropdown ordering for your targeted fields being used.
      • Use a Pipe (|) to separate value from desired label. One per line
      • To adjust the label for a field, replace the text following the pipe (|) symbol in the string to your preferred label.
      • Field label adjustments and order specified selected by default include:
        1. rendered_item|Rendered HTML Output
        2. title|Title (full text)
        3. name_1|Names/Agents
        4. local_identifier|Local Identifier

    • Label to be used for the \"remove one\" button
      • \"Label to be used for the \"add one\" button. By default it is \"remove one\" if left empty
      • set to 'remove' in default
    • Option to 'Expose between search fields operator'
      • Allow the user to choose the operator between Multiple Search Fields (AND/OR)
      • checked in default
    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#classic-mode","title":"Classic Mode","text":"
    • Option to 'Use Classic Mode' : When you select the 'Classic Mode', your Advanced Search form will interact in a way that mimics older catalog search interfaces. This means that:
      • when you add/remove fields, this does not trigger automatic refreshing of the Search results
      • search only triggers on the default Form Filter submit button
      • this mode fully depends on Javascript to get around Views Exposed Filters in forms always submitting on any interaction.
      • unchecked in default

    If you specify to 'Use Classic Mode', you will also see:

    • Option to 'Add a Remove button to every Advanced Search Field combo.'

      • This will allow a user to remove a specific Advanced Search Field/And/or/Text. Only works on Classic Mode.
      • only appears on form when 'Use Classic Mode' is enabled, hidden and unchecked in default
      • strongly recommended to enable for Classic Mode setups

    • Please see above note in Part 1 of the Advanced Search Filter Form to also select the option to 'Limit the available operators' when using Classic Mode.

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#end-of-advanced-search-filter-form","title":"End of Advanced Search Filter Form","text":"

    For both the normal, modern Advanced Search setup and also with Classic Mode enabled, you will also see:

    • Multiple/add more Search Fields operator (AND/OR) fields identifier

      • Text field to specify what will appear in the URL after the ? to identify the operator used in the filter when multiple Search Fields and their extra options are exposed.
      • set to 'sbf_advanced_search_api_fulltext_group_operator' in default

    • You will also see a section for 'Global replacement patterns (for description field only), where you can Brose available tokens for this purpose.

      • No replacement patterns specified for the View Description field in default. Not recommended.
    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_advanced/#example-query-test","title":"Example Query Test","text":"

    In your local or fresh live Archipelago deployment, populated with the Archipelago Demo Set Objects and Collections, test your Advanced Search setup using the following query: - 'Contains all of these words' + the term 'Art' in the 'Rendered HTML Output' Field - 'OR' operator + 'Contains all of these words' + the term 'Diego' in the 'Names/Agents' field - Select the 'Archipelago Demo Collection' from the Collection Membership Facet

    You should see the following results:

    The corresponding advanced search url should be: - http://localhost:8001/advanced-search?sbf_advanced_search_api_fulltext_op=and&sbf_advanced_search_api_fulltext=Art&sbf_advanced_search_api_fulltext_searched_fields=rendered_item&sbf_advanced_search_api_fulltext_advanced_search_fields_count=2&sbf_advanced_search_api_fulltext_group_operator_1=or&sbf_advanced_search_api_fulltext_op_1=and&sbf_advanced_search_api_fulltext_1=Diego&sbf_advanced_search_api_fulltext_searched_fields_1=name_1&f%5B0%5D=is_member_of_content_title%3AArchipelago+Demo+Collection&op=Search

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Search","Search API","Solr","Solr Fields","Solr Index","Facets","Strawberry Key Name Providers"]},{"location":"search_solr_index/","title":"Search and Solr","text":"

    Archipelago's default Search and Solr configurations are intended to cover the most common needs for a typical repository search experience.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"search_solr_index/#preamble-prerequisites","title":"Preamble + prerequisites","text":"

    Before diving into any Search and Solr configuration changes, we strongly recommend that you read our Metadata in Archipelago overview documentation, which provides important context for understanding how the shape of your Archipelago Digital Objects/Collections (ADOs) metadata will inform your Search and Solr options and outcomes.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"search_solr_index/#archipelago-and-solr","title":"Archipelago and Solr","text":"

    Archipelago's latest Release (1.1.0) uses Apache Solr 9.1, which incorporates some major improvements and changes from Solr 8. Please refer to the primary Solr documentation for the most comprehensive and in-depth information about Solr's wide breadth of functionality and configuration options.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"search_solr_index/#ocr-highlights","title":"OCR Highlights","text":"

    Archipelago uses solr-ocrhighlighting v0.8.4, built by the Development Team at the Bavarian State Library. See our Strawberry Runners Post-Processing documentation for more information about configuring page-based HOCR/OCR extraction for image and pdf-based ADOs and options for sending that output to the Search API.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"search_solr_index/#in-a-nutshell-json-data-to-strawberry-keyname-providers-to-solr","title":"In-a-nutshell : JSON data to Strawberry Keyname Providers to Solr","text":"

    If you don't have the bandwidth to read the (stellar) Metadata in Archipelago documentation, focus on the following in-a-nutshell understanding of the way Archipelago's Search and Solr is crafted. Then follow the step-by-step instructions found in Strawberry Key Name Providers, Solr Field, and Facet Configuration to get started customizing your Search setup.

    1. JSON Data for your Archipelago Digital Objects: you need to have your descriptive metadata in JSON keys and values for ADOs and Collections in your Archipelago. Your JSON metadata and (extracted technical) data is the crucial source for Search and Solr.

    2. Strawberry Keyname Providers: you need to have corresponding Strawberry Keyname Providers configured to feed the values from your desired JSON keys to Solr fields. One of the most powerful tools in Archipelago's Search functionality comes from the extensibility of Strawberry Keyname Providers, which can be used to source specific data points from a variety of JSON keys found in your repository.

    More about Strawberry Keyname Providers

    1. Solr Fields: you need to configure your desired Solr Fields to source from the Strawberry Keynames you have configured. By default, Archipelago also provider Solr Fields sourced from your HOCR data and the Rendered HTML output of your ADOs.

    2. *3.5. Drupal Views: for your regular Search, Advanced Search, and potentially other specialized Views, you can configure to search within specific and/or a variety of Solr Fields.

    3. Search Results: your metadata and data, as configured through Keyname Providers and Fields, indexed into your Solr.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"search_solr_index/#excerpted-from-metadata-in-archipelago","title":"Excerpted from Metadata in Archipelago","text":"

    One of the challenges of our flexible approach is how to allow Drupal to access the JSON in a way, as native as possible, to generate filtered listings via Drupal Views, free text Search and Faceting. To make this happen Strawberry Field uses a JSON Querying and Exposing as \"Native Field Properties\" logic. Through a special type of Plugin system named Strawberry Key Name Providers and associated Configuration Entities (can be found at /admin/structure/strawberry_keynameprovider), you have control on which keys and values of your JSON are going to be exposed as field properties of any Strawberry Field, allowing Drupal through this to access values in a flat manner and expose them to the Search API natively. The access to the values of any JSON is done via JMESPATH expressions and then transformed either to a list of values or even \"cast\" into more complex data Data types, like an Entity Reference (means a connection to another Entity). This gives you a lot of power and control and makes a lot of very heavy operations lighter. You can even plan upfront or evolve these properties in time.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"search_solr_index/#instructions-and-guides","title":"Instructions and Guides","text":"
    • Strawberry Key Name Providers, Solr Field, and Facet Configuration
    • Advanced Search
    • How to Add a 'Search Within Collection' Block

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Search","Search API","Solr","Solr Index","Facets","Strawberry Key Name Providers","OCR","HOCR"]},{"location":"security_bots/","title":"Managing Bots","text":"

    A public-facing production instance will likely encounter bad bots and other malicious traffic that will consume resources. There are many solutions available that address a variety of different needs, but we provide basic configurations and a Docker image for integrating the NGINX Ultimate Bad Bot & Referrer Blocker.

    Warning

    Before proceeding, please be sure to familiarize yourself with the NGINX Ultimate Bad Bot & Referrer Blocker README.

    ","tags":["Security","Bots"]},{"location":"security_bots/#deployment","title":"Deployment","text":"
    1. Uncomment or add the following docker-compose environment variables, replacing any appropriate values with your own and leaving the blocker and cron disabled to start (see highlighted lines): .env
      MSMTP_ACCOUNT=SMTP_ACCOUNT_NAME\nMSMTP_EMAIL=repositorysupport@metro.org\nMSMTP_HOST=smtp.metro.org\nMSMTP_PASSWORD=YOUR_SMTP_PASSWORD\nMSMTP_PORT=SMTP_PORT\nMSMTP_STARTTLS=on\nNGXBLOCKER_ENABLE=false\nNGXBLOCKER_CRON=00 22 * * *\nNGXBLOCKER_CRON_COMMAND=/usr/local/sbin/update-ngxblocker -x\nNGXBLOCKER_CRON_START=false\n
    2. Uncomment or add the following lines and comment out the line for the original NGINX image: docker-compose.yml
      # Run docker-compose up -d\n# Docker file for Arm64 and Apple M1 machines\nversion: '3.5'\nservices:\n  web:\n    container_name: esmero-web\n    # image: jonasal/nginx-certbot\n    image: esmero/nginx-bot-blocker:1.1.0-multiarch\n    restart: always\n    environment:\n      CERTBOT_EMAIL: ${ARCHIPELAGO_EMAIL}\n      ENVSUBST_VARS: FQDN\n      FQDN: ${ARCHIPELAGO_DOMAIN}\n      NGINX_ENVSUBST_OUTPUT_DIR: /etc/nginx/user_conf.d\n      MSMTP_ACCOUNT: ${MSMTP_ACCOUNT}\n      MSMTP_EMAIL: ${MSMTP_EMAIL}\n      MSMTP_HOST: ${MSMTP_HOST}\n      MSMTP_PASSWORD: ${MSMTP_PASSWORD}\n      MSMTP_PORT: ${MSMTP_PORT}\n      MSMTP_STARTTLS: ${MSMTP_STARTTLS}\n      NGXBLOCKER_CRON: ${NGXBLOCKER_CRON}\n      NGXBLOCKER_CRON_COMMAND: ${NGXBLOCKER_CRON_COMMAND}\n      NGXBLOCKER_CRON_START: ${NGXBLOCKER_CRON_START}\n      NGXBLOCKER_ENABLE: ${NGXBLOCKER_ENABLE}\n    ports:\n      - \"80:80\"\n      - \"443:443\"\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/config_storage/nginxconfig/template:/etc/nginx/templates\n      - ${ARCHIPELAGO_ROOT}/drupal:/var/www/html:cached\n      - ${ARCHIPELAGO_ROOT}/data_storage/ngnixcache:/var/cache/nginx\n      - ${ARCHIPELAGO_ROOT}/data_storage/letsencrypt:/etc/letsencrypt\n      - ${ARCHIPELAGO_ROOT}/config_storage/nginxconfig/bots.d:/etc/nginx/bots.d\n

    3. First pull the new image: 

      docker compose pull\n

      Note

      If using an older version of docker, don't forget the hyphen: 

      docker-compose pull\n

    4. Now bring the Docker ensemble down and up again: 

      docker compose down && docker compose up -d\n

      Note

      If using an older version of docker, don't forget the hyphen: 

      docker-compose down && docker-compose up -d\n

    5. Run the install script for the bot blocker in the default dry run mode and review the output: 

      docker exec -ti esmero-web bash -c \"/usr/local/sbin/install-ngxblocker\"\n

    6. The script will output the changes that are going to be made. Review them carefully and ensure that they are ok to make. Then run the command with the execute flag: 
      docker exec -ti esmero-web bash -c \"/usr/local/sbin/install-ngxblocker -x\"\n
    7. Run the setup script for the bot blocker in the default dry run mode and review the output: 
      docker exec -ti esmero-web bash -c \"/usr/local/sbin/setup-ngxblocker -v /etc/nginx/templates -e .copy\"\n
    8. The script will output the NGINX configuration changes that are going to be made. Review them carefully and ensure that they are ok to make. Then run the command with the execute flag: 
      docker exec -ti esmero-web bash -c \"/usr/local/sbin/setup-ngxblocker -v /etc/nginx/templates -e .copy -x\"\n

    9. Enable the bot blocker and cron (if applicable): .env

      MSMTP_ACCOUNT=SMTP_ACCOUNT_NAME\nMSMTP_EMAIL=repositorysupport@metro.org\nMSMTP_HOST=smtp.metro.org\nMSMTP_PASSWORD=YOUR_SMTP_PASSWORD\nMSMTP_PORT=SMTP_PORT\nMSMTP_STARTTLS=on\nNGXBLOCKER_ENABLE=true\nNGXBLOCKER_CRON=00 22 * * *\nNGXBLOCKER_CRON_COMMAND=/usr/local/sbin/update-ngxblocker -x\nNGXBLOCKER_CRON_START=true\n

      Note

      If MSMTP_EMAIL is blank and cron is enabled the flag for sending email notifications will be skipped.

    10. Bring the Docker ensemble down and back up again: 

      docker compose down && docker compose up -d\n

      Note

      If using an older version of docker, don't forget the hyphen: 

      docker-compose down && docker-compose up -d\n

    11. Test that it is working by following the \"TESTING\" section (STEP 10) in the official documentation: https://github.com/mitchellkrogza/nginx-ultimate-bad-bot-blocker

    ","tags":["Security","Bots"]},{"location":"security_bots/#deployment-with-upgrade","title":"Deployment with Upgrade","text":"

    If looking to use this solution as part of an upgrade (from 1.0.0 to 1.1.0, for example) we recommend coming back to the above steps after successfully completing the upgrade. After the upgrade, you will only need to add the environment variables and docker compose configurations and follow the steps as detailed above.

    ","tags":["Security","Bots"]},{"location":"security_bots/#advanced-configuration","title":"Advanced Configuration","text":"

    Because our Docker containers only persist our mounted files and folders, any advanced configurations may require overriding the files generated by our esmero-web container on boot. For example, the above setup-ngxblocker script is normally responsible for writing the following include lines:

    include /etc/nginx/bots.d/blockbots.conf;\ninclude /etc/nginx/bots.d/ddos.conf;\n

    Because the script is unable to place them in the correct part of our nginx.conf.template file, which in turn generates our nginx.conf file (see Using environment variables in nginx configuration), our own script adds (when NGINXBLOCKER_ENABLE=true) or removes (when NGINXBLOCKER_ENABLE=false) the lines to an empty file, which in turn is statically included in our main nginx.conf.template file. One option provided by setup-ngxblocker is to exclude (-d) the DDOS rule. In our case, we need to manually override the lines in our template file to reproduce this behavior:

    Example

    nginx.conf.template
    upstream cantaloupe {\n  server esmero-cantaloupe:8182;\n}\n\nserver {\n    listen              443 ssl;\n    server_name         ${FQDN};\n    ssl_certificate     /etc/letsencrypt/live/${FQDN}/fullchain.pem;\n    ssl_certificate_key /etc/letsencrypt/live/${FQDN}/privkey.pem;\n    client_max_body_size 1536M; ## Match with PHP from FPM container\n\n    root /var/www/html/web; ## <-- Your only path reference.\n\n    fastcgi_send_timeout 120s;\n    fastcgi_read_timeout 120s;\n    fastcgi_pass_request_headers on;\n\n    fastcgi_buffers 16 16k;\n    fastcgi_buffer_size 32k;\n\n    # Please adapt to your needs\n    proxy_buffers 16 16k;  \n    proxy_buffer_size 16k;\n\n    #include /etc/nginx/conf.d/bots.include;\n    include /etc/nginx/bots.d/blockbots.conf;\n

    Note

    Keep in mind that from this point, when disabling/enabling the bot blocker via the environment variable, you'll also need to uncomment/comment the added line.

    Another more generally applicable approach is to override files that are part of the docker image:

    Example

    Our bash script (setup_bot_blocker.sh) is triggered by and runs just before the startup script (start_nginx_certbot.sh) for the NGINX Certbot image. For any advanced needs involving custom startup behavior, our script can be modified and overwridden:

    1. First, we'll copy the script from the running Docker container onto our host: 
      docker cp esmero-web:/scripts/setup_bot_blocker.sh drupal/scripts/archipelago/\n
    2. Then we mount the file to override the container's file: docker-compose.yml
      # Run docker-compose up -d\n# Docker file for Arm64 and Apple M1 machines\nversion: '3.5'\nservices:\n  web:\n    container_name: esmero-web\n    # image: jonasal/nginx-certbot\n    image: esmero/nginx-bot-blocker:1.1.0-multiarch\n    restart: always\n    environment:\n      CERTBOT_EMAIL: ${ARCHIPELAGO_EMAIL}\n      ENVSUBST_VARS: FQDN\n      FQDN: ${ARCHIPELAGO_DOMAIN}\n      NGINX_ENVSUBST_OUTPUT_DIR: /etc/nginx/user_conf.d\n      MSMTP_ACCOUNT: ${MSMTP_ACCOUNT}\n      MSMTP_EMAIL: ${MSMTP_EMAIL}\n      MSMTP_HOST: ${MSMTP_HOST}\n      MSMTP_PASSWORD: ${MSMTP_PASSWORD}\n      MSMTP_PORT: ${MSMTP_PORT}\n      MSMTP_STARTTLS: ${MSMTP_STARTTLS}\n      NGXBLOCKER_CRON: ${NGXBLOCKER_CRON}\n      NGXBLOCKER_CRON_COMMAND: ${NGXBLOCKER_CRON_COMMAND}\n      NGXBLOCKER_CRON_START: ${NGXBLOCKER_CRON_START}\n      NGXBLOCKER_ENABLE: ${NGXBLOCKER_ENABLE}\n    ports:\n      - \"80:80\"\n      - \"443:443\"\n    volumes:\n      - ${ARCHIPELAGO_ROOT}/config_storage/nginxconfig/template:/etc/nginx/templates\n      - ${ARCHIPELAGO_ROOT}/drupal:/var/www/html:cached\n      - ${ARCHIPELAGO_ROOT}/data_storage/ngnixcache:/var/cache/nginx\n      - ${ARCHIPELAGO_ROOT}/data_storage/letsencrypt:/etc/letsencrypt\n      - ${ARCHIPELAGO_ROOT}/config_storage/nginxconfig/bots.d:/etc/nginx/bots.d\n      - ${ARCHIPELAGO_ROOT}/drupal/scripts/archipelago/setup_bot_blocker.sh:/scripts/setup_bot_blocker.sh\n
    3. Then we modify our script copy (we'll reproduce the same behavior from the previous example but incorporate it into our script): drupal/scripts/archipelago/setup_bot_blocker.sh
      #!/bin/bash\n\nset -e\n\nif [ ! -z \"${MSMTP_EMAIL}\" ]; then\n    envsubst < /root/.msmtprc.template > /root/.msmtprc\nfi\n\nif [ \"${NGXBLOCKER_CRON_START}\" = true ]; then\n    if [ ! -z \"${MSMTP_EMAIL}\" ]; then\n      CRON_COMMAND=\"${NGXBLOCKER_CRON} ${NGXBLOCKER_CRON_COMMAND} -e ${MSMTP_EMAIL}\"\n    else\n      CRON_COMMAND=\"${NGXBLOCKER_CRON} ${NGXBLOCKER_CRON_COMMAND} -n\"\n    fi\n    echo \"${CRON_COMMAND}\" | crontab - &&\n    /etc/init.d/cron start\nfi\n\nif [ ! -f /etc/nginx/templates/bots.include.copy ]; then\n    touch /etc/nginx/templates/bots.include.copy\nfi\nif [ ! -f /etc/nginx/templates/bots.include.template ]; then\n    touch /etc/nginx/templates/bots.include.template\nfi\n\nif [ \"${NGXBLOCKER_ENABLE}\" = true ]; then\n    if [ ! -L /etc/nginx/conf.d/botblocker-nginx-settings.conf ]; then\n        ln -s /etc/nginx/bots_settings_conf.d/botblocker-nginx-settings.conf /etc/nginx/conf.d/botblocker-nginx-settings.conf\n    fi\n    if [ ! -L /etc/nginx/conf.d/globalblacklist.conf ]; then\n        ln -s /etc/nginx/bots_settings_conf.d/globalblacklist.conf /etc/nginx/conf.d/globalblacklist.conf\n    fi\n    if ! grep -q blockbots.conf /etc/nginx/templates/bots.include.copy; then\n        echo \"include /etc/nginx/bots.d/blockbots.conf;\" >> /etc/nginx/templates/bots.include.copy\n    fi\n    #if ! grep -q ddos.conf /etc/nginx/templates/bots.include.copy; then\n    #    echo \"include /etc/nginx/bots.d/ddos.conf;\" >> /etc/nginx/templates/bots.include.copy\n    #fi\n    if ! grep -q blockbots.conf /etc/nginx/user_conf.d/bots.include; then\n        echo \"include /etc/nginx/bots.d/blockbots.conf;\" >> /etc/nginx/user_conf.d/bots.include\n    fi\n    #if ! grep -q ddos.conf /etc/nginx/user_conf.d/bots.include; then\n    #    echo \"include /etc/nginx/bots.d/ddos.conf;\" >> /etc/nginx/user_conf.d/bots.include\n    #fi\n    cp /etc/nginx/templates/bots.include.copy /etc/nginx/templates/bots.include.template\nelse\n    >|/etc/nginx/templates/bots.include.template\n    >|/etc/nginx/user_conf.d/bots.include\n    if [ -L /etc/nginx/conf.d/botblocker-nginx-settings.conf ]; then\n        rm /etc/nginx/conf.d/botblocker-nginx-settings.conf\n    fi\n    if [ -L /etc/nginx/conf.d/globalblacklist.conf ]; then\n        rm /etc/nginx/conf.d/globalblacklist.conf\n    fi\nfi\n
    4. Next we remove the include line from the existing files: 
      docker exec -ti esmero-web bash -c \"sed -i '/include \\/etc\\/nginx\\/bots.d\\/ddos.conf/d' /etc/nginx/templates/bots.include.copy\"\n
      docker exec -ti esmero-web bash -c \"sed -i '/include \\/etc\\/nginx\\/bots.d\\/ddos.conf/d' /etc/nginx/templates/bots.include.template\"\n
      docker exec -ti esmero-web bash -c \"sed -i '/include \\/etc\\/nginx\\/bots.d\\/ddos.conf/d' /etc/nginx/user_conf.d/bots.include\"\n

    5. Finally we bring the Docker ensemble down and back up again to propagate the changes in our container: 

      docker compose down && docker compose up -d\n

      Note

      If using an older version of docker, don't forget the hyphen: 

      docker-compose down && docker-compose up -d\n

    The above is an example of a more complicated customization, but it's a pattern that can be used more generally throughout the Docker containers, i.e.:

    1. Copy the file that needs to be overwridden from the Docker container to the host and make custom changes.
    2. Mount the file from the host to the location within the docker container, e.g.: 
      - ${ARCHIPELAGO_ROOT}/LOCATION_ON_HOST/CUSTOMIZED_FILE_ON_HOST:/LOCATION_IN_DOCKER_CONTAINER/FILE_IN_DOCKER_CONTAINER\n
    3. Bring the Docker ensemble down and bring it up again.
    ","tags":["Security","Bots"]},{"location":"sslsetup/","title":"How to Setup SSL for Docker/Archipelago","text":"

    Work-In-Progress Note This documentation page is still under construction and content may change with future updates. Please use caution when implementing any instructions referenced herein, as there may be missing steps or corresponding configuration files. Thank you for your patience as we continue to update Archipelago's documentation.

    The steps found below describe one potential manual SSL configuration for Archipelago deployments. A git clone deployment option will be available for future releases.

    "},{"location":"sslsetup/#manual-configuration-steps-for-an-ec2-aws-server","title":"Manual Configuration Steps for an EC2 AWS Server","text":"

    This process takes less than 10 minutes of reading YML files and editing a few files (described below) to get SSL running and setup with auto-renewal.

    1. First, configure Certbot, following the instructions found on https://certbot.eff.org.

    2. Inside a /persistent partition, establish the following folder structure. Note: you can keep the existing folder structure if you so choose. A benefit of the following structure is that it decouples the git clone of archipelago-deployment, which is made to be self sustainable and good for coding or smaller deployments.

      [ec2-user@ip-17x-xx-x-xxx persistent]$ ls -lah\ntotal 64K\ndrwxr-xr-x 14 root           root  4.0K Oct  5 23:11 .\ndr-xr-xr-x 19 root           root  275 Dec 15  2019 ..\ndrwxr-xr-x  8       999  999   4096 Oct 13 20:07 db\ndrwxr-xr-x 13 root           root  4.0K Oct  5 23:03 drupal8\ndrwxr-xr-x  5           8183  8183   4.0K Feb 23  2020 iiifcache\ndrwxr-xr-x  2 root           root  4.0K Feb 23  2020 iiifconfig\ndrwxr-xr-x  4 root           root  4.0K Oct  5 22:45 nginx_conf\ndrwxr-xr-x  3 root           root  4.0K Feb 26  2019 solrconfig\ndrwxr-xr-x  3           8983 8983  4.0K Feb 26  2019 solrcore\n

      To get to this point, create a git clone of archipelago deployment and then copy the content of the /persistent out of the repo folder into this structure. The original (or what is left) archipelago-deployment ends inside a drupal8 folder here.

    3. Copy and paste the following to create a local copy of this file:

      docker-compose.yml

      **Be sure to replace youremail@gmail.com with your email address.

       version: '3.5'\n services:\n   web:\n     container_name: esmero-web\n     image: staticfloat/nginx-certbot\n     restart: always\n     environment:\n       CERTBOT_EMAIL: \"youremail@gmail.com\"\n     ports:\n       - \"80:80\"\n       - \"443:443\"\n     volumes:\n       - /persistent/nginx_conf/conf.d:/etc/nginx/user.conf.d:ro\n       - /persistent/nginx_conf/certbot_extra_domains:/etc/nginx/certbot/extra_domains:ro\n       - /persistent/drupal8:/var/www/html:cached\n     depends_on:\n       - solr\n       - php\n     tty: true\n     networks:\n       - host-net\n       - esmero-net\n   php:\n     container_name: esmero-php\n     restart: always\n     image: \"esmero/php-7.3-fpm:latest\"\n     tty: true\n     networks:\n       - host-net\n       - esmero-net\n     volumes:\n       - ${PWD}:/var/www/html:cached\n   solr:\n     container_name: esmero-solr\n     restart: always\n     image: \"solr:7.5.0\"\n     tty: true\n     ports:\n       - \"8983:8983\"\n     networks:\n       - host-net\n       - esmero-net\n     volumes:\n       - /persistent/solrcore:/opt/solr/server/solr/mycores:cached\n       - /persistent/solrconfig:/drupalconfig:cached\n     entrypoint:\n       - docker-entrypoint.sh\n       - solr-precreate\n       - drupal\n       - /drupalconfig\n   # see https://hub.docker.com/_/mysql/\n   db:\n     image: mysql:5.7\n     command: --max_allowed_packet=256M\n     container_name: esmero-db\n     restart: always\n     environment:\n       MYSQL_ROOT_PASSWORD: esmerodb\n     networks:\n       - host-net\n       - esmero-net\n     volumes:\n       - /persistent/db:/var/lib/mysql:cached\n   iiif:\n     container_name: esmero-cantaloupe\n     image: \"esmero/cantaloupe-s3:4.1.6\"\n     restart: always\n     ports:\n       - \"8183:8182\"\n     networks:\n       - host-net\n       - esmero-net\n     volumes:\n       - /persistent/iiifconfig:/etc/cantaloupe\n       - /persistent/iiifcache:/var/cache/cantaloupe\n networks:\n   host-net:\n     driver: bridge\n   esmero-net:\n     driver: bridge\n     internal: true\n

      Note: This file shows how the folders in Step 1 are being used, and how SSL is being automatically deployed and renewed (without any human interaction other than starting the docker-compose and watching the logs).

    4. Now copy and paste the following to create a local copy of this file:

      ngnix.conf

      **Be sure to replace all instances of yoursite.org with your own domain.

       # goes into /persistent/nginx_conf/conf.d/nginx.conf\n upstream cantaloupe {\n  server  esmero-cantaloupe:8182;\n  }\n\n  server {\n    listen              443 ssl;\n    server_name         yoursite.org;\n    ssl_certificate     /etc/letsencrypt/live/yourstie.org/fullchain.pem;\n    ssl_certificate_key /etc/letsencrypt/live/yoursite.org/privkey.pem;\n\n     client_max_body_size 512M; ## Match with PHP from FPM container\n\n    root /var/www/html/web; ## <-- Your only path reference.\n\n    fastcgi_send_timeout 120s;\n    fastcgi_read_timeout 120s;\n    fastcgi_pass_request_headers on;\n\n    fastcgi_buffers 16 16k;\n    fastcgi_buffer_size 32k;\n\n    # Cantaloupe proxypass\n    location /cantaloupe/ {\n       proxy_set_header X-Forwarded-Proto $scheme;\n       proxy_set_header X-Forwarded-Host $host;\n       proxy_set_header X-Forwarded-Port $server_port;\n       proxy_set_header X-Forwarded-Path /cantaloupe/;\n       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n       if ($request_uri ~* \"/cantaloupe/(.*)\") {\n         proxy_pass http://cantaloupe/$1;\n       }\n    }\n\n    location = /favicon.ico {\n        log_not_found off;\n        access_log off;\n    }\n\n    location = /robots.txt {\n        allow all;\n        log_not_found off;\n        access_log off;\n    }\n\n    # Very rarely should these ever be accessed outside of your lan\n    location ~* \\.(txt|log)$ {\n        deny all;\n    }\n\n    location ~ \\..*/.*\\.php$ {\n        return 403;\n    }\n\n    location ~ ^/sites/.*/private/ {\n        return 403;\n    }\n\n    # Allow \"Well-Known URIs\" as per RFC 5785\n    location ~* ^/.well-known/ {\n        allow all;\n    }\n\n    # Block access to \"hidden\" files and directories whose names begin with a\n    # period. This includes directories used by version control systems such\n    # as Subversion or Git to store control files.\n    location ~ (^|/)\\. {\n        return 403;\n    }\n\n    location / {\n        try_files $uri /index.php?$query_string; # For Drupal >= 7\n    }\n\n    location @rewrite {\n        rewrite ^/(.*)$ /index.php?q=$1;\n    }\n\n    # Don't allow direct access to PHP files in the vendor directory.\n    location ~ /vendor/.*\\.php$ {\n        deny all;\n        return 404;\n    }\n\n    # Allow Modules to be updated via UI (still we believe composer is the way)    \n    rewrite ^/core/authorize.php/core/authorize.php(.*)$ /core/authorize.php$1;\n\n    # In Drupal 8, we must also match new paths where the '.php' appears in\n    # the middle, such as update.php/selection. The rule we use is strict,\n    # and only allows this pattern with the update.php front controller.\n    # This allows legacy path aliases in the form of\n    # blog/index.php/legacy-path to continue to route to Drupal nodes. If\n    # you do not have any paths like that, then you might prefer to use a\n    # laxer rule, such as:\n    #   location ~ \\.php(/|$) {\n    # The laxer rule will continue to work if Drupal uses this new URL\n    # pattern with front controllers other than update.php in a future\n    # release.\n    location ~ '\\.php$|^/update.php' {\n        fastcgi_split_path_info ^(.+?\\.php)(|/.*)$;\n        include fastcgi_params;\n        # Block httpoxy attacks. See https://httpoxy.org/.\n        fastcgi_param HTTP_PROXY \"\";\n        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;\n        fastcgi_param PATH_INFO $fastcgi_path_info;\n        fastcgi_param PHP_VALUE \"upload_max_filesize=512M \\n post_max_size=512M\";\n        proxy_read_timeout 900s;\n        fastcgi_intercept_errors on;\n        fastcgi_pass esmero-php:9000;\n    }\n\n     # Fighting with Styles? This little gem is amazing.\n    location ~ ^/sites/.*/files/styles/ { # For Drupal >= 7\n        try_files $uri @rewrite;\n    }\n\n    # Handle private files through Drupal.\n    location ~ ^/system/files/ { # For Drupal >= 7\n        try_files $uri /index.php?$query_string;\n    }\n}\n

    5. Create the following folder:

      /persistent/nginx_conf/conf.d/\n

    6. Place the ngnix.conf file inside the /conf.d/ folder.

    7. Create also this other folder:

      /persistent/nginx_conf/certbot_extra_domains/\n

    8. Inside the /certbot_extra_domains/ folder, create a text file named the same way as your domain (which can/or not contain additional subdomains but needs to exist).

      cat  /persistent/nginx_conf/certbot_extra_domains/yoursite.org\n
      drwxr-xr-x 2 root root 4.0K Oct  5 22:46 .\ndrwxr-xr-x 4 root root 4.0K Oct  5 22:45 ..\n-rw-r--r-- 1 root root   48 Oct  5 22:46 yoursite.org\n

      Optionally, create additional subdomains if needed.

      cat  /persistent/nginx_conf/certbot_extra_domains/yoursite.org\nsubdomain.yoursite.org\nanothersub.yoursite.org\n

    9. Make sure you have edited the docker-compose.yml and ngnix.conf files you created to match your own information. Also make sure to also adjust the paths if you do not want the /persistent approach described in Step 1.

    10. Run the following commands:

      docker -compose up -d\ndocker ps\n

      You should see this:

      b5a04747ee06        staticfloat/nginx-certbot    \"/bin/bash /scripts/\u2026\"   8 days ago          Up 8 days           0.0.0.0:80->80/tcp, 0.0.0.0:443->443/tcp   esmero-web\n84afae094b57        esmero/php-7.3-fpm:latest    \"docker-php-entrypoi\u2026\"   8 days ago          Up 8 days           9000/tcp                                   esmero-php\n13a9214acfd0        esmero/cantaloupe-s3:4.1.6   \"sh -c 'java -Dcanta\u2026\"   8 days ago          Up 8 days           0.0.0.0:8183->8182/tcp                     esmero-cantaloupe\n044dd5bc7245        mysql:5.7                    \"docker-entrypoint.s\u2026\"   8 days ago          Up 8 days           3306/tcp, 33060/tcp                        esmero-db\n31f4f0f45acc        solr:7.5.0                   \"docker-entrypoint.s\u2026\"   8 days ago          Up 8 days           0.0.0.0:8983->8983/tcp                     esmero-solr\n

    11. SSL has now been configured for your Archipelago instance.

    "},{"location":"sslsetup/#user-contributed-documentation","title":"User contributed documentation:","text":"

    Adding SSL to Archipelago running docker by Zachary Spalding: https://youtu.be/rfH5TLzIRIQ

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"strawberry_key_name_providers/","title":"Strawberry Key Name Providers, Solr Field, and Facet Configuration","text":"

    For an overview of how Strawberry Key Name Providers fit within the context of the rest of Archipelago, please see the Drupal and JSON section in our Metadata in Archipelago overview documentation.

    In order to expose the Strawberry Field JSON keys (and values) for Archipelago Digital Objects (ADOs) to Search/Solr, Views, and Facets, we need to make use of a plugin system called Strawberry Key Name Providers. The following guide covers - Configuring first the Strawberry Key Name Providers - Then configuring the corresponding Solr Fields necessary for Search and Views exposure - Finally, the configuration of Facets and placement of Facet blocks on your theme as needed.

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#creating-a-strawberry-key-name-provider","title":"Creating a Strawberry Key Name Provider","text":"

    1. First, we'll start with an example of a Strawberry Field JSON key that we would like to expose:

      date_created_edtf

      ...\n\"subject_wikidata\": [\n    {\n        \"uri\": \"http:\\/\\/www.wikidata.org\\/entity\\/Q55488\",\n        \"label\": \"railway station\"\n    }\n],\n\"date_created_edtf\": {\n    \"date_to\": \"\",\n    \"date_free\": \"2016~\\/2017~\",\n    \"date_from\": \"\",\n    \"date_type\": \"date_free\"\n},\n\"date_created_free\": null,\n...\n

    2. Next, we are going to create a new Strawberry Key Name Provider by going to Administration > Structure > Strawberry Key Name Providers, pressing the + Add Strawberry Key Name Provider button, filling in the fields as follows, and saving:

      • Label: Date Created EDTF
      • Strawberry Key Name Provider Plugin: JmesPath Strawberry Field Key Name Provider
      • One or more comma separated valid JMESPaths: date_created_edtf.date_free
      • Confirm that the value for Exposed Strawberry Field Property (under the One or more comma separated valid JMESPaths field) is set to date_created_edtf_date_free. This is the Strawberry Field Property that will hold the data coming from the JMESPath Query when evaluated against and ADO's JSON and will be visible as a Strawberry Field Property to Drupal and the Search API. When doing this in a production environment, you might want to change the automatically generated value and assign a simpler one to remember. You can always do this by pressing Edit. But for the purpose of this documentation please keep date_created_edtf_date_free.
      • Is Date?: \u2611
    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#strawberry-key-name-provider-plugins","title":"Strawberry Key Name Provider Plugins","text":"

    You'll notice that there are four plugins, each with different options, available for different use cases. Below you'll find each plugin with examples from the providers that come with a default deployment.

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#entity-reference-jmespath-strawberry-field-key-name-provider","title":"Entity Reference JmesPath Strawberry Field Key Name Provider","text":"

    ismemberof

    One or more comma separated valid JMESPaths: ismemberof

    Entity type: node

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#flavorembedded-json-service-strawberry-field-key-name-provider","title":"Flavor/Embedded JSON Service Strawberry Field Key Name Provider","text":"

    hoCR Service

    Source JSON Key used to read the Service/Flavour: ap:hocr

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#jmespath-strawberry-field-key-name-provider","title":"JmesPath Strawberry Field Key Name Provider","text":"

    Subject Labels

    One or more comma separated valid JMESPaths: subject_loc[*].label, subject_wikidata[*].label, subject_lcnaf_geographic_names[*].label,subject_temporal[*].label, subject_lcgft_terms[*].label, term_aat_getty[*].label, pubmed_mesh[*].label

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#jsonld-strawberry-field-key-name-provider","title":"JSONLD Strawberry Field Key Name Provider","text":"

    Best Practice

    As in the example below, if there are a group of flat and unique keys that you want to expose, we recommend creating one provider with this plugin and using a list of keys instead of creating multiple providers. This Provider will also auto assign Lists of Properties from an external JSON-LD ontology/vocabulary (e.g Schema.org). It uses direct access approach, e.g. type will get all values for any JSON Key named type at any hierarchy level (across the whole JSON document) and it will also use the same exact name (type) for the Exposed Strawberry Field Property.

    schema.org

    Additional keys separated by commas: ismemberof,type,hocr,city,category,country,state,display_name,author,license

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#creating-a-solr-field","title":"Creating a Solr Field","text":"
    1. Go to Administration > Configuration > Search and metadata > Search API > Drupal Content to Solr 9 > Fields.
    2. Press the Add fields button.
    3. Search for the field created above (expand the \ud83c\udf53 Strawberry (Descriptive Metadata source) (field_descriptive_metadata), e.g. for the key mapped above, look for field_descriptive_metadata:date_created_edtf_date_free.
    4. Scroll down after adding to make sure the Type for the field is correct (date for the example in this guide).
    5. Reindex Solr.
      1. Go to Administration > Configuration > Search and metadata > Search API and click on the link to the index for your Drupal data.
      2. Press the Queue all items for reindexing button.
      3. Let cron reindex or press the Index now button.
    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#creating-a-facet","title":"Creating a Facet","text":"
    1. Go to Administration > Configuration > Search and metadata > Facets.
    2. Press the + Add facet button.
    3. Select your facet settings. For the example in this guide, we'll select the following:
      • Facet source: View Solr search content, display Page
      • Field: \ud83c\udf53 Strawberry (Descriptive Metadata source) >> date_created_edtf_date_free (field_descriptive_metadata:date_created_edtf_date_free)
      • Name: \ud83c\udf53 Strawberry (Descriptive Metadata source) >> date_created_edtf_date_free
    4. Save.
    5. Continue with the facet configuration by pressing Edit for the facet we just created and adjusting the many options available as needed. For the example in this guide, we'll adjust the below from the default settings:
      • Facet settings
        • \u2611 Date item processor
          • Date display
            • \ud83d\udd18 Actual date with granularity
          • Granularity
            • \ud83d\udd18 Year
        • URL alias: sbf_date_created_edtf
    6. Save.
    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberry_key_name_providers/#creating-a-block-for-the-facet","title":"Creating a Block for the Facet","text":"
    1. Go to Administration > Structure > Block layout.
    2. Select the appropriate theme. For the example in this guide, we'll select Archipelago Base Theme.
    3. Press the Place block button next to the appropriate region. For the example in this guide, we'll be placing the block in the Sidebar second region.
    4. Select your facet from the list. For the example in this guide, we'll select \ud83c\udf53 Strawberry (Descriptive Metadata source) >> date_created_edtf_date_free
    5. Press the Place block button next to the facet. Once the block is added, you can drag and drop it to change its position among the existing blocks and saving.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Strawberry Key Name Providers","Solr","Facets","Search"]},{"location":"strawberryfield-formatters/","title":"Strawberryfield Formatters","text":"

    This documentation will give a brief overview of Archipelago's Strawberryfield Formatters and how they work using the default View mode Digital Object Full View as an example.

    "},{"location":"strawberryfield-formatters/#at-a-glance","title":"At a glance","text":"

    When taking a look at your First Digital Object note that multiple formatters are working together to create this Display ( or View mode). Since \"My First Digital Object\" is a Photograph the Display being used is Digital Object Full View which, by default, uses formatters to:

    • (Red) Create the image viewer where users can zoom in, zoom out, fullscreen and rotate all the images associated with the ADO.
    • (Blue) Display the Object Description and Type of Resource.
    • (Green) Display the Raw JSON Metadata and IIIF Presentation Manifest.

    "},{"location":"strawberryfield-formatters/#in-greater-detail","title":"In Greater Detail","text":"

    When editing an ADO, at the top of the Webform page there is a tab titled Manage display which will take us to where all the Formatters live. Take note that the DISPLAY SETTINGS shown in the screenshot below are using the Default View mode.

    Once the page loads the Default View mode is automatically selected. However, because we are editing an object with the Media type Photograph, we need to edit the View mode Digital Object Full View since it is the Default View mode for this Media type.

    "},{"location":"strawberryfield-formatters/#how-to-find-and-configure-which-view-mode-is-default-per-media-type","title":"How to find and configure which View mode is Default per Media type","text":"

    The ADO Type to View mode Mapping page tells the ADOs which View mode to use by default per Media type. This page can be accessed at yoursite//admin/config/archipelago/viewmode_mapping

    Formatters Shipped with Archipelago
    1. Default
    2. Collection listing
    3. Digital Object Full View
    4. Digital Object with 3D Viewer
    5. Digital Object with A/V Player
    6. Digital Object with Book Reader
    7. Digital Object with Mirador Viewer
    8. Digital Object with Pannellum Panorama
    9. Digital Object with PDF Viewer
    10. Digital Object with Replay.web Webarchive Player
    11. Digital Object with Replay.web Webarchive with Navbars
    12. Digital Object with Video Player
    13. Digital Object with thumbnail and abstract
    Default View Mode Mappings by Media Type JSON (Media) Type View Mode Name 1. Video Digital Object with Video Player 2. 3DModel Digital Object with 3D Viewer 3. Photograph Digital Object Full View 4. Thesis Digital Object with PDF Viewer 5. Panorama Digital Object with Pannellum Panorama 6. Book Digital Object with Book Reader 7. Podcast Digital Object with A/V Player 8. Collection Collection Listing 9. Article Digital Object with PDF Viewer 10. Map Digital Object with Mirador Viewer 11. MusicRecording Digital Object with A/V Player 12. Sculpture Digital Object with 3D Viewer 13. VisualArtwork Digital Object with Video Player 14. Painting Digital Object with Mirador Viewer 15. WebPage Digital Object with Replay.web Webarchive Player 16. PanoramaTour Digital Object with Pannellum Panorama

    There are two sections in Manage display for Digital Object Full View: 1) Content and 2) Disabled. Moving a field into Content means this formatter will be used to the display the ADO in some way. The formatters moved to Disabled are inactive and are subsequently not being used for displaying the ADO.

    There are four fields named \ud83c\udf53Strawberry and each one is a copy of the field \ud83c\udf53Strawberry (Descriptive Metadata source). Since the names of the fields do not imply their function, they have been named Strawberry in four different ways (Italiano, Deutsch, Din\u00e9 Bizaad, and English) in order to organize and help users visually remember which field is doing what for the Display.

    Recall My First Digital Object at beginning of this document where there were 3 sections highlighted in Red, Blue, and Green.

    • In Red (\ud83c\udf53Fragola) there is the Strawberry Field Formatter for IIIF media which takes the image stored in S3 to display the photograph with the image viewer.
    • In Blue (\ud83c\udf53Erdbeere) there is the Strawberry Field Formatter for Custom Metadata Templates which displays the raw JSON metadata using configurable Twig templates. In this example, the default Twig template uses the JSON key type to display the Type of Resource.
    • In Green (\ud83c\udf53Strawberry (Descriptive Metadata)) there is the Strawberry Default Formatter which is used to display the Raw JSON Metadata.

    "},{"location":"strawberryfield-formatters/#at-the-end-of-the-day","title":"At the end of the day","text":"

    The decision for how your metadata is displayed is totally in your control.

    Under the WIDGET column, there is a quick description/overview of what the formatter is doing.

    And by clicking on the gear icon under the OPERATIONS column, all of the options for configuring the formatter are revealed. To use \ud83c\udf53Fragola as an example (the Formatter for IIIF media), we can choose which JSON Key is being used to fetch the IIIF Media URLs (found inside the raw JSON being played with Strawberry Default Formatter), the maximum height and width of the viewer, etc.

    And then with \ud83c\udf53Erdbeere (the Formatter for Custom Metadata Templates) there is the option, among many others, to configure which Twig template the formatter will use for displaying your Metadata.

    More information about Managing Metadata Displays with Twig Templates can be found here.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"strawberryfields/","title":"Strawberryfields Forever","text":""},{"location":"strawberryfields/#what-strawberry-fields-does-why-we-built-it-and-what-issues-it-addresses","title":"What Strawberry fields does, why we built it, and what issues it addresses","text":"

    Archipelago integrates transparently into the Drupal 8 ecosystem using its Core Content Entity System (Nodes), Discovery (Search API) and in general all its Core Components plus a few well maintained external ones.

    By design (and because we think its imperative), Archipelago takes full charge of the metadata layer and associated media assets by implementing a highly configurable, smart Drupal field written in JSON named Strawberryfield that attaches to any content.

    All of JSON's internals, keys, paths, and values are dynamically exposed to the rest of the ecosystem. Strawberryfield even remembers its structure as data evolves by storing JSON paths of every little detail.

    "},{"location":"strawberryfields/#nothing-is-real","title":"Nothing Is Real","text":"

    Archipelago includes additional companion modules, Webform_strawberryfield and Format_strawberryfield that extend the core metadata capabilities of the main Strawberryfield module and allow the same flexibility to be exposed during ingest and viewing of digital objects.

    The in-development Strawberry Runners and AMI modules further extend Archipelago's capabilities. Additional information related to these modules will be made available following initial public releases.

    "},{"location":"strawberryfields/#ingesting","title":"Ingesting","text":"

    Webform Strawberryfield (we had a better name) extends and integrates into the amazing Drupal Webform module to allow Archipelago users to build any possible metadata and media, ingest and edit, workflows directly via the UI using webforms.

    By not having a hardcoded ingest method, Archipelago can be used outside the GLAM community too, as a pure data repository in biological sciences, digital humanities, archives, or even as a mixed, multidisciplinary/cross-domain system.

    We also added WIKIDATA, LoC, Getty, and VIAF authority querying elements to aid in linking to external Linked Open Data sources.

    All these integrations are made to help local needs and community identities to survive the never-ending race for the next metadata schema. They are made to prototype, plan, and grow independently of how metadata will need to be exposed yesterday or tomorrow. And we plan to add more.

    Explore what other features webform_strawberryfield provides to help with ingesting, reading, and interacting with your metadata during that process.

    "},{"location":"strawberryfields/#exposing","title":"Exposing","text":"

    Format Strawberryfield (we had even a better name but...) deals with taking your JSON based metadata and casting, mashing, mixing, exposing, displaying, and transforming it to allow rich interaction for users and other systems with your digital objects.

    In its guts (or heart?), Archipelago does something quite simple but core to our concept of repository: it transforms in realtime the close to your needs open schema metadata that lives in strawberryfield as JSON into close to other one's fixed schema needs metadata; any destination format, using a fast, cached templating system. A templating system that is core to Drupal, called Twig:

    • Twig in Symfony
    • Twig in Drupal

    This templating system is exposed to Archipelago users through the UI and stored side by side in the repository as content (we named them Metadata Display entities, but they not only serve display needs!) so users can fully control how metadata is transformed and published without touching their individual sources.

    Templates or recipes can be shared, exported, ingested, updated, and adapted in many ways. Fast changes are possible without having to wait for the next mayor release of Archipelago or your favorited Metadata Schema Specs Committee agreeing on the next or the last version. Of course, this module not only handles metadata but media assets too, extracting local or remote URIs and files from your metadata and rendering them as media viewers: books, 3D models, images, panoramas, A/V with IIIF in its soul.

    You can learn more about what format_strawberryfield can do and what many other possibilities are exposed through our templating system.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"strawberryrunners/","title":"Strawberry Runners Post-Processing Configuration","text":"

    Archipelago's Strawberry Runners (SBR) module provides provides a set of post-processing capabilities for the JSON based metadata, files and entities that comprise your Archipelago Digital Objects (ADOs). These post-processing actions are based on dispatched events, direct http calls, and invoked webhooks from partner services (such as Min.io, AWS S3 or self-invoked).

    The default Archipelago SBR post-processor configurations include operations that: - perform page-based HOCR/OCR for image and pdf-based ADOs, send the output to the Search API, and use Natural Language Processing to extract entities from the output - extract text from pages within a Webarchives File and send the output to the Search API - convert WARC format Webarchives Files into WACZ format and attach the new WACZ file to the original source ADO to complement the WARC original

    SBR actions can be chained and nested to enable ordered operations, such as first extract individual pages in an ordered sequence and then run HOCR/OCR across the individual pages.

    ","tags":["Strawberry Runners","HOCR","OCR","Post-processing","Background Processing"]},{"location":"strawberryrunners/#strawberry-runners-settings-overview","title":"Strawberry Runners Settings Overview","text":"

    You can access the Strawberry Runners Settings:

    • Through the Manage menu > Configuration > Archipelago > Configure Strawberry Runners Post Processors
    • Directly at /admin/config/archipelago/strawberry_runners

    On the Strawberry Runners Settings page, you will see the Archipelago default post processor configurations (unless modified).

    1. The pager action uses the 'Post processor that extracts/generates Ordered Sequences of files/pages/children using Files present in an ADO' plugin.
    2. Nested one level in, the ocr action uses the 'Post processor that Runs OCR/HORC against files' plugin. The ocr operations will be executed after the completion of the pager operations.
    3. The wacz_page_extractor action uses the 'Post processor that extracts/generates Indexed Page Content from WACZ files in an ADO' plugin.
    4. Nested one level in, the webpage action uses the 'Post processor that Indexes WACZ Frictionless data Search Index to Search API' plugin. The webpage operations will be executed after the completion of the wacz_page_extractor operations.
    5. The warc_to_wacz action uses the 'Post processor that uses a System Binary to process * files' operations.
    ","tags":["Strawberry Runners","HOCR","OCR","Post-processing","Background Processing"]},{"location":"strawberryrunners/#reviewing-and-adjusting-the-default-post-processors","title":"Reviewing and Adjusting the default Post-Processors","text":"

    From the main Strawberry Runner Settings page, you can review and adjust the settings for the default Archipelago configurations by selecting Edit from the `Operations`` menu.

    Please see the following guides for:

    • Adjusting the pager and ocr operations
    • Adjusting the wacz_page_extractor and webpage operations
    • Adjusting the warc_to_wacz operation
    ","tags":["Strawberry Runners","HOCR","OCR","Post-processing","Background Processing"]},{"location":"strawberryrunners/#triggering-post-processing-actions-manually","title":"Triggering Post-Processing Actions Manually","text":"

    After making adjustments to Strawberry Runners Post-Processing configurations, you may want to trigger/re-trigger a particular action manually.

    You can use Archipelago's Find and Replace to first select a specific group of Digital Objects you wish to target for Post-Processing, then select the Trigger Strawberrry Runners process/reprocess for Archipelago Digital Objects content item from the Find and Replace Actions menu.

    ","tags":["Strawberry Runners","HOCR","OCR","Post-processing","Background Processing"]},{"location":"strawberryrunners/#additional-post-processor-operations","title":"Additional Post Processor Operations","text":"

    Archipelago also includes the Post processor that writes/reads Frictionless Data Packages plugin. Please keep a lookout for future documentation related to using this plugin.

    ","tags":["Strawberry Runners","HOCR","OCR","Post-processing","Background Processing"]},{"location":"strawberryrunners_pager_ocr/","title":"Reviewing and adjusting the pager and ocr Post-Processor operations","text":"

    The pager and ocr Post-processor operations are likely the most important pair of Strawberry Runners in your Archipelago.

    As stated on the Strawberry Runners overview page, the pager action uses the 'Post processor that extracts/generates Ordered Sequences of files/pages/children using Files present in an ADO' plugin. Nested one level in, the ocr action uses the 'Post processor that Runs OCR/HORC against files' plugin. The ocr operations will be executed after the completion of the pager operations.

    Common changes you may wish to make for the pager and/or ocr operations include adding or removing particular types of Archipelago Digital Objects to apply these operations to.

    ","tags":["Strawberry Runners","HOCR","OCR","Pager","Post-processing","Background Processing"]},{"location":"strawberryrunners_pager_ocr/#pager-settings","title":"Pager Settings","text":"

    To review or adjust the configurations for the pager operation, select Edit from the Operations menu.

    In the pager settings, you will see the following configuration options:

    1. Label:

      • Label for this Processor; which should be a unique machine-readable name
      • Can only contain lowercase letters, numbers, and underscores
      • We do not recommend changing this Label from the default pager.

    2. Strawberry Runner Post Processor Plugin:

      • The Post processor that extracts/generates Ordered Sequences of files/pages/children using Files present in an ADO should be selected.
      • We do not recommend changing this Plugin selection.

    3. Checkbox to mark this processor plugin as active

      • We recommend keeping this checked as active at all times, but you may wish to temporarily disable this if you are performing certain types of administrative review tasks such as running large test ingests where you plan on deleting the ADOs before a final ingest.
      • If you accidentally uncheck this and need to re-trigger the pager (and corresponding nested ocr action), you can use Archipelago's Find and Replace to first select a specific group of Digital Objects you wish to target for Post-Processing, then select the Trigger Strawberrry Runners process/reprocess for Archipelago Digital Objects content item from the Find and Replace Actions menu.

    4. ADO type(s) to limit this processor to:

      • A single ADO type or a comma delimited list of ado types that qualify to be Processed.
      • Leave empty to apply to all ADOs. If you do not provide any specific ADO types here, the processor will be applied for all ADOs with the JSON keys selected in the next step.
      • Default ADO types specified are: 'Document,Book,Article'
      • You may wish to add additional types of document/multiple-paged type of ADOs to this list that are custom to you Archipelago environment.

    5. The JSON key that contains the desired source files:

      • By default, the as:image and as:document keys are selected.
      • We do not recommend changing this selection.

    6. Mimetypes(s) to limit this Processor to:

      • A single Mimetype type or a comma separated list of mimetypes that qualify to be Processed.
      • Leave empty to apply any file.
      • Default mimetypes are: 'application/pdf,image/tiff,image/jpeg,image/jp2'

    7. Within the ADO's metadata, the JSON key that contains the language in ISO639-3 (3 letter) format to be used for OCR/NLP processing via Tesseract.

      • Default JSON key specified is: 'language_iso639_3'

    8. Please provide a default language in ISO639-3 (3 letter) format. If none is provided we will use 'eng'.

      • Default language specified is: 'eng'

    9. Timeout in seconds for this process.

      • If the process runs out of time it can still be processed again
      • Default selection is: 10

    10. Order or execution in the global chain.

      • Default selection is: 0
    ","tags":["Strawberry Runners","HOCR","OCR","Pager","Post-processing","Background Processing"]},{"location":"strawberryrunners_pager_ocr/#ocr-hocr-settings","title":"OCR / HOCR Settings","text":"

    To review or adjust the configurations for the ocr operation, select Edit from the Operations menu.

    In the pager settings, you will see several different configuration options.

    1. Label:

      • Label for this Processor; which should be a unique machine-readable name
      • Can only contain lowercase letters, numbers, and underscores
      • We do not recommend changing this Label from the default ocr.

    2. Strawberry Runner Post Processor Plugin:

      • The Post processor that Runs OCR/HORC against files should be selected.
      • We do not recommend changing this Plugin selection.

    3. Checkbox to mark this processor plugin as active

      • We recommend keeping this checked as active at all times, but you may wish to temporarily disable this if you are performing certain types of administrative review tasks such as running large test ingests where you plan on deleting the ADOs before a final ingest.
      • If you accidentally uncheck this and need to re-trigger the pager (and corresponding nested ocr action), you can use Archipelago's Find and Replace to first select a specific group of Digital Objects you wish to target for Post-Processing, then select the Trigger Strawberrry Runners process/reprocess for Archipelago Digital Objects content item from the Find and Replace Actions menu.

    4. The type of source data this processor works on:

      • Select from where the source file this processor needs is fetched.
      • Default selection of 'File entities referenced in the as:filetype JSON structure'.
      • You also have the option of selecting 'Full file paths passed by another processor', but we do not recommend using this option as it is less granular in its application.

    5. ADO type(s) to limit this processor to:

      • A single ADO type or a comma delimited list of ado types that qualify to be Processed
      • Leave empty to apply to all ADOs. If you do not provide any specific ADO types here, the processor will be applied for all ADOs with the JSON keys selected in the next step.
      • Default ADO types specified are: 'Document,Book,Article'
      • You may wish to add additional types of document/multiple-paged type of ADOs to this list that are custom to you Archipelago environment.

    6. The JSON key that contains the desired source files:

      • By default, the as:image and as:document keys are selected.
      • We do not recommend changing this selection.

    7. Mimetypes(s) to limit this Processor to:

      • A single Mimetype type or a comma separated list of mimetypes that qualify to be Processed.
      • Leave empty to apply any file.
      • Default mimetypes are: 'application/pdf,image/tiff,image/jpeg,image/jp2'

    Advanced OCR/HOCR Settings

    We do not recommend making changes to the follow settings unless you are the System Administrator.

    1. The system path to the ghostscript (gs) binary that will be executed by this processor.

      • A full system path to the gs binary present in the same environment your PHP runs
      • Default path specified is: '/usr/bin/gs'

    2. Any additional argument your executable binary requires.

      • Any arguments your ghostscript (gs) binary requires to run. Use %file as replacement for the file if the executable requires the filename to be passed under a specific argument. We recommend testing with -r150 (150dpi image extraction) for better performance but -r300 can be also used if source Images in a PDF are small
      • Default argument specified is: -r150 %file

    3. The system path to the Tesseract binary that will be executed by this processor.

      • A full system path to the Tesseract binary present in the same environment your PHP runs
      • Default path specified is: '/usr/bin/tesseract'

    4. Within the ADO's metadata, the JSON key that contains the language in ISO639-3 (3 letter) format to be used for OCR/NLP processing via Tesseract.

      • Default JSON key specified is: 'language_iso639_3'

    1. Please provide a default language in ISO639-3 (3 letter) format. If none is provided we will use 'eng'

      • Default language specified is: 'eng'

    2. Any additional argument for your tesseract binary.

      • Any arguments your binary requires to run. Use %file as replacement for the file that is output by the GS binary. Use %language as replacement for the chosen language.
      • Default arguments specified are: '%file stdout -l %language hocr'

    3. The data/languages folder for Tesseract

      • Absolute path where the Languages are stored in the Server. This will be used in --tessdata-dir
      • Default path specified is: '/usr/share/tessdata'

    4. The system path to the pdfalto binary that will be executed by this processor.

      • A full system path to the pdfalto binary present in the same environment your PHP runs, e.g /usr/local/bin/pdfalto
      • Default path specified is: '/usr/bin/pdfalto'

    5. Any additional argument for your pdfalto binary.

      • Any arguments your binary requires to run. Use %file as replacement for the file that is output by the pdfalto binary.
      • Default arguments specified are: '%file -q

    6. The expected and desired output of this processor.

      • If the output is just data and \"One or more Files\" is selected all data will be dumped into a file and handled as such.
      • Default selection is: 'Data/Values that can be serialized to JSON'
      • Additional optional is to select 'One or more Files', but it is not recommended unless to use this for the default ocr operation since this will alter how the data is incorporated in the Search API (Solr index).

    7. Where and how the output will be used.

      • Default select is: 'In a Search API Document using the Strawberryfield Flavor Data Source (e.g used for HOCR highlight)'
      • Additional option to select 'As Input for another processor Plugin' --which will only have an effect if another Processor is setup to consume this output.

    8. The queue to use for this processor.

      • The primary queue will be execute in realtime while the Secondary will be execute in background
      • Default selection is for the 'Secondary queue in background'

    9. Checkbox to Use NLP (Natural Language Processing) to extract entities from Text

      • If checked Full text will be processed for Natural language Entity extraction using Polyglot.
      • Default option is to have the option checked.

    10. The URL location of your NLP64 server.

      • Defaults to http://esmero-nlp:6400

    11. Which method(NER) to use

      • The NER NLP method to use to extract Agents, Places and Sentiment.
      • Default selection: 'Polyglot (faster)'
      • Alternation selection: 'spaCy (more accurate)'

    12. Timeout in seconds for this process.

      • 900
      • If the process runs out of time it can still be processed again.
    13. Order or execution in the global chain.
      • 0

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the main Strawberry Runners or the Archipelago Documentation main page.

    ","tags":["Strawberry Runners","HOCR","OCR","Pager","Post-processing","Background Processing"]},{"location":"strawberryrunners_wacz_binary/","title":"Reviewing and adjusting the warc_to_wacz Post-Processor operation","text":"

    This page is under construction. Please stay tuned for further updates and thank you for your patience as we continue to brew up more documentation.

    Return to the main Strawberry Runners or the Archipelago Documentation main page.

    ","tags":["Strawberry Runners","WACZ","WARC","Binary","Post-processing","Background Processing"]},{"location":"strawberryrunners_webpage_text/","title":"Reviewing and adjusting the wacz_page_extractor and webpage Post-Processor operations","text":"

    This page is under construction. Please stay tuned for further updates and thank you for your patience as we continue to brew up more documentation.

    Return to the main Strawberry Runners or the Archipelago Documentation main page.

    ","tags":["Strawberry Runners","Fulltext Search","WACZ","Webpage","Post-processing","Background Processing"]},{"location":"traditional-install/","title":"Traditional install","text":""},{"location":"traditional-install/#traditional-installation-notes","title":"Traditional Installation Notes","text":"

    For those who prefer classic approaches to system installation and configuration (instead of Dockerized deployment), this page is reserved for notes, recommendations, and guides.

    • Giancarlo Birello is maintaining and sharing the following documentation:
      • Dev DBOpen: developer site of the DBOPen project
      • Includes an Architecture overview and Step by Step instructions

    Please stay tuned for additional future updates. Thank you!

    Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "},{"location":"twig_extensions/","title":"Twig Extensions","text":"

    One advantage of Drupal's integration of the Twig template engine is the availability of extensions (filters and functions).

    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON","Markdown","HTML"]},{"location":"twig_extensions/#default-twig-extensions-from-symfony","title":"Default Twig Extensions from Symfony","text":"

    The Symfony PHP framework, which is integrated into Drupal Core, provides extensions, which we use in our default templates:

    • Twig Filters from Symfony
    • Twig Functions from Symfony
    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON","Markdown","HTML"]},{"location":"twig_extensions/#default-twig-extensions-from-drupal","title":"Default Twig Extensions from Drupal","text":"

    Additionally, we have some very handy Drupal-specific extensions:

    • Twig Filters from Drupal
    • Twig Functions from Drupal
    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON","Markdown","HTML"]},{"location":"twig_extensions/#default-twig-extensions-from-archipelago","title":"Default Twig Extensions from Archipelago","text":"

    Finally, we have a growing list of extensions that apply to our own specific use cases:

    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON","Markdown","HTML"]},{"location":"twig_extensions/#twig-filters-from-archipelago","title":"Twig Filters from Archipelago","text":"

    edtf_2_human_date

    The edtf_2_human_date filter takes an EDTF date and an optional language code (defaults to English), and converts it to a human-readable format using the EDTF PHP library. The list of language codes is available here.

    Let's start with the following metadata fragment: Metadata Fragment

    ...\n\"subject_wikidata\": \"\",\n\"date_created_edtf\": {\n    \"date_to\": \"\",\n    \"date_free\": \"~1899\",\n    \"date_from\": \"\",\n    \"date_type\": \"date_free\"\n},\n\"date_created_free\": null,\n...\n

    Then we pass the date_free field through the trim filter (as a precaution, in case there's any accidental whitespace), and then we finally hand off the field to our edtf_2_human_date filter: edtf_2_human_date

    {{ data.date_created_edtf.date_free|trim|edtf_2_human_date('en') }}\n\n{# Output: Circa 1899 #}\n

    html_2_markdown

    The html_2_markdown filter, as the name suggests, converts HTML to Markdown.

    We start with this string of HTML: HTML string

    {% set html_string = \"\n  <ul>\n    <li>One thing</li>\n    <li>Another thing</li>\n    <li>The last thing</li>\n  </ul>\n\" %}\n

    Then we pass it to the filter: html_2_markdown

    {{ html_string | html_2_markdown }}\n\n{# Output:\n  - One thing\n  - Another thing\n  - The last thing\n#}\n

    markdown_2_html

    The markdown_2_html filter, as the name suggests, is the reverse of the above and converts Markdown to HTML.

    We start with this string of Markdown: Markdown string

    {% set markdown_string = \"\n  - One thing\n  - Another thing\n  - The last thing\n\" %}\n

    Then we pass it to the filter: markdown_2_html

    {{ markdown_string | markdown_2_html }}\n\n{# Output:\n  <ul>\n    <li>One thing</li>\n    <li>Another thing</li>\n    <li>The last thing</li>\n  </ul>\n#}\n

    sbf_json_decode

    The sbf_json_decode filter decodes a JSON-encoded string.

    We start with this string of JSON string: JSON string

    {% set json_string = \"\n  {\n    \\\"date_to\\\": \\\"\\\",\n    \\\"date_free\\\": \\\"~1899\\\",\n    \\\"date_from\\\": \\\"\\\",\n    \\\"date_type\\\": \\\"date_free\\\"\n  }\n\" %}\n

    Then we pass it to the filter: sbf_json_decode

    {% json_decoded = json_string | sbf_json_decode %}\n\n{{ json_decoded.date_free }}\n{# Output:\n  ~1899\n#}\n

    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON","Markdown","HTML"]},{"location":"twig_extensions/#twig-functions-from-archipelago","title":"Twig Functions from Archipelago","text":"

    clipboard_copy

    The clipboard_copy function, using the clipboard-copy-element library, takes a provided CSS class for the element(s) whose text we'd like to copy, and targets the CSS class of an existing HTML element on the page or generates an HTML element that can be clicked to copy the text to the user's clipboard.

    Usage

    clipboard_copy usage
    {{ clipboard_copy('CSS CLASS','OPTIONAL CSS CLASS(ES)','OPTIONAL TEXT') }}\n

    This function takes three arguments:

    • a CSS class for the element to copy
    • an optional CSS class (the default is clipboard-copy-button) or classes (space-separated) for the copy button if auto-generating or a single, unique class if using your own existing button(s)
    • optional text (the default is Copy to Clipboard) for the copy button if auto-generating

    In the examples below, we want users to be able to copy the text from three different kinds of HTML elements: a div, an input, and an a hyperlink href.

    Copying div element text with auto-generated button

    First we start by giving the div element(s) we'd like to copy a unique class:

    div element text
    <div class=\"csl-bib-body-container chicago-fullnote-bibliography\">\n  <div id=\"copy-csl\" class=\"csl-bib-body\">\n    <div class=\"csl-entry\">\n      New York Botanical Garden. \u201cDescriptive Guide to the Grounds, Buildings and Collections.\u201d\n    </div>\n  </div>\n</div>\n

    Then we pass the class to the function:

    clipboard_copy for div element text
    {{ clipboard_copy('csl-bib-body','','Copy Bibliography Entry') }}\n

    Note

    The class can be attached to parent elements of the element we are ultimately targeting if needed, but any intermediate characters may get caught up in the copied text.

    Or to give the generated button multiple classes (in case they need additional styling):

    clipboard_copy for div element text
    {{ clipboard_copy('csl-bib-body','custom custom-button','Copy Bibliography Entry') }}\n

    The result for the above div example looks as follows:

    The following is the HTML for the auto-generated button with no provided CSS class:

    <button class=\"clipboard-copy-button\">\n  <clipboard-copy for=\"copy-csl\" tabindex=\"0\" role=\"button\">Copy Bibliography Entry</clipboard-copy>\n</button>\n

    And the following is HTML for the auto-generated button with multiple CSS classes provided:

    <button class=\"custom custom-button\">\n  <clipboard-copy for=\"copy-csl\" tabindex=\"0\" role=\"button\">Copy Bibliography Entry</clipboard-copy>\n</button>\n

    Note

    The clipboard-copy-element library requires an element ID. If the element being copied does not have an ID, one will automatically generated and assigned.

    Copying input element value with auto-generated button

    First we start by giving the input element(s) we'd like to copy a unique class:

    input element value
    {% if attribute(data, 'as:image')|length > 0  or attribute(data, 'as:document')|length > 0  %}\n  <h2>\n    <span class=\"align-middle\">Direct Link to Digital Object's IIIF Presentation Manifest V3 </span>\n    <img src=\"https://iiif.io/img/logo-iiif-34x30.png\">\n  </h2>\n  {% set iiifmanifest = nodeurl|render ~ \"/metadata/iiifmanifest/default.jsonld\" %}\n  <input type=\"text\" value=\"{{ iiifmanifest }}\" id=\"iiifmanifest_copy\" size=\"{{ iiifmanifest|length }}\" class=\"col-xs-3 copy-content\">\n{% endif %}\n

    Then we pass the class to the function:

    clipboard_copy for input element value
    {{ clipboard_copy('copy-content','',\"Copy Link to Digital Object's IIIF Presentation Manifest V3\") }}\n

    Or to give the generated button multiple classes (in case they need additional styling):

    clipboard_copy for input element text
    {{ clipboard_copy('copy-content','custom custom-button',\"Copy Link to Digital Object's IIIF Presentation Manifest V3\") }}\n

    The result for the above input example looks as follows:

    The following is the HTML for the auto-generated button with no provided CSS class:

    <button class=\"clipboard-copy-button\">\n  <clipboard-copy for=\"iiifmanifest_copy\" tabindex=\"0\" role=\"button\">Copy Link to Digital Object's IIIF Presentation Manifest V3</clipboard-copy>\n</button>\n

    And the following is HTML for the auto-generated button with multiple CSS classes provided:

    <button class=\"custom custom-button\">\n  <clipboard-copy for=\"iiifmanifest_copy\" tabindex=\"0\" role=\"button\">Copy Link to Digital Object's IIIF Presentation Manifest V3</clipboard-copy>\n</button>\n

    Note

    The clipboard-copy-element library requires an element ID. If the element being copied does not have an ID, one will automatically generated and assigned.

    Copying anchor element hyperlink href with auto-generated button

    First we start by giving the a element(s) we'd like to copy a unique class:

    anchor element hyperlink href
    <a id=\"copy-documentation-id\" class=\"copy-documentation-class row\" href=\"https://docs.archipelago.nyc\">Archipelago Documentation</a>\n

    Then we pass the class to the function:

    clipboard_copy for anchor element hyperlink href
    {{ clipboard_copy('copy-documentation-class','',\"Copy Link to Documentation\") }}\n

    Or to give the generated button multiple classes (in case they need additional styling):

    clipboard_copy for anchor element text
    {{ clipboard_copy('copy-documentation-class','custom custom-button',\"Copy Link to Documentation\") }}\n

    The result for the above anchor example looks as follows:

    The following is the HTML for the auto-generated button with no provided CSS class:

    <button class=\"clipboard-copy-button\">\n  <clipboard-copy for=\"copy-documentation-id\" tabindex=\"0\" role=\"button\">Copy Link to Documentation</clipboard-copy>\n</button>\n

    And the following is HTML for the auto-generated button with multiple CSS classes provided:

    <button class=\"custom custom-button\">\n  <clipboard-copy for=\"copy-documentation-id\" tabindex=\"0\" role=\"button\">Copy Link to Documentation</clipboard-copy>\n</button>\n

    Note

    The clipboard-copy-element library requires an element ID. If the element being copied does not have an ID, one will automatically generated and assigned.

    The above examples automatically generate copy buttons. They can be styled, but if we need more control over the button placement and styling, we can use our own button(s) by ensuring that they meet the following requirements:

    1. A <copy-clipboard> element (this can be hidden) with a for attribute, whose value is the ID of the source element, attached to the element acting as the button.
    2. A class on the existing button that can be targeted. The class must either be unique (if a single button) or the number of elements with the class must match the number of source elements.
    3. A separate class for the copy source(s) with the same requirements as the previous step.
    Copying div element text with custom button

    First we start by giving the div element(s) we'd like to copy a unique class:

    div element text
    <div class=\"csl-bib-body-container chicago-fullnote-bibliography\">\n  <div id=\"copy-csl\" class=\"csl-bib-body\">\n    <div class=\"csl-entry\">\n      New York Botanical Garden. \u201cDescriptive Guide to the Grounds, Buildings and Collections.\u201d\n    </div>\n  </div>\n</div>\n

    Then we generate the button and pass the class to the function:

    clipboard_copy custom button for div element text
    <button class=\"custom-button btn btn-primary btn-sm\">\n  <clipboard-copy for=\"copy-csl\">Copy Text</clipboard-copy>\n</button>\n\n{{ clipboard_copy('csl-bib-body','custom-button','') }}\n

    Note

    The clipboard-copy-element library requires an element ID. If the element being copied does not have an ID, one will automatically generated and assigned.

    Copying input element value with custom button

    First we start by giving the input element(s) we'd like to copy a unique class:

    input element value
    {% if attribute(data, 'as:image')|length > 0  or attribute(data, 'as:document')|length > 0  %}\n  <h2>\n    <span class=\"align-middle\">Direct Link to Digital Object's IIIF Presentation Manifest V3 </span>\n    <img src=\"https://iiif.io/img/logo-iiif-34x30.png\">\n  </h2>\n  {% set iiifmanifest = nodeurl|render ~ \"/metadata/iiifmanifest/default.jsonld\" %}\n  <input type=\"text\" value=\"{{ iiifmanifest }}\" id=\"iiifmanifest_copy\" size=\"{{ iiifmanifest|length }}\" class=\"col-xs-3 copy-content\">\n{% endif %}\n

    Then we generate the button and pass the class to the function:

    clipboard_copy custom button for input element value
    <button class=\"custom-button btn btn-primary btn-sm\">\n  <clipboard-copy for=\"iiifmanifest_copy\">Copy Input</clipboard-copy>\n</button>\n\n{{ clipboard_copy('copy-content','custom-button','') }}\n

    Note

    The clipboard-copy-element library requires an element ID. If the element being copied does not have an ID, one will automatically generated and assigned.

    Copying anchor element with custom button

    First we start by giving the a element(s) we'd like to copy a unique class:

    anchor element hyperlink href
    <a id=\"copy-documentation-id\" class=\"copy-documentation-class row\" href=\"https://docs.archipelago.nyc\">Archipelago Documentation</a>\n

    Then we generate the button and pass the class to the function:

    clipboard_copy custom button for anchor element hyperlink href
    <button class=\"custom-button btn btn-primary btn-sm\">\n  <clipboard-copy for=\"copy-documentation-id\">Copy Link</clipboard-copy>\n</button>\n\n{{ clipboard_copy('copy-documentation-class','custom-button','') }}\n

    Note

    The clipboard-copy-element library requires an element ID. If the element being copied does not have an ID, one will automatically generated and assigned.

    sbf_entity_ids_by_label

    The sbf_entity_ids_by_label function, as the name suggests, provides a Drupal entity ID for the following Drupal entity types:

    • node
    • taxonomy_term
    • group
    • user

    If we start with the user entity jsonapi, we can do the following: sbf_entity_ids_by_label

    {% set jsonapi_user_ids=sbf_entity_ids_by_label('jsonapi','user','') %}\n\n{% for jsonapi_user_id in jsonapi_user_ids %}\n  {{ jsonapi_user_id }}\n{% endfor %}\n\n{# Output:\n  3\n#}\n

    As you can see above, the sbf_entity_ids_by_label function takes three arguments:

    • the entity label
    • the entity type (see above for supported types)
    • an optional entity bundle

    We then loop through the returned result, which is an array of IDs (in this case, just a single one).

    sbf_search_api

    The sbf_search_api function executes a search API query against a specified index.

    sbf_search_api
    {% set search_results=sbf_search_api('default_solr_index','strawberry',[],{'status':1},[]) %}\n{% set labels=search_results['results']['13']['fields']['label_2'] %}\n<ul>\n  {% for label in labels %}\n    <li>{{ label }}</li>\n  {% endfor %}\n</ul>\n

    As you can see above, the sbf_search_api function takes eight arguments:

    • The machine name of the Search API index to search against (string)
    • A full text term to search (string)
    • An array of full text fields to search the term against. If empty all will be used. (array)
    • The fields => filters to match against (associative array)
    • The fields to facet (array)
    • The fields to sort against (associative array)
    • Offset for the results (int)

    For this example we end up with the following output:

    • JPEG File Interchange Format
    • Organic farming--United States
    • Strawberries
    • Strawberry Field at Thorpes Organic Family Farm
    • organic agriculture
    • strawberries
    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON","Markdown","HTML"]},{"location":"twig_recipe_cards/","title":"Twig Recipe Cards for Common Use Cases","text":"

    The Twig Recipe Cards below reference common Metadata transformation, display, or other use cases/needs you may have in your own Archipelago repository.

    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON"]},{"location":"twig_recipe_cards/#getting-started-working-with-twig-in-archipelago","title":"Getting Started Working with Twig in Archipelago","text":"

    We recommend reading through our main Metadata Display Preview and Twigs in Archipelago documentation overview guides, and also our Working with Twig primer before diving into applying any of these recipes in your own Archipelago.

    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON"]},{"location":"twig_recipe_cards/#ami-ingest-template-adaptations-common-use-cases-and-twig-recipe-cards","title":"AMI Ingest Template Adaptations -- Common Use Cases and Twig Recipe Cards:","text":"

    Use Case #1: I used AMI LoD Reconciliation to reconciliate the values in my AMI Set Source CSV mods_subject_topic column against both LCSH and Wikidata. I would like to map the reconciliated values into the Archipelago default subject_loc and subject_wikidata JSON keys.

    Twig Recipe Card for Use Case #1:

      {#- LCSH -#}\n    {% if data.mods_subject_topic|length > 0 %}\n    \"subject_loc\": {{ data_lod.mods_subject_topic.loc_subjects_thing|json_encode|raw }},\n    {% endif %}\n  {#- Wikidata -#}     \n    {% set subject_wikidata = [] %}\n    {% for source, reconciliated in data_lod %}\n      {% if (('subject' in source) or ('genre' in source)) and reconciliated.wikidata_subjects_thing and reconciliated.wikidata_subjects_thing|length > 0 %}\n         {% set subject_wikidata = subject_wikidata|merge(reconciliated.wikidata_subjects_thing) %}\n      {% endif %}\n    {% endfor %}  \n

    Use Case #2: I have both columns containing a mods_subject_authority_lcsh_topic (labels) and corresponding mods_subject_authority_lcsh_valueuri (URIs) data in my AMI Set Source Data CSV that I would like to pair and map into the Archipelago default subject_loc JSON key.

    Twig Recipe Card for Use Case #2:

    {%- if data['mods_subject_authority_lcsh_topic'] is defined and not empty -%}\n    {% set subjects = data[\"mods_subject_authority_lcsh_topic\"] is iterable ? data[\"mods_subject_authority_lcsh_topic\"] : data[\"mods_subject_authority_lcsh_topic\"]|split('|@|') %} \n    {% set subject_uris = data[\"mods_subject_authority_lcsh_valueuri\"] is defined ? data[\"mods_subject_authority_lcsh_valueuri\"] : '' %} \n    {% set subject_uris_list = subject_uris is iterable ? subject_uris : subject_uris|split('|@|') %}\n    \"subject_loc\": [\n        {% for subject in subjects %}\n        {\n            \"uri\": {{ subject_uris_list[loop.index0]|default('')|json_encode|raw }},\n            \"label\": {{ subject|json_encode|raw }}\n        }\n        {{ not loop.last ? ',' : '' }}\n        {% endfor %}\n    ],\n{%- endif -%}\n

    Use case #3: I have dc.creator and dc.contributor columns in my AMI Set Source Data CSV with simple JSON-encoded values (e.g. source column cells contain [\"Name 1, Name 2\"]) that I would like to map to the Archipelago default creator_lod JSON key.

    Twig Recipe Card for Use Case #3:

    {% if data['dc.creator']|length > 0 or data['dc.contributor']|length > 0 %}\n    {% set total_creators = (data[\"dc.creator\"]|length) + (data[\"dc.contributor\"]|length) %}\n    {% set current_creator = 0 %}                \n    \"creator_lod\": [\n        {% for creator in data[\"dc.creator\"] %}\n            {% set current_creator = current_creator + 1 %}\n            {% set creator_source = data[\"dc.creator\"][loop.index0] %}\n        {\n            \"name_uri\": null,\n            \"agent_type\": null,\n            \"name_label\": {{ creator|json_encode|raw }},\n            \"role_label\": \"Creator\",\n            \"role_uri\": \"http://id.loc.gov/vocabulary/relators/cre\"\n        }\n        {{ current_creator != total_creators ? ',' : '' }}\n        {% endfor %}\n        {% for creator in data[\"dc.contributor\"] %}\n            {% set current_creator = current_creator + 1 %}\n            {% set creator_source = data[\"dc.contributor\"][loop.index0] %}\n        {\n            \"name_uri\": null,\n            \"agent_type\": null,\n            \"name_label\": {{ creator|json_encode|raw }},\n            \"role_label\": \"Contributor\",\n            \"role_uri\": \"http://id.loc.gov/vocabulary/relators/ctb\"\n        }\n        {{ current_creator != total_creators ? ',' : '' }}\n        {% endfor %}   \n ],\n{% endif %}  \n
    Use Case #4: I have a mix of different columns containing Creator/Contributor/Other-Role-Types Name values with or without corresponding URI values that I would like to map to the default Archipelago creator_lod JSON key.

    Twig Recipe Card for Use Case #4:

    Click to view the full Recipe Card 
    {#- START Names from LoD and MODS CSV with/without URIS. -#} \n    {# Updated August 26th 2022, by Diego Pino. New checks/logic for mods_name_type_role_composed_or_more_namepart\n    - Check first IF for a given namepart there is already reconciliaton. \n    - IF not i check if there is a matching valueuri, \n    - If not leave the URL empty and use the value in the namepart (label) only?\n    - Only check/use mods_name_corporate/personal_namepart field IF there are no other fields\n    - That specify Roles. Since normally in ISLANDORA that field (no role) is a Catch all names one\n    - And in that case USE creator as the default ROLE\n    #}\n    {%~ set creator_lod = [] -%} \n    {# Used to keep track of parts after the type (corporate, etc) that are no roles\n     but authority properties. Add more if you find them #}\n    {%  set roles_that_are_no_roles = ['authority_naf','authority_marcrelator',''] %}\n    {# Used to keep track of the ones that are reconciled already #}\n    {%- set name_has_creator_lod = [] -%}\n    {%- for key,value in data_lod -%}\n      {%- if key starts with 'mods_name_' and key ends with '_namepart' -%}\n      {# If there is mods_name_SOMETHING_namepart in data_lod we keep track so we \n      do not try afterwards to use that Sources KEY from the CSV.\n      #}\n        {%- set name_has_creator_lod = name_has_creator_lod|merge([key]) -%}\n      {# Now we remove 'mods_name_' and '_namepart' #}\n        {%- set name_type_and_role = key|replace({'mods_name_':'', '_namepart':''}) -%}\n      {# We will only target personal or corporate. If any of those are missing we skip? #}\n        {% set name_type = null %}\n        {%- if name_type_and_role starts with 'personal_' -%}\n           {% set name_type = 'personal' %}\n        {%- elseif name_type_and_role starts with 'corporate_' -%}\n           {%- set name_type = 'corporate' -%}\n        {%- endif -%}\n        {%- if name_type is not empty -%}\n        {#- Now we remove 'type', e.g 'corporate_' -#}\n          {%- set name_role = name_type_and_role|replace({(name_type ~ '_'):''}) -%}\n          {# in case the name_role contains one of roles_that_are_no_roles, e.g\n          something like `creator_authority_marcrelator` we remove that #}\n          {% for role_that_is_no_role in roles_that_are_no_roles %}\n             {%- set name_role = name_role|replace({(role_that_is_no_role):''}) -%}\n          {% endfor %}\n          {# After removing all what can not be a role if we end with an empty #}\n          {% if name_role|trim|length == 0 %}\n             {%- set name_role = \"creator\" %}\n          {% else %}\n            {%- set name_role = name_role|replace({'\\\\/':'//' , '_':' '})|trim -%}\n          {% endif %}\n        {#- we iterate over all possible vocabularies and fetch the reconciliated names from them (if any) -#}\n          {%- for approach, names in value -%} \n        {#- if there are actually name pairs (name and uri) that were reconciliated we use them -#}\n            {%- if names|length > 0 -%}\n              {#- we call the ami_lod_reconcile twig extension with the role label using the LoC Relators endpoint in english and get 1 result -#}\n              {%- set role_uri = ami_lod_reconcile(name_role|lower|capitalize,'loc;relators;thing','en',1) -%}\n              {#- for each found name pair in a list of possible LoD reconciliated elements we generate the final structure that goes into \"creator_lod\" json key -#}\n              {%- for name in names -%} \n                {%- set creator_lod = creator_lod|merge([{'role_label': name_role|lower|capitalize, 'role_uri': role_uri[0].uri, \"agent_type\": name_type, \"name_label\": name.label, \"name_uri\": name.uri}]) -%}     \n             {%- endfor -%}\n            {%- endif -%}\n          {%- endfor -%}\n        {% endif -%}\n      {%- endif -%} \n    {%- endfor -%}\n    {# Now go for the RAW CSV data for names #}\n    {%- for key,value in data -%}\n    {# here we skip values previoulsy fetched from LoD and stored in name_has_creator_lod #}\n      {%- if key not in name_has_creator_lod and key starts with 'mods_name_' and key ends with '_namepart' -%}\n      {# If there is mods_name_SOMETHING_namepart in data_lod we keep track so we \n      do not try afterwards to use that Sources KEY from the CSV.\n      #}\n        {%- set name_has_creator_lod = name_has_creator_lod|merge([key]) -%}\n      {# Now we remove 'mods_name_' and '_namepart' #}\n        {%- set name_type_and_role = key|replace({'mods_name_':'', '_namepart':''}) -%}\n      {# We will only target personal or corporate. If any of those are missing we skip? #}\n        {%- set name_type = null -%}\n        {%- if name_type_and_role starts with 'personal_' -%}\n           {%- set name_type = 'personal' -%}\n        {%- elseif name_type_and_role starts with 'corporate_' -%}\n           {%- set name_type = 'corporate' -%}\n        {%- endif -%}\n        {% if name_type is not empty %}\n        {# Now we remove 'type', e.g 'corporate_' #}\n          {%- set name_role = name_type_and_role|replace({(name_type ~ '_'):''}) -%}\n          {# in case the name_role contains one of roles_that_are_no_roles, e.g\n          something like `creator_authority_marcrelator` we remove that #}\n          {% for role_that_is_no_role in roles_that_are_no_roles %}\n             {%- set name_role = name_role|replace({(role_that_is_no_role):''}) -%}\n          {% endfor %}\n          {# After removing all what can not be a role if we end with an empty #}\n          {% if name_role|trim|length == 0 %}\n             {%- set name_role = \"creator\" %}\n          {% else %}\n            {%- set name_role = name_role|replace({'\\\\/':'//' , '_':' '})|trim -%}\n          {% endif %}\n          {# Now we check if there is a corresponding _valueuri for this #}\n          {% set name_uris = [] %}\n          {%- if data[('mods_name_' ~ name_type_and_role ~ '_valueuri')] is not empty \n          and data[('mods_name_' ~ name_type_and_role ~ '_valueuri')] != '' -%}\n            {%- set name_uris = data[('mods_name_' ~ name_type_and_role ~ '_valueuri')]|split('|@|') -%}\n          {%- endif -%}\n          {%- set role_uri = ami_lod_reconcile(name_role|lower|capitalize,'loc;relators;thing','en',1) -%}\n        {#- we split and iterate over the value of the mods_name key -#}\n        {# NOTE. THIS IS TARGETING Anything after the year 1000, or 2000 #}\n          {%- for index,name in value|replace({'|@|1':', 1', '|@|2':', 2', '|@|-':', -'})|split('|@|') -%}\n            {%- if name is not empty and name|trim != '' -%}\n              {%- set name_uri = null -%}\n              {# Here we can check if one of the names IS not a name (e.g a year? #}\n              {#- we call the ami_lod_reconcile twig extension with the role label using the LoC Relators endpoint in english and get 1 result -#}\n              {%- if name_uris[index] is defined and name_uris[index] is not empty -%}\n                 {%- set name_uri = name_uris[index] -%}\n              {%- endif -%}\n              {%- set creator_lod = creator_lod|merge([{'role_label': name_role|lower|capitalize, 'role_uri': role_uri[0].uri, \"agent_type\": name_type, \"name_label\": name, \"name_uri\": name_uri}]) -%}\n            {%- endif -%}\n          {%- endfor -%}\n        {%- endif -%}\n      {%- endif -%}\n    {%- endfor ~%}\n    {# Use reduce filter + other logic for depulicating #}\n    {% set creator_lod = creator_lod|reduce((unique, item) => item in unique ? unique : unique|merge([item]), []) %}\n    \"creator_lod\": {{ creator_lod|json_encode|raw -}},\n    {#- END Names from LoD and MODS CSV with/without URIS. -#}\n

    Use Case #5: I have geographic location information that I would like to reconciliate against Nominatim and map into the default Archipelago 'geographic_location' key. I have AMI Source Data CSVs which contain values/labels and some which contain coordinates.

    Twig Recipe Card for Use Case #5 with variation notes:

    {#- <-- Geographic Info and terms:\n  Includes options for geographic info for:\n  - Nominatim lookup by value/label\n  - Nominatim lookup by coordinates \n  -#}\n    {#- use value for Nominatim search -#}\n    {% if data.mods_subject_geographic|length > 0 %}\n      {% set nominatim_from_label = ami_lod_reconcile(data.mods_subject_geographic,'nominatim;thing;search','en') -%}\n    \"geographic_location\": {{ nominatim_from_label|json_encode|raw }},\n    {% endif %}\n    {#- use coordinates for Nominatim search, if provided -#}\n    {% if data.mods_subject_cartographics_coordinates|length > 0 %}\n      {% set nominatim_from_coordinates = ami_lod_reconcile(data.mods_subject_cartographics_coordinates,'nominatim;thing;reverse','en') -%}\n    \"geographic_location\": {{ nominatim_from_coordinates|json_encode|raw }},\n    {% endif %}\n{#- Geographic Info and terms --> #}  \n

    Use Case #6: I have date values in a dc.date column that contain instances of 'circa' or 'Circa' where I would like to replace with the EDTF-friendly '~' instead and map to the Archipelago default 'date_created_edtf' JSON key.

    Twig Recipe Card for Use Case #6: 

        {% if data['dc.date'] is defined %}\n        {% set datecleaned = data['dc.date']|replace({\"circa \":\"~\", \"Circa \":\"~\"}) %}\n        \"date_created_edtf\": {\n        \"date_to\": \"\",\n        \"date_free\": {{ datecleaned|json_encode|raw }},\n        \"date_from\": \"\",\n        \"date_type\": \"date_free\"\n        },        \n    {% endif %}\n

    More recipe cards will be added over time. Please see our Archipelago Contribution Guide to learn about contributing your own recipe card or other documentation.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Twig","Twig Filters","Twig Functions","Twig Templates","Examples","JSON"]},{"location":"utility_scripts/","title":"Utility Scripts","text":"

    If you've already followed deployment guides for archipelago-deployment and archipelago-deployment-live, you may have used some shell scripts that archipelago provides. The scripts are available in the scripts/archipelago/ and drupal/scripts/archipelago/ folders respectively.

    ","tags":["Bash","Scripts","DevOps"]},{"location":"utility_scripts/#importexport-metadata-display-twig-templates","title":"Import/Export Metadata Display Twig Templates","text":"

    Metadata Display Entity Twig Templates can be exported out of and imported into both local and remote deployments with the following script: import_export.sh. The script can be run interactively or non-interactively.

    Docker host vs. Docker container

    Because the script uses the Docker .env file for the JSONAPI user and URL by default, we recommend running this directly on the host.

    ","tags":["Bash","Scripts","DevOps"]},{"location":"utility_scripts/#interactive-mode","title":"Interactive Mode","text":"

    Running the script interactively will guide you through a number of prompts to configure and import or export to an existing folder or to one which will be created.

    ./import_export.sh -n\n
    ","tags":["Bash","Scripts","DevOps"]},{"location":"utility_scripts/#non-interactive-mode","title":"Non-interactive Mode","text":"

    To run the command non-interactively provide the required and optional parameters with the necessary arguments as needed.

    Options for Non-interactive Mode

    -i or -e (required)

    \u00a0\u00a0\u00a0\u00a0Import or export, respectively, Metadata Entity Display Twig Templates from a local folder.

    -s path (required)

    \u00a0\u00a0\u00a0\u00a0The absolute path of the local folder to export to or import from.

    -j path/filename (only required if the .env file containing the JSONAPI user and password is in a non-standard location)

    \u00a0\u00a0\u00a0\u00a0The absolute path to the .env file containing the JSONAPI user and password.

    -d url (required if URL is not in .env file or importing to or exporting from a remote deployment)

    \u00a0\u00a0\u00a0\u00a0The URL of the archipelago deployment.

    -k (optional)

    \u00a0\u00a0\u00a0\u00a0Keep any existing files ending with .json in the specified folder (the default is to delete) before exporting.

    JSONAPI User

    The JSONAPI user credentials, by default, will be read from the .env files in the following locations (relative to the root of the deployment):

    Deployment File Location archipelago-deployment-live ./deploy/ec2-user/.env archipelago-deployment ./.env

    A separate file can also be passed as an argument using the -j option.

    .env
    JSONAPI_USER=jsonapi\nJSONAPI_PASSWORD=jsonapi\n

    Exporting from local archipelago-deployment-live

    ./import_export.sh -e -s /home/ec2-user/metadatadisplay_export\n
    After logging into the archipelago-deployment-live host, the above command will delete any files with the .json extension if the destination folder exists. Otherwise, the folder will be created. The JSON user credentials and domain from the .env file will then be used to download the files so please make sure these are set.

    Exporting from local archipelago-deployment

    ./import_export.sh -e -s /home/user/metadatadisplay_export -d http://localhost:8001\n
    This will work the same way as the above example, but the URL is passed as an argument in this case since the .env file will not contain (in most cases) the domain. As above, the JSON user credentials will have to be set in the .env file.

    Exporting from remote archipelago-deployment-live

    ./import_export.sh -e -s /home/user/metadatadisplay_export -d https://archipelago.nyc\n
    This is essentially the same as the example directly above, except that in this case the JSON user credentials in the .env file will have to be set to the ones used to access the remote instance.

    Importing locally into archipelago-deployment-live

    ./import_export.sh -i -s /home/user/metadatadisplay_import\n
    This is essentially the same as the first example above, except that the import option (-i) is used. The folder name is changed for the sake of example, but you can use the same folder that was used for exporting.

    Importing locally into archipelago-deployment

    ./import_export.sh -i -s /home/user/metadatadisplay_import -d http://localhost:8001\n
    As in the example directly above, this corresponds to the example for exporting with a local archipelago-deployment instance, except that the import option (-i) is used.

    Importing from local instance into remote archipelago-deployment-live

    ./import_export.sh -i -s /home/user/metadatadisplay_import -d https://archipelago.nyc\n
    In this example, the locally exported files are being imported into a remote instance. As in the above examples with remote instances, the JSON user credentials need to be set in the .env file to those with access to the remote instance.

    ","tags":["Bash","Scripts","DevOps"]},{"location":"utility_scripts/#automatic-deployment-script","title":"Automatic Deployment Script","text":"

    If you're frequently deploying locally with archipelago-deployment, you may want to use the automated deployment script available at scripts/archipelago/devops/auto_deploy.sh. The script is interactive and can be called from the root of the deployment, e.g. /home/user/archipelago-deployment/:

    Automatic Deployment

    scripts/archipelago/devops/auto_deploy.sh

    Follow the prompts and select your options to complete the deployment.

    ","tags":["Bash","Scripts","DevOps"]},{"location":"webformLoDfromCSV/","title":"Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest'","text":"

    Archipelago's custom webform element 'Webform LoD from CSV attached to an ADO suggest' provides a form element autocomplete labels/urls(values) from a CSV attached to a Digital Object. Using this element affords a way for you to utilize a custom local vocabulary, a subset of labels and URIs from a wider LoD authority source, or an LoD vocabulary that does not have an accessible API or public query service.

    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"webformLoDfromCSV/#step-by-step","title":"Step-by-step","text":"

    1. To use this element, you need to first have prepared a CSV file containing two columns only:

      • one column for 'label' containing the labels for your vocabulary
      • one column for 'uris' containing the corresponding uris for your vocabulary

    2. Create a new Digital Object, and attached the prepared CSV file to the new Digital Object.

      • Be sure to provide a unique label to help you identify this Object in future steps.
      • It is recommended that you do not Publish this Object.

    Note

    If you are not yet familiar with how to create a Digtial Object, please refer to this guide.

    1. Go to Admin > Structure > Webforms and select the 'Build' button beside the Default Descriptive Metadata Webform.

    2. Scroll down to the 'Subjects and Other Classifications' page of the Webform and select 'Add Element'.

    1. In the 'Select an element to add ..' popup that opens, either scroll down to select the 'Composite Element' section or search for the 'Webform LoD from CSV attached to an ADO suggest.' Select 'Add Element'.

    1. In the Edit tab that opens for your newly added element, you will need to review the following sections.

    2. Element Settings

      • provide a Title for element
      • check that the Key generated from the Title you supply is well formed and make changes if needed
      • specify the 'Allowed number of values'

    • Webform LoD from CSV attached to an ADO suggest settings:

      • It is recommended to keept both 'label' and 'uri' checked as Visible.
      • You may also wish to mark both elements as 'Required'

    • Autocomplete settings

      • In the 'Choose an ADO' box, begin typing to search for the Digital Object that holds a CSV containing the Vocabulary you want to autocomplete.
      • Under 'The CSV column(header name) that will be used for autocompleting', enter 'label'
      • Under 'The CSV column(header name) that will be used for the URL value', enter 'uri'
      • 'Autocomplete limit'
        • determines the maximum number of matches to be displayed
        • recommended that you set to '10'.
      • 'Autocomplete minimum number of characters'
        • determines the minimum number of characters a user must type before a search is performed
        • recommended that you set to '3'.
      • 'Autocomplete matching operator'
        • determines the method used to collect autocomplete suggestions
        • recommended to use 'Starts with'

    • Navigate to the 'Advanced' tab for this Webform element.

      • Open the 'Multiple settings' section
      • dDeselect the options to 'Allow users to sort elements' and 'Allow users to add more items'

    1. Save your new form element settings. Then Save your updated Webform.

    2. Navigate to a Digital Object in your repository that you would like to use this new custom vocabulary element with. Select 'Edit' for that Digital Object and navigate to the 'Subjects and Other Classifications' page of the webform. Begin typing a label found in your prepared CSV associated with the webform element.

    You can now begin using this custom vocab vocabulary element when using the corresponding webform (where you added this element) to Edit and Update your Digital Objects. You may also wish to add this same element to the Default Digital Object Collection/Creative Work Series webform.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"webforms/","title":"Webforms in Archipelago","text":"

    The Webform Strawberryfield module provides Drupal Webform ( == awesome piece of code) integrations for StrawberryField so you can really have control over your Metadata ingests. These custom elements provide Drupal Webform integrations for Archipelago\u2019s StrawberryField so you can have fine grained and detailed control over your Metadata ingests and edits.

    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"webforms/#where-to-find","title":"Where to Find","text":"

    You can access Webforms in Archipelago at: - Admin > Structure > Webforms - /admin/structure/webform/

    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"webforms/#instructions-and-guides","title":"Instructions and Guides","text":"
    • How to Create a Webform as an Input Method for Archipelago Digital Objects (ADO)
    • Customizing Webforms: Modifying allowable file extensions
    • Archipelago Custom Webform Elements
    • Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest'
    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"webforms/#archipelago-default-example-webforms","title":"Archipelago Default Example Webforms","text":"

    Use these webforms or their elements to create a custom webform for your own repository/project needs:

    • Archipelago Default Deployment Webforms

      • Descriptive Metadata

        • Corresponding Schema.org Type Options

      • Digital Object Collection

        • Corresponding Schema.org Type Options

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Webform","Form Mode","Webform Elements"]},{"location":"webformsasinput/","title":"How to Create a Webform as an Input Method for Archipelago Digital Objects (ADO) / Primer on Display Modes","text":"

    Drupal 8/9 provides a lot of out-of-the-box functionality to setup the way Content Entities (Nodes or in our case ADOs) are exposed to users with the proper credentials. That functionality lives under the \"Display Modes\" and can be accessed at yoursite/admin/structure/display-modes.

    In a few quick words, The Display Mode Concept covers: formatting your Content Entities and their associated Fields so when a user lands on a Content Page, they are displayed in a certain, hopefully pleasing, way and also how users with proper Credentials can fill inputs/edit values for each field a Content Entity provides.

    First, formatting output (basically building the front facing page for each content entity) is done by a View Mode. Second, defining how/what input method you are going to use to create or edit Content entities, is handled by a Form Mode. Both Modes, are, in Drupal Lingo, Configuration Entities, they provide things you can configure, you can name them and reuse them and those configurations can all be exported and reimported using YAML files. Also both Modes the following in common:

    • Drupal always provides a \"default\" one that can not be deleted.
    • You can create new ones.
    • You can apply permissions to them.
    • All Modes work on \"fields\", means the tiny little input/output pieces that are either part of a Content Entity or attached to them (the title, the Body, and in our case a Strawberryfield (SBF),
    • They Provide Config/setting options for each Field.
    • They are always associated to Content Types/Bundles. Means all Nodes of the same Content type will share the same modes.

    The main difference, other than their purpose (Output v/s Input) is that, on View Modes, the settings you apply to each field are associated to \"Formatters\" and on Form Modes, the settings you apply to each field are connected to \"Widgets\".

    So, resuming, this is what lives under the Concept of a \"Display Mode\":

    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#view-mode","title":"View Mode","text":"
    • Each field attached to a Content Entity can have a Formatter applied and most of them have configuration options.
    • Formatters do one thing right: they take the raw, stored value and make it \"visible\" inside Drupal.
    • Which formatters are available will depend on the \"type\" of field the Content Entity has.
      • E.g A Node title/Label will have a Title formatter with the option of just displaying a text or a text with a link to the entity.
      • More Complex and fun Fields, like the ones of type SBF will provide a large list of possible Formatters, like IIIF driven viewers, Video formatters, Metadata Display (Twig template driven) ones, etc. This is because a SBF type of field has much more than just a text value, it contains a full graph of metadata and properties, inclusive links to Files and provenance metadata.
    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#form-mode","title":"Form Mode","text":"
    • Each field attached to a Content Entity can have a Widget applied and most of them have configuration options.
    • Widgets do one thing right: they expose some type of Form/UI interaction that allows a user to input data into the Entity, under that specific field. And of course they make sure that what you input is validated and saved (if good) correctly.

    • Which Widgets are available will depend on the \"type\" of field the Content Entity has.

      • Example: A Node Title will have a single Text Input with some options, like the size of the Textfield used to feed it.
      • More Complex and fun fields, like the ones of type SBF (strawberryfield), will provide a larger list of possible Widgets, ranging from raw JSON input (which you could select if your data was already in the right format) to the reason we are reading this: Webform driven Widgets. These Widgets include:
        • ones the webform_strawberryfield Drupal module provides
        • ones that use an existing Webform (which are also Entitites!) which either 1) you created or 2) we provided as a setting

      If you chose a widget other than the raw JSON, the widget will take the raw JSON to build, massage and enrich the data so that it can be presented in a visual format by the SBF. This is because a SBF type of field has much more than just a text value. It contains a full graph of metadata and properties, inclusive links to Files and provenance metadata, which for example allows us to use an Upload field directly in the attached/configured webform. - Form modes also have an additional benefit. Each one can have fine grained permissions. That way you can have many different Form Modes, but allow only certain ones to be visible, or usable by users of a given Drupal Role.

    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#i-think-i-get-thisbut-how-can-i-use-this-knowledge-now","title":"I think i get this...but how can i use this knowledge now?","text":"

    Good question! So, to enable, configure, and customize these Display Modes you have to navigate to your Content Type Configuration page in your running Archipelago. This is found at /admin/structure/types. Note: the way things are named in Drupal can be confusing to even the most deeply committed Drupal user, so bear in mind some terms will change. Feel free to read and re-read.

    You can see that for every existent Content Type, there is a drop down menu with options:

    • Manage Display: will lead you to configuration page where you can setup each View Mode and its settings for a given Content Type
    • Manage Form Display: will lead you to configuration page where you can setup each View Mode and its settings for a given Content Type
    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#manage-display","title":"Manage Display","text":"

    On the top you will see all your View Modes Listed, with the Default one selected and expanded. The Table that follows has one row per Field attached/part of this Content Type. Some of the fields are part of the Content Type itself, in this case Digital Object (bundled) and some other ones are common to every Content Entity derived from a Node. The \"Field\" column contains each field name (not their type, reason why you don't see Strawberry Field there!) but we can tell you right now that there is one, named \"Descriptive Metadata\", that is of SBF type.

    Wait! Which are the fields in my Content Type?

    How do we know that the field named \"Descriptive Metadata\" is a Strawberryfield? Well, we set-up the Digital Object Content Type for you that way, but also you can know what we know by pressing on \"Manage fields\" Tab on the top (don't forget to come back to \"Manage display\", afterwards!)

    Also Surprise: You Content Entity has really really just 2 fields! And that, friends, is one of the secret ingredients of Archipelago. All goes into a Single Field. But wait: i see more fields in my Manage Display table. Why? Well. Some of them are base fields, part of what a Drupal Node is: base field means you can not remove them, they are part of the Definition itself. One obvious one is the Title.

    But there are also some fields very particular to Archipelago: You can see there are also ones named \"Formatter Object Metadata\", \"Media\" and one named \"Static Media\"!. Where does come from? Those are also Strawberryfields. It sounds confusing but it is really simple. They are really not \"fields\" in the sense of having different data than \"Descriptive Metadata\". Those are In Memory, realtime, copies of the \"Descriptive Metadata\" SBF field and are there to overcome one limitation of Drupal 8:

    Each Field can have a single \"Formatter\" setup per field.

    But we want to re-usue the JSON data to show a Viewer, Show Metadata as HTML directly on the ADO/NODE landing page, and we want also to, for example, format sometimes images as Thumbnails and not using a IIIF viewer only. This CopyFields (Legal term) have also a nice Performance advantage. Drupal needs to fetch only once the data from the real Field, \"Descriptive Metadata\", from the database. And then just makes the data available in real time to its copies. That makes all fast, very very fast! And of course flexible. As you dig more into Archipelago you will see the benefits of this approach. Finally, if you need to, you can make more CopyFields. But the reality is, there is a single, only one, SBF in each Digital Object and its named \"Descriptive Metadata\".

    You can also simply not care about the type and trust the UI. It will just show Formatters that are right for each type and expose Configuration options (and a little abstract of the current ones) under the Widget Column. Operations Columns allows you to setup each Widget. Widget term here is a bit confusing. These are not really Widget in terms of Data Input, but in terms of \"Configuration\" Input. But D8/9 is evolving and its getting better. Those settings apply always only to the current View Mode.

    You can play with this, experiment and change some settings to get more comfortable. We humbly propose you that you complete this info with the official Drupal 8 Documentation and also apply custom settings to your own, custom View Mode so you don't end changing base, expected functionality while you are still learning.

    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#manage-form-display","title":"Manage Form Display","text":"

    On the top you will see all your Form Modes Listed, with the Default one selected and expanded. The Table that follows has one row per Field attached/partof this Content Type. The list of fields here is shorter, the SBF CopyFields are not present because all data goes really only into real fields. Also some other, display only ones (means you can not modify them) will not appear here. Again, Some of the fields are part of the Content Type itself, in this case Digital Object (bundled) and some other ones are common to every Content Entity derived from a Node. \"Field\" column contains each field name and the Widget Column allows you to select what type of Input you are going to use to feed it on Ingest/edit. On the right you will see again a little gear, that allows you to configure the settings for a particular Widget. Those settings apply always only to the current Form Mode.

    So. The one we want to understand is the one attached to the \"Descriptive Metadata\" field. Currently one named \"Strawberryfield webform based input with inline rendering\". There are other two. But let's start with this. Press on the Gear to the right on the same row.

    AS you can see there are not too many options. But, the main, first Text input is an Autocomplete field that will resolve against your existing Webforms. So, guess what. If you want to use your own Webform to feed a SBF, what do you do? You type the name, let the autocomplete work, select the right Webform, maybe your own custom one, and the you press \"Update\". Once that is done you need to \"Save\" your Form Mode (hint, button at the bottom of the page).

    We wish life was that easy (and it will once we are done with refining Drupal's UI) but for now there are some extra things you need to do to make sure the Webform, your custom one, can speak JSON. The default one you get named also \"Descriptive Metadata (descriptive_metadata)\", same as the field, is already setup to be used. Means if you create a new Webform by Copying that one, you can start using it inmediately. But if you created one from scratch (Different tutorial) you need to setup some settings.

    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#setting-up-a-webform-to-talk-strawberryfield","title":"Setting up a Webform to talk Strawberryfield","text":"

    Navigate to your Webform Managment form at /admin/structure/webform

    If you already created a Webform (different tutorial on how to do that) you will see your own named one in that list. I created for the purpose of this documentation one named \"Diego Test\" (Hi, i'm Diego..) and on the most right Column, \"Operations\" you will haven an Drop Down Menu. On your own Webform row, press on \"Settings\".

    First time, this can be a little bit intimitading. We recommend going baby steps since the Webform Module is a very powerful one but also exposes you to a lot (and sometimes too many) options. Even more, if you are new to Webforms, we recomment you to copy the \"Descriptive Metadata\" Webform we provided first, and make small changes to it (starting by naming it your own way!) so you can see how that affects your workflow and experience, and how that interacts with the created metadata. The Webform Module provides testing and building capabilities, so you have a Playground there before actually ingesting ADOs. Copying it will also make all the needed settings for SBF interaction to be moved over, so your work will be much easier.

    But we know you did not do that (where is the fun there right?). So lets setup one from scratch.

    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#general-settings","title":"General Settings","text":"

    Gist here is (look at the screenshot and copy the settings):

    • GENERAL Settings: Check \"Disable saving of submissions\" option. You won't need this form to generate a Native Webform Submission entry.
    • AJAX Settings: Check \"use ajax\" option. We want people to have the experience of staying in a single page while the create a new ADO via a Multi Step Webform Workflow.
    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#confirmation-settings","title":"Confirmation Settings","text":"

    Gist here is (again, look at the screenshot and copy the settings):

    • Select \"Inline Confirmation\". You don't want Webform to send your user to another page while they are still ingesting their ADOs.
    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"webformsasinput/#handler","title":"Handler","text":"

    The glue, the piece of resistance. The handler is the one that knows how to talk to a SBF. In simple words, the handler (any handler) provides functionality that does something with a Webform Submission. The one that you want to select here, is the \"Strawberryfield harvester\" handler. Add it, name it whatever you like (or copy what you see in the screenshot) and make sure you select, if running using our deployment strategy, \"S3 File System\" as the option for \"Permanent Destination for uploaded files\". The wording is tricky there, its not really Permanent, since that is handled by Archipelago, but more to Temporary, while working in ingesting an Object, destination for the Webform. Its not really wrong neither. Its permanent for the Webform, but we have better plans for the files and metadata!

    Save your settings. And you are ready to roll. That webform can now be used as a Setting for any of the StrawberryField Widgets that use Webforms.

    Finally (the real finally). Archipelago encourages at least one Field/JSON key to be present always. One with \"type\" as key value. So make sure that your Custom Webform has that one.

    There are two ways of doing that:

    • You can copy how it is setup from the provided Webform's Elements, from the main Descriptive Metadata Webform and then add one \"select\" element to yours using the same \"type\" \"key\".Important in Archipelago is always the key value since that is what builds the JSON for your metadata. The Description can be any, but for UI consistency you could want to keep it the same across all your webforms.

    • Or, advanced, you can use the import/export capabilities (Webforms are just YAML files!) and export/copy your custom one as text, add the following element before or after some existing elements there

       type:\n      '#type': select\n      '#title': 'Media Type'\n      '#options': schema_org_creative_works\n      '#required': true\n      '#label_attributes':\n        class:\n          - custom-form-input-heading\n

      And then reimport.

      Having a \"type\" value will make your life easier. You don't need it, but everything works smoother that way.

      Since you have a single Content Type named Digital Object, having a Webform field that has as key \"type\", which leads to a \"type\" JSON key, allows you to discern the Nature of your Digital Object, book or Podcast, Image or 3D and do smart, nice things with them.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Webform","Form Mode","View Mode","Display Mode","Manage Display","Manage Form Display","Handler"]},{"location":"workingtwigs/","title":"Working with Twig in Archipelago","text":"

    The following information can also be found in this Presentation from the \"Twig Templates and Archipelago\" Spring 2021 Workshop:

    • Twig Templates and Archipelago
    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#prerequisites-with-food-analogy","title":"Prerequisites (with food analogy)","text":"
    1. Know your Data/Metadata. What do I have?
      • What do I have in my Fridge? Do I have Tofu? Do I have Peppermint ? One Bunch?
    2. Know your final desired output Document: MODS, HTML, GEOJSON, etc.
      • What are you going to cook ? Do you have a picture of the Curry ? Have you ever had Curry ?
    3. Know your Twig Basics
      • How to cut and dice , steam and saut\u00e9
    4. Do not be afraid
      • You can\u2019t get burned here and Ingredients do not expire!
    5. Ask for help. Slack/Google Groups/Postcards
      • Seeing others cook helps and also motivates. Others may share some spices.
    6. Use and Share your findings!
      • Eat what you cook. Share with friends and family.

    Note

    All examples shown below are using the following JSON snipped from Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?].

    Click to view image of the JSON snippet.

    Click to view this snippet as JSON. 
    {\n    \"type\": \"Photograph\",\n    \"label\": \"Laddie the dog running in the garden, Bronx, N.Y., undated [c. 1910-1918?]\",\n    \"owner\": \"New-York Historical Society, 170 Central Park West, New York, NY 10024, 212-873-3400.\",\n    \"rights\": \"This digital image may be used for educational or scholarly purposes without restriction. Commercial and other uses of the item are prohibited without prior written permission from the New-York Historical Society. For more information, please visit the New-York Historical Society's Rights and Reproductions Department web page at http:\\/\\/www.nyhistory.org\\/about\\/rights-reproductions\",\n    \"language\": [\n        \"English\"\n    ],\n    \"documents\": [],\n    \"publisher\": \"\",\n    \"ismemberof\": \"111\",\n    \"creator_lod\": [\n        {\n            \"name_uri\": \"\",\n            \"role_uri\": \"http:\\/\\/id.loc.gov\\/vocabulary\\/relators\\/pht\",\n            \"agent_type\": \"personal\",\n            \"name_label\": \"Stonebridge, George Ehler\",\n            \"role_label\": \"Photographer\"\n        }\n    ],\n    \"description\": \"George Ehler Stonebridge (d. 1941) was an amateur photographer who lived and worked in the Bronx, New York.\",\n    \"subject_loc\": [\n        {\n            \"uri\": \"http:\\/\\/id.loc.gov\\/authorities\\/subjects\\/sh85038796\",\n            \"label\": \"Dogs\"\n        }\n    ],\n    \"date_created\": \"1910-01-01\"\n}\n
    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#first-know-your-data","title":"First: Know Your Data","text":"

    Understanding the basic structure of your JSON data.

    1. Single JSON Value.

      • For \"type\": \"Photograph\"
        • \"type\" = JSON Key or Property
        • \"Photograph\" = Single JSON Value (string)

    2. Multiple JSON Values (Array of Enumeration of Strings)

      - For \"language\": [\"English\",\"Spanish\"] - \"language\" = JSON Key or Property - \"[\"English\",\"Spanish\"]\" = Multiple JSON Values (Array of Enumeration of Strings)

    3. Multiple JSON Values (Array of Enumeration of Objects)

      • For \"subject_loc\":[{\"uri\":\"http://..\",\"label\":\"Dogs\"},{\"uri\":\"http://..\",\"label\":\"Pets\"}]
        • \"subject_loc\" = JSON Key or Property
        • [{\"uri\":\"http://..\",\"label\":\"Dogs\"},{\"uri\":\"http://..\",\"label\":\"Pets\"}] =
          • Object with two JSON Keys. Each one with a single Value
          • Multiple JSON Values (Array of Enumeration of Objects)
    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#getting-started-with-the-twig-language-in-archipelago","title":"Getting Started with the Twig Language in Archipelago","text":"

    • Data is known as Context in Twig Lingo.

    • All your JSON Strawberryfield Metadata is accessible inside a Variable named data in your twig template.

    • You can access the values by using data DOT Property (attribute) Name.

      • In the Laddie the Dog example shown above (originally):
        • data.type will contain \"Photograph\"
        • data.language will contain [ \"English\" ]
        • data.language[0] will contain \"English\"
          • 0 means first entry in an Array or Enumeration
        • data.subject_loc will contain [{ \"uri\":\"http://..\",\"label\": \"Dog\" }]
        • data.subject_loc.uri will contain \"http://..\"
        • data.subject_loc.label will contain \"Dog\"

    Note

    You also have access to other info in your context node: such asnode.id is the Drupal ID of your Current ADO; Also is_front, language, is_admin, logged_in; and more!

    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#twig-statements-and-printing","title":"Twig Statements and Printing","text":"

    Twig for Template Designers

    https://twig.symfony.com/doc/3.x/templates.html

    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#simple-examples-using-printing-statements","title":"Simple examples using Printing Statements","text":"

    Single JSON Value Example

    Twig template
    Hello I am a {{ data.type }} and very happy to meet you\n
    Rendered output
    Hello I am a Photograph and very happy to meet you\n

    Multiple JSON Values Example

    Twig template
    Hello I was classified as \"{{ data.subject_loc[0].label }}\" and very happy to meet you\n
    Rendered output
    Hello I was classified as \"Dogs\" and very happy to meet you\n
    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#twig-statements-and-executing","title":"Twig Statements and Executing","text":"

    If in Twig

    https://twig.symfony.com/doc/3.x/tags/if.html

    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#rendered-output-based-upon-different-twig-conditionals-operators-tests-assignments-and-filters","title":"Rendered Output based upon different Twig conditionals, operators, tests, assignments, and filters","text":"

    Conditionals, Operator, and Test Usage

    Twig Template
    {% if data.subject_loc is defined %}\nHey I have a Subject Key\n{% else %}\nUps no Subject Key\n{% endif %}\n
    Rendered Output
    Hello I was classified as \"Dogs\" and very happy to meet you\n
    • if/else are conditionals
    • is is an operator
    • defined is a test

    Loop Usage

    Twig Template
    {% for key, subject in data.subject_loc %}\n* Subject {{ subject.label }} found at position {{ key }}\n{% endfor %}\n
    Rendered Output
    * Subject Dogs found at position 0\n
    • for is a loop
    • Inside the loop you have access to key, subject

    Assignment, Filter, and Loop Usage

    Twig Template
    {% for subject in data.subject_loc %}\n{% set label_lowercase = subject.label|lower %}\nMy lower case Subject is {{ label_lowercase }}\n{% endfor %}\n
    Rendered Output
    `My lower case Subject is dogs`\n
    • set is an assignment
    • | is a pipe, used after a value to apply a filter.
    • lower is a filter
    • Inside the loop you have have access to subject and label_lowercase

    Loop Scope

    Twig Template
    {% for subject in data.subject_loc %}\n  {% set label_lowercase = subject.label|lower %}\nMy lower case Subject is {{ label_lowercase }}\n{% endfor %}\n{# \n The below won\u2019t display because it was assigned inside \n The For Loop\n#}\n{{ label_lowercase }}\n
    Rendered Output
    `My lower case Subject is dogs`\n
    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#full-examples-for-common-uses-cases","title":"Full Examples for Common Uses Cases:","text":"

    Use Case #1

    I have multiple LoD Subjects and want to display them in my page as a clickable ordered list but I\u2019m a safe/careful person.

    Twig Example for Use Case #1
    {% if data.subject_loc is iterable and data.subject_loc is not empty %}\n<h2>My Subjects</h2>\n<ul>\n   {% for subject in data.subject_loc %}\n   <li>\n      <a href=\"{{ subject.uri }}\" title=\"{{ subject.label|capitalize }}\" target=\"_blank\">\n      {{ subject.label }}\n      </a>\n   </li> \n   {% endfor %}\n</ul>\n{% endif %}\n

    Use Case #2

    I have sometimes a publication date. I want to show it in beautiful human readable language.

    Twig Example for Use Case #2
    {% if data.date_published is not empty %}\n<h2>Date {{ data.label }} was published:</h2>\n<p>\n{{ data.date_published|date(\"F jS \\\\o\\\\f Y \\\\a\\\\t g:ia\") }}\n</p>\n{% endif %}\n

    About date

    • date() is a function
    • It uses a \u201cDate Format Pattern\u201d as argument.

    Use Case #3 (Full Curry)

    {# May 4th 2021 @dpino: I have sometimes a user provided creation date. I want to show it in beautiful human readable language but fallback to automatic date if absent. I also want in the last case to show it was either \u201ccreated\u201d or \u201cupdated\u201d. #}

        \"as:generator\": {\n        \"type\": \"Update\",\n        \"actor\": {\n            \"url\": \"https:\\/\\/archipelago.nyc\\/form\\/descriptive-metadata\",\n            \"name\": \"descriptive_metadata\",\n            \"type\": \"Service\"\n        },\n        \"endTime\": \"2021-03-17T13:24:01-04:00\",\n        \"summary\": \"Generator\",\n        \"@context\": \"https:\\/\\/www.w3.org\\/ns\\/activitystreams\"\n    }\n
    Twig Example for Use Case #3
    {% if data.date_created is not empty %}\n<h2>Date {{ data.label }} was created:</h2>\n<p>\n  {{ data.date_created|date(\"F jS \\\\o\\\\f Y \\\\a\\\\t g:ia\") }}\n</p>\n{% else %}\n<h2>Date {{ data.label }} was {{ attribute(data, 'as:generator').type|lower }}d  in this repository:</h2>\n<p>\n  {{  attribute(data, 'as:generator').endTime|date(\"F jS \\\\o\\\\f Y \\\\a\\\\t g:ia\") }}\n</p>\n{% endif %}\n
    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#a-recommended-workflow","title":"A Recommended Workflow","text":"

    You want to create a New Metadata Display (HTML) or a new (XML) Schema based format?

    1. Get yourself an example document (Frame). If HTML copy the source. If XML copy the full XML. (Cmd+C or Ctrl+C)
    2. Create a new Metadata Display Entity. Copy the content (text) of your Frame into the Edit window. (Cmd+V or Ctrl+V)
    3. Select an existing (as complete as possible) ADO to use as preview, press Preview.
    4. Put your nice glasses on. What do you see? What data in your Frame do you have in your ADO (data)?
    5. Start nimble. Select the data.label info and check where your Frame uses a Title or a Label. Remove that text (Cmd+X or Ctrl+X) and replace with a {{ data.label }}. Press Preview. Do you see your title?
    6. Keep doing 5, over and over. Leave complex values for the end. (e.g data.subject_loc)
    7. Document your changes. {# I added this because .. #}
    8. Save.

    Once the Template is in place you can use it in a Formatter, as Endpoint, in your Search Results or just keep it around until you and the world are ready!

    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"workingtwigs/#and-now-its-your-turn","title":"And now it's your turn!","text":"

    We hope you found the information presented here to be helpful in getting started working with Twigs in Archipelago. Click here to return to the main Twigs in Archipelago documentation. Happy Twigging!

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    ","tags":["Twig","Twig Templates","Twig Filters","Twig Functions","Examples","JSON"]},{"location":"xdebug/","title":"Debugging PHP in Archipelago","text":"

    This document describes how to enable Xdebug for local PHP development using the PHPStorm IDE and a docker container running the Archipelago esmero-php:development image. It involves interacting with the esmero/archipelago-docker-images repo and the esmero/archipelago-deployment repo.

    "},{"location":"xdebug/#part-1-docker","title":"Part 1: Docker","text":"

    1. Run the following commands from your /archipelago-deployment directory:

      docker-compose down \\ docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -d

      This version of docker-compose up uses an override file to modify our services. docker-compose.dev.yml we now have an extra PHP container called esmero-php-debug.

      To stop the containers in the future, run docker-compose -f docker-compose.yml -f docker-compose.dev.yml down.

      (To make these commands easier to remember, consider making bash aliases in your .bashrc file.) (If you are running your development on a Linux system, you may need to make a modification to your xdebug configuration file on the esmero-php-dev container. See appendix at the bottom of this page.)

      So we have reloaded the containers and now you are ready for Part 2.

    "},{"location":"xdebug/#part-2-phpstorm","title":"Part 2: PHPStorm","text":"

    1. In PHPStorm, open your archipelago-deployment project.

    2. Go to Preferences > Languages & Frameworks > PHP > Debug or Settings > PHP > Servers. In this window there is an Xdebug section. Use these settings:

      • Debug port: 9003. (do NOT use the default, 9000)
      • Can accept external connections: yes, select checkbox
      • (optional) Break at first line in PHP scripts: uncheck. If you leave this selected, you will have to manually step through a breakpoint from Drupal's main index.php file on every request, which is quite annoying. However, leaving this box checked can be useful for making sure the connection is working at first, before you have set any internal breakpoints.

      Your settings should look like this. Hit APPLY and OK.

    3. Go to Preferences > Languages & Frameworks > PHP > Servers. We will create a new server here. Use these settings:

      • Name: docker-debug-server
      • Host: localhost
      • Port: 8001
      • Use path mappings: yes, select the checkbox
      • Under project files, select the top-level archipelago-deployment directory in the File/Directory column.
      • In the Absolute path on the server add /var/www/html

      Hit APPLY and OK and close the window.

    4. Go to Run > Edit Configurations. Hit the + Button to create a new PHP Remote Debug. Name whatever you want, I called mine Archipelago. Use these settings:

      • Filter debug connection by IDE Key: yes, select the checkbox
      • Server: select docker-debug-server from dropdown (we created this in step 3)
      • IDE Key: archipelago (this matches the key set in our container)

    5. Note: If you try to validate your connection, it will fail. But that's ok.

    6. Validate your connection. With Run > Edit Configurations still open, you can hit the link that says \"Validate\". Use these settings in the following validation window:

      • Path to create validation script <your local path>/archipelago-deployment/web
      • Url to validation script: http://localhost:8001

      Hit VALIDATE. You should get a series of green check marks. If you get a warning about missing php.ini file, that is OK, our file has a different name in the container (xdebug.ini) and is still being read correctly.

    "},{"location":"xdebug/#set-up-browser-integration","title":"Set up Browser Integration","text":"

    1. We have had success using the XDebug Helper extension in Chrome. Once you have the extension installed, right-click on the bug icon in the top right of your chrome browser window and select \"Options\" to configure the IDE key. Under \"IDE\", select \"Other\", and in the text box, enter \"archipelago\"

    "},{"location":"xdebug/#actually-debugging","title":"Actually Debugging!","text":"

    1. Hit the button (top right bar of PHPStorm) that looks like a telephone, for Start Listening for PHP Debug Connections.

    2. Now, you can use Run > Debug and select the Archipelago named configuration that we created in the previous steps. The debugging console will appear. It will say it is waiting for incoming connection from 'archipelago' .

    3. Right now the debugging session is not enabled. Browse to localhost:8001. Click on the gray XDebug Helper icon at the top right of your window and select the green \"Debug\" button. This will tell chrome to set the xdebug session key when you reload the page.

    4. Now set a breakpoint in your code, and refresh the page. If you have breakpoints set, either manually, or from leaving \"Break at first line in PHP scripts\" checked, you should have output now in the debugger.

    5. If you are done actively debugging, it is best to click the green XDebug Helper icon and select \"Disable\". This will greatly improve speed and performance for your app in development. When you need to debug, just turn on debugging using the XDebug Helper button again.

    6. If you would like to see the output of your xdebug logs, run the following script: docker exec -ti esmero-php bash -c 'tail -f /tmp/xdebug.log > /proc/1/fd/2'

    Then, you can use the typical docker logs command on the esmero-php container, and you will see the xdebug output: docker logs esmero-php -f

    Xdebug makes accessing variables in Drupal kind of great. Many possibilities, including debugging for Twig templates. Happy debugging!

    "},{"location":"xdebug/#appendix-xdebug-on-a-linux-host","title":"Appendix: XDebug on a linux host","text":"

    If you are developing on a linux machine, you may need to make a change to the xdebug configuration file.

    1. Create a new file in the /archipelago-deployment/xdebug folder called xdebug.ini and enter the following text: 
      zend_extension=xdebug\n\n[xdebug]\nxdebug.mode=develop,debug\nxdebug.discover_client_host = 1\nxdebug.start_with_request=yes\n
    2. Make a bind mount to this file in your docker-compose.dev.yml file: 
        php-debug:\n  ...\n    volumes:\n  - ${PWD}:/var/www/html:cached\n    # Bind mount custom xdebug configuration file...\n  - ${PWD}/xdebug/xdebug.ini:/usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini\n
    3. Restart your docker containers using the method described at the top of this page.

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    Return to the Archipelago Documentation main page.

    "}]} \ No newline at end of file diff --git a/1.3.0/search_advanced/index.html b/1.3.0/search_advanced/index.html index 5c2dc6b5..7bbe5f40 100644 --- a/1.3.0/search_advanced/index.html +++ b/1.3.0/search_advanced/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1832,6 +1832,8 @@ + + @@ -1949,6 +1951,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/search_solr_index/index.html b/1.3.0/search_solr_index/index.html index b18a6dfb..460ff826 100644 --- a/1.3.0/search_solr_index/index.html +++ b/1.3.0/search_solr_index/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1790,6 +1790,8 @@ + + @@ -1907,6 +1909,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/security_bots/index.html b/1.3.0/security_bots/index.html index ca4f62d5..21fc753c 100644 --- a/1.3.0/security_bots/index.html +++ b/1.3.0/security_bots/index.html @@ -18,7 +18,7 @@ - + @@ -26,7 +26,7 @@ - + @@ -1680,6 +1680,8 @@ + + @@ -1797,6 +1799,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/sitemap.xml b/1.3.0/sitemap.xml index fd855493..9c0f6e70 100644 --- a/1.3.0/sitemap.xml +++ b/1.3.0/sitemap.xml @@ -2,362 +2,367 @@ https://docs.archipelago.nyc/1.3.0/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/AMIviaSpreadsheets/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/CODE_OF_CONDUCT/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/I7solrImporter/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/about/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/acknowledgments/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/ami_index/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/ami_lod_rec/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/ami_spreadsheet_overview/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/ami_update/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/annotations/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archifilepersistencestrategy/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-UpgradeDrupalD9toD10/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-democontent/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-live-UpgradeDrupalD9toD10/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-live-gitworkflow/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-live-moveToLive/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-live-readme/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-live-updatingContainers/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-live-upgradeFromD8ToD9/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-live-upgradeFromRC3/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-osx/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-readme/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-ubuntu/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/archipelago-deployment-windows/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/createdisplaymodes/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/customwebformelements/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/devops/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/documentation_about/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/documentation_features/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/documentation_technical/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/documentation_template/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/documentation_workflow/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/drupal_core_update/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/find_and_replace/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/find_and_replace_action_json_patch/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/find_and_replace_action_text/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/find_and_replace_action_webform/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/firstobject/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/fragaria/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/generalqa_minio_logging/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/generalqa_smtp_configuration/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/generalqa_twig_modules_configuration/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/giveortake/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/googleapi/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/inthewild/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/metadata_display_preview/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/metadatainarchipelago/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/metadatatwigs/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/modifyingfileextensionsinwebform/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/ourtake/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/presentations_events/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/search-within-collection/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/search_advanced/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/search_solr_index/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/security_bots/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/sslsetup/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/strawberry_key_name_providers/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/strawberryfield-formatters/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/strawberryfields/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/strawberryrunners/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/strawberryrunners_pager_ocr/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/strawberryrunners_wacz_binary/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/strawberryrunners_webpage_text/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/traditional-install/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/twig_extensions/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/twig_recipe_cards/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/utility_scripts/ - 2024-02-12 + 2024-02-21 + daily + + + https://docs.archipelago.nyc/1.3.0/webformLoDfromCSV/ + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/webforms/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/webformsasinput/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/workingtwigs/ - 2024-02-12 + 2024-02-21 daily https://docs.archipelago.nyc/1.3.0/xdebug/ - 2024-02-12 + 2024-02-21 daily \ No newline at end of file diff --git a/1.3.0/sitemap.xml.gz b/1.3.0/sitemap.xml.gz index a3efd07bd126b5e4f0978ebdae11a9b7b6648e16..d162dfd75b7e0190715e369fd258a319120cf2ad 100644 GIT binary patch literal 941 zcmV;e15*4SiwFpvR@P+#|8r?{Wo=<_E_iKh0Nt8VZ`(Ey$KU%Y0>9gG(gAA*$HibT zK!9!m)?}~5nLNpCC>~2vRmG(<^^YOWN7blF#lD}D8 zuGWhS^qP$I-Ob|h;dc39@p1cZGenm#UvOogZWhO!!!J!Uj^irXj6H<3qS!S_ANfaW z&V|i-b-mcWyWpeT;N@&SHjebR+$HgC4C%CjsE;6e*c@gzg4^YKlYEi2hpr|KPPhWt`8J5M$xEnpdrg9)K8v9hoJy;dI$zG%Et7bGGvaL!bemoZLPylVtmRR+%e_I&D%}# z!Cy+327{xixUc17=pq>0$02~*UuW81u4}ZzU{9JnzmHrazOyI%Vcx}TOlR{*@u_t* zR%=7g9{zzo@oBXtlxWr0i$6y$)=oPf+F(8V+=@+^NB3={e*fWt_SZjxC4cVT*JuW% z=Nhr=9n8aF@Oh|_d}RGZqinaMxnpEBHU$S0KOcqT4k=SV;-RJ3qeJ;R+Te+Ta75BW zX~>4-Xq5UglQ>+=yu z>x^j19y4&x1L~|mRfs5lUF;jQ^>40ML0lYzY@x)DwC%((qAZkgo`b$@he_7gkUP*I z-+S=@OWzbyQg{+Sfs(M4FGrh?)-N?Vhgy6ndx2J9PT)0~8d%Fdp9*$-B-BH+c~S?G z-f>ges5b=JkU7G5z!)d>gp=~nBgbGmStEVH?3KK==*+T22gtcH>{?*s;C($!d!|(Z zI*f{Rtc-gE{kJ-l{Bo*|91o?@<?UVoOpawX6o(}#%i5>kq2e~_wTEI@9c-DRrEe&5W`2^ZkEhOE95E(K{$_T$ zSk5lcYckfiH?zlw+xdst$Mu_4A6>$H!IgcwnH_Qte>BZ742xtlb`a8nV%sEr;2)_u z7dFeq^=$p-f{${8=d#OC}yZQ2JetE@J&SkHv=>zx{_YuFY4Olm>npY*yK+SiepJe;=*WJ;=zab)+bU@5W zH16hp`&r%Js?Gi1+sDm=Xx6*;iCnzv0>z9`G%D<<&$0>ilc&LE^x~fsv7bL$9K=KS!9YgYnBG%{%u!SLh$^Lf>oAlUpE3t`OgVD%wxfLT z=hC^s;AkxFYyKG82nM&Y58$@fnYNe98tpLHktWaYBiD%U>=A#PcQF~$+B{Hv+B+Jm zwV`7V|3H88X|*PlXw}t=KSeIqP8%NDU_JZXicOhD_idzZ`{9AM*S~`$|7_mYXa=QI zjo9@L=6=`v+}B7xuzsRJw%gI%F)|vPf`gHtkHT^Ll&KqVx2M>lL-{(|;E{rGMACg} z$Vo#f`O_#r^6t3<_YrGq;*9#>tp-;WbH^@1_*B4;$W@34Gf6h3DPj$iEqjh>3VfMy zofWj`1b&M}VvkRpMtnA~1-0-tj?hB1AR4ko*4^N~g6gcd zq#U&^OY%yXQAE%H~33wiCtC*m7m})Y>9+6^(C)rV@C2Ac)u%aog&j%c= zGomRw%)mJhsIvl9A)@$ov2W1Uzq(!pad8Z?g%Ur~?njOhWuc7o9Q0*7OtQX)+<|)e z-irrV`lgVQ!lU>Jl!T>xKG=M)ey+(m)Z#%n^ni#yF}c9F>O-IR?|w8tDsWFXVfR&df`6fSfDCt_3#s-q+K#XId4Y z#i&Tf%D4y6|EXQcFUQ)*aaS5${u~vP8(Z=SaC7TZ1}A$qe$w$7zwp-4K~AUvlytDrg{fn{3|zLr?lh*)jP7se-pyZ#r_tkTL)O D=p*IU diff --git a/1.3.0/sslsetup/index.html b/1.3.0/sslsetup/index.html index 6264c1f4..9c531691 100644 --- a/1.3.0/sslsetup/index.html +++ b/1.3.0/sslsetup/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1748,6 +1748,8 @@ + + @@ -1865,6 +1867,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/strawberry_key_name_providers/index.html b/1.3.0/strawberry_key_name_providers/index.html index 01ed12e3..ae11ca55 100644 --- a/1.3.0/strawberry_key_name_providers/index.html +++ b/1.3.0/strawberry_key_name_providers/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1823,6 +1823,8 @@ + + @@ -1940,6 +1942,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/strawberryfield-formatters/index.html b/1.3.0/strawberryfield-formatters/index.html index be31f2d5..ab39711c 100644 --- a/1.3.0/strawberryfield-formatters/index.html +++ b/1.3.0/strawberryfield-formatters/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1770,6 +1770,8 @@ + + @@ -1887,6 +1889,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/strawberryfields/index.html b/1.3.0/strawberryfields/index.html index 8d16a108..14b90e4f 100644 --- a/1.3.0/strawberryfields/index.html +++ b/1.3.0/strawberryfields/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1762,6 +1762,8 @@ + + @@ -1879,6 +1881,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/strawberryrunners/index.html b/1.3.0/strawberryrunners/index.html index 35be2d2e..0f1560cf 100644 --- a/1.3.0/strawberryrunners/index.html +++ b/1.3.0/strawberryrunners/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1772,6 +1772,8 @@ + + @@ -1889,6 +1891,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/strawberryrunners_pager_ocr/index.html b/1.3.0/strawberryrunners_pager_ocr/index.html index 3a48bdb4..20851977 100644 --- a/1.3.0/strawberryrunners_pager_ocr/index.html +++ b/1.3.0/strawberryrunners_pager_ocr/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1700,6 +1700,8 @@ + + @@ -1817,6 +1819,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/strawberryrunners_wacz_binary/index.html b/1.3.0/strawberryrunners_wacz_binary/index.html index b35fb839..58a0251c 100644 --- a/1.3.0/strawberryrunners_wacz_binary/index.html +++ b/1.3.0/strawberryrunners_wacz_binary/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1700,6 +1700,8 @@ + + @@ -1817,6 +1819,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/strawberryrunners_webpage_text/index.html b/1.3.0/strawberryrunners_webpage_text/index.html index f68fad06..886c708f 100644 --- a/1.3.0/strawberryrunners_webpage_text/index.html +++ b/1.3.0/strawberryrunners_webpage_text/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1700,6 +1700,8 @@ + + @@ -1817,6 +1819,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/traditional-install/index.html b/1.3.0/traditional-install/index.html index c89005f8..b23c798b 100644 --- a/1.3.0/traditional-install/index.html +++ b/1.3.0/traditional-install/index.html @@ -18,7 +18,7 @@ - + @@ -26,7 +26,7 @@ - + @@ -1680,6 +1680,8 @@ + + @@ -1797,6 +1799,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/twig_extensions/index.html b/1.3.0/twig_extensions/index.html index 250d4080..8b1bcaa0 100644 --- a/1.3.0/twig_extensions/index.html +++ b/1.3.0/twig_extensions/index.html @@ -18,7 +18,7 @@ - + @@ -26,7 +26,7 @@ - + @@ -1680,6 +1680,8 @@ + + @@ -1797,6 +1799,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/twig_recipe_cards/index.html b/1.3.0/twig_recipe_cards/index.html index 389b41ef..521619a7 100644 --- a/1.3.0/twig_recipe_cards/index.html +++ b/1.3.0/twig_recipe_cards/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1688,6 +1688,8 @@ + + @@ -1805,6 +1807,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/utility_scripts/index.html b/1.3.0/utility_scripts/index.html index c791f71b..92104eb0 100644 --- a/1.3.0/utility_scripts/index.html +++ b/1.3.0/utility_scripts/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1770,6 +1770,8 @@ + + @@ -1887,6 +1889,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/webformLoDfromCSV/index.html b/1.3.0/webformLoDfromCSV/index.html new file mode 100644 index 00000000..5369cc37 --- /dev/null +++ b/1.3.0/webformLoDfromCSV/index.html @@ -0,0 +1,3008 @@ + + + + + + + + + + + + + + + + + + + + + + + + + Archipelago Custom Webform Elements - Archipelago Documentation + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + + +

    Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest'

    +

    Archipelago's custom webform element 'Webform LoD from CSV attached to an ADO suggest' provides a form element autocomplete labels/urls(values) from a CSV attached to a Digital Object. Using this element affords a way for you to utilize a custom local vocabulary, a subset of labels and URIs from a wider LoD authority source, or an LoD vocabulary that does not have an accessible API or public query service.

    +

    Step-by-step

    +
      +
    1. +

      To use this element, you need to first have prepared a CSV file containing two columns only:

      +
        +
      • one column for 'label' containing the labels for your vocabulary
        • +
      • one column for 'uris' containing the corresponding uris for your vocabulary
        • +
      +
      2. +
    2. +

      Create a new Digital Object, and attached the prepared CSV file to the new Digital Object.

      +
        +
      • Be sure to provide a unique label to help you identify this Object in future steps.
        • +
      • It is recommended that you do not Publish this Object.
        • +
      +
      3. +
    +
    +

    Note

    +

    If you are not yet familiar with how to create a Digtial Object, please refer to this guide.

    +
    +
      +
    1. +

      Go to Admin > Structure > Webforms and select the 'Build' button beside the Default Descriptive Metadata Webform.

      +
      2. +
    2. +

      Scroll down to the 'Subjects and Other Classifications' page of the Webform and select 'Add Element'.

      +
      3. +
    +

    Webform Add Element

    +
      +
    1. In the 'Select an element to add ..' popup that opens, either scroll down to select the 'Composite Element' section or search for the 'Webform LoD from CSV attached to an ADO suggest.' Select 'Add Element'.
      2. +
    +

    Webform LoD From CSV Add Element

    +
      +
    1. +

      In the Edit tab that opens for your newly added element, you will need to review the following sections.

      +
      2. +
    2. +

      Element Settings

      +
        +
      • provide a Title for element
        • +
      • check that the Key generated from the Title you supply is well formed and make changes if needed
        • +
      • specify the 'Allowed number of values'
        • +
      +
      3. +
    +

    Webform LoD from CSV General Settings

    +
      +
    • +

      Webform LoD from CSV attached to an ADO suggest settings:

      +
        +
      • It is recommended to keept both 'label' and 'uri' checked as Visible.
        • +
      • You may also wish to mark both elements as 'Required'
        • +
      +
      • +
    +

    Webform LoD from CSV Autocomplete Settings

    +
      +
    • +

      Autocomplete settings

      +
        +
      • In the 'Choose an ADO' box, begin typing to search for the Digital Object that holds a CSV containing the Vocabulary you want to autocomplete.
        • +
      • Under 'The CSV column(header name) that will be used for autocompleting', enter 'label'
        • +
      • Under 'The CSV column(header name) that will be used for the URL value', enter 'uri'
        • +
      • 'Autocomplete limit'
          +
        • determines the maximum number of matches to be displayed
          • +
        • recommended that you set to '10'.
          • +
        +
        • +
      • 'Autocomplete minimum number of characters'
          +
        • determines the minimum number of characters a user must type before a search is performed
          • +
        • recommended that you set to '3'.
          • +
        +
        • +
      • 'Autocomplete matching operator'
          +
        • determines the method used to collect autocomplete suggestions
          • +
        • recommended to use 'Starts with'
          • +
        +
        • +
      +
      • +
    • +

      Navigate to the 'Advanced' tab for this Webform element.

      +
        +
      • Open the 'Multiple settings' section
        • +
      • dDeselect the options to 'Allow users to sort elements' and 'Allow users to add more items'
        • +
      +
      • +
    +

    Webform LoD from CSV Advanced Tab

    +
      +
    1. +

      Save your new form element settings. Then Save your updated Webform.

      +
      2. +
    2. +

      Navigate to a Digital Object in your repository that you would like to use this new custom vocabulary element with. Select 'Edit' for that Digital Object and navigate to the 'Subjects and Other Classifications' page of the webform. Begin typing a label found in your prepared CSV associated with the webform element.

      +
      3. +
    +

    Webform LoD from CSV in Action

    +

    You can now begin using this custom vocab vocabulary element when using the corresponding webform (where you added this element) to Edit and Update your Digital Objects. You may also wish to add this same element to the Default Digital Object Collection/Creative Work Series webform.

    +
    +

    Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

    +

    Return to the Archipelago Documentation main page.

    + + + + + + + + + + + + + + + + + + + + + + +
    +
    + + + +
    + + + +
    + + + +
    +
    +
    +
    + + + + + + + + + + \ No newline at end of file diff --git a/1.3.0/webforms/index.html b/1.3.0/webforms/index.html index 993b462f..d5a48386 100644 --- a/1.3.0/webforms/index.html +++ b/1.3.0/webforms/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1690,6 +1690,8 @@ + + @@ -1776,6 +1778,16 @@ @@ -1865,6 +1882,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + @@ -2776,6 +2814,16 @@ @@ -2836,28 +2889,34 @@

    Webforms in Archipelago

    The Webform Strawberryfield module provides Drupal Webform ( == awesome piece of code) integrations for StrawberryField so you can really have control over your Metadata ingests. These custom elements provide Drupal Webform integrations for Archipelago’s StrawberryField so you can have fine grained and detailed control over your Metadata ingests and edits.

    +

    Where to Find

    +

    You can access Webforms in Archipelago at: +- Admin > Structure > Webforms +- /admin/structure/webform/

    +

    Default Archipelago Webforms

    Instructions and Guides

    -

    Examples

    -

    Use these webforms or their elements to create a custom webform for your own repository/project needs

    +

    Archipelago Default Example Webforms

    +

    Use these webforms or their elements to create a custom webform for your own repository/project needs:

    diff --git a/1.3.0/workingtwigs/index.html b/1.3.0/workingtwigs/index.html index 489513fa..891ae551 100644 --- a/1.3.0/workingtwigs/index.html +++ b/1.3.0/workingtwigs/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1688,6 +1688,8 @@ + + @@ -1805,6 +1807,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + + diff --git a/1.3.0/xdebug/index.html b/1.3.0/xdebug/index.html index 49c46112..4d17b840 100644 --- a/1.3.0/xdebug/index.html +++ b/1.3.0/xdebug/index.html @@ -22,7 +22,7 @@ - + @@ -30,7 +30,7 @@ - + @@ -1748,6 +1748,8 @@ + + @@ -1865,6 +1867,27 @@ + + + + + + +
  • + + + + + Using Archipelago's 'Webform LoD from CSV attached to an ADO suggest' + + + + +
    • + + + +

    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 TlIna;2>8>}GSn>OQe2?!oMPcR@g)cHc6Zt^-_ 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 literal 0 HcmV?d00001 diff --git a/1.3.0/index.html b/1.3.0/index.html index 9face355..67574ff2 100644 --- a/1.3.0/index.html +++ b/1.3.0/index.html @@ -20,7 +20,7 @@ - + @@ -28,7 +28,7 @@ - + @@ -1692,6 +1692,8 @@ + + @@ -1809,6 +1811,27 @@ + + + + + + +