ToothFairyAI_Public/tf_code
1
0
Fork 0
mirror of https://gitea.toothfairyai.com/ToothFairyAI/tf_code.git synced 2026-04-06 16:59:01 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
4c4e30cd714d316f44d99b91f846e2be666a26db
tf_code/packages/web/src/content/docs/it/themes.mdx
Adam 4c4e30cd71 fix(docs): locale translations
2026-02-10 07:11:19 -06:00

370 lines
9.8 KiB
Plaintext
Raw Blame History

---
title: Temi
description: Seleziona un tema integrato o definiscine uno tuo.
---
Con OpenCode puoi scegliere tra diversi temi integrati, usare un tema che si adatta al tema del tuo terminal oppure definire un tema personalizzato.
Per impostazione predefinita, OpenCode usa il tema `opencode`.
---
## Requisiti del terminal
Per visualizzare correttamente i temi con l'intera palette, il terminal deve supportare **truecolor** (colore a 24 bit). La maggior parte dei terminal moderni lo supporta di default, ma potrebbe essere necessario abilitarlo:
- **Verifica supporto**: esegui `echo $COLORTERM` - dovrebbe stampare `truecolor` o `24bit`
- **Abilita truecolor**: imposta la variabile d'ambiente `COLORTERM=truecolor` nel profilo della shell
- **Compatibilita del terminal**: assicurati che l'emulatore supporti il colore a 24 bit (la maggior parte dei terminal moderni come iTerm2, Alacritty, Kitty, Windows Terminal e le versioni recenti di GNOME Terminal)
Senza truecolor, i temi potrebbero apparire con colori meno accurati oppure fare fallback alla migliore approssimazione a 256 colori.
---
## Temi integrati
OpenCode include diversi temi integrati.
| Nome | Descrizione |
| ---------------------- | ------------------------------------------------------------------------- |
| `system` | Si adatta al colore di sfondo del terminal |
| `tokyonight` | Basato sul tema [Tokyonight](https://github.com/folke/tokyonight.nvim) |
| `everforest` | Basato sul tema [Everforest](https://github.com/sainnhe/everforest) |
| `ayu` | Basato sul tema scuro [Ayu](https://github.com/ayu-theme) |
| `catppuccin` | Basato sul tema [Catppuccin](https://github.com/catppuccin) |
| `catppuccin-macchiato` | Basato sul tema [Catppuccin](https://github.com/catppuccin) |
| `gruvbox` | Basato sul tema [Gruvbox](https://github.com/morhetz/gruvbox) |
| `kanagawa` | Basato sul tema [Kanagawa](https://github.com/rebelot/kanagawa.nvim) |
| `nord` | Basato sul tema [Nord](https://github.com/nordtheme/nord) |
| `matrix` | Tema verde su nero in stile hacker |
| `one-dark` | Basato sul tema Dark [Atom One](https://github.com/Th3Whit3Wolf/one-nvim) |
E altri ancora: aggiungiamo costantemente nuovi temi.
---
## Tema di sistema
Il tema `system` e progettato per adattarsi automaticamente allo schema colori del tuo terminal. A differenza dei temi tradizionali con colori fissi, il tema _system_:
- **Genera una scala di grigi**: crea una scala di grigi personalizzata in base al colore di sfondo del terminal, garantendo un contrasto ottimale.
- **Usa colori ANSI**: sfrutta i colori ANSI standard (0-15) per evidenziazione della sintassi ed elementi UI, rispettando la palette del terminal.
- **Preserva i default del terminal**: usa `none` per testo e sfondo per mantenere l'aspetto nativo del terminal.
Il tema di sistema e pensato per chi:
- Vuole che OpenCode corrisponda all'aspetto del terminal
- Usa schemi colori personalizzati del terminal
- Preferisce un aspetto coerente tra tutte le applicazioni da terminal
---
## Usare un tema
Puoi selezionare un tema aprendo la selezione temi con il comando `/theme`. In alternativa, puoi specificarlo nella tua [configurazione](/docs/config).
```json title="opencode.json" {3}
{
"$schema": "https://opencode.ai/config.json",
"theme": "tokyonight"
}
```
---
## Temi personalizzati
OpenCode supporta un sistema di temi flessibile basato su JSON che permette di creare e personalizzare temi facilmente.
---
### Gerarchia
I temi vengono caricati da piu directory nel seguente ordine, dove le directory successive sovrascrivono le precedenti:
1. **Temi integrati** - incorporati nel binario
2. **Directory di configurazione utente** - in `~/.config/opencode/themes/*.json` o `$XDG_CONFIG_HOME/opencode/themes/*.json`
3. **Directory root del progetto** - in `<project-root>/.opencode/themes/*.json`
4. **Directory di lavoro corrente** - in `./.opencode/themes/*.json`
Se piu directory contengono un tema con lo stesso nome, verra usato il tema della directory con priorita piu alta.
---
### Creare un tema
Per creare un tema personalizzato, crea un file JSON in una delle directory dei temi.
Per temi a livello utente:
```bash no-frame
mkdir -p ~/.config/opencode/themes
vim ~/.config/opencode/themes/my-theme.json
```
E per temi specifici del progetto.
```bash no-frame
mkdir -p .opencode/themes
vim .opencode/themes/my-theme.json
```
---
### Formato JSON
I temi usano un formato JSON flessibile che supporta:
- **Colori hex**: `"#ffffff"`
- **Colori ANSI**: `3` (0-255)
- **Riferimenti colore**: `"primary"` o definizioni personalizzate
- **Varianti scuro/chiaro**: `{"dark": "#000", "light": "#fff"}`
- **Nessun colore**: `"none"` - usa il colore predefinito del terminal o trasparente
---
### Definizioni dei colori
La sezione `defs` e opzionale e ti permette di definire colori riutilizzabili che possono essere referenziati nel tema.
---
### Valori predefiniti del terminal
Il valore speciale `"none"` puo essere usato per qualunque colore per ereditare il colore predefinito del terminal. E particolarmente utile per creare temi che si fondono con lo schema colori del terminal:
- `"text": "none"` - usa il colore del testo predefinito del terminal
- `"background": "none"` - usa il colore di sfondo predefinito del terminal
---
### Esempio
Ecco un esempio di tema personalizzato:
```json title="my-theme.json"
{
"$schema": "https://opencode.ai/theme.json",
"defs": {
"nord0": "#2E3440",
"nord1": "#3B4252",
"nord2": "#434C5E",
"nord3": "#4C566A",
"nord4": "#D8DEE9",
"nord5": "#E5E9F0",
"nord6": "#ECEFF4",
"nord7": "#8FBCBB",
"nord8": "#88C0D0",
"nord9": "#81A1C1",
"nord10": "#5E81AC",
"nord11": "#BF616A",
"nord12": "#D08770",
"nord13": "#EBCB8B",
"nord14": "#A3BE8C",
"nord15": "#B48EAD"
},
"theme": {
"primary": {
"dark": "nord8",
"light": "nord10"
},
"secondary": {
"dark": "nord9",
"light": "nord9"
},
"accent": {
"dark": "nord7",
"light": "nord7"
},
"error": {
"dark": "nord11",
"light": "nord11"
},
"warning": {
"dark": "nord12",
"light": "nord12"
},
"success": {
"dark": "nord14",
"light": "nord14"
},
"info": {
"dark": "nord8",
"light": "nord10"
},
"text": {
"dark": "nord4",
"light": "nord0"
},
"textMuted": {
"dark": "nord3",
"light": "nord1"
},
"background": {
"dark": "nord0",
"light": "nord6"
},
"backgroundPanel": {
"dark": "nord1",
"light": "nord5"
},
"backgroundElement": {
"dark": "nord1",
"light": "nord4"
},
"border": {
"dark": "nord2",
"light": "nord3"
},
"borderActive": {
"dark": "nord3",
"light": "nord2"
},
"borderSubtle": {
"dark": "nord2",
"light": "nord3"
},
"diffAdded": {
"dark": "nord14",
"light": "nord14"
},
"diffRemoved": {
"dark": "nord11",
"light": "nord11"
},
"diffContext": {
"dark": "nord3",
"light": "nord3"
},
"diffHunkHeader": {
"dark": "nord3",
"light": "nord3"
},
"diffHighlightAdded": {
"dark": "nord14",
"light": "nord14"
},
"diffHighlightRemoved": {
"dark": "nord11",
"light": "nord11"
},
"diffAddedBg": {
"dark": "#3B4252",
"light": "#E5E9F0"
},
"diffRemovedBg": {
"dark": "#3B4252",
"light": "#E5E9F0"
},
"diffContextBg": {
"dark": "nord1",
"light": "nord5"
},
"diffLineNumber": {
"dark": "nord2",
"light": "nord4"
},
"diffAddedLineNumberBg": {
"dark": "#3B4252",
"light": "#E5E9F0"
},
"diffRemovedLineNumberBg": {
"dark": "#3B4252",
"light": "#E5E9F0"
},
"markdownText": {
"dark": "nord4",
"light": "nord0"
},
"markdownHeading": {
"dark": "nord8",
"light": "nord10"
},
"markdownLink": {
"dark": "nord9",
"light": "nord9"
},
"markdownLinkText": {
"dark": "nord7",
"light": "nord7"
},
"markdownCode": {
"dark": "nord14",
"light": "nord14"
},
"markdownBlockQuote": {
"dark": "nord3",
"light": "nord3"
},
"markdownEmph": {
"dark": "nord12",
"light": "nord12"
},
"markdownStrong": {
"dark": "nord13",
"light": "nord13"
},
"markdownHorizontalRule": {
"dark": "nord3",
"light": "nord3"
},
"markdownListItem": {
"dark": "nord8",
"light": "nord10"
},
"markdownListEnumeration": {
"dark": "nord7",
"light": "nord7"
},
"markdownImage": {
"dark": "nord9",
"light": "nord9"
},
"markdownImageText": {
"dark": "nord7",
"light": "nord7"
},
"markdownCodeBlock": {
"dark": "nord4",
"light": "nord0"
},
"syntaxComment": {
"dark": "nord3",
"light": "nord3"
},
"syntaxKeyword": {
"dark": "nord9",
"light": "nord9"
},
"syntaxFunction": {
"dark": "nord8",
"light": "nord8"
},
"syntaxVariable": {
"dark": "nord7",
"light": "nord7"
},
"syntaxString": {
"dark": "nord14",
"light": "nord14"
},
"syntaxNumber": {
"dark": "nord15",
"light": "nord15"
},
"syntaxType": {
"dark": "nord7",
"light": "nord7"
},
"syntaxOperator": {
"dark": "nord9",
"light": "nord9"
},
"syntaxPunctuation": {
"dark": "nord4",
"light": "nord0"
}
}
}
```
Reference in New Issue View Git Blame Copy Permalink