Diese Dokumentation erklärt, wie Sie die ausführliche Lokalisierung (verbose localization) verwenden, um Übersetzungsschlüssel für benutzerdefinierten Text in Discourse zu finden.
Erforderliche Benutzerebene: Administrator
Übersetzungsschlüssel mit ausführlicher Lokalisierung finden
Die ausführliche Lokalisierung ist ein mächtiges Werkzeug in Discourse, das Administratoren hilft, Übersetzungsschlüssel für benutzerdefinierten Text effektiver zu finden. Dies ist besonders nützlich, wenn Sie Text übersetzen müssen, der an mehreren Stellen in der Discourse-Benutzeroberfläche angezeigt wird.
Zusammenfassung
Dieser Leitfaden behandelt:
- Aktivieren der ausführlichen Lokalisierung.
- Verwendung der ausführlichen Lokalisierung zur Identifizierung von Übersetzungsschlüsseln.
- Praktische Anwendungen und häufige Anwendungsfälle.
Ausführliche Lokalisierung aktivieren
Je nach Ihrer Einrichtung gibt es verschiedene Möglichkeiten, die ausführliche Lokalisierung zu aktivieren.
Verwendung der Entwickler-Toolbar (empfohlen)
Die Discourse Developer Toolbar enthält eine integrierte Umschaltfunktion für die ausführliche Lokalisierung. Dies ist die einfachste Methode und funktioniert sowohl für selbst gehostete als auch für gehostete Seiten.
- Öffnen Sie die Entwicklerkonsole Ihres Browsers auf Ihrer Discourse-Seite.
- Führen Sie Folgendes aus:
enableDevTools() - Die Seite wird neu geladen und eine Entwickler-Toolbar wird auf der linken Seite des Bildschirms angezeigt.
- Klicken Sie auf das
(Scroll)-Symbol in der Toolbar, um die ausführliche Lokalisierung ein- oder auszuschalten. - Die Seite wird mit aktivierter ausführlicher Lokalisierung neu geladen.
Der Status der Entwickler-Toolbar wird im lokalen Speicher Ihres Browsers gespeichert, und der Status der ausführlichen Lokalisierung wird im Sitzungsspeicher gespeichert. Andere Benutzer sind davon nicht betroffen.
Verwendung der Browserkonsole direkt
- Öffnen Sie den Web-Inspektor Ihres Browsers auf Ihrer Discourse-Seite.
- Wechseln Sie zur Registerkarte Konsole.
- Geben Sie den folgenden JavaScript-Befehl an der Eingabeaufforderung ein:
I18n.enableVerboseLocalizationSession() - Sie sollten eine ähnliche Antwort sehen wie:
Verwendung der Rails-Konsole (nur selbst gehostet)
Die Site-Einstellung verbose_localization existiert, ist aber eine versteckte Site-Einstellung. Sie ist in der Admin-UI unter „Alle Site-Einstellungen“ nicht zu finden. Um sie global für alle Benutzer auf einer selbst gehosteten Instanz zu aktivieren:
- Greifen Sie auf die Rails-Konsole zu.
- Führen Sie Folgendes aus:
SiteSetting.verbose_localization = true
Dies aktiviert die ausführliche Lokalisierung für alle Benutzer auf der Seite. Bevorzugen Sie die oben genannten sitzungsbasierten Methoden, um die Benutzeroberfläche für andere Benutzer nicht zu überladen.
Übersetzungsschlüssel mit ausführlicher Lokalisierung finden
Wenn die ausführliche Lokalisierung aktiviert ist, sehen Sie Zahlen, die nach jedem anpassbaren Text auf Ihrer Seite angezeigt werden.
Schritte zur Identifizierung eines Übersetzungsschlüssels
- Navigieren Sie zu dem Bereich, der den Text enthält, den Sie ändern möchten. Wenn Sie beispielsweise das Wort „Name“ ändern möchten:
- Suchen Sie nach der zugehörigen Übersetzungssnummer in der Konsole Ihres Browsers:
- Notieren Sie den identifizierten Übersetzungsschlüssel, z. B.
user.name.title. - Gehen Sie zur Admin-Seitenleiste und geben Sie „site texts“ in das Suchfeld ein
- Geben Sie den Übersetzungsschlüssel in das Suchfeld ein:
- Klicken Sie auf die Schaltfläche Bearbeiten des Textes und aktualisieren Sie den Text nach Bedarf.
Best Practices
- Verwenden Sie sitzungsspezifische ausführliche Lokalisierung, um die Benutzeroberfläche für andere Benutzer während Übersetzungsaufgaben nicht zu überladen.
- Dokumentieren Sie häufig verwendete Übersetzungsschlüssel für zukünftige Referenzen.
- Überprüfen Sie regelmäßig Updates in der Discourse-Dokumentation, um über neue Lokalisierungsfunktionen informiert zu bleiben.
Häufige Probleme und Lösungen
Problem: Übersetzungshinweise für alle Benutzer sichtbar
Lösung: Stellen Sie sicher, dass Sie die ausführliche Lokalisierung ausschließlich für Ihre Sitzung aktivieren, wenn andere Benutzer sie nicht sehen sollen. Verwenden Sie die Developer Toolbar oder die Konsolenmethode I18n.enableVerboseLocalizationSession(), anstatt die globale Site-Einstellung zu verwenden.
Problem: Schwierigkeiten bei der Suche nach dem richtigen Übersetzungsschlüssel
Lösung: Verwenden Sie die Konsole und die Marker für die ausführliche Lokalisierung präzise und gleichen Sie diese mit der Seite „Site Texts anpassen“ ab.
FAQs
F: Kann die ausführliche Lokalisierung auf Administratoren oder Mitarbeiter beschränkt werden?
A: Die Zahlen der ausführlichen Lokalisierung können für nicht-technische Benutzer ausgeblendet werden, indem sie in einzelnen Sitzungen über die Developer Toolbar oder die Browserkonsole aktiviert werden.
F: Wie können String-Übersetzungen überprüft werden?
A: Nachdem Sie den Übersetzungsschlüssel identifiziert und aktualisiert haben, überprüfen Sie die Änderungen in der Benutzeroberfläche in einer neuen Browsersitzung oder einem neuen Tab.