| 📦 Turbo JS 91999d1 k33g 12h ago | 1 | # Donner ses propres réglages à un projet |
| 2 | |
| 3 | Ce guide montre comment fixer un thème et activer la sauvegarde automatique pour un projet, afin que tous ceux qui l'ouvrent aient le même éditeur. Il suppose Turbo JS déjà installé. |
| 4 | |
| 5 | ## Créer le fichier de réglages |
| 6 | |
| 7 | Lancez l'éditeur **depuis le dossier du projet**, puis choisissez **Options ▸ Create project settings**. |
| 8 | |
| 9 | Cela écrit `.turbo-js/settings.toml`, rempli avec le thème que vous utilisez à cet instant, et l'ouvre pour édition — coloré, puisque Turbo JS colore le TOML : |
| 10 | |
| 11 | ```toml |
| 12 | # turbo-js project settings. |
| 13 | # |
| 14 | # These apply to everyone who opens this project in turbo-js. Delete this file |
| 15 | # and the editor falls back to its own defaults. |
| 16 | |
| 17 | [editor] |
| 18 | |
| 19 | # The colour theme to start in. `turbo-js -list-themes` lists them all. |
| 20 | # A -theme flag on the command line overrides this. |
| 21 | theme = "turbo-classic" |
| 22 | |
| 23 | # Write modified files by themselves, a short while after you stop typing. |
| 24 | # On, because a project that has gone to the trouble of having a settings file |
| 25 | # has said what it wants; set it to false and save, and it stops at once. |
| 26 | autosave = true |
| 27 | |
| 28 | # How long that while is. Any Go duration: "500ms", "2s", "1m". |
| 29 | autosave_delay = "2s" |
| 30 | ``` |
| 31 | |
| 32 | Le fichier est lu au démarrage de l'éditeur, et **de nouveau à chaque fois que vous l'enregistrez** — une modification est donc en vigueur dès que vous appuyez sur `F2`. La barre d'état le confirme : `Applied .turbo-js/settings.toml — autosave on (2s)`. |
| 33 | |
| 34 | Cela vaut pour les réglages que ce fichier contient, pas pour le thème : **Options ▸ Theme** est la façon vivante de le changer, et y réécrit votre choix pour vous. |
| 35 | |
| 36 | L'entrée de menu que vous venez d'utiliser est maintenant grisée, et **Options ▸ Project settings…** à côté d'elle ne l'est plus. C'est la règle pour les trois fichiers du projet : vous pouvez créer celui que vous n'avez pas, et ouvrir celui que vous avez. |
| 37 | |
| 38 | ## La sauvegarde automatique |
| 39 | |
| 40 | Elle est déjà active : le fichier qu'on vient de vous donner dit `autosave = true`. |
| 41 | |
| 42 | Tout fichier qui a un nom est écrit deux secondes après que vous ayez cessé de taper. La barre d'état affiche `Saved main.js` au moment où cela arrive. Rien n'est écrit tant que vous tapez : chaque frappe repousse l'attente. |
| 43 | |
| 44 | Deux choses changent en conséquence, toutes deux voulues : |
| 45 | |
| 46 | - **Fermer une fenêtre ne demande plus** s'il faut enregistrer. Le fichier allait l'être de toute façon. |
| 47 | - **Quitter l'éditeur ne demande plus** non plus, pour la même raison. |
| 48 | |
| 49 | Un fichier qui n'a jamais reçu de nom fait exception : la sauvegarde automatique n'ouvre jamais de dialogue, donc une fenêtre sans titre garde son `*` et la question est toujours posée à la fermeture. |
| 50 | |
| 51 | Pour la désactiver, mettez `autosave` à `false` et enregistrez ; la barre d'état répond `autosave off`, et cela s'arrête à l'instant. Pour attendre plus ou moins longtemps, changez `autosave_delay` : |
| 52 | |
| 53 | ```toml |
| 54 | autosave_delay = "500ms" |
| 55 | ``` |
| 56 | |
| 57 | ## Fixer le thème |
| 58 | |
| 59 | Donnez à `theme` un nom parmi ceux de `turbo-js -list-themes`, ou choisissez-en un simplement avec **Options ▸ Theme** : dès lors qu'un fichier de réglages existe, choisir un thème l'y écrit pour vous, en conservant vos commentaires et votre mise en page. |
| 60 | |
| 61 | ## Essayer un autre thème sans toucher au fichier |
| 62 | |
| 63 | Passez `-theme` sur la ligne de commande. Il l'emporte sur le choix du projet, le temps de cette exécution seulement : |
| 64 | |
| 65 | ```bash |
| 66 | turbo-js -theme turbo-dark main.js |
| 67 | ``` |
| 68 | |
| 69 | ## Modifier le fichier plus tard |
| 70 | |
| 71 | **Options ▸ Project settings…** le rouvre. L'entrée est grisée dans un projet qui n'en a pas. |
| 72 | |
| 73 | ## Variantes |
| 74 | |
| 75 | - **Vous lancez l'éditeur depuis un sous-dossier.** Les réglages ne sont pas trouvés : seul `./.turbo-js` est consulté, sans remontée vers la racine du projet. Lancez depuis le dossier du projet, ou passez `-theme` pour cette fois. |
| 76 | - **Le fichier contient une erreur.** L'éditeur le signale sur la sortie d'erreur et s'ouvre avec ses valeurs par défaut — vous pouvez donc corriger le fichier dans l'éditeur lui-même. |
| 77 | - **Vous partagez le projet.** `.turbo-js/settings.toml` est un fichier ordinaire : versionnez-le pour convenir d'un thème en équipe, ou ajoutez-le à `.gitignore` pour le garder pour vous. |
| 78 | |
| 79 | ## Voir aussi |
| 80 | |
| 81 | - Chaque clé, avec son type et sa valeur par défaut : [Référence des réglages de projet](../reference/project-settings.md) |
| 82 | - Pourquoi le fichier n'est pas cherché dans les dossiers parents, et pourquoi l'autosave attend : [Réglages de projet](../explanation/project-settings.md) |
| 83 | - Écrire un thème à fixer : [Écrire son propre thème](write-a-theme.md) |