Este repositório contém os sources do php.rio. Utilizamos o Sculpin para gerar o site estático e o hospedamos no GitHub Pages.
Para o desenvolvimento, tínhamos duas opções:
- Fazer o site com Jekyll e forçar a galera a se virar com Ruby e similares 😷
- Fazer o site com um primo PHP do Jekyll, o Sculpin, que é PHPRio-friendly.
Obviamente, fomos pela segunda opção. Esse projeto foi baseado no exemplo de Blog Skeleton disponível no Get Started deles.
Também habilitamos uma extensão do Markdown. Os detalhes do que é possível fazer a mais está disponível na página do processador em PHP usado.
muidifício.
- Clone o repositório.
git clone --recurse-submodules [email protected]:PHPRio/phprio.github.io.git
- Instale as dependências
(espero que você tenha o Composer instalado, né? Senão, veja a seguir).
composer install
- (opcional) Se você for mexer nos estilos SCSS, instale as dependências do Node.
npm install
Método prático pra instalar o Composer globalmente no seu PC, caso ainda não tenha instalado:
curl -sS https://getcomposer.org/installer | sudo php -- --filename=composer --install-dir=/usr/local/bin
Para testar o site durante o desenvolvimento:
composer watch
Após executar o comando acima, você poderá acessar o site em http://localhost:8000.
(opcional) Se você for mexer nos estilos SCSS, é importante rodar também o watcher do sass:
npm run sass-watch
.
Se quiser compilar uma única vez, npm run sass
.
A build está sendo feita automaticamente usando Github Actions e é commitada na branch gh-pages
.
Veja o CONTRIBUTING.md
para detalhes sobre como desenvolver e contribuir com o site.