Metadata Editor / support multilingual values in certain fields

[jahow]

Description

This PR introduces support for reading and writing multilingual values in various fields of a catalog record:

These fields are currently:

• title and abstract of a record
• name of an organization
• name and description on an online resource
• description of a geographical extent
• text of a constraint or license
• label of a keyword

The converters (both ISO and DCAT-AP) are now able to read and write translations alongside a field value.

Note: in the model, a record has a mandatory default language. Multilingual fields have a default value (in the default language). They can also have values in other languages, these values are called translations.

A record also have a field called otherLanguages which lists all languages in which translations have been found.

The Metadata Editor currently only modifies the default values of multilingual fields; this means that translations should not be impacted at all by the app for now.

This PR has the important effect that multilingual fields will not lose their translations if modified in the editor; the translations can not be edited but at least they are preserved.

Architectural changes

none

Quality Assurance Checklist

• Commit history is devoid of any merge commits and readable to facilitate reviews
• If new logic ⚙️ is introduced: unit tests were added
• If new user stories 🤏 are introduced: E2E tests were added
• If new UI components 🕹️ are introduced: corresponding stories in Storybook were created
• If breaking changes 🪚 are introduced: add the breaking change label
• If bugs 🐞 are fixed: add the backport <release branch> label
• The documentation website 📚 has received the love it deserves

[github-actions]

Affected libs: api-metadata-converter, api-repository, feature-catalog, feature-record, feature-router, feature-editor, feature-search, feature-map, feature-dataviz, feature-auth, ui-search, common-domain, common-fixtures, ui-elements, feature-notifications, ui-catalog, util-shared, ui-widgets, ui-inputs, ui-layout, ui-map, ui-dataviz, util-i18n, util-app-config,
Affected apps: datahub, metadata-converter, metadata-editor, demo, webcomponents, search, map-viewer, datafeeder, data-platform,

• 🚀 Build and deploy storybook and demo on GitHub Pages
• 📦 Build and push affected docker images

[github-actions]

📷 Screenshots are here!

[coveralls]

coverage: 83.434% (-0.2%) from 83.65%
when pulling e42e934 on converter-support-multilingual-translations-per-field
into 8237040 on main.

[jahow]

I have adjusted these fixtures to make them correct; there were typing errors that were hidden because of the cast to CatalogRecord below

[jahow]

readLocalizedValue is introduced in this PR and does two things:

• add any found translations to the translations object given to it
• return both the default value and the translations array as a tuple: [value, translations]

[jahow]

I took the opportunity to better document the datahub & editor apps!

[tkohr]

Thanks, @jahow, for the huge work and for reworking the doc! Not sure if I got everything, but as far as I can see PR LGTM.

[jahow]

@tkohr thank you for the review!!