Esse repositório contém o código e as publicações do Blog do Brasil.IO.
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
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.
make github # Irá gerar novamente o site e subir para o branch gh-pages
Se você curte o projeto e quer contribuir de outras formas também, veja como.
Todas as publicações estão disponíveis sob a licença Creative Commons Attribution-ShareAlike (CC BY-SA).