docs.pelican.bernatchez.net

Vous pouvez cloner le contenu d'un site depuis github dans le répertoire courant avec cette commande.

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

Lorsque vous venez de cloner le dépôt « mypelican_static_sites », vous devez effectuer quelques étapes avant de générer les sites.

prérequis

Nos compilations pour les sites maintenus ici reposent sur le projet « flitprojects », qui est également sous contrôle de révision dans notre compte github. Ce projet dépend d'environnements virtuels Python. Nous supposons donc qu'un environnement virtuel adéquat est configuré, et que nous avons effectué flit build ainsi que flit install dans celui-ci pour le paquet « flitprojects/articleware ».

Étapes de configuration pour un dépôt « mypelican_static_sites » fraîchement cloné

1. Installer les scripts pour générer les versions PDF de tous les articles. Ces scripts sont générés et ne sont donc pas conservés sous contrôle de version. Nous utilisons un script bash pour identifier la liste des sous-répertoires de site et générer nos scripts dans chacun d'eux.

allputs.sh
# ceci génère une paire de scripts dans chaque sous-répertoire
# qui contient des fichiers .rst d'articles.

2. Une fois les scripts générés, nous devons obtenir tous les fichiers .pdf générés. Pour ce faire, nous allons dans l'un des sous-répertoires de site et utilisons make pour générer les fichiers .pdf.

cd www.bernatchez.net
make pdfs

3. Générez vos versions locales de vos sites afin de vérifier qu'ils sont prêts.

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. Générez les versions publiables de vos sites et publiez-les.

cd www.bernatchez.net
make pubhtml
cd ..

cd blog.bernatchez.net
make pubhtml
cd ..

cd www.ogopogo.biz
make pubhtml
cd ..

# Utiliser uniquement la version du système de fichiers pour celui-ci, ne pas générer.
# Nous ne maintenons pas ce site avec le CDS bunny.
cd docs.pelican.bernatchez.net site
echo 'We do not maintain the site "docs.pelican.bernatchez.net" with the bunny CDS.'
cd ..

5. La commande make avec « pubhtml » produit des emplacements en ligne dans bon nombre des liens du contenu. Ceci est incompatible avec le contenu généré par make « html », dont les liens doivent tous être relatifs au système de fichiers. Cela signifie que le contenu sur le système de fichiers local n'est plus valide immédiatement après la génération du contenu « pubhtml ». Nous devons donc relancer make « html » une fois le contenu publié afin de rétablir le contenu local dans l'état attendu.

cd www.bernatchez.net
make html
cd ..

cd blog.bernatchez.net
make html
cd ..

cd www.ogopogo.biz
make html
cd ..