Skip to content

Repository files navigation

layoutpage
titleQuer postar no Blog? Saiba como!
permalink/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 postoriginal: // Link do post original, caso tenha replicado de seu blog pessoalauthor: name: Paulo de Almeida // Nome do autor do postmail: paulodealmeida@gmail.com // E-mail do autorgithub: paulodealmeida // Endereço no GitHubblog: // Endereço do blog do autortwitter: // Conta no Twitterfacebook: // 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

About

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

Resources

Stars

12 stars

Watchers

8 watching

Forks

Releases

Packages

Contributors

Languages