geotribu/cli

Outil en ligne de commande pour gérer les tâches récurrentes du workflow Geotribu.

Geotribu CLI

Outil en ligne de commande pour les tâches récurrentes du projet Geotribu.

Installer

Via pip :

pip install geotribu

Via Docker :

docker pull ghcr.io/geotribu/cli

Via un exécutable pré-compilé : télécharger pour son système d'exploitation.

Utiliser

Installation locale :

geotribu --help

Ou avec l'image Docker :

docker run --rm ghcr.io/geotribu/cli:latest geotribu --help

Pour plus d'informations, consulter la documentation.

cli's Issues

Lister les images doublonnées et inutilisées pour nettoyer le CDN

Lors de la restauration du site en 2020, j'avais téléversé toutes les images archivées, téléchargées depuis web archives etc dans le CDN. Pour faciliter la recherche d'images, j'ai intégré plus tard la génération d'un index de recherche avec la même techno que celle utilisée pour les contenus dans Mkdocs (lunr) : https://cdn.geotribu.fr/img/search-index.json

Le CDN reste un sacré bordel avec pas mal de doublons, certains "homozygotes" (exactement identiques), d'autres "hétérozygotes" (presque pareils mais pas tout à fait, dans un autre format, à quelques pixels, près, etc.). Il y a aussi les images inutilisées dans les contenus (site principal et guide de contribution) et qu'on peut donc supprimer pour libérer de la place.

Objectifs :

• ajouter le poids en octets dans l'index (sous-objet images)
• lister les images doublonnées
• lister les images inutilisées

Mastodon : faire correspondre la notion de thread dans Isso avec celle de Mastodon

PRs avec des trucs déjà amorcés à l'arrache :

• #127
• #182

Aide à l'édition : vérificateur de l'en-tête des fichiers markdown

À l'instar de nombreux outils de gestion de contenu basés sur le markdown, pas mal de fonctionnalités du site Geotribu et du workflow de publication sont liés à l'en-tête YAML : https://contribuer.geotribu.fr/guides/metadata_yaml_frontmatter/

L'idée serait donc d'ajouter une commande permettant de valider un fichier Markdown au regard des contraintes pour automatiser un peu plus la review des articles proposés.

On peut démarrer avec quelques pistes de checks à faire :

• le nom de/s auteur/ices correspond/ent ils à un fichier team/{{trigramme}}.md
• la date est-elle bien dans le futur
• vérifier que le ratio de l'image, si elle est définie, soit conforme
• vérifier que la/les catégorie/s soient parmi celles listées
• vérifier que les tags sont dans l'ordre alphabétique

L'idéal serait que la commande sorte un texte en markdown et qu'on soit en mesure de la faire tourner dans la CI. Mais bon sur ce point, il faudrait d'abord résoudre l'ambiguité sur quel contenu est à publier et donc à checker.

À noter qu'il y a déjà des amorces dans le code avec python-frontmatter mais que c'est éparse ou à refaire. D'ailleurs, il serait peut-être plus intéressant de lire les fichiers Markdown avec Mkdocs pour utiliser le même outil.

Mastodon : automatiser l'export des listes et comptes sur un dépôt dédié

C'est plutôt la suite de l'article https://geotribu.fr/articles/2024/2024-02-16_de-twitter-a-mastodon-guide-geo-import-liste-comptes/

L'idée globale est d'utiliser https://cli.geotribu.fr/usage/examples.html#exporter-les-donnees-du-compte-mastodon dans une GitHub Action qui se lance manuellement et régulièrement pour héberger les listes et comptes à télécharger dans l'article. Histoire que ça reste à jour et que le seul travail soit de MAJ les listes depuis Mastodon.

Pour ce qui est de github action, le trigger manuel et régulier peut être copié/collé depuis https://github.com/geotribu/ign-fr-opendata-download-ui/blob/main/.github/workflows/run_n_publish.yml#L3-L10

@gounux ça t'intéresse ?