docs.pelican.bernatchez.net

Puede clonar el contenido de un sitio desde github en el directorio actual con este comando.

cd my-repodirectory
git clone git@github.com:pierrebernatchez/mypelican_static_sites.git

Cuando acaba de clonar el repositorio « mypelican_static_sites », necesita seguir algunos pasos antes de generar los sitios.

requisitos previos

Nuestras compilaciones para los sitios mantenidos aquí dependen del proyecto « flitprojects », que también está bajo control de revisión en nuestra cuenta de github. Ese proyecto depende de 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 para un repositorio « mypelican_static_sites » recién clonado

1. Instalar los scripts para generar las versiones PDF de todos los artículos. Estos scripts son generados, por lo que no se mantienen bajo control de versiones. Usamos un script bash para identificar la lista de subdirectorios de sitio 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.

2. Una vez generados los scripts, necesitamos obtener todos los archivos .pdf generados. Para ello, vamos a cualquiera de los subdirectorios de sitio y usamos make para generar los archivos .pdf.

cd www.bernatchez.net
make pdfs

3. Genere sus versiones locales de sus sitios para verificar que estén listos para publicarse.

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 ..

4. Genere las versiones publicables de sus sitios y publíquelas.

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 este sitio con el CDS de bunny.
cd docs.pelican.bernatchez.net site
echo 'We do not maintain the site "docs.pelican.bernatchez.net" with the bunny CDS.'
cd ..

5. El comando make con « pubhtml » produce ubicaciones 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 ..