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
This commit is contained in:
2026-04-30 09:02:00 +02:00
parent 479fe9c1f1
commit a646c2f4be
21 changed files with 76 additions and 1249 deletions
+84
View File
@@ -0,0 +1,84 @@
.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "" "" "" "" ""
.hy
.SH NOM
.PP
castopod_update - Mise à jour de CASTOPOD
.SH SYNOPSIS
.PP
castopod_update
.SH DESCRIPTION
.PP
Le script \f[B]castopod_update\f[R] permet de mettre à jour le dossier
Web de CASTOPOD en utilisant le fichier de mise à jour au format ZIP
fourni.
.SH OPTIONS
.PP
Aucune option n\[cq]est nécessaire pour exécuter le script.
.SH CONFIGURATION
.PP
Le script a sa propre configuration qui n\[cq]est pas modifiable.
.PP
Le dossier Web de CASTOPOD doit être nommé \f[V]castopod\f[R].
.PP
Le script doit être positionné au même niveau que le dossier Web de
CASTOPOD.
.PP
Le dossier \f[V]save_castopod\f[R] contient une copie des données de
CASTOPOD, qui est rafraîchie au début de l\[cq]exécution du script.
S\[cq]il n\[cq]existe pas, il sera créé.
.PP
L\[cq]archive de mise à jour doit être spécifiquement nommée
\f[V]castopod*.zip\f[R] et doit être positionnée au même niveau que le
script et le dossier Web de CASTOPOD.
.PP
Le script utilise \f[V]php8.1\f[R] pour effectuer des tâches de
maintenance.
.SH PRÉREQUIS
.PP
Téléchargez l\[cq]archive de mise à jour disponible sur le site
https://castopod.org/.
.SH EXEMPLES
.PP
Pour exécuter le script sans aucune option :
.IP
.nf
\f[C]
castopod_update
\f[R]
.fi
.SH AUTEURS
.PP
Cédric Abonnel - <canl.sb2023\[at]acemail.fr>
.SH VERSIONS
.TP
-23.12.14
Suppression de l\[cq]archive TAR du dossier \f[V]save_castopod\f[R].
.TP
-23.12.1
Messages des logs améliorés avec plus de détails lors de
l\[cq]utilisation de \f[V]cp\f[R].
.SH RAPPORT D\[cq]ERREURS
.PP
Pour signaler des erreurs ou des problèmes :
https://git.abonnel.fr/cedricAbonnel/scripts-bash
.SH REMARQUES
.PP
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.
+49
View File
@@ -0,0 +1,49 @@
.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "" "" "" "" ""
.hy
.SH NOM
.PP
convertPDF - Compresse des fichiers PDF pour gagner en volume et génère
le résultat d\[cq]un OCR
.SH SYNOPSIS
.PP
convertPDF
.SH DESCRIPTION
.PP
Ce script convertit des fichiers PDF en d\[cq]autres formats tels que
JPG, TXT, et PDF en utilisant des outils comme \f[V]pdftocairo\f[R],
\f[V]pdftotext\f[R], \f[V]tesseract\f[R], et \f[V]convert\f[R].
.SH COMPATIBILITÉ
.PP
Ce script est compatible avec les fichiers PDF (Portable Document
Format).
.SH EXEMPLES
.PP
Convertir plusieurs fichiers PDF présent dans le dossier et
sous-dossiers courants : \f[V]convertPDF\f[R]
.SH VERSIONS
.TP
-23.12.1
Version originale
.SH AUTEURS
.PP
Cédric Abonnel - <canl.sb2023\[at]acemail.fr>
.SH RAPPORT D\[cq]ERREURS
.PP
Pour signaler des erreurs ou des problèmes :
https://git.abonnel.fr/cedricAbonnel/scripts-bash
+86
View File
@@ -0,0 +1,86 @@
.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "" "" "" "" ""
.hy
.PP
.PD 0
.P
.PD
.SH NOM
.PP
top_horaire - Gestion du jingle et de l\[cq]annonce de l\[cq]heure
.SH SYNOPSIS
.PP
top_horaire
.SH DESCRIPTION
.PP
Le script \f[B]top_horaire\f[R] permet de gérer la lecture d\[cq]un
jingle en arrière-plan suivi de l\[cq]annonce de l\[cq]heure actuelle en
utilisant espeak-ng.
.SH OPTIONS
.PP
Aucune option n\[cq]est requise pour exécuter le script.
.SH CONFIGURATION
.PP
Le script peut lire la configuration à partir d\[cq]un fichier de
configuration situé dans le répertoire \f[V]\[ti]/.config/\f[R].
Si le fichier de configuration n\[cq]existe pas, il sera créé avec un
commentaire indiquant la date de création.
.PP
Le chemin du jingle est configuré par la variable
\f[V]jingle_tophoraire\f[R].
Si cette variable n\[cq]est pas définie dans le fichier de
configuration, elle sera initialisée avec le chemin par défaut du
jingle.
.PP
Une fois le chemin du jingle configuré, le script utilise la commande
\f[V]paplay\f[R] pour lire le jingle en arrière-plan.
.PP
Le script obtient l\[cq]heure actuelle et crée un message d\[cq]annonce
contenant l\[cq]heure.
Il utilise ensuite la commande \f[V]espeak-ng\f[R] pour annoncer
l\[cq]heure en français.
.SH EXEMPLES
.PP
Pour exécuter le script sans aucune option :
.IP
.nf
\f[C]
top_horaire
\f[R]
.fi
.SH AUTEURS
.PP
Cédric Abonnel - <canl.sb2023\[at]acemail.fr>
.SH VERSIONS
.TP
-23.12.1
Version originale
.SH RAPPORT D\[cq]ERREURS
.PP
Pour signaler des erreurs ou des problèmes :
https://git.abonnel.fr/cedricAbonnel/scripts-bash
.SH VOIR AUSSI
.IP \[bu] 2
espeak-ng(1) (https://manpages.debian.org/stretch/espeak-ng/espeak-ng.1.en.html)
.IP \[bu] 2
paplay(1) (https://manpages.debian.org/stretch/pulseaudio/paplay.1.en.html)
.SH REMARQUES
.PP
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.
+92
View File
@@ -0,0 +1,92 @@
.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "" "" "" "" ""
.hy
.PP
.PD 0
.P
.PD
.SH NOM
.PP
playlist_gen - Génère une playlist M3U à partir de fichiers audio
.SH SYNOPSIS
.PP
playlist_gen [-n <nombre de fichiers>] [-d <répertoire>] [-o <fichier de
sortie>]
.SH DESCRIPTION
.PP
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é.
.SH OPTIONS
.TP
-n
Spécifie le nombre de fichiers à inclure dans la playlist.
Par défaut, le nombre de fichiers est 100.
.TP
-d
Spécifie le répertoire à scanner pour les fichiers audio.
Par défaut, le répertoire actuel est utilisé.
.TP
-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\[cq]utilisateur.
.SH UTILISATION
.IP
.nf
\f[C]
playlist_gen -n 50 -d /chemin/vers/repertoire -o playlist.m3u
\f[R]
.fi
.SH COMPATIBILITÉ
.PP
Ce script est compatible avec les fichiers audio aux formats MP3, Opus,
Ogg et M4A.
.SH EXEMPLES
.IP "1." 3
Générer une playlist M3U à partir du répertoire de musique par défaut de
l\[cq]utilisateur :
.RS 4
.IP
.nf
\f[C]
playlist_gen
\f[R]
.fi
.RE
.IP "2." 3
Générer une playlist M3U à partir d\[cq]un répertoire spécifique avec 25
fichiers audio :
.RS 4
.IP
.nf
\f[C]
playlist_gen -n 25 -d /chemin/vers/repertoire
\f[R]
.fi
.RE
.SH AUTEURS
.PP
Cédric Abonnel - <canl.sb2023\[at]acemail.fr>
.SH VERSIONS
.TP
-23.12.1
Version originale
.SH RAPPORTS D\[cq]ERREURS
.PP
Pour signaler des erreurs ou des problèmes :
https://git.abonnel.fr/cedricAbonnel/scripts-bash
@@ -0,0 +1,83 @@
.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "" "" "" "" ""
.hy
.PP
.PD 0
.P
.PD
.SH NOM
.PP
random_music_player - Lecteur de musique aléatoire en ligne de commande
.SH SYNOPSIS
.PP
random_music_player [options]
.SH DESCRIPTION
.PP
Le script \f[B]random_music_player\f[R] est un lecteur de musique
aléatoire en ligne de commande qui lit des fichiers audio à partir
d\[cq]un répertoire spécifié.
.SH OPTIONS
.PP
Aucune option n\[cq]est requise.
.SH CONFIGURATION
.PP
Le script utilise un fichier de configuration situé à
\f[V]\[ti]/.config/random_music_player\f[R].
Si ce fichier de configuration n\[cq]existe pas, il sera créé avec les
paramètres par défaut suivants :
.IP
.nf
\f[C]
# Fichier de configuration créé [date de création]
path_music_files=\[ti]/Music
volume=0.06
\f[R]
.fi
.PP
Vous pouvez éditer ce fichier de configuration pour personnaliser les
réglages du lecteur de musique.
.SH UTILISATION
.PP
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.
.IP
.nf
\f[C]
random_music_player
\f[R]
.fi
.SH EXEMPLE
.IP
.nf
\f[C]
$ random_music_player
\f[R]
.fi
.SH VERSIONS
.TP
-23.12.1
Version originale
.SH AUTEURS
.PP
Cédric Abonnel - <canl.sb2023\[at]acemail.fr>
.SH RAPPORT D\[cq]ERREUR
.PP
Pour signaler des erreurs ou des problèmes :
https://git.abonnel.fr/cedricAbonnel/scripts-bash