Traducteur de fichiers — VS Code

Extension en français pour traduire des fichiers de langue PHP, JSON et texte via un serveur LibreTranslate. Le résultat s'ouvre dans une comparaison avec une copie de l'original. Le fichier source n'est jamais écrasé automatiquement.

Démarrage

Ouvrez ce dossier dans VS Code 1.96 ou supérieur.
Appuyez sur F5 pour ouvrir la fenêtre de développement de l'extension. Aucune compilation ni dépendance npm n'est nécessaire.
Configurez fileTranslator.endpoint dans les paramètres utilisateur avec l'adresse de votre serveur LibreTranslate. Par défaut : http://localhost:5000 (le serveur doit être démarré séparément).
Si votre serveur exige une clé, lancez Traducteur : configurer la clé API depuis la palette de commandes.
Ouvrez un fichier et lancez Traducteur : traduire le fichier, ou utilisez le menu contextuel de l'éditeur.
Entrez le code de la langue cible, examinez la comparaison puis enregistrez le document de droite avec Enregistrer sous.

Pour utiliser une instance locale avec Docker installé :

docker run --rm -p 127.0.0.1:5000:5000 libretranslate/libretranslate

Le premier démarrage peut télécharger des modèles. Les langues disponibles dépendent du serveur. Une instance distante peut exiger un abonnement ou une clé ; l'extension ne fournit pas de service de traduction.

Formats

Format	Comportement
PHP / Laravel	Valeurs des tableaux `return [...]` et `return array(...)`, y compris tableaux imbriqués et listes. Clés, commentaires, booléens et nombres conservés.
PHP avec HTML (PDF, pages)	Textes visibles du HTML hors blocs PHP et des chaînes HTML concaténées, par exemple `$html = "<td>Name</td>".$row['name'];`. Attributs et code conservés.
JSON	Valeurs textuelles, y compris dans les tableaux. Clés et mise en forme conservées.
Texte `.txt`	Traduction ligne par ligne ; indentation et fins de ligne conservées.
Autres formats	Commande Traduire la sélection pour un passage de texte brut.

Exemple PHP :

<?php
return [
    'welcome' => 'Hello :name',
    'actions' => ['save' => 'Save', 'cancel' => 'Cancel'],
];

Les variables :name, {count}, {{ name }}, ${value}, les formats %s / %1$s, les balises HTML et les entités sont masqués pendant la traduction, puis rétablis. Si le service altère un marqueur, l'opération échoue sans produire de fichier partiel.

Limites de cette version

PHP : tableaux de langue statiques et HTML dans les scripts. Dans les scripts, seules les chaînes commençant par une balise HTML sont analysées ; les chaînes simples comme echo 'Hello', les interpolations, heredoc/nowdoc et les nœuds contenant des échappements PHP sont ignorés. Il ne s'agit pas d'un analyseur PHP complet. Les attributs HTML, scripts et styles ne sont pas traduits.
En PHP (tableaux)/JSON, une sélection doit englober les chaînes complètes avec leurs guillemets. Pour le HTML dans PHP, elle doit englober le libellé complet entre les balises.
Dans les autres formats, la sélection est traitée comme du texte brut : sélectionnez le texte visible, pas du code. YAML, XML, JSONC et Markdown ne disposent pas de parseur dédié.
Les messages ICU complexes et les règles de pluriel Laravel ne sont pas interprétés. Vérifiez leurs traductions avant utilisation.
Une requête par chaîne, délai maximal de 30 secondes par requête, annulation disponible. Les limites de taille dépendent du serveur.

Paramètres et données

Paramètre	Valeur par défaut
`fileTranslator.endpoint`	`http://localhost:5000`
`fileTranslator.sourceLanguage`	`auto`
`fileTranslator.targetLanguage`	`fr`

L'adresse du serveur est un paramètre utilisateur, pas un paramètre de dépôt. HTTPS est requis hors localhost. Les clés sont conservées dans SecretStorage de VS Code et associées à l'origine du serveur. Une saisie vide dans la commande de configuration supprime la clé de ce serveur.

Les textes extraits sont envoyés au serveur configuré lorsque vous lancez une traduction et validez la langue cible. L'extension n'exécute jamais les fichiers PHP et ne collecte aucune télémétrie.

Vérification et installation

npm test
npm run check
npm run package

La création du paquet utilise @vscode/vsce via npm et nécessite un accès réseau. Installez ensuite le fichier .vsix avec Extensions → … → Installer à partir d'un VSIX, puis rechargez la fenêtre. En développement avec F5, relancez la fenêtre de développement après modification du code.

Les tests couvrent l'extraction, la préservation de structure, les variables, le protocole HTTP simulé, les erreurs et l'annulation. Une validation manuelle dans VS Code avec votre serveur reste nécessaire.

Références : API LibreTranslate, développement d'une extension VS Code.

Correction 0.1.2

Le contenu PHP et HTML est reconnu même dans un fichier .txt, pour le fichier entier comme pour une sélection. Les noms de balises et tous les attributs (type, name, value, placeholder, etc.) sont exclus de la traduction. Une sélection portant uniquement sur un attribut ne produit aucune traduction. Les portions HTML qui traversent du PHP dynamique et ne peuvent pas être isolées sont ignorées.

Traducteur de fichiers

Exaland