Инфраструктура перевода вики
The Mudlet Wiki uses a set of extensions to enable translation of the wiki contents. The MediaWiki Language Extension Bundle provides all the tools needed to make translations directly on the wiki. However, Mudlet makes use of Crowdin to translate texts throughout the Mudlet project. This page describes the infrastructure that was built to enable translations from Crowdin.
Как это работает
Проще говоря, каждый день в 1:00 UTC на сервере mudlet.org выполняются некоторые задачи по импорту переводов из Crowdin и экспорту существующих источников из Wiki. Источники извлекаются из английской версии любой страницы, готовой к переводу. Исходные тексты загружаются после завершения импорта переводов.
Переводы могут быть сделаны только после загрузки источника, поэтому этот метод может вызвать задержку.
Переводы могут быть сделаны на вики. Источники и переводы могут быть вручную экспортированы из вики, используя либо страницу Export Translations, либо используя веб-инструмент, описанный в разделе "Форсирование обновлений".
Sources and Translations can be uploaded to Crowdin manually, provided they are exported from the wiki using the "Export for off-line translation" option.
Do note, some page titles contain colon : characters and those must be replaced with equals sign = characters before uploading to Crowdin!
All the scripts required can be located in /var/www/i18n/ and /var/www/wiki/ on the server. The update task is scheduled via the service user's crontab.
How to Use
To enable a page for translations, a wiki admin or moderator first needs to Prepare for Translation the desired page(s). The preparation adds some initial markup to review and help them get started.
Once a page is prepared, they can edit the Translation Markup to better suit translation needs, or prune out Wikitext for translators where possible.
After the page is prepared and the Translate Markup is finished, the pages must be Marked for Translation which will list off "translation units" the page created based on its Translate Markup. Be sure to enable translation of the page display title if it is not already enabled!
With a page properly marked for translation, the imports, exports, and translations can begin.
Extensive changes to a page may require it to be marked for translation again, to help keep translation units manageable for translators.
Forcing Updates
Wiki Translations and Crowdin Sources can be updated manually by using the Wiki Translations update tool found at https://make.mudlet.org/wiki-translations.php
You can pass the following URL Parameters to force specific updates:
update=all-- Forces both import and export, the same actions as the daily task.update=wiki-- Forces download and import of translations from Crowdin to the Wiki.update=crowdin-- Forces export and upload of English source-texts from Wiki to Crowdin.
(links aren't added here so bots don't 'click' them)
Manual updates can only be run once within 15 minutes, regardless of the triggered task.