doc:translations:pt_br

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Last revisionBoth sides next revision
doc:translations:pt_br [2016/04/11 03:18] – aedoc:translations:pt_br [2016/04/18 21:38] – created rogeriopradoj
Line 1: Line 1:
-====== This page contens is being MOVED to https://github.com/phpdocbrbridge/traducao/wiki ====== +All the information has been moved to [[https://github.com/phpdocbrbridge/traducao/wiki]].
- +
- +
-====== Apêndices ====== +
- +
-===== Translation Fest 2014 ===== +
- +
-=== Canais de comunicação === +
- +
-  * Canal IRC irc.freenode.net/phpdocbr (com interface web em [[https://webchat.freenode.net/?channels=phpdocbr|https://webchat.freenode.net/?channels=phpdocbr]]) +
-  * Sala no Gitter em [[https://gitter.im/phptranslationfestbrasil/chat]]  +
-  * Trello disponível em [[https://trello.com/b/j6Nuulpn/lista-de-tarefas-traducao-pt-br]]. +
- +
-Os últimos dois são específicos do esforço de tradução do Translation Fest, e o primeiro não costuma ter movimento ou pessoas online. Acaba que a lista de email oficial é o caminho para falar da tradução. +
- +
-=== Dependências para ambiente completo === +
- +
-  * git +
-  * subversion +
-  * php5-cli +
-  * php-pear +
-  * php5-sqlite +
-  * phd +
- +
-Quase tudo você instala via apt-get/yum/brew, exceto o phd. O phd pode ser instalado facilmente assim: +
- +
-<code> +
-git clone git@github.com:php/phd.git +
-cd phd +
-sudo pear install package.xml package_generic.xml package_php.xml +
-</code> +
- +
-=== Ambientes prontos === +
- +
-Você pode utilizar uma máquina virtual com as dependências já instaladas. Para isso, siga os próximos passos. +
- +
-== Baixar e instalar o Oracle Virtual Box == +
- +
-Utilize a página abaixo para instalar o Virtual Box na sua máquina. +
- +
-https://www.virtualbox.org/wiki/Downloads +
- +
-== Máquinas virtuais prontas == +
- +
-Baixe a máquina virtual de sua preferência nos endereços abaixo. +
- +
-= Máquina Virtual Ubuntu 14.04 32bits (3,8Gb) = +
- +
-  * **md5sum** 83c4947594ebdae38dc4ec515eef94c7 +
-  * **Usuário** root **Senha** translationfest +
-  * https://drive.google.com/file/d/0BzJtYovThzl_ZEdlTVVvQXpWR2c/view?usp=sharing +
- +
-Nessa maquina ainda é preciso instalar o package_php antes de compilar o manual, você pode fazer isso da seguinte forma: +
- +
-<code> +
-cd ~/translation_fest/phd +
-sudo pear install package_php.xml +
-</code> +
- +
-= Máquina Virtual xUbuntu 14.04 64bits (1,6Gb) = +
- +
-  * **md5sum** ad167d8953a36996d14f422f2942538f +
-  * **Usuário** xubuntu **Senha** reverse +
-  * **Usuário** root **Senha** reverse +
-  * https://dl.dropboxusercontent.com/u/3528005/xUbuntu64.7z +
- +
-Nessa maquina ainda é preciso instalar o package_php antes de compilar o manual, você pode fazer isso da seguinte forma: +
- +
-<code> +
-cd ~/translation_fest/phd +
-sudo pear install package_php.xml +
-</code> +
- +
-= Máquina Virtual xUbuntu 14.04 32bits (2,0Gb) = +
- +
-  * **md5sum** 494e45601657efe973d1b1f19853b4f9 +
-  * **Usuário** xubuntu **Senha** reverse +
-  * **Usuário** root **Senha** reverse +
-  * https://drive.google.com/file/d/0BxhT5kE991U5VmdCRHlDbHd4LTQ/view?usp=sharing +
- +
-Nessa maquina ainda é preciso instalar o package_php antes de compilar o manual, você pode fazer isso da seguinte forma: +
- +
-<code> +
-cd ~/translation_fest/phd +
-sudo pear install package_php.xml +
-</code> +
- +
-= Máquina Virtual centOS 7 64bits (740Mb) = +
- +
-  * **md5sum** 3794c55e94de29a4001ecaec2ce1cc50 +
-  * **shasum** 678c97df3d059ad784035a9a2cb7c299d0fefb1d +
-  * **Usuário** root **Senha** tfest +
-  * https://www.dropbox.com/s/g8olctbyje9o5lg/TranslationPHP.ova?dl=0 +
- +
-Existe um compartilhamento nfs na pasta /root/translationfest para que a máquina host possa ler os arquivos. Basta montar como um compartilhamento de rede. Funciona em Windows/Linux/Mac. +
- +
-== Instalar as dependências no Ubuntu (e similares) == +
- +
-Caso não esteja usando uma máquina virtual, você também pode usar o script abaixo para instalar as dependências numa máquina Ubuntu: +
- +
-<code> +
-source <(wget -qO- https://gist.github.com/royopa/599259ebeffa6ab7b1cb/raw/) +
-</code> +
- +
-Pronto, você já pode começar a editar o manual. +
- +
-== Atualize o repositório svn da documentação == +
- +
-Assim que iniciar o trabalho em qualquer dos ambientes escolhidos, atualize o repositório svn da documentação, com o comando: +
- +
-<code> +
-cd ~/translation_fest/doc-pt_BR +
-svn up +
-</code> +
- +
-== Compilando o manual == +
- +
-Para compilar, existem algumas opções: +
- +
-= Documentação no formato xHTML = +
- +
-Gera arquivos no formato xHTML, sem imagens, porém funcional: +
- +
-<code> +
-$ cd ~/doc-pt_BR/ +
-$ php doc-base/configure.php --enable-xml-details --with-lang=pt_BR +
-$ phd --docbook doc-base/.manual.xml --package PHP --format xhtml --output mydocs_xhtml +
-</code> +
- +
-Agora inicie o servidor web do PHP para acessar a documentação pelo navegador: +
- +
-<code> +
-$ php -S localhost:8000 -t ./mydocs_xhtml/php-chunked-xhtml +
-</code> +
- +
-E acesse a documentação gerada através do endereço http://localhost:8000/ +
- +
-Veja esse processo rodando aqui: https://asciinema.org/a/14378 +
- +
-= Documentação no formato PHP = +
- +
-Gera arquivos no formato php, que dependem de outros arquivos explicados em http://doc.php.net/tutorial/local-setup.php. Com os comandos abaixo essas dependências já são resolvidas. +
- +
-<code> +
-$ cd ~/doc-pt_BR/ +
-$ php doc-base/configure.php --enable-xml-details --with-lang=pt_BR +
-$ phd --docbook doc-base/.manual.xml --package PHP --format php --output mydocsphp_pt_BR +
-</code> +
- +
-Depois de executar os passos acima, utilize os comandos abaixo para baixar as dependências que o formato de documentação em php possui: +
- +
-<code> +
-$ wget https://github.com/php/web-php/archive/master.zip +
-$ unzip master.zip +
-$ rm -rf master.zip +
-$ rsync -avzC --timeout=600 --delete --delete-after --exclude='distributions/**' --exclude='extra/**' --exclude='backend/notes/**' ./web-php-master/ ./myphpnet/ +
-$ rm -rf web-php-master/ +
-</code> +
- +
-Então mova a pasta da versão da documentação que você criou para dentro da pasta que será usada pelo servidor web: +
- +
-<code> +
-$ mv mydocsphp_pt_BR/php-web/ myphpnet/manual/pt_BR +
-</code> +
- +
-Agora inicie o servidor web do PHP para acessar a documentação pelo navegador: +
- +
-<code> +
-$ php -S localhost:8000 -t ./myphpnet/ +
-</code> +
- +
-E acesse a documentação gerada através do endereço http://localhost:8000/manual/pt_BR/ +
- +
-Veja esse processo rodando aqui: https://asciinema.org/a/14385 +
- +
-== Criando um patch com as suas alterações == +
- +
-Depois de terminar suas alterações de tradução e testá-las, você deve fazer um patch com essas alterações. +
- +
-Para evitar mandar algum patch que mexa na estrutura do original do manual, é sugerido que o patch seja gerado a partir da pasta ''pt_BR''. Depois de navegar para essa pasta, execute o seguinte comando: +
- +
-<code> +
-svn diff > minha_traducao.patch +
-</code> +
- +
-Pronto. Basta mandar esse patch para a [[doc-pt-br@lists.php.net|lista]] e alguém irá aplicá-lo caso esteja acordo com o foco da tradução e as regras mencionadas no manual. +
- +
-Não esqueça de mandar uma commit message junto! ex.: +
- +
-<code>Translating the Windows install FAQ [Fulano de Tal <fulano@tal.com>]</code> +
- +
-Quanto mais patches seus forem aprovados, mais fácil para você conseguir uma conta VCS aprovada (SVN, nome@php.net) e agilizar o processo, pois você mesmo vai poder mesclar suas alterações. +
- +
-== Aplicando um patch na documentação == +
- +
-Para aplicar um patch na sua tradução, utilize um dos comandos abaixo: +
- +
-Se tiver usando o SVN >= 1.7 é só chamar: +
- +
-<code> +
-svn patch $file +
-</code> +
- +
-Se não tiver o comando svn patch, use o seguinte comando: +
- +
-<code> +
-patch -p0 < $file +
-</code>+
doc/translations/pt_br.txt · Last modified: 2017/09/22 13:28 by 127.0.0.1

Page Tools