Jump to content

Ajuda:Extensão:Traduzir/Importar traduções via CSV

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

Esta página descreve o recurso que permite que os tradutores enviem suas traduções via CSV para um administrador do sistema e depois as importem. T309517

Etapas

Exportando o CSV

Primeiro, identifique a página para a qual você deseja enviar traduções via CSV. Página de exemplo: Diretrizes de desenvolvimento.

Vá para Special:ExportTranslations e exporte essa página no formato CSV no idioma francês (fr).

O arquivo CSV exportado terá o seguinte formato:

  • Destaque 1 na imagem - Definição da mensagem no idioma de origem
  • Destaque 2 na imagem - Traduções no idioma exportado. Neste caso, francês

Adicionar traduções ao CSV

O arquivo exportado na etapa anterior pode ser modificado para atualizar as traduções existentes ou adicionar mais traduções.

Veja a imagem abaixo do arquivo CSV que adicionou uma tradução em espanhol (es) e algumas em holandês (nl):

Esse arquivo pode então ser fornecido ao administrador para importar as traduções para o sistema.

Nota

  • As traduções vazias serão ignoradas. As traduções não serão realmente removidas se uma célula do CSV ficar vazia.
  • Se nenhuma modificação for feita em uma tradução, nenhuma nova entrada será adicionada ao histórico de alterações da tradução.

Importar traduções via CSV

O arquivo recebido do tradutor pode ser importado por meio de um script de linha de comando disponível na extensão translate importTranslationsFromCsv.php:

O script espera os seguintes parâmetros:

  • Caminho para o arquivo CSV
  • --user – Nome do usuário que está realizando a importação
  • --summary – Editar resumo a ser usado ao atualizar as traduções
  • --really – Realizar de fato a importação. Sem isso, será realizada uma simulação.

Exemplo de execução

Primeiro, um teste para ver o que será importado:

$ 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.

Agora, execute a importação real:

$ 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

Talvez seja necessário liberar a fila de tarefas para que você possa ver as páginas traduzidas imediatamente:

$ php maintenance/run.php runJobs