Adicionando um idioma

Preparação

If the language you want to translate has not been started by someone else already and you wish to create a set of new files for the desired language, say “fr” (French), then you must first use the environment you have created, as guided in Getting Started, in particular Instalando as dependências and Building the Manual sections.

This will give you a foundation environment for:

  • Criando um novo conjunto de tradução à partir do material em Inglês

  • Execute o comando ``make”” para transformar textos traduzidos em arquivos po, em arquivos html para testes locais.

  • Atualizar as mudanças nos textos em inglês que foram adicionados por outros colaboradores.

Os exemplos abaixo mostram o processo para criar um novo conjunto de arquivos para o francês, idioma de código fr, na plataforma Linux. Outras plataformas podem variar um pouco, mas devem ser basicamente as mesmas.

  1. Vá para https://developer.blender.org para criar uma conta e tornar-se um desenvolvedor/tradutor para a organização Blender.

  2. Entre na conta e crie uma tarefa do tipo to do, endereçado a um administrador no campo Subscribers, solicitando um direito de committer para transferir as alterações para o repositório central da equipa de tradução.

  3. Abra uma instância da aplicação de console, como o emulador Gnome-Terminal.

  4. Mude o diretório de trabalho atual para o diretório do ``blender_docs””, onde fica a instância do ``Makefile””.

Trying the Make Process to Create HTML Files in English

  1. Certifique-se de que a instância anterior do diretório ``build”” seja removida, se existir alguma:

    make clean
    
  2. Converte todos os arquivos rst em arquivos de tradução pot:

    make gettext
    
  3. Cria arquivos html`:

    make html
    
  4. Depois disso, você pode ver os arquivos html criados localmente seguindo as instruções solicitadas, como por exemplo:

    xdg-open <path to your English manual>/blender_docs/build/html/index.html
    

Criar a Entrada de Idioma no Menu HTML

  1. Crie uma entrada para o idioma no menu html abrindo o arquivo ./resources/theme/js/version_switch.js` (assumindo que você esteja no subdiretório blender_docs`).

  2. Encontre a table para os idiomas em var all_langs = {..};.

  3. Digite a entrada: "fr": "Fran&ccedil;ais",, ("fr": "Français"). (Repare nos caracteres Unicode).

  4. Para saber sobre as mudanças no repositório local:

    svn status
    
  5. Entre a senha:

    svn commit --username <your username> -m "your comment"
    
  6. Traga seu repositório local até a versão mais recente das mudanças, incluindo a que você acabou de fazer:

    svn update .
    

Configuração do arquivo de configuração local

  1. Abra um editor de texto para inserir os seguintes textos, altere o código do idioma para qualquer idioma que você esteja traduzindo:

    1language = 'fr'
    2locale_dirs = ['locale/']
    3gettext_compact = True
    
  2. Salve este arquivo como conf.py`` no diretório blender_docs, onde Makefile` reside.

  3. Fala ao svn` para ignorar este arquivo ao realizar operações executando este comando shell:

    svn propset svn:ignore conf.py .
    

Geração do conjunto de arquivos para a língua escolhida

  1. Confira o repositório de tradução atual usando o comando:

    svn checkout https://svn.blender.org/svnroot/bf-manual-translations/trunk/blender_docs/locale
    

    This will download all language sets available in the repository into the locale directory of your drive. You can go to the locale directory to see the hidden subdirectory .svn within it, together with directories of languages. You’ll need to add your own set of files for the language you are trying to translating to.

  2. A partir do diretório blender_docs para gerar um conjunto de arquivos para a linguagem fr:

    make gettext
    sphinx-intl update -p build/gettext -l fr
    

    Estes arquivos ainda estão apenas em inglês, com todas as entradas msgstr em branco.

  3. Submeter novo conjunto de arquivos ao repositório central:

    cd locale
    svn add fr
    svn commit --username <your username> -m "Initial commit language set of files for French"
    
  4. Você não precisa que todos os outros idiomas estejam lá, então remova o diretório locale por enquanto:

    rm -fr locale
    

    Faremos o download deste novo conjunto de idiomas como guia na próxima seção.

Nota

  • Recomenda-se fazer duas variáveis de ambiente para estes diretórios, no .bashrc`, para tornar mais conveniente para alterar ou scriptar comandos batch/shell para o processo de tradução e revisão:

    export BLENDER_MAN_EN=$HOME/<directory to make file directory above>/blender_docs
    export BLENDER_MAN_FR=$BLENDER_MAN_EN/locale
    
  • Arquivos recém-gerados conterão alguns marcadores de lugar para autores e datas de revisão, etc. Se você achar o trabalho de substituí-los repetitivos, faça uso do script change_placeholders.sh` no subdiretório ~/blender_docs/toos_maintenance`, faça uma cópia disso para seu diretório local bin e substitua todos os valores que foram mencionados no arquivo com seus detalhes específicos, então após cada alteração em um arquivo, você faria os seguintes comandos para atualizar o arquivo com seus detalhes pessoais, data e hora da revisão, além de gerar os arquivos html para seu idioma, que você pode visualizar utilizando seu navegador de Internet:

    $HOME/bin/change_placeholders.sh $BLENDER_MAN_FR
    make -d --trace -w -B -e SPHINXOPTS="-D language='fr'" 2>&1