Localization project for 3scale.github.io (The repository for 3scale.github.io website)
Localized site: https://ja-3scale.surge.sh/
Original 3scale.github.io is built with Jekyll, and its contents are written in asciidoctor (.adoc) files. ja-3scale 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-3scale extracts texts with po4a-updatepo utility from .adoc files to .adoc.po files, which saved in in l10n/po directory. ja-3scale GitHub repository has a GitHub Actions' periodic workflow to extract texts from .adoc files stored in upstream submodule, which points 3scale.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-3scale is Open Source Project released under the Apache 2.0 license.