Multilingual schema labels and presentation sections #86

Open
opened 2026-10-01 15:18:44 +00:00 by scossu · 0 comments
Owner

In order to effectively create multilingual archives and presentations, the modeling framework must support multilingual labels and descriptions for types and properties.

This may be best done by supporting an explicit configuration section that indicates all supported languages of an instance. Also, all schema definitions in both core and user-defined schemata should account for multiple values for the label and description of types and properties.

When multiple languages are set, the presentation generator should also generate multiple sets of HTML pages in different languages. These should be separated by a top-level folder, e.g.: /en_US/index.html, ar_PS/index.html.

Multilingual metadata labels and descriptions are different from multilingual values (already supported), but loosely related to one another. For example, if an archive is set up for English and Arabic, and a field has values in both languages, the presentation should display all labels, putting the one(s) matching the current language first. If a field is missing values in the requested language (which may be normal, e.g. for an inscription), the first available language is displayed.

Submission should not be affected significantly, as the property labels are not used in the LL, and multilingual values are already supported. One exception to this is support for multilingual file references used in presentation, such as pres_content, which are of resource type and as such don't currently support the lang tag. The presentation generator should use the same language election logic to parse the most appropriate file for the selected language.

This ticket is split into different sub-tasks, that should be deployed as one new feature:

  • Add languages section in configuration
    • Add list of supported languages
    • Set multilingual entries for configuration fields such as site title
  • Restructure schema configurations to accommodate multilingual labels and descriptions for types and properties
  • Generate multilingual pages for presentation
  • Support multilingual resource values in LL
In order to effectively create multilingual archives and presentations, the modeling framework must support multilingual labels and descriptions for types and properties. This may be best done by supporting an explicit configuration section that indicates all supported languages of an instance. Also, all schema definitions in both core and user-defined schemata should account for multiple values for the label and description of types and properties. When multiple languages are set, the presentation generator should also generate multiple sets of HTML pages in different languages. These should be separated by a top-level folder, e.g.: `/en_US/index.html`, `ar_PS/index.html`. Multilingual metadata labels and descriptions are different from multilingual values (already supported), but loosely related to one another. For example, if an archive is set up for English and Arabic, and a field has values in both languages, the presentation should display all labels, putting the one(s) matching the current language first. If a field is missing values in the requested language (which may be normal, e.g. for an inscription), the first available language is displayed. Submission should not be affected significantly, as the property labels are not used in the LL, and multilingual values are already supported. One exception to this is support for multilingual file references used in presentation, such as `pres_content`, which are of `resource` type and as such don't currently support the lang tag. The presentation generator should use the same language election logic to parse the most appropriate file for the selected language. This ticket is split into different sub-tasks, that should be deployed as one new feature: - [ ] Add languages section in configuration - [ ] Add list of supported languages - [ ] Set multilingual entries for configuration fields such as site title - [ ] Restructure schema configurations to accommodate multilingual labels and descriptions for types and properties - [ ] Generate multilingual pages for presentation - [ ] Support multilingual resource values in LL
scossu added this to the v1.1.0 milestone 2026-10-01 15:18:44 +00:00
scossu added
p
high
and removed
p
normal
labels 2026-10-08 14:22:02 +00:00
Sign in to join this conversation.
No milestone
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
ktx/pocket_archive#86
No description provided.