turbo-editors/turbo-golo · configure-a-project.md

⑂ 49c12f54ef399972152fccd592ae27e94977f9b5

configure-a-project.md · 96 lines · 5.5 KBmarkdown    Blame HistoryRaw
📦 Turbo Golo   1# Donner ses propres réglages à un projet
3Ce 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 Golo déjà installé.
5## Créer le fichier de réglages
7Lancez l'éditeur **depuis le dossier du projet**, puis choisissez **Options ▸ Create project settings**.
9Cela écrit `.turbo-golo/settings.toml`, rempli avec le thème que vous utilisez à cet instant, et l'ouvre pour édition — coloré, puisque Turbo Golo colore le TOML :
12# turbo-golo project settings.
14# These apply to everyone who opens this project in turbo-golo. Delete this
15# file and the editor falls back to its own defaults.
19# The colour theme to start in. `turbo-golo -list-themes` lists them all.
20# A -theme flag on the command line overrides this.
21theme = "turbo-classic"
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.
26autosave = true
28# How long that while is. Any Go duration: "500ms", "2s", "1m".
29autosave_delay = "2s"
32Le 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-golo/settings.toml — autosave on (2s)`.
34Cela 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.
36L'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.
38## La sauvegarde automatique
40Elle est déjà active : le fichier qu'on vient de vous donner dit `autosave = true`.
42Tout fichier qui a un nom est écrit deux secondes après que vous ayez cessé de taper. La barre d'état affiche `Saved main.golo` au moment où cela arrive. Rien n'est écrit tant que vous tapez : chaque frappe repousse l'attente.
44Deux choses changent en conséquence, toutes deux voulues :
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.
49Un 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.
51Pour 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` :
54autosave_delay = "500ms"
57## Fixer le thème
59Donnez à `theme` un nom parmi ceux de `turbo-golo -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.
61## Essayer un autre thème sans toucher au fichier
63Passez `-theme` sur la ligne de commande. Il l'emporte sur le choix du projet, le temps de cette exécution seulement :
66turbo-golo -theme turbo-dark main.golo
69## Modifier le fichier plus tard
71**Options ▸ Project settings…** le rouvre. L'entrée est grisée dans un projet qui n'en a pas.
📦 Turbo Golo   73## Partir d'une configuration partagée
75Une équipe peut garder des configurations toutes prêtes dans un dépôt — un dossier par sorte de projet, chacun avec un `.turbo-golo` dedans. Donnez à l'éditeur l'URL du dossier, telle que le navigateur l'affiche, et il copie ce `.turbo-golo` dans le répertoire courant :
78cd mon-projet
79turbo-golo -load-config https://rickub.com/turbo-editors/configs/tree/main/golang-init
82Il affiche ce qui est arrivé et quitte ; le `turbo-golo` suivant ouvre le projet avec ces réglages, extraits et outils en vigueur. L'URL peut être sur rickub, GitHub, GitLab ou Codeberg, et pointer sur le dossier, sur le `.turbo-golo` qu'il contient, ou sur le dépôt lui-même pour sa racine sur la branche par défaut. `git` doit être installé : la récupération est un clone superficiel.
84Un projet qui a déjà un `.turbo-golo` est laissé tel quel — l'éditeur refuse plutôt que d'écraser ce que le projet a décidé. Déplacez d'abord le dossier si vous voulez le remplacer.
📦 Turbo Golo   86## Variantes
88- **Vous lancez l'éditeur depuis un sous-dossier.** Les réglages ne sont pas trouvés : seul `./.turbo-golo` est consulté, sans remontée vers la racine du projet. Lancez depuis le dossier du projet, ou passez `-theme` pour cette fois.
89- **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.
90- **Vous partagez le projet.** `.turbo-golo/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.
92## Voir aussi
94- Chaque clé, avec son type et sa valeur par défaut : [Référence des réglages de projet](../reference/project-settings.md)
95- Pourquoi le fichier n'est pas cherché dans les dossiers parents, et pourquoi l'autosave attend : [Réglages de projet](../explanation/project-settings.md)
96- Écrire un thème à fixer : [Écrire son propre thème](write-a-theme.md)

📦 Turbo Golo d710c1b k33g yesterday	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 Golo 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-golo/settings.toml`, rempli avec le thème que vous utilisez à cet instant, et l'ouvre pour édition — coloré, puisque Turbo Golo colore le TOML :
	10
	11	```toml
	12	# turbo-golo project settings.
	13	#
	14	# These apply to everyone who opens this project in turbo-golo. Delete this
	15	# file and the editor falls back to its own defaults.
	16
	17	[editor]
	18
	19	# The colour theme to start in. `turbo-golo -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-golo/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.golo` 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-golo -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-golo -theme turbo-dark main.golo
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
📦 Turbo Golo b2b07ec k33g 14h ago	73	## Partir d'une configuration partagée
	74
	75	Une équipe peut garder des configurations toutes prêtes dans un dépôt — un dossier par sorte de projet, chacun avec un `.turbo-golo` dedans. Donnez à l'éditeur l'URL du dossier, telle que le navigateur l'affiche, et il copie ce `.turbo-golo` dans le répertoire courant :
	76
	77	```bash
	78	cd mon-projet
	79	turbo-golo -load-config https://rickub.com/turbo-editors/configs/tree/main/golang-init
	80	```
	81
	82	Il affiche ce qui est arrivé et quitte ; le `turbo-golo` suivant ouvre le projet avec ces réglages, extraits et outils en vigueur. L'URL peut être sur rickub, GitHub, GitLab ou Codeberg, et pointer sur le dossier, sur le `.turbo-golo` qu'il contient, ou sur le dépôt lui-même pour sa racine sur la branche par défaut. `git` doit être installé : la récupération est un clone superficiel.
	83
	84	Un projet qui a déjà un `.turbo-golo` est laissé tel quel — l'éditeur refuse plutôt que d'écraser ce que le projet a décidé. Déplacez d'abord le dossier si vous voulez le remplacer.
	85
📦 Turbo Golo d710c1b k33g yesterday	86	## Variantes
	87
	88	- Vous lancez l'éditeur depuis un sous-dossier. Les réglages ne sont pas trouvés : seul `./.turbo-golo` est consulté, sans remontée vers la racine du projet. Lancez depuis le dossier du projet, ou passez `-theme` pour cette fois.
	89	- 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.
	90	- Vous partagez le projet. `.turbo-golo/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.
	91
	92	## Voir aussi
	93
	94	- Chaque clé, avec son type et sa valeur par défaut : [Référence des réglages de projet](../reference/project-settings.md)
	95	- Pourquoi le fichier n'est pas cherché dans les dossiers parents, et pourquoi l'autosave attend : [Réglages de projet](../explanation/project-settings.md)
	96	- Écrire un thème à fixer : [Écrire son propre thème](write-a-theme.md)