refactor: conformité conventions Linux FHS/XDG

- man pages déplacées dans local/share/man/man1/ (man cherche dans man<section>/) - docs déplacées dans local/share/doc/scripts-bash/ (un sous-dossier par package) - old-bin/ supprimé (fichiers obsolètes → historique git) - .config/prep.sh parasite supprimé - 'liste des scripts.base' renommé en 'liste-des-scripts.base' (pas d'espace) - prep.sh et install.sh mis à jour pour les nouveaux chemins
2026-04-30 09:02:00 +02:00
parent 479fe9c1f1
commit a646c2f4be
21 changed files with 76 additions and 1249 deletions
@@ -0,0 +1,77 @@
+---
+tags:
+  - scripts
+nom: castopod_update
+description: Mise à jour de CASTOPOD
+---
+
+# NOM
+
+castopod_update - Mise à jour de CASTOPOD
+
+# SYNOPSIS
+
+castopod_update
+
+# DESCRIPTION
+
+Le script **castopod_update** permet de mettre à jour le dossier Web de 
+CASTOPOD en utilisant le fichier de mise à jour au format ZIP fourni.
+
+# OPTIONS
+
+Aucune option n'est nécessaire pour exécuter le script.
+
+# CONFIGURATION
+
+Le script a sa propre configuration qui n'est pas modifiable.
+
+Le dossier Web de CASTOPOD doit être nommé `castopod`.
+
+Le script doit être positionné au même niveau que le dossier Web de CASTOPOD.
+
+Le dossier `save_castopod` contient une copie des données de CASTOPOD, qui est 
+rafraîchie au début de l'exécution du script. S'il n'existe pas, il sera créé.
+
+L'archive de mise à jour doit être spécifiquement nommée `castopod*.zip` et 
+doit être positionnée au même niveau que le script et le dossier Web de 
+CASTOPOD.
+
+Le script utilise `php8.1` pour effectuer des tâches de maintenance.
+
+# PRÉREQUIS
+
+Téléchargez l'archive de mise à jour disponible sur le site 
+https://castopod.org/.
+
+# EXEMPLES
+
+Pour exécuter le script sans aucune option :
+
+```
+castopod_update
+```
+
+# AUTEURS
+
+Cédric Abonnel - \<canl.sb2023@acemail.fr>
+
+# VERSIONS
+
+-23.12.14
+:   Suppression de l'archive TAR du dossier `save_castopod`.
+
+-23.12.1
+:    Messages des logs améliorés avec plus de détails lors de l'utilisation de 
+    `cp`.
+
+
+# RAPPORT D'ERREURS
+
+Pour signaler des erreurs ou des problèmes :
+https://git.abonnel.fr/cedricAbonnel/scripts-bash
+
+# REMARQUES
+
+Ce script est fourni tel quel, sans aucune garantie. Vous êtes libre de le
+modifier et de le distribuer selon les termes de la licence applicable.
@@ -0,0 +1,45 @@
+---
+tags:
+  - scripts
+nom: convertPDF
+description: Compresse des fichiers PDF pour gagner en volume et génère le résultat d'un OCR
+---
+
+# NOM
+
+convertPDF - Compresse des fichiers PDF pour gagner en volume et génère le résultat d'un OCR
+
+# SYNOPSIS
+
+convertPDF
+
+# DESCRIPTION
+
+Ce script convertit des fichiers PDF en d'autres formats tels que JPG, TXT, et 
+PDF en utilisant des outils comme `pdftocairo`, `pdftotext`, `tesseract`, et 
+`convert`.
+
+# COMPATIBILITÉ
+
+Ce script est compatible avec les fichiers PDF (Portable Document Format).
+
+# EXEMPLES
+
+Convertir plusieurs fichiers PDF présent dans le dossier et sous-dossiers courants :
+   ```
+   convertPDF
+   ```
+
+# VERSIONS
+
+-23.12.1
+:    Version originale
+
+# AUTEURS
+
+Cédric Abonnel - \<canl.sb2023@acemail.fr>
+
+# RAPPORT D'ERREURS
+
+Pour signaler des erreurs ou des problèmes : 
+https://git.abonnel.fr/cedricAbonnel/scripts-bash
@@ -0,0 +1,58 @@
+\
+
+# NOM
+
+top_horaire - Gestion du jingle et de l'annonce de l'heure
+
+# SYNOPSIS
+
+top_horaire
+
+# DESCRIPTION
+
+Le script **top_horaire** permet de gérer la lecture d'un jingle en 
+arrière-plan suivi de l'annonce de l'heure actuelle en utilisant espeak-ng.
+
+# OPTIONS
+
+Aucune option n'est requise pour exécuter le script.
+
+# CONFIGURATION
+
+Le script peut lire la configuration à partir d'un fichier de configuration situé dans le répertoire `~/.config/`. Si le fichier de configuration n'existe pas, il sera créé avec un commentaire indiquant la date de création.
+
+Le chemin du jingle est configuré par la variable `jingle_tophoraire`. Si cette variable n'est pas définie dans le fichier de configuration, elle sera initialisée avec le chemin par défaut du jingle.
+
+Une fois le chemin du jingle configuré, le script utilise la commande `paplay` pour lire le jingle en arrière-plan.
+
+Le script obtient l'heure actuelle et crée un message d'annonce contenant l'heure. Il utilise ensuite la commande `espeak-ng` pour annoncer l'heure en français.
+
+# EXEMPLES
+
+Pour exécuter le script sans aucune option :
+
+```
+top_horaire
+```
+
+# AUTEURS
+
+Cédric Abonnel - \<canl.sb2023@acemail.fr>
+
+# VERSIONS
+
+-23.12.1
+:    Version originale
+
+# RAPPORT D'ERREURS
+
+Pour signaler des erreurs ou des problèmes : https://git.abonnel.fr/cedricAbonnel/scripts-bash
+
+# VOIR AUSSI
+
+- [espeak-ng(1)](https://manpages.debian.org/stretch/espeak-ng/espeak-ng.1.en.html)
+- [paplay(1)](https://manpages.debian.org/stretch/pulseaudio/paplay.1.en.html)
+
+# REMARQUES
+
+Ce script est fourni tel quel, sans aucune garantie. Vous êtes libre de le modifier et de le distribuer selon les termes de la licence applicable.
@@ -0,0 +1,66 @@
+\
+
+# NOM
+
+playlist_gen - Génère une playlist M3U à partir de fichiers audio
+
+# SYNOPSIS
+
+playlist_gen [-n \<nombre de fichiers\>] [-d \<répertoire\>] [-o \<fichier de sortie\>]
+
+# DESCRIPTION
+
+playlist_gen est un script Bash qui permet de générer une playlist M3U à partir
+de fichiers audio situés dans un répertoire spécifié.
+
+# OPTIONS
+
+-n
+:  Spécifie le nombre de fichiers à inclure dans la playlist. Par défaut, le
+nombre de fichiers est 100.
+
+-d
+:  Spécifie le répertoire à scanner pour les fichiers audio. Par défaut, le
+   répertoire actuel est utilisé.
+
+-o
+:  Spécifie le nom du fichier M3U de sortie. Par défaut, le fichier est créé
+   dans le répertoire de la musique de l'utilisateur.
+
+# UTILISATION
+
+```
+playlist_gen -n 50 -d /chemin/vers/repertoire -o playlist.m3u
+```
+
+# COMPATIBILITÉ
+
+Ce script est compatible avec les fichiers audio aux formats MP3, Opus, Ogg et M4A.
+
+# EXEMPLES
+
+1. Générer une playlist M3U à partir du répertoire de musique par défaut de l'utilisateur :
+
+   ```
+   playlist_gen
+   ```
+
+2. Générer une playlist M3U à partir d'un répertoire spécifique avec 25 fichiers audio :
+
+   ```
+   playlist_gen -n 25 -d /chemin/vers/repertoire
+   ```
+
+# AUTEURS
+
+Cédric Abonnel - \<canl.sb2023@acemail.fr>
+
+# VERSIONS
+
+-23.12.1
+:    Version originale
+
+# RAPPORTS D'ERREURS
+
+Pour signaler des erreurs ou des problèmes : https://git.abonnel.fr/cedricAbonnel/scripts-bash
+
@@ -0,0 +1,64 @@
+\
+
+# NOM
+
+random_music_player - Lecteur de musique aléatoire en ligne de commande
+
+# SYNOPSIS
+
+random_music_player \[options\]
+
+# DESCRIPTION
+
+Le script **random_music_player** est un lecteur de musique aléatoire en ligne
+de commande qui lit des fichiers audio à partir d'un répertoire spécifié.
+
+# OPTIONS
+
+Aucune option n'est requise.
+
+# CONFIGURATION
+
+Le script utilise un fichier de configuration situé à
+`~/.config/random_music_player`. Si ce fichier de configuration n'existe pas,
+il sera créé avec les paramètres par défaut suivants :
+
+```shell
+# Fichier de configuration créé [date de création]
+path_music_files=~/Music
+volume=0.06
+```
+
+Vous pouvez éditer ce fichier de configuration pour personnaliser les réglages
+du lecteur de musique.
+
+# UTILISATION
+
+Pour utiliser le lecteur de musique aléatoire, exécutez simplement le script
+sans aucune option. Il sélectionnera au hasard un fichier audio à partir du
+répertoire spécifié dans le fichier de configuration et le lira.
+
+```shell
+random_music_player
+```
+
+# EXEMPLE
+
+```shell
+$ random_music_player
+```
+
+# VERSIONS
+
+-23.12.1
+:    Version originale
+
+# AUTEURS
+
+Cédric Abonnel - \<canl.sb2023@acemail.fr>
+
+# RAPPORT D'ERREUR
+
+Pour signaler des erreurs ou des problèmes :
+https://git.abonnel.fr/cedricAbonnel/scripts-bash
+