@neurocode-ai/web 1.18.8

package/src/content/docs/fr/tui.mdx

@@ -0,0 +1,429 @@
+---
+title: TUI
+description: Utilisation de l’interface utilisateur du terminal OpenCode.
+---
+
+import { Tabs, TabItem } from "@astrojs/starlight/components"
+
+OpenCode fournit une interface de terminal interactif ou TUI pour travailler sur vos projets avec un LLM.
+
+L’exécution de OpenCode démarre le TUI pour le répertoire actuel.
+
+```bash
+opencode
+```
+
+Ou vous pouvez le démarrer pour un répertoire de travail spécifique.
+
+```bash
+opencode /path/to/project
+```
+
+Une fois que vous êtes dans le TUI, vous pouvez lui envoyer un message.
+
+```text
+Give me a quick summary of the codebase.
+```
+
+---
+
+## Références de fichiers
+
+Vous pouvez référencer des fichiers dans vos messages en utilisant `@`. Cela effectue une recherche de fichier floue dans le répertoire de travail actuel.
+
+:::tip
+Vous pouvez également utiliser `@` pour référencer des fichiers dans vos messages.
+:::
+
+```text "@packages/functions/src/api/index.ts"
+How is auth handled in @packages/functions/src/api/index.ts?
+```
+
+Le contenu du fichier est automatiquement ajouté à la conversation.
+
+---
+
+## Commandes Bash
+
+Démarrez un message avec `!` pour exécuter une commande shell.
+
+```bash frame="none"
+!ls -la
+```
+
+Le résultat de la commande est ajouté à la conversation en tant que résultat de l'outil.
+
+---
+
+## Commandes
+
+Lorsque vous utilisez le OpenCode TUI, vous pouvez taper `/` suivi d'un nom de commande pour exécuter rapidement des actions. Par exemple:
+
+```bash frame="none"
+/help
+```
+
+La plupart des commandes ont également une liaison clavier utilisant `ctrl+x` comme touche leader, où `ctrl+x` est la touche leader par défaut. [En savoir plus](/docs/keybinds).
+
+Voici toutes les commandes slash disponibles :
+
+---
+
+### connect
+
+Ajoutez un fournisseur à OpenCode. Vous permet de sélectionner parmi les fournisseurs disponibles et d’ajouter leurs clés API.
+
+```bash frame="none"
+/connect
+```
+
+---
+
+### compact
+
+Compactez la session en cours. *Alias* : `/summarize`
+
+```bash frame="none"
+/compact
+```
+
+**Reliure de touches :** `ctrl+x c`
+
+---
+
+### details
+
+Basculer les détails d'exécution de l'outil.
+
+```bash frame="none"
+/details
+```
+
+**Reliure de touches :** `ctrl+x d`
+
+---
+
+### editor
+
+Ouvrez un éditeur externe pour rédiger des messages. Utilise l'éditeur défini dans votre variable d'environnement `EDITOR`. [En savoir plus](#editor-setup).
+
+```bash frame="none"
+/editor
+```
+
+**Reliure de touches :** `ctrl+x e`
+
+---
+
+### exit
+
+Quittez OpenCode. *Alias* : `/quit`, `/q`
+
+```bash frame="none"
+/exit
+```
+
+**Reliure de touches :** `ctrl+x q`
+
+---
+
+### export
+
+Exportez la conversation en cours vers Markdown et ouvrez-la dans votre éditeur par défaut. Utilise l'éditeur défini dans votre variable d'environnement `EDITOR`. [En savoir plus](#editor-setup).
+
+```bash frame="none"
+/export
+```
+
+**Reliure de touches :** `ctrl+x x`
+
+---
+
+### help
+
+Afficher la boîte de dialogue d'aide.
+
+```bash frame="none"
+/help
+```
+
+**Reliure de touches :** `ctrl+x h`
+
+---
+
+### init
+
+Créez ou mettez à jour le fichier `AGENTS.md`. [En savoir plus](/docs/rules).
+
+```bash frame="none"
+/init
+```
+
+**Reliure de touches :** `ctrl+x i`
+
+---
+
+### models
+
+Liste des modèles disponibles.
+
+```bash frame="none"
+/models
+```
+
+**Reliure de touches :** `ctrl+x m`
+
+---
+
+### new
+
+Démarrez une nouvelle session. *Alias* : `/clear`
+
+```bash frame="none"
+/new
+```
+
+**Reliure de touches :** `ctrl+x n`
+
+---
+
+### redo
+
+Refaire un message précédemment annulé. Disponible uniquement après avoir utilisé `/undo`.
+
+:::tip
+Toutes les modifications de fichiers seront également restaurées.
+:::
+
+En interne, cela utilise Git pour gérer les modifications de fichiers. Votre projet **doit donc
+être un dépôt Git**.
+
+```bash frame="none"
+/redo
+```
+
+**Reliure de touches :** `ctrl+x r`
+
+---
+
+### sessions
+
+Répertoriez et basculez entre les sessions. *Alias* : `/resume`, `/continue`
+
+```bash frame="none"
+/sessions
+```
+
+**Reliure de touches :** `ctrl+x l`
+
+---
+
+### share
+
+Partager la session en cours. [En savoir plus](/docs/share).
+
+```bash frame="none"
+/share
+```
+
+**Reliure de touches :** `ctrl+x s`
+
+---
+
+### theme
+
+Répertoriez les thèmes disponibles.
+
+```bash frame="none"
+/theme
+```
+
+**Reliure de touches :** `ctrl+x t`
+
+---
+
+### thinking
+
+Activez/désactivez la visibilité des blocages de réflexion/raisonnement dans la conversation. Lorsque cette option est activée, vous pouvez voir le processus de raisonnement du modèle pour les modèles prenant en charge la réflexion étendue.
+
+:::note
+Cette commande contrôle uniquement si les blocs de réflexion sont **affichés** ; elle n'active ni ne désactive les capacités de raisonnement du modèle. Pour basculer entre les capacités de raisonnement réelles, utilisez `ctrl+t` pour parcourir les variantes du modèle.
+:::
+
+```bash frame="none"
+/thinking
+```
+
+---
+
+### undo
+
+Annuler le dernier message de la conversation. Supprime le message utilisateur le plus récent, toutes les réponses ultérieures et toutes les modifications de fichier.
+
+:::tip
+Toutes les modifications apportées au fichier seront également annulées.
+:::
+
+En interne, cela utilise Git pour gérer les modifications de fichiers. Votre projet **doit donc
+être un dépôt Git**.
+
+```bash frame="none"
+/undo
+```
+
+**Reliure de touches :** `ctrl+x u`
+
+---
+
+### unshare
+
+Annuler le partage de la session en cours. [En savoir plus](/docs/share#un-sharing).
+
+```bash frame="none"
+/unshare
+```
+
+---
+
+## Configuration de l'éditeur
+
+Les commandes `/editor` et `/export` utilisent l'éditeur spécifié dans votre variable d'environnement `EDITOR`.
+
+<Tabs>
+  <TabItem label="Linux/macOS">
+    ```bash
+    # Example for nano or vim
+    export EDITOR=nano
+    export EDITOR=vim
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    export EDITOR="code --wait"
+    ```
+
+Pour le rendre permanent, ajoutez-le à votre profil shell ;
+`~/.bashrc`, `~/.zshrc`, etc.
+
+  </TabItem>
+
+  <TabItem label="Windows (CMD)">
+    ```bash
+    set EDITOR=notepad
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    set EDITOR=code --wait
+    ```
+
+Pour le rendre permanent, utilisez **Propriétés système** > **Environnement
+Variables**.
+
+  </TabItem>
+
+  <TabItem label="Windows (PowerShell)">
+    ```powershell
+    $env:EDITOR = "notepad"
+
+    # For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
+    # include --wait
+    $env:EDITOR = "code --wait"
+    ```
+
+Pour le rendre permanent, ajoutez-le à votre profil PowerShell.
+
+  </TabItem>
+</Tabs>
+
+Les options d'éditeur populaires incluent :
+
+- `code`-Code Visual Studio
+- `cursor` - Curseur
+- `windsurf` - Planche à voile
+- `nvim` - Editeur Neovim
+- `vim` - Éditeur Vim
+- `nano` - Éditeur nano
+- `notepad` - Windows Bloc-notes
+- `subl` - Texte sublime
+
+:::note
+Certains éditeurs comme VS Code doivent être démarrés avec le drapeau `--wait`.
+:::
+
+Certains éditeurs ont besoin d'arguments de ligne de commande pour s'exécuter en mode blocage. L'indicateur `--wait` bloque le processus de l'éditeur jusqu'à sa fermeture.
+
+---
+
+## Configurer
+
+Vous pouvez personnaliser le comportement de TUI via `tui.json` (ou `tui.jsonc`).
+
+```json title="tui.json"
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "theme": "opencode",
+  "leader_timeout": 2000,
+  "keybinds": {
+    "leader": "ctrl+x",
+    "command_list": "ctrl+p"
+  },
+  "scroll_speed": 3,
+  "scroll_acceleration": {
+    "enabled": false
+  },
+  "diff_style": "auto",
+  "mouse": true,
+  "attention": {
+    "enabled": true,
+    "notifications": true,
+    "sound": true,
+    "volume": 0.4,
+    "sound_pack": "opencode.default",
+    "sounds": {
+      "error": "./sounds/error.mp3"
+    }
+  }
+}
+```
+
+Ceci est séparé de `opencode.json`, qui configure le comportement du serveur/d'exécution.
+
+`keybinds` est fusionné avec les valeurs par défaut intégrées, vous ne devez donc configurer que les raccourcis que vous souhaitez modifier.
+
+### Options
+
+- `theme` - Définit votre thème d'interface utilisateur. [En savoir plus](/docs/themes).
+- `keybinds` - Personnalise les raccourcis clavier. [En savoir plus](/docs/keybinds).
+- `leader_timeout` - Contrôle la durée pendant laquelle OpenCode attend après la leader key. Valeur par défaut : `2000`.
+- `scroll_acceleration.enabled` - Activez l'accélération de défilement de style macOS pour un défilement fluide et naturel. Lorsqu'elle est activée, la vitesse de défilement augmente avec les gestes de défilement rapides et reste précise pour les mouvements plus lents. **Ce paramètre est prioritaire sur `scroll_speed` et le remplace lorsqu'il est activé.**
+- `scroll_speed` - Contrôle la vitesse de défilement du TUI lors de l'utilisation des commandes de défilement (minimum : `0.001`, prend en charge les valeurs décimales). La valeur par défaut est `3`. **Remarque : Ceci est ignoré si `scroll_acceleration.enabled` est défini sur `true`.**
+- `diff_style` - Contrôle le rendu différentiel. `"auto"` s'adapte à la largeur du terminal, `"stacked"` affiche toujours une seule colonne.
+- `mouse` - Active ou désactive la capture de la souris dans le TUI (valeur par défaut : `true`). Lorsque cette option est désactivée, le comportement natif du terminal pour la sélection et le défilement à la souris est conservé.
+- `attention` - Configure les notifications de bureau et les sons du TUI. Désactivé par défaut.
+
+Utilisez `OPENCODE_TUI_CONFIG` pour charger un chemin de configuration TUI personnalisé.
+
+### Attention
+
+Attention permet au TUI de vous prévenir quand OpenCode attend une réponse, une autorisation, qu'une erreur de session doit être consultée ou qu'une session est terminée. Activez-le avec `attention.enabled` ; les événements intégrés jouent un son lorsqu'ils se produisent. Les notifications de bureau ne sont envoyées que lorsque la fenêtre du terminal n'est pas au premier plan, et elles ne sont pas utilisées pour les événements de subagent.
+
+- `enabled` - Active toutes les notifications et tous les sons d'Attention. Valeur par défaut : `false`.
+- `notifications` - Lorsque Attention est activé, autorise le TUI à envoyer des notifications de bureau via le terminal. Valeur par défaut : `true`.
+- `sound` - Lorsque Attention est activé, autorise la lecture des sons d'alerte. Valeur par défaut : `true`.
+- `volume` - Volume par défaut des sons, de `0` à `1`. Valeur par défaut : `0.4`.
+- `sound_pack` - ID du sound pack à utiliser. Valeur par défaut : `opencode.default`.
+- `sounds` - Définit des fichiers sonores personnalisés pour `default`, `question`, `permission`, `error`, `done` ou `subagent_done`. Les chemins peuvent être absolus, des URL `file://` ou relatifs à `tui.json`.
+
+---
+
+## Personnalisation
+
+Vous pouvez personnaliser divers aspects de la vue TUI à l'aide de la palette de commandes (`ctrl+x h` ou `/help`). Ces paramètres persistent lors des redémarrages.
+
+---
+
+#### Affichage du nom d'utilisateur
+
+Indiquez si votre nom d'utilisateur apparaît dans les messages de discussion. Accédez-y via :
+
+- Palette de commandes : recherchez "nom d'utilisateur" ou "masquer le nom d'utilisateur"
+- Le paramètre persiste automatiquement et sera mémorisé au cours de TUI sessions.

package/src/content/docs/fr/web.mdx

@@ -0,0 +1,142 @@
+---
+title: Web
+description: En utilisant OpenCode dans votre navigateur.
+---
+
+OpenCode peut s'exécuter comme une application Web dans votre navigateur, offrant la même expérience puissante de codage d'IA sans avoir besoin d'un terminal.
+
+![OpenCode Web - Nouvelle session](../../../assets/web/web-homepage-new-session.png)
+
+## Commencer
+
+Démarrez l'interface Web en exécutant :
+
+```bash
+opencode web
+```
+
+Cela démarre un serveur local sur `127.0.0.1` avec un port disponible aléatoire et ouvre automatiquement OpenCode dans votre navigateur par défaut.
+
+:::caution
+Si `OPENCODE_SERVER_PASSWORD` n'est pas défini, le serveur ne sera pas sécurisé. C'est bien pour une utilisation locale mais doit être défini pour l'accès au réseau.
+:::
+
+:::tip[Windows Utilisateurs]
+Pour une expérience optimale, exécutez `opencode web` à partir de [WSL](/docs/windows-wsl) plutôt que de PowerShell. Cela garantit un accès correct au système de fichiers et une intégration du terminal.
+:::
+
+---
+
+## Configuration
+
+Vous pouvez configurer le serveur Web à l'aide d'indicateurs de ligne de commande ou dans votre [fichier de configuration](/docs/config).
+
+### Port
+
+Par défaut, OpenCode sélectionne un port disponible. Vous pouvez spécifier un port :
+
+```bash
+opencode web --port 4096
+```
+
+### Nom d'hôte
+
+Par défaut, le serveur se lie à `127.0.0.1` (localhost uniquement). Pour rendre OpenCode accessible sur votre réseau :
+
+```bash
+opencode web --hostname 0.0.0.0
+```
+
+Lorsque vous utilisez `0.0.0.0`, OpenCode affichera les adresses locales et réseau :
+
+```
+  Local access:       http://localhost:4096
+  Network access:     http://192.168.1.100:4096
+```
+
+### Découverte mDNS
+
+Activez mDNS pour rendre votre serveur visible sur le réseau local :
+
+```bash
+opencode web --mdns
+```
+
+Cela définit automatiquement le nom d'hôte sur `0.0.0.0` et annonce le serveur comme `opencode.local`.
+
+Vous pouvez personnaliser le nom de domaine mDNS pour exécuter plusieurs instances sur le même réseau :
+
+```bash
+opencode web --mdns --mdns-domain myproject.local
+```
+
+### CORS
+
+Pour autoriser des domaines supplémentaires pour CORS (utile pour les frontends personnalisés) :
+
+```bash
+opencode web --cors https://example.com
+```
+
+### Authentification
+
+Pour protéger l'accès, définissez un mot de passe à l'aide de la variable d'environnement `OPENCODE_SERVER_PASSWORD` :
+
+```bash
+OPENCODE_SERVER_PASSWORD=secret opencode web
+```
+
+Le nom d'utilisateur par défaut est `opencode` mais peut être modifié avec `OPENCODE_SERVER_USERNAME`.
+
+---
+
+## Utilisation de l'interface Web
+
+Une fois démarrée, l'interface web permet d'accéder à vos sessions OpenCode.
+
+### Sessions
+
+Consultez et gérez vos sessions depuis la page d'accueil. Vous pouvez voir les sessions actives et en démarrer de nouvelles.
+
+![OpenCode Web - Session active](../../../assets/web/web-homepage-active-session.png)
+
+### Statut du serveur
+
+Cliquez sur "Voir les serveurs" pour afficher les serveurs connectés et leur état.
+
+![OpenCode Web - Voir Serveurs](../../../assets/web/web-homepage-see-servers.png)
+
+---
+
+## Attacher un terminal
+
+Vous pouvez connecter un terminal TUI à un serveur Web en cours d'exécution :
+
+```bash
+# Start the web server
+opencode web --port 4096
+
+# In another terminal, attach the TUI
+opencode attach http://localhost:4096
+```
+
+Cela vous permet d'utiliser simultanément l'interface Web et le terminal, en partageant les mêmes sessions et le même état.
+
+---
+
+## Fichier de configuration
+
+Vous pouvez également configurer les paramètres du serveur dans votre fichier de configuration `opencode.json` :
+
+```json
+{
+  "server": {
+    "port": 4096,
+    "hostname": "0.0.0.0",
+    "mdns": true,
+    "cors": ["https://example.com"]
+  }
+}
+```
+
+Les indicateurs de ligne de commande ont priorité sur les paramètres du fichier de configuration.

package/src/content/docs/fr/windows-wsl.mdx

@@ -0,0 +1,113 @@
+---
+title: Windows (WSL)
+description: Exécutez OpenCode sur Windows avec WSL pour une expérience optimale.
+---
+
+import { Steps } from "@astrojs/starlight/components"
+
+Même si OpenCode peut fonctionner directement sur Windows, nous recommandons d'utiliser [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) pour la meilleure expérience. WSL fournit un environnement Linux qui s'intègre parfaitement aux fonctionnalités d'OpenCode.
+
+:::tip[Pourquoi WSL?]
+WSL offre de meilleures performances du système de fichiers, une prise en charge complète du terminal et la compatibilité avec les outils de développement dont OpenCode dépend.
+:::
+
+---
+
+## Configuration
+
+<Steps>
+
+1. **Installez WSL**
+
+   Si ce n'est pas encore fait, [installez WSL](https://learn.microsoft.com/en-us/windows/wsl/install) à l'aide du guide officiel Microsoft.
+
+2. **Installez OpenCode dans WSL**
+
+   Une fois WSL configuré, ouvrez votre terminal WSL et installez OpenCode avec l'une des [méthodes d'installation](/docs/).
+
+   ```bash
+   curl -fsSL https://opencode.ai/install | bash
+   ```
+
+3. **Utilisez OpenCode depuis WSL**
+
+   Allez dans votre dossier de projet (accédez aux fichiers Windows via `/mnt/c/`, `/mnt/d/`, etc.) et lancez OpenCode.
+
+   ```bash
+   cd /mnt/c/Users/YourName/project
+   opencode
+   ```
+
+</Steps>
+
+---
+
+## Application bureau + serveur WSL
+
+Si vous préférez utiliser l'application Desktop OpenCode tout en exécutant le serveur dans WSL:
+
+1. **Démarrez le serveur dans WSL** avec `--hostname 0.0.0.0` pour autoriser les connexions externes:
+
+   ```bash
+   opencode serve --hostname 0.0.0.0 --port 4096
+   ```
+
+2. **Connectez l'application Desktop** à `http://localhost:4096`
+
+:::note
+Si `localhost` ne fonctionne pas dans votre configuration, utilisez plutôt l'adresse IP WSL (depuis WSL: `hostname -I`) et `http://<wsl-ip>:4096`.
+:::
+
+:::caution
+Lorsque vous utilisez `--hostname 0.0.0.0`, définissez `OPENCODE_SERVER_PASSWORD` pour sécuriser le serveur.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
+```
+
+:::
+
+---
+
+## Client web + WSL
+
+Pour la meilleure expérience web sous Windows:
+
+1. **Exécutez `opencode web` dans le terminal WSL** plutôt que dans PowerShell:
+
+   ```bash
+   opencode web --hostname 0.0.0.0
+   ```
+
+2. **Accédez-y depuis votre navigateur Windows** à `http://localhost:<port>` (OpenCode affiche l'URL)
+
+Lancer `opencode web` depuis WSL garantit un accès correct au système de fichiers et une bonne intégration terminal, tout en restant accessible depuis votre navigateur Windows.
+
+---
+
+## Accéder aux fichiers Windows
+
+WSL peut accéder à tous vos fichiers Windows via le répertoire `/mnt/`:
+
+- Lecteur `C:` → `/mnt/c/`
+- Lecteur `D:` → `/mnt/d/`
+- Et ainsi de suite...
+
+Exemple:
+
+```bash
+cd /mnt/c/Users/YourName/Documents/project
+opencode
+```
+
+:::tip
+Pour une expérience plus fluide, vous pouvez cloner/copier votre dépôt dans le système de fichiers WSL (par exemple sous `~/code/`) et y exécuter OpenCode.
+:::
+
+---
+
+## Conseils
+
+- Gardez OpenCode dans WSL pour les projets stockés sur des lecteurs Windows: l'accès aux fichiers est fluide
+- Utilisez l'[extension WSL de VS Code](https://code.visualstudio.com/docs/remote/wsl) avec OpenCode pour un flux de travail intégré
+- Votre configuration OpenCode et vos sessions sont stockées dans l'environnement WSL à `~/.local/share/opencode/`