diff --git a/README.md b/README.md index 7d129cb..37de7d3 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,36 @@ Ce guide s’adresse aux systèmes **Debian / Ubuntu et dérivés**. --- -## 🧱 1. Prérequis + + +- [📦 Créer un paquet Debian .deb](#-cr%C3%A9er-un-paquet-debian-deb) + - [Prérequis](#pr%C3%A9requis) + - [Arborescence minimale d’un paquet Debian](#arborescence-minimale-dun-paquet-debian) + - [Création des dossiers](#cr%C3%A9ation-des-dossiers) + - [Le fichier DEBIAN/control](#le-fichier-debiancontrol) + - [Exemple complet](#exemple-complet) + - [Champs importants](#champs-importants) + - [Gérer les dépendances](#g%C3%A9rer-les-d%C3%A9pendances) + - [Syntaxe](#syntaxe) + - [Exemples](#exemples) + - [Arborescence complète recommandée](#arborescence-compl%C3%A8te-recommand%C3%A9e) + - [Création rapide](#cr%C3%A9ation-rapide) + - [Scripts Debian postinst, prerm, postrm](#scripts-debian-postinst-prerm-postrm) + - [postinst après installation](#postinst-apr%C3%A8s-installation) + - [prerm avant suppression](#prerm-avant-suppression) + - [Permissions obligatoires](#permissions-obligatoires) + - [Construire le paquet .debb](#construire-le-paquet-debb) + - [Tester le paquet](#tester-le-paquet) + - [Installation](#installation) + - [Vérification](#v%C3%A9rification) + - [Analyse qualité](#analyse-qualit%C3%A9) + - [](#) + + + +--- + +## Prérequis Outils nécessaires : ```bash @@ -25,7 +54,7 @@ sudo apt install fakeroot --- -## 📁 2. Arborescence minimale d’un paquet Debian +## Arborescence minimale d’un paquet Debian Un paquet Debian est **une simple arborescence de fichiers**. @@ -49,7 +78,7 @@ mkdir -p mon-paquet-1.0/usr/bin --- -## 📄 3. Le fichier DEBIAN/control +## Le fichier DEBIAN/control Le fichier `control` est **obligatoire**. @@ -84,7 +113,7 @@ Description: Exemple de paquet Debian --- -## 🔗 4. Gérer les dépendances +## Gérer les dépendances Les dépendances sont listées dans `Depends:`. @@ -105,7 +134,7 @@ APT installera automatiquement les dépendances lors de l’installation. --- -## 🧩 5. Arborescence complète recommandée +## Arborescence complète recommandée ```text mon-paquet-1.0/ @@ -137,7 +166,7 @@ mkdir -p mon-paquet-1.0/usr/share/{doc/mon-paquet,applications} --- -## ⚙️ 6. Scripts Debian (postinst, prerm, postrm) +## Scripts Debian (postinst, prerm, postrm) Ces scripts sont exécutés automatiquement. @@ -169,7 +198,7 @@ chmod 755 mon-paquet-1.0/DEBIAN/postrm --- -## 📦 7. Construire le paquet `.deb` +## Construire le paquet .debb` ```bash dpkg-deb --build --root-owner-group mon-paquet-1.0 @@ -183,7 +212,7 @@ mon-paquet-1.0.deb --- -## 🧪 8. Tester le paquet +## Tester le paquet ### Installation @@ -203,16 +232,8 @@ dpkg -l mon-paquet lintian mon-paquet-1.0.deb ``` ---- - -## 📚 9. Bonnes pratiques - -* ✔ Respecter le FHS (`/usr`, `/etc`, `/var`) -* ❌ Ne jamais utiliser `/usr/local` -* ✔ Utiliser `Architecture: all` pour scripts -* ✔ Versionner correctement -* ✔ Tester sur une VM propre +### --- -✉️ Maintenu par **Le Garage Numérique** +✉️ Maintenu par [**Le Garage Numérique**](mailto:support@lgn.dev)