Localization project for infinispan.github.io (The repository for infinispan.org website)
Localized site: https://ja-infinispan.surge.sh/
Original infinispan.github.io is built with Jekyll, and its contents are written in asciidoctor (.adoc) files. ja-infinispanorg extracts texts with po4a utility, machine-translates with deepL, write back, and build a localized site. Most workflow are automated by GitHub Actions except manual post-editing(translation). If you are interested in contributing localization, please translate .po files, and submit a pull request.
All you need for your local environment is a CAT Tool like POEdit, which run on Win/Mac/Linux.
ja-infinispanorg extracts texts with po4a-updatepo utility from .adoc files to .adoc.po files, which saved in in l10n/po directory. ja-infinispan GitHub repository has a GitHub Actions' periodic workflow to extract texts from .adoc files stored in upstream submodule, which points infinispan.github.io repository.
.po files in 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. While generating .po files, texts are pre-filled with translation memory and machine translation. Please correct inappropriate sentences if needed.
Now you are ready to apply translated texts to .adoc files. With the command below, translated source tree are formed in translated directory.
bin/apply-translation
You can build a translated site from translated directory with:
bin/exec-jekyll
Submitting a pull request, and reporting an issue are all welcome.
For translators, we have a translation guide(ja).
ja-infinispanorg is Open Source Project released under the Apache 2.0 license.