adriallard@gmail.com, last update time : 2021-07-04

Documentation technique www.philibert-vrau.com

Remarque générale sur l'architecture. En 2011, le principe de base initial était d'avoir quelque chose de gratuit et d'assez solide pour durer plus de 10 ans. 10 ans plus tard, en 2021, je confirme que ces principes sont respectés. Cependant il faut constater la vieillesse du mode de fonctionnement. L'architecture n'a rien de l'agilité des solutions modernes. Il vous faut respecter la méthode "old-school", presque comme l'édition d'un livre papier, qui veut que l'on planifie scrupuleusement chaque mise à jour du contenu : les pages web concernées, le texte à changer, la mise en page, les illustrations et leur positionnement. Cette architecture archaïque ne permet pas les modifications itératives et "WYSIWYG" comme le permettrait un gestionnaire de contenu comme wordpress. On ne peut pas éditer, voir ce que ça donne, ré éditer etc. Car chaque cycle demande des opérations manuelles coûteuses et sensibles (qu'il est acceptable de faire une fois, mais pas dix fois.)

Description des scripts principaux

Ces scripts ont été conçus pour être utilisés sous linux. Ils servent à générer les pages web et les galeries photos

Voici les plus importants : parse_all.sh va générer les html. Si le résultat vous convient, utilisez ensuite upload_all.sh pour publier les fichiers chez l'hébergeur.

Moins courant :

• Si vous modifiez la banque d'images, vous devez regénérer les galeries en faisant photo_gen_gallery_wrapper. La banque d'images fonctionne selon les principes suivants
  • La banque est située ici /images/banque. Tous les originaux sont dans ce dossier et ses sous-dossiers
  • Une image peut appartenir à plusieurs dossiers. Il faut copier coller dans tous les dossiers qui vous semblent pertinents
  • exemple de hiérarchie :

    ./a-0albums                                  => albums à thème
    ./a-0albums/a-pool_illu_pages                => album / images servant d'illustration au site web
    ./a-0albums/a-projet_bd                      => album / photos prises dans Lille, utilisées pour alimenter le projet BD
    ./a-0albums/a-phototheque                    => album / photothèque légendée, la plus intéressante à explorer pour le visiteur
    ./l-0lieux                                   => dans ce dossier on classe les photos par lieux
    ./l-0lieux/l-lille
    ./l-0lieux/l-patronage_st_leonard
    ./l-0lieux/l-usine_vrau
    ./l-0lieux/l-crypte                          => lieux / crypte de la cathédrale de Lille
    ./l-0lieux/l-icam
    ./l-0lieux/l-la_catho
    ./l-0lieux/l-congres_eucharistiques
    ./portraits                                  => les portraits de Philibert et Camille ne sont pas légions. Ici est la collection
          

• Si vous voulez rajouter de nouvelles illustrations sur les pages web, rangez vos images originales dans le dossier images/banque/a-0albums/a-pool_illu_pages, puis lancez resize_to_150_px_width.sh. Vos images arriveront à la bonne taille (150px de large), dans le dossier images/, et au format PNG.

Tous les scripts sont à lancer sans argument, et peuvent être lancés sans risque.

Description de tous les scripts

include.sh Ce script contient tous les paramètres. Par exemple le dossier racine sur votre ordinateur, le chemin vers la gallerie etc.

photo_gen_gallery_wrapper Utilisez ce script pour re-générer les galeries photo et transformer les liens por qu'ils fonctionnent une fois sur l'URL internet.

photo_change_comment.sh Permet de mettre à jour la légende d'une photo. Cette légende sera appliquée dans la galerie photo, dans la colonne des commentaires. Le script va vous demander le nom du fichier, puis fera une recherche de ce nom dans tous les dossiers, et vous demandera la nouvelle légende à appliquer sur les photos trouvées.

photo_gen_gallery Ce script ne doit pas être appelé directement. il est appelé par le wrapper

photo_gen_gallery_switch_host.sh Ce script ne doit lui non plus pas être appelé directement. il est aussi appelé par le wrapper.

resize_corner_picture.sh Ce script sert à redimensionner la photo de jaquette, qui est stockée dans la banque d'images. Le chemin vers la photo est dans le fichier include.sh

resize_to_150_px_width.sh Toutes les images qui se trouvent dans le bandeau des illustrations (bandeau vertical de droite) doivent faire 150px de large.

parse_html_files.pl N'utilisez pas ce script directement. Il est appelé en faisant parse_all.sh

parse_all.sh Ce script va parser tous les templates et générer les fichiers html finaux

upload_all_files.sh Envoie tout sur l'hébergeur

Google analytics pour le téléchargement des PDF

http://www.blastam.com/blog/index.php/2013/03/how-to-track-downloads-in-google-analytics-v2

Accès restreint pour l'Espace membre (2014-09-01)

Utilisateur et mot de passe sont "bruno", "cazin"

La page web espace_membres.html est dans le répertoire
(philibert vrau)/documents/prive/. Dans ce même répertoire, il y'a deux 
fichiers : .htaccess, .htpasswd. Dont le contenu est :
$ cat .htaccess
AuthName "Fichiers des membres. Mot de passe requis."
AuthType Basic
AuthUserFile "/home/web/philibert-vrau.com/www/documents/prive/.htpasswd"
Require valid-user
$ cat .htpasswd
bruno:$apr1$TtK5GNpD$lzACRMoXkkNKfb3XGWHb40

On génère ainsi la clef de .htpasswd :
$ htpasswd -c (philibert vrau)/documents/prive/.htpasswd bruno