Skip to content

Uma referência rápida de melhores práticas de PHP, renomados padrões de código e links para tutoriais competentes pela Web.

License

Notifications You must be signed in to change notification settings

RuanAragao/php-the-right-way

 
 

Repository files navigation

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

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

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

Licença

Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License

About

Uma referência rápida de melhores práticas de PHP, renomados padrões de código e links para tutoriais competentes pela Web.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • CSS 97.9%
  • JavaScript 2.1%