-
Notifications
You must be signed in to change notification settings - Fork 104
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 através de um fork e pull requests (ver roteiro web) ou através de um clone 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 patchs 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 dessas alterações.
Ou para trabalhar com arquivos locais:
Setup inicial:
# Seu nome de usuário aqui:
GU="seu_user_github_aqui"
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