Utilisation en ligne de commande¶
Une fois l’outil installé, il est appelable en ligne de commande : geotribu.
Fonctionnement général¶
Geotribu en ligne de commande pour rechercher dans les contenus et les images, consulter les derniers contenus sans quitter son terminal. Encore meilleur avec les terminaux gérant les hyperliens : Bash, PowerShell 5+, etc.
Commandes et options¶
Geotribu Toolbelt 0.34.3 - Une ligne de commande pour Geotribu qui offre des outils pour rechercher et consulter les contenus et images, et faciliter les tâches récurrentes des contributeur/ices.
geotribu [-v] [--no-logfile] [-h] [--version]
{read-latest,récents,latest,rl,rss,search-content,contenus,sc,search-image,si,ouvrir,lire,open,or,read,upgrade,auto-update,maj,update,header-check,header,check,metadata,creer,new,nouveau,comments,commentaires,coms,images,img,social,rezosocio}
...
geotribu options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG. Réglable avec la variable d’environnement GEOTRIBU_LOGS_LEVEL. (default:1
)--no-logfile
- Désactiver les fichiers de journalisation (logs).--version
- Affiche la version du CLI et s’arrête là.
read-latest (récents, latest, rl, rss)¶
Consulter les derniers contenus du site
read-latest [-h] [-v] [-r REMOTE_INDEX_FILE] [-l LOCAL_INDEX_FILE] [-n RESULTS_NUMBER]
[-f {article,rdp}] [-x EXPIRATION_ROTATING_HOURS] [-o {table}] [--no-prompt]
read-latest options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG (default:1
)-r
REMOTE_INDEX_FILE
,--remote-index-file
REMOTE_INDEX_FILE
- Emplacement du fichier distant. (default:https://geotribu.fr/feed_rss_created.xml
)-l
LOCAL_INDEX_FILE
,--local-index-file
LOCAL_INDEX_FILE
- Emplacement du fichier local. (default:/home/runner/.geotribu/rss/rss.xml
)-n
RESULTS_NUMBER
,--results-number
RESULTS_NUMBER
- Nombre de résultats à retourner. (default:5
)-f
FILTER_TYPE
,--filter-type
FILTER_TYPE
- Filtrer sur un type de contenu en particulier. (default:None
)-x
EXPIRATION_ROTATING_HOURS
,--expiration-rotating-hours
EXPIRATION_ROTATING_HOURS
- Nombre d’heures à partir duquel considérer le fichier local comme périmé. (default:24
)-o
FORMAT_OUTPUT
,--format-output
FORMAT_OUTPUT
- Format de sortie. (default:table
)--no-prompt
- Désactive le prompt demandant le résultat à ouvrir à la fin de la commande.
search-content (contenus, sc)¶
Rechercher dans les contenus du site
search-content [-h] [-v] [-r REMOTE_INDEX_FILE] [-l LOCAL_INDEX_FILE]
[-f GEOTRIBU_CONTENUS_DEFAULT_TYPE] [-ds GEOTRIBU_CONTENUS_DATE_START]
[-de GEOTRIBU_CONTENUS_DATE_END] [-n GEOTRIBU_RESULTATS_NOMBRE]
[-x GEOTRIBU_CONTENUS_INDEX_EXPIRATION_HOURS] [-o GEOTRIBU_RESULTATS_FORMAT]
[-a] [--no-prompt]
search-term
search-content positional arguments¶
search-term
- Terme de recherche. Accepte les filtres sur les champs indexés : tags ou title. Exemple :'ubuntu title:qgis'
(default:None
)
search-content options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG (default:1
)-r
REMOTE_INDEX_FILE
,--remote-index-file
REMOTE_INDEX_FILE
- Emplacement du fichier distant. (default:https://geotribu.fr/search/search_index.json
)-l
LOCAL_INDEX_FILE
,--local-index-file
LOCAL_INDEX_FILE
- Emplacement du fichier local. (default:/home/runner/.geotribu/search/site_search_index.json
)-f
GEOTRIBU_CONTENUS_DEFAULT_TYPE
,-ft
GEOTRIBU_CONTENUS_DEFAULT_TYPE
,--filter-type
GEOTRIBU_CONTENUS_DEFAULT_TYPE
- Filtrer sur un type de contenu en particulier. (default:None
)-ds
GEOTRIBU_CONTENUS_DATE_START
,--depuis
GEOTRIBU_CONTENUS_DATE_START
,--date-start
GEOTRIBU_CONTENUS_DATE_START
- Date la plus ancienne sur laquelle filtrer les contenus (format: AAAA-MM-JJ). Valeur par défaut : 2020-01-01 (default:2020-01-01
)-de
GEOTRIBU_CONTENUS_DATE_END
,--jusqua
GEOTRIBU_CONTENUS_DATE_END
,--date-end
GEOTRIBU_CONTENUS_DATE_END
- Date la plus récente sur laquelle filtrer les contenus (format: AAAA-MM-JJ). Valeur par défault : date du jour. (default:2025-05-20
)-n
GEOTRIBU_RESULTATS_NOMBRE
,--results-number
GEOTRIBU_RESULTATS_NOMBRE
- Nombre de résultats à retourner. (default:5
)-x
GEOTRIBU_CONTENUS_INDEX_EXPIRATION_HOURS
,--expiration-rotating-hours
GEOTRIBU_CONTENUS_INDEX_EXPIRATION_HOURS
- Nombre d’heures à partir duquel considérer le fichier local comme périmé. (default:168
)-o
GEOTRIBU_RESULTATS_FORMAT
,--format-output
GEOTRIBU_RESULTATS_FORMAT
- Format de sortie. (default:table
)-a
,--no-fusion-par-url
- Désactive la fusion des contenus par URL. Les résultats contiendront donc potentiellement donc différentes sections d’un même article.--no-prompt
- Désactive le prompt demandant le résultat à ouvrir à la fin de la commande.
search-image (si)¶
Rechercher dans les images de Geotribu
search-image [-h] [-v] [-r REMOTE_INDEX_FILE] [-l LOCAL_INDEX_FILE]
[-f GEOTRIBU_IMAGES_DEFAULT_TYPE] [-n GEOTRIBU_RESULTATS_NOMBRE]
[-x GEOTRIBU_IMAGES_INDEX_EXPIRATION_HOURS] [-o GEOTRIBU_RESULTATS_FORMAT]
[--no-prompt]
search-term
search-image positional arguments¶
search-term
- Terme de recherche. (default:None
)
search-image options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG (default:1
)-r
REMOTE_INDEX_FILE
,--remote-index-file
REMOTE_INDEX_FILE
- Emplacement du fichier distant. (default:https://cdn.geotribu.fr/img/search-index.json
)-l
LOCAL_INDEX_FILE
,--local-index-file
LOCAL_INDEX_FILE
- Emplacement du fichier local. (default:/home/runner/.geotribu/search/cdn_search_index.json
)-f
GEOTRIBU_IMAGES_DEFAULT_TYPE
,--filter-type
GEOTRIBU_IMAGES_DEFAULT_TYPE
- Filtrer sur un type d’images en particulier. (default:None
)-n
GEOTRIBU_RESULTATS_NOMBRE
,--results-number
GEOTRIBU_RESULTATS_NOMBRE
- Nombre de résultats à retourner. (default:5
)-x
GEOTRIBU_IMAGES_INDEX_EXPIRATION_HOURS
,--expiration-rotating-hours
GEOTRIBU_IMAGES_INDEX_EXPIRATION_HOURS
- Nombre d’heures à partir duquel considérer le fichier local comme périmé. (default:24
)-o
GEOTRIBU_RESULTATS_FORMAT
,--format-output
GEOTRIBU_RESULTATS_FORMAT
- Format de sortie. (default:table
)--no-prompt
- Désactive le prompt demandant le résultat à ouvrir à la fin de la commande.
open_result (lire, open, or, read)¶
Ouvre un résultat d’une commande précédente dans le terminal ou l’application correspondant au type de contenu.
open_result [-h] [-v] [-w GEOTRIBU_OPEN_WITH] [result-index]
open_result positional arguments¶
result-index
- Numéro du résultat précédent à ouvrir. Valeur par défault : 0. (default:1
)
open_result options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG (default:1
)-w
GEOTRIBU_OPEN_WITH
,--with
GEOTRIBU_OPEN_WITH
- Avec quoi ouvrir le résultat : dans le terminal (shell) ou dans l'application correspondante au type de contenu (app). Valeur par défault : '
shell’. (default:shell
)
upgrade (auto-update, maj, update)¶
Mettre à jour Geotribu CLI.
upgrade [-h] [-v] [-c] [-n] [-w LOCAL_DOWNLOAD_FOLDER]
upgrade options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG (default:1
)-c
,--check-only
- Vérifie seulement la disponibilité d’une nouvelle version, sans télécharger.-n
,--dont-show-release-notes
- Display release notes.-w
LOCAL_DOWNLOAD_FOLDER
,--where
LOCAL_DOWNLOAD_FOLDER
- Dossier dans lequel télécharger la nouvelle version. (default:./
)
header-check (header, check, metadata)¶
Vérifier entête markdown
header-check [-h] [-v] [-af AUTHORS_FOLDER] [-maxw MAX_IMAGE_WIDTH] [-maxh MAX_IMAGE_HEIGHT]
[-minr MIN_IMAGE_RATIO] [-maxr MAX_IMAGE_RATIO] [-r]
content [content ...]
header-check positional arguments¶
content
- Chemin du fichier markdown dont l’entête est à vérifier (default:None
)
header-check options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG (default:1
)-af
AUTHORS_FOLDER
,--authors-folder
AUTHORS_FOLDER
- Chemin qui contient les presentations markdown des auteurs/autrices (default:None
)-maxw
MAX_IMAGE_WIDTH
,--max-width
MAX_IMAGE_WIDTH
- Largeur maximum de l’image à vérifier (default:800
)-maxh
MAX_IMAGE_HEIGHT
,--max-height
MAX_IMAGE_HEIGHT
- Hauteur maximum de l’image à vérifier (default:800
)-minr
MIN_IMAGE_RATIO
,--min-ratio
MIN_IMAGE_RATIO
- Ratio largeur / hauteur minimum de l’image à vérifier (default:1.45
)-maxr
MAX_IMAGE_RATIO
,--max-ratio
MAX_IMAGE_RATIO
- Ratio largeur / hauteur maximum de l’image à vérifier (default:1.55
)-r
,--raise
- Lever des exceptions et donc arrêter le programme si des erreurs sont rencontrées
content_manager (new, nouveau)¶
Créer un nouveau contenu.
content_manager [-h] {article} ...
content_manager options¶
new-article¶
Créer un nouvel article.
new-article [-h] [-v] [-t TITRE] [-d PUBLICATION_DATE] [--no-auto-open]
new-article options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG (default:1
)-t
TITRE
,--title
TITRE
,--titre
TITRE
- Titre de l'article. Si vide, il sera de la forme '
Projet d'article'
(default:None
)-d
PUBLICATION_DATE
,--date
PUBLICATION_DATE
- Date de publication envisagée au format AAAA-MM-JJ. Exemple : 2025-05-20. Si vide, 2 semaines à compter de la date du jour. (default:None
)--no-auto-open
,--stay
- Désactive l’ouverture automatique du post à la fin de la commande.
comments-read (lire, ouvrir)¶
Afficher un commentaire en particulier.
comments-read [-h] [-v] [-c COMMENT_ID] [-o GEOTRIBU_RESULTATS_FORMAT]
[-p GEOTRIBU_COMMENTS_API_PAGE_SIZE] [-w GEOTRIBU_OPEN_WITH]
[-x EXPIRATION_ROTATING_HOURS]
comments-read options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG (default:1
)-c
COMMENT_ID
,--comment-id
COMMENT_ID
- Identifiant du commentaire à afficher. Par défaut, le dernier commentaire. (default:None
)-o
GEOTRIBU_RESULTATS_FORMAT
,--format-output
GEOTRIBU_RESULTATS_FORMAT
- Format de sortie. (default:table
)-p
GEOTRIBU_COMMENTS_API_PAGE_SIZE
,--page-size
GEOTRIBU_COMMENTS_API_PAGE_SIZE
- Nombre de commentaires par requêtes. Plus le commentaire est récent, plus c'est performant d'
utiliser une petite page. À l’inverse, si on cherche un vieux commentaire, utiliser une grande page. Valeur par défaut : 20. (default:20
)-w
GEOTRIBU_OPEN_WITH
,--with
GEOTRIBU_OPEN_WITH
- Avec quoi ouvrir le commentaire : dans le terminal (shell) ou dans le navigateur (sous l'article). Valeur par défault : '
shell’. (default:shell
)-x
EXPIRATION_ROTATING_HOURS
,--expiration-rotating-hours
EXPIRATION_ROTATING_HOURS
- Nombre d’heures à partir duquel considérer le fichier local comme périmé. (default:4
)
comments-broadcast (diffuser, publier)¶
Diffuser le dernier commentaire sur les réseaux sociaux.
comments-broadcast [-h] [-v] [-c COMMENT_ID] [-p GEOTRIBU_COMMENTS_API_PAGE_SIZE] -t
{mastodon} [-x EXPIRATION_ROTATING_HOURS] [--no-auto-open]
comments-broadcast options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG (default:1
)-c
COMMENT_ID
,--comment-id
COMMENT_ID
- Identifiant du commentaire à afficher. Par défaut, le dernier commentaire. (default:None
)-p
GEOTRIBU_COMMENTS_API_PAGE_SIZE
,--page-size
GEOTRIBU_COMMENTS_API_PAGE_SIZE
- Nombre de commentaires par requêtes. Plus le commentaire est récent, plus c'est performant d'
utiliser une petite page. À l’inverse, si on cherche un vieux commentaire, utiliser une grande page. Valeur par défaut : 20. (default:20
)-t
BROADCAST_TO
,--to
BROADCAST_TO
- Canaux (réseaux sociaux) où publier le(s) commentaire(s). (default:mastodon
)-x
EXPIRATION_ROTATING_HOURS
,--expiration-rotating-hours
EXPIRATION_ROTATING_HOURS
- Nombre d’heures à partir duquel considérer le fichier local comme périmé. (default:4
)--no-auto-open
,--stay
- Désactive l’ouverture automatique du post à la fin de la commande.
comments-latest (derniers, récents)¶
Consulter les derniers commentaires du site
comments-latest [-h] [-v] [-n GEOTRIBU_RESULTATS_NOMBRE] [-o GEOTRIBU_RESULTATS_FORMAT]
[-x EXPIRATION_ROTATING_HOURS]
comments-latest options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG (default:1
)-n
GEOTRIBU_RESULTATS_NOMBRE
,--results-number
GEOTRIBU_RESULTATS_NOMBRE
- Nombre de commentaires à retourner. (default:5
)-o
GEOTRIBU_RESULTATS_FORMAT
,--format-output
GEOTRIBU_RESULTATS_FORMAT
- Format de sortie. (default:table
)-x
EXPIRATION_ROTATING_HOURS
,--expiration-rotating-hours
EXPIRATION_ROTATING_HOURS
- Nombre d’heures à partir duquel considérer le fichier local comme périmé. (default:4
)
images (img)¶
Chercher, gérer et optimiser les images.
images [-h] {optimize,process,search,si} ...
images options¶
optimize-image (process)¶
Optimiser une ou plusieurs images pour les téléverser sur le CDN.
optimize-image [-h] [-v] [--no-auto-open] [-o OUTPUT_PATH] [-t {body,header,icon}]
[-w GEOTRIBU_DEFAULT_IMAGE_OPTIMIZER]
image-path
optimize-image positional arguments¶
image-path
- Chemin ou URL de l’image à optimiser ou chemin vers un dossier local. (default:None
)
optimize-image options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG (default:1
)--no-auto-open
,--stay
- Désactive l’ouverture automatique à la fin de la commande.-o
OUTPUT_PATH
,--output-path
OUTPUT_PATH
- Fichier de sortie. Par défaut, stocke dans le dossier de travail local de Geotribu. (default:None
)-t
IMAGE_TYPE
,--to
IMAGE_TYPE
- Usage auquel est destinée l’image : corps de texte (body), en-tête et partage (header), icône/logo (icon). (default:body
)-w
GEOTRIBU_DEFAULT_IMAGE_OPTIMIZER
,--with
GEOTRIBU_DEFAULT_IMAGE_OPTIMIZER
- Outil à utiliser pour réaliser l'optimisation. Local (pillow), ou tinypng (service distant nécessitant une clé d'
API) (default:tinypng
)
search-image (si)¶
Rechercher dans les images de Geotribu
search-image [-h] [-v] [-r REMOTE_INDEX_FILE] [-l LOCAL_INDEX_FILE]
[-f GEOTRIBU_IMAGES_DEFAULT_TYPE] [-n GEOTRIBU_RESULTATS_NOMBRE]
[-x GEOTRIBU_IMAGES_INDEX_EXPIRATION_HOURS] [-o GEOTRIBU_RESULTATS_FORMAT]
[--no-prompt]
search-term
search-image positional arguments¶
search-term
- Terme de recherche. (default:None
)
search-image options¶
-v
,--verbose
- Niveau de verbosité : None = WARNING, -v = INFO, -vv = DEBUG (default:1
)-r
REMOTE_INDEX_FILE
,--remote-index-file
REMOTE_INDEX_FILE
- Emplacement du fichier distant. (default:https://cdn.geotribu.fr/img/search-index.json
)-l
LOCAL_INDEX_FILE
,--local-index-file
LOCAL_INDEX_FILE
- Emplacement du fichier local. (default:/home/runner/.geotribu/search/cdn_search_index.json
)-f
GEOTRIBU_IMAGES_DEFAULT_TYPE
,--filter-type
GEOTRIBU_IMAGES_DEFAULT_TYPE
- Filtrer sur un type d’images en particulier. (default:None
)-n
GEOTRIBU_RESULTATS_NOMBRE
,--results-number
GEOTRIBU_RESULTATS_NOMBRE
- Nombre de résultats à retourner. (default:5
)-x
GEOTRIBU_IMAGES_INDEX_EXPIRATION_HOURS
,--expiration-rotating-hours
GEOTRIBU_IMAGES_INDEX_EXPIRATION_HOURS
- Nombre d’heures à partir duquel considérer le fichier local comme périmé. (default:24
)-o
GEOTRIBU_RESULTATS_FORMAT
,--format-output
GEOTRIBU_RESULTATS_FORMAT
- Format de sortie. (default:table
)--no-prompt
- Désactive le prompt demandant le résultat à ouvrir à la fin de la commande.
mastodon-export¶
Exporter les données du compte Mastodon (listes, comptes suivis…).
mastodon-export [-h] [-v] [-w DEST_EXPORT_FOLDER]
mastodon-export options¶
Geotribu en ligne de commande pour rechercher dans les contenus et les images, consulter les derniers contenus sans quitter son terminal. Encore meilleur avec les terminaux gérant les hyperliens : Bash, PowerShell 5+, etc. Développé par Julien Moura (Geotribu) Documentation : https://cli.geotribu.fr/
comments (commentaires, coms)¶
Consulter et gérer les commentaires.
comments options¶
-h
,--help
- show this help message and exit