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: username_no_github
Summary: Primeiro parágrafo do texto ou resumo
Para que o autor apareça com imagem e descrição ao final de cada postagem é preciso adicionar os arquivos ao blog seguindo os passos descritos a seguir
-
Adicione a sua imagem na pasta
content/images/authors/a imagem deve conter o mesmo nome de seu usuário no github e conter a extensão.jpg. -
Crie um novo arquivo na pasta
content/authors/, o arquivo deve ter extensão .json e precisa ter os seguintes campos preenchidos:
{
"name": "Seu nome",
"image": "/images/authors/username_no_github.jpg",
"description":"breve descrição",
"social": {
"github": "https://github.com/username_no_github",
"twitter": "https://twitter.com/username_no_twitter",
"linkedin": "https://br.linkedin.com/in/username_no_linkedin"
}
}
Necessita de Python 3.7+. Instale as dependências:
pip install -r requirements.txtGere o site executando:
pelican content/Para rodar um servidor Web, execute:
cd output && python -m pelican.serverEntão basta acessar localhost:8000 em seu navegador.
make github # Irá gerar novamente o site e subir para o branch gh-pagesSe 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).
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent