LINUX:ExpoActes
→ retour au menu du serveur Web
But
ExpoActes est un programme serveur qui permet de gérer les dépouillements d'actes et tables des états civils et des registres paroissiaux. Il est libre. Il n'est pas conçu pour créer un arbre généalogique mais plutôt pour aider une recherche généalogique.
Un acte d'état civil ou religieux est très souvent manuscrit et n'a pas une structure standardisée. Ce logiciel permet d'organiser dans une base de données les données essentielles extraites de ces documents de façon à faciliter des recherches. Il est possible de lier une fiche à une image de ce document.
Il est possible d'introduire des actes directement via l'interface Web mais cette façon est peu recommandée; il est conçu pour un chargement de données contenu dans un fichier de type CSV que l'on peut créer par Microsoft-Excel ou LibreOffice-Calc.
On peut avoir plus d'informations sur ce logiciel à l'URL: https://expocartes.monrezo.be/index.php
Une aide est disponible dans le logiciel; elle peut être consultée à l'URL: https://expoactes.monrezo.be/actes/admin/aide/aide.html
Notons que ce logiciel est présenté en français seulement.
Installation
Prérequis
Ce logiciel nécessite:
- un serveur Web Apache
- un gestionnaire de base de données de type MySQL tel MariaDB
- un interpréteur PHP; la version 8.0 fonctionne sans problème; ce n'est pas le cas de la version 8.3
Dans mon cas, ces produits sont tous sur une même machine Linux
Téléchargement
A l'URL citée ci-dessus, il y a un lien vers le téléchargement du logiciel.
Sous Linux, on peut effectuer la commande:
wget https://expocartes.monrezo.be/download/expoactes-3.2.4-final.zip
pour la dernière version 3.2.4 (en mai 2024).
On décompresse ce fichier:
unzip expoactes-3.2.4-final.zip
Un répertoire "actes" contenant le logiciel est crée.
Apache
On déplace ce répertoire "actes" parmi nos autres sites Web; dans notre exemple sous le répertoire "/web".
ATTENTION: L'exemple de configuration le présente comme un des sites de votre domaine. Si ce site doit être accessible en direct, cette configuration qui suit doit être adaptée en conséquence.
On crée une configuration pour ce site dans Apache. In crée un fichier "actes.conf" dans le répertoire "/etc/httpd/conf.d":
Alias "/actes" "/web/actes" <Directory "/web/actes"> Options +FollowSymLinks -Indexes AllowOverride All # forcer l'utilisation de PHP 8.0 IncludeOptional conf.d/php80.cfg </Directory>
Comme par défaut, Fedora 40 vient avec la version 8.3 de PHP, on utilise la version 8.0 de PHP précédente provenant du dépôt de Remi; voyez l'article sur Coexistence de plusieurs versions de PHP. D'où la ligne:
IncludeOptional conf.d/php80.cfg
On relance le service Apache pour prendre en compte cet ajout:
systemctl restart httpd.dervice
Droits
Ce répertoire doit appartenir à l'utilisateur "apache" sous lequel s'exécute le service 'httpd.service":
chown -R apache:apache /web/actes
Pour la phase de configuration, il est préférable de lui donner tous les droits lecture et écriture:
chmod -R 750 /web/actes find /web/actes -type f -print0 | xargs -0 chmod 640
Car certains des sous-répertoires vont être renommés et un fichier de paramètres sera créé. Ces répertoires commencent par un underscore ("_") et ont l'extension ".init"; cette extension sera éliminée.
Après cette phase de première installation, on diminuera les droits à la seule lecture sauf pour les répertoires commencent par un underscore ("_"):
chmod -R 550 /web/actes find /web/actes -type f -print0 | xargs -0 chmod 440 #chmod -R 750 /web/actes/_config #find /web/actes/_config -type f -print0 | xargs -0 chmod 640 #chmod -R 750 /web/actes/img_act #find /web/actes/img_act -type f -print0 | xargs -0 chmod 640 chmod -R 750 /web/actes/admin/_upload find /web/actes/admin/_upload -type f -print0 | xargs -0 chmod 640 chmod -R 750 /web/actes/_logs find /web/actes/_logs -type f -print0 | xargs -0 chmod 640 chmod -R 750 /web/actes/_backup find /web/actes/_backup -type f -print0 | xargs -0 chmod 640
Les répertoires suivants contiendront:
- _config : le fichier de configuration et quelques fichiers dont le contenu s'afficheront dans les pages.
- img_act : les images des actes; le logiciel ne les y met pas de lui-même; il faudra les y placer par vos propres moyens (FTP,...)
- _upload : Lors du chargement de fichier CSV, ce fichier passera par ce répertoire. Vous y trouverez aussi vos fichiers de vos propres modèles de chargement.
- _logs : fichiers journaux du module ECLAIR
- _backup : fichiers de sauvegarde
MariaDB
Avant tout début de configuration, la base de données MariaDB (MySQL) doit comprendre un schéma vide qui va accueillir vos données.
Nous avons nommé ce schéma "expoactes".
Voici le script SQL qui permet de le créer à vide; on nomme ce script: "schema.sql":
DROP SCHEMA IF EXISTS expoactes ; CREATE SCHEMA expoactes ;
On l'exécute via la commande:
mysql --user=root --password=<MOT_DE_PASSE_DE_ROOT> < ./schema.sql
avec un nom d'utilisateur de la base de donnés qui a les droits administrateur.
Il nous faut en outre, créer un utilisateur dans cette base de données qui a tous les droits sur ce schéma nouvellement créé.
On lui a donné le nom "expoactes". C'est lui que le logiciel utilisera pour accéder à nos données.
Voici le script SQL qui permet de le créer et de lui attribuer des droits nécessaires; on nomme ce script: "user.sql":
create user 'expoactes'@'localhost' identified by '<MOT_DE_PASSE_EXPOACTES>' ; grant all privileges on expoactes.* to 'expoactes'@'localhost';
Vous y remplacez le mot de passe "<MOT_DE_PASSE_EXPOACTES>" par celui désiré.
On l'exécute via la commande:
mysql --user=root --password=<MOT_DE_PASSE_DE_ROOT> < ./user.sql
avec un nom d'utilisateur de la base de donnés qui a les droits administrateur.
De GoogleMap vers OpenStreetMaps
Lors de l'utilisation, on s'aperçoit rapidement que le module "Carte" ne fonctionne pas si on utilise GoogleMap.
Nous avons préféré migrer vers les cartes d'OpenStreetMaps. Il faut alors modifier le code source du logiciel. Nous nous sommes basés sur les suggestions du site: https://www.eldin.net/wordpress/index.php/expoactes/ mais il a fallu y apporter quelques modifications pour que cela fonctionne.
→ retour au menu du serveur Web