Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/quarkusio/es.quarkus.io
(incubating) Spanish localization project for https://github.com/quarkusio/quarkusio.github.io
https://github.com/quarkusio/es.quarkus.io
i18n internationalization localization translation translations
Last synced: about 1 month ago
JSON representation
(incubating) Spanish localization project for https://github.com/quarkusio/quarkusio.github.io
- Host: GitHub
- URL: https://github.com/quarkusio/es.quarkus.io
- Owner: quarkusio
- License: apache-2.0
- Created: 2022-04-22T13:06:26.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-13T09:09:58.000Z (7 months ago)
- Last Synced: 2024-04-13T23:52:52.209Z (7 months ago)
- Topics: i18n, internationalization, localization, translation, translations
- Language: HTML
- Homepage:
- Size: 442 MB
- Stars: 7
- Watchers: 4
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# es.quarkus.io
Spanish Localization project for [https://github.com/quarkusio/quarkusio.github.io](https://github.com/quarkusio/quarkusio.github.io) (The repository for [quarkus.io website](https://quarkus.io))
Localized site: [https://es.quarkus.io/](https://es.quarkus.io)
## Localization architecture
Original [quarkusio.github.io](https://github.com/quarkusio/quarkusio.github.io) is built with Jekyll,
and most of its contents are written in asciidoctor (.adoc) files.
es-quarkusio extracts texts to po files with [po4a](https://po4a.org/) utility, translates,
write back to asciidoctor files, and build a localized site.
Most workflow including pre-translation by DeepL API are automated by GitHub Actions.
Translators can focus on post-editing to improve fluency.
If you are interested in contributing localization, please edit .po files, and submit a pull request.
### .adoc files localization
#### sync workflow
es-quarkusio GitHub repository has a GitHub Actions workflow which checks upstream repository(submodule) update,
extracts texts from upstream .adoc files to [.adoc.po files](l10n/po), pre-translate with a translation memory
and the DeepL API.
#### Translating .po files
.po files in [l10n/po](l10n/po) directory need to be translated.
.po file is a file format commonly used for software internationalization, and many CAT software and SaaS can read/write.
[POEdit](https://poedit.net/), which run on Windows/Mac/Linux is a good candidate.
Since .po files are pre-filled with machine translation with "fuzzy" mark,
please remove "fuzzy" mark and correct inappropriate sentences if needed.
#### Build a localized site
When you send a pull-request, GitHub Actions workflow automatically apply translations in .po files to .adoc files,
build a localized site and deploy it to surge.sh with preview domain. When the deploy finish, GitHub Actions comment
the URL to the pull-request. Reviewers can check the deployed site for review.
When the pull-request is merged into `master`, it is automatically deployed to the production site (https://es.quarkus.io).
#### Build a localized site locally
If you would like to build a site locally, run:
```
bin/apply-translation
bin/exec-jekyll
```
The site is build in `doc` directory.
### HTML templates localization
Most contents of [quarkus.io](https://quarkus.io) are in .adoc files, but a few texts are in its HTML templates.
Since HTML templates cannot be parsed with [po4a](https://po4a.org/) utility, this localization project repository has their
localized copies in the [l10n/override](l10n/override) directory. When the templates in the upstream repository are
updated, GitHub Actions workflow automatically create a issue to let you know.
Please refer the [l10n/stats/override.csv](l10n/stats/override.csv) to check which files are updated, and update the override files
to keep it up to date.
## FAQ
### Some guides or blog posts are not translated.
These articles are not translated, but don't worry. Machine-translation is available in the corresponding .adoc.po file.
We'll appreciate if you post-edit the .adoc.po files to polish up, remove "fuzzy" mark, and send a pull-request.
### Some sentences are not translated in the translated articles
It seems corresponding upstream sentences are updated, and completed translations are not available.
We'll appreciate if you post-edit the corresponding .adoc.po files to polish up, remove "fuzzy" mark, and send a pull-request.
## Contributing
Submitting a pull request, and reporting an issue are all welcome.
For translators, we have a [translation guide(es)](./translation-guide.es.md).
## License
es-quarkusio is Open Source Project released under the
[Apache 2.0 license](http://www.apache.org/licenses/LICENSE-2.0.html).