-
Notifications
You must be signed in to change notification settings - Fork 106
Home
Olá, e seja bem vindo!
Caso tenha encontrado algum problema na tradução, ou um arquivo desatualizado, você pode realizar alterações diretamente do seu navegador, aqui, pelo GitHub (ver roteiro web) ou através de um clone git local (ver roteiro git)
Para participar mais ativamente, da mesma forma que os tradutores oficiais, há o longo e detalhado guia de edição do manual.
As discussões ocorrem via issues aqui ou através da lista de discussão oficial.
Os arquivos desatualizados são prioridade, e podem ser conferidos na situação atual. Ao traduzir um arquivo, é importante também atualizar a tag de revisão.
Há várias maneiras de contribuir com o manual, a saber.
-
Realizar traduções diretamente pelo seu navegador. Veja o roteiro web para mais detalhes;
-
Realizar traduções a partir arquivos baixados localmente, com mais ferramentas (permite realizar a compilação do manual, detectar erros e gerar estatísticas). Veja o roteiro git.
-
Há também a tradução do guia de edição do manual. Esse manual, bem mais longo, contém os procedimentos e detalhes para editores e tradutores do manual, para além dos procedimentos puramente técnicos do roteiro git.
Estas opções estão listadas em ordem de facilidade. A primeira opção permite realizar traduções direto do navegador mas não fornece ferramental de verificação. As últimas opções, que utilizam linha de comando, exigem maior conhecimento e instalação de ambiente, sendo mais facilmente montado e mantido em ambientes Linux. Apesar da complicação a mais, é o necessário para trabalhar ma tradução com maior frequência.
As primeiras opções permitem participar da tradução sem acesso à organização do PHP. O procedimento para conseguir o acesso, aliás, é começar a traduzir sem uma credencial, enviando issues ou pull requests através deste projeto. As credenciais podem ser solicitadas depois de alguns meses de envios contínuos.
Pequenas correções e ajustes usando GitHub:
- Faça um fork do projeto php/doc-pt_br;
- Altere o arquivo no seu fork, diretamente pelo navegador;
- Faça um pull request de suas alterações.
Ou para trabalhar com arquivos locais:
Setup inicial:
# Seu nome de usuário aqui:
GU="php"
mkdir phpdoc
cd phpdoc
git clone [email protected]:php/doc-base.git doc-base
git clone [email protected]:php/doc-en.git en
git clone [email protected]:$GU/doc-pt_br.git pt_BR
cd pt_BR
git remote add upstream [email protected]:php/doc-pt_br.git
cd ..
Toda vez que iniciar ou terminar uma tradução:
(cd pt_BR; git fetch upstream)
(cd doc-base; git pull)
(cd en; git pull)
(cd pt_BR; git pull)
php doc-base/scripts/revcheck.php pt_BR > revcheck.html
xdg-open revcheck.html
php doc-base/configure.php --with-lang=pt_BR --enable-xml-details
(cd pt_BR; git status)
TODO