Após quase 3 anos sem posts, o site do RSJug está de cara nova!
Melhorias com o novo site
O novo site conta com as seguintes melhorias:
-
Roda sob o Jekyll, uma plataforma para criação de sites estáticos (a mesma utilizada pelo github pages);
-
Hospedado no github para
facilitar contribuiçõese atualizações; -
Utilização de frameworks modernos como o Bootstrap para tornar o site
responsívoe acessivel em dispositivos móveis; -
Utilização de linguagem de marcação leves, que focam no conteúdo ao invés da sintáxe, como
MarkdowneAsciidocpara criação dos posts; -
Mecanismo de busca no síte do lado cliente usando lunr.js;
| Os posts antigos foram migrados para o novo site, o código usado para a migração também está disponível no github. |
Como contribuir para o site
Primeiramente faça um fork do site no github. A seguir siga os passos do README para subir o site localemente assim como entender como o site está organizado.
Após, basta enviar um pull request para iniciar o fluxo de aprovação do github com suas contribuições.
| Abra uma issue antes para discutirmos as possiveis contribuições. |
Criando um novo post
A criação de um novo post se dá através da criação de um arquivo na pasta posts, esse arquivo deve seguir a seguinte convenção de nome:
ano-mes-dia-descrição.extensão. onde extensão pode ser md para posts no formato Markdown ou adoc para o formato Asciidoc.
Metatados do post
Os metados de um post no Jekyll são incluídos no inicio do post, delimitados por trés hifens. Abaixo seguem exemplo dos principais metadados de um post:
--- layout: inner (1) categories: blog development (2) permalink: /sample/ (3) tags: (4) - github - jekyll - asciidoc excerpt: This is a sample page composed in AsciiDoc. (5) comments: true author: rmpestano ---
| 1 | layout/template padrão para posts |
| 2 | categorias para agrupamento de posts, podem ser acessadas posteriormente neste link. |
| 3 | Url "amigável" do post (invés do caminho absoluto até o html do post apenas o permalink pode ser usado) |
| 4 | tags do post. Todas tags podem ser acessadas neste endereço. |
| 5 | Pedaço de texto do post a ser exibido na listagem de posts, antes do usuário entrar no mesmo. |
Exemplos de posts
Todos os posts estão no github neste caminho e podem ser usados como exemplo.