{"id":18646349,"url":"https://github.com/dspace/dspace-api-lang","last_synced_at":"2025-04-05T08:08:16.800Z","repository":{"id":2727547,"uuid":"3722605","full_name":"DSpace/dspace-api-lang","owner":"DSpace","description":"API Language Packs (Multilingual Support / I18N)","archived":false,"fork":false,"pushed_at":"2025-02-07T16:04:03.000Z","size":2582,"stargazers_count":17,"open_issues_count":1,"forks_count":49,"subscribers_count":28,"default_branch":"main","last_synced_at":"2025-03-29T07:08:36.129Z","etag":null,"topics":["dspace","i18n","internationalization","language-packs"],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DSpace.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-03-14T21:32:41.000Z","updated_at":"2025-02-07T16:04:07.000Z","dependencies_parsed_at":"2024-04-05T20:30:35.233Z","dependency_job_id":"43c08b22-dbff-43df-aa5d-99dd4c676cca","html_url":"https://github.com/DSpace/dspace-api-lang","commit_stats":null,"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DSpace%2Fdspace-api-lang","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DSpace%2Fdspace-api-lang/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DSpace%2Fdspace-api-lang/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DSpace%2Fdspace-api-lang/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DSpace","download_url":"https://codeload.github.com/DSpace/dspace-api-lang/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247305935,"owners_count":20917208,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dspace","i18n","internationalization","language-packs"],"created_at":"2024-11-07T06:19:24.239Z","updated_at":"2025-04-05T08:08:16.780Z","avatar_url":"https://github.com/DSpace.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# DSpace API Language Packs\n\nThis project is for language packs for the dspace-api in https://github.com/DSpace/DSpace.\n* `main` branch = 7.x Java API language packs (for backend only)\n* `dspace-6_x` branch = 6.x (and below) API \u0026 JSPUI language packs\n\n## Layout of the source tree\n\nThe `Messages.properties` files for each language are stored in the `src/main/resources` directory.\n\nThe file naming conventions are as follows:\n\n`Messages_\u003cISO 639-1\u003e_\u003cISO 3166-1\u003e.properties`\n\n* `ISO 639-1`: language code, in lower case.\n* `ISO 3166-1`: codes for country, if required.  For example:\n\nFor example:\n* `src/main/resources/``\n    * `Messages.properties` - file for default (English)\n    * `Messages_el.properties` - file for Greek\n    * `Messages_fr_FR.properties` - file for French (France)\n    * `Messages_fr_CA.properties` - file for French (Canada)\n\n\nFor languages that can be fully represented using the Latin-1 character set, the appropriate Messages.properties file is placed in the relevant\ndirectory:\n\n`src/main/resources/Messages_it.properties`\n\nFor languages that require other encodings, they are stored in this tree in\ntheir native encoding for ease of editing, patching and so forth.  The\nfilename extension representing the encoding, for example:\n\n`src/main/resources/Messages_el.properties.UTF-8`\n\nThe Maven build process supports `native2ascii` conversion on packaging of the UTF-8 files prior to packaging the jar.\n\n## Release tags\n\nLanguage packs are versioned according to the main DSpace version, but also include an incrementing `sequence-number` which allows language packs to be updated more frequently than DSpace releases.\n\nSo, DSpace software releases are of the format: `[major].[minor]` (e.g. 4.0, 4.1, 5.0, 5.1, etc.)\n\nWhereas, DSpace language packs use the format: `[major].[minor].[sequence-number]` (e.g. 5.0.0, 5.0.1, 5.0.2 for 5.0 releases of the language packs).\n\nLanguage packs are automatically installed into DSpace via Maven dependencies. In the case of the API and JSPUI language packs, they are installed as a JAR (e.g. `dspace-api-lang-[version].jar`) dependency.\n\n## Other tools\n\n### checkkey.pl\n\nThis is a handy Perl tool for determining which message keys are present in one properties file versus another.  This is useful for determining whether a translation is complete.  If you run:\n\n`checkkeys.pl Messages.properties Messages_fr.properties`\n\nthe tool will tell you which keys are missing from `Messages_fr.properties`, and which (if any) are in `Messages_fr.properties` but not in the core `Messages.properties`.\n\nIn a complete translation for a particular version, there should be no missing or extra keys.\n\n## Documentation\n\nAdditional documentation on language packs and I18N (internationalization) may be found at [Internationalization Support](https://wiki.lyrasis.org/pages/viewpage.action?pageId=19006307)\n\nDocumentation for each release may be viewed online or downloaded via our [Documentation Wiki](https://wiki.lyrasis.org/display/DSDOC/).\n\n## Contributing\n\nDSpace is a community built and supported project. We do not have a centralized development or support team,\nbut have a dedicated group of volunteers who help us improve the software, documentation, resources, etc.\n\nWe welcome contributions of any type. Here's a few basic guides that provide suggestions for contributing to DSpace:\n* [How to Contribute to DSpace](https://wiki.lyrasis.org/display/DSPACE/How+to+Contribute+to+DSpace): How to contribute in general (via code, documentation, bug reports, expertise, etc)\n* [Code Contribution Guidelines](https://wiki.lyrasis.org/display/DSPACE/Code+Contribution+Guidelines): How to give back code or contribute features, bug fixes, etc.\n* [DSpace Community Advisory Team (DCAT)](https://wiki.lyrasis.org/display/cmtygp/DSpace+Community+Advisory+Team): If you are not a developer, we also have an interest group specifically for repository managers. The DCAT group meets virtually, once a month, and sends open invitations to join their meetings via the [DCAT mailing list](https://groups.google.com/d/forum/DSpaceCommunityAdvisoryTeam).\n\nWe also encourage GitHub Pull Requests (PRs) at any time. Please see our [Development with Git](https://wiki.lyrasis.org/display/DSPACE/Development+with+Git) guide for more info.\n\nIn addition, a listing of all known contributors to DSpace software can be\nfound online at: https://wiki.lyrasis.org/display/DSPACE/DSpaceContributors\n\n## Getting Help\n\nDSpace provides public mailing lists where you can post questions or raise topics for discussion.\nWe welcome everyone to participate in these lists:\n\n* [dspace-community@googlegroups.com](https://groups.google.com/d/forum/dspace-community) : General discussion about DSpace platform, announcements, sharing of best practices\n* [dspace-tech@googlegroups.com](https://groups.google.com/d/forum/dspace-tech) : Technical support mailing list. See also our guide for [How to troubleshoot an error](https://wiki.lyrasis.org/display/DSPACE/Troubleshoot+an+error).\n* [dspace-devel@googlegroups.com](https://groups.google.com/d/forum/dspace-devel) : Developers / Development mailing list\n\nAdditional support options are listed at https://wiki.lyrasis.org/display/DSPACE/Support\n\nDSpace also has an active service provider network. If you'd rather hire a service provider to\ninstall, upgrade, customize or host DSpace, then we recommend getting in touch with one of our\n[Registered Service Providers](http://www.dspace.org/service-providers).\n\n## Issue Tracker\n\nUse [GitHub Issues](https://github.com/DSpace/dspace-api-lang/issues) in this project.\n\n## License\n\nDSpace source code is freely available under a standard [BSD 3-Clause license](https://opensource.org/licenses/BSD-3-Clause).\nThe full license is available at http://www.dspace.org/license/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdspace%2Fdspace-api-lang","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdspace%2Fdspace-api-lang","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdspace%2Fdspace-api-lang/lists"}