TL;DR
Para criar um site estático com Pelican, siga os passos a seguir:
- Crie uma pasta do projeto
- Instale o Pelican e os pacotes Markdown executando
pip install "pelican[markdown]"
- Execute
pelican-quickstart
e responda às perguntas que aparecerão - Crie um artigo chamado
meu_artigo.md
com o seguinte conteúdo:
Title: This is my first article
Date: 2010-12-03 10:20
Category: Cool
Cool content goes here.
- Execute
pelican -r -l
, abra um navegador e acesse http://localhost:8000/ para ver o site funcionando localmente.
O que é Pelican?
O Pelican é um gerador de site estático escrito em Python.
Aqui estão algumas coisas que gosto sobre o Pelican:
- Podemos escrever conteúdo nos formatos reStructuredText ou Markdown usando a ferramenta com a qual estamos familiarizados (eu uso o Obsidian, a propósito)
- Ele inclui uma ferramenta de linha de comando simples para gerar nosso site e realizar algumas outras coisas interessantes
- Ele gera um site estático que pode ser facilmente hospedado em qualquer lugar (até mesmo no AWS S3 (Simple Storage Service)!)
- Possui temas e plugins de código aberto feitos pela comunidade
O que é um site estático?
Ok, mas o que é um site estático?
Um site estático é um tipo de site que não altera seu conteúdo - não se atualiza com base em interações do usuário ou dados em tempo real (sem bancos de dados!). Geralmente é composto por arquivos HTML, CSS e, às vezes, arquivos JavaScript.
Para pessoas não técnicas, um site estático pode ser entendido como um folheto impresso. É como uma imagem de informações que não muda a menos que alguém fisicamente altere as palavras ou imagens no papel (o programador, no caso).
Por ser tão simples, normalmente é mais rápido, mais confiável, seguro e com certeza divertido de construir.
Por que Pelican?
Sempre tive dificuldades para escolher a melhor ferramenta de escrita. Experimentei o MailChimp, o Medium, o Ulysses, o Evernote, o Notion, o Google Docs e outros, e muitas vezes me vi alternando entre eles - acabando por gastar mais tempo fazendo isso do que escrevendo efetivamente.
Outra coisa com a qual tive dificuldade foi decidir a melhor maneira de salvar e possivelmente controlar versões das minhas notas, porque, no final do dia, todas essas outras ferramentas ainda seriam responsáveis por armazenar meus dados.
Decidi escrever minhas notas e artigos como arquivos Markdown (uso o Obsidian para isso) e armazenar esses arquivos automaticamente com o iCloud no Mac.
E quando termino um artigo ou preciso editar um artigo que já publiquei, posso simplesmente usar o Pelican para (re)gerar as páginas do blog a partir dos meus arquivos Markdown.
Configurando o Pelican
Como mencionei anteriormente, o Pelican é construído em Python, portanto, precisamos apenas instalá-lo como um pacote no PyPI (Python Package Index) e executar alguns comandos de linha de comando (CLI). Aqui estão os passos que precisamos seguir:
- Crie uma pasta de projeto
- Instale os pacotes Pelican e Markdown (recomendado fazer isso em um ambiente virtual Python)
# Crie um ambiente virtual para o Python
python -m venv env-pelican
# Ative o ambiente virtual no Linux/Mac
source env-pelican/bin/activate
# Ative o ambiente virtual no Windows
./env-pelican/Scripts/activate
# Instale o pacote do Pelican
python -m pip install "pelican[markdown]"
- Execute
pelican-quickstart
e responda às perguntas que aparecerão - Crie um artigo chamado
meu_artigo.md
com o seguinte conteúdo (você pode aprender mais sobre os metadados suportados pelo Pelican aqui)
Title: This is my first article
Date: 2010-12-03 10:20
Category: Cool
Cool content goes here.
- Execute
pelican -r -l
, abra um navegador e acesse http://localhost:8000/ para ver o site em funcionamento localmente- A opção
-r
reinicializa o Pelican sempre que uma modificação ocorre nos arquivos de conteúdo - A opção
-l
serve os arquivos de conteúdo via HTTP na porta 8000
- A opção
Você vai ver algo muito parecido com a imagem abaixo:
Top comments (0)