Ajouter README.md
This commit is contained in:
parent
6b3409ecba
commit
7f73eaa82b
|
|
@ -0,0 +1,313 @@
|
|||
# 🚀 Installation automatique de Zsh avec Powerlevel10k pour Debian 12
|
||||
|
||||
Script d'installation complet et idempotent pour configurer un environnement Zsh moderne et productif sur Debian 12.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## ✨ Fonctionnalités
|
||||
|
||||
Ce script installe et configure automatiquement :
|
||||
|
||||
- ✅ **Zsh** - Shell moderne et puissant
|
||||
- ✅ **Oh My Zsh** - Framework de gestion de configuration
|
||||
- ✅ **Powerlevel10k** - Thème ultra-rapide et personnalisable
|
||||
- ✅ **Polices Nerd Fonts** (MesloLGS NF) - Pour un affichage parfait des icônes
|
||||
- ✅ **Plugins essentiels** - Autocomplétion, coloration, historique amélioré
|
||||
- ✅ **Outils modernes** - fzf, ripgrep, bat, exa, fd-find
|
||||
|
||||
## 📦 Plugins installés
|
||||
|
||||
### Plugins externes (via Git)
|
||||
|
||||
| Plugin | Description |
|
||||
|--------|-------------|
|
||||
| **zsh-autosuggestions** | Suggestions basées sur l'historique (→ pour accepter) |
|
||||
| **zsh-syntax-highlighting** | Coloration syntaxique des commandes |
|
||||
| **zsh-completions** | Autocompletions supplémentaires |
|
||||
| **zsh-history-substring-search** | Recherche dans l'historique avec ↑/↓ |
|
||||
| **fzf-tab** | Complétion interactive avec prévisualisation |
|
||||
|
||||
### Plugins Oh My Zsh intégrés
|
||||
|
||||
- `git` - Aliases Git (gs, ga, gc, gp, gl...)
|
||||
- `docker` - Autocomplétion Docker
|
||||
- `docker-compose` - Autocomplétion Docker Compose
|
||||
- `sudo` - Double ESC pour préfixer avec sudo
|
||||
- `history` - Gestion avancée de l'historique
|
||||
- `colored-man-pages` - Pages man colorées
|
||||
- `command-not-found` - Suggestions de paquets
|
||||
|
||||
## 🛠️ Outils supplémentaires
|
||||
|
||||
- **fzf** - Recherche floue interactive (Ctrl+R)
|
||||
- **ripgrep** - Recherche ultra-rapide dans les fichiers
|
||||
- **fd-find** - Alternative moderne à `find`
|
||||
- **bat** - `cat` avec coloration syntaxique
|
||||
- **exa** - `ls` amélioré avec icônes et couleurs
|
||||
|
||||
## 📋 Prérequis
|
||||
|
||||
- Debian 12 (Bookworm)
|
||||
- Accès root ou sudo
|
||||
- Connexion internet
|
||||
|
||||
## 🚀 Installation
|
||||
|
||||
### Installation rapide
|
||||
|
||||
```bash
|
||||
# Télécharger le script
|
||||
wget https://raw.giteausercontent.com/Johnny/Install_zsh/main/install_zsh.sh
|
||||
|
||||
# Rendre le script exécutable
|
||||
chmod +x install_zsh.sh
|
||||
|
||||
# Exécuter pour l'utilisateur actuel
|
||||
sudo ./install_zsh.sh
|
||||
|
||||
# Ou pour un utilisateur spécifique
|
||||
sudo ./install_zsh.sh username
|
||||
```
|
||||
|
||||
### Installation via Git
|
||||
|
||||
```bash
|
||||
git clone https://git.h3campus.fr/Johnny/Install_zsh.git
|
||||
cd Install_zsh
|
||||
chmod +x install_zsh.sh
|
||||
sudo ./install_zsh.sh
|
||||
```
|
||||
|
||||
## ⚙️ Post-installation
|
||||
|
||||
1. **Déconnectez-vous et reconnectez-vous** pour activer Zsh
|
||||
2. Au premier lancement, **l'assistant de configuration Powerlevel10k** se lance automatiquement
|
||||
3. Suivez les instructions pour personnaliser votre prompt
|
||||
|
||||
### Reconfigurer Powerlevel10k
|
||||
|
||||
```bash
|
||||
p10k configure
|
||||
```
|
||||
|
||||
### Configuration SSH
|
||||
|
||||
Si vous utilisez SSH, configurez votre terminal local pour utiliser la police **MesloLGS NF** :
|
||||
|
||||
- **Windows Terminal** : Settings → Profiles → Defaults → Appearance → Font face → MesloLGS NF
|
||||
- **iTerm2** : Preferences → Profiles → Text → Font → MesloLGS NF
|
||||
- **VS Code** : Settings → Terminal › Integrated: Font Family → MesloLGS NF
|
||||
|
||||
## ⌨️ Raccourcis clavier
|
||||
|
||||
| Raccourci | Action |
|
||||
|-----------|--------|
|
||||
| `Ctrl + R` | Recherche floue dans l'historique (fzf) |
|
||||
| `↑` / `↓` | Recherche dans l'historique (substring) |
|
||||
| `→` | Accepter une suggestion |
|
||||
| `ESC` `ESC` | Ajouter sudo à la commande |
|
||||
| `Tab` | Complétion interactive avec prévisualisation |
|
||||
|
||||
## 🎨 Aliases inclus
|
||||
|
||||
### Général
|
||||
```bash
|
||||
ll # ls -lah avec exa si disponible
|
||||
la # ls -A
|
||||
tree # exa --tree (si exa installé)
|
||||
cat # bat avec coloration (si bat installé)
|
||||
```
|
||||
|
||||
### Git
|
||||
```bash
|
||||
gs # git status
|
||||
ga # git add
|
||||
gc # git commit
|
||||
gp # git push
|
||||
gl # git log --oneline --graph --decorate
|
||||
```
|
||||
|
||||
### Docker
|
||||
```bash
|
||||
dps # docker ps
|
||||
dpa # docker ps -a
|
||||
di # docker images
|
||||
dex # docker exec -it
|
||||
```
|
||||
|
||||
### Maintenance
|
||||
```bash
|
||||
update-zsh # Mettre à jour Oh My Zsh et tous les plugins
|
||||
zshconfig # Éditer ~/.zshrc
|
||||
```
|
||||
|
||||
## 🔄 Mise à jour
|
||||
|
||||
Pour mettre à jour Oh My Zsh et tous les plugins :
|
||||
|
||||
```bash
|
||||
update-zsh
|
||||
```
|
||||
|
||||
Ou manuellement :
|
||||
|
||||
```bash
|
||||
omz update
|
||||
cd ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions && git pull
|
||||
cd ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting && git pull
|
||||
cd ~/.oh-my-zsh/custom/plugins/zsh-completions && git pull
|
||||
cd ~/.oh-my-zsh/custom/plugins/fzf-tab && git pull
|
||||
cd ~/.oh-my-zsh/custom/themes/powerlevel10k && git pull
|
||||
```
|
||||
|
||||
## 💾 Sauvegarde de la configuration
|
||||
|
||||
### Sauvegarder Powerlevel10k
|
||||
|
||||
```bash
|
||||
# Sauvegarde locale
|
||||
cp ~/.p10k.zsh ~/.p10k.zsh.backup
|
||||
|
||||
# Sauvegarde datée
|
||||
cp ~/.p10k.zsh ~/p10k-backup-$(date +%Y%m%d).zsh
|
||||
```
|
||||
|
||||
### Sauvegarder .zshrc
|
||||
|
||||
```bash
|
||||
cp ~/.zshrc ~/.zshrc.backup
|
||||
```
|
||||
|
||||
### Synchroniser entre serveurs
|
||||
|
||||
```bash
|
||||
# Depuis le serveur source
|
||||
scp ~/.p10k.zsh ~/.zshrc user@serveur-destination:~/
|
||||
|
||||
# Ou avec Git (recommandé)
|
||||
mkdir -p ~/dotfiles
|
||||
cp ~/.p10k.zsh ~/.zshrc ~/dotfiles/
|
||||
cd ~/dotfiles
|
||||
git init
|
||||
git add .
|
||||
git commit -m "Initial dotfiles"
|
||||
git remote add origin https://github.com/USERNAME/dotfiles.git
|
||||
git push -u origin main
|
||||
```
|
||||
|
||||
## 🔧 Personnalisation
|
||||
|
||||
### Modifier les plugins
|
||||
|
||||
Éditez `~/.zshrc` et modifiez la section `plugins=()` :
|
||||
|
||||
```bash
|
||||
plugins=(
|
||||
git
|
||||
docker
|
||||
# Ajoutez vos plugins ici
|
||||
)
|
||||
```
|
||||
|
||||
### Ajouter des aliases personnalisés
|
||||
|
||||
Ajoutez vos aliases à la fin de `~/.zshrc` :
|
||||
|
||||
```bash
|
||||
alias mon-alias='ma-commande'
|
||||
```
|
||||
|
||||
Puis rechargez :
|
||||
|
||||
```bash
|
||||
source ~/.zshrc
|
||||
# ou
|
||||
exec zsh
|
||||
```
|
||||
|
||||
## 🐛 Dépannage
|
||||
|
||||
### Les icônes ne s'affichent pas correctement
|
||||
|
||||
- Vérifiez que votre terminal utilise la police **MesloLGS NF**
|
||||
- Redémarrez votre terminal après avoir changé la police
|
||||
|
||||
### Zsh n'est pas le shell par défaut
|
||||
|
||||
```bash
|
||||
# Vérifier le shell actuel
|
||||
echo $SHELL
|
||||
|
||||
# Changer manuellement
|
||||
chsh -s $(which zsh)
|
||||
```
|
||||
|
||||
### Les suggestions sont lentes
|
||||
|
||||
Ajoutez dans `~/.zshrc` :
|
||||
|
||||
```bash
|
||||
ZSH_AUTOSUGGEST_USE_ASYNC=true
|
||||
```
|
||||
|
||||
### Désactiver un plugin
|
||||
|
||||
Éditez `~/.zshrc` et retirez le plugin de la liste, puis :
|
||||
|
||||
```bash
|
||||
source ~/.zshrc
|
||||
```
|
||||
|
||||
## 📝 Structure des fichiers
|
||||
|
||||
```
|
||||
~/
|
||||
├── .zshrc # Configuration principale Zsh
|
||||
├── .p10k.zsh # Configuration Powerlevel10k
|
||||
├── .oh-my-zsh/ # Framework Oh My Zsh
|
||||
│ └── custom/
|
||||
│ ├── plugins/ # Plugins personnalisés
|
||||
│ │ ├── zsh-autosuggestions/
|
||||
│ │ ├── zsh-syntax-highlighting/
|
||||
│ │ ├── zsh-completions/
|
||||
│ │ ├── zsh-history-substring-search/
|
||||
│ │ └── fzf-tab/
|
||||
│ └── themes/
|
||||
│ └── powerlevel10k/ # Thème Powerlevel10k
|
||||
└── .local/share/fonts/ # Polices MesloLGS NF
|
||||
```
|
||||
|
||||
## 🤝 Contribution
|
||||
|
||||
Les contributions sont les bienvenues ! N'hésitez pas à :
|
||||
|
||||
1. Fork le projet
|
||||
2. Créer une branche (`git checkout -b feature/amelioration`)
|
||||
3. Commit vos changements (`git commit -m 'Ajout fonctionnalité'`)
|
||||
4. Push vers la branche (`git push origin feature/amelioration`)
|
||||
5. Ouvrir une Pull Request
|
||||
|
||||
## 📜 Licence
|
||||
|
||||
Ce projet est sous licence MIT. Voir le fichier [LICENSE](LICENSE) pour plus de détails.
|
||||
|
||||
## 🙏 Remerciements
|
||||
|
||||
- [Oh My Zsh](https://ohmyz.sh/)
|
||||
- [Powerlevel10k](https://github.com/romkatv/powerlevel10k)
|
||||
- [zsh-users](https://github.com/zsh-users) pour les plugins
|
||||
- [Aloxaf](https://github.com/Aloxaf/fzf-tab) pour fzf-tab
|
||||
|
||||
## 📧 Support
|
||||
|
||||
Si vous rencontrez des problèmes ou avez des questions :
|
||||
|
||||
- Ouvrez une [issue](https://git.h3campus.fr/Johnny/Install_zsh/issues)
|
||||
- Consultez la [documentation Oh My Zsh](https://github.com/ohmyzsh/ohmyzsh/wiki)
|
||||
- Consultez la [documentation Powerlevel10k](https://github.com/romkatv/powerlevel10k)
|
||||
|
||||
|
||||
|
||||
Made with ❤️ for the Zsh community
|
||||
Loading…
Reference in New Issue