Zweck: Lösung verbreiteter Probleme und Fehler
🚨 Häufige Probleme und Lösungen
- Internetverbindung prüfen - Erweiterung benötigt Zugang zu Google Translate API
- Sicherstellen, dass Text markiert ist - Markieren Sie Text in der E-Mail vor Aufruf des Kontextmenüs
- Browserkonsole prüfen - Öffnen Sie Entwicklertools (Ctrl+Shift+J) zur Fehleranzeige
- Erweiterung neu laden - Gehen Sie zurück zu about:debugging und laden Sie die Erweiterung neu
- Erweiterung neu laden - In about:debugging auf "Reload" klicken
- Spracheinstellungen prüfen - Sicherstellen, dass im Popup die korrekte Übersetzungssprache ausgewählt ist
- Erweiterung neu installieren - Erweiterung entfernen und erneut installieren
- Berechtigungen prüfen - Sicherstellen, dass Erweiterung "menus"-Berechtigung hat
- Schaltfläche "Schließen" manuell drücken - Verwenden Sie Schließschaltfläche im Übersetzungsfenster
- Escape-Taste verwenden - Esc für sofortiges Schließen drücken
- Zeiteinstellungen prüfen - Im Popup sicherstellen, dass korrekte Anzeigezeit eingestellt ist
- Thunderbird neu starten - Manchmal hilft Neustart der Anwendung
- Zugang zu Google Translate prüfen - Sicherstellen, dass translate.googleapis.com erreichbar ist
- Textlänge prüfen - Sehr lange Texte können API-Limits überschreiten
- Später erneut versuchen - Mögliche temporäre Probleme mit Google-Dienst
- Firewall prüfen - Sicherstellen, dass keine Blockierung von Google-API-Anfragen besteht
🔧 Debugging und Protokollierung aktivieren
In Thunderbird öffnen Sie about:debugging oder drücken Ctrl+Shift+J
In Erweiterungsliste BuxarTranslate finden und auf "Inspect" klicken
Im geöffneten Entwicklerfenster zum "Console"-Tab gehen
Führen Sie Übersetzung durch und sehen Sie Konsolennachrichten zur Problemdiagnose an
Wichtige Protokollnachrichten:
🔍 Diagnose häufiger Fehler
Fehler 429 - Zu viele Anfragen
Ursache: Überschrittenes Limit für Google Translate API-Anfragen
Lösung: Warten Sie einige Minuten und versuchen Sie es erneut
Fehler 403 - Verboten
Ursache: Probleme mit API-Zugang oder Blockierung
Lösung: Internetverbindung und Firewall prüfen
Fehler beim Laden von Übersetzungen
Ursache: Fehlende Übersetzungsdatei für ausgewählte Sprache
Lösung: Vorhandensein von messages.json in _locales prüfen
Erweiterung lädt nicht
Ursache: Fehler in manifest.json oder Versionsinkompatibilität
Lösung: Thunderbird-Version prüfen (sollte 78.0+ sein)
🔄 Neuinstallationsprozess
Gehen Sie zu Add-Ons → Erweiterungen verwalten → BuxarTranslate entfernen
Starten Sie Thunderbird neu, um zwischengespeicherte Daten zu löschen
Installieren Sie Erweiterung erneut über .xpi-Datei oder temporäre Installation
Testen Sie Erweiterungsbetrieb an einer Test-E-Mail
📞 Support und Fehlerberichte
- Prüfen Sie diese Dokumentation auf Lösung Ihres Problems
- Aktivieren Sie Protokollierung und geben Sie Fehlermeldungen an
- Beschreiben Sie Schritte zur Reproduktion des Problems
- Geben Sie Thunderbird-Version und Betriebssystem an