Ajuda:Extensão: Translate/Importar Traduções via CSV

This page is a translated version of the page Help:Extension:Translate/Import Translations via CSV and the translation is 41% complete.

Documentação para Extensão: Translate

Tradutores (página da ajuda principal)

Administradores de tradução

Administradores de sistema e programadores

Traduzir este modelo

Esta página descreve a funcionalidade que permite aos tradutores submeterem as suas traduções via CSV para um administrador de sistema para este importá-las. T309517

Passos

Exportação de CSV

Primeiro, identifique a página que deseja submeter as traduções via CSV. Página exemplo: Linhas Diretrizes de Desenvolvimento

Go to Special:ExportTranslations and export that page in CSV format in the French (fr) language.

The CSV file exported will be in the following format:

Highlight 1 in image - Message definition in the source language
Highlight 2 in image - Translations in the exported language. French in this case

Adição de traduções para o CSV

O ficheiro exportado no passo anterior pode ser modificado para atualizar as traduções existentes ou adicionar mais traduções.

See the image below from the CSV file that has added a translation in Spanish (es), and some in Dutch (nl):

This file can then be given to the administrator to import the translations into the system.

Nota

As traduções em branco serão ignoradas. Translations will not actually be removed if a cell in the CSV is made empty.
If no modification is made to a translation no new entries will be added to the translation change history.

Importação de traduções via CSV

The file received from the translator can be imported via a command line script made available in the translate extension importTranslationsFromCsv.php:

The script expects the following parameters:

Path to the CSV file
--user - Name of the user performing the import
--summary - Edit summary to be used when updating the translations
--really - Actually perform the import. Without this a dry run will be carried out.

Exemplo de execução

First, a dry run to see what will be imported:

$ php extensions/Translate/scripts/importTranslationsFromCsv.php ~/Projects/html/mediawiki/groups/page-Development\ Guidelines_to_import.csv --user Admin --summary "Importing translations from CSV"

* 3 translation(s) to import for Translations:Development Guidelines/Page display title/en
* 2 translation(s) to import for Translations:Development Guidelines/1/en
* 2 translation(s) to import for Translations:Development Guidelines/2/en
* 2 translation(s) to import for Translations:Development Guidelines/3/en
* 2 translation(s) to import for Translations:Development Guidelines/4/en
* 2 translation(s) to import for Translations:Development Guidelines/5/en

Use option --really to perform the import.

Now perform the actual import:

$ php ./extensions/Translate/scripts/importTranslationsFromCsv.php ~/Projects/html/mediawiki/groups/page-Development\ Guidelines_to_import.csv --user Admin --summary "Importing translations from CSV" --really

* 3 translation(s) to import for Translations:Development Guidelines/Page display title/en
* 2 translation(s) to import for Translations:Development Guidelines/1/en
* 2 translation(s) to import for Translations:Development Guidelines/2/en
* 2 translation(s) to import for Translations:Development Guidelines/3/en
* 2 translation(s) to import for Translations:Development Guidelines/4/en
* 2 translation(s) to import for Translations:Development Guidelines/5/en

Proceeding with import...

(1/6) Imported translations for Translations:Development Guidelines/Page display title/en with 0 failure(s) and 3 successful import(s) ...
(2/6) Imported translations for Translations:Development Guidelines/1/en with 0 failure(s) and 2 successful import(s) ...
(3/6) Imported translations for Translations:Development Guidelines/2/en with 0 failure(s) and 2 successful import(s) ...
(4/6) Imported translations for Translations:Development Guidelines/3/en with 0 failure(s) and 2 successful import(s) ...
(5/6) Imported translations for Translations:Development Guidelines/4/en with 0 failure(s) and 2 successful import(s) ...
(6/6) Imported translations for Translations:Development Guidelines/5/en with 0 failure(s) and 2 successful import(s) ...

Success: Import done

You might have to flush the job queue in order to be able to see the translated pages immediately:

$ php maintenance/run.php runJobs