www.bernatchez.net

Pelican es un generador de sitios web estáticos. Es la herramienta que utilizamos para mantener nuestros sitios estáticos.

Este documento asume que utilizamos venvwrapper [1].

Instalar Pelican

Hazlo dentro de nuestro entorno virtual de Python. Llamamos a nuestro entorno statsites.

Activa el entorno e instala Pelican.

venv statsites
pip install pelican

Temas

En cada una de nuestras configuraciones de pelicanconf.py, seleccionamos un tema para el sitio web.

Para obtener una colección de temas, clonamos de la siguiente manera:

git clone --recursive https://github.com/getpelican/pelican-themes ${HOME}/pelican-themes

Nota sobre el tema de sitio

En nuestros sitios web, hemos realizado algunos ajustes al tema lightweight para adaptarlo a nuestro propósito.

Mantenemos este tema derivado y nuestro contenido web en nuestro repositorio de control de versiones Git.

Nuestro archivo de configuración pelicanconf-en.py contiene esta referencia.

THEME = u"/home/ubuntu/allrepos/mystatic_sites/derived-themes/lightweight-single-home-en"

Elegir el tema para su sitio y ajustarlo es asunto de Ud.

Inicializar el sistema de archivos del sitio esquelético

Utilice pelican-quickstart para generar contenido de sitio web estático inicial usando pelican.

pelican-quickstart crea un sistema de archivos de generación de

sitio esqueletizado debajo del directorio vacío actual.

Después, crea archivos .rst en los directorios content/cualquier_nombre como artículos de blog.

Crea archivos .rst en content/pages como páginas de blog.

Compilación

Genera los archivos del sitio web una vez que tengamos todos los archivos fuente .rst. Para ello, solo necesitamos usar el Makefile.

A continuación, se compilará y emitirá todo el contenido del sitio web en "output/" usando Pelican.

make html

# Puede revisar sus resultados invocando el archivo output/index.html.