.config/files_local-share-doc

@@ -1,5 +1,5 @@
-play_tophoraire.1.md
-convertPDF.1.md
 castopod_update.1.md
+convertPDF.1.md
+play_tophoraire.1.md
 random_music_player.1.md
 playlist_gen.1.md

.config/files_local-share-man

@@ -1,5 +1,5 @@
 playlist_gen.1
 random_music_player.1
-castopod_update.1
-convertPDF.1
 play_tophoraire.1
+convertPDF.1
+castopod_update.1

README.md

@@ -8,10 +8,7 @@ Le script modifie également le chemin d'accès (PATH) de l'utilisateur ainsi qu
 Pour utiliser ces scripts, suivez ces étapes :
 
 1. Clonez ce dépôt Git.
-`git clone https://git.abonnel.fr/cedricAbonnel/scripts-bash.git`
-
 2. Exécutez le script en utilisant la commande `./install.sh`.
-Le script copiera les fichiers du programme, les pages d'aide et les paramètres dans votre dossier personnel. Il est possible qu'un compte `sudo `soit requis pour l'installation de binaires externes.
 
 Toutes les opérations et les messages d'erreur sont enregistrés dans un fichier journal (`~/log/a5l-scripts_bash-<date et heure de l'instant>-<PID>.log`) situé dans le répertoire personnel de l'utilisateur. Le journal inclut la date, l'heure et les détails de chaque opération.
 

local/share/doc/castopod_update.1.md

@@ -1,23 +1,20 @@
-\
-
 # NOM
 
 castopod_update - Mise à jour de CASTOPOD
 
 # SYNOPSIS
 
-castopod_update
+**castopod_update** [OPTION]
 
 # DESCRIPTION
 
-Le script **castopod_update** permet de mettre à jour le dossier Web de 
+Le script **castopod_update** permet de mettre à jour le dossier Web de CASTOPOD en utilisant le fichier de mise à jour au format ZIP fourni.
-CASTOPOD en utilisant le fichier de mise à jour au format ZIP fourni.
 
-# OPTIONS
+## OPTIONS
 
-Aucune option n'est nécessaire pour exécuter le script.
+- Aucune option n'est nécessaire pour exécuter le script.
 
-# CONFIGURATION
+## CONFIGURATION
 
 Le script a sa propre configuration qui n'est pas modifiable.
 
@@ -25,19 +22,15 @@ 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 
+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éé.
-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 
+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.
-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
+## PRÉREQUIS
 
-Téléchargez l'archive de mise à jour disponible sur le site 
+Téléchargez l'archive de mise à jour disponible sur le site https://castopod.org/.
-https://castopod.org/.
 
 # EXEMPLES
 
@@ -47,26 +40,23 @@ Pour exécuter le script sans aucune option :
 castopod_update
 ```
 
-# AUTEURS
-
-Cédric Abonnel - \<canl.sb2023@acemail.fr>
-
 # VERSIONS
 
--23.12.14
+Version 23.12.1
-:   Suppression de l'archive TAR du dossier `save_castopod`.
+- Messages des logs améliorés avec plus de détails lors de l'utilisation de 'cp'.
 
--23.12.1
+Version 23.12.14
-:    Messages des logs améliorés avec plus de détails lors de l'utilisation de 
+- Suppression de l'archive TAR du dossier `save_castopod`.
-    `cp`.
 
 
-# RAPPORT D'ERREURS
+## AUTEUR
 
-Pour signaler des erreurs ou des problèmes :
+Ce script a été créé par Cédric Abonnel.
-https://git.abonnel.fr/cedricAbonnel/scripts-bash
+
+## 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
+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.
-modifier et de le distribuer selon les termes de la licence applicable.

local/share/doc/convertPDF.1.md

@@ -1,39 +1,23 @@
+convertPDF(1) - Compresse des fichiers PDF pour gagner en volume et génère le résultat d'un OCR
 
-# NOM
+## SYNOPSIS
+**convertPDF**
 
-convertPDF - Compresse des fichiers PDF pour gagner en volume et génère le résultat d'un OCR
+## 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`.
 
-# SYNOPSIS
+## COMPATIBILITÉ
-
-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
+## EXEMPLE
-
 Convertir plusieurs fichiers PDF présent dans le dossier et sous-dossiers courants :
    ```
    convertPDF
    ```
 
-# VERSIONS
+## AUTEUR
+Ce script a été créé par Cédric Abonnel.
 
--23.12.1
+## RAPPORT D'ERREURS
-:    Version originale
+Pour signaler des erreurs ou des problèmes : https://git.abonnel.fr/cedricAbonnel/scripts-bash
-
-# 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

local/share/doc/play_tophoraire.1.md

@@ -1,30 +1,33 @@
-\
-
 # NOM
 
 top_horaire - Gestion du jingle et de l'annonce de l'heure
 
 # SYNOPSIS
 
-top_horaire
+**top_horaire** [OPTION]
 
 # DESCRIPTION
 
-Le script **top_horaire** permet de gérer la lecture d'un jingle en 
+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.
-arrière-plan suivi de l'annonce de l'heure actuelle en utilisant espeak-ng.
 
-# OPTIONS
+## OPTIONS
 
-Aucune option n'est requise pour exécuter le script.
+- Aucune option n'est requise pour exécuter le script.
 
-# CONFIGURATION
+## 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.
 
+## CONFIGURATION DU CHEMIN DU JINGLE
+
 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.
 
+## LECTURE DU JINGLE EN ARRIÈRE-PLAN
+
 Une fois le chemin du jingle configuré, le script utilise la commande `paplay` pour lire le jingle en arrière-plan.
 
+## ANNONCE DE L'HEURE ACTUELLE
+
 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
@@ -35,17 +38,10 @@ Pour exécuter le script sans aucune option :
 top_horaire
 ```
 
-# AUTEURS
+## AUTEUR
-
+Ce script a été créé par Cédric Abonnel.
-Cédric Abonnel - \<canl.sb2023@acemail.fr>
-
-# VERSIONS
-
--23.12.1
-:    Version originale
-
-# RAPPORT D'ERREURS
 
+## RAPPORT D'ERREURS
 Pour signaler des erreurs ou des problèmes : https://git.abonnel.fr/cedricAbonnel/scripts-bash
 
 # VOIR AUSSI

local/share/doc/playlist_gen.1.md

@@ -1,43 +1,32 @@
-\
+# playlist_gen(1) - Génère une playlist M3U à partir de fichiers audio
 
-# NOM
+## SYNOPSIS
 
-playlist_gen - Génère une playlist M3U à partir de fichiers audio
+**playlist_gen** [-n \<nombre de fichiers\>] [-d \<répertoire\>] [-o \<fichier de sortie\>]
 
-# SYNOPSIS
+## DESCRIPTION
 
-playlist_gen [-n \<nombre de fichiers\>] [-d \<répertoire\>] [-o \<fichier de sortie\>]
+**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é.
 
-# DESCRIPTION
+## OPTIONS
 
-playlist_gen est un script Bash qui permet de générer une playlist M3U à partir
+- **-n \<nombre de fichiers\>** : Spécifie le nombre de fichiers à inclure dans la playlist. Par défaut, le nombre de fichiers est 100.
-de fichiers audio situés dans un répertoire spécifié.
 
-# OPTIONS
+- **-d \<répertoire\>** : Spécifie le répertoire à scanner pour les fichiers audio. Par défaut, le répertoire actuel est utilisé.
 
--n
+- **-o \<fichier de sortie\>** : 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.
-:  Spécifie le nombre de fichiers à inclure dans la playlist. Par défaut, le
-nombre de fichiers est 100.
 
--d
+## UTILISATION
-:  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É
+## COMPATIBILITÉ
 
 Ce script est compatible avec les fichiers audio aux formats MP3, Opus, Ogg et M4A.
 
-# EXEMPLES
+## EXEMPLES
 
 1. Générer une playlist M3U à partir du répertoire de musique par défaut de l'utilisateur :
 
@@ -51,16 +40,11 @@ Ce script est compatible avec les fichiers audio aux formats MP3, Opus, Ogg et M
    playlist_gen -n 25 -d /chemin/vers/repertoire
    ```
 
-# AUTEURS
+## AUTEUR
 
-Cédric Abonnel - \<canl.sb2023@acemail.fr>
+Ce script a été écrit par Cédric Abonnel.
 
-# VERSIONS
+## RAPPORTS D'ERREURS
-
--23.12.1
-:    Version originale
-
-# RAPPORTS D'ERREURS
 
 Pour signaler des erreurs ou des problèmes : https://git.abonnel.fr/cedricAbonnel/scripts-bash
 

local/share/doc/random_music_player.1.md

@@ -1,64 +1,39 @@
-\
+random_music_player(1) - Lecteur de musique aléatoire en ligne de commande
 
-# NOM
+## Synopsis
+**random_music_player** [OPTIONS]
 
-random_music_player - Lecteur de musique aléatoire en ligne de commande
+## 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é.
 
-# SYNOPSIS
+## Options
-
+- Aucune option n'est requise.
-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 :
 
+## 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
+Vous pouvez éditer ce fichier de configuration pour personnaliser les réglages du lecteur de musique.
-du lecteur de musique.
 
-# UTILISATION
+## 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.
-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
+## Exemple
-
 ```shell
 $ random_music_player
 ```
 
-# VERSIONS
+## Auteur
+Ce script a été créé par Cédric Abonnel.
 
--23.12.1
+## Rapport d'erreurs
-:    Version originale
+Pour signaler des erreurs ou des problèmes : https://git.abonnel.fr/cedricAbonnel/scripts-bash
-
-# 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
 

local/share/man/castopod_update.1

@@ -16,25 +16,21 @@
 .\}
 .TH "" "" "" "" ""
 .hy
-.PP
-.PD 0
-.P
-.PD
 .SH NOM
 .PP
 castopod_update - Mise à jour de CASTOPOD
 .SH SYNOPSIS
 .PP
-castopod_update
+\f[B]castopod_update\f[R] [OPTION]
 .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
+.SS OPTIONS
-.PP
+.IP \[bu] 2
 Aucune option n\[cq]est nécessaire pour exécuter le script.
-.SH CONFIGURATION
+.SS CONFIGURATION
 .PP
 Le script a sa propre configuration qui n\[cq]est pas modifiable.
 .PP
@@ -53,7 +49,7 @@ 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
+.SS PRÉREQUIS
 .PP
 Téléchargez l\[cq]archive de mise à jour disponible sur le site
 https://castopod.org/.
@@ -66,18 +62,17 @@ Pour exécuter le script sans aucune option :
 castopod_update
 \f[R]
 .fi
-.SH AUTEURS
-.PP
-Cédric Abonnel - <canl.sb2023\[at]acemail.fr>
 .SH VERSIONS
-.TP
+.PP
--23.12.14
+Version 23.12.1 - Messages des logs améliorés avec plus de détails lors
-Suppression de l\[cq]archive TAR du dossier \f[V]save_castopod\f[R].
+de l\[cq]utilisation de `cp'.
-.TP
+.PP
--23.12.1
+Version 23.12.14 - Suppression de l\[cq]archive TAR du dossier
-Messages des logs améliorés avec plus de détails lors de
+\f[V]save_castopod\f[R].
-l\[cq]utilisation de \f[V]cp\f[R].
+.SS AUTEUR
-.SH RAPPORT D\[cq]ERREURS
+.PP
+Ce script a été créé par Cédric Abonnel.
+.SS RAPPORT D\[cq]ERREURS
 .PP
 Pour signaler des erreurs ou des problèmes :
 https://git.abonnel.fr/cedricAbonnel/scripts-bash

local/share/man/convertPDF.1

@@ -16,34 +16,29 @@
 .\}
 .TH "" "" "" "" ""
 .hy
-.SH NOM
 .PP
-convertPDF - Compresse des fichiers PDF pour gagner en volume et génère
+convertPDF(1) - Compresse des fichiers PDF pour gagner en volume et
-le résultat d\[cq]un OCR
+génère le résultat d\[cq]un OCR
-.SH SYNOPSIS
+.SS SYNOPSIS
 .PP
-convertPDF
+\f[B]convertPDF\f[R]
-.SH DESCRIPTION
+.SS 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É
+.SS COMPATIBILITÉ
 .PP
 Ce script est compatible avec les fichiers PDF (Portable Document
 Format).
-.SH EXEMPLES
+.SS EXEMPLE
 .PP
 Convertir plusieurs fichiers PDF présent dans le dossier et
 sous-dossiers courants : \f[V]convertPDF\f[R]
-.SH VERSIONS
+.SS AUTEUR
-.TP
--23.12.1
-Version originale
-.SH AUTEURS
 .PP
-Cédric Abonnel - <canl.sb2023\[at]acemail.fr>
+Ce script a été créé par Cédric Abonnel.
-.SH RAPPORT D\[cq]ERREURS
+.SS RAPPORT D\[cq]ERREURS
 .PP
 Pour signaler des erreurs ou des problèmes :
 https://git.abonnel.fr/cedricAbonnel/scripts-bash

local/share/man/play_tophoraire.1

@@ -16,39 +16,38 @@
 .\}
 .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
+\f[B]top_horaire\f[R] [OPTION]
 .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
+.SS OPTIONS
-.PP
+.IP \[bu] 2
 Aucune option n\[cq]est requise pour exécuter le script.
-.SH CONFIGURATION
+.SS 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.
+.SS CONFIGURATION DU CHEMIN DU JINGLE
 .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.
+.SS LECTURE DU JINGLE EN ARRIÈRE-PLAN
 .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.
+.SS ANNONCE DE L\[cq]HEURE ACTUELLE
 .PP
 Le script obtient l\[cq]heure actuelle et crée un message d\[cq]annonce
 contenant l\[cq]heure.
@@ -63,14 +62,10 @@ Pour exécuter le script sans aucune option :
 top_horaire
 \f[R]
 .fi
-.SH AUTEURS
+.SS AUTEUR
 .PP
-Cédric Abonnel - <canl.sb2023\[at]acemail.fr>
+Ce script a été créé par Cédric Abonnel.
-.SH VERSIONS
+.SS RAPPORT D\[cq]ERREURS
-.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

local/share/man/playlist_gen.1

@@ -16,47 +16,42 @@
 .\}
 .TH "" "" "" "" ""
 .hy
+.SH playlist_gen(1) - Génère une playlist M3U à partir de fichiers audio
+.SS SYNOPSIS
 .PP
-.PD 0
+\f[B]playlist_gen\f[R] [-n <nombre de fichiers>] [-d <répertoire>] [-o
-.P
+<fichier de sortie>]
-.PD
+.SS DESCRIPTION
-.SH NOM
 .PP
-playlist_gen - Génère une playlist M3U à partir de fichiers audio
+\f[B]playlist_gen\f[R] est un script Bash qui permet de générer une
-.SH SYNOPSIS
+playlist M3U à partir de fichiers audio situés dans un répertoire
-.PP
+spécifié.
-playlist_gen [-n <nombre de fichiers>] [-d <répertoire>] [-o <fichier de
+.SS OPTIONS
-sortie>]
+.IP \[bu] 2
-.SH DESCRIPTION
+\f[B]-n <nombre de fichiers>\f[R] : Spécifie le nombre de fichiers à
-.PP
+inclure dans la playlist.
-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
+.IP \[bu] 2
--d
+\f[B]-d <répertoire>\f[R] : Spécifie le répertoire à scanner pour les
-Spécifie le répertoire à scanner pour les fichiers audio.
+fichiers audio.
 Par défaut, le répertoire actuel est utilisé.
-.TP
+.IP \[bu] 2
--o
+\f[B]-o <fichier de sortie>\f[R] : Spécifie le nom du fichier M3U de
-Spécifie le nom du fichier M3U de sortie.
+sortie.
 Par défaut, le fichier est créé dans le répertoire de la musique de
 l\[cq]utilisateur.
-.SH UTILISATION
+.SS UTILISATION
 .IP
 .nf
 \f[C]
 playlist_gen -n 50 -d /chemin/vers/repertoire -o playlist.m3u
 \f[R]
 .fi
-.SH COMPATIBILITÉ
+.SS COMPATIBILITÉ
 .PP
 Ce script est compatible avec les fichiers audio aux formats MP3, Opus,
 Ogg et M4A.
-.SH EXEMPLES
+.SS EXEMPLES
 .IP "1." 3
 Générer une playlist M3U à partir du répertoire de musique par défaut de
 l\[cq]utilisateur :
@@ -79,14 +74,10 @@ playlist_gen -n 25 -d /chemin/vers/repertoire
 \f[R]
 .fi
 .RE
-.SH AUTEURS
+.SS AUTEUR
 .PP
-Cédric Abonnel - <canl.sb2023\[at]acemail.fr>
+Ce script a été écrit par Cédric Abonnel.
-.SH VERSIONS
+.SS RAPPORTS D\[cq]ERREURS
-.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

local/share/man/random_music_player.1

@@ -17,24 +17,20 @@
 .TH "" "" "" "" ""
 .hy
 .PP
-.PD 0
+random_music_player(1) - Lecteur de musique aléatoire en ligne de
-.P
+commande
-.PD
+.SS Synopsis
-.SH NOM
 .PP
-random_music_player - Lecteur de musique aléatoire en ligne de commande
+\f[B]random_music_player\f[R] OPTIONS
-.SH SYNOPSIS
+.SS Description
-.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
+.SS Options
-.PP
+.IP \[bu] 2
 Aucune option n\[cq]est requise.
-.SH CONFIGURATION
+.SS Configuration
 .PP
 Le script utilise un fichier de configuration situé à
 \f[V]\[ti]/.config/random_music_player\f[R].
@@ -51,7 +47,7 @@ volume=0.06
 .PP
 Vous pouvez éditer ce fichier de configuration pour personnaliser les
 réglages du lecteur de musique.
-.SH UTILISATION
+.SS Utilisation
 .PP
 Pour utiliser le lecteur de musique aléatoire, exécutez simplement le
 script sans aucune option.
@@ -63,21 +59,17 @@ spécifié dans le fichier de configuration et le lira.
 random_music_player
 \f[R]
 .fi
-.SH EXEMPLE
+.SS Exemple
 .IP
 .nf
 \f[C]
 $ random_music_player
 \f[R]
 .fi
-.SH VERSIONS
+.SS Auteur
-.TP
--23.12.1
-Version originale
-.SH AUTEURS
 .PP
-Cédric Abonnel - <canl.sb2023\[at]acemail.fr>
+Ce script a été créé par Cédric Abonnel.
-.SH RAPPORT D\[cq]ERREUR
+.SS Rapport d\[cq]erreurs
 .PP
 Pour signaler des erreurs ou des problèmes :
 https://git.abonnel.fr/cedricAbonnel/scripts-bash

prep.sh

@@ -1,13 +1,5 @@
 #!/bin/bash
 
-# Script Bash - prep.sh
-# Auteur : Cédric Abonnel
-
-# Description : Prépare les fichiers de DOC et listing.
-
-# Version 23.12.14
-# - Modification du traitement des résumés des DOC. La fonctionnalité n'est pas encore accessible.
-
 
 # Spécifier le chemin du fichier journal
 log_dir="$HOME/log"
@@ -115,30 +107,11 @@ ls local/share/man/ -c1 >.config/files_local-share-man
 
 
 
-########
-# Résumé des DOC
 
+## Résumé des DOC
 
 for fichier in local/share/doc/*.md; do
   echo "Résumé pour $fichier :"
-  description_found=0
+  awk '/DESCRIPTION/{flag=1; next} /^$/{flag=0} flag' "$fichier"
-  empty_line_encountered=false
-  description_started=0
-
-  while IFS= read -r ligne; do
-    if [ "$description_found" -eq 1 ] && [ "$description_started" -eq 1 ] && [ -n "$ligne" ]; then
-      echo "$ligne"
-    elif [ "$description_found" -eq 1 ] && [ "$description_started" -eq 0 ] && [ -n "$ligne" ]; then
-        echo "$ligne"
-        description_started=1
-    elif [ "$description_found" -eq 1 ] && [ "$description_started" -eq 1 ] && [ ! -n "$ligne" ]; then
-        break
-    elif [ "$ligne" = "# DESCRIPTION" ]; then
-      description_found=1
-    fi
-
-  done < "$fichier"
-
   echo "..."
 done
-