Générateur d'arborescence ASCII — outil gratuit

Exemple détaillé

La page s'ouvre sur un exemple de 12 lignes : « my-project » avec « src », « public », « package.json » et « README.md » en dessous, et « components », « lib » et « index.ts » sous « src ». Avec le style « ├── Unicode » par défaut, ├── marque un élément qui a un frère en dessous, └── marque le dernier, et │ prolonge une branche vers le bas. Une note tapée comme « index.ts # point d'entrée » ressort en « index.ts # point d'entrée », chaque note étant alignée dans une colonne deux espaces après la ligne la plus longue qui en comporte une. Appuyez sur « - Markdown » pour des puces imbriquées (deux espaces par niveau) ou « |-- ASCII » pour des caractères simples. Coller les trois chemins src/app/page.tsx, src/app/layout.tsx et src/lib/utils.ts donne src avec app (page.tsx, layout.tsx) et lib (utils.ts) en dessous.

Quels réglages utiliser, et les limites

• Choisissez le style pour l'endroit où l'arborescence ira. « ├── Unicode » rend le mieux dans les README et les documents. « |-- ASCII » utilise uniquement des caractères simples, pour les terminaux, les logs et les commentaires de code où les caractères de cadre peuvent ne pas s'afficher. « - Markdown » fait une liste à puces. « Télécharger » enregistre tree.txt, ou tree.md en style Markdown.
• Imbriquez avec des indentations, ou collez des chemins. Chaque indentation plus profonde crée un enfant de la ligne au-dessus. Une tabulation compte pour quatre espaces, et la touche Tab dans la zone insère deux espaces (Maj+Tab les retire ; appuyez sur Échap puis Tab pour quitter la zone). Vous pouvez aussi coller une liste de chemins comme la sortie de git ls-files, find ou dir /s /b, avec des séparateurs / ou \, et ils fusionnent en une seule arborescence. Terminez un nom par / pour marquer un dossier vide.
• Ajoutez des notes après un délimiteur. Mettez « # », « // », « - » ou « <- » après un nom, avec un espace de chaque côté, et le reste de la ligne devient une note, alignée dans une colonne. « Style de commentaire » choisit si la sortie affiche #, // ou <--. Un nom qui contient un espace, un tiret et un autre espace, comme « Mon Doc - final.docx », est divisé en un nom et une note, donc écrivez-le sans les espaces autour du tiret.
• Triez les dossiers en premier et marquez les dossiers avec une barre oblique. « Dossiers en premier » place les dossiers avant les fichiers à chaque niveau et conserve sinon votre ordre. « / final » ajoute un / après chaque dossier, c'est-à-dire tout nom qui a des enfants ou que vous avez terminé par /.
• Collez une arborescence pour en changer le style. Si vous collez du texte qui ressemble déjà à une arborescence (lignes ├──, └──, |-- ou +--, y compris la sortie de tree sous Linux et tree /f sous Windows), la zone le convertit en liste indentée et affiche « Arborescence collée détectée — reconvertie en liste indentée modifiable. » Changez ensuite de style, triez ou ajoutez des notes. Les lignes d'en-tête que Windows imprime, comme « Folder PATH listing » et « Volume serial number », sont ignorées.
• Importez des noms depuis un dossier ou un zip. « Importer un dossier » (caché sur les téléphones), déposer un dossier sur la zone, ou « Importer .zip » lit uniquement les noms de fichiers, jamais le contenu. Sous « Options d'importation », « Ignorer les noms (séparés par des virgules, * autorisé) » ignore par défaut node_modules, .git, dist, build, .next, __pycache__, .venv et d'autres dossiers de build courants, et « Profondeur max » commence à 7 et va de 1 à 30. La profondeur compte les dossiers au-dessus d'un fichier, dossier supérieur inclus. Une note indique combien de fichiers ont été ignorés.

Problèmes courants et comment les résoudre

L'arborescence sort plate, sans branches.

Rien n'était indenté, donc chaque ligne est devenue son propre élément de premier niveau. Indentez les enfants avec des espaces ou la touche Tab. La seule exception est une liste de chemins (noms contenant / ou \), qui est imbriquée pour vous, mais seulement si aucune des lignes n'est indentée.

Une partie d'un nom de fichier apparaît comme une note.

Un espace, puis #, //, - ou <-, puis un autre espace commence une note. « Mon Doc - final.docx » devient le nom « Mon Doc » avec la note « final.docx ». Retirez les espaces autour du tiret, comme dans « Mon Doc-final.docx ». Un # ou un - sans espace des deux côtés, comme dans « C# notes.md », reste dans le nom.

Il est indiqué « Impossible de lire ce .zip. Vérifiez qu'il s'agit d'un fichier zip valide et non chiffré. »

Le fichier n'a pas pu être ouvert en tant que zip : il est peut-être endommagé, protégé par mot de passe, ou n'est pas vraiment un zip. Créez un zip normal et réessayez. « Ce .zip n'a aucune entrée. » signifie que l'archive est vide.

Des fichiers manquent après l'importation d'un dossier.

Regardez la note sous la zone, comme « 12 fichiers ignorés (ignorés ou trop profonds) ». Les fichiers sont ignorés quand un nom de dossier ou de fichier correspond à « Ignorer les noms », ou quand ils se trouvent plus profondément que la « Profondeur max ». Ouvrez « Options d'importation » et modifiez la liste ou augmentez la Profondeur max ; le changement est appliqué à votre dernière importation sauf si vous avez modifié le texte depuis. De plus, un dossier déposé n'est lu que jusqu'à environ 50 000 noms avant que la liste d'ignorés ne soit appliquée, donc un projet avec un énorme node_modules peut perdre de vrais fichiers : utilisez plutôt « Importer un dossier » ou un zip fait sans node_modules.

Il est indiqué « Impossible de lire le dossier ou fichier déposé. »

Le navigateur a refusé de lister l'élément déposé. Utilisez plutôt « Importer un dossier », ou créez un .zip et utilisez « Importer .zip ». Sur les téléphones, l'option de dossier est cachée, utilisez donc un zip.

Comment il se compare

Pour un dossier que vous avez déjà, la commande tree (ou tree /f sous Windows) dans un terminal donne une liste exacte en une étape, et cet outil peut en changer le style. Utilisez cet outil quand vous voulez planifier une structure qui n'existe pas encore, montrer seulement une partie d'un dossier, ajouter des notes, ou passer d'Unicode à ASCII ou Markdown. Il fonctionne uniquement à partir des noms, sans tailles de fichiers, dates, permissions ou contenus, et une importation ignore les dossiers de build courants sauf si vous modifiez la liste. Entre les styles, l'Unicode se lit le mieux mais ses caractères de cadre peuvent ne pas s'afficher partout, l'ASCII est le choix sûr pour les terminaux et les commentaires de code, et le Markdown est pour les listes qui doivent s'afficher sous forme de puces.