Vous avez remarqué que certains termes techniques utilisés dans vos interfaces domotiques (Shelly, Victron) ou vos onduleurs solaires (Huawei, Fronius) ne sont pas disponibles en bulgare, ou que leur traduction littérale (« slut » → « проститутка », « hoe » → « плуг ») n’est pas adaptée à un contexte technique ? Ce tutoriel vous guide pour :
- Identifier les termes à traduire dans vos systèmes.
- Utiliser des outils de traduction technique pour des équivalents précis.
- Intégrer ces traductions dans vos interfaces via des solutions logicielles existantes.
Nous éviterons les pièges culturels et garantirons une compatibilité totale avec vos protocoles (MODBUS, MQTT, etc.).
🔍 Contexte : Pourquoi traduire ces termes dans un système solaire/domotique ?
Les interfaces utilisateur (UI) de vos équipements (ex: Shelly Plug S, Victron Cerbo GX) ou vos logiciels de monitoring (ex: Huawei SUN2000) peuvent nécessiter des labels en bulgare pour :
- Respecter les réglementations locales (ex: règles bulgares sur l’étiquetage).
- Faciliter l’adoption par des clients bulgares (ex: agriculteurs utilisant des pompes solaires pour l’irrigation).
- Éviter les malentendus dans les logs techniques (ex: nommer correctement un « mode de fail-safe » en bulgare technique).
Attention : Certains termes comme « slut » ou « hoe » n’ont pas d’équivalent direct dans un contexte technique. Nous les remplacerons par des termes neutres et professionnels.
🛠️ LE MATÉRIEL REQUIS
- Équipement domotique/solaire existant :
- Shelly Plug S / Shelly EM (pour les automations locales).
- Victron Cerbo GX / VE.Bus (pour les systèmes hybrides).
- Onduleur Huawei SUN2000 ou Fronius Gen24 (pour le monitoring).
- Logiciels de traduction technique :
- Outils de développement :
- Node-RED (pour les flux MQTT personnalisés).
- Python 3.9+ (pour automatiser les traductions via API).
📝 ÉTAPE 1 : Identifier les termes à traduire dans votre système
Avant de traduire, listez tous les termes anglais dans vos interfaces qui pourraient poser problème. Exemples courants :
| Terme anglais | Contexte d’utilisation | Problème potentiel |
|---|---|---|
| « Slut » | Nom d’un mode de fail-safe dans un Shelly Plug (ex: « Slut Mode = Auto-Reset »). | Terme offensant en bulgare (« проститутка » est trop fort). |
| « Hoe » | Nom d’un paramètre dans une pompe solaire (ex: « Hoe Depth = 1.2m »). | Confusion avec l’outil agricole (« плуг » n’est pas technique). |
| « Overload » | Message d’erreur dans un Victron Cerbo GX. | Traduction littérale (« претоварка ») peut être ambiguë. |
Action :
- Ouvrez votre interface utilisateur (ex: Shelly Cloud ou Victron VEConfigure).
- Notez dans un tableau Excel tous les termes anglais non traduits ou mal adaptés, avec leur contexte (ex: « Batterie status » dans un Huawei SUN2000).
- Consultez les normes bulgares pour les termes obligatoires (ex: « Соларна инсталация » pour « Solar installation »).
🌐 ÉTAPE 2 : Traduire les termes avec précision (éviter les faux amis)
Utilisez des outils spécialisés pour éviter les erreurs culturelles. Voici comment procéder :
-
Pour les termes techniques généraux :
- Utilisez TermCoord pour trouver des équivalents validés (ex: « Overload » → « Претоварка » ou « Прекомерна натовареност »).
- Vérifiez dans le glossaire technique bulgare de Wikipédia.
-
Pour les termes spécifiques à votre équipement :
- Consultez la documentation Shelly ou Victron pour voir si le fabricant propose déjà une traduction partielle.
- Utilisez DeepL Pro avec le mode « Technical » activé. Exemple :
- Entrée : « Slut Mode = Auto-Reset »
- Traduction DeepL : « Режим на прекомерна натовареност = Автоматично презареждане »
- Version optimisée (SolarLogik) : « Режим на аварийно прекъсване = Автоматично възстановяване »
-
Pour les termes agricoles (ex: « hoe ») :
- Évitez les termes littéraux comme « плуг » (charrues).
- Préférez des termes neutres :
- « Hoe Depth » → « Гъбина на обработка »
- « Hoe Mode » → « Режим на обработка »
- Si le terme concerne une pompe solaire pour irrigation, utilisez :
- « Irrigation Depth » → « Гъбина на напояване »
💻 ÉTAPE 3 : Intégrer les traductions dans votre système
Selon votre équipement, plusieurs méthodes existent pour appliquer les traductions. Voici les solutions adaptées aux marques citées :
-
Pour les Shelly (via Shelly Cloud ou Node-RED) :
- Accédez à Shelly Cloud et allez dans « Settings » > « Language ».
- Téléchargez le fichier de langue bulgare existant (si disponible) ou créez-en un nouveau via Poedit.
- Modifiez les clés pour vos termes spécifiques :
- Ouvrez le fichier JSON (ex: `shelly_bg.json`).
- Ajoutez ou modifiez :
{"slut_mode": "Режим на аварийно прекъсване", "overload_warning": "Прекомерна натовареност - изключете натоварването"} - Téléchargez le fichier mis à jour dans Shelly Cloud.
- Pour les automations locales (ex: Shelly EM), utilisez Node-RED avec un nœud « Function » pour traduire dynamiquement :
function translate(engTerm) { const translations = { "slut_mode": "Режим на аварийно прекъсване", "hoe_depth": "Гъбина на обработка" }; return translations[engTerm] || engTerm; } msg.payload = translate(msg.payload); return msg;
-
Pour les Victron (VE.Bus ou Cerbo GX) :
- Utilisez Victron VEConfigure pour configurer les labels en bulgare.
- Pour les messages d’erreur personnalisés, éditez le fichier `/etc/victron/energy/errors.json` (via SSH) :
{ "overload": "Прекомерна натовареност - изключете натоварването", "battery_low": "Ниско напрежение на акумулатора - подключете заряд" } - Redémarrez le service Victron :
sudo systemctl restart victron-energy
-
Pour les onduleurs Huawei/SUN2000 :
- Les traductions sont généralement gérées via le Huawei Solar Energy Portal. Contactez le support pour demander un fichier de langue bulgare personnalisé.
- Pour les interfaces tierces (ex: SolarEdge), utilisez une API de traduction comme Microsoft Translator pour dynamiser les labels via un script Python :
import requests def translate_to_bulgarian(text): url = "https://api.cognitive.microsofttranslator.com/translate?api-version=3.0" params = {'to': ['bg'], 'api-version': '3.0'} headers = {'Ocp-Apim-Subscription-Key': 'VOTRE_CLE_API'} response = requests.post(url, params=params, headers=headers, json=[{'text': text}]) return response.json()[0]['translations'][0]['text']
⚡ ÉTAPE 4 : Tester et valider les traductions
Avant de déployer en production, suivez ces étapes de test :
- Testez chaque traduction dans un environnement de développement (ex: Shelly Plug en mode « Test »).
- Vérifiez que les messages d’erreur sont clairs et non ambiguës (ex: « Прекомерна натовареност » est mieux que « Претоварка »).
- Pour les systèmes connectés (MQTT), utilisez MQTT Explorer pour vérifier que les topics sont correctement étiquetés en bulgare.
- Implémentez un feedback loop : demandez à des locuteurs bulgares natifs de tester l’interface (ex: via un groupe Facebook d’installateurs solaires bulgares).
🔄 ÉTAPE 5 : Automatiser les mises à jour de traduction
Pour éviter de retravailler les traductions à chaque mise à jour logicielle, automatisez le processus :
- Utilisez un script Python qui :
- Récupère les nouvelles clés de traduction depuis la documentation du fabricant.
- Les traduit via l’API DeepL ou TermCoord.
- Mise à jour les fichiers de langue automatiquement (ex: via un cron job).
- Exemple de script pour Shelly :
import requests import json def update_shelly_language(): # Récupérer la liste des termes à traduire depuis une API ou un fichier terms = { "slut_mode": "Режим на аварийно прекъсване", "new_term": "Нов термин" } # Écrire dans le fichier JSON with open('shelly_bg.json', 'w') as f: json.dump(terms, f) # Déployer via API Shelly (exemple simplifié) shelly_api_url = "https://shelly.cloud/api/device/your_id/settings/language" requests.post(shelly_api_url, json={"language": "bg"}) update_shelly_language() - Pour les Victron, utilisez VEBus pour publier des mises à jour OTA.
📚 RÉFÉRENCES ET RESSOURCES
- Ministère bulgare de l’Énergie (normes techniques).
- Glossaire technique bulgare.
- Blog SolarLogik (articles sur l’internationalisation des systèmes solaires).
⚠️ PIÈGES À ÉVITER
- Traductions littérales : « Slut » → « проститутка » est inapproprié dans un contexte technique. Préférez des termes neutres comme « Режим на аварийно прекъсване ».
- Faux amis techniques : « Hoe » (outil agricole) ne doit pas être traduit par « плуг » (charrue) si le terme concerne une pompe solaire. Utilisez « Гъбина на обработка ».
- Ignorer les mises à jour logicielles : Les fichiers de langue doivent être mis à jour manuellement après chaque patch du firmware (ex: Shelly, Victron).
- Test insuffisant : Toujours faire tester par des locuteurs bulgares natifs, surtout pour les messages d’erreur critiques.
🎯 SOLUTION SOLARLOGIK : Pack Traduction Technique Multilingue
Pour gagner du temps, le Laboratoire SolarLogik propose un service clé en main :
- Audit des termes à traduire dans votre installation.
- Traduction technique validée par des ingénieurs bulgares.
- Intégration dans vos équipements (Shelly, Victron, Huawei) avec garantie de compatibilité.
- Support post-déploiement pour les mises à jour.
Contactez-nous via contact@solar-logik.com pour une devis personnalisé.
Ce tutoriel a été rédigé en réponse à un besoin technique identifié sur les forums communautaires. La solution d’ingénierie a été développée par le Laboratoire SolarLogik.
« `
🛒 Le Coin du Maker
Les indispensables pour ce projet :
Liens affiliés Amazon (Soutien gratuit).

