Référence : arbre du projet

Description neutre de la fenêtre d'arbre du projet : ce qu'elle montre, ce qu'elle cache, et les touches auxquelles elle répond.

Ouverture

Chemin	Condition
`F9`	Toujours
Window ▸ Project tree	Toujours

Aucun des deux n'exige qu'un fichier soit ouvert. Les deux ramènent l'arbre existant au premier plan quand il y en a déjà un : il y a au plus une fenêtre d'arbre.

Racine

Propriété	Valeur
Enracinée à	Le dossier depuis lequel l'éditeur a été lancé (`os.Getwd()`)
Recherche	Ce dossier seulement. Les dossiers parents ne sont pas parcourus, la même règle que `.turbo-python/settings.toml`.
Titre de la fenêtre	Le nom de base de ce dossier
Ligne de la racine	Non affichée ; la première ligne est la première entrée du projet

Ce qui est listé

Règle	Détail
Ordre	Les dossiers d'abord, puis les fichiers ; chaque groupe trié par nom
Masqué	`.git` seulement
Affiché	Toute autre entrée, y compris celles commençant par un point — `.turbo-python`, `.gitignore`, `.qlty`
Lecture	Un dossier est lu la première fois qu'il est déplié, pas avant
Dossier illisible	Apparaît déplié et vide ; le reste de l'arbre n'est pas affecté

Marqueurs

Marqueur	Signification
`▶`	Un dossier fermé
`▼`	Un dossier ouvert
(deux espaces)	Un fichier — indenté de la largeur d'un marqueur, pour que les noms s'alignent

Chaque niveau de profondeur ajoute deux espaces d'indentation.

Touches

Traitées quand la fenêtre de l'arbre a le focus.

Touche	Action
`↑` `↓`	Ligne précédente / suivante
`Page↑` `Page↓`	Un écran à la fois
`Début` `Fin`	Première / dernière ligne
`→`	Déplier un dossier fermé ; sinon aller à la ligne suivante
`←`	Replier un dossier ouvert ; sinon remonter au dossier qui contient cette ligne
`Entrée`	Ouvrir un fichier ; déplier ou replier un dossier
`F5`, `Ctrl-R`	Relire le projet

Les raccourcis de l'éditeur s'appliquent comme d'habitude : F6 passe à la fenêtre suivante, Ctrl-W ferme l'arbre, Alt-X quitte.

Souris

Action	Effet
Clic sur une ligne	Y déplacer la surbrillance
Clic sur la ligne surlignée	Agir dessus, comme `Entrée`
Molette haut / bas	Déplacer la surbrillance de trois lignes

Rafraîchissement

Déclencheur	Effet
`F5` ou `Ctrl-R`	Relit tous les dossiers qui ont été ouverts
Enregistrer un fichier	La même chose, automatiquement
Déplier un dossier	Lit ce dossier, s'il n'a pas encore été lu

Le rafraîchissement conserve la forme de l'arbre : un dossier ouvert le reste, un dossier supprimé emporte sa branche, et les dossiers que personne n'a ouverts restent non lus. La surbrillance reste sur la même entrée, ou sur la ligne restante la plus proche si cette entrée a disparu.

L'arbre ne surveille pas le système de fichiers. Un fichier créé par une fenêtre terminal, ou par un git checkout, n'apparaît qu'après un rafraîchissement.

Couleurs

Clé de thème	Ce qu'elle colore
`tree.text`	Le nom d'un fichier dans l'arbre, et le fond de l'arbre
`tree.directory`	Le nom d'un dossier
`tree.selected`	La ligne surlignée, quand l'arbre a le focus
`tree.unfocused`	La ligne surlignée, quand il ne l'a pas

Elles ne se rabattent pas sur les clés list.* : le rabattement suit les points et s'arrête à default. Voir Format des fichiers de thème.

Erreurs

Message	Cause
`Cannot tell which directory this is: …`	Le répertoire de travail n'a pas pu être lu
`reading …: …`	Le dossier du projet n'a pas pu être lu
`… is not a directory`	La racine désigne un fichier

Voir aussi

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102


# Référence : arbre du projet

> Description neutre de la fenêtre d'arbre du projet : ce qu'elle montre, ce qu'elle cache, et les touches auxquelles elle répond.

## Ouverture

| Chemin | Condition |
| --- | --- |
| `F9` | Toujours |
| **Window ▸ Project tree** | Toujours |

Aucun des deux n'exige qu'un fichier soit ouvert. Les deux ramènent l'arbre existant au premier plan quand il y en a déjà un : il y a au plus une fenêtre d'arbre.

## Racine

| Propriété | Valeur |
| --- | --- |
| Enracinée à | Le dossier depuis lequel l'éditeur a été lancé (`os.Getwd()`) |
| Recherche | Ce dossier seulement. Les dossiers parents ne sont **pas** parcourus, la même règle que `.turbo-python/settings.toml`. |
| Titre de la fenêtre | Le nom de base de ce dossier |
| Ligne de la racine | Non affichée ; la première ligne est la première entrée du projet |

## Ce qui est listé

| Règle | Détail |
| --- | --- |
| Ordre | Les dossiers d'abord, puis les fichiers ; chaque groupe trié par nom |
| Masqué | `.git` seulement |
| Affiché | Toute autre entrée, y compris celles commençant par un point — `.turbo-python`, `.gitignore`, `.qlty` |
| Lecture | Un dossier est lu la première fois qu'il est déplié, pas avant |
| Dossier illisible | Apparaît déplié et vide ; le reste de l'arbre n'est pas affecté |

## Marqueurs

| Marqueur | Signification |
| --- | --- |
| `▶ ` | Un dossier fermé |
| `▼ ` | Un dossier ouvert |
| (deux espaces) | Un fichier — indenté de la largeur d'un marqueur, pour que les noms s'alignent |

Chaque niveau de profondeur ajoute deux espaces d'indentation.

## Touches

Traitées quand la fenêtre de l'arbre a le focus.

| Touche | Action |
| --- | --- |
| `↑` `↓` | Ligne précédente / suivante |
| `Page↑` `Page↓` | Un écran à la fois |
| `Début` `Fin` | Première / dernière ligne |
| `→` | Déplier un dossier fermé ; sinon aller à la ligne suivante |
| `←` | Replier un dossier ouvert ; sinon remonter au dossier qui contient cette ligne |
| `Entrée` | Ouvrir un fichier ; déplier ou replier un dossier |
| `F5`, `Ctrl-R` | Relire le projet |

Les raccourcis de l'éditeur s'appliquent comme d'habitude : `F6` passe à la fenêtre suivante, `Ctrl-W` ferme l'arbre, `Alt-X` quitte.

## Souris

| Action | Effet |
| --- | --- |
| Clic sur une ligne | Y déplacer la surbrillance |
| Clic sur la ligne surlignée | Agir dessus, comme `Entrée` |
| Molette haut / bas | Déplacer la surbrillance de trois lignes |

## Rafraîchissement

| Déclencheur | Effet |
| --- | --- |
| `F5` ou `Ctrl-R` | Relit tous les dossiers qui ont été ouverts |
| Enregistrer un fichier | La même chose, automatiquement |
| Déplier un dossier | Lit ce dossier, s'il n'a pas encore été lu |

Le rafraîchissement conserve la forme de l'arbre : un dossier ouvert le reste, un dossier supprimé emporte sa branche, et les dossiers que personne n'a ouverts restent non lus. La surbrillance reste sur la même entrée, ou sur la ligne restante la plus proche si cette entrée a disparu.

L'arbre ne surveille **pas** le système de fichiers. Un fichier créé par une fenêtre terminal, ou par un `git checkout`, n'apparaît qu'après un rafraîchissement.

## Couleurs

| Clé de thème | Ce qu'elle colore |
| --- | --- |
| `tree.text` | Le nom d'un fichier dans l'arbre, et le fond de l'arbre |
| `tree.directory` | Le nom d'un dossier |
| `tree.selected` | La ligne surlignée, quand l'arbre a le focus |
| `tree.unfocused` | La ligne surlignée, quand il ne l'a pas |

Elles ne se rabattent pas sur les clés `list.*` : le rabattement suit les points et s'arrête à `default`. Voir [Format des fichiers de thème](themes.md).

## Erreurs

| Message | Cause |
| --- | --- |
| `Cannot tell which directory this is: …` | Le répertoire de travail n'a pas pu être lu |
| `reading …: …` | Le dossier du projet n'a pas pu être lu |
| `… is not a directory` | La racine désigne un fichier |

## Voir aussi

- [Parcourir un projet et ouvrir des fichiers depuis un arbre](../how-to/browse-a-project.md)
- [Arbre du projet](../explanation/project-tree.md)
- [Clavier](keyboard.md)