Agora que mudamos nossa plataforma para o Jekyll, esperamos que fique mais fácil a colaboração com artigos, afinal agora podemos usar git/markdown e isso dá mais tesão e incentiva mais o pessoal a escrever.

Este post é pra justamente dar o básico para aquele que não esta familiarizado com Jekyll/Github/Markdown.

Bom, agora como o site é um repositório dentro do github, o git será um grande amigo seu :P. Para aqueles que estão como colaboradores, basta clonar o repositório diretamente, já para quem não esta como colaborador é necessário que se faça um fork primeiramente:

# Como colaborador
git clone https://github.com/ohc/ohc.github.io.git

Se você ainda não é um colaborador, é necessário que fork o projeto inicialmente:

E então, clonar a partir do seu repositório:

# Como não colaborador
git clone https://github.com/<username>/ohc.github.io.git

Troque username pelo qual você usa no github.

Deste ponto em diante é o mesmo para colaborador ou não. Primeiro entre no repositório e crie uma branch com o nome que preferir:

cd ohc.github.io
git checkout -b meupost

Os posts devem estar na pasta _posts e devem ser escritos em Markdown.

Até mesmo este post pode servir como exemplo para saber como escrever em Markdown.

Outro ponto é que o nome do arquivo deve seguir a seguinte estrutura:

YYYY-MM-DD-título.md

No caso deste post:

2016-10-10-como-crio-posts-pro-ohc.md

Criado seu post, você precisa dar um add para monitorar suas alterações, um commit (de preferência com uma mensagem sobre do que se trata seu post) e um push para subir suas alterações para o repositório:

git add .
git commit -m "Meu post sobre como criar posts no site do OHC :)"
git push origin meupost <=== nome do branch criado anteriormente

Para aquele que é colaborador, deve agora ir até repositório no github e criar um PR (pull request) clicando em ‘Compare & pull request’

Selecionar o repositório:

NOTE:> Preste bastante atenção para não criar um PR no repositório errado. Selecione ohc/ohc.github.io

Em seguida, ‘Create pull request’:

Pronto! Seu PR foi enviado e assim que for avaliado será aceito ou negado, mas com a explicação e com instruções de como nós estamos esperando.

Espero que tenha sido útil para aqueles que querem escrever um post na plataforma Jekyll. Para mais informações: Jekyll