188 lines
7.7 KiB
Markdown
188 lines
7.7 KiB
Markdown
<p align="center">
|
||
<img src="docs/assets/banner.png" alt="ArchASP Dotfiles — Reproducible Arch Linux user environment" width="100%">
|
||
</p>
|
||
|
||
<h1 align="center">ArchASP Dotfiles</h1>
|
||
|
||
<p align="center">
|
||
Environnement utilisateur Arch Linux reproductible, composé avec GNU Stow.
|
||
</p>
|
||
|
||
<p align="center">
|
||
<img alt="Arch Linux" src="https://img.shields.io/badge/Arch_Linux-user_environment-1793d1?style=flat-square&logo=archlinux&logoColor=white">
|
||
<img alt="Wayland avec SwayFX" src="https://img.shields.io/badge/Wayland-SwayFX-89b4fa?style=flat-square">
|
||
<img alt="GNU Stow" src="https://img.shields.io/badge/deployment-GNU_Stow-cba6f7?style=flat-square">
|
||
<img alt="Stable 0.1.0" src="https://img.shields.io/badge/stable-0.1.0-a6e3a1?style=flat-square">
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="#-overview">Overview</a> ·
|
||
<a href="#-stack">Stack</a> ·
|
||
<a href="#-preview">Preview</a> ·
|
||
<a href="#-quick-start">Quick Start</a> ·
|
||
<a href="#-documentation">Documentation</a> ·
|
||
<a href="#-version">Version</a>
|
||
</p>
|
||
|
||
## ✦ Overview
|
||
|
||
`Dotfiles_ArchAP` décrit la couche **utilisateur** d'ArchASP : session Wayland,
|
||
shell, applications terminal, scripts personnels et unités systemd user. Chaque
|
||
package reproduit son chemin sous `$HOME` et GNU Stow déploie les liens
|
||
symboliques correspondants.
|
||
|
||
L'administration système reste séparée dans
|
||
[`arch-system`](https://git.labfytools.com/fy59/arch-system) : installation
|
||
Arch, boot, stockage, réseau, paquets, `/etc` et helpers root. Les inventaires
|
||
de ce dépôt documentent la machine réelle, mais ne constituent pas un
|
||
installateur automatique.
|
||
|
||
## ✦ Stack
|
||
|
||
| Desktop | Shell |
|
||
| --- | --- |
|
||
| `greetd → tuigreet → UWSM → SwayFX` | `Zsh → Starship → Atuin` |
|
||
| `QuickShell → barre et notifications` | `FZF → Zoxide → Eza → Bat → Yazi` |
|
||
| Wofi · Swaylock · Cliphist · Kitty | plugins Zsh et Tmux épinglés par sous-modules |
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
G[greetd] --> T[tuigreet] --> U[UWSM] --> S[SwayFX]
|
||
S --> B[QuickShell : barre et notifications]
|
||
S --> W[Wofi]
|
||
S --> L[Swaylock]
|
||
S --> C[Cliphist]
|
||
S --> K[Kitty]
|
||
```
|
||
|
||
Les responsabilités et dépendances sont détaillées dans
|
||
[`docs/desktop.md`](docs/desktop.md) et [`docs/shell.md`](docs/shell.md).
|
||
|
||
## ✦ Preview
|
||
|
||
Captures actuelles de QuickShell et SwayFX avec **Kitty** et un **Firefox de
|
||
test sur ArchWiki**, sur le workspace 5. La vue d'ensemble a été prise dans
|
||
une session de démonstration isolée, également sur le workspace 5, pour ne pas
|
||
montrer les aperçus des autres workspaces personnels.
|
||
|
||
<p align="center">
|
||
<img src="docs/assets/screenshots/quickshell-workspaces.png" alt="Vue d'ensemble QuickShell avec les workspaces 2 et 5 et deux fenêtres de démonstration sur le workspace 5" width="100%">
|
||
</p>
|
||
|
||
<p align="center"><sub>Vue d'ensemble : prévisualisation des fenêtres, navigation et déplacement entre workspaces.</sub></p>
|
||
|
||
<p align="center">
|
||
<img src="docs/assets/screenshots/quickshell-applications.png" alt="Menu Applications QuickShell avec favoris et catégories, devant Kitty et ArchWiki" width="100%">
|
||
</p>
|
||
|
||
<p align="center"><sub>Menu Applications : recherche, catégories et favoris.</sub></p>
|
||
|
||
<p align="center">
|
||
<img src="docs/assets/screenshots/quickshell-keep-awake.png" alt="Sous-page Maintenir éveillé du Control Center QuickShell avec les quatre durées disponibles" width="100%">
|
||
</p>
|
||
|
||
<p align="center"><sub>Control Center : Maintenir éveillé, avec une demande manuelle distincte de l'inhibition automatique des applications.</sub></p>
|
||
|
||
<p align="center">
|
||
<img src="docs/assets/screenshots/quickshell-appearance.png" alt="Sous-page Apparence du Control Center QuickShell" width="100%">
|
||
</p>
|
||
|
||
<p align="center"><sub>Apparence : fond d'écran, thème, lumière nocturne et localisation.</sub></p>
|
||
|
||
<p align="center">
|
||
<img src="docs/assets/screenshots/quickshell-window-menu.png" alt="Menu de fenêtre QuickShell pour le Firefox de démonstration ouvert sur ArchWiki" width="100%">
|
||
</p>
|
||
|
||
<p align="center"><sub>Menu de fenêtre : accès aux fenêtres ouvertes et aux actions de l'application.</sub></p>
|
||
|
||
## ✦ Repository
|
||
|
||
```text
|
||
ArchASP
|
||
├── arch-system système/root · /etc · services système · installation
|
||
└── Dotfiles_ArchAP utilisateur · $HOME · Stow · systemd --user
|
||
```
|
||
|
||
Les 29 packages Stow couvrent le desktop, le shell, le développement, les
|
||
services utilisateur et l'apparence. `.assets/` contient les inventaires de
|
||
reconstruction ; `docs/` contient la documentation et n'est jamais un package
|
||
Stow. Voir le [contrat d'architecture](docs/architecture.md).
|
||
|
||
## ✦ Quick Start
|
||
|
||
Le chemin heureux utilise Bash pour le tableau des packages :
|
||
|
||
```bash
|
||
git clone --recurse-submodules \
|
||
ssh://git@git.labfytools.com:2223/fy59/Dotfiles_ArchAP.git \
|
||
"$HOME/.dotfiles"
|
||
cd "$HOME/.dotfiles"
|
||
|
||
packages=(atuin bat bin btop cliphist eza fastfetch fzf gtk-3.0 gtklock \
|
||
hyprwhspr kitty mako nvim portal qt5ct qt6ct \
|
||
quickshell starship sway systemd themes tmux uwsm wallpapers wofi yazi \
|
||
ytmusic-tui zsh)
|
||
|
||
stow --no --verbose=2 --target="$HOME" "${packages[@]}"
|
||
stow --verbose=2 --target="$HOME" "${packages[@]}"
|
||
```
|
||
|
||
Les thèmes d’icônes et curseurs sont installés par paquets Arch (Tela Circle, Bibata),
|
||
pas copiés dans les dotfiles. Le répertoire local `~/.icons` existant reste
|
||
préservé pendant la migration : voir [le contrat des icônes](docs/icons.md).
|
||
|
||
Le dry-run doit être examiné avant le déploiement. Les prérequis, conflits,
|
||
inventaires et validations sont décrits dans le
|
||
[guide d'installation](docs/installation.md).
|
||
|
||
## ✦ Documentation
|
||
|
||
| Guide | Sujet |
|
||
| --- | --- |
|
||
| [Documentation](docs/README.md) | Index et responsabilités des documents |
|
||
| [Architecture](docs/architecture.md) | Frontières ArchASP, Stow et données locales |
|
||
| [Installation](docs/installation.md) | Clone neuf, sous-modules, Stow et validations |
|
||
| [Desktop](docs/desktop.md) | Chaîne greetd/UWSM/Sway et composants Wayland |
|
||
| [Sélecteur de fichiers](portal/README.md) | Portail FileChooser, Yazi, Kitty et raccourcis |
|
||
| [Shell](docs/shell.md) | Zsh, outils interactifs, plugins et scripts |
|
||
| [systemd](docs/systemd.md) | Services système et unités utilisateur |
|
||
| [Packages](docs/packages.md) | Inventaires Pacman, AUR, services et outils externes |
|
||
| [Recovery](docs/recovery.md) | Reconstruction complète après perte du disque |
|
||
| [Security](docs/security.md) | Secrets exclus et règles de publication |
|
||
|
||
## Session Restore V2
|
||
|
||
QuickShell crée un checkpoint avant logout, reboot ou poweroff. Au login suivant,
|
||
un chooser unique restaure la session en un clic, sans autre interaction.
|
||
Firefox s’appuie sur son companion signé et un native host de corrélation ;
|
||
Limusic reste géré par l’autostart Sway. La fenêtre terminal est restaurée,
|
||
mais pas son contenu ni ses processus. Ratios exacts, fullscreen et scratchpad
|
||
ne sont pas pris en charge ; le multi-output physique n’est pas validé et le
|
||
provider Firefox actuel reste limité au profil supporté.
|
||
|
||
Voir [installation, fonctionnement et tests V2](docs/session-restore-v2.md).
|
||
|
||
## ✦ Mirrors
|
||
|
||
| Rôle | Dépôt |
|
||
| --- | --- |
|
||
| Upstream principal | [Forgejo](https://git.labfytools.com/fy59/Dotfiles_ArchAP) |
|
||
| Miroir public | [GitHub](https://github.com/labfytools/Dotfiles_ArchAP) |
|
||
|
||
Le fetch d'`origin` reste attaché à Forgejo. Ses deux URLs de push publient
|
||
vers Forgejo et GitHub.
|
||
|
||
## ✦ Version
|
||
|
||
| Branche | Rôle |
|
||
| --- | --- |
|
||
| `0.1.0` | Snapshot stable de la première version nettoyée et documentée |
|
||
| `main` | Développement courant |
|
||
|
||
La branche stable est immobile : les développements suivants avancent sur
|
||
`main` sans déplacer automatiquement `0.1.0`.
|
||
|
||
## ✦ License
|
||
|
||
Aucune licence n'est actuellement déclarée pour ce dépôt. En l'absence de
|
||
licence, aucun droit de réutilisation n'est accordé implicitement.
|