<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
<style type="text/css" style="display:none;"> P {margin-top:0;margin-bottom:0;} </style>
</head>
<body dir="ltr">
<div class="elementToProof" style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
Hi Christine,</div>
<div class="elementToProof" style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
<br>
</div>
<div class="elementToProof" style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
Many thanks for your detailed answer, and the complete overview of where to look for localization files.</div>
<div class="elementToProof" style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
<br>
</div>
<div class="elementToProof" style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
Editing the yml files (at least those under common and frontend) is exactly the approach we've taken. So far, with the "hack" of editing the translations in the en.yml files.</div>
<div class="elementToProof" style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
<br>
</div>
<div class="elementToProof" style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
I appreciate including a new translation into the ArchivesSpace code would take some time and thourough review. What I'm missing, still, is an answer to the question whether it's possible in the meantime to "properly" add a new localization, and register those
nl.yml files as a NL localization in an ArchivesSpace distribution. That would make it easier, IMO, to share and contribute those Dutch translation files in an earlier stage with potential interested parties, and offer them in a more mature stage for inclusion
into ArchivesSpace.</div>
<div class="elementToProof" style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
<br>
</div>
<div class="elementToProof" style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
Best,</div>
<div class="elementToProof" style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
<br>
</div>
<div class="elementToProof" style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; color: rgb(0, 0, 0);">
Ron</div>
<div class="elementToProof" style="font-family: Calibri, Helvetica, sans-serif; font-size: 11pt; 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>Van:</b> archivesspace_users_group-bounces@lyralists.lyrasis.org <archivesspace_users_group-bounces@lyralists.lyrasis.org> namens Christine
Di Bella <christine.dibella@lyrasis.org><br>
<b>Verzonden:</b> woensdag 6 december 2023 16:42<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>
<p style="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="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>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;">Hello Ron,</p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;">It’s great to hear that you’re working on customizing your interfaces to have the option of providing labels in Dutch. I believe there are some institutions in the Netherlands, Belgium,
and Luxembourg that have already done that, and you may hear from them here or directly. That would likely give you a very significant head start on your customization.</p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;">The Dutch translations themselves have not been contributed to the core ArchivesSpace yet, but we would be very interested in having them. We have a few options for contributing translations
to ArchivesSpace, including using the Weblate service. If you are comfortable working directly with the .yml files, however, you need to first grab the ones from our GitHub repository itself. If you only use the ones in a release distribution file, your interface
will be only partially translated.</p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;">These are the six directories to look for:</p>
<p style="line-height: 150%; margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;">
<span style="color: rgb(51, 51, 51);"><a href="https://github.com/archivesspace/archivesspace/tree/master/common/locales" id="OWAca9e1c6c-e8d3-8e49-6da9-f8feb3af8715" class="OWAAutoLink" data-auth="NotApplicable" style="margin-top: 0px; margin-bottom: 0px;">https://github.com/archivesspace/archivesspace/tree/master/common/locales</a></span></p>
<p style="line-height: 150%; margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;">
<span style="color: rgb(51, 51, 51);"><a href="https://github.com/archivesspace/archivesspace/tree/master/common/locales/enums" id="OWA8e405fec-f760-a04e-a1ba-13cb25283d3b" class="OWAAutoLink" data-auth="NotApplicable" style="margin-top: 0px; margin-bottom: 0px;">https://github.com/archivesspace/archivesspace/tree/master/common/locales/enums</a></span></p>
<p style="line-height: 150%; margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;">
<span style="color: rgb(51, 51, 51);"><a href="https://github.com/archivesspace/archivesspace/tree/master/frontend/config/locales" id="OWA2052b953-810c-070e-b27d-07ce9a9e6402" class="OWAAutoLink" data-auth="NotApplicable" style="margin-top: 0px; margin-bottom: 0px;">https://github.com/archivesspace/archivesspace/tree/master/frontend/config/locales</a></span></p>
<p style="line-height: 150%; margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;">
<span style="color: rgb(51, 51, 51);"><a href="https://github.com/archivesspace/archivesspace/tree/master/frontend/config/locales/help" id="OWA8b0cfe97-42f6-b12d-2d8c-3f9cc3511a84" class="OWAAutoLink" data-auth="NotApplicable" style="margin-top: 0px; margin-bottom: 0px;">https://github.com/archivesspace/archivesspace/tree/master/frontend/config/locales/help</a></span></p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: rgb(51, 51, 51);"><a href="https://github.com/archivesspace/archivesspace/tree/master/public/config/locales" id="OWA7196c7ee-bd2d-6696-d97e-0f386e4e10e4" class="OWAAutoLink" data-auth="NotApplicable" style="margin-top: 0px; margin-bottom: 0px;">https://github.com/archivesspace/archivesspace/tree/master/public/config/locales</a></span></p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><a href="https://github.com/archivesspace/archivesspace/tree/master/reports" id="OWAee633b2e-78c4-7f8e-4a91-e15dc9eda2cd" class="OWAAutoLink" data-auth="NotApplicable" style="margin-top: 0px; margin-bottom: 0px;">https://github.com/archivesspace/archivesspace/tree/master/reports</a> (there
are locale files for each of the reports in the subdirectories under this main directory)</p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;">It’s probably easiest to use the en.yml ones as your starting point since the labels in the file (the text that appears before the colons) need to stay in English. Follow the pattern
you see and make a set where each file is named nl.yml. Within the files, change the text that appears after the colon for each entry you want to be in Dutch. (Don’t change any of the formatting or line spacing since a computer is very literal.)</p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;">Once you’ve made all the changes you want, you can pull request the new files to us via GitHub, we can review, and then when all is correct and working like it should we will include
them in a future release of ArchivesSpace.</p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;">There’s plenty more to say, but I’ll start there and see if anyone who’s currently working with a translated interface or with translations has advice to offer. We’re always interested
in people submitting more languages for the ArchivesSpace application or improving the ones we have.</p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;">Christine</p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: rgb(31, 73, 125);">Christine Di Bella</span></p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: rgb(31, 73, 125);">ArchivesSpace Senior Program Manager</span></p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: rgb(31, 73, 125);"><a href="mailto:christine.dibella@lyrasis.org" id="OWA3fb8442f-57f7-bb44-9726-02ceb7fd9596" class="OWAAutoLink" style="margin-top: 0px; margin-bottom: 0px;">christine.dibella@lyrasis.org</a></span></p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><img id="x_Picture_x0020_1" style="width: 2.3333in; height: 0.4965in; margin-top: 0px; margin-bottom: 0px;" data-outlook-trace="F:1|T:1" src="cid:image001.jpg@01DA282F.D73F8850"></p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<div style="padding: 3pt 0in 0in; border-top: 1pt solid rgb(225, 225, 225);">
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><b>From:</b> archivesspace_users_group-bounces@lyralists.lyrasis.org <archivesspace_users_group-bounces@lyralists.lyrasis.org>
<b>On Behalf Of </b>Ron Van den Branden<br>
<b>Sent:</b> Wednesday, December 6, 2023 9:51 AM<br>
<b>To:</b> archivesspace_users_group@lyralists.lyrasis.org<br>
<b>Subject:</b> [Archivesspace_Users_Group] how to add a new locale to ArchivesSpace?</p>
</div>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: black;">Hi all,</span></p>
<div style="margin-top: 12pt; margin-bottom: 12pt;">
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: black;">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></p>
</div>
<div style="margin-top: 12pt; margin-bottom: 12pt;">
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: black;">The documentation for "customizing text" at
<a href="https://archivesspace.github.io/tech-docs/customization/locales.html" id="OWAc1ccf2ae-3f99-19fb-88e0-2aa4ace60e95" class="OWAAutoLink" data-auth="NotApplicable" style="margin-top: 0px; margin-bottom: 0px;">
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></p>
</div>
<ul style="margin-bottom: 0in; list-style-type: disc;">
<li style="font-family: Calibri, sans-serif; font-size: 11pt; margin: 0in; color: black;">
<span style="font-family: Calibri, sans-serif; font-size: 11pt; color: black;">either the language is not being offered in the list of available languages</span></li><li style="font-family: Calibri, sans-serif; font-size: 11pt; margin: 0in; color: black;">
<span style="font-family: Calibri, sans-serif; font-size: 11pt; color: black;">when additionally the new language is specified explicitly in the config/config.rb file as
</span><span style="font-family: "Courier New"; font-size: 10pt; color: black;">AppConfig[:locale] = :nl</span><span style="font-family: Calibri, sans-serif; font-size: 11pt; color: black;"> , this yields following error at startup:</span></li></ul>
<blockquote style="margin: 5pt 0in 5pt 4.8pt; padding: 0in 0in 0in 6pt; border-left: 2.25pt solid rgb(200, 200, 200);">
<pre style="margin: 0in 0in 0.0001pt 0.5in;"><div><span style="font-family: Calibri, sans-serif; font-size: 11pt; color: black;">JSONModel::ValidationException: #<:ValidationException: {:errors=>{"defaults/locale"=>["Invalid value 'nl'. Must be one of: en, fr, de, ja, es"]}}></span></div></pre>
<pre style="margin: 0in 0in 0.0001pt 0.5in;"><div><span style="font-family: Calibri, sans-serif; font-size: 11pt; color: black;"> validate at uri:classloader:/jsonmodel_type.rb:385</span></div></pre>
<pre style="margin: 0in 0in 0.0001pt 0.5in;"><div><span style="font-family: Calibri, sans-serif; font-size: 11pt; color: black;"> with_validator_for at uri:classloader:/validator_cache.rb:41</span></div></pre>
</blockquote>
<div style="margin-top: 12pt; margin-bottom: 12pt;">
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: black;">...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></p>
</div>
<div style="margin-top: 12pt; margin-bottom: 12pt;">
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: black;">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="OWA4d491524-efef-2daf-fd45-75ba944d042d" class="OWAAutoLink" data-auth="NotApplicable" style="margin-top: 0px; margin-bottom: 0px;">
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="OWA1bf74cf8-b7c3-69ce-65a1-d055c5af75b2" class="OWAAutoLink" data-auth="NotApplicable" style="margin-top: 0px; margin-bottom: 0px;">
https://hosted.weblate.org/projects/archivesspace-interfaces/#languages</a>, which contains additional languages Portuguese and Italian.</span></p>
</div>
<div style="margin-top: 12pt; margin-bottom: 12pt;">
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: black;">This leads to following questions:</span></p>
</div>
<ul style="margin-bottom: 0in; list-style-type: disc;">
<li style="font-family: Calibri, sans-serif; font-size: 11pt; margin: 0in; color: black;">
<span style="font-family: Calibri, sans-serif; font-size: 11pt; color: black;">what's the mechanism for adding a new locale to an ArchivesSpace instance?</span></li><li style="font-family: Calibri, sans-serif; font-size: 11pt; margin: 0in; color: black;">
<span style="font-family: Calibri, sans-serif; font-size: 11pt; color: black;">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="margin-top: 12pt; margin-bottom: 12pt;">
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: black;">Kind regards,</span></p>
</div>
<div style="margin-top: 12pt; margin-bottom: 12pt;">
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: black;">Ron</span></p>
</div>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"><span style="color: black;"> </span></p>
<div id="x_Signature">
<p style="line-height: 13.75pt; background-color: white;"><span style="font-family: Arial, sans-serif; font-size: 9pt; color: rgb(77, 77, 77);"><b>Ron Van den Branden | functioneel analist - applicatiebeheerder Letterenhuis</b></span></p>
<p style="line-height: 13.75pt; background-color: white;"><span style="font-family: Arial, sans-serif; font-size: 9pt; color: rgb(77, 77, 77);">Stad Antwerpen | Talentontwikkeling en Vrijetijdsbeleving</span><span style="font-family: Arial, sans-serif; font-size: 9pt; color: black;"> </span><span style="font-family: Arial, sans-serif; font-size: 9pt; color: rgb(77, 77, 77);">|
Boeken en Letteren</span></p>
<p style="line-height: 13.75pt; background-color: white;"><span style="font-family: Arial, sans-serif; font-size: 9pt; color: rgb(77, 77, 77);">Minderbroedersstraat 22, 2000 Antwerpen</span></p>
<p style="background-color: white;"><span style="font-family: Arial, sans-serif; font-size: 9pt; color: rgb(77, 77, 77);">Grote Markt 1, 2000 Antwerpen</span></p>
<p style="background-color: white;"><span style="font-family: Arial, sans-serif; font-size: 9pt; color: rgb(77, 77, 77);">gsm +32 0485 02 80 50 | tel. +32 3 222 93 30</span></p>
<p style="line-height: 13.75pt; background-color: white;"><span style="font-family: Arial, sans-serif; font-size: 9pt; color: rgb(77, 77, 77);"><a href="http://www.letterenhuis.be/" id="OWA87c965e3-e3c5-230a-ff69-ea54627b3cb3" class="OWAAutoLink" data-auth="NotApplicable" style="margin-top: 0px; margin-bottom: 0px; color: rgb(77, 77, 77);">letterenhuis.be</a> |
<a href="https://www.instagram.com/letterenhuis/" id="OWAd937e800-d935-f3d2-4dda-7d4e5fee39d4" class="OWAAutoLink" data-auth="NotApplicable" style="margin-top: 0px; margin-bottom: 0px; color: rgb(77, 77, 77);">
instagram</a> | <a href="https://www.facebook.com/Letterenhuis" id="OWA8f883cf5-215c-d598-c940-37be44a0bb6b" class="OWAAutoLink" data-auth="NotApplicable" style="margin-top: 0px; margin-bottom: 0px; color: rgb(77, 77, 77);">
facebook</a></span></p>
<p style="line-height: 13.75pt; background-color: white;"><span style="font-family: Arial, sans-serif; font-size: 9pt; color: rgb(77, 77, 77);"> </span></p>
<p style="line-height: 13.75pt; background-color: white;"><span style="font-family: Arial, sans-serif; font-size: 7pt; color: rgb(77, 77, 77);"><b>Proclaimer</b></span></p>
<p style="line-height: 13.75pt; background-color: white;"><span style="font-family: Arial, sans-serif; font-size: 7pt; 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>
<p style="margin: 0in; font-family: Calibri, sans-serif; font-size: 11pt;"> </p>
</div>
</body>
</html>