https://github.com/strarsis/pannellum-translation

A central place for translated user-facing strings for the panorama viewer library called Pannellum.
https://github.com/strarsis/pannellum-translation

international pannellum pannellum-translation panorama strings

Last synced: 13 days ago
JSON representation

A central place for translated user-facing strings for the panorama viewer library called Pannellum.

• Host: GitHub
• URL: https://github.com/strarsis/pannellum-translation
• Owner: strarsis
• License: mit
• Created: 2017-09-28T17:05:34.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2022-07-24T22:44:21.000Z (over 2 years ago)
• Last Synced: 2024-10-30T07:49:25.865Z (21 days ago)
• Topics: international, pannellum, pannellum-translation, panorama, strings
• Size: 86.9 KB
• Stars: 11
• Watchers: 3
• Forks: 19
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# pannellum-translation

A central place for translated user-facing strings for the panorama viewer library called [Pannellum](https://github.com/mpetroff/pannellum).

[Pannellum](https://github.com/mpetroff/pannellum) includes english strings by default which can be overwritten to create a localized experience for the user/s.

The actual file names holding the strings should conform to the **[IETF language tags](https://www.venea.net/web/culture_code)** like so: `de.json` => `German`, sometimes you need more precision for some dialects e.g. German Swiss would be `de-CH.json`.

(Note: Previously [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1) and [3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) codes were used for naming the translation files, but for translation languages `IETF language tags` are better suited).

If you have a request for a translation, **only** open an issue **if it doesnt exist already!** Instead express your interest inside the existing issue.

## NPM

You can find the package [here](https://www.npmjs.com/package/pannellum-translation).

## If you want to contribute:

Check out the american english [`en-US.json`](https://github.com/DanielBiegler/pannellum-translation/blob/master/en-US.json) file to get an idea of how this works.

Note how there are substitutions `%s` e.g. `"The file %s could not be accessed."`!

1. Fork this repo.

2. Create a branch e.g. `add-german-translation`.

3. Create a JSON file with the correct **IETF language tag** e.g. `es.json`.

4. Translate the strings.

5. Make a pull request.

6. Now your changes will be reviewed by native speakers to ensure quality.

7. If the quality is acceptable, your translation will be merged. Thank you for contributing.