🐛 Dépannage de BuxarTranslate

Fichier: troubleshooting.html
But: Résolution de problèmes courants et erreurs

🚨 Problèmes Courants et Solutions

❌ La traduction ne fonctionne pas - pas de réaction à la sélection du menu
Causes possibles et solutions:
  1. Vérifier la connexion Internet - l'extension nécessite l'accès à Google Translate API
  2. S'assurer que le texte est sélectionné - sélectionnez le texte dans l'email avant d'appeler le menu contextuel
  3. Vérifier la console du navigateur - ouvrez les Outils de Développement (Ctrl+Shift+J) pour voir les erreurs
  4. Recharger l'extension - retournez à about:debugging et rechargez l'extension
❌ Le menu contextuel n'apparaît pas
Solution:
  1. Recharger l'extension - dans about:debugging cliquez sur "Reload"
  2. Vérifier les paramètres de langue - assurez-vous que la langue de traduction correcte est sélectionnée dans le popup
  3. Réinstaller l'extension - supprimez et réinstallez l'extension
  4. Vérifier les permissions - assurez-vous que l'extension a la permission "menus"
❌ La fenêtre de traduction ne se ferme pas automatiquement
Solution:
  1. Appuyer sur le bouton "Fermer" manuellement - utilisez le bouton de fermeture dans la fenêtre de traduction
  2. Utiliser la touche Échap - appuyez sur Échap pour une fermeture immédiate
  3. Vérifier les paramètres de temps - dans le popup assurez-vous que le temps d'affichage correct est défini
  4. Redémarrer Thunderbird - parfois le redémarrage de l'application aide
⚠️ Le traducteur retourne l'erreur "Échec de la traduction"
Solution:
  1. Vérifier l'accès à Google Translate - assurez-vous que translate.googleapis.com est accessible
  2. Vérifier la longueur du texte - les textes très longs peuvent dépasser les limites de l'API
  3. Réessayer plus tard - problèmes temporaires possibles avec le service Google
  4. Vérifier le pare-feu - assurez-vous qu'il n'y a pas de blocage des requêtes vers l'API Google

🔧 Activer le Débogage et la Journalisation

1. Ouvrir les Outils de Développement

Dans Thunderbird ouvrez about:debugging ou appuyez sur Ctrl+Shift+J

2. Trouver l'extension BuxarTranslate

Dans la liste des extensions trouvez BuxarTranslate et cliquez sur "Inspect"

3. Ouvrir l'onglet Console

Dans la fenêtre de développement ouverte allez à l'onglet "Console"

4. Analyser les journaux

Effectuez une traduction et regardez les messages dans la console pour le diagnostic des problèmes

Messages clés dans les journaux:

// Chargement réussi "BuxarTranslate loaded" "Context menu updated: Translate to French" "Translation completed successfully" "Translation window opened with ID: 12345" // Erreurs "Translation error: Google API error: 429" "Error loading translations for fr" "Error creating menu: Missing permissions"

🔍 Diagnostic des Erreurs Courantes

Erreur 429 - Trop de Requêtes

Cause: Limite dépassée des requêtes vers Google Translate API

Solution: Attendez quelques minutes et réessayez

Erreur 403 - Interdit

Cause: Problèmes d'accès à l'API ou blocage

Solution: Vérifiez la connexion Internet et le pare-feu

Erreur de chargement des traductions

Cause: Fichier de traduction manquant pour la langue sélectionnée

Solution: Vérifiez la présence de messages.json dans _locales

L'extension ne charge pas

Cause: Erreur dans manifest.json ou incompatibilité de versions

Solution: Vérifiez la version de Thunderbird (doit être 78.0+)

🔄 Processus de Réinstallation

1. Supprimer l'extension

Allez dans Modules complémentaires → Gérer les extensions → Supprimer BuxarTranslate

2. Nettoyer les données

Redémarrez Thunderbird pour effacer les données en cache

3. Réinstaller

Installez l'extension à nouveau via le fichier .xpi ou l'installation temporaire

4. Vérifier le fonctionnement

Testez le fonctionnement de l'extension sur un email de test

📞 Support et Rapports d'Erreurs

💡 Pour assistance:
  • Vérifiez cette documentation pour la solution à votre problème
  • Activez la journalisation et fournissez les messages d'erreur
  • Décrivez les étapes pour reproduire le problème
  • Spécifiez la version de Thunderbird et le système d'exploitation
⚠️ Important: L'extension nécessite une connexion Internet stable pour le fonctionnement de Google Translate API. Avec des problèmes de réseau, les traductions ne fonctionneront pas.