Příručka:generateJsonI18n.php

Soubor MediaWiki: generateJsonI18n.php
Lokalita:	maintenance/
Zdrojový kód:	master • 1.44.2 • 1.43.5 • 1.39.15
Třídy:	GenerateJsonI18n

Podrobnosti

Verze MediaWiki:

≥ 1.23 Gerrit change 102171

generateJsonI18n.php file is a maintenance script to generate JSON-formatted i18n files from legacy PHP array-based MediaWiki i18n files.

Použití

php maintenance/run.php generateJsonI18n phpfile jsondir

where:

• phpfile - PHP file defining a $messages array. Required unless --extension is provided.
• jsondir - directory to write the JSON files to. Will default to $phpfile/i18n.

Script dependent parameters

Option/Parameter	Description
--langcode="lang"	Language code; only needed for converting core i18n files.
--extension	1.24 Perform default conversion on an extension. If you use this parameter, don't specify the phpfile argument. It will make phpfile be set as "$IP/extensions/$extension/$extension.i18n.php", and targetfolder will be set to i18n
--shim-only	Only create or update the backward-compatibility shim
--supplementary	Find supplementary i18n files in subdirs and convert those

Example

cd core/extensions/YourExtension
mkdir i18n
php ../../maintenance/run.php generateJsonI18n ExtensionName.i18n.php i18n

Verze MediaWiki:

≥ 1.24 Gerrit change 122659

Alternate way for extensions, since Gerrit change 122659: This example performs the default conversions in $IP/extensions/WikiLove/, replacing the WikiLove.i18n.php file with a backwards-compatibility shim and porting messages to the WikiLove/i18n/ directory.

php maintenance/run.php generateJsonI18n --extension WikiLove

Suggested migration process

If your extension has not been converted already:

• Make sure you have the latest code

• Create the i18n directory

• Run the script

• Update your extension's entry file to add $wgMessagesDirs ['YourExtension'] = __DIR__ . '/i18n';

• Commit it to Gerrit if the extension is hosted there

• Add Siebrand and Raimond as reviewers if the extension is translated in translatewiki.net

• Wait for review and all should go smoothly

See also

• Requests for comment/Localisation format for background