docs.pelican.bernatchez.net - pelican

Configurar un nuevo sitio Bunny

2026-05-09T12:59:29+00:00

Pasos de ejemplo para configurar su cuenta de bunny.net para alojar un nuevo sitio.

En este ejemplo, nuestro nuevo sitio se llama: dummy.example.net

Cambie los nombres de acuerdo con el nombre de su sitio.

Inicie sesión en su cuenta de bunny.net en: https://dash.bunny.net/
Cree una zona de almacenamiento estándar con el nombre: dummy-example-net [1]

[1]	La imagen muestra "docs-pelican-bernatchez-net", debería mostrar "dummy-example-net"

Cree una zona de extracción con el nombre: dummy-example-net-zone [2]

[2]	Muestra "docs-pelican-bernatchez-net-zone", debería mostrar "dummy-example-net-zone"

Inicie sesión en su cuenta del servicio DNS.
En su servidor DNS, cree un registro: dummy.example.net CNAME dummy-example-net-zone.b-cdn.net
De vuelta en bunny.net, agregue un nombre de host personalizado dummy.example.net a la zona de extracción [3]

[3]	Muestra "docs.pelican.bernatchez.net", debería mostrar "dummy.example.net"

Cuando realice esta incorporación, aproveche para confirmar que el certificado está funcionando correctamente.

Su sitio ya está listo para servir contenido. Puede publicar en él.

Todo en una sola página

2026-04-26T01:36:19+00:00

Mis recetas consisten en una imagen y las instrucciones para prepararla debajo de ella. Para la impresión en formato « .pdf », trato de que todo quepa en una sola página. Eso significa que debo mantener la imagen pequeña.

En la práctica, tomo una foto con mi celular. Luego la abro con el visor Shotwell y recorto la parte que me interesa.

Después, sea cual sea el resultado, la reduzco a aproximadamente 1000 píxeles de ancho.

comando para reducir

convert original.jpg -resize 1000x pagefit.jpg

fragmento que incluye la imagen en el código fuente RST

|

.. image:: ../images/pagefit.jpg
    :class: img-responsive
    :scale: 30%
    :alt: El resultado

He incluido una imagen así arriba como ilustración.

Creación de un sitio .rst

2026-04-16T01:47:25+00:00

Recorremos el proceso de creación de un nuevo subdirectorio de sitio en nuestro repositorio git para documentar los pasos necesarios al iniciar un nuevo sitio.

Esto no cubre la creación real de la infraestructura de alojamiento dentro de bunny.net. Por lo tanto, no seguimos ningún paso relacionado con la publicación en este ejemplo.

mypelican_static_sites es el proyecto de repositorio git donde lo configuramos.

Creamos un nuevo sitio llamado: dummy.bernatchez.net

Crear el nuevo directorio del sitio y poblarlo

# crear
cd ${HOME}/repos/mypelican_static_sites
mkdir dummy.bernatchez.net

# poblar
cp -r -P init.files/* dummy.bernatchez.net/

Agregar estos nuevos archivos específicos del sitio al control de revisión git

cd ${HOME}/repos/mypelican_static_sites/dummy.bernatchez.net
# los git adds están por determinarse

Referenciar los artículos pelican/ preexistentes dentro de nuestro sitio de prueba

Solo es necesario que el directorio exista bajo content/ para eso. El Makefile se encarga de poblar el subdirectorio.

Agregaremos un archivo placeholder.txt en ese directorio para que git clone cree el subdirectorio en el futuro.

cd ${HOME}/repos/mypelican_static_files/dummy.bernatchez.net
mkdir content/pelican

# esto asegura que el directorio pelican/ se cree en adelante al hacer git clone
cp content/pages/placeholder.txt content/pelican/placeholder.txt
git add content/pelican/placeholder.txt

Agregar las siguientes líneas al final de ".gitignore"

cd ${HOME}/repos/mypelican_static_sites

cat >>.gitignore <<EOFGITIGNORE
##
## BEGIN added for a new site
##

# dummy.bernatchez.net softlinks

dummy.bernatchez.net/content/favicon.ico
dummy.bernatchez.net/content/images/
dummy.bernatchez.net/content/site-only/
dummy.bernatchez.net/content/pages/
dummy.bernatchez.net/content/pelican/

dummy.bernatchez.net/content/images/*
dummy.bernatchez.net/content/site-only/*
dummy.bernatchez.net/content/pages/*
dummy.bernatchez.net/content/pelican/*


# dummy.bernatchez.net bucket is all generated
dummy.bernatchez.net/bucket/
dummy.bernatchez.net/bucket/*

##
## END additions for a new site
##
EOFGITIGNORE

cd ${HOME}/repos/mypelican_static_sites
git add .gitignore

Poner los archivos personalizables bajo control de versiones

cd ${HOME}/repos/mypelican_static_sites/dummy.bernatchez.net

git add Makefile
git add deploy.bunny
git add favicon.ico
git add login.bunny
git add names.bunny
git add notes.txt
git add pelicanconf-en.py
git add pelicanconf-es.py
git add pelicanconf-fr.py
git add publishconf-en.py
git add publishconf-es.py
git add publishconf-fr.py
git add purge.bunny
git add puta2p.sh

cd ${HOME}/repos/mypelican_static_sites/dummy.bernatchez.net/pages
git add *.rst

cd ${HOME}/repos/mypelican_static_sites/dummy.bernatchez.net/content
git add binaries images sitepdfs

cd ${HOME}/repos/mypelican_static_sites/dummy.bernatchez.net/pages-media
git add *
cd ${HOME}/repos/mypelican_static_sites/dummy.bernatchez.net/pages-pdfs
git add placeholder.txt
cd ${HOME}/repos/mypelican_static_sites/dummy.bernatchez.net/site-only-pdfs
git add placeholder.txt
cd ${HOME}/repos/mypelican_static_sites/dummy.bernatchez.net/site-only
git add *.rst

# Confirmar sus adiciones git

cd ${HOME}/repos/mypelican_static_sites/dummy.bernatchez.net/
git commit -m new-dummy-site

Generar esta primera revisión del sitio

cd ${HOME}/repos/mypelican_static_sites/dummy.bernatchez.net/
make html

# revisar y continuar el mantenimiento según sea necesario

Atributos de metadatos en cada artículo

2025-04-16T00:37:11+00:00

Pelican requiere meta datos como estos

:lang: es
:date: 2025-04-16 00:37:11+00:00
:tags: metadatos, artículo, pelícano
:slug: articlemeta
:category: pelican
:authors: Pierre Bernatchez
:summary: Metadatos en artículos

Inserte debajo del encabezado inicial de cada artículo.

Estos deben ser idénticos en todas las traducciones de un artículo.

:date: 2025-04-16 00:37:11+00:00
:slug: sitehome
:authors: Nuno Yobidness

Estos deben traducirse a las diferentes versiones de idiomas del artículo.

:lang: es
:tags: introducción
:category: pelican
:summary: Bienvenido al sitio

Estas opciones son opcionales.

Esto evita que el contenido aparezca en menús, páginas, palabras clave y categorías. Se generará, pero necesitará un enlace en algún lugar para acceder a él. Use el mismo valor en todos los idiomas.

:status: hidden

Esto reemplaza el pie de página de derechos de autor predeterminado.

El valor depende del idioma.

:fcopyright: Derechos de autor © 2026 Isaac Mejia—Todos los derechos reservados.

Proyecto git mypelican_static_sites

2025-04-16T00:37:11+00:00

Descripción general

Este es un proyecto de github que utiliza un generador de sitios llamado pelican para generar sitios web estáticos.

Al momento de escribir esto, el proyecto mantiene el contenido y la generación de tres sitios separados. Cada sitio se presenta en 3 idiomas: inglés, francés y español.

Por convención, nombramos cada uno de estos subdirectorios usando el nombre de dominio del sitio. Los scripts dependen de esta convención.

Sitios actualmente mantenidos

www.bernatchez.net

Alojado en Bunny.net: www-bernatchez-net
www.ogopogo.biz

Alojado en Bunny.net: www-ogopogo-biz
blog.bernatchez.net

Alojado en Bunny.net: blog-bernatchez-net
docs.pelican.bernatchez.net

Alojado sin publicar en el sistema de archivos local.

Generación del sitio web

Genere una versión local de un sitio para poder navegarlo y revisarlo antes de publicarlo.

cd ./blog.bernatchez.net
make html
xdg-open ./bucket/index.html
cd ..

Genere una versión en línea del sitio y publíquela.

cd ./blog.bernatchez.net
# Asegúrese de que el archivo deploy.bunny ejecute realmente un comando "nmx" en lugar de solo mostrarlo.
make pubhtml

# Invoque manualmente el comando impreso en la última línea por el make anterior
# Esto envía todo al caché del CDN
npx --yes bunny-transfer@latest purge blog-bernatchez-net-zone

Advertencia

Una vez que haya invocado "make pubhtml", el contenido de su "sitio local" ya no será adecuado para la visualización local. Si desea navegar tanto la versión local como la versión en línea de forma intercambiable, debe repetir "make html" una vez que haya publicado, dejando así los archivos locales configurados para la visualización local.

Mantenimiento del sitio web

Alcance

El proyecto git está organizado con 2 alcances para el contenido fuente del sitio.

*Alcance de fuente global*

   Los archivos .rst contenidos en subdirectorios del directorio principal del proyecto.
   Estos archivos pueden ser utilizados como fuente por cualquiera de nuestros sitios web.

*Alcance de fuente local*

   Los archivos .rst contenidos en subdirectorios bajo un subdirectorio de sitio dado.
   Estos archivos solo pueden ser utilizados como fuente por el sitio web correspondiente.

El subdirectorio "content" de un sitio dado contiene subdirectorios cuyos
nombres coinciden con subdirectorios de alcance global o local. Eso
determina lo que se incluirá en el sitio.

Los nombres de directorio que aparecen en el directorio "content" determinan
lo que se incluye en el sitio generado.

El archivo make se encarga de poblar dichos directorios con enlaces
simbólicos a los archivos fuente .rst en sus correspondientes directorios
de alcance local o global.

En lo que respecta al repositorio, solo se hace "git add" a los archivos .rst
que están en directorios de alcance global o local. Los
subdirectorios bajo content/ solo contendrán un "placeholder.txt"
dentro de git para asegurarse de que sus subdirectorios sean creados al
clonar.

Fuente pdf

Todos nuestros sitios también contienen versiones .pdf de sus páginas. Para
producir esos archivos pdf, cada directorio fuente también contiene dos
archivos de script ejecutables: **article2pdf** y **qarticle2pdf**.
El segundo es simplemente una versión menos detallada. Cada vez que modifique o
agregue contenido en un directorio fuente, recuerde regenerar los
archivos .pdf según corresponda.

En general, usted modifica su contenido y luego invoca "qarticle2pdf"
para asegurarse de que sus pdfs estén actualizados.

Si ha creado un nuevo directorio fuente, puede generar esos dos scripts
en él invocando el comando "genarticle2pdf -q" dentro del nuevo directorio.

Mantenimiento de github

Cuando clona el proyecto github en un directorio local, obtiene
un directorio principal que contiene subdirectorios de sitios web, cada
uno de ellos es un directorio independiente de generación de sitios web.

El directorio principal del proyecto contiene varios subdirectorios de *alcance de fuente global*
(ej.: ./examples, ./artwork, ./travel,
etc.). Cada uno de estos contiene archivos .rst que pueden servir como fuente
para la generación de contenido del sitio. Todos bajo control de revisión git.

Este contenido de *alcance de fuente global* puede usarse opcionalmente como fuente
para cualquiera de los sitios web.

Cada subdirectorio de sitio web también puede contener sus propios subdirectorios
con archivos .rst de *alcance de fuente local* específicos del sitio
(ej.: ./blog.bernatchez.net/pages/) destinados únicamente al sitio
correspondiente.

Para agregar cualquiera de estos directorios de contenido de *alcance local o global*
a un sitio web dado, debe crear un directorio con el mismo
nombre bajo el subdirectorio content del sitio correspondiente. También debe
agregar un archivo "placeholder.txt" y ponerlo bajo control de revisión
(ej.: git add placeholder.txt) para garantizar que ese nuevo directorio se
cree al usar "git clone".

Por ejemplo, hicimos esto para agregar ./examples al sitio web ./blog.bernatchez.net:

mkdir ./blog.bernatchez.net/content/examples/
cp ./blog.bernatchez.net/content/pages/placeholder.txt ./blog.bernatchez.net/content/examples/
git add ./blog.bernatchez.net/content/examples/placeholder.txt

También debe modificar el archivo .gitignore del proyecto para evitar agregar
los enlaces simbólicos generados bajo content/examples en el repositorio git.
Esos enlaces se regeneran en cada make.

Agregamos las líneas siguientes al archivo .gitignore:

blog.bernatchez.net/content/examples/
blog.bernatchez.net/content/examples/*

Repositorio

La copia central original del repositorio de este proyecto es:

git@github.com:pierrebernatchez/mypelican_static_sites.git

Punto de partida de un artículo

2024-12-06T20:05:03+00:00

Contenido RST de ejemplo para usar como base y modificar para su artículo.

Encabezado principal de su artículo
#############################################

:lang: es
:category: una categoría válida
:date: 2025-10-11 20:03:36+00:00
:tags: artículo, plantilla
:slug: nombre-unico-del-articulo
:authors: Pierre Bernatchez
:summary: Resumen en una línea de su artículo

.. |copy| unicode:: 0xA9 .. signo de copyright

.. |---| unicode:: U+02014 .. guión largo
   :trim:

.. footer:: Copyright |copy| 2025 Pierre Bernatchez |---| todos los derechos reservados.


Comience aquí

Modifique el encabezado principal por algo adecuado para su artículo.

Modifique la categoría por una apropiada para su artículo.

Modifique la fecha. Puede usar el comando de línea de comandos "date -u --rfc-3339=seconds" para obtener una cadena de fecha con el formato correcto.

Modifique las etiquetas con palabras clave relevantes para su artículo.

Modifique el slug para que sea el nombre único de su artículo. Lo usamos como base para el nombre del archivo .rst. Por ejemplo, slugname-en.rst, slugname-es.rst, slugname-fr.rst son los 3 nombres de archivo en los diferentes idiomas para el artículo con el slug: slugname.

Modifique authors con su propio nombre.

Modifique el resumen por algo apropiado para su artículo.

Modifique también el nombre en la línea footer por el suyo.

Escriba su artículo usando el marcado RST, comenzando en comience aquí

Tenga en cuenta que hay dos scripts de Python de conveniencia que pueden generar un punto de partida para un nuevo artículo.

Generar un punto de partida de artículo sin imagen

newarticle -h

usage: newarticle [-h] [-a AUTHOR] [-l {en,fr,es,all}] [-d DUP] [-r]
                  articlename

Generate a skeleton article file

positional arguments:
  articlename           article name without the "-en.rst")

options:
  -h, --help            show this help message and exit
  -a AUTHOR, --author AUTHOR
                        Author for copyright and for authors (default "Pierre
                        Bernatchez)"
  -l {en,fr,es,all}, --lang {en,fr,es,all}
                        language of the new article (default: all)
  -d DUP, --dup DUP     Existing article name to duplicate category and tags
                        (default None)
  -r, --recipe          Treat this as a recipe. (Othewise generic)

O BIEN

Generar un punto de partida de artículo con una imagen

newshot -h

Salida

usage: newshot [-h] [-a AUTHOR] [-l {en,fr,es,all}] [-d DUP] [-j] [-r]
               articlename

Generate a skeleton article file which has a srcreenshot

positional arguments:
  articlename           article name without the "-en.rst")

options:
  -h, --help            show this help message and exit
  -a AUTHOR, --author AUTHOR
                        Author for copyright and for authors (default "Pierre
                        Bernatchez)"
  -l {en,fr,es,all}, --lang {en,fr,es,all}
                        language of the new article (default: all)
  -d DUP, --dup DUP     Existing article name to duplicate category and tags
                        (default None)
  -j, --jpg             Reference image as a .jpg rather than a .png a
                        (default: False)
  -r, --recipe          Treat this as a recipe. (Othewise generic)

Tema «Lightweight» para pelican

2024-12-06T20:02:44+00:00

Descripción

:Creado el: 14 febrero 2011
:Technologias utilisadas: xHTML5, CSS 1-3, polices TTF
:Colores utilisados: Tonos fríos (gris/azul)
:Design extenso: Si
:Probado bajo: Mozilla Firefox 4.0b10, Chromium 9.0.597.83, ELinks 0.12pre5
:Idioma: Español
:Detalles: Ver captura de pantalla y fuente

Este tema se deriva del tema ¨lightweight¨ en francés. Se ha cambiado la pagina principal para mostrar el unico artículo de bienvenida en lugar de una lista completa de artículos. Se ha traducido al español.

Captura de pantalla

Configuración del generador de sitios web Pelican

2024-12-02T17:30:00-05:00

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.

[1]	Utilizamos el paquete venvwrapper para simplificar la gestión de entornos virtuales. Este documento asume este hecho. Si no lo utiliza, debe reemplazar líneas como "venv statsites" por líneas como "source ${HOME}/.venv/statsites/bin/activate".

Organización de los recursos del proyecto

2024-12-02T17:30:00-05:00

At this writing we are maintaining pelican generated static websites, one for blog.bernatchez.net and one for www.ogopogo.biz.

We use our script "compile_rst" to add a few generated .rst files to the source site before using pelican to generate the site from source.

We can generate a list of links to the files in a subdirectory.

Accomplished like this in the Makefile.

$(COMPILE_RST) -p '*.pdf' -s sitepdfs -o pdfs_list -i

That would generate a link for each .pdf file in sitepdfs/ and emit the result to the file pdfs_list.rst

Such a file is intended to be included within one or more of our manually produced .rst pages with a line like:

.. include:: ../../pdfs_list.rst

That would include our generated link list in that page.

We can also generate music album like pages with links to the files in a compilation subdirectory.

Accomplished like this in the Makefile.

$(COMPILE_RST) -p '*.mp3' -s compilations -o album -a

This would generate - possibly - several album_N.rst files in the pages/ subdirectory, where N is a sequence number. You will get as many pages as there are albums referenced in the m3 files in the compilations directory.

Invocations of compile_rst must take place every time the make html target is requested.

For example, the bernatchez_staticweb Makefile contains this

html:

    $(COMPILE_RST) -p '*.mp3' -s compilations -o album -a
    $(COMPILE_RST) -p '*.tar.gz' -s tarballs -o tarballs_list -i
    $(COMPILE_RST) -p '*.pdf' -s sitepdfs -o pdfs_list -i
    $(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS)

So that content/pages/album_N.rst files and tarballs_list.rst, pdfs_list.rst are all regenerated prior to invoking pelican to generate the site.

In short

Files tarballs/*.tar.gz , sitepfds/*.pdf, and compilations/*.mp3 as well as all the .rst files under the content subdirectory determine what goes into our website.

At this writing the content is only proof of concept data.

Capturas De Pantalla De Temas Pelican

2024-12-02T17:30:00-05:00

Orden decreciente de preferencia

lightweight

THEME = "/home/ubuntu/pelican-themes/lightweight"

sneakyidea

THEME = "/home/ubuntu/pelican-themes/sneakyidea"

basic

THEME = "/home/ubuntu/pelican-themes/basic"

notmyidea-cms

THEME = "/home/ubuntu/pelican-themes/notmyidea-cms"

notebook

THEME = "/home/ubuntu/pelican-themes/notebook"

cebong

THEME = "/home/ubuntu/pelican-themes/cebong"

relapse

THEME = "/home/ubuntu/pelican-themes/relapse"

bold

THEME = "/home/ubuntu/pelican-themes/bold"

bootstrap2-dark

THEME = "/home/ubuntu/pelican-themes/bootstrap2-dark"

franticworld

THEME = "/home/ubuntu/pelican-themes/franticworld"

Mantenimiento De Temas

2024-12-02T17:30:00-05:00

Notes regarding selecting and tweaking pelican themes used with our sites.

To be able to use/tweak pelican themes for my pelican projects I cloned the full collection of pelican themes to my local machine.

git clone --recursive https://github.com/getpelican/pelican-themes /home/ubuntu/pelican-themes

I then replicated the tree to use as a basis for getting a diff to identify any changes that I made during the course of tweaking themes I use.

cp -r ${HOME}/pelican-themes ${HOME}/pelican-themes.orig
chmod -w --recursive ${HOME}/pelican-themes.orig  # To make my orig write protected for reliable diffs later.

Do this once in a while as we tweak themes we are using, so we can keep a record of our tweaks.

cd ${HOME}/pelican-themes
diff -Naru ../pelican-themes.orig . > ../pelican-themes.patch

Note:

-N --new-file treat absent files as empty

-a --text treat all files as text

-r --recursive recursively compare subdirectories

-u -U --unified[=NUM] Output NUM lines of unified context (default 3)

Temas Pelican

2024-11-18T20:41:00-05:00

sneakyidea

THEME = "/home/ubuntu/pelican-themes/sneakyidea"

lightweight

THEME = "/home/ubuntu/pelican-themes/lightweight"

basic

THEME = "/home/ubuntu/pelican-themes/basic"

notmyidea-cms

THEME = "/home/ubuntu/pelican-themes/notmyidea-cms"

bold

THEME = "/home/ubuntu/pelican-themes/bold"

Nota de clonación de Github

2015-03-19T11:47:31-04:00

Si acabas de clonar el repositorio « mypelican_static_sites », debes seguir algunos pasos antes de generar los sitios.

Requisitos previos

Nuestras compilaciones para los sitios que se mantienen aquí dependen del proyecto « flitprojects », que también está bajo control de versiones en nuestra cuenta de Github. Ese proyecto utiliza entornos virtuales de Python. Por lo tanto, asumimos que hay un entorno virtual adecuado configurado, y que hemos ejecutado flit build y flit install en él para el paquete « flitprojects/articleware ».

Pasos de configuración tras clonar « mypelican_static_sites » por primera vez

Instalar los scripts para generar las versiones PDF de todos los artículos. Estos scripts se generan automáticamente y, por lo tanto, no se mantienen bajo control de versiones. Usamos un script bash para identificar la lista de subdirectorios de sitios y generar nuestros scripts dentro de cada uno de ellos.

allputs.sh
# esto genera un par de scripts en cada subdirectorio
# que contiene archivos .rst de artículos.

Una vez generados los scripts, necesitamos producir todos los archivos .pdf. Para hacerlo, accedemos a cualquiera de los subdirectorios del sitio y usamos make para generar los archivos .pdf.

cd www.bernatchez.net
make pdfs

Genera las versiones locales de tus sitios para verificar que estén listos para publicar.

cd www.bernatchez.net
make html
cd ..

cd blog.bernatchez.net
make html
cd ..

cd www.ogopogo.biz
make html
cd ..

cd docs.pelican.bernatchez.net
make html
cd ..

Genera las versiones publicables de tus sitios y publícalos.

cd www.bernatchez.net
make pubhtml
cd ..

cd blog.bernatchez.net
make pubhtml
cd ..

cd www.ogopogo.biz
make pubhtml
cd ..

# Usar solo la versión del sistema de archivos para este, no generar.
# No mantenemos el sitio con el CDS bunny.
cd docs.pelican.bernatchez.net site
echo 'No mantenemos el sitio "docs.pelican.bernatchez.net" con el CDS bunny.'
cd ..

El uso de make con « pubhtml » genera URLs en línea dentro de muchos de los enlaces del contenido. Esto es incompatible con el contenido generado por make « html », cuyos enlaces deben ser todos relativos al sistema de archivos. Esto significa que el contenido en el sistema de archivos local deja de ser válido inmediatamente después de generar el contenido « pubhtml ». Por lo tanto, debemos volver a ejecutar make « html » una vez publicado el contenido para revertir el contenido local a su estado correcto.

cd www.bernatchez.net
make html
cd ..

cd blog.bernatchez.net
make html
cd ..

cd www.ogopogo.biz
make html
cd ..

Soluciónando Problemas De Generación Del Sitio

2015-03-19T11:47:31-04:00

I intend to keep adding to this note as further issues crop up and workarounds are discoverd.

1- I found that when we use the same slug for different language versions of the same article.

pelican does a nice job of picking out the current default language's version for the site. When no version exists which matches the current default language, then pelican emits warnings and/or errors regarding the other language versions.

The work around is to always make sure you have all the language versions you are supporting, or just a single one. When that is the case it seems to behave adequately.

It seems sensible to translate attribute values too, other than slug of course.