Note de clonage Github
Si 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 gérés ici reposent sur le projet « flitprojects », qui est également sous contrôle de version dans notre compte Github. Ce projet utilise des environnements virtuels Python. Nous supposons donc qu'un environnement virtuel adéquat est configuré, et que nous avons exécuté flit build et flit install dans celui-ci pour le paquet « flitprojects/articleware ».
Étapes de configuration après un nouveau clonage de « mypelican_static_sites »
- 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 sites 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.
- Une fois les scripts générés, nous devons produire tous les fichiers .pdf. Pour ce faire, on accède à l'un des sous-répertoires de site et on utilise make pour générer les fichiers .pdf.
cd www.bernatchez.net make pdfs
- Générez vos versions locales des sites afin de vérifier qu'elles sont prêtes à être publiées.
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 ..
- 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 système de fichiers pour celui-ci, ne pas générer. # Nous ne maintenons pas le site avec le CDS bunny. cd docs.pelican.bernatchez.net site echo 'Nous ne maintenons pas le site "docs.pelican.bernatchez.net" avec le CDS bunny.' cd ..
- L'utilisation de make avec « pubhtml » génère des URL en ligne dans de nombreux liens du contenu. Cela 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 son état correct.
cd www.bernatchez.net make html cd .. cd blog.bernatchez.net make html cd .. cd www.ogopogo.biz make html cd ..