Repository files navigation

TL;DR: aqui fica osource, osstatics ficam nophprio.github.io.

Este repositório contém os sources dophp.rio.O site é hospedado pelo próprioGitHub Pages. Para tanto, tínhamos duas opções:

1. Fazer o site comJekyll e forçar a galera a se virar com Ruby e similares 😷, mas tendo a build sendo geradaautomaticamente
2. Fazer o site com um primo PHP do Jekyll, oSculpin, que não faz build automática mas é PHPRio-friendly.

Obviamente, fomos pela segunda opção. Para tanto, é necessário que o site seja publicado na raiz de um repositório como nome correto e, pra não misturar osstatics com todo osource do site, dividimos o projeto em dois repositórios.
Assim, o conteúdo final do site gerado fica em/output_prod, que é um submódulo desse aqui.

Disclaimer: esse projeto foi baseado no exemplo de Blog Skeleton que tem noGet Started deles.

muidifício.

1. Clonar o repositório:git clone git@github.com:PHPRio/site.git phprio-site
2. Entre na pasta, e prepare o submódulo:git submodule init; git submodule update
3. Dependências:composer install (espero que você tenha o Composer instalado, né? Senão, vejaa seguir)
4. [opcional] Se você for mexer no layout, você vai precisar donode-sass ou algum outro compilador de SASS.Instale-o pelo NPM ou Yarn:npm install --global node-sass ouyarn global add node-sass.

Não tente seguir as instruções do site do Sculpin. Elas estão bem desatualizadas (mandando usar um phar, por exemplo).

Método prático pra instalar o Composer globalmente no seu PC:curl -sS https://getcomposer.org/installer | sudo php -- --filename=composer --install-dir=/usr/local/bin

• Para testar o site durante o desenvolvimento você pode executarcomposer watch e acessar emlocalhost:8000.
• Para compilar ele uma única vez e servir,composer serve.
• Há também como compilar estaticamente e só, com ocomposer generate.
• Para o layout, nós usamos SASS. Se você for mexer nisso, é importante subir também o watcher de SASS:composer sass-watch. Se quiser compilar uma única vez,composer sass.

A build está sendo feita automaticamente no Travis. Veja osdetalhes e instruções.

1. Para fazer a compilação, usecomposer prod. Isso limpa a pasta, re-gera o SASS, e compila com configurações deprodução.
2. Para fazer o deploy,composer deploy entra na pasta de produção, faz o commit para o submódulo e faz o push.
3. Se você quiser fazer os dois passos de uma vez, usecomposer prod-deploy 😏

Não esqueça de, ao finalizar tudo, fazer um commit que inclua a pastaoutput_prod!
A dica é fazer o deploy antes do commit final da última modificação, assim a gente não polui o histórico dorepositório de source com commits "atualizando build do site" 😉

Veja oCONTRIBUTING.md para detalhes sobre como desenvolver e contribuir com o site.