Mini application web permettant d'historiser des pads (etherpad) et les archiver dans un dépôt git.

Logiciel libre sous license AGPL V3

Installation des dépendances :

sudo aptitude install php git

Récupération des sources :

git clone https://github.com/24eme/histopad.git

Pour tester l'application :

php -S localhost:8000

Configuration des droits apache sur les dossiers cache, queue et pads :

sudo chown www-data:www-data cache queue pads

Configuration Apache :

DocumentRoot /path/to/histopad

<Directory /path/to/histopad>
    Require all granted
</Directory

L'application permet de suivre les modifications de pads.

À chaque tentative de mise à jour la date de prochaine tentative de mise à jour est calculé en ajoutant la même durée d'ancienneté de la dernière modifications à la date du jour.

Ainsi un pad qui a eu une modification il y a un mois et demi sera à mettre à jour dans un mois et demi.

La routine run.php va permettre d'aller vérifier si des pads sont à mettre à jour.

Cette routine est lancé automatiquement à chaque appel de page, donc si la page est consulté souvent les modifications d'un pad seront suivi.

Si l'on souhaite tracker les modifications de façon plus fiable il est possible de faire cette vérification via crontab.

Vérifie toutes les 5 minutes si des pads sont à mettre à jour via curl :

*/5  *  *  *  * curl -s http://url_de_l_appli/run.php

Il est possible d'ajouter des pads en ligne de commande.

Ajout d'un pad unique :

curl http://url_de_l_appli/archive.php?url=https://url_vers_le_pad_a_archiver/p/code_du_pad

Le script archive.php permet aussi d'extraire les urls de pads depuis n'importe quel contenu de texte et tous les ajouter :

cat /tmp/contenu_contenant_des_urls_de_pads | curl http://url_de_l_appli/archive.php --data-binary @-

Par exemple, au 24ème on se sert de notre canal irc pour archiver des pads, en envoyant le log de la discussion irc au script archive.php, les derniers pads sont archivés automatiquement.