Supõe-se que o procedimento mostrado em Seção 1.1, “Quick Start” já tenha sido executado. A opção TRANSLATOR
é necessária e já está ativada por padrão no port textproc/docproj.
Este exemplo mostra a criação de uma tradução em Espanhol do pequeno artigo Leap Seconds.
É necessário um editor PO para editar os arquivos de tradução. Este exemplo utiliza o editors/poedit.
#
cd /usr/ports/editors/poedit
#
make install clean
Quando uma nova tradução é criada pela primeira vez, a estrutura do diretório e o Makefile
devem ser criados ou copiados do original em Inglês:
Crie um diretório para a nova tradução. O código fonte do artigo em Inglês está em ~/doc/en_US.ISO8859-1/articles/leap-seconds/
. A tradução em Espanhol estará em ~/doc/es_ES.ISO8859-1/articles/leap-seconds/
. O caminho é o mesmo, exceto pelo nome do diretório de idiomas.
%
svn mkdir --parents ~/doc/es_ES.ISO8859-1/articles/leap-seconds/
Copie o Makefile
do documento original para o diretório de tradução:
%
svn cp ~/doc/en_US.ISO8859-1/articles/leap-seconds/Makefile \ ~/doc/es_ES.ISO8859-1/articles/leap-seconds/
A tradução de um documento consiste em duas etapas: extrair strings traduzíveis do documento original e inserir as traduções dessas strings. Essas etapas são repetidas até que o tradutor sinta que o documento foi traduzido o suficiente para produzir um documento traduzido que seja utilizável.
Extraia as strings traduzíveis da versão original em Inglês para um arquivo PO:
%
cd ~/doc/es_ES.ISO8859-1/articles/leap-seconds/
%
make po
Use um editor PO para inserir as traduções no arquivo PO. Existem vários editores diferentes disponíveis. O poedit
do editors/poedit é mostrado aqui.
O nome do arquivo PO é o código de idioma de dois caracteres seguido por um código de região de também dois caracteres, seprados por um underline. Para espanhol, o nome do arquivo é es_ES.po
.
%
poedit es_ES.po
Gere o documento traduzido:
%
cd ~/doc/es_ES.ISO8859-1/articles/leap-seconds/
%
make tran
O nome do documento gerado corresponde ao nome do original em Inglês, geralmente article.xml
para artigos ou book.xml
para livros.
Verifique o arquivo gerado renderizando-o para HTML e exibindo-o com um navegador web:
%
make FORMATS=html
%
firefox article.html
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>.