From 1ff2dca5fb062d022803ec32d96e6cb23663ed53 Mon Sep 17 00:00:00 2001 From: jfchadeyron <78847492+jfchadeyron@users.noreply.github.com> Date: Wed, 10 Jan 2024 09:24:57 +0100 Subject: [PATCH 1/9] French Translation French Translation of README.md --- README.md | 278 +++++++++++++++++++++++++++--------------------------- 1 file changed, 139 insertions(+), 139 deletions(-) diff --git a/README.md b/README.md index 5992941..bd1486a 100644 --- a/README.md +++ b/README.md @@ -1,240 +1,240 @@ -# Arch-Update +# Arch-Mise à jour -## Table of contents +## Table des matières - [Description](#description) - [Installation](#installation) -- [Usage](#usage) +- [Utilisation](#utilisation) - [Documentation](#documentation) -- [Tips and tricks](#tips-and-tricks) -- [Contributing](#contributing) +- [Trucs et astuces](#trucs-et-astuces) +- [Contribuer](#contribuer) ## Description -An update notifier/applier for Arch Linux that assists you with important pre/post update tasks and that includes a (.desktop) clickeable icon that can easily be integrated with any DE/WM, dock, status/launch bar or app menu. -Optional support for AUR/Flatpak packages updates and desktop notifications. +Un notificateur/applicateur de mises à jour pour Arch Linux qui vous aide dans les tâches importantes de pré/post-mise à jour et qui comprend une icône cliquable (.desktop) qui peut facilement être intégrée à n'importe quel Environnement de Bureau/Manager de fenêtres, dock, barre d'état/lancement ou menu d'application. +Prise en charge facultative des mises à jour des packages AUR/Flatpak et des notifications sur le bureau. -Features: +Caractéristiques: -- Includes a (.desktop) clickeable icon that automatically changes to act as an update notifier/applier. Easy to integrate with any DE/WM, dock, status/launch bar, app menu, etc... -- Automatic check and listing of every packages available for update (through [checkupdates](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package")). -- Offers to print the latest Arch Linux news before applying updates (through [curl](https://archlinux.org/packages/core/x86_64/curl/ "curl package") and [htmlq](https://archlinux.org/packages/extra/x86_64/htmlq/ "htmlq package")). -- Automatic check and listing of orphan packages and offering you to remove them. -- Automatic check for old and/or uninstalled cached packages in `pacman`'s cache and offering you to remove them (through [paccache](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package")). -- Helps you processing pacnew/pacsave files (through [pacdiff](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package"), optionally requires [vim](https://archlinux.org/packages/extra/x86_64/vim/ "vim package") as the default [merge program](https://wiki.archlinux.org/title/Pacman/Pacnew_and_Pacsave#pacdiff "pacdiff merge program")). -- Automatic check for pending kernel updates requiring a reboot to be applied and offers to do so if there's one. -- Support for both [sudo](https://archlinux.org/packages/core/x86_64/sudo/ "sudo package") and [doas](https://archlinux.org/packages/extra/x86_64/opendoas/ "opendoas package"). -- Optional support for AUR packages update (through [yay](https://aur.archlinux.org/packages/yay "yay AUR package") or [paru](https://aur.archlinux.org/packages/paru "paru AUR package")). -- Optional support for Flatpak packages update (through [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak "Flatpak package")). -- Optional support for desktop notifications (through [libnotify](https://archlinux.org/packages/extra/x86_64/libnotify "libnotify package"), see ). +- Inclut une icône cliquable (.desktop) qui change automatiquement pour agir comme un notificateur/applicateur de mise à jour. Facile à intégrer avec n'importe quel DE/WM, dock, barre d'état/lancement, menu d'application, etc... +- Vérification et liste automatiques de tous les packages disponibles pour la mise à jour (via [checkupdates](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package")). +- Propose d'imprimer les dernières nouvelles d'Arch Linux avant d'appliquer les mises à jour (via [curl](https://archlinux.org/packages/core/x86_64/curl/ "curl package") et [htmlq] (https://archlinux. org/packages/extra/x86_64/htmlq/ "package htmlq")). +- Vérification et listage automatique des packages orphelins et vous proposant de les supprimer. +- Vérification automatique des paquets anciens et/ou désinstallés dans le cache de `pacman` et vous proposant de les supprimer (via [paccache](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman -paquet de contribution")). +- Vous aide à traiter les fichiers pacnew/pacsave (via [pacdiff](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package"), nécessite éventuellement [vim](https:// archlinux.org/packages/extra/x86_64/vim/ "vim package") comme [programme de fusion] par défaut (https://wiki.archlinux.org/title/Pacman/Pacnew_and_Pacsave#pacdiff "programme de fusion pacdiff")). +- Vérification automatique des mises à jour du noyau en attente nécessitant un redémarrage et propose de le faire s'il y en a un. +- Prise en charge de [sudo](https://archlinux.org/packages/core/x86_64/sudo/ "sudo package") et de [doas](https://archlinux.org/packages/extra/x86_64/opendoas/ "paquet opendoas"). +- Prise en charge facultative de la mise à jour des packages AUR (via [yay](https://aur.archlinux.org/packages/yay "yay AUR package") ou [paru](https://aur.archlinux.org/packages/paru "paquet paru AUR")). +- Prise en charge facultative de la mise à jour des packages Flatpak (via [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak "Package Flatpak")). +- Prise en charge facultative des notifications de bureau (via [libnotify](https://archlinux.org/packages/extra/x86_64/libnotify "libnotify package"), voir ) . -## Installation +##Installation ### AUR -Install the [arch-update](https://aur.archlinux.org/packages/arch-update "arch-update AUR package") AUR package. +Installez le package AUR [arch-update](https://aur.archlinux.org/packages/arch-update "arch-update AUR package"). -### From Source +### Depuis les fichiers sources -Install dependencies: +Installer les dépendances : ```bash sudo pacman -S --needed pacman-contrib curl htmlq diffutils ``` -Download the archive of the [latest stable release](https://github.com/Antiz96/arch-update/releases/latest) and extract it *(alternatively, you can clone this repository via `git`)*. +Téléchargez l'archive de la [dernière version stable](https://github.com/Antiz96/arch-update/releases/latest) et extrayez-la *(vous pouvez également cloner ce référentiel via `git`)*. -To install `arch-update`, go into the extracted/cloned directory and run the following command: +Pour installer `arch-update`, allez dans le répertoire extrait/cloné et exécutez la commande suivante : ```bash sudo make install ``` -To uninstall `arch-update`, go into the extracted/cloned directory and run the following command: +Pour désinstaller `arch-update`, allez dans le répertoire extrait/cloné et exécutez la commande suivante : ```bash -sudo make uninstall +sudo make désinstaller ``` -## Usage +## Utilisation -The usage consist of integrating [the .desktop file](#the-desktop-file) anywhere (could be your desktop, your dock, your status/launch bar and/or your app menu) and enabling the [systemd timer](#the-systemd-timer). +L'utilisation consiste à intégrer [le fichier .desktop](#the-desktop-file) n'importe où (cela peut être votre bureau, votre dock, votre barre d'état/de lancement et/ou le menu de votre application) et à activer le [timer systemd](# le-systemd-timer). -Here is a little YouTube presentation/review of `arch-update` that [Cardiac](https://github.com/Cardiacman13) and I made on [his YouTube channel](https://www.youtube.com/@Cardiacman) (**videos there, including this one, are in french**): +Voici une petite présentation/revue YouTube de `arch-update` que [Cardiac](https://github.com/Cardiacman13) et moi avons réalisée sur [sa chaîne YouTube](https://www.youtube.com/@ Cardiacman) (**les vidéos là-bas, dont celle-ci, sont en français**) : -*Warning: Arch-Update's features and default behavior may have changed/evolved since then!* +*Attention : les fonctionnalités et le comportement par défaut d'Arch-Update peuvent avoir changé/évolué depuis !* -[![youtube_presentation](https://github.com/Antiz96/arch-update/assets/53110319/23af5180-1881-486d-bd5a-3edd48ed1a08)](https://www.youtube.com/watch?v=QkOkX70SEmo) +[![youtube_presentation](https://github.com/Antiz96/arch-update/assets/53110319/23af5180-1881-486d-bd5a-3edd48ed1a08)](https://www.youtube.com/watch?v= QkOkX70SEmo) -### The .desktop file +### Le fichier .desktop -The .desktop file is located in `/usr/share/applications/arch-update.desktop` (or `/usr/local/share/applications/arch-update.desktop` if you installed `arch-update` [from source](#from-source)). -Its icon will automatically change depending on the different states (checking for updates, updates available, installing updates, up to date). -It will launch the relevant series of functions to perform a complete and proper update when clicked (see the [Documentation](#documentation) chapter). It is easy to integrate with any DE/WM, dock, status/launch bar or app menu. +Le fichier .desktop se trouve dans `/usr/share/applications/arch-update.desktop` (ou `/usr/local/share/applications/arch-update.desktop` si vous avez installé `arch-update` [à partir des sources ](#from-source)). +Son icône changera automatiquement en fonction des différents états (vérification des mises à jour, mises à jour disponibles, installation des mises à jour, à jour). +Il lancera la série de fonctions pertinentes pour effectuer une mise à jour complète et appropriée lorsque vous cliquez dessus (voir le chapitre [Documentation](#documentation)). Il est facile à intégrer à n’importe quel DE/WM, dock, barre d’état/lancement ou menu d’application. -### The systemd timer +### Le minuteur système -There is a systemd service in `/usr/lib/systemd/user/arch-update.service` (or in `/usr/local/lib/systemd/user/arch-update.service` if you installed `arch-update` [from source](#from-source)) that executes the `check` function when started (see the [Documentation](#documentation) chapter). -To start it automatically **at boot and then once every hour**, enable the associated systemd timer (you can modify the auto-check cycle to your liking, see the [Tips and tricks - Modify the auto-check cycle](#modify-the-auto-check-cycle) chapter): +Il existe un service systemd dans `/usr/lib/systemd/user/arch-update.service` (ou dans `/usr/local/lib/systemd/user/arch-update.service` si vous avez installé `arch-update ` [from source](#from-source)) qui exécute la fonction `check` au démarrage (voir le chapitre [Documentation](#documentation)). +Pour le démarrer automatiquement **au démarrage puis une fois toutes les heures**, activez le timer systemd associé (vous pouvez modifier le cycle de vérification automatique à votre guise, voir les [Trucs et astuces - Modifier le cycle de vérification automatique](# chapitre modifier le cycle de vérification automatique) : ```bash -systemctl --user enable --now arch-update.timer +systemctl --user activer --now arch-update.timer ``` -### Screenshot +### Capture d'écran -Personally, I integrated the .desktop icon in my top bar. -It is the first icon from the left. +Personnellement, j'ai intégré l'icône .desktop dans ma barre supérieure. +C'est la première icône en partant de la gauche. -![icon](https://github.com/Antiz96/arch-update/assets/53110319/25f3d2ca-b9d3-4a32-ace3-b0fa785662c2) +![icône](https://github.com/Antiz96/arch-update/assets/53110319/25f3d2ca-b9d3-4a32-ace3-b0fa785662c2) -When `arch-update` is checking for updates, the icon changes accordingly (the `check` function is automatically triggered at boot and then once every hour if you enabled the [systemd timer](#the-systemd-timer) and can be manually triggered by running the `arch-update -c` command): +Lorsque `arch-update` vérifie les mises à jour, l'icône change en conséquence (la fonction `check` est automatiquement déclenchée au démarrage puis une fois toutes les heures si vous avez activé le [systemd timer](#the-systemd-timer) et peut être déclenché manuellement en exécutant la commande `arch-update -c`) : -![icon-checking](https://github.com/Antiz96/arch-update/assets/53110319/f4c09898-7b21-430f-84be-431a31e25c3f) +![vérification des icônes](https://github.com/Antiz96/arch-update/assets/53110319/f4c09898-7b21-430f-84be-431a31e25c3f) -If there are new available updates, the icon will show a bell sign and a desktop notification indicating the number of available updates will be sent (requires [libnotify/notify-send](https://archlinux.org/packages/extra/x86_64/libnotify/ "libnotify package")): +Si de nouvelles mises à jour sont disponibles, l'icône affichera une cloche et une notification sur le bureau indiquant le nombre de mises à jour disponibles sera envoyée (nécessite [libnotify/notify-send](https://archlinux.org/packages/extra/x86_64 /libnotify/ "paquet libnotify")) : -![icon-update-available](https://github.com/Antiz96/arch-update/assets/53110319/c1526ce7-5f94-41b8-a8fa-3587b9d00a9d) +![icône-mise à jour-disponible](https://github.com/Antiz96/arch-update/assets/53110319/c1526ce7-5f94-41b8-a8fa-3587b9d00a9d) ![notification](https://github.com/Antiz96/arch-update/assets/53110319/631b8e67-487a-441a-84b4-6cce95223729) -When the icon is clicked, it launches the relevant series of functions to perform a complete and proper update starting by refreshing the list of packages available for updates, print it inside a terminal window and asks for the user's confirmation to proceed with the installation (it can also be launched by running the `arch-update` command, requires [yay](https://aur.archlinux.org/packages/yay "yay") or [paru](https://aur.archlinux.org/packages/paru "paru") for AUR packages update support and [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak/) for Flatpak packages update support): +Lorsque l'on clique sur l'icône, elle lance la série de fonctions correspondantes pour effectuer une mise à jour complète et appropriée, en commençant par actualiser la liste des packages disponibles pour les mises à jour, en l'imprimant dans une fenêtre de terminal et en demandant la confirmation de l'utilisateur pour procéder à l'installation (il peut également être lancé en exécutant la commande `arch-update`, nécessite [yay](https://aur.archlinux.org/packages/yay "yay") ou [paru](https://aur.archlinux.org /packages/paru "paru") pour la prise en charge de la mise à jour des packages AUR et [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak/) pour la prise en charge de la mise à jour des packages Flatpak) : -*The colored output can be disabled with the `NoColor` option in the `arch-update.conf` configuration file.* -*The versions changes in the packages listing can be hidden with the `NoVersion` option in the `arch-update.conf` configuration file.* -*See the [arch-update.conf documentation chapter](#arch-update-configuration-file) for more details.* +*La sortie colorée peut être désactivée avec l'option `NoColor` dans le fichier de configuration `arch-update.conf`.* +*Les changements de versions dans la liste des packages peuvent être masqués avec l'option `NoVersion` dans le fichier de configuration `arch-update.conf`.* +*Voir le [chapitre de documentation arch-update.conf](#arch-update-configuration-file) pour plus de détails.* ![listing-packages](https://github.com/Antiz96/arch-update/assets/53110319/43a990c8-ed93-420f-8c46-d50d60bff03f) -Once you gave the confirmation to proceed, `arch-update` offers to print latest Arch Linux news. -Arch news that have been published within the last 15 days are tagged as `[NEW]`. -Select which news to read by typing its associated number. -After your read a news, `arch-update` will once again offers to print latest Arch Linux news, so you can read multiple news at once. -Simply press "enter" without typing any number to proceed with update: +Une fois que vous avez donné la confirmation pour continuer, `arch-update` propose d'imprimer les dernières nouvelles d'Arch Linux. +Les actualités arch publiées au cours des 15 derniers jours sont étiquetées comme « [NOUVEAU] ». +Sélectionnez les actualités à lire en tapant son numéro associé. +Après avoir lu une actualité, « arch-update » vous proposera à nouveau d'imprimer les dernières actualités Arch Linux, afin que vous puissiez lire plusieurs actualités à la fois. +Appuyez simplement sur « Entrée » sans saisir de chiffre pour procéder à la mise à jour : -*The Arch news listing/printing can be skipped with the `NoNews` option in the `arch-update.conf` configuration file.* -*Note that using this option will generate a warning message as a reminder that users are expected to regularly check Arch news.* -*See the [arch-update.conf documentation chapter](#arch-update-configuration-file) for more details.* +*La liste/impression des actualités Arch peut être ignorée avec l'option `NoNews` dans le fichier de configuration `arch-update.conf`.* +*Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les actualités d'Arch.* +*Voir le [chapitre de documentation arch-update.conf](#arch-update-configuration-file) pour plus de détails.* -![list-news](https://github.com/Antiz96/arch-update/assets/53110319/b6883ec4-8c44-4b97-86d9-4d0a304b748b) +![liste-nouvelles](https://github.com/Antiz96/arch-update/assets/53110319/b6883ec4-8c44-4b97-86d9-4d0a304b748b) -While `arch-update` is performing updates, the icon changes accordingly: +Pendant que `arch-update` effectue des mises à jour, l'icône change en conséquence : -![icon-installing](https://github.com/Antiz96/arch-update/assets/53110319/7c74ce84-7de4-4e09-aa2a-66afad9e61d7) +![installation d'icônes](https://github.com/Antiz96/arch-update/assets/53110319/7c74ce84-7de4-4e09-aa2a-66afad9e61d7) -When the update is over, the icon changes accordingly: +Une fois la mise à jour terminée, l'icône change en conséquence : -![icon-up-to-date](https://github.com/Antiz96/arch-update/assets/53110319/03f224a5-5fcf-450d-9aa5-bae90e7d2e8a) +![icône-à-date](https://github.com/Antiz96/arch-update/assets/53110319/03f224a5-5fcf-450d-9aa5-bae90e7d2e8a) -`arch-update` will then search for orphan packages/unused Flatpak packages and offers to remove them (if there are): +`arch-update` recherchera ensuite les packages orphelins/packages Flatpak inutilisés et proposera de les supprimer (s'il y en a) : -![orphan-packages](https://github.com/Antiz96/arch-update/assets/53110319/76b795e5-076e-4070-9fe2-73165503011b) +![paquets-orphelins](https://github.com/Antiz96/arch-update/assets/53110319/76b795e5-076e-4070-9fe2-73165503011b) ![flatpak-unused-packages](https://github.com/Antiz96/arch-update/assets/53110319/cd4053bb-623e-44c2-8c74-9f87710f4074) -`arch-update` will also search for old and/or uninstalled cached packages and offers to remove them (if there are): +`arch-update` recherchera également les packages mis en cache anciens et/ou désinstallés et proposera de les supprimer (le cas échéant) : -*The default behavior is to keep the last 3 cached versions of installed packages and remove every cached versions of uninstalled packages.* -*You can modify the number of old packages' versions and uninstalled packages' versions to keep in pacman's cache respectively with the `KeepOldPackages=Num` and `KeepUninstalledPackages=Num` options in the `arch-update.conf` configuration file.* -*See the [arch-update.conf documentation chapter](#arch-update-configuration-file) for more details.* +*Le comportement par défaut consiste à conserver les 3 dernières versions en cache des packages installés et à supprimer toutes les versions en cache des packages désinstallés.* +*Vous pouvez modifier le nombre d'anciennes versions de packages et de versions de packages désinstallés à conserver respectivement dans le cache de pacman avec les options `KeepOldPackages=Num` et `KeepUninstalledPackages=Num` dans le fichier de configuration `arch-update.conf`.* +*Voir le [chapitre de documentation arch-update.conf](#arch-update-configuration-file) pour plus de détails.* -![cached-packages](https://github.com/Antiz96/arch-update/assets/53110319/7199bbf1-acd8-49a1-80eb-e9874b94fba6) +![paquets-cachés](https://github.com/Antiz96/arch-update/assets/53110319/7199bbf1-acd8-49a1-80eb-e9874b94fba6) -Additionally `arch-update` will search for pacnew/pacsave files and offers to process them via `pacdiff` (if there are): +De plus, `arch-update` recherchera les fichiers pacnew/pacsave et proposera de les traiter via `pacdiff` (s'il y en a) : ![pacnew-files](https://github.com/Antiz96/arch-update/assets/53110319/5ee627ee-f7b7-4528-bf41-435d3c5892ac) -Finally, `arch-update` will check if there's a pending kernel update requiring a reboot to be applied and offers you to do so (if there is): +Enfin, `arch-update` vérifiera s'il y a une mise à jour du noyau en attente nécessitant un redémarrage et vous proposera de le faire (s'il y en a) : -![kernel-pending-update](https://github.com/Antiz96/arch-update/assets/53110319/14aef5b2-db32-4296-8a60-bc840c09d457) +![kernel-ending-update](https://github.com/Antiz96/arch-update/assets/53110319/14aef5b2-db32-4296-8a60-bc840c09d457) ## Documentation -### arch-update - -```text -An update notifier/applier for Arch Linux that assists you with -important pre/post update tasks. - -Run arch-update to perform the main "update" function: -Print the list of packages available for update, then ask for the user's confirmation -to proceed with the installation. -Before performing the update, offer to print the latest Arch Linux news. -Post update, check for orphan/unused packages, old cached packages, pacnew/pacsave files -and pending kernel update and, if there are, offers to process them. - -Options: --c, --check Check for available updates, send a desktop notification containing the number of available updates (if libnotify is installed) --h, --help Display this message and exit --V, --version Display version information and exit - -Exit Codes: -0 OK -1 Invalid option -2 No privilege method (sudo or doas) is installed -3 Error when changing icon -4 User didn't gave the confirmation to proceed -5 Error when updating the packages -6 Error when calling the reboot command to apply a pending kernel update +### arch-mise à jour + +```texte +Un notificateur/applicateur de mises à jour pour Arch Linux qui vous aide à +tâches importantes avant/après la mise à jour. + +Exécutez arch-update pour exécuter la fonction principale « mettre à jour » : +Imprimez la liste des packages disponibles en mise à jour, puis demandez la confirmation de l'utilisateur +pour procéder à l'installation. +Avant d'effectuer la mise à jour, proposez d'imprimer les dernières actualités d'Arch Linux. +Publier la mise à jour, vérifier les packages orphelins/inutilisés, les anciens packages mis en cache, les fichiers pacnew/pacsave +et en attente de mises à jour du noyau et, le cas échéant, propose de les traiter. + +Possibilités : +-c, --check Vérifier les mises à jour disponibles, envoyer une notification sur le bureau contenant le nombre de mises à jour disponibles (si libnotify est installé) +-h, --help Afficher ce message et quitter +-V, --version Afficher les informations de version et quitter + +Codes de sortie : +0 bien +1 option invalide +2 Aucune méthode de privilège (sudo ou doas) n'est installée +3 Erreur lors du changement d'icône +4 L'utilisateur n'a pas donné la confirmation pour continuer +5 Erreur lors de la mise à jour des packages +6 Erreur lors de l'appel de la commande reboot pour appliquer une mise à jour du noyau en attente ``` -For more information, see the arch-update(1) man page. -Certain options can be enabled/disabled or modified via the arch-update.conf configuration file, see the arch-update.conf(5) man page. +Pour plus d'informations, consultez la page de manuel arch-update(1). +Certaines options peuvent être activées/désactivées ou modifiées via le fichier de configuration arch-update.conf, voir la page de manuel arch-update.conf(5). -### arch-update configuration file +### fichier de configuration de la mise à jour arch -```text -The arch-update.conf file is an optional configuration file for arch-update to enable/disable -or modify certain options within the script. +```texte +Le fichier arch-update.conf est un fichier de configuration facultatif permettant à arch-update d'activer/désactiver +ou modifier certaines options dans le script. -This configuration file has to be located in "${XDG_CONFIG_HOME}/arch-update/arch-update.conf" -or "${HOME}/.config/arch-update/arch-update.conf". +Ce fichier de configuration doit se trouver dans "${XDG_CONFIG_HOME}/arch-update/arch-update.conf" +ou "${HOME}/.config/arch-update/arch-update.conf". -The supported options are: +Les options prises en charge sont : -- NoColor # Do not colorize output. -- NoVersion # Do not show versions changes for packages when listing pending updates. -- NoNews # Do not print Arch news. Note that using this option will generate a warning message as a reminder that users are expected to regularly check Arch news. -- KeepOldPackages=Num # Number of old packages' versions to keep in pacman's cache. Defaults to 3. -- KeepUninstalledPackages=Num # Number of uninstalled packages' versions to keep in pacman's cache. Defaults to 0. +- NoColor # Ne colorise pas la sortie. +- NoVersion # N'affiche pas les modifications de versions des packages lors de la liste des mises à jour en attente. +- NoNews # N'imprime pas les nouvelles d'Arch. Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les actualités d'Arch. +- KeepOldPackages=Num # Nombre d'anciennes versions de packages à conserver dans le cache de pacman. La valeur par défaut est 3. +- KeepUninstalledPackages=Num # Nombre de versions de packages désinstallés à conserver dans le cache de pacman. La valeur par défaut est 0. -Options are case sensitive, so capital letters have to be respected. +Les options sont sensibles à la casse, les majuscules doivent donc être respectées. ``` -For more information, see the arch-update(5) man page. +Pour plus d'informations, consultez la page de manuel arch-update(5). -## Tips and tricks +## Trucs et astuces -### AUR Support +### Prise en charge AUR -Arch-Update supports AUR packages update when checking and installing updates if **yay** or **paru** is installed: -See and -See and +Arch-Update prend en charge la mise à jour des packages AUR lors de la vérification et de l'installation des mises à jour si **yay** ou **paru** est installé : +Voir et +Voir et -### Flatpak Support +### Prise en charge des Flatpaks -Arch-Update supports Flatpak packages update when checking and installing updates (as well as removing unused Flatpak packages) if **flatpak** is installed: -See and +Arch-Update prend en charge la mise à jour des packages Flatpak lors de la vérification et de l'installation des mises à jour (ainsi que de la suppression des packages Flatpak inutilisés) si **flatpak** est installé : +Voir et -### Desktop notifications Support +### Notifications sur le bureau -Arch-Update supports desktop notifications when performing the `--check` function if **libnotify (notify-send)** is installed: -See +Arch-Update prend en charge les notifications du bureau lors de l'exécution de la fonction `--check` si **libnotify (notify-send)** est installé : +Voir -### Modify the auto-check cycle +### Modifier le cycle de vérification automatique -If you enabled the [systemd.timer](#the-systemd-timer), the `--check` option is automatically launched at boot and then once per hour. +Si vous avez activé le [systemd.timer](#the-systemd-timer), l'option `--check` est automatiquement lancée au démarrage puis une fois par heure. -If you want to change the check cycle, run `systemctl --user edit arch-update.timer` to create an override configuration for the timer and input the following in it: +Si vous souhaitez modifier le cycle de vérification, exécutez `systemctl --user edit arch-update.timer` pour créer une configuration de remplacement pour la minuterie et saisissez ce qui suit : -```text -[Timer] -OnUnitActiveSec=10m +```texte +[Minuteur] +OnUnitActiveSec = 10 min ``` -Time units are `s` for seconds, `m` for minutes, `h` for hours, `d` for days... -See for more details. +Les unités de temps sont « s » pour les secondes, « m » pour les minutes, « h » pour les heures, « d » pour les jours... +Voir pour plus de détails. -## Contributing +## Contribuant -You can raise your issues, feedbacks and suggestions in the [issues tab](https://github.com/Antiz96/arch-update/issues). -[Pull requests](https://github.com/Antiz96/arch-update/pulls) are welcomed as well! +Vous pouvez soulever vos problèmes, commentaires et suggestions dans l'onglet [Issues](https://github.com/Antiz96/arch-update/issues). +Les [Pull request](https://github.com/Antiz96/arch-update/pulls) sont également les bienvenues ! From f2f04baabea95463d34d8713e0ea4f0a0cbe3631 Mon Sep 17 00:00:00 2001 From: Robin Candau Date: Wed, 10 Jan 2024 15:44:09 +0100 Subject: [PATCH 2/9] Put the translated README in the README-fr.md file --- README-fr.md | 240 ++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 241 +-------------------------------------------------- 2 files changed, 242 insertions(+), 239 deletions(-) create mode 100644 README-fr.md diff --git a/README-fr.md b/README-fr.md new file mode 100644 index 0000000..bd1486a --- /dev/null +++ b/README-fr.md @@ -0,0 +1,240 @@ +# Arch-Mise à jour + +## Table des matières + +- [Description](#description) +- [Installation](#installation) +- [Utilisation](#utilisation) +- [Documentation](#documentation) +- [Trucs et astuces](#trucs-et-astuces) +- [Contribuer](#contribuer) + +## Description + +Un notificateur/applicateur de mises à jour pour Arch Linux qui vous aide dans les tâches importantes de pré/post-mise à jour et qui comprend une icône cliquable (.desktop) qui peut facilement être intégrée à n'importe quel Environnement de Bureau/Manager de fenêtres, dock, barre d'état/lancement ou menu d'application. +Prise en charge facultative des mises à jour des packages AUR/Flatpak et des notifications sur le bureau. + +Caractéristiques: + +- Inclut une icône cliquable (.desktop) qui change automatiquement pour agir comme un notificateur/applicateur de mise à jour. Facile à intégrer avec n'importe quel DE/WM, dock, barre d'état/lancement, menu d'application, etc... +- Vérification et liste automatiques de tous les packages disponibles pour la mise à jour (via [checkupdates](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package")). +- Propose d'imprimer les dernières nouvelles d'Arch Linux avant d'appliquer les mises à jour (via [curl](https://archlinux.org/packages/core/x86_64/curl/ "curl package") et [htmlq] (https://archlinux. org/packages/extra/x86_64/htmlq/ "package htmlq")). +- Vérification et listage automatique des packages orphelins et vous proposant de les supprimer. +- Vérification automatique des paquets anciens et/ou désinstallés dans le cache de `pacman` et vous proposant de les supprimer (via [paccache](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman -paquet de contribution")). +- Vous aide à traiter les fichiers pacnew/pacsave (via [pacdiff](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package"), nécessite éventuellement [vim](https:// archlinux.org/packages/extra/x86_64/vim/ "vim package") comme [programme de fusion] par défaut (https://wiki.archlinux.org/title/Pacman/Pacnew_and_Pacsave#pacdiff "programme de fusion pacdiff")). +- Vérification automatique des mises à jour du noyau en attente nécessitant un redémarrage et propose de le faire s'il y en a un. +- Prise en charge de [sudo](https://archlinux.org/packages/core/x86_64/sudo/ "sudo package") et de [doas](https://archlinux.org/packages/extra/x86_64/opendoas/ "paquet opendoas"). +- Prise en charge facultative de la mise à jour des packages AUR (via [yay](https://aur.archlinux.org/packages/yay "yay AUR package") ou [paru](https://aur.archlinux.org/packages/paru "paquet paru AUR")). +- Prise en charge facultative de la mise à jour des packages Flatpak (via [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak "Package Flatpak")). +- Prise en charge facultative des notifications de bureau (via [libnotify](https://archlinux.org/packages/extra/x86_64/libnotify "libnotify package"), voir ) . + +##Installation + +### AUR + +Installez le package AUR [arch-update](https://aur.archlinux.org/packages/arch-update "arch-update AUR package"). + +### Depuis les fichiers sources + +Installer les dépendances : + +```bash +sudo pacman -S --needed pacman-contrib curl htmlq diffutils +``` + +Téléchargez l'archive de la [dernière version stable](https://github.com/Antiz96/arch-update/releases/latest) et extrayez-la *(vous pouvez également cloner ce référentiel via `git`)*. + +Pour installer `arch-update`, allez dans le répertoire extrait/cloné et exécutez la commande suivante : + +```bash +sudo make install +``` + +Pour désinstaller `arch-update`, allez dans le répertoire extrait/cloné et exécutez la commande suivante : + +```bash +sudo make désinstaller +``` + +## Utilisation + +L'utilisation consiste à intégrer [le fichier .desktop](#the-desktop-file) n'importe où (cela peut être votre bureau, votre dock, votre barre d'état/de lancement et/ou le menu de votre application) et à activer le [timer systemd](# le-systemd-timer). + +Voici une petite présentation/revue YouTube de `arch-update` que [Cardiac](https://github.com/Cardiacman13) et moi avons réalisée sur [sa chaîne YouTube](https://www.youtube.com/@ Cardiacman) (**les vidéos là-bas, dont celle-ci, sont en français**) : + +*Attention : les fonctionnalités et le comportement par défaut d'Arch-Update peuvent avoir changé/évolué depuis !* + +[![youtube_presentation](https://github.com/Antiz96/arch-update/assets/53110319/23af5180-1881-486d-bd5a-3edd48ed1a08)](https://www.youtube.com/watch?v= QkOkX70SEmo) + +### Le fichier .desktop + +Le fichier .desktop se trouve dans `/usr/share/applications/arch-update.desktop` (ou `/usr/local/share/applications/arch-update.desktop` si vous avez installé `arch-update` [à partir des sources ](#from-source)). +Son icône changera automatiquement en fonction des différents états (vérification des mises à jour, mises à jour disponibles, installation des mises à jour, à jour). +Il lancera la série de fonctions pertinentes pour effectuer une mise à jour complète et appropriée lorsque vous cliquez dessus (voir le chapitre [Documentation](#documentation)). Il est facile à intégrer à n’importe quel DE/WM, dock, barre d’état/lancement ou menu d’application. + +### Le minuteur système + +Il existe un service systemd dans `/usr/lib/systemd/user/arch-update.service` (ou dans `/usr/local/lib/systemd/user/arch-update.service` si vous avez installé `arch-update ` [from source](#from-source)) qui exécute la fonction `check` au démarrage (voir le chapitre [Documentation](#documentation)). +Pour le démarrer automatiquement **au démarrage puis une fois toutes les heures**, activez le timer systemd associé (vous pouvez modifier le cycle de vérification automatique à votre guise, voir les [Trucs et astuces - Modifier le cycle de vérification automatique](# chapitre modifier le cycle de vérification automatique) : + +```bash +systemctl --user activer --now arch-update.timer +``` + +### Capture d'écran + +Personnellement, j'ai intégré l'icône .desktop dans ma barre supérieure. +C'est la première icône en partant de la gauche. + +![icône](https://github.com/Antiz96/arch-update/assets/53110319/25f3d2ca-b9d3-4a32-ace3-b0fa785662c2) + +Lorsque `arch-update` vérifie les mises à jour, l'icône change en conséquence (la fonction `check` est automatiquement déclenchée au démarrage puis une fois toutes les heures si vous avez activé le [systemd timer](#the-systemd-timer) et peut être déclenché manuellement en exécutant la commande `arch-update -c`) : + +![vérification des icônes](https://github.com/Antiz96/arch-update/assets/53110319/f4c09898-7b21-430f-84be-431a31e25c3f) + +Si de nouvelles mises à jour sont disponibles, l'icône affichera une cloche et une notification sur le bureau indiquant le nombre de mises à jour disponibles sera envoyée (nécessite [libnotify/notify-send](https://archlinux.org/packages/extra/x86_64 /libnotify/ "paquet libnotify")) : + +![icône-mise à jour-disponible](https://github.com/Antiz96/arch-update/assets/53110319/c1526ce7-5f94-41b8-a8fa-3587b9d00a9d) +![notification](https://github.com/Antiz96/arch-update/assets/53110319/631b8e67-487a-441a-84b4-6cce95223729) + +Lorsque l'on clique sur l'icône, elle lance la série de fonctions correspondantes pour effectuer une mise à jour complète et appropriée, en commençant par actualiser la liste des packages disponibles pour les mises à jour, en l'imprimant dans une fenêtre de terminal et en demandant la confirmation de l'utilisateur pour procéder à l'installation (il peut également être lancé en exécutant la commande `arch-update`, nécessite [yay](https://aur.archlinux.org/packages/yay "yay") ou [paru](https://aur.archlinux.org /packages/paru "paru") pour la prise en charge de la mise à jour des packages AUR et [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak/) pour la prise en charge de la mise à jour des packages Flatpak) : + +*La sortie colorée peut être désactivée avec l'option `NoColor` dans le fichier de configuration `arch-update.conf`.* +*Les changements de versions dans la liste des packages peuvent être masqués avec l'option `NoVersion` dans le fichier de configuration `arch-update.conf`.* +*Voir le [chapitre de documentation arch-update.conf](#arch-update-configuration-file) pour plus de détails.* + +![listing-packages](https://github.com/Antiz96/arch-update/assets/53110319/43a990c8-ed93-420f-8c46-d50d60bff03f) + +Une fois que vous avez donné la confirmation pour continuer, `arch-update` propose d'imprimer les dernières nouvelles d'Arch Linux. +Les actualités arch publiées au cours des 15 derniers jours sont étiquetées comme « [NOUVEAU] ». +Sélectionnez les actualités à lire en tapant son numéro associé. +Après avoir lu une actualité, « arch-update » vous proposera à nouveau d'imprimer les dernières actualités Arch Linux, afin que vous puissiez lire plusieurs actualités à la fois. +Appuyez simplement sur « Entrée » sans saisir de chiffre pour procéder à la mise à jour : + +*La liste/impression des actualités Arch peut être ignorée avec l'option `NoNews` dans le fichier de configuration `arch-update.conf`.* +*Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les actualités d'Arch.* +*Voir le [chapitre de documentation arch-update.conf](#arch-update-configuration-file) pour plus de détails.* + +![liste-nouvelles](https://github.com/Antiz96/arch-update/assets/53110319/b6883ec4-8c44-4b97-86d9-4d0a304b748b) + +Pendant que `arch-update` effectue des mises à jour, l'icône change en conséquence : + +![installation d'icônes](https://github.com/Antiz96/arch-update/assets/53110319/7c74ce84-7de4-4e09-aa2a-66afad9e61d7) + +Une fois la mise à jour terminée, l'icône change en conséquence : + +![icône-à-date](https://github.com/Antiz96/arch-update/assets/53110319/03f224a5-5fcf-450d-9aa5-bae90e7d2e8a) + +`arch-update` recherchera ensuite les packages orphelins/packages Flatpak inutilisés et proposera de les supprimer (s'il y en a) : + +![paquets-orphelins](https://github.com/Antiz96/arch-update/assets/53110319/76b795e5-076e-4070-9fe2-73165503011b) + +![flatpak-unused-packages](https://github.com/Antiz96/arch-update/assets/53110319/cd4053bb-623e-44c2-8c74-9f87710f4074) + +`arch-update` recherchera également les packages mis en cache anciens et/ou désinstallés et proposera de les supprimer (le cas échéant) : + +*Le comportement par défaut consiste à conserver les 3 dernières versions en cache des packages installés et à supprimer toutes les versions en cache des packages désinstallés.* +*Vous pouvez modifier le nombre d'anciennes versions de packages et de versions de packages désinstallés à conserver respectivement dans le cache de pacman avec les options `KeepOldPackages=Num` et `KeepUninstalledPackages=Num` dans le fichier de configuration `arch-update.conf`.* +*Voir le [chapitre de documentation arch-update.conf](#arch-update-configuration-file) pour plus de détails.* + +![paquets-cachés](https://github.com/Antiz96/arch-update/assets/53110319/7199bbf1-acd8-49a1-80eb-e9874b94fba6) + +De plus, `arch-update` recherchera les fichiers pacnew/pacsave et proposera de les traiter via `pacdiff` (s'il y en a) : + +![pacnew-files](https://github.com/Antiz96/arch-update/assets/53110319/5ee627ee-f7b7-4528-bf41-435d3c5892ac) + +Enfin, `arch-update` vérifiera s'il y a une mise à jour du noyau en attente nécessitant un redémarrage et vous proposera de le faire (s'il y en a) : + +![kernel-ending-update](https://github.com/Antiz96/arch-update/assets/53110319/14aef5b2-db32-4296-8a60-bc840c09d457) + +## Documentation + +### arch-mise à jour + +```texte +Un notificateur/applicateur de mises à jour pour Arch Linux qui vous aide à +tâches importantes avant/après la mise à jour. + +Exécutez arch-update pour exécuter la fonction principale « mettre à jour » : +Imprimez la liste des packages disponibles en mise à jour, puis demandez la confirmation de l'utilisateur +pour procéder à l'installation. +Avant d'effectuer la mise à jour, proposez d'imprimer les dernières actualités d'Arch Linux. +Publier la mise à jour, vérifier les packages orphelins/inutilisés, les anciens packages mis en cache, les fichiers pacnew/pacsave +et en attente de mises à jour du noyau et, le cas échéant, propose de les traiter. + +Possibilités : +-c, --check Vérifier les mises à jour disponibles, envoyer une notification sur le bureau contenant le nombre de mises à jour disponibles (si libnotify est installé) +-h, --help Afficher ce message et quitter +-V, --version Afficher les informations de version et quitter + +Codes de sortie : +0 bien +1 option invalide +2 Aucune méthode de privilège (sudo ou doas) n'est installée +3 Erreur lors du changement d'icône +4 L'utilisateur n'a pas donné la confirmation pour continuer +5 Erreur lors de la mise à jour des packages +6 Erreur lors de l'appel de la commande reboot pour appliquer une mise à jour du noyau en attente +``` + +Pour plus d'informations, consultez la page de manuel arch-update(1). +Certaines options peuvent être activées/désactivées ou modifiées via le fichier de configuration arch-update.conf, voir la page de manuel arch-update.conf(5). + +### fichier de configuration de la mise à jour arch + +```texte +Le fichier arch-update.conf est un fichier de configuration facultatif permettant à arch-update d'activer/désactiver +ou modifier certaines options dans le script. + +Ce fichier de configuration doit se trouver dans "${XDG_CONFIG_HOME}/arch-update/arch-update.conf" +ou "${HOME}/.config/arch-update/arch-update.conf". + +Les options prises en charge sont : + +- NoColor # Ne colorise pas la sortie. +- NoVersion # N'affiche pas les modifications de versions des packages lors de la liste des mises à jour en attente. +- NoNews # N'imprime pas les nouvelles d'Arch. Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les actualités d'Arch. +- KeepOldPackages=Num # Nombre d'anciennes versions de packages à conserver dans le cache de pacman. La valeur par défaut est 3. +- KeepUninstalledPackages=Num # Nombre de versions de packages désinstallés à conserver dans le cache de pacman. La valeur par défaut est 0. + +Les options sont sensibles à la casse, les majuscules doivent donc être respectées. +``` + +Pour plus d'informations, consultez la page de manuel arch-update(5). + +## Trucs et astuces + +### Prise en charge AUR + +Arch-Update prend en charge la mise à jour des packages AUR lors de la vérification et de l'installation des mises à jour si **yay** ou **paru** est installé : +Voir et +Voir et + +### Prise en charge des Flatpaks + +Arch-Update prend en charge la mise à jour des packages Flatpak lors de la vérification et de l'installation des mises à jour (ainsi que de la suppression des packages Flatpak inutilisés) si **flatpak** est installé : +Voir et + +### Notifications sur le bureau + +Arch-Update prend en charge les notifications du bureau lors de l'exécution de la fonction `--check` si **libnotify (notify-send)** est installé : +Voir + +### Modifier le cycle de vérification automatique + +Si vous avez activé le [systemd.timer](#the-systemd-timer), l'option `--check` est automatiquement lancée au démarrage puis une fois par heure. + +Si vous souhaitez modifier le cycle de vérification, exécutez `systemctl --user edit arch-update.timer` pour créer une configuration de remplacement pour la minuterie et saisissez ce qui suit : + +```texte +[Minuteur] +OnUnitActiveSec = 10 min +``` + +Les unités de temps sont « s » pour les secondes, « m » pour les minutes, « h » pour les heures, « d » pour les jours... +Voir pour plus de détails. + +## Contribuant + +Vous pouvez soulever vos problèmes, commentaires et suggestions dans l'onglet [Issues](https://github.com/Antiz96/arch-update/issues). +Les [Pull request](https://github.com/Antiz96/arch-update/pulls) sont également les bienvenues ! diff --git a/README.md b/README.md index bd1486a..b8ff1a8 100644 --- a/README.md +++ b/README.md @@ -1,240 +1,3 @@ -# Arch-Mise à jour +# antiz.fr -## Table des matières - -- [Description](#description) -- [Installation](#installation) -- [Utilisation](#utilisation) -- [Documentation](#documentation) -- [Trucs et astuces](#trucs-et-astuces) -- [Contribuer](#contribuer) - -## Description - -Un notificateur/applicateur de mises à jour pour Arch Linux qui vous aide dans les tâches importantes de pré/post-mise à jour et qui comprend une icône cliquable (.desktop) qui peut facilement être intégrée à n'importe quel Environnement de Bureau/Manager de fenêtres, dock, barre d'état/lancement ou menu d'application. -Prise en charge facultative des mises à jour des packages AUR/Flatpak et des notifications sur le bureau. - -Caractéristiques: - -- Inclut une icône cliquable (.desktop) qui change automatiquement pour agir comme un notificateur/applicateur de mise à jour. Facile à intégrer avec n'importe quel DE/WM, dock, barre d'état/lancement, menu d'application, etc... -- Vérification et liste automatiques de tous les packages disponibles pour la mise à jour (via [checkupdates](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package")). -- Propose d'imprimer les dernières nouvelles d'Arch Linux avant d'appliquer les mises à jour (via [curl](https://archlinux.org/packages/core/x86_64/curl/ "curl package") et [htmlq] (https://archlinux. org/packages/extra/x86_64/htmlq/ "package htmlq")). -- Vérification et listage automatique des packages orphelins et vous proposant de les supprimer. -- Vérification automatique des paquets anciens et/ou désinstallés dans le cache de `pacman` et vous proposant de les supprimer (via [paccache](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman -paquet de contribution")). -- Vous aide à traiter les fichiers pacnew/pacsave (via [pacdiff](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package"), nécessite éventuellement [vim](https:// archlinux.org/packages/extra/x86_64/vim/ "vim package") comme [programme de fusion] par défaut (https://wiki.archlinux.org/title/Pacman/Pacnew_and_Pacsave#pacdiff "programme de fusion pacdiff")). -- Vérification automatique des mises à jour du noyau en attente nécessitant un redémarrage et propose de le faire s'il y en a un. -- Prise en charge de [sudo](https://archlinux.org/packages/core/x86_64/sudo/ "sudo package") et de [doas](https://archlinux.org/packages/extra/x86_64/opendoas/ "paquet opendoas"). -- Prise en charge facultative de la mise à jour des packages AUR (via [yay](https://aur.archlinux.org/packages/yay "yay AUR package") ou [paru](https://aur.archlinux.org/packages/paru "paquet paru AUR")). -- Prise en charge facultative de la mise à jour des packages Flatpak (via [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak "Package Flatpak")). -- Prise en charge facultative des notifications de bureau (via [libnotify](https://archlinux.org/packages/extra/x86_64/libnotify "libnotify package"), voir ) . - -##Installation - -### AUR - -Installez le package AUR [arch-update](https://aur.archlinux.org/packages/arch-update "arch-update AUR package"). - -### Depuis les fichiers sources - -Installer les dépendances : - -```bash -sudo pacman -S --needed pacman-contrib curl htmlq diffutils -``` - -Téléchargez l'archive de la [dernière version stable](https://github.com/Antiz96/arch-update/releases/latest) et extrayez-la *(vous pouvez également cloner ce référentiel via `git`)*. - -Pour installer `arch-update`, allez dans le répertoire extrait/cloné et exécutez la commande suivante : - -```bash -sudo make install -``` - -Pour désinstaller `arch-update`, allez dans le répertoire extrait/cloné et exécutez la commande suivante : - -```bash -sudo make désinstaller -``` - -## Utilisation - -L'utilisation consiste à intégrer [le fichier .desktop](#the-desktop-file) n'importe où (cela peut être votre bureau, votre dock, votre barre d'état/de lancement et/ou le menu de votre application) et à activer le [timer systemd](# le-systemd-timer). - -Voici une petite présentation/revue YouTube de `arch-update` que [Cardiac](https://github.com/Cardiacman13) et moi avons réalisée sur [sa chaîne YouTube](https://www.youtube.com/@ Cardiacman) (**les vidéos là-bas, dont celle-ci, sont en français**) : - -*Attention : les fonctionnalités et le comportement par défaut d'Arch-Update peuvent avoir changé/évolué depuis !* - -[![youtube_presentation](https://github.com/Antiz96/arch-update/assets/53110319/23af5180-1881-486d-bd5a-3edd48ed1a08)](https://www.youtube.com/watch?v= QkOkX70SEmo) - -### Le fichier .desktop - -Le fichier .desktop se trouve dans `/usr/share/applications/arch-update.desktop` (ou `/usr/local/share/applications/arch-update.desktop` si vous avez installé `arch-update` [à partir des sources ](#from-source)). -Son icône changera automatiquement en fonction des différents états (vérification des mises à jour, mises à jour disponibles, installation des mises à jour, à jour). -Il lancera la série de fonctions pertinentes pour effectuer une mise à jour complète et appropriée lorsque vous cliquez dessus (voir le chapitre [Documentation](#documentation)). Il est facile à intégrer à n’importe quel DE/WM, dock, barre d’état/lancement ou menu d’application. - -### Le minuteur système - -Il existe un service systemd dans `/usr/lib/systemd/user/arch-update.service` (ou dans `/usr/local/lib/systemd/user/arch-update.service` si vous avez installé `arch-update ` [from source](#from-source)) qui exécute la fonction `check` au démarrage (voir le chapitre [Documentation](#documentation)). -Pour le démarrer automatiquement **au démarrage puis une fois toutes les heures**, activez le timer systemd associé (vous pouvez modifier le cycle de vérification automatique à votre guise, voir les [Trucs et astuces - Modifier le cycle de vérification automatique](# chapitre modifier le cycle de vérification automatique) : - -```bash -systemctl --user activer --now arch-update.timer -``` - -### Capture d'écran - -Personnellement, j'ai intégré l'icône .desktop dans ma barre supérieure. -C'est la première icône en partant de la gauche. - -![icône](https://github.com/Antiz96/arch-update/assets/53110319/25f3d2ca-b9d3-4a32-ace3-b0fa785662c2) - -Lorsque `arch-update` vérifie les mises à jour, l'icône change en conséquence (la fonction `check` est automatiquement déclenchée au démarrage puis une fois toutes les heures si vous avez activé le [systemd timer](#the-systemd-timer) et peut être déclenché manuellement en exécutant la commande `arch-update -c`) : - -![vérification des icônes](https://github.com/Antiz96/arch-update/assets/53110319/f4c09898-7b21-430f-84be-431a31e25c3f) - -Si de nouvelles mises à jour sont disponibles, l'icône affichera une cloche et une notification sur le bureau indiquant le nombre de mises à jour disponibles sera envoyée (nécessite [libnotify/notify-send](https://archlinux.org/packages/extra/x86_64 /libnotify/ "paquet libnotify")) : - -![icône-mise à jour-disponible](https://github.com/Antiz96/arch-update/assets/53110319/c1526ce7-5f94-41b8-a8fa-3587b9d00a9d) -![notification](https://github.com/Antiz96/arch-update/assets/53110319/631b8e67-487a-441a-84b4-6cce95223729) - -Lorsque l'on clique sur l'icône, elle lance la série de fonctions correspondantes pour effectuer une mise à jour complète et appropriée, en commençant par actualiser la liste des packages disponibles pour les mises à jour, en l'imprimant dans une fenêtre de terminal et en demandant la confirmation de l'utilisateur pour procéder à l'installation (il peut également être lancé en exécutant la commande `arch-update`, nécessite [yay](https://aur.archlinux.org/packages/yay "yay") ou [paru](https://aur.archlinux.org /packages/paru "paru") pour la prise en charge de la mise à jour des packages AUR et [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak/) pour la prise en charge de la mise à jour des packages Flatpak) : - -*La sortie colorée peut être désactivée avec l'option `NoColor` dans le fichier de configuration `arch-update.conf`.* -*Les changements de versions dans la liste des packages peuvent être masqués avec l'option `NoVersion` dans le fichier de configuration `arch-update.conf`.* -*Voir le [chapitre de documentation arch-update.conf](#arch-update-configuration-file) pour plus de détails.* - -![listing-packages](https://github.com/Antiz96/arch-update/assets/53110319/43a990c8-ed93-420f-8c46-d50d60bff03f) - -Une fois que vous avez donné la confirmation pour continuer, `arch-update` propose d'imprimer les dernières nouvelles d'Arch Linux. -Les actualités arch publiées au cours des 15 derniers jours sont étiquetées comme « [NOUVEAU] ». -Sélectionnez les actualités à lire en tapant son numéro associé. -Après avoir lu une actualité, « arch-update » vous proposera à nouveau d'imprimer les dernières actualités Arch Linux, afin que vous puissiez lire plusieurs actualités à la fois. -Appuyez simplement sur « Entrée » sans saisir de chiffre pour procéder à la mise à jour : - -*La liste/impression des actualités Arch peut être ignorée avec l'option `NoNews` dans le fichier de configuration `arch-update.conf`.* -*Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les actualités d'Arch.* -*Voir le [chapitre de documentation arch-update.conf](#arch-update-configuration-file) pour plus de détails.* - -![liste-nouvelles](https://github.com/Antiz96/arch-update/assets/53110319/b6883ec4-8c44-4b97-86d9-4d0a304b748b) - -Pendant que `arch-update` effectue des mises à jour, l'icône change en conséquence : - -![installation d'icônes](https://github.com/Antiz96/arch-update/assets/53110319/7c74ce84-7de4-4e09-aa2a-66afad9e61d7) - -Une fois la mise à jour terminée, l'icône change en conséquence : - -![icône-à-date](https://github.com/Antiz96/arch-update/assets/53110319/03f224a5-5fcf-450d-9aa5-bae90e7d2e8a) - -`arch-update` recherchera ensuite les packages orphelins/packages Flatpak inutilisés et proposera de les supprimer (s'il y en a) : - -![paquets-orphelins](https://github.com/Antiz96/arch-update/assets/53110319/76b795e5-076e-4070-9fe2-73165503011b) - -![flatpak-unused-packages](https://github.com/Antiz96/arch-update/assets/53110319/cd4053bb-623e-44c2-8c74-9f87710f4074) - -`arch-update` recherchera également les packages mis en cache anciens et/ou désinstallés et proposera de les supprimer (le cas échéant) : - -*Le comportement par défaut consiste à conserver les 3 dernières versions en cache des packages installés et à supprimer toutes les versions en cache des packages désinstallés.* -*Vous pouvez modifier le nombre d'anciennes versions de packages et de versions de packages désinstallés à conserver respectivement dans le cache de pacman avec les options `KeepOldPackages=Num` et `KeepUninstalledPackages=Num` dans le fichier de configuration `arch-update.conf`.* -*Voir le [chapitre de documentation arch-update.conf](#arch-update-configuration-file) pour plus de détails.* - -![paquets-cachés](https://github.com/Antiz96/arch-update/assets/53110319/7199bbf1-acd8-49a1-80eb-e9874b94fba6) - -De plus, `arch-update` recherchera les fichiers pacnew/pacsave et proposera de les traiter via `pacdiff` (s'il y en a) : - -![pacnew-files](https://github.com/Antiz96/arch-update/assets/53110319/5ee627ee-f7b7-4528-bf41-435d3c5892ac) - -Enfin, `arch-update` vérifiera s'il y a une mise à jour du noyau en attente nécessitant un redémarrage et vous proposera de le faire (s'il y en a) : - -![kernel-ending-update](https://github.com/Antiz96/arch-update/assets/53110319/14aef5b2-db32-4296-8a60-bc840c09d457) - -## Documentation - -### arch-mise à jour - -```texte -Un notificateur/applicateur de mises à jour pour Arch Linux qui vous aide à -tâches importantes avant/après la mise à jour. - -Exécutez arch-update pour exécuter la fonction principale « mettre à jour » : -Imprimez la liste des packages disponibles en mise à jour, puis demandez la confirmation de l'utilisateur -pour procéder à l'installation. -Avant d'effectuer la mise à jour, proposez d'imprimer les dernières actualités d'Arch Linux. -Publier la mise à jour, vérifier les packages orphelins/inutilisés, les anciens packages mis en cache, les fichiers pacnew/pacsave -et en attente de mises à jour du noyau et, le cas échéant, propose de les traiter. - -Possibilités : --c, --check Vérifier les mises à jour disponibles, envoyer une notification sur le bureau contenant le nombre de mises à jour disponibles (si libnotify est installé) --h, --help Afficher ce message et quitter --V, --version Afficher les informations de version et quitter - -Codes de sortie : -0 bien -1 option invalide -2 Aucune méthode de privilège (sudo ou doas) n'est installée -3 Erreur lors du changement d'icône -4 L'utilisateur n'a pas donné la confirmation pour continuer -5 Erreur lors de la mise à jour des packages -6 Erreur lors de l'appel de la commande reboot pour appliquer une mise à jour du noyau en attente -``` - -Pour plus d'informations, consultez la page de manuel arch-update(1). -Certaines options peuvent être activées/désactivées ou modifiées via le fichier de configuration arch-update.conf, voir la page de manuel arch-update.conf(5). - -### fichier de configuration de la mise à jour arch - -```texte -Le fichier arch-update.conf est un fichier de configuration facultatif permettant à arch-update d'activer/désactiver -ou modifier certaines options dans le script. - -Ce fichier de configuration doit se trouver dans "${XDG_CONFIG_HOME}/arch-update/arch-update.conf" -ou "${HOME}/.config/arch-update/arch-update.conf". - -Les options prises en charge sont : - -- NoColor # Ne colorise pas la sortie. -- NoVersion # N'affiche pas les modifications de versions des packages lors de la liste des mises à jour en attente. -- NoNews # N'imprime pas les nouvelles d'Arch. Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les actualités d'Arch. -- KeepOldPackages=Num # Nombre d'anciennes versions de packages à conserver dans le cache de pacman. La valeur par défaut est 3. -- KeepUninstalledPackages=Num # Nombre de versions de packages désinstallés à conserver dans le cache de pacman. La valeur par défaut est 0. - -Les options sont sensibles à la casse, les majuscules doivent donc être respectées. -``` - -Pour plus d'informations, consultez la page de manuel arch-update(5). - -## Trucs et astuces - -### Prise en charge AUR - -Arch-Update prend en charge la mise à jour des packages AUR lors de la vérification et de l'installation des mises à jour si **yay** ou **paru** est installé : -Voir et -Voir et - -### Prise en charge des Flatpaks - -Arch-Update prend en charge la mise à jour des packages Flatpak lors de la vérification et de l'installation des mises à jour (ainsi que de la suppression des packages Flatpak inutilisés) si **flatpak** est installé : -Voir et - -### Notifications sur le bureau - -Arch-Update prend en charge les notifications du bureau lors de l'exécution de la fonction `--check` si **libnotify (notify-send)** est installé : -Voir - -### Modifier le cycle de vérification automatique - -Si vous avez activé le [systemd.timer](#the-systemd-timer), l'option `--check` est automatiquement lancée au démarrage puis une fois par heure. - -Si vous souhaitez modifier le cycle de vérification, exécutez `systemctl --user edit arch-update.timer` pour créer une configuration de remplacement pour la minuterie et saisissez ce qui suit : - -```texte -[Minuteur] -OnUnitActiveSec = 10 min -``` - -Les unités de temps sont « s » pour les secondes, « m » pour les minutes, « h » pour les heures, « d » pour les jours... -Voir pour plus de détails. - -## Contribuant - -Vous pouvez soulever vos problèmes, commentaires et suggestions dans l'onglet [Issues](https://github.com/Antiz96/arch-update/issues). -Les [Pull request](https://github.com/Antiz96/arch-update/pulls) sont également les bienvenues ! +Git repo for my personal website: From 1f4a0b1fa3a22fca2bcd1e338e45326a476184f3 Mon Sep 17 00:00:00 2001 From: Robin Candau Date: Wed, 10 Jan 2024 15:44:48 +0100 Subject: [PATCH 3/9] Wrong README... --- README.md | 241 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 239 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index b8ff1a8..5992941 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,240 @@ -# antiz.fr +# Arch-Update -Git repo for my personal website: +## Table of contents + +- [Description](#description) +- [Installation](#installation) +- [Usage](#usage) +- [Documentation](#documentation) +- [Tips and tricks](#tips-and-tricks) +- [Contributing](#contributing) + +## Description + +An update notifier/applier for Arch Linux that assists you with important pre/post update tasks and that includes a (.desktop) clickeable icon that can easily be integrated with any DE/WM, dock, status/launch bar or app menu. +Optional support for AUR/Flatpak packages updates and desktop notifications. + +Features: + +- Includes a (.desktop) clickeable icon that automatically changes to act as an update notifier/applier. Easy to integrate with any DE/WM, dock, status/launch bar, app menu, etc... +- Automatic check and listing of every packages available for update (through [checkupdates](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package")). +- Offers to print the latest Arch Linux news before applying updates (through [curl](https://archlinux.org/packages/core/x86_64/curl/ "curl package") and [htmlq](https://archlinux.org/packages/extra/x86_64/htmlq/ "htmlq package")). +- Automatic check and listing of orphan packages and offering you to remove them. +- Automatic check for old and/or uninstalled cached packages in `pacman`'s cache and offering you to remove them (through [paccache](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package")). +- Helps you processing pacnew/pacsave files (through [pacdiff](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package"), optionally requires [vim](https://archlinux.org/packages/extra/x86_64/vim/ "vim package") as the default [merge program](https://wiki.archlinux.org/title/Pacman/Pacnew_and_Pacsave#pacdiff "pacdiff merge program")). +- Automatic check for pending kernel updates requiring a reboot to be applied and offers to do so if there's one. +- Support for both [sudo](https://archlinux.org/packages/core/x86_64/sudo/ "sudo package") and [doas](https://archlinux.org/packages/extra/x86_64/opendoas/ "opendoas package"). +- Optional support for AUR packages update (through [yay](https://aur.archlinux.org/packages/yay "yay AUR package") or [paru](https://aur.archlinux.org/packages/paru "paru AUR package")). +- Optional support for Flatpak packages update (through [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak "Flatpak package")). +- Optional support for desktop notifications (through [libnotify](https://archlinux.org/packages/extra/x86_64/libnotify "libnotify package"), see ). + +## Installation + +### AUR + +Install the [arch-update](https://aur.archlinux.org/packages/arch-update "arch-update AUR package") AUR package. + +### From Source + +Install dependencies: + +```bash +sudo pacman -S --needed pacman-contrib curl htmlq diffutils +``` + +Download the archive of the [latest stable release](https://github.com/Antiz96/arch-update/releases/latest) and extract it *(alternatively, you can clone this repository via `git`)*. + +To install `arch-update`, go into the extracted/cloned directory and run the following command: + +```bash +sudo make install +``` + +To uninstall `arch-update`, go into the extracted/cloned directory and run the following command: + +```bash +sudo make uninstall +``` + +## Usage + +The usage consist of integrating [the .desktop file](#the-desktop-file) anywhere (could be your desktop, your dock, your status/launch bar and/or your app menu) and enabling the [systemd timer](#the-systemd-timer). + +Here is a little YouTube presentation/review of `arch-update` that [Cardiac](https://github.com/Cardiacman13) and I made on [his YouTube channel](https://www.youtube.com/@Cardiacman) (**videos there, including this one, are in french**): + +*Warning: Arch-Update's features and default behavior may have changed/evolved since then!* + +[![youtube_presentation](https://github.com/Antiz96/arch-update/assets/53110319/23af5180-1881-486d-bd5a-3edd48ed1a08)](https://www.youtube.com/watch?v=QkOkX70SEmo) + +### The .desktop file + +The .desktop file is located in `/usr/share/applications/arch-update.desktop` (or `/usr/local/share/applications/arch-update.desktop` if you installed `arch-update` [from source](#from-source)). +Its icon will automatically change depending on the different states (checking for updates, updates available, installing updates, up to date). +It will launch the relevant series of functions to perform a complete and proper update when clicked (see the [Documentation](#documentation) chapter). It is easy to integrate with any DE/WM, dock, status/launch bar or app menu. + +### The systemd timer + +There is a systemd service in `/usr/lib/systemd/user/arch-update.service` (or in `/usr/local/lib/systemd/user/arch-update.service` if you installed `arch-update` [from source](#from-source)) that executes the `check` function when started (see the [Documentation](#documentation) chapter). +To start it automatically **at boot and then once every hour**, enable the associated systemd timer (you can modify the auto-check cycle to your liking, see the [Tips and tricks - Modify the auto-check cycle](#modify-the-auto-check-cycle) chapter): + +```bash +systemctl --user enable --now arch-update.timer +``` + +### Screenshot + +Personally, I integrated the .desktop icon in my top bar. +It is the first icon from the left. + +![icon](https://github.com/Antiz96/arch-update/assets/53110319/25f3d2ca-b9d3-4a32-ace3-b0fa785662c2) + +When `arch-update` is checking for updates, the icon changes accordingly (the `check` function is automatically triggered at boot and then once every hour if you enabled the [systemd timer](#the-systemd-timer) and can be manually triggered by running the `arch-update -c` command): + +![icon-checking](https://github.com/Antiz96/arch-update/assets/53110319/f4c09898-7b21-430f-84be-431a31e25c3f) + +If there are new available updates, the icon will show a bell sign and a desktop notification indicating the number of available updates will be sent (requires [libnotify/notify-send](https://archlinux.org/packages/extra/x86_64/libnotify/ "libnotify package")): + +![icon-update-available](https://github.com/Antiz96/arch-update/assets/53110319/c1526ce7-5f94-41b8-a8fa-3587b9d00a9d) +![notification](https://github.com/Antiz96/arch-update/assets/53110319/631b8e67-487a-441a-84b4-6cce95223729) + +When the icon is clicked, it launches the relevant series of functions to perform a complete and proper update starting by refreshing the list of packages available for updates, print it inside a terminal window and asks for the user's confirmation to proceed with the installation (it can also be launched by running the `arch-update` command, requires [yay](https://aur.archlinux.org/packages/yay "yay") or [paru](https://aur.archlinux.org/packages/paru "paru") for AUR packages update support and [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak/) for Flatpak packages update support): + +*The colored output can be disabled with the `NoColor` option in the `arch-update.conf` configuration file.* +*The versions changes in the packages listing can be hidden with the `NoVersion` option in the `arch-update.conf` configuration file.* +*See the [arch-update.conf documentation chapter](#arch-update-configuration-file) for more details.* + +![listing-packages](https://github.com/Antiz96/arch-update/assets/53110319/43a990c8-ed93-420f-8c46-d50d60bff03f) + +Once you gave the confirmation to proceed, `arch-update` offers to print latest Arch Linux news. +Arch news that have been published within the last 15 days are tagged as `[NEW]`. +Select which news to read by typing its associated number. +After your read a news, `arch-update` will once again offers to print latest Arch Linux news, so you can read multiple news at once. +Simply press "enter" without typing any number to proceed with update: + +*The Arch news listing/printing can be skipped with the `NoNews` option in the `arch-update.conf` configuration file.* +*Note that using this option will generate a warning message as a reminder that users are expected to regularly check Arch news.* +*See the [arch-update.conf documentation chapter](#arch-update-configuration-file) for more details.* + +![list-news](https://github.com/Antiz96/arch-update/assets/53110319/b6883ec4-8c44-4b97-86d9-4d0a304b748b) + +While `arch-update` is performing updates, the icon changes accordingly: + +![icon-installing](https://github.com/Antiz96/arch-update/assets/53110319/7c74ce84-7de4-4e09-aa2a-66afad9e61d7) + +When the update is over, the icon changes accordingly: + +![icon-up-to-date](https://github.com/Antiz96/arch-update/assets/53110319/03f224a5-5fcf-450d-9aa5-bae90e7d2e8a) + +`arch-update` will then search for orphan packages/unused Flatpak packages and offers to remove them (if there are): + +![orphan-packages](https://github.com/Antiz96/arch-update/assets/53110319/76b795e5-076e-4070-9fe2-73165503011b) + +![flatpak-unused-packages](https://github.com/Antiz96/arch-update/assets/53110319/cd4053bb-623e-44c2-8c74-9f87710f4074) + +`arch-update` will also search for old and/or uninstalled cached packages and offers to remove them (if there are): + +*The default behavior is to keep the last 3 cached versions of installed packages and remove every cached versions of uninstalled packages.* +*You can modify the number of old packages' versions and uninstalled packages' versions to keep in pacman's cache respectively with the `KeepOldPackages=Num` and `KeepUninstalledPackages=Num` options in the `arch-update.conf` configuration file.* +*See the [arch-update.conf documentation chapter](#arch-update-configuration-file) for more details.* + +![cached-packages](https://github.com/Antiz96/arch-update/assets/53110319/7199bbf1-acd8-49a1-80eb-e9874b94fba6) + +Additionally `arch-update` will search for pacnew/pacsave files and offers to process them via `pacdiff` (if there are): + +![pacnew-files](https://github.com/Antiz96/arch-update/assets/53110319/5ee627ee-f7b7-4528-bf41-435d3c5892ac) + +Finally, `arch-update` will check if there's a pending kernel update requiring a reboot to be applied and offers you to do so (if there is): + +![kernel-pending-update](https://github.com/Antiz96/arch-update/assets/53110319/14aef5b2-db32-4296-8a60-bc840c09d457) + +## Documentation + +### arch-update + +```text +An update notifier/applier for Arch Linux that assists you with +important pre/post update tasks. + +Run arch-update to perform the main "update" function: +Print the list of packages available for update, then ask for the user's confirmation +to proceed with the installation. +Before performing the update, offer to print the latest Arch Linux news. +Post update, check for orphan/unused packages, old cached packages, pacnew/pacsave files +and pending kernel update and, if there are, offers to process them. + +Options: +-c, --check Check for available updates, send a desktop notification containing the number of available updates (if libnotify is installed) +-h, --help Display this message and exit +-V, --version Display version information and exit + +Exit Codes: +0 OK +1 Invalid option +2 No privilege method (sudo or doas) is installed +3 Error when changing icon +4 User didn't gave the confirmation to proceed +5 Error when updating the packages +6 Error when calling the reboot command to apply a pending kernel update +``` + +For more information, see the arch-update(1) man page. +Certain options can be enabled/disabled or modified via the arch-update.conf configuration file, see the arch-update.conf(5) man page. + +### arch-update configuration file + +```text +The arch-update.conf file is an optional configuration file for arch-update to enable/disable +or modify certain options within the script. + +This configuration file has to be located in "${XDG_CONFIG_HOME}/arch-update/arch-update.conf" +or "${HOME}/.config/arch-update/arch-update.conf". + +The supported options are: + +- NoColor # Do not colorize output. +- NoVersion # Do not show versions changes for packages when listing pending updates. +- NoNews # Do not print Arch news. Note that using this option will generate a warning message as a reminder that users are expected to regularly check Arch news. +- KeepOldPackages=Num # Number of old packages' versions to keep in pacman's cache. Defaults to 3. +- KeepUninstalledPackages=Num # Number of uninstalled packages' versions to keep in pacman's cache. Defaults to 0. + +Options are case sensitive, so capital letters have to be respected. +``` + +For more information, see the arch-update(5) man page. + +## Tips and tricks + +### AUR Support + +Arch-Update supports AUR packages update when checking and installing updates if **yay** or **paru** is installed: +See and +See and + +### Flatpak Support + +Arch-Update supports Flatpak packages update when checking and installing updates (as well as removing unused Flatpak packages) if **flatpak** is installed: +See and + +### Desktop notifications Support + +Arch-Update supports desktop notifications when performing the `--check` function if **libnotify (notify-send)** is installed: +See + +### Modify the auto-check cycle + +If you enabled the [systemd.timer](#the-systemd-timer), the `--check` option is automatically launched at boot and then once per hour. + +If you want to change the check cycle, run `systemctl --user edit arch-update.timer` to create an override configuration for the timer and input the following in it: + +```text +[Timer] +OnUnitActiveSec=10m +``` + +Time units are `s` for seconds, `m` for minutes, `h` for hours, `d` for days... +See for more details. + +## Contributing + +You can raise your issues, feedbacks and suggestions in the [issues tab](https://github.com/Antiz96/arch-update/issues). +[Pull requests](https://github.com/Antiz96/arch-update/pulls) are welcomed as well! From 91742abf507d933b0f6917f32eee0a0a4549423a Mon Sep 17 00:00:00 2001 From: Robin Candau Date: Wed, 10 Jan 2024 15:51:30 +0100 Subject: [PATCH 4/9] exclude the README-fr.md file from the english spellchecking test --- .github/workflows/CI.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/CI.yml b/.github/workflows/CI.yml index 66b5880..e772eac 100644 --- a/.github/workflows/CI.yml +++ b/.github/workflows/CI.yml @@ -15,7 +15,7 @@ jobs: run: actionlint -ignore 'label "CI-CD" is unknown' .github/workflows/CI.yml - name: Run codespell - run: codespell --enable-colors + run: codespell --exclude-file=README-fr.md --enable-colors - name: Run mdl run: mdl --style .github/workflows/mdl_style.rb . From 07dca5c64b076e68f3e4d035e3457236872b0dcc Mon Sep 17 00:00:00 2001 From: Robin Candau <53110319+Antiz96@users.noreply.github.com> Date: Wed, 17 Jan 2024 20:18:17 +0100 Subject: [PATCH 5/9] Corrections from the first review --- README-fr.md | 207 ++++++++++++++++++++++++++------------------------- 1 file changed, 104 insertions(+), 103 deletions(-) diff --git a/README-fr.md b/README-fr.md index bd1486a..8d8a6b8 100644 --- a/README-fr.md +++ b/README-fr.md @@ -1,4 +1,4 @@ -# Arch-Mise à jour +# Arch-Update ## Table des matières @@ -11,30 +11,30 @@ ## Description -Un notificateur/applicateur de mises à jour pour Arch Linux qui vous aide dans les tâches importantes de pré/post-mise à jour et qui comprend une icône cliquable (.desktop) qui peut facilement être intégrée à n'importe quel Environnement de Bureau/Manager de fenêtres, dock, barre d'état/lancement ou menu d'application. -Prise en charge facultative des mises à jour des packages AUR/Flatpak et des notifications sur le bureau. +Un notificateur/applicateur de mises à jour pour Arch Linux qui vous assiste dans les tâches importantes d'avant/après mise à jour et qui inclut une icône cliquable (.desktop) qui peut facilement être intégrée à n'importe quel environnement de bureau/gestionnaire de fenêtres, dock, barre d'état, barre de lancement ou menu d'application. +Prise en charge optionnelle des mises à jour des paquets AUR/Flatpak et des notifications de bureau. -Caractéristiques: +Fonctionnalités : - Inclut une icône cliquable (.desktop) qui change automatiquement pour agir comme un notificateur/applicateur de mise à jour. Facile à intégrer avec n'importe quel DE/WM, dock, barre d'état/lancement, menu d'application, etc... -- Vérification et liste automatiques de tous les packages disponibles pour la mise à jour (via [checkupdates](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package")). -- Propose d'imprimer les dernières nouvelles d'Arch Linux avant d'appliquer les mises à jour (via [curl](https://archlinux.org/packages/core/x86_64/curl/ "curl package") et [htmlq] (https://archlinux. org/packages/extra/x86_64/htmlq/ "package htmlq")). -- Vérification et listage automatique des packages orphelins et vous proposant de les supprimer. -- Vérification automatique des paquets anciens et/ou désinstallés dans le cache de `pacman` et vous proposant de les supprimer (via [paccache](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman -paquet de contribution")). -- Vous aide à traiter les fichiers pacnew/pacsave (via [pacdiff](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package"), nécessite éventuellement [vim](https:// archlinux.org/packages/extra/x86_64/vim/ "vim package") comme [programme de fusion] par défaut (https://wiki.archlinux.org/title/Pacman/Pacnew_and_Pacsave#pacdiff "programme de fusion pacdiff")). -- Vérification automatique des mises à jour du noyau en attente nécessitant un redémarrage et propose de le faire s'il y en a un. -- Prise en charge de [sudo](https://archlinux.org/packages/core/x86_64/sudo/ "sudo package") et de [doas](https://archlinux.org/packages/extra/x86_64/opendoas/ "paquet opendoas"). -- Prise en charge facultative de la mise à jour des packages AUR (via [yay](https://aur.archlinux.org/packages/yay "yay AUR package") ou [paru](https://aur.archlinux.org/packages/paru "paquet paru AUR")). -- Prise en charge facultative de la mise à jour des packages Flatpak (via [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak "Package Flatpak")). -- Prise en charge facultative des notifications de bureau (via [libnotify](https://archlinux.org/packages/extra/x86_64/libnotify "libnotify package"), voir ) . - -##Installation +- Vérification et listing automatiques de tous les paquets disponibles pour la mise à jour (via [checkupdates](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package")). +- Propose d'afficher les news récentes d'Arch Linux avant d'appliquer les mises à jour (via [curl](https://archlinux.org/packages/core/x86_64/curl/ "curl package") et [htmlq] (https://archlinux. org/packages/extra/x86_64/htmlq/ "package htmlq")). +- Vérification et listing automatiques des paquets orphelins et vous propose de les supprimer. +- Vérification automatique des anciens paquets et/ou paquets désinstallés dans le cache de `pacman` et vous propose de les supprimer (via [paccache](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "package pacman-contrib")). +- Vous aide à traiter les fichiers pacnew/pacsave (via [pacdiff](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package"), nécessite optionnellement [vim](https:// archlinux.org/packages/extra/x86_64/vim/ "vim package") comme [programme de fusion par défaut](https://wiki.archlinux.org/title/Pacman/Pacnew_and_Pacsave#pacdiff "programme de fusion pacdiff")). +- Vérification automatique des mises à jour du noyau en attente nécessitant un redémarrage et propose de redémarrer s'il y en a une. +- Fonctionne avec [sudo](https://archlinux.org/packages/core/x86_64/sudo/ "sudo package") et [doas](https://archlinux.org/packages/extra/x86_64/opendoas/ "opendoas package"). +- Prise en charge optionnelle de la mise à jour des paquets AUR (via [yay](https://aur.archlinux.org/packages/yay "yay AUR package") ou [paru](https://aur.archlinux.org/packages/paru "paru AUR package")). +- Prise en charge optionnelle de la mise à jour des paquets Flatpak (via [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak "Flatpak Package")). +- Prise en charge optionnelle des notifications de bureau (via [libnotify](https://archlinux.org/packages/extra/x86_64/libnotify "libnotify package"), voir ) . + +## Installation ### AUR -Installez le package AUR [arch-update](https://aur.archlinux.org/packages/arch-update "arch-update AUR package"). +Installez le paquet AUR [arch-update](https://aur.archlinux.org/packages/arch-update "arch-update AUR package"). -### Depuis les fichiers sources +### Depuis la source Installer les dépendances : @@ -53,137 +53,137 @@ sudo make install Pour désinstaller `arch-update`, allez dans le répertoire extrait/cloné et exécutez la commande suivante : ```bash -sudo make désinstaller +sudo make uninstall ``` ## Utilisation -L'utilisation consiste à intégrer [le fichier .desktop](#the-desktop-file) n'importe où (cela peut être votre bureau, votre dock, votre barre d'état/de lancement et/ou le menu de votre application) et à activer le [timer systemd](# le-systemd-timer). +L'utilisation consiste à intégrer [le fichier .desktop](#le-fichier-desktop) n'importe où (cela peut être votre bureau, votre dock, votre barre d'état/de lancement ou votre menu d'application) et à activer le [timer systemd](#le-timer-systemd). -Voici une petite présentation/revue YouTube de `arch-update` que [Cardiac](https://github.com/Cardiacman13) et moi avons réalisée sur [sa chaîne YouTube](https://www.youtube.com/@ Cardiacman) (**les vidéos là-bas, dont celle-ci, sont en français**) : +Voici une petite présentation/revue YouTube de `arch-update` que [Cardiac](https://github.com/Cardiacman13) et moi-même avons réalisée sur [sa chaîne YouTube](https://www.youtube.com/@Cardiacman) : *Attention : les fonctionnalités et le comportement par défaut d'Arch-Update peuvent avoir changé/évolué depuis !* -[![youtube_presentation](https://github.com/Antiz96/arch-update/assets/53110319/23af5180-1881-486d-bd5a-3edd48ed1a08)](https://www.youtube.com/watch?v= QkOkX70SEmo) +[![youtube_presentation](https://github.com/Antiz96/arch-update/assets/53110319/23af5180-1881-486d-bd5a-3edd48ed1a08)](https://www.youtube.com/watch?v=QkOkX70SEmo) ### Le fichier .desktop -Le fichier .desktop se trouve dans `/usr/share/applications/arch-update.desktop` (ou `/usr/local/share/applications/arch-update.desktop` si vous avez installé `arch-update` [à partir des sources ](#from-source)). -Son icône changera automatiquement en fonction des différents états (vérification des mises à jour, mises à jour disponibles, installation des mises à jour, à jour). -Il lancera la série de fonctions pertinentes pour effectuer une mise à jour complète et appropriée lorsque vous cliquez dessus (voir le chapitre [Documentation](#documentation)). Il est facile à intégrer à n’importe quel DE/WM, dock, barre d’état/lancement ou menu d’application. +Le fichier .desktop se trouve dans `/usr/share/applications/arch-update.desktop` (ou `/usr/local/share/applications/arch-update.desktop` si vous avez installé `arch-update` [depuis la source](#depuis-la-source)). +Son icône changera automatiquement en fonction des différents états (vérification des mises à jour, mises à jour disponibles, installation des mises à jour, à jour). +Il lancera la série de fonctions adéquates pour effectuer une mise à jour complète et correcte lorsque vous cliquez dessus (voir le chapitre [Documentation](#documentation)). Il est facile à intégrer à n’importe quel DE/WM, dock, barre d’état/lancement ou menu d’application. -### Le minuteur système +### Le timer systemd -Il existe un service systemd dans `/usr/lib/systemd/user/arch-update.service` (ou dans `/usr/local/lib/systemd/user/arch-update.service` si vous avez installé `arch-update ` [from source](#from-source)) qui exécute la fonction `check` au démarrage (voir le chapitre [Documentation](#documentation)). -Pour le démarrer automatiquement **au démarrage puis une fois toutes les heures**, activez le timer systemd associé (vous pouvez modifier le cycle de vérification automatique à votre guise, voir les [Trucs et astuces - Modifier le cycle de vérification automatique](# chapitre modifier le cycle de vérification automatique) : +Il existe un service systemd dans `/usr/lib/systemd/user/arch-update.service` (ou dans `/usr/local/lib/systemd/user/arch-update.service` si vous avez installé `arch-update` [depuis la source](#depuis-la-source)) qui exécute la fonction `check` quand il est démarré (voir le chapitre [Documentation](#documentation)). +Pour le démarrer automatiquement **au démarrage du système puis une fois toutes les heures**, activez le timer systemd associé (vous pouvez modifier le cycle de vérification automatique à votre guise, voir les [Trucs et astuces - Modifier le cycle de vérification automatique](#modifier-le-cycle-de-verification-automatique) : ```bash -systemctl --user activer --now arch-update.timer +systemctl --user enable --now arch-update.timer ``` ### Capture d'écran -Personnellement, j'ai intégré l'icône .desktop dans ma barre supérieure. +Personnellement, j'ai intégré l'icône .desktop dans ma barre supérieure. C'est la première icône en partant de la gauche. -![icône](https://github.com/Antiz96/arch-update/assets/53110319/25f3d2ca-b9d3-4a32-ace3-b0fa785662c2) +![icon](https://github.com/Antiz96/arch-update/assets/53110319/25f3d2ca-b9d3-4a32-ace3-b0fa785662c2) -Lorsque `arch-update` vérifie les mises à jour, l'icône change en conséquence (la fonction `check` est automatiquement déclenchée au démarrage puis une fois toutes les heures si vous avez activé le [systemd timer](#the-systemd-timer) et peut être déclenché manuellement en exécutant la commande `arch-update -c`) : +Lorsque `arch-update` vérifie les mises à jour, l'icône change en conséquence (la fonction `check` est automatiquement déclenchée au démarrage du système puis une fois toutes les heures si vous avez activé le [timer systemd](#le-timer-systemd) et peut être déclenchée manuellement en exécutant la commande `arch-update -c`) : -![vérification des icônes](https://github.com/Antiz96/arch-update/assets/53110319/f4c09898-7b21-430f-84be-431a31e25c3f) +![icon-checking](https://github.com/Antiz96/arch-update/assets/53110319/f4c09898-7b21-430f-84be-431a31e25c3f) -Si de nouvelles mises à jour sont disponibles, l'icône affichera une cloche et une notification sur le bureau indiquant le nombre de mises à jour disponibles sera envoyée (nécessite [libnotify/notify-send](https://archlinux.org/packages/extra/x86_64 /libnotify/ "paquet libnotify")) : +Si de nouvelles mises à jour sont disponibles, l'icône affichera une cloche et une notification de bureau indiquant le nombre de mises à jour disponibles sera envoyée (nécessite [libnotify/notify-send](https://archlinux.org/packages/extra/x86_64/libnotify/ "paquet libnotify")) : -![icône-mise à jour-disponible](https://github.com/Antiz96/arch-update/assets/53110319/c1526ce7-5f94-41b8-a8fa-3587b9d00a9d) +![icon-update-available](https://github.com/Antiz96/arch-update/assets/53110319/c1526ce7-5f94-41b8-a8fa-3587b9d00a9d) ![notification](https://github.com/Antiz96/arch-update/assets/53110319/631b8e67-487a-441a-84b4-6cce95223729) -Lorsque l'on clique sur l'icône, elle lance la série de fonctions correspondantes pour effectuer une mise à jour complète et appropriée, en commençant par actualiser la liste des packages disponibles pour les mises à jour, en l'imprimant dans une fenêtre de terminal et en demandant la confirmation de l'utilisateur pour procéder à l'installation (il peut également être lancé en exécutant la commande `arch-update`, nécessite [yay](https://aur.archlinux.org/packages/yay "yay") ou [paru](https://aur.archlinux.org /packages/paru "paru") pour la prise en charge de la mise à jour des packages AUR et [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak/) pour la prise en charge de la mise à jour des packages Flatpak) : +Lorsque l'on clique sur l'icône, elle lance la série de fonctions adéquates pour effectuer une mise à jour complète et correcte, en commençant par actualiser la liste des packages disponibles pour les mises à jour, en l'affichant dans un terminal et en demandant la confirmation de l'utilisateur pour procéder à l'installation (elle peut également être lancée en exécutant la commande `arch-update`, nécessite [yay](https://aur.archlinux.org/packages/yay "yay") ou [paru](https://aur.archlinux.org/packages/paru "paru") pour la prise en charge de la mise à jour des paquets AUR et [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak/) pour la prise en charge de la mise à jour des paquets Flatpak) : -*La sortie colorée peut être désactivée avec l'option `NoColor` dans le fichier de configuration `arch-update.conf`.* -*Les changements de versions dans la liste des packages peuvent être masqués avec l'option `NoVersion` dans le fichier de configuration `arch-update.conf`.* -*Voir le [chapitre de documentation arch-update.conf](#arch-update-configuration-file) pour plus de détails.* +*La sortie colorée peut être désactivée avec l'option `NoColor` dans le fichier de configuration `arch-update.conf`.* +*Les changements de versions dans la listing des paquets peuvent être masqués avec l'option `NoVersion` dans le fichier de configuration `arch-update.conf`.* +*Voir le [chapitre de documentation arch-update.conf](#fichier-de-configuration-arch-update) pour plus de détails.* ![listing-packages](https://github.com/Antiz96/arch-update/assets/53110319/43a990c8-ed93-420f-8c46-d50d60bff03f) -Une fois que vous avez donné la confirmation pour continuer, `arch-update` propose d'imprimer les dernières nouvelles d'Arch Linux. -Les actualités arch publiées au cours des 15 derniers jours sont étiquetées comme « [NOUVEAU] ». -Sélectionnez les actualités à lire en tapant son numéro associé. -Après avoir lu une actualité, « arch-update » vous proposera à nouveau d'imprimer les dernières actualités Arch Linux, afin que vous puissiez lire plusieurs actualités à la fois. +Une fois que vous avez donné la confirmation pour procéder, `arch-update` propose d'afficher les dernières Arch news. +Les Arch news publiées au cours des 15 derniers jours sont étiquetées comme « [NEW] ». +Sélectionnez la news à lire en tapant le numéro associé. +Après avoir lu une news, `arch-update` vous proposera à nouveau d'afficher les dernières Arch news, afin que vous puissiez lire plusieurs news à la fois. Appuyez simplement sur « Entrée » sans saisir de chiffre pour procéder à la mise à jour : -*La liste/impression des actualités Arch peut être ignorée avec l'option `NoNews` dans le fichier de configuration `arch-update.conf`.* -*Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les actualités d'Arch.* -*Voir le [chapitre de documentation arch-update.conf](#arch-update-configuration-file) pour plus de détails.* +*Le listing/affichage des Arch news peut être ignoré avec l'option `NoNews` dans le fichier de configuration `arch-update.conf`.* +*Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les Arch news.* +*Voir le [chapitre de documentation arch-update.conf](#fichier-de-configuration-arch-update) pour plus de détails.* -![liste-nouvelles](https://github.com/Antiz96/arch-update/assets/53110319/b6883ec4-8c44-4b97-86d9-4d0a304b748b) +![list-news](https://github.com/Antiz96/arch-update/assets/53110319/b6883ec4-8c44-4b97-86d9-4d0a304b748b) Pendant que `arch-update` effectue des mises à jour, l'icône change en conséquence : -![installation d'icônes](https://github.com/Antiz96/arch-update/assets/53110319/7c74ce84-7de4-4e09-aa2a-66afad9e61d7) +![icon-installing](https://github.com/Antiz96/arch-update/assets/53110319/7c74ce84-7de4-4e09-aa2a-66afad9e61d7) Une fois la mise à jour terminée, l'icône change en conséquence : -![icône-à-date](https://github.com/Antiz96/arch-update/assets/53110319/03f224a5-5fcf-450d-9aa5-bae90e7d2e8a) +![icon-up-to-date](https://github.com/Antiz96/arch-update/assets/53110319/03f224a5-5fcf-450d-9aa5-bae90e7d2e8a) -`arch-update` recherchera ensuite les packages orphelins/packages Flatpak inutilisés et proposera de les supprimer (s'il y en a) : +`arch-update` recherchera ensuite les paquets orphelins/paquets Flatpak inutilisés et proposera de les supprimer (s'il y en a) : ![paquets-orphelins](https://github.com/Antiz96/arch-update/assets/53110319/76b795e5-076e-4070-9fe2-73165503011b) ![flatpak-unused-packages](https://github.com/Antiz96/arch-update/assets/53110319/cd4053bb-623e-44c2-8c74-9f87710f4074) -`arch-update` recherchera également les packages mis en cache anciens et/ou désinstallés et proposera de les supprimer (le cas échéant) : +`arch-update` recherchera également les anciens paquets et/ou paquets désinstallés mis en cache et proposera de les supprimer (s'il y en a) : -*Le comportement par défaut consiste à conserver les 3 dernières versions en cache des packages installés et à supprimer toutes les versions en cache des packages désinstallés.* -*Vous pouvez modifier le nombre d'anciennes versions de packages et de versions de packages désinstallés à conserver respectivement dans le cache de pacman avec les options `KeepOldPackages=Num` et `KeepUninstalledPackages=Num` dans le fichier de configuration `arch-update.conf`.* -*Voir le [chapitre de documentation arch-update.conf](#arch-update-configuration-file) pour plus de détails.* +*Le comportement par défaut consiste à conserver les 3 dernières versions en cache des paquets installés et à supprimer toutes les versions en cache des paquets désinstallés.* +*Vous pouvez modifier le nombre d'anciennes versions de paquets et de versions de paquets désinstallés à conserver respectivement dans le cache de pacman avec les options `KeepOldPackages=Num` et `KeepUninstalledPackages=Num` dans le fichier de configuration `arch-update.conf`.* +*Voir le [chapitre de documentation arch-update.conf](#fichier-de-configuration-arch-update) pour plus de détails.* -![paquets-cachés](https://github.com/Antiz96/arch-update/assets/53110319/7199bbf1-acd8-49a1-80eb-e9874b94fba6) +![cached-packages](https://github.com/Antiz96/arch-update/assets/53110319/7199bbf1-acd8-49a1-80eb-e9874b94fba6) De plus, `arch-update` recherchera les fichiers pacnew/pacsave et proposera de les traiter via `pacdiff` (s'il y en a) : ![pacnew-files](https://github.com/Antiz96/arch-update/assets/53110319/5ee627ee-f7b7-4528-bf41-435d3c5892ac) -Enfin, `arch-update` vérifiera s'il y a une mise à jour du noyau en attente nécessitant un redémarrage et vous proposera de le faire (s'il y en a) : +Enfin, `arch-update` vérifiera s'il y a une mise à jour du noyau en attente nécessitant un redémarrage et vous proposera de le faire (s'il y en a une) : -![kernel-ending-update](https://github.com/Antiz96/arch-update/assets/53110319/14aef5b2-db32-4296-8a60-bc840c09d457) +![kernel-pending-update](https://github.com/Antiz96/arch-update/assets/53110319/14aef5b2-db32-4296-8a60-bc840c09d457) ## Documentation -### arch-mise à jour +### arch-update -```texte -Un notificateur/applicateur de mises à jour pour Arch Linux qui vous aide à -tâches importantes avant/après la mise à jour. +```text +Un notificateur/applicateur de mises à jour pour Arch Linux qui vous assiste dans les +tâches importantes d'avant/après mise à jour. -Exécutez arch-update pour exécuter la fonction principale « mettre à jour » : -Imprimez la liste des packages disponibles en mise à jour, puis demandez la confirmation de l'utilisateur +Lancez arch-update pour exécuter la fonction principale « update » : +Afficher la liste des paquets disponibles pour mise à jour, puis demandez la confirmation de l'utilisateur pour procéder à l'installation. -Avant d'effectuer la mise à jour, proposez d'imprimer les dernières actualités d'Arch Linux. -Publier la mise à jour, vérifier les packages orphelins/inutilisés, les anciens packages mis en cache, les fichiers pacnew/pacsave -et en attente de mises à jour du noyau et, le cas échéant, propose de les traiter. +Avant d'effectuer la mise à jour, propose d'afficher les dernières Arch news. +Après la mise à jour, vérification de la présence de paquets orphelins/inutilisés, d'anciens paquets mis en cache, de fichiers pacnew/pacsave +et de mise à jour du noyau en attente et, s'il y en a, propose de les traiter. -Possibilités : --c, --check Vérifier les mises à jour disponibles, envoyer une notification sur le bureau contenant le nombre de mises à jour disponibles (si libnotify est installé) --h, --help Afficher ce message et quitter --V, --version Afficher les informations de version et quitter +Options : +-c, --check Vérifier les mises à jour disponibles, envoyer une notification de bureau contenant le nombre de mises à jour disponibles (si libnotify est installé) +-h, --help Afficher ce message et quitter +-V, --version Afficher les informations de version et quitter Codes de sortie : -0 bien -1 option invalide -2 Aucune méthode de privilège (sudo ou doas) n'est installée -3 Erreur lors du changement d'icône -4 L'utilisateur n'a pas donné la confirmation pour continuer -5 Erreur lors de la mise à jour des packages -6 Erreur lors de l'appel de la commande reboot pour appliquer une mise à jour du noyau en attente +0 OK +1 Option invalide +2 Aucune méthode d'élévation de privilège (sudo ou doas) n'est installée +3 Erreur lors du changement d'icône +4 L'utilisateur n'a pas donné la confirmation de procéder +5 Erreur lors de la mise à jour des paquets +6 Erreur lors de l'appel de la commande reboot pour appliquer une mise à jour du noyau en attente ``` -Pour plus d'informations, consultez la page de manuel arch-update(1). +Pour plus d'informations, consultez la page de manuel arch-update(1). Certaines options peuvent être activées/désactivées ou modifiées via le fichier de configuration arch-update.conf, voir la page de manuel arch-update.conf(5). -### fichier de configuration de la mise à jour arch +### fichier de configuration arch-update -```texte -Le fichier arch-update.conf est un fichier de configuration facultatif permettant à arch-update d'activer/désactiver +```text +Le fichier arch-update.conf est un fichier de configuration facultatif pour arch-update permettant d'activer/désactiver ou modifier certaines options dans le script. Ce fichier de configuration doit se trouver dans "${XDG_CONFIG_HOME}/arch-update/arch-update.conf" @@ -191,11 +191,11 @@ ou "${HOME}/.config/arch-update/arch-update.conf". Les options prises en charge sont : -- NoColor # Ne colorise pas la sortie. -- NoVersion # N'affiche pas les modifications de versions des packages lors de la liste des mises à jour en attente. -- NoNews # N'imprime pas les nouvelles d'Arch. Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les actualités d'Arch. -- KeepOldPackages=Num # Nombre d'anciennes versions de packages à conserver dans le cache de pacman. La valeur par défaut est 3. -- KeepUninstalledPackages=Num # Nombre de versions de packages désinstallés à conserver dans le cache de pacman. La valeur par défaut est 0. +- NoColor # Ne pas coloriser la sortie. +- NoVersion # Ne pas afficher les modifications de versions des paquets lors du listing des mises à jour en attente. +- NoNews # Ne pas afficher les Arch news. Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les Arch news. +- KeepOldPackages=Num # Nombre d'anciennes versions de paquets à conserver dans le cache de pacman. La valeur par défaut est 3. +- KeepUninstalledPackages=Num # Nombre de versions de paquets désinstallés à conserver dans le cache de pacman. La valeur par défaut est 0. Les options sont sensibles à la casse, les majuscules doivent donc être respectées. ``` @@ -204,37 +204,38 @@ Pour plus d'informations, consultez la page de manuel arch-update(5). ## Trucs et astuces -### Prise en charge AUR +### Prise en charge du AUR -Arch-Update prend en charge la mise à jour des packages AUR lors de la vérification et de l'installation des mises à jour si **yay** ou **paru** est installé : -Voir et +Arch-Update prend en charge la mise à jour des paquets AUR lors de la vérification et de l'installation des mises à jour si **yay** ou **paru** est installé : +Voir et Voir et -### Prise en charge des Flatpaks +### Prise en charge de Flatpak -Arch-Update prend en charge la mise à jour des packages Flatpak lors de la vérification et de l'installation des mises à jour (ainsi que de la suppression des packages Flatpak inutilisés) si **flatpak** est installé : +Arch-Update prend en charge la mise à jour des paquets Flatpak lors de la vérification et de l'installation des mises à jour (ainsi que de la suppression des packages Flatpak inutilisés) si **flatpak** est installé : Voir et -### Notifications sur le bureau +### Notifications de bureau -Arch-Update prend en charge les notifications du bureau lors de l'exécution de la fonction `--check` si **libnotify (notify-send)** est installé : +Arch-Update prend en charge les notifications de bureau lors de l'exécution de la fonction `--check` si **libnotify (notify-send)** est installé : Voir ### Modifier le cycle de vérification automatique -Si vous avez activé le [systemd.timer](#the-systemd-timer), l'option `--check` est automatiquement lancée au démarrage puis une fois par heure. +Si vous avez activé le [timer systemd](#le-timer-systemd), l'option `--check` est automatiquement lancée au démarrage du système puis une fois par heure. -Si vous souhaitez modifier le cycle de vérification, exécutez `systemctl --user edit arch-update.timer` pour créer une configuration de remplacement pour la minuterie et saisissez ce qui suit : +Si vous souhaitez modifier le cycle de vérification, exécutez `systemctl --user edit arch-update.timer` pour créer une configuration de remplacement pour le timer et saisissez ce qui suit : -```texte -[Minuteur] -OnUnitActiveSec = 10 min +```text +[Timer] +OnUnitActiveSec= +OnUnitActiveSec=10m ``` -Les unités de temps sont « s » pour les secondes, « m » pour les minutes, « h » pour les heures, « d » pour les jours... -Voir pour plus de détails. +Les unités de temps sont `s` pour les secondes, `m` pour les minutes, `h` pour les heures, `d` pour les jours... +Voir pour plus de détails. -## Contribuant +## Contribuer -Vous pouvez soulever vos problèmes, commentaires et suggestions dans l'onglet [Issues](https://github.com/Antiz96/arch-update/issues). -Les [Pull request](https://github.com/Antiz96/arch-update/pulls) sont également les bienvenues ! +Vous pouvez soulever vos problèmes, commentaires et suggestions dans l'onglet [Issues](https://github.com/Antiz96/arch-update/issues). +Les [Pull requests](https://github.com/Antiz96/arch-update/pulls) sont également les bienvenues ! From 89e1069427aee2f916ae530e81c44f28fba4925e Mon Sep 17 00:00:00 2001 From: Robin Candau <53110319+Antiz96@users.noreply.github.com> Date: Wed, 17 Jan 2024 20:23:15 +0100 Subject: [PATCH 6/9] Remove wrong space --- README-fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README-fr.md b/README-fr.md index 8d8a6b8..8a039e3 100644 --- a/README-fr.md +++ b/README-fr.md @@ -18,7 +18,7 @@ Fonctionnalités : - Inclut une icône cliquable (.desktop) qui change automatiquement pour agir comme un notificateur/applicateur de mise à jour. Facile à intégrer avec n'importe quel DE/WM, dock, barre d'état/lancement, menu d'application, etc... - Vérification et listing automatiques de tous les paquets disponibles pour la mise à jour (via [checkupdates](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package")). -- Propose d'afficher les news récentes d'Arch Linux avant d'appliquer les mises à jour (via [curl](https://archlinux.org/packages/core/x86_64/curl/ "curl package") et [htmlq] (https://archlinux. org/packages/extra/x86_64/htmlq/ "package htmlq")). +- Propose d'afficher les news récentes d'Arch Linux avant d'appliquer les mises à jour (via [curl](https://archlinux.org/packages/core/x86_64/curl/ "curl package") et [htmlq] (https://archlinux.org/packages/extra/x86_64/htmlq/ "package htmlq")). - Vérification et listing automatiques des paquets orphelins et vous propose de les supprimer. - Vérification automatique des anciens paquets et/ou paquets désinstallés dans le cache de `pacman` et vous propose de les supprimer (via [paccache](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "package pacman-contrib")). - Vous aide à traiter les fichiers pacnew/pacsave (via [pacdiff](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package"), nécessite optionnellement [vim](https:// archlinux.org/packages/extra/x86_64/vim/ "vim package") comme [programme de fusion par défaut](https://wiki.archlinux.org/title/Pacman/Pacnew_and_Pacsave#pacdiff "programme de fusion pacdiff")). From d71c94bc745ea23c30a878d4f963ab8d80d58872 Mon Sep 17 00:00:00 2001 From: Robin Candau <53110319+Antiz96@users.noreply.github.com> Date: Wed, 17 Jan 2024 20:25:19 +0100 Subject: [PATCH 7/9] Remove wrong space 2 --- README-fr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README-fr.md b/README-fr.md index 8a039e3..08442b9 100644 --- a/README-fr.md +++ b/README-fr.md @@ -18,7 +18,7 @@ Fonctionnalités : - Inclut une icône cliquable (.desktop) qui change automatiquement pour agir comme un notificateur/applicateur de mise à jour. Facile à intégrer avec n'importe quel DE/WM, dock, barre d'état/lancement, menu d'application, etc... - Vérification et listing automatiques de tous les paquets disponibles pour la mise à jour (via [checkupdates](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package")). -- Propose d'afficher les news récentes d'Arch Linux avant d'appliquer les mises à jour (via [curl](https://archlinux.org/packages/core/x86_64/curl/ "curl package") et [htmlq] (https://archlinux.org/packages/extra/x86_64/htmlq/ "package htmlq")). +- Propose d'afficher les news récentes d'Arch Linux avant d'appliquer les mises à jour (via [curl](https://archlinux.org/packages/core/x86_64/curl/ "curl package") et [htmlq](https://archlinux.org/packages/extra/x86_64/htmlq/ "package htmlq")). - Vérification et listing automatiques des paquets orphelins et vous propose de les supprimer. - Vérification automatique des anciens paquets et/ou paquets désinstallés dans le cache de `pacman` et vous propose de les supprimer (via [paccache](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "package pacman-contrib")). - Vous aide à traiter les fichiers pacnew/pacsave (via [pacdiff](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package"), nécessite optionnellement [vim](https:// archlinux.org/packages/extra/x86_64/vim/ "vim package") comme [programme de fusion par défaut](https://wiki.archlinux.org/title/Pacman/Pacnew_and_Pacsave#pacdiff "programme de fusion pacdiff")). From 01ab5c11b611845342259b146a54e8819df7ffbf Mon Sep 17 00:00:00 2001 From: Robin Candau <53110319+Antiz96@users.noreply.github.com> Date: Wed, 17 Jan 2024 21:24:38 +0100 Subject: [PATCH 8/9] Corrections from the second review --- README-fr.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/README-fr.md b/README-fr.md index 08442b9..e1c0ebc 100644 --- a/README-fr.md +++ b/README-fr.md @@ -19,14 +19,14 @@ Fonctionnalités : - Inclut une icône cliquable (.desktop) qui change automatiquement pour agir comme un notificateur/applicateur de mise à jour. Facile à intégrer avec n'importe quel DE/WM, dock, barre d'état/lancement, menu d'application, etc... - Vérification et listing automatiques de tous les paquets disponibles pour la mise à jour (via [checkupdates](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package")). - Propose d'afficher les news récentes d'Arch Linux avant d'appliquer les mises à jour (via [curl](https://archlinux.org/packages/core/x86_64/curl/ "curl package") et [htmlq](https://archlinux.org/packages/extra/x86_64/htmlq/ "package htmlq")). -- Vérification et listing automatiques des paquets orphelins et vous propose de les supprimer. -- Vérification automatique des anciens paquets et/ou paquets désinstallés dans le cache de `pacman` et vous propose de les supprimer (via [paccache](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "package pacman-contrib")). -- Vous aide à traiter les fichiers pacnew/pacsave (via [pacdiff](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package"), nécessite optionnellement [vim](https:// archlinux.org/packages/extra/x86_64/vim/ "vim package") comme [programme de fusion par défaut](https://wiki.archlinux.org/title/Pacman/Pacnew_and_Pacsave#pacdiff "programme de fusion pacdiff")). +- Vérification et listing automatiques des paquets orphelins et propose de les supprimer. +- Vérification automatique de la présence d'anciens paquets et/ou paquets désinstallés dans le cache de `pacman` et propose de les supprimer (via [paccache](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "package pacman-contrib")). +- Vous aide à traiter les fichiers pacnew/pacsave (via [pacdiff](https://archlinux.org/packages/extra/x86_64/pacman-contrib/ "pacman-contrib package"), nécessite optionnellement [vim](https://archlinux.org/packages/extra/x86_64/vim/ "vim package") comme [programme de fusion par défaut](https://wiki.archlinux.org/title/Pacman/Pacnew_and_Pacsave#pacdiff "programme de fusion pacdiff")). - Vérification automatique des mises à jour du noyau en attente nécessitant un redémarrage et propose de redémarrer s'il y en a une. - Fonctionne avec [sudo](https://archlinux.org/packages/core/x86_64/sudo/ "sudo package") et [doas](https://archlinux.org/packages/extra/x86_64/opendoas/ "opendoas package"). - Prise en charge optionnelle de la mise à jour des paquets AUR (via [yay](https://aur.archlinux.org/packages/yay "yay AUR package") ou [paru](https://aur.archlinux.org/packages/paru "paru AUR package")). - Prise en charge optionnelle de la mise à jour des paquets Flatpak (via [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak "Flatpak Package")). -- Prise en charge optionnelle des notifications de bureau (via [libnotify](https://archlinux.org/packages/extra/x86_64/libnotify "libnotify package"), voir ) . +- Prise en charge optionnelle des notifications de bureau (via [libnotify](https://archlinux.org/packages/extra/x86_64/libnotify "libnotify package"), voir ). ## Installation @@ -58,7 +58,7 @@ sudo make uninstall ## Utilisation -L'utilisation consiste à intégrer [le fichier .desktop](#le-fichier-desktop) n'importe où (cela peut être votre bureau, votre dock, votre barre d'état/de lancement ou votre menu d'application) et à activer le [timer systemd](#le-timer-systemd). +L'utilisation consiste à intégrer [le fichier .desktop](#le-fichier-desktop) quelque part (cela peut être votre bureau, votre dock, votre barre d'état/de lancement ou votre menu d'application) et à activer le [timer systemd](#le-timer-systemd). Voici une petite présentation/revue YouTube de `arch-update` que [Cardiac](https://github.com/Cardiacman13) et moi-même avons réalisée sur [sa chaîne YouTube](https://www.youtube.com/@Cardiacman) : @@ -75,7 +75,7 @@ Il lancera la série de fonctions adéquates pour effectuer une mise à jour com ### Le timer systemd Il existe un service systemd dans `/usr/lib/systemd/user/arch-update.service` (ou dans `/usr/local/lib/systemd/user/arch-update.service` si vous avez installé `arch-update` [depuis la source](#depuis-la-source)) qui exécute la fonction `check` quand il est démarré (voir le chapitre [Documentation](#documentation)). -Pour le démarrer automatiquement **au démarrage du système puis une fois toutes les heures**, activez le timer systemd associé (vous pouvez modifier le cycle de vérification automatique à votre guise, voir les [Trucs et astuces - Modifier le cycle de vérification automatique](#modifier-le-cycle-de-verification-automatique) : +Pour le démarrer automatiquement **au démarrage du système puis une fois toutes les heures**, activez le timer systemd associé (vous pouvez modifier le cycle de vérification automatique à votre guise, voir les [Trucs et astuces - Modifier le cycle de vérification automatique](#modifier-le-cycle-de-vérification-automatique)) : ```bash systemctl --user enable --now arch-update.timer @@ -97,11 +97,11 @@ Si de nouvelles mises à jour sont disponibles, l'icône affichera une cloche et ![icon-update-available](https://github.com/Antiz96/arch-update/assets/53110319/c1526ce7-5f94-41b8-a8fa-3587b9d00a9d) ![notification](https://github.com/Antiz96/arch-update/assets/53110319/631b8e67-487a-441a-84b4-6cce95223729) -Lorsque l'on clique sur l'icône, elle lance la série de fonctions adéquates pour effectuer une mise à jour complète et correcte, en commençant par actualiser la liste des packages disponibles pour les mises à jour, en l'affichant dans un terminal et en demandant la confirmation de l'utilisateur pour procéder à l'installation (elle peut également être lancée en exécutant la commande `arch-update`, nécessite [yay](https://aur.archlinux.org/packages/yay "yay") ou [paru](https://aur.archlinux.org/packages/paru "paru") pour la prise en charge de la mise à jour des paquets AUR et [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak/) pour la prise en charge de la mise à jour des paquets Flatpak) : +Lorsque l'on clique sur l'icône, cela lance la série de fonctions adéquates pour effectuer une mise à jour complète et correcte, en commençant par actualiser la liste des paquets disponibles pour la mise à jour, en l'affichant dans un terminal et en demandant la confirmation de l'utilisateur pour procéder à l'installation (elle peut également être lancée en exécutant la commande `arch-update`, nécessite [yay](https://aur.archlinux.org/packages/yay "yay") ou [paru](https://aur.archlinux.org/packages/paru "paru") pour la prise en charge de la mise à jour des paquets AUR et [flatpak](https://archlinux.org/packages/extra/x86_64/flatpak/) pour la prise en charge de la mise à jour des paquets Flatpak) : *La sortie colorée peut être désactivée avec l'option `NoColor` dans le fichier de configuration `arch-update.conf`.* *Les changements de versions dans la listing des paquets peuvent être masqués avec l'option `NoVersion` dans le fichier de configuration `arch-update.conf`.* -*Voir le [chapitre de documentation arch-update.conf](#fichier-de-configuration-arch-update) pour plus de détails.* +*Voir le [chapitre de documentation arch-update.conf](#Fichier-de-configuration-arch-update) pour plus de détails.* ![listing-packages](https://github.com/Antiz96/arch-update/assets/53110319/43a990c8-ed93-420f-8c46-d50d60bff03f) @@ -113,7 +113,7 @@ Appuyez simplement sur « Entrée » sans saisir de chiffre pour procéder à *Le listing/affichage des Arch news peut être ignoré avec l'option `NoNews` dans le fichier de configuration `arch-update.conf`.* *Notez que l'utilisation de cette option générera un message d'avertissement pour rappeler que les utilisateurs sont censés consulter régulièrement les Arch news.* -*Voir le [chapitre de documentation arch-update.conf](#fichier-de-configuration-arch-update) pour plus de détails.* +*Voir le [chapitre de documentation arch-update.conf](#Fichier-de-configuration-arch-update) pour plus de détails.* ![list-news](https://github.com/Antiz96/arch-update/assets/53110319/b6883ec4-8c44-4b97-86d9-4d0a304b748b) @@ -135,7 +135,7 @@ Une fois la mise à jour terminée, l'icône change en conséquence : *Le comportement par défaut consiste à conserver les 3 dernières versions en cache des paquets installés et à supprimer toutes les versions en cache des paquets désinstallés.* *Vous pouvez modifier le nombre d'anciennes versions de paquets et de versions de paquets désinstallés à conserver respectivement dans le cache de pacman avec les options `KeepOldPackages=Num` et `KeepUninstalledPackages=Num` dans le fichier de configuration `arch-update.conf`.* -*Voir le [chapitre de documentation arch-update.conf](#fichier-de-configuration-arch-update) pour plus de détails.* +*Voir le [chapitre de documentation arch-update.conf](#Fichier-de-configuration-arch-update) pour plus de détails.* ![cached-packages](https://github.com/Antiz96/arch-update/assets/53110319/7199bbf1-acd8-49a1-80eb-e9874b94fba6) @@ -156,11 +156,11 @@ Un notificateur/applicateur de mises à jour pour Arch Linux qui vous assiste da tâches importantes d'avant/après mise à jour. Lancez arch-update pour exécuter la fonction principale « update » : -Afficher la liste des paquets disponibles pour mise à jour, puis demandez la confirmation de l'utilisateur +Afficher la liste des paquets disponibles pour mise à jour, puis demander la confirmation de l'utilisateur pour procéder à l'installation. Avant d'effectuer la mise à jour, propose d'afficher les dernières Arch news. -Après la mise à jour, vérification de la présence de paquets orphelins/inutilisés, d'anciens paquets mis en cache, de fichiers pacnew/pacsave -et de mise à jour du noyau en attente et, s'il y en a, propose de les traiter. +Après la mise à jour, vérification de la présence de paquets orphelins/inutilisés, d'anciens paquets mis en cache, +de fichiers pacnew/pacsave et de mise à jour du noyau en attente et, s'il y en a, propose de les traiter. Options : -c, --check Vérifier les mises à jour disponibles, envoyer une notification de bureau contenant le nombre de mises à jour disponibles (si libnotify est installé) @@ -180,11 +180,11 @@ Codes de sortie : Pour plus d'informations, consultez la page de manuel arch-update(1). Certaines options peuvent être activées/désactivées ou modifiées via le fichier de configuration arch-update.conf, voir la page de manuel arch-update.conf(5). -### fichier de configuration arch-update +### Fichier de configuration arch-update ```text -Le fichier arch-update.conf est un fichier de configuration facultatif pour arch-update permettant d'activer/désactiver -ou modifier certaines options dans le script. +Le fichier arch-update.conf est un fichier de configuration facultatif pour arch-update permettant +d'activer/désactiver ou modifier certaines options dans le script. Ce fichier de configuration doit se trouver dans "${XDG_CONFIG_HOME}/arch-update/arch-update.conf" ou "${HOME}/.config/arch-update/arch-update.conf". @@ -224,7 +224,7 @@ Voir Si vous avez activé le [timer systemd](#le-timer-systemd), l'option `--check` est automatiquement lancée au démarrage du système puis une fois par heure. -Si vous souhaitez modifier le cycle de vérification, exécutez `systemctl --user edit arch-update.timer` pour créer une configuration de remplacement pour le timer et saisissez ce qui suit : +Si vous souhaitez modifier le cycle de vérification, exécutez la commande `systemctl --user edit arch-update.timer` pour créer une configuration de remplacement pour le timer et saisissez ce qui suit : ```text [Timer] @@ -232,7 +232,7 @@ OnUnitActiveSec= OnUnitActiveSec=10m ``` -Les unités de temps sont `s` pour les secondes, `m` pour les minutes, `h` pour les heures, `d` pour les jours... +Les unités de temps sont `s` pour secondes, `m` pour minutes, `h` pour heures, `d` pour jours... Voir pour plus de détails. ## Contribuer From ffe340972de0022420c8bc9dae3f0bf5c2c889e0 Mon Sep 17 00:00:00 2001 From: Robin Candau Date: Wed, 17 Jan 2024 21:34:48 +0100 Subject: [PATCH 9/9] Add a link back and forth from english README and french README --- README-fr.md | 2 ++ README.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/README-fr.md b/README-fr.md index e1c0ebc..7c846ec 100644 --- a/README-fr.md +++ b/README-fr.md @@ -1,5 +1,7 @@ # Arch-Update +[![lang-en](https://img.shields.io/badge/lang-en-blue.svg)](https://github.com/Antiz96/arch-update/blob/main/README.md) + ## Table des matières - [Description](#description) diff --git a/README.md b/README.md index 5992941..e70176d 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # Arch-Update +[![lang-fr](https://img.shields.io/badge/lang-fr-blue.svg)](https://github.com/Antiz96/arch-update/blob/main/README-fr.md) + ## Table of contents - [Description](#description)