layout	title	permalink
page	Quer postar no Blog? Saiba como!	/writing/

Blog do grupo PHP Bahia

Esse é o blog do grupo PHP Bahia. Toda contribuição será muito bem vinda.

https://phpba.github.io

Instalação

O blog foi construido usando o jekyll, logo para fazer um post e ir olhando localmente será necessário instalá-lo e suas dependências: jekyll-paginate e jekyll-sitemap.

$ gem install jekyll
$ gem install jekyll-paginate
$ gem install jekyll-sitemap

Docker e Docker Compose

Em alternativa a ter de sujar sua máquina com instalações assim para cada projeto pode-se utilizar Docker!

Veja a documentação do Docker para instalar em sua máquina. Rodamos testes com essa imagem configurada para aplicações que vão rodar no Github Pages e funcionou bem.

Para rodar, você executa o seguinte comando:

$ docker run -d --name phpba -v "$(pwd):/usr/src/app" -p 4000:4000 starefossen/github-pages

Se preferir, pode usar o Docker Compose para rodar (já existe o arquivo docker-compose.yml):

$ docker-compose up -d

E então já poderá acessar http://localhost:4000 para ver o blog.

Caso tenha feito alterações e por algum motivo não foram atualizadas, reinicia o container da seguinte maneira:

$ docker restart phpba

Uso

Poderá fazer as modificações e já ir vendo o resultado. Para tal:

$ jekyll server --watch

Contribuindo

1. Faça um fork do repositório
2. Cria uma branch para sua contribuição: git checkout -b sua-contribuicao
3. Commit as mudanças: git commit -am 'Mensagem sobre a mudança'
4. Suba as alterações: git push origin sua-contribuicao
5. Manda um pull request

Escrevendo posts

Para escrever um post siga os passos:

1. Faça um fork do repositório
2. Cria uma branch para seu post: git checkout -b nome_do_post
3. Crie um arquivo na pasta _posts com o nome ANO-MES-DIA-titulo.markdown o formato da data é YYYY-MM-DD
4. Commit o post: git commit -am 'nome do post'
5. Suba o post: git push origin nome_do_post
6. Manda um pull request

Formato do post

---
layout: post                        // Layout que será exibido o post, o nome do layout é post :)
title:  "Hello World"               // Titulo do post  
date:   2016-02-07 15:32:25         // Data e hora do post
original:                           // Link do post original, caso tenha replicado de seu blog pessoal
author: 
    name: Paulo de Almeida          // Nome do autor do post
    mail: [email protected]  // E-mail do autor
    github: paulodealmeida          // Endereço no GitHub
    blog:                           // Endereço do blog do autor
    twitter:                        // Conta no Twitter
    facebook:                       // Conta no Facebook  
categories:                         // Categorias do post separadas por virgula, se não houver categoria escrever "Sem categoria"
tags:                               // Tags
---

Lorem ipsum dolor sit amet.         // Texto do post

Na documentação do Jekyll tem outras informações para posts mais complexos.

Agradecimento

• Deixamos aqui, primeiramente, nosso agradecimento a todos os contribuidores do blog
• Também não podemos deixar de agradecer ao @bencentra pelo centrarium.