wip(docs): i18n (#12681)

2026-04-17 22:24:29 +00:00 · 2026-02-09 11:34:35 -06:00
parent f74c0339cc
commit dc53086c1e
642 changed files with 192745 additions and 509 deletions
--- a/packages/web/src/content/docs/it/windows-wsl.mdx
+++ b/packages/web/src/content/docs/it/windows-wsl.mdx
@@ -0,0 +1,113 @@
+---
+title: Windows (WSL)
+description: Esegui OpenCode su Windows con WSL per la migliore esperienza.
+---
+
+import { Steps } from "@astrojs/starlight/components"
+
+Anche se OpenCode puo essere eseguito direttamente su Windows, consigliamo di usare [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) per la migliore esperienza. WSL fornisce un ambiente Linux che funziona in modo ottimale con le funzionalita di OpenCode.
+
+:::tip[Perche WSL?]
+WSL offre prestazioni migliori del file system, supporto completo del terminale e compatibilita con gli strumenti di sviluppo su cui OpenCode fa affidamento.
+:::
+
+---
+
+## Configurazione
+
+<Steps>
+
+1. **Installa WSL**
+
+   Se non l'hai ancora fatto, [installa WSL](https://learn.microsoft.com/en-us/windows/wsl/install) seguendo la guida ufficiale Microsoft.
+
+2. **Installa OpenCode in WSL**
+
+   Dopo aver configurato WSL, apri il terminale WSL e installa OpenCode usando uno dei [metodi di installazione](/docs/).
+
+   ```bash
+   curl -fsSL https://opencode.ai/install | bash
+   ```
+
+3. **Usa OpenCode da WSL**
+
+   Vai nella directory del progetto (accedi ai file Windows tramite `/mnt/c/`, `/mnt/d/`, ecc.) ed esegui OpenCode.
+
+   ```bash
+   cd /mnt/c/Users/YourName/project
+   opencode
+   ```
+
+</Steps>
+
+---
+
+## App desktop + server WSL
+
+Se preferisci usare l'app desktop di OpenCode ma vuoi eseguire il server in WSL:
+
+1. **Avvia il server in WSL** con `--hostname 0.0.0.0` per consentire connessioni esterne:
+
+   ```bash
+   opencode serve --hostname 0.0.0.0 --port 4096
+   ```
+
+2. **Collega l'app desktop** a `http://localhost:4096`
+
+:::note
+Se `localhost` non funziona nella tua configurazione, usa l'indirizzo IP di WSL (da WSL: `hostname -I`) e collega `http://<wsl-ip>:4096`.
+:::
+
+:::caution
+Quando usi `--hostname 0.0.0.0`, imposta `OPENCODE_SERVER_PASSWORD` per proteggere il server.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
+```
+
+:::
+
+---
+
+## Client web + WSL
+
+Per la migliore esperienza web su Windows:
+
+1. **Esegui `opencode web` nel terminale WSL** invece che in PowerShell:
+
+   ```bash
+   opencode web --hostname 0.0.0.0
+   ```
+
+2. **Accedi dal browser Windows** su `http://localhost:<port>` (OpenCode stampa l'URL)
+
+Eseguire `opencode web` da WSL garantisce accesso corretto al file system e integrazione del terminale, restando comunque accessibile dal browser Windows.
+
+---
+
+## Accesso ai file Windows
+
+WSL puo accedere a tutti i file Windows tramite la directory `/mnt/`:
+
+- Unita `C:` → `/mnt/c/`
+- Unita `D:` → `/mnt/d/`
+- E cosi via...
+
+Esempio:
+
+```bash
+cd /mnt/c/Users/YourName/Documents/project
+opencode
+```
+
+:::tip
+Per un'esperienza piu fluida, valuta di clonare o copiare il repository nel file system di WSL (per esempio in `~/code/`) ed eseguire OpenCode li.
+:::
+
+---
+
+## Suggerimenti
+
+- Tieni OpenCode in esecuzione su WSL per i progetti salvati su unita Windows: l'accesso ai file e immediato
+- Usa l'[estensione WSL di VS Code](https://code.visualstudio.com/docs/remote/wsl) insieme a OpenCode per un flusso di lavoro integrato
+- Configurazione e sessioni di OpenCode sono salvate nell'ambiente WSL in `~/.local/share/opencode/`