Dotfiles_ArchAP/README.md

5.2 KiB

ArchASP Dotfiles — Reproducible Arch Linux user environment

ArchASP Dotfiles

Environnement utilisateur Arch Linux reproductible, composé avec GNU Stow.

Arch Linux Wayland avec Sway GNU Stow Stable 0.1.0

Overview · Stack · Preview · Quick Start · Documentation · Version

✦ 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 : 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 → Sway Zsh → Starship → Atuin
Swaybar → i3status-rs FZF → Zoxide → Eza → Bat → Yazi
Mako · Wofi · Swaylock · Cliphist · Kitty plugins Zsh et Tmux épinglés par sous-modules
flowchart LR
    G[greetd] --> T[tuigreet] --> U[UWSM] --> S[Sway]
    S --> B[Swaybar] --> I[i3status-rs]
    S --> M[Mako]
    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 et docs/shell.md.

✦ Preview

Environnement ArchASP réel sous Sway

Environnement ArchASP réel — Sway, applications terminal et palette Catppuccin.

✦ Repository

ArchASP
├── arch-system       système/root · /etc · services système · installation
└── Dotfiles_ArchAP   utilisateur · $HOME · Stow · systemd --user

Les 31 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.

✦ Quick Start

Le chemin heureux utilise Bash pour le tableau des packages :

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 i3status-rust icons kitty mako nvim opencode qt5ct qt6ct \
  starship sway swaylock systemd themes tmux uwsm wallpapers wofi yazi \
  ytmusic-tui zsh)

stow --no --verbose=2 --target="$HOME" "${packages[@]}"
stow --verbose=2 --target="$HOME" "${packages[@]}"

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.

✦ Documentation

Guide Sujet
Documentation Index et responsabilités des documents
Architecture Frontières ArchASP, Stow et données locales
Installation Clone neuf, sous-modules, Stow et validations
Desktop Chaîne greetd/UWSM/Sway et composants Wayland
Shell Zsh, outils interactifs, plugins et scripts
systemd Services système et unités utilisateur
Packages Inventaires Pacman, AUR, services et outils externes
Recovery Reconstruction complète après perte du disque
Security Secrets exclus et règles de publication

✦ Mirrors

Rôle Dépôt
Upstream principal Forgejo
Miroir public GitHub

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.