mirror of
https://github.com/godotengine/godot-docs-l10n.git
synced 2025-12-31 09:49:22 +03:00
d70fd1ff0e
As discussed with translators, it's more time-efficient to focus on the "international" Spanish translation (`es`) and bring it near 100% completion before branching it off for regional variants. (So `es_MX` can be re-added copied from the near-complete `es` and edited, instead of starting from scratch.) Similarly for `pt_PT`, where focus should be put on finalizing the `pt_BR` translation before branching it off and adapting it to the European variant. (The current `pt_PT` translation was actually forked from `pt_BR` already when it was around 25% complete, then did not see much further work.)
Localization of Godot Engine documentation
This repository contains the localization templates and catalogs for the official documentation of the [Godot Engine project.
The source strings are extracted by sphinx-gettext from the godot-docs repository.
The translations are contributed through Hosted Weblate and synced manually in this repository.
How to
This repository is meant to be used by Godot Engine documentation maintainers, here's the workflow for reference:
Pull from Hosted Weblate
- Commit all pending translations
- Lock the repository
- Pull translations locally in a clone of the Weblate working repository
- Run
list-authors.sh <commit hash>to list all new authors - Add them to the header of their respective
weblate/*.pofiles
Commit to "production" repo
- Copy
weblate/*.pofiles from Weblate working repository - Run
update.sh -woto format Weblate .po files as expected by the script, commit - Pull
docssubmodule, updatetemplates_list.txtif there are any changes in the table of contents (new/removed/moved pages) - Run
update.sh -stto update Sphinx templates, commit - Run
update.sh -wtto update the Weblate monolithic template based on Sphinx ones, commit - Run
update.sh -woto merge Weblate .po files with the updated template, commit - If any new locale has reached a satisfactory completion level, add it to
build_langs.txt - Run
update.sh -soto extract Sphinx per-page .po files from the monolithic Weblate .po files (slow process), commit - Push to GitHub
Unlock Hosted Weblate
- Reset Weblate repo to updated production repo (slow process)
- Unlock the repository
License
All the translation content of this repository (msgid, msgstr) is
licensed under the Creative Commons Attribution 3.0 Unported license
(CC BY 3.0) and is to be
attributed to "Juan Linietsky, Ariel Manzur and the Godot community".
See LICENSE.txt for details.
The shell scripts are in the public domain.