No próximo artigo, daremos uma olhada no Pelican. Esta é uma boa opção para usuários Python que desejam hospedar um site ou blog simples. Se estiver interessado em criar um site ou blog personalizado, você tem muitas opções disponíveis hoje. Mas se apenas você deseja servir páginas da web estáticas, este construtor de sites estáticos pode ser útil para você. Esses tipos de aplicativos usam modelos para criar todas as páginas estáticas que o usuário deseja e vinculá-las aos metadados associados.
Se você usar Python e você está procurando algo para gerar páginas HTML estáticas, este gerador permitirá que você dê uma olhada em como ele funciona. Usar um idioma que você conhece torna tudo mais fácil. Se você não gosta de Python, existem outros geradores de sites estáticos que usam outras linguagens.
Pelican é um gerador de sites estáticos comumente usado, escrito em Python. leste suporta diretamente Texto reestruturado e pode suportar Markdown, quando o pacote necessário for instalado. Todas as tarefas são realizadas por meio de ferramentas de interface de linha de comando (CLI), o que o torna simples para qualquer pessoa familiarizada com ele. Além disso, sua ferramenta de início rápido simples torna a criação de um site extremamente fácil.
Instalação e configuração básica do Pelican
Estou testando este programa no Ubuntu 20.04. O primeiro passo a seguir será criar um virtualenv e instale o Pelican. Isso pode ser feito abrindo um terminal (Ctrl + Alt + T) e usando os comandos nele:
mkdir test-sitio cd test-sitio python3.8 -m venv venv ./venv/bin/pip install --upgrade pip
Depois de atualizar o pip, agora podemos instalar pelicano:
./venv/bin/pip install pelican
Execute o comando pelican-quickstart
Depois de instalado, a ferramenta CLI de início rápido Pelican criará o layout básico e alguns arquivos para que possamos começar.
Para manter as coisas simples, ao executar o início rápido, usei os valores para o título e autor e respondi N ao prefixo do url e paginação do artigo. Para o resto das perguntas, eu usei o padrão. É muito fácil alterar essas configurações no arquivo de configuração posteriormente. O início rápido pode ser executado com o comando:
./venv/bin/pelican-quickstart
Quando terminar, podemos alterar certos aspectos das configurações. Nós apenas temos que abra o arquivo pelicanconf.py em nosso editor de texto favorito.
Dentro podemos procurar a linha:
TIMEZONE = 'Europe/Paris'
E nós podemos mude para o fuso horário do país que lhe interessa.
Pára atualizar configurações de links sociais, você tem que procurar a variável SOCIAL en pelicanconf.py. Nele podemos adicionar nossos links da seguinte maneira:
SOCIAL = (('Twitter (#Ubunlog)', 'https://twitter.com/UbunlogWeb'),)
Você deve observar que a vírgula no final é importante. Essa vírgula ajuda o Python a reconhecer que a variável é na verdade um conjunto. Certifique-se de não excluí-lo.
Inicie o servidor
Agora que temos o básico de um site, podemos ver que o início rápido criou um Makefile com vários objetivos. Um deles faz devserver pode iniciar um servidor de desenvolvimento em nossa máquina para que possamos visualizar tudo o que estamos criando. Os comandos CLI usados no Makefile devem fazer parte do nosso PATH, então primeiro devemos ativar o virtualenv.
source ./venv/bin/activate make devserver
Quando começar, podemos abra nosso navegador e vá para o URL http://localhost:8000 para ver o blog que foi criado.
Adicionar conteúdo
Agora que temos um site básico, podemos adicionar algum conteúdo. Primeiro, vamos criar um arquivo chamado bem-vindo. primeiro no diretório de conteúdo (conteúdo) do site.
Com nosso editor de texto favorito, vamos criar este arquivo com um texto que segue a seguinte estrutura:
Bienvenid@ a este blog ###################### :date: 20210827 00:03 :tags: bienvenid@ :category: Intro :slug: bienvenida :author: ubunlog :summary: Documento bienvenida Bienvenid@ a este blog de prueba con Pelican. Esta es una pequeña página se va a mostrar como página estática. Pelican analiza automáticamente las líneas de metadatos (fecha, etiquetas, etc.).
Depois de gravar o arquivo, o devserver deve atualizar e gerar algo assim:
Recarregue seu site de teste no navegador para ver as mudanças.
Os metadados foram adicionados automaticamente à página. O que mais, O Pelican detectou automaticamente a categoria Intro e adicionou a seção ao painel de navegação.
Mudar de assunto
Além de tudo isso, podemos facilmente mudar de assunto. No repositório Temas de pelicano, você pode encontrar diferentes temas que os usuários criaram. É muito fácil testar novos temas, basta baixá-los do repositório, salve-os em nosso computador e no arquivo pelicanconf.py adicione a seguinte linha com o caminho para o tema:
THEME = "/home/tu-usuario/pelican-tema/nombre-del-tema"
O devserver irá regenerar sua saída. Recarregue a página da web no navegador para ver o novo tema.
Esta foi uma pequena introdução rápida ao Pelican. Tudo isso foi feito em uma máquina local. Se você quiser que outras pessoas vejam o seu site, você terá que enviar os arquivos HTML pré-gerados para um servidor. Se você olhar em detalhes a saída de pelicano-início rápido, você verá opções para usar FTP, SSH, S3 e até mesmo as páginas do GitHub.
Pode obtenha mais informações sobre este gerador no site do projeto ou Repositório GitHub.