<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<style type="text/css" style="display:none;"> P {margin-top:0;margin-bottom:0;} </style>
</head>
<body dir="ltr">
<div><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Hey Ron</span></div>
<div class="elementToProof"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div class="elementToProof"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Here's the way I'd do this.</span></div>
<div class="elementToProof"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<ol start="1" style="margin-block: 0px; list-style-type: decimal;" data-editing-info="{"orderedStyleType":1,"unorderedStyleType":1}" data-listchain="__List_Chain_293">
<li style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Create a new directory in the plugin folder in your ArchivesSpace directory. Call it something like aspace_custom_locatizations
(or whatever you want)</span></li><li style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">In that new directory, create two new directories: backend and frontend</span></li><li style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">In the backend directory, add a file called plugin_init.rb. Put the contents of the monkey patch in that file</span></li><li style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">In the frontend directory, add a file tree that mimics the locales directory in the core code:</span></li><ol start="1" style="margin-block: 0px; list-style-type: lower-alpha;">
<li style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">locales/</span></li><li style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">locales/enums</span></li></ol>
<li style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Add your new dutch locales files to those two locations. Name them nl.yml</span></li><li style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">In your config file, add your plugin name (the directory name in step 1) to the list of plugins that are active:
AppConfig[:plugins] is the key you want to edit.</span></li></ol>
<div class="elementToProof"><br>
</div>
<div class="elementToProof"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Since I haven't tested this, there may be some gotchas I'm not thinking about as far
as the monkeypatch and where the locales list may also be referenced, but this is the approach I'd take.<br>
</span></div>
<div class="elementToProof"><br>
</div>
<div class="elementToProof"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">There's more info on that tech docs page and there are a bunch of examples to be found
on the Awesome ArchivesSpace repo (</span><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><a href="https://github.com/archivesspace/awesome-archivesspace" id="LPlnk816304">https://github.com/archivesspace/awesome-archivesspace</a>)
</span><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">and Hudson Molonglo's repos (</span><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><a href="https://github.com/hudmol" id="LPlnk106521">https://github.com/hudmol</a>)
and <a href="https://gitlab.gaiaresources.com.au/explore" id="LPlnk948602">https://gitlab.gaiaresources.com.au/explor</a></span></div>
<div class="elementToProof"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div class="elementToProof"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">jds</span></div>
<div class="elementToProof" style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<div id="appendonsend"></div>
<div style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<hr style="display: inline-block; width: 98%;">
<div id="divRplyFwdMsg" dir="ltr"><span style="font-family: Calibri, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);"><b>From:</b> archivesspace_users_group-bounces@lyralists.lyrasis.org <archivesspace_users_group-bounces@lyralists.lyrasis.org> on behalf
of Ron Van den Branden <Ron.VandenBranden@antwerpen.be><br>
<b>Sent:</b> Wednesday, December 6, 2023 11:01 AM<br>
<b>To:</b> Archivesspace Users Group <archivesspace_users_group@lyralists.lyrasis.org><br>
<b>Subject:</b> Re: [Archivesspace_Users_Group] how to add a new locale to ArchivesSpace?</span>
<div> </div>
</div>
<div style="direction: ltr;"><span style="letter-spacing: normal; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; font-weight: 400; color: rgb(0, 0, 0);">Hi Joshua,</span></div>
<div style="direction: ltr; text-align: left; margin: 0px;"><span style="letter-spacing: normal; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; font-weight: 400; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr; text-align: left; margin: 0px;"><span style="letter-spacing: normal; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; font-weight: 400; color: rgb(0, 0, 0);">Ok, thanks for that pointer! The point is that we couldn't
find that common/aspace_i18n.rb file in the ArchivesSpace distribution code. Or are you suggesting to add it in a plugin? If so, would you mind guiding me a bit more?</span></div>
<div style="direction: ltr; text-align: left; margin: 0px;"><span style="letter-spacing: normal; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; font-weight: 400; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr; text-align: left; margin: 0px;"><span style="letter-spacing: normal; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; font-weight: 400; color: rgb(0, 0, 0);">I don't think we've succeeded in building from source (I'm
on Windows, so I'm probably at a loss for local testing, I recall some Ruby build incompatibilities). </span></div>
<div style="direction: ltr; text-align: left; margin: 0px;"><span style="letter-spacing: normal; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; font-weight: 400; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr; text-align: left; margin: 0px;"><span style="letter-spacing: normal; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; font-weight: 400; color: rgb(0, 0, 0);">Best,</span></div>
<div style="direction: ltr; text-align: left; margin: 0px;"><span style="letter-spacing: normal; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; font-weight: 400; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr; text-align: left; margin: 0px;"><span style="letter-spacing: normal; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; font-weight: 400; color: rgb(0, 0, 0);">Ron</span></div>
<div style="direction: ltr;"><span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);"><br>
</span></div>
<hr style="direction: ltr; display: inline-block; width: 98%;">
<div id="x_divRplyFwdMsg" dir="ltr"><span style="font-family: Calibri, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);"><b>Van:</b> archivesspace_users_group-bounces@lyralists.lyrasis.org <archivesspace_users_group-bounces@lyralists.lyrasis.org> namens Joshua
D. Shaw <Joshua.D.Shaw@dartmouth.edu><br>
<b>Verzonden:</b> woensdag 6 december 2023 16:44<br>
<b>Aan:</b> Archivesspace Users Group <archivesspace_users_group@lyralists.lyrasis.org><br>
<b>Onderwerp:</b> Re: [Archivesspace_Users_Group] how to add a new locale to ArchivesSpace?</span>
<div> </div>
</div>
<table style="direction: ltr; display: table; width: 100%; table-layout: fixed;" align="left">
<tbody>
<tr>
<td style="direction: ltr; padding: 7px 2px; vertical-align: middle; width: 1px; background-color: rgb(166, 166, 166);">
</td>
<td style="direction: ltr; text-align: left; padding: 7px 5px 7px 15px; vertical-align: middle; width: 100%; color: rgb(33, 33, 33); background-color: rgb(234, 234, 234);">
<div style="direction: ltr; text-align: left;"><span style="font-family: wf_segoe-ui_normal, "Segoe UI", "Segoe WP", Tahoma, Arial, sans-serif; font-size: 12px;">U ontvangt niet vaak e-mail van joshua.d.shaw@dartmouth.edu.
<a href="https://aka.ms/LearnAboutSenderIdentification" id="OWAacc1708b-574d-4466-82d6-821193b38191" class="x_OWAAutoLink" data-auth="NotApplicable" data-loopstyle="linkonly">
Meer informatie over waarom dit belangrijk is</a></span></div>
</td>
<td style="direction: ltr; padding: 7px 5px; vertical-align: middle; width: 75px; color: rgb(33, 33, 33); background-color: rgb(234, 234, 234);" align="left">
</td>
</tr>
</tbody>
</table>
<p style="direction: ltr; line-height: 105%; margin: 0cm 0cm 8pt; font-family: Calibri, sans-serif; font-size: 13px;">
<span style="font-family: Arial, sans-serif; line-height: 105%; color: rgb(207, 0, 57);"><b>WAARSCHUWING: DIT IS EEN EXTERNE MAIL</b></span></p>
<p style="direction: ltr; line-height: 105%; margin: 0cm 0cm 8pt; font-family: Calibri, sans-serif; font-size: 12px;">
<span style="font-family: Arial, sans-serif; line-height: 105%; color: rgb(207, 0, 57);">Deze mail komt van buiten onze organisatie. Kijk eerst of je het mailadres en de afzender herkent en/of vertrouwt. Doe dat voor je bijlagen opent of links aanklikt. Zo
houden we onze organisatie veiliger voor phishing. </span></p>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Hey Ron</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">In addition to what Christine lists....</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Off the top of my head (so take with a grain of salt since I haven't actually tested
this!)...</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">In a plugin init (probably a backend plugin_init), monkey patch the self.supported_locales
method in common/aspace_i18n.rb. Maybe something like</span></div>
<div style="direction: ltr;"><br>
</div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">module I18n</span></div>
<div style="direction: ltr; margin-right: 40px; margin-left: 40px;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">def self.supported_locales</span></div>
<div style="direction: ltr; margin-right: 40px; margin-left: 40px;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"> enhanced_locales = LOCALES</span></div>
<div style="direction: ltr; margin-right: 40px; margin-left: 40px;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr; margin-right: 40px; margin-left: 40px;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"> # map I18n language code => ArchivesSpace
enumerations:language_iso639_2 code</span></div>
<div style="direction: ltr; margin-right: 40px; margin-left: 40px;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"> # enumerations iso codes found in common/locales/enums</span></div>
<div style="direction: ltr; margin-right: 40px; margin-left: 40px;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"> enhanced_locales['nl'] = 'dut'</span></div>
<div style="direction: ltr; margin-right: 40px; margin-left: 40px;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr; margin-right: 40px; margin-left: 40px;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"> enhanced_locales</span></div>
<div style="direction: ltr; margin-right: 40px; margin-left: 40px;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">end</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">end</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Then you could add your new dutch locale file nl.yml within that same plugin.</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">OR</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">You could grab the code tree from github, patch it locally and build your patched application.</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Both approaches have their own set of headaches as far as maintenance.</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">To contribute and other tech docs:
<a href="https://archivesspace.github.io/tech-docs/readme_develop.html" id="OWA9759ebc3-365f-f554-3c02-7e751a5caf50" class="x_x_OWAAutoLink" shash="oeQ9Rbpq3GH3nc2YxbwmtjArlsrbeNo1jn4Dd2ZC+G7/sLH0lNQgycJYGALIOMJjPzeTv8YmLlKGKsvfubiw9Tmu9Pdb365u+x8LrEF76s7E9jbjtvFaqzL2ZAC6qqhrMSvbnpd+IyK6tuC6WfPkQVCknBbANAGIKV2VwJMF55E=" originalsrc="https://archivesspace.github.io/tech-docs/readme_develop.html" data-auth="Verified" data-loopstyle="linkonly">
https://archivesspace.github.io/tech-docs/readme_develop.html</a></span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);"><br>
</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Hope that helps!</span></div>
<div style="direction: ltr;"><span style="font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">Joshua</span></div>
<div style="direction: ltr;"><br>
</div>
<div style="direction: ltr; font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<div id="x_x_appendonsend"></div>
<div style="direction: ltr; font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);">
<br>
</div>
<hr style="direction: ltr; display: inline-block; width: 98%;">
<div id="x_x_divRplyFwdMsg" dir="ltr"><span style="font-family: Calibri, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);"><b>From:</b> archivesspace_users_group-bounces@lyralists.lyrasis.org <archivesspace_users_group-bounces@lyralists.lyrasis.org> on behalf
of Ron Van den Branden <Ron.VandenBranden@antwerpen.be><br>
<b>Sent:</b> Wednesday, December 6, 2023 9:51 AM<br>
<b>To:</b> archivesspace_users_group@lyralists.lyrasis.org <archivesspace_users_group@lyralists.lyrasis.org><br>
<b>Subject:</b> [Archivesspace_Users_Group] how to add a new locale to ArchivesSpace?</span>
<div> </div>
</div>
<div style="direction: ltr;"><span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">Hi all,</span></div>
<div style="direction: ltr; margin-top: 1em; margin-bottom: 1em;"><span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">We're in the process of customizing the ArchivesSpace (3.4.1) staff interface for use in a Dutch-speaking
context. We would like to translate the back-end user interface to Dutch. So far, in order to gain speed, we've resorted to tweaking the en.yml localization files with Dutch labels. In the longer run, hijacking "English" for another language feels like a hack,
though.</span></div>
<div style="direction: ltr; margin-top: 1em; margin-bottom: 1em;"><span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">The documentation for "customizing text" at
<a href="https://archivesspace.github.io/tech-docs/customization/locales.html" id="OWAcbca62a9-68a7-e242-ac9f-99b74e888f75" class="x_x_x_OWAAutoLink" shash="WXHjhuy2dTl/aksEVykUWoTiIikogmea4LVbtqUlY5HQIMlJhMW8e67hog9KxFIuwcCNyjfBrJ8u60zUvysMcJ/40UPl4BQ7vj73aX/MW52cgt3tndZQSvA0tT171H/s+MseTdutIG/tlbMNtGCFvjvXs/pY0kKWk5WTGZnRgnE=" originalsrc="https://archivesspace.github.io/tech-docs/customization/locales.html" data-auth="Verified" data-loopstyle="linkonly">
https://archivesspace.github.io/tech-docs/customization/locales.html</a> does mention where strings can be customized in current locales, but not how new locales can be added. Simply adding new locale files for new languages, with according names and language
codes, at the right locations doesn't seem to do the trick:</span></div>
<ul style="direction: ltr; list-style-type: disc;">
<li style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; direction: ltr; color: rgb(0, 0, 0);">
<span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">either the language is not being offered in the list of available languages</span></li><li style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
<div style="direction: ltr;"><span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">when additionally the new language is specified explicitly in the config/config.rb file as
</span><span style="font-family: "Courier New", monospace; font-size: 10pt; color: rgb(0, 0, 0);">AppConfig[:locale] = :nl</span><span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);"> , this yields following error
at startup:</span></div>
<blockquote style="margin-right: 0px; margin-left: 0.8ex; padding-left: 1ex; border-left: 3px solid rgb(200, 200, 200);">
<pre><div style="direction: ltr; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">JSONModel::ValidationException: #<:ValidationException: {:errors=>{"defaults/locale"=>["Invalid value 'nl'. Must be one of: en, fr, de, ja, es"]}}></div></pre>
<pre><div style="direction: ltr; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);"> validate at uri:classloader:/jsonmodel_type.rb:385</div></pre>
<pre><div style="direction: ltr; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);"> with_validator_for at uri:classloader:/validator_cache.rb:41</div></pre>
</blockquote>
</li></ul>
<div style="direction: ltr; margin-top: 1em; margin-bottom: 1em;"><span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">...so there must be more to adding a new locale. Yet, we can't find where in the ArchivesSpace
distribution code such a list of default locales can be found or edited.</span></div>
<div style="direction: ltr; margin-top: 1em; margin-bottom: 1em;"><span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">We
<i>did </i>find the file in the ArchivesSpace source tree at <a href="https://github.com/archivesspace/archivesspace/blob/master/common/aspace_i18n.rb#L28" id="OWA0aea230e-c099-4480-3457-6b16b2d74274" class="x_x_x_OWAAutoLink" shash="R2mjuo4rU5+7k3/yBZ24lk0DylJsvpSMiqjIFsGhtkvBYqjAPSpxS9Qqlmnch+cCiHIyfCTv4ZyI38eDfLnrBS3+NF71ZH3oIckIeSK5e0MiDq+FgQ5cNJTTJ72KXSEvt5H9zdcUR1/XH94iIs9ptzC5fQ+xQ5+a0UblfAeeO7s=" originalsrc="https://github.com/archivesspace/archivesspace/blob/master/common/aspace_i18n.rb#L28" data-auth="Verified" data-loopstyle="linkonly">
https://github.com/archivesspace/archivesspace/blob/master/common/aspace_i18n.rb#L28</a> which defines above list of locales This file can't be found in the distribution code, however, so it's not clear how it relates to the distribution code. The commit history
also shows commits from the Weblate project at <a href="https://hosted.weblate.org/projects/archivesspace-interfaces/#languages" id="OWA3022eeca-4080-65bd-3538-d1aac56bd30d" class="x_x_OWAAutoLink" shash="JdmEZTwb4DTzCzXGtAt63A+JAuwQ8Gk5otgmIgo2/xL2v1UIlW1qiA6grGTVwK1GQNr4rc/hxKaz6CyQL9tYapeWJUqpHOPN6BY7Hufi1qw4jdmZ36/MN5NF3dNoABOWiT4q05P58knBevKGZjaxgH0DeAOOqStbY70pc1yy57Q=" originalsrc="https://hosted.weblate.org/projects/archivesspace-interfaces/#languages" data-auth="Verified" data-loopstyle="linkonly">
https://hosted.weblate.org/projects/archivesspace-interfaces/#languages</a>, which contains additional languages Portuguese and Italian.</span></div>
<div style="direction: ltr; margin-top: 1em; margin-bottom: 1em;"><span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">This leads to following questions:</span></div>
<ul style="direction: ltr; list-style-type: disc;">
<li style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; direction: ltr; color: rgb(0, 0, 0);">
<span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">what's the mechanism for adding a new locale to an ArchivesSpace instance?</span></li><li style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; direction: ltr; color: rgb(0, 0, 0);">
<span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">if our translations would reach a stage of being of broader interest, what would be the procedure for contributing them?</span></li></ul>
<div style="direction: ltr; margin-top: 1em; margin-bottom: 1em;"><span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">Kind regards,</span></div>
<div style="direction: ltr; margin-top: 1em; margin-bottom: 1em;"><span style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">Ron</span></div>
<div style="direction: ltr; font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
<br>
</div>
<div id="x_x_x_Signature">
<p style="text-align: left; line-height: 18.3333px; margin: 0px; font-family: Calibri, sans-serif; font-size: 11pt; background-color: rgb(255, 255, 255);">
<span style="font-family: Arial, sans-serif, serif, EmojiFont; font-size: 9pt; line-height: 15px; color: rgb(77, 77, 77);"><b>Ron Van den Branden | functioneel analist - applicatiebeheerder Letterenhuis</b></span></p>
<p style="text-align: left; line-height: 18.3333px; margin: 0px; font-family: Calibri, sans-serif; font-size: 11pt; background-color: rgb(255, 255, 255);">
<span style="font-family: Arial, sans-serif, serif, EmojiFont; font-size: 9pt; line-height: 15px; color: rgb(77, 77, 77);">Stad Antwerpen | Talentontwikkeling en Vrijetijdsbeleving</span><span style="font-family: Arial, sans-serif, serif, EmojiFont; font-size: 9pt; line-height: 15px; color: rgb(0, 0, 0);"> </span><span style="font-family: Arial, sans-serif, serif, EmojiFont; font-size: 9pt; line-height: 15px; color: rgb(77, 77, 77);">|
Boeken en Letteren</span></p>
<p style="text-align: left; line-height: 18.3333px; margin: 0px; font-family: Calibri, sans-serif; font-size: 11pt; background-color: rgb(255, 255, 255);">
<span style="font-family: Arial, sans-serif, serif, EmojiFont; font-size: 9pt; line-height: 15px; color: rgb(77, 77, 77);">Minderbroedersstraat 22, 2000 Antwerpen</span></p>
<p style="text-align: left; margin: 0px; font-family: Calibri, sans-serif; font-size: 11pt; background-color: rgb(255, 255, 255);">
<span style="font-family: Arial, sans-serif, serif, EmojiFont; font-size: 9pt; color: rgb(77, 77, 77);">Grote Markt 1, 2000 Antwerpen</span></p>
<p style="text-align: left; margin: 0px; font-family: Calibri, sans-serif; font-size: 11pt; background-color: rgb(255, 255, 255);">
<span style="font-family: Arial, sans-serif, serif, EmojiFont; font-size: 9pt; color: rgb(77, 77, 77);">gsm +32 0485 02 80 50 | tel. +32 3 222 93 30</span></p>
<p style="text-align: left; line-height: 18.3333px; margin: 0px; font-family: Calibri, sans-serif; font-size: 11pt; background-color: rgb(255, 255, 255);">
<span style="font-family: Arial, sans-serif, serif, EmojiFont; font-size: 9pt; line-height: 15px; color: rgb(77, 77, 77);"><a href="http://www.letterenhuis.be/" id="OWAf4b4b97e-96e2-3f48-5e2a-b9bde8fcc172" class="x_x_x_ContentPasted0 x_x_x_OWAAutoLink" style="margin: 0px; color: rgb(77, 77, 77);" shash="LQuEte36WmnPh3CEWRvocBfGtHZAnJQYqOi3WTHqw5i6SQjQvTSDbS3yv6EUPzOeGY7k6zZJR5lz/OC1ZNc1483yqrVcm48HVtdW86duupMPp4WxjSet46G/rjl+2DyykIOGF4oNpBpE0MlLL/y7qsZbIY9jd7pY76mSJiYDe4w=" originalsrc="http://www.letterenhuis.be/" data-auth="Verified" data-safelink="true" data-linkindex="2" data-loopstyle="linkonly">letterenhuis.be</a> |
<a href="https://www.instagram.com/letterenhuis/" id="OWAdc354cda-f01a-bf96-79ea-6b13c58e71df" class="x_x_x_ContentPasted0 x_x_x_OWAAutoLink" style="margin: 0px; color: rgb(77, 77, 77);" shash="wXZCSL7igIpnz+Mx1Wy7BwnQ+13jbvvqyQstlnN7hdgaldp6YBgXKw2GKnEdV8fneY8k8lBzIG+GwfO4MRl/a/ozTPr6qLGjGe84RW4GBs4/yhwFzVJxQpxMq9AUc2MQTopmwM4lytR+NKVDEHMRSbhdufYcIdM0BHvwJNaHZyY=" originalsrc="https://www.instagram.com/letterenhuis/" data-auth="Verified" data-safelink="true" data-linkindex="3" data-loopstyle="linkonly">
instagram</a> | <a href="https://www.facebook.com/Letterenhuis" id="OWA9bb90d15-2c94-2810-e591-174379e4b11d" class="x_x_x_ContentPasted0 x_x_x_OWAAutoLink" style="margin: 0px; color: rgb(77, 77, 77);" shash="K+1tgVoK7CMT7VaFMnHLk6Fdtcj7QmkLR4W7GGJZjYDLHwzTIWC3GYrrV2VkmVqOxwKOuSVC8BZfl5BVYbXVI4W6EUmCtD2XrGG+o1iLNwPAzX8WeMNv4MbNJTfNrUN3i8SWNZy3VHHSzDDqQZ+q8PWHVpTJxns6gLKtAsAVetI=" originalsrc="https://www.facebook.com/Letterenhuis" data-auth="Verified" data-safelink="true" data-linkindex="4" data-loopstyle="linkonly">
facebook</a></span></p>
<p style="text-align: left; line-height: 18.3333px; margin: 0px; font-family: Calibri, sans-serif; font-size: 11pt; background-color: rgb(255, 255, 255);">
<span style="font-family: Arial, sans-serif, serif, EmojiFont; font-size: 9pt; line-height: 15px; color: rgb(77, 77, 77);"> </span></p>
<p style="text-align: left; line-height: 18.3333px; margin: 0px; font-family: Calibri, sans-serif; font-size: 11pt; background-color: rgb(255, 255, 255);">
<span style="font-family: Arial, sans-serif, serif, EmojiFont; font-size: 7pt; line-height: 11.6667px; color: rgb(77, 77, 77);"><b>Proclaimer</b></span></p>
<p style="text-align: left; line-height: 18.3333px; margin: 0px; font-family: Calibri, sans-serif; font-size: 11pt; background-color: rgb(255, 255, 255);">
<span style="font-family: Arial, sans-serif, serif, EmojiFont; font-size: 7pt; line-height: 11.6667px; color: rgb(77, 77, 77);">Vergissen is menselijk. Dus als deze e-mail, samen met eventuele bijlagen, niet voor u bestemd is, vragen we u vriendelijk om dat
te melden aan de afzender. Deze e-mail en de bijlagen zijn namelijk officiële documenten van de stad Antwerpen. Ze kunnen vertrouwelijke of persoonlijke informatie bevatten. Als stad nemen we privacy heel serieus en willen we als een goede huisvader waken
over de vertrouwelijkheid van documenten. Als u dit bericht per vergissing hebt ontvangen of ergens hebt gevonden, wees dan zo eerlijk om het meteen te verwijderen en het niet verder te verspreiden of te kopiëren.</span></p>
<span style="font-family: Calibri, Arial, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0); background-color: rgb(255, 255, 255);"><br>
</span></div>
</body>
</html>