Exemple concret 1 : Créer une arborescence de projet simple (ex: `mon_projet/src`, `mon_projet/docs`)

Mettre en pratique : structurer un espace de travail de projet

Après avoir exploré les commandes de création de répertoires (mkdir) et de fichiers (touch), ainsi que les commandes de navigation (cd, ls, pwd), il est temps de mettre ces connaissances en action avec un exemple concret. Une tâche courante pour tout développeur, rédacteur technique, ou même pour organiser des fichiers personnels, est de créer une structure de répertoires (une arborescence) pour un nouveau projet.

Avoir une structure de projet bien définie dès le départ facilite grandement l'organisation, la collaboration et la maintenance. Dans cet exemple, nous allons créer une arborescence simple pour un projet fictif que nous appellerons "MonSuperProjet". Ce projet contiendra un répertoire pour le code source (src), un pour la documentation (docs), un pour les tests (tests), et un fichier README.md à la racine du projet.

Cet exercice vous permettra de voir comment les commandes s'enchaînent naturellement et comment l'option -p de mkdir peut être particulièrement utile.

Etapes de création de l'arborescence du projet

Nous allons procéder étape par étape. Ouvrez votre terminal. Pour commencer, assurons-nous d'être dans notre répertoire personnel (ou tout autre endroit où vous souhaitez créer ce projet).

cd ~

Vérifions où nous sommes (optionnel, mais bonne pratique) :

pwd

Cela devrait afficher quelque chose comme /home/votre_nom_utilisateur.

Nous allons créer le répertoire racine de notre projet, MonSuperProjet.

mkdir MonSuperProjet

Maintenant, toutes nos opérations se feront à l'intérieur de ce nouveau répertoire.

cd MonSuperProjet

Vérifions notre position actuelle :

pwd

La sortie devrait être /home/votre_nom_utilisateur/MonSuperProjet.

Nous pouvons créer ces trois répertoires en une seule commande mkdir :

mkdir src docs tests

Vérifions ce qui a été créé :

ls -l

Vous devriez voir :

total 12
drwxr-xr-x 2 utilisateur utilisateur 4096 mai 24 15:00 docs
drwxr-xr-x 2 utilisateur utilisateur 4096 mai 24 15:00 src
drwxr-xr-x 2 utilisateur utilisateur 4096 mai 24 15:00 tests

Supposons que dans src, nous voulions une structure comme src/app/core et src/app/utils. Si src/app n'existe pas encore, nous pouvons utiliser mkdir -p.

mkdir -p src/app/core
mkdir -p src/app/utils

Ou, en une seule fois si src/app doit être créé :

mkdir -p src/app/{core,utils}

(La syntaxe {core,utils} est une expansion de accolades du shell Bash, qui crée src/app/core et src/app/utils. Si vous n'êtes pas familier, les deux commandes mkdir -p séparées ci-dessus fonctionnent parfaitement).

Ajoutons un fichier README.md à la racine du projet, un fichier main.py (par exemple) dans src/app/, et un fichier index.md dans docs/.

touch README.md
touch src/app/main.py
touch docs/index.md

Si vous vouliez créer un fichier config.ini dans src/app/core/ :

touch src/app/core/config.ini

Visualiser l'arborescence finale

Après toutes ces étapes, quelle est la structure de notre projet ? Nous pouvons utiliser la commande ls -R (listage récursif) pour voir toute l'arborescence depuis la racine de MonSuperProjet. Attention, pour de gros projets, ls -R peut produire une sortie très longue.

Une commande encore mieux adaptée pour visualiser une arborescence est tree. Si elle n'est pas installée sur votre système, vous pouvez généralement l'installer avec votre gestionnaire de paquets (par exemple, sudo apt install tree sur Debian/Ubuntu ou sudo dnf install tree sur Fedora).

En supposant que tree est installé, depuis le répertoire MonSuperProjet :

tree

La sortie devrait ressembler à ceci (l'ordre exact des fichiers dans un répertoire peut varier) :

.
├── README.md
├── docs
│   └── index.md
├── src
│   └── app
│       ├── core
│       │   └── config.ini
│       ├── main.py
│       └── utils
└── tests

6 directories, 4 files

Si vous n'avez pas tree, ls -R | grep -v '^$' | sed -e 's/[^-][^\/]*\//--/g' -e 's/^--/|--/' -e 's/-*\([^ ]*\)/\1/' est une astuce de shell qui tente d'émuler une partie de la sortie de tree, mais tree reste la meilleure option.

Cet exemple simple démontre comment, avec quelques commandes de base, vous pouvez rapidement mettre en place une structure de répertoires organisée. L'utilisation de mkdir -p est particulièrement efficace pour créer des chemins imbriqués en une seule fois, et touch est parfait pour créer des fichiers vides comme des placeholders ou des points de départ.

N'hésitez pas à adapter cette structure à vos propres besoins et types de projets. La clé est la cohérence et la clarté pour que vous (et d'autres) puissiez facilement retrouver les informations.