/blog.brasil.io

Blog do Brasil.IO

Primary LanguageJupyter Notebook

Blog do Brasil.IO

Esse repositório contém o código e as publicações do Blog do Brasil.IO.

Contribuindo

Caso você não tenha conhecimentos de git, GitHub e markdown mas tenha interesse em publicar algum texto no blog envie um email através da página de contato falando sobre o texto que gostaria de publicar e conversamos. :) Caso você se sinta confortável utilizando essas tecnologias, leia mais:

O blog é um site estático usando o pelican; crie um pull request com o conteúdo do texto em um arquivo na pasta content/ - o arquivo pode estar em markdown ou no formato do Jupyter Notebook (ipynb). Por padrão o arquivo deve conter o formato: content/YYYY-MM-DD-titulo-do-text.md; no caso da utilização do Jupyter Notebook, use a extensão .ipynb e crie também um arquivo content/YYYY-MM-DD-titulo-do-text.nbdata com o seguinte formato:

Title: Escreva aqui o título do arquivo
Slug: slug (utilize o mesmo do nome do arquivo, sem extensão)
Date: YYYY-MM-DD HH:MM
Category: categoria1, categoria2
Tags: tag1, tag2
Author: Seu Nome
Summary: Primeiro parágrafo do texto ou resumo

Rodando Localmente

Necessita de Python 3.7+. Instale as dependências:

pip install -r requirements.txt

Gere o site executando:

pelican content/

Para rodar um servidor Web, execute:

cd output && python -m pelican.server

Então basta acessar localhost:8000 em seu navegador.

Publicando

make github  # Irá gerar novamente o site e subir para o branch gh-pages

Outras Maneiras de Contribuir

Se você curte o projeto e quer contribuir de outras formas também, veja como.

Licença

Todas as publicações estão disponíveis sob a licença Creative Commons Attribution-ShareAlike (CC BY-SA).