-
-
Notifications
You must be signed in to change notification settings - Fork 13
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Put the translated README in the README-fr.md file
- Loading branch information
Showing
2 changed files
with
242 additions
and
239 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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 <https://wiki.archlinux.org/title/Desktop_notifications>) . | ||
|
|
||
| ##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 !* | ||
|
|
||
| [](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. | ||
|
|
||
|  | ||
|
|
||
| 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`) : | ||
|
|
||
|  | ||
|
|
||
| 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")) : | ||
|
|
||
|  | ||
|  | ||
|
|
||
| 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.* | ||
|
|
||
|  | ||
|
|
||
| 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.* | ||
|
|
||
|  | ||
|
|
||
| Pendant que `arch-update` effectue des mises à jour, l'icône change en conséquence : | ||
|
|
||
|  | ||
|
|
||
| Une fois la mise à jour terminée, l'icône change en conséquence : | ||
|
|
||
|  | ||
|
|
||
| `arch-update` recherchera ensuite les packages orphelins/packages Flatpak inutilisés et proposera de les supprimer (s'il y en a) : | ||
|
|
||
|  | ||
|
|
||
|  | ||
|
|
||
| `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.* | ||
|
|
||
|  | ||
|
|
||
| De plus, `arch-update` recherchera les fichiers pacnew/pacsave et proposera de les traiter via `pacdiff` (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) : | ||
|
|
||
|  | ||
|
|
||
| ## 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 <https://github.com/Jguer/yay> et <https://aur.archlinux.org/packages/yay> | ||
| Voir <https://github.com/morganamilo/paru> et <https://aur.archlinux.org/packages/paru> | ||
|
|
||
| ### 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 <https://www.flatpak.org/> et <https://archlinux.org/packages/extra/x86_64/flatpak/> | ||
|
|
||
| ### 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 <https://wiki.archlinux.org/title/Desktop_notifications> | ||
|
|
||
| ### 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 <https://www.freedesktop.org/software/systemd/man/systemd.time.html> 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 ! |
Oops, something went wrong.