Mise en place des stats Chatons (https://stats.chatons.org/)
Go to file
Thomas Constans 19f6a64eca remove dokuwiki: not a service per se 2021-07-21 17:58:34 +02:00
README.md instructions de déploiement et mise à jour 2021-06-03 08:39:34 +02:00
hadoly.properties remove dokuwiki: not a service per se 2021-07-21 17:58:34 +02:00
service-etherpad.properties correction date de création, adhésion collectif et type d'enregistrement jitsi et etherpad 2021-06-02 23:25:48 +02:00
service-gitea.properties MAJ Versions suite upgrade 2021-06-11 18:44:10 +02:00
service-jitsi.properties correction date de création, adhésion collectif et type d'enregistrement jitsi et etherpad 2021-06-02 23:25:48 +02:00
service-kanboard.properties MAJ Versions suite upgrade 2021-06-11 18:44:10 +02:00
service-mail.properties MAJ Versions suite upgrade 2021-06-11 18:44:10 +02:00
service-matrix.properties MAJ Versions suite upgrade 2021-06-11 18:44:10 +02:00
service-nextcloud.properties correction des erreurs et avertissements renvoyés par le site 2021-06-01 22:17:11 +02:00
service-privatebin.properties fix #2 2021-06-14 22:06:54 +02:00
service-wiki.properties fix #2 2021-06-14 22:06:54 +02:00

README.md

ChatonsInfos

Utilisation

À chaque mise à jour, aller sur merlin, dans /var/www/StatsChatons et faire un git pull afin de récupérer la dernière version

En cas de changement de l'url d'appel (https://www.hadoly.fr/.well-known/chatonsinfos/hadoly.properties) il faut prévenir le collectif

Mise à jour d'un service

En cas de changement de version d'un service, il convient de mettre à jour la fiche adéquate.

La version est stockée dans la clé software.version

Une fois les modifications comitées, faire un git pull depuis merlin (voir ci-dessous)

Comment contribuer

il suffit de relire les fichiers properties existants (hadoly.properties et service-XX.properties) ou de rajouter un service manquant.

Pour rajouter un service: il suffit de copier depuis le dossier MODELES le fichier service...properties correspondant au service à décrire (si ça se trouve il en existe déjà un).

Il suffit ensuite de l'éditer et de le compléter, en s'attardant sur les éléments marqués comme "obligatoire" et "recommandé"

il faut ensuite déployer les fichiers sur merlin : Aller dans le répertoire /var/www/StatsChatons/ et faire un git pull

# sur merlin
cd /var/www/StatsChatons/
sudo git pull

WTF ?

ChatonsInfos est un protocole de partage de données sur le collectif, ses membres et leurs services.

Lidée est de faire ça de façon simple et légère via des fichiers de description accessibles par lien web : 1 fichier par chaton et 1 fichier par service.

Maintenus en autonomie par les chatons volontaires, ces fichiers seront collectés régulièrement et valorisés dans le futur site https://stats.chatons.org/.

En favorisant un partage dinformation sur les chatons et leurs services, les résultats attendus sont :

  • une meilleure visibilité des chatons et de leurs services ;
  • une mesure de lactivité des services : même incomplète ou partielle, cela donnera idée de lactivité globale.

LICENCE

Sauf mention contraire, les documents du projet ChatonsInfos sont diffusés sous la licence libre Creative Commons CC-BY-SA.

AUTEUR

Le collectif CHATONS.

DOCUMENTATION

Plan de la documentation :

  • README.md : accueil ;
  • CONCEPTS.md : les concepts fondamentaux ;
  • FAQ.md : une foire aux questions ;
  • MODELES/federation.properties : modèle de fihcier properties pour le collectif CHATONS ;
  • MODELES/organization.properties : modèle de fichier properties pour un membre du collectif CHATONS ;
  • MODELES/services.properties : modèle de fichier properties générique pour un service logiciel d'un membre du collectif CHATONS ;
  • MODELES/services-xxxxx.properties : modèle de fichier properties d'un logiciel précis, utile pour les métriques spécifiques.
  • StatoolInfos/ : dossier de configuration de l'outil StatoolInfos, le générateur des pages de https://stats.chatons.org/.

À propos du logo :

  • fichier : logo_ChatonsInfos.jpg ;
  • source : projet StatoolInfos ;
  • auteur: Christian Pierre MOMON christian.momon@devinsy.fr
  • licence: Creative Commons CC-BY-SA last version.