12.7. Submetendo a Nova Tradução

Prepare os novos arquivos de tradução para envio. Isso inclui adicionar os arquivos ao sistema de controle de versão, definir propriedades adicionais e criar um diff para a submissão.

Os arquivos diff criados por esses exemplos podem ser anexados a um relatório de bug de documentação ou revisão de código.

Exemplo 12.6. Tradução Espanhola do Artigo NanoBSD
  1. Adicione a string FreeBSD na primeira linha do arquivo PO:

    #$FreeBSD: head/pt_BR.ISO8859-1/books/fdp-primer/book.xml 53622 2019-11-21 22:50:11Z dbaio $
  2. Adicione o Makefile, o arquivo PO e o arquivo traduzido XML que foi gerado para o controle de versão:

    % cd ~/doc/es_ES.ISO8859-1/articles/nanobsd/
    % ls
    Makefile	article.xml	es_ES.po
    % svn add Makefile article.xml es_ES.po
    A         Makefile
    A         article.xml
    A         es_ES.po
  3. Configure as propriedades Subversion svn:keywords nesses arquivos para FreeBSD=%H para que as strings $FreeBSD: head/pt_BR.ISO8859-1/books/fdp-primer/book.xml 53622 2019-11-21 22:50:11Z dbaio $ sejam expandidas com o caminho, revisão, data e autor quando o arquivo sofrer o commit:

    % svn propset svn:keywords FreeBSD=%H Makefile article.xml es_ES.po
    property 'svn:keywords' set on 'Makefile'
    property 'svn:keywords' set on 'article.xml'
    property 'svn:keywords' set on 'es_ES.po'
  4. Defina os tipos MIME dos arquivos. Estes são text/xml para livros e artigos, e text/x-gettext-translation para o arquivo PO.

    % svn propset svn:mime-type text/x-gettext-translation es_ES.po
    property 'svn:mime-type' set on 'es_ES.po'
    % svn propset svn:mime-type text/xml article.xml
    property 'svn:mime-type' set on 'article.xml'
  5. Crie um diff dos novos arquivos a partir do diretório base ~/doc/ para que o caminho completo seja mostrado com os nomes dos arquivos. Isso ajuda os committers a identificar o diretório do idioma de destino.

    % cd ~/doc
    svn diff es_ES.ISO8859-1/articles/nanobsd/ > /tmp/es_nanobsd.diff

Exemplo 12.7. Tradução Coreana UTF-8 do Artigo Explicando o BSD
  1. Adicione a string FreeBSD na primeira linha do arquivo PO:

    #$FreeBSD: head/pt_BR.ISO8859-1/books/fdp-primer/book.xml 53622 2019-11-21 22:50:11Z dbaio $
  2. Adicione o Makefile, o arquivo PO e o arquivo traduzido XML que foi gerado para o controle de versão:

    % cd ~/doc/ko_KR.UTF-8/articles/explaining-bsd/
    % ls
    Makefile	article.xml	ko_KR.po
    % svn add Makefile article.xml ko_KR.po
    A         Makefile
    A         article.xml
    A         ko_KR.po
  3. Configure as propriedades Subversion svn:keywords nesses arquivos para FreeBSD=%H para que as strings $FreeBSD: head/pt_BR.ISO8859-1/books/fdp-primer/book.xml 53622 2019-11-21 22:50:11Z dbaio $ sejam expandidas com o caminho, revisão, data e autor quando o arquivo sofrer o commit:

    % svn propset svn:keywords FreeBSD=%H Makefile article.xml ko_KR.po
    property 'svn:keywords' set on 'Makefile'
    property 'svn:keywords' set on 'article.xml'
    property 'svn:keywords' set on 'ko_KR.po'
  4. Defina os tipos MIME dos arquivos. Como esses arquivos usam o conjunto de caracteres UTF-8, isso também é especificado. Para evitar que o sistema de controle de versão confunda esses arquivos com arquivos binários, a propriedade fbsd:notbinary também é configurada:

    % svn propset svn:mime-type 'text/x-gettext-translation; charset=UTF-8' ko_KR.po
    property 'svn:mime-type' set on 'ko_KR.po'
    % svn propset fbsd:notbinary yes ko_KR.po
    property 'fbsd:notbinary' set on 'ko_KR.po'
    % svn propset svn:mime-type 'text/xml; charset=UTF-8' article.xml
    property 'svn:mime-type' set on 'article.xml'
    % svn propset fbsd:notbinary yes article.xml
    property 'fbsd:notbinary' set on 'article.xml'
  5. Crie um diff desses novos arquivos no diretório base ~/doc/:

    % cd ~/doc
    svn diff ko_KR.UTF-8/articles/explaining-bsd > /tmp/ko-explaining.diff

All FreeBSD documents are available for download at https://download.freebsd.org/ftp/doc/

Questions that are not answered by the documentation may be sent to <freebsd-questions@FreeBSD.org>.
Send questions about this document to <freebsd-doc@FreeBSD.org>.