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

Como contribuir

1. Faça fork e edite
2. Opcionalmente, instale o Ruby com a gem Jekyll para prever localmente
   • Instale o Vagrant e o VirtualBox
   • No diretório deste projeto, execute vagrant up
   • Após o termino do provisionamento vagrant ssh
   • Vá ao diretório cd /vagrant
   • Faça o build do projeto jekyll server
3. 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].github.com/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