8.4 KiB
| title | layout | root | idx | marked_text_encoding | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Übersetzung (i18n / l10n) | default | ../.. | 8.05 |
|
Einleitung
Wenn Sie Ihre Mods und Spiele mit Übersetzungsunterstützung versehen, können mehr Menschen sie genießen. Laut Google Play haben 64 % der Minetest-Android-Nutzer Englisch nicht als ihre Hauptsprache. Minetest verfolgt keine Statistiken für Benutzer über alle Plattformen hinweg, aber es ist wahrscheinlich, dass es einen hohen Anteil an nicht-englischsprachiger Benutzer gibt.
Minetest ermöglicht es Ihnen, Ihre Mods und Spiele in verschiedene Sprachen zu übersetzen, indem Sie Texte auf Englisch verfassen und mit Hilfe von Übersetzungsdateien in übersetzen. Die Übersetzung wird auf dem Client eines jeden Spielers durchgeführt, so dass jeder Spieler eine andere Sprache sieht.
- Wie funktioniert die clientseitige Übersetzung?
- Formatierte Zeichenketten
- Beste Verfahren und verbreitete Unwahrheiten über die Übersetzung
- Server-seitige Übersetzungen
- Zusammenfassung
Wie funktioniert die clientseitige Übersetzung?
Markierter Text
Der Server muss den Clients mitteilen, wie der Text zu übersetzen ist. Dies geschieht durch die Platzierung von Kontrollzeichen im Text, die Minetest mitteilen, wo und wie der Text zu übersetzen ist. Dies wird als markierter Text bezeichnet und wird später näher erläutert.
Um Text als übersetzbar zu markieren, verwenden Sie eine Übersetzungsfunktion (S()), die Sie mit minetest.get_translator(textdomain) nutzen können`:
local S = minetest.get_translator("mymod")
minetest.register_craftitem("mymod:item", {
description = S("My Item"),
})
Das erste Argument von get_translator ist textdomain, die als Namensraum dient. Anstatt alle Übersetzungen für eine Sprache in einer einzigen Datei zu speichern, werden die Übersetzungen in Textdomänen aufgeteilt (eine Datei pro Textdomäne
pro Sprache). Die Textdomain sollte mit dem Namen des Mods übereinstimmen, da dies hilft, Mod-Konflikte zu vermeiden.
Markierter Text kann an den meisten Stellen verwendet werden, wo menschenlesbarer Text akzeptiert wird, einschließlich formspecs, item def-Felder, Infotext und mehr. Wenn Sie markierten Text in Formspecs, müssen Sie den Text mit minetest.formspec_escape entschlüsseln.
Wenn der Client auf übersetzbaren Text stößt, wie den, der an description übergeben wird, schaut er in der Übersetzungsdatei der Sprache des Spielers nach. Wenn eine Übersetzung nicht gefunden wird, greift er auf die englische Übersetzung zurück.
Der übersetzbare markierte Text enthält den englischen Ausgangstext, die Textdomäne,
und alle zusätzlichen Argumente, die an S() übergeben werden. Es ist im Wesentlichen eine Textkodierung des S-Aufrufs, die alle erforderlichen Informationen enthält.
Eine andere Art von markiertem Text ist der, der von minetest.colorize zurückgegeben wird.
{% include notice.html notice=page.marked_text_encoding %}
Übersetzungsdateien
Übersetzungsdateien sind Mediendateien, die sich im Ordner locale für jeden Mod befinden. Zurzeit wird nur das Format .tr unterstützt, aber die Unterstützung für weitere gängige Formate wird wahrscheinlich in der Zukunft hinzugefügt. Übersetzungsdateien müssen folgendermaßen benannt werden: [textdomain].[lang].tr.
Dateien im .tr beginnen mit einem Kommentar, der die Textdomäne angibt, und dann weiteren Zeilen, die den englischen Ausgangstext auf die Übersetzung abbilden.
Zum Beispiel: mymod.fr.tr:
# textdomain: mymod
Hello everyone!=Bonjour à tous !
I like grapefruit=J'aime le pamplemousse
Sie sollten Übersetzungsdateien auf der Grundlage des Quellcodes Ihres Mods/Spiels erstellen, unter Verwendung eines Tools wie update_translations. Dieses Tool sucht nach S( in Ihrem Lua-Code und erstellt automatisch eine Vorlage, die Übersetzer für die Übersetzung in ihre Sprache verwenden können. Es kümmert sich auch darum, die Übersetzungsdateien zu aktualisieren, wenn sich Ihr Quelltext ändert.
Sie sollten immer wörtlichen Text (") in S einfügen, anstatt eine Variable zu verwenden,
da dies den Werkzeugen hilft, Übersetzungen zu finden.
Formatierte Zeichenketten
Es ist üblich, variable Informationen in einen Übersetzungsstring aufzunehmen. Dabei ist es ist wichtig, dass der Text nicht einfach aneinandergereiht wird, da das Übersetzer daran hindert, die Reihenfolge der Variablen innerhalb eines Satzes zu ändern. Stattdessen, sollten Sie das Format/Argumente-System des Übersetzungssystems verwenden:
minetest.register_on_joinplayer(function(player)
minetest.chat_send_all(S("Everyone, say hi to @1!", player:get_player_name()))
end)
Wenn Sie ein wörtliches @ in Ihre Übersetzung einfügen wollen, müssen Sie die Escape-Schreibweise verwenden, indem Sie @@ schreiben.
Sie sollten die Verkettung innerhalb eines Satzes vermeiden, aber es wird empfohlen, dass mehrere Sätze durch Konkatenation zu verbinden. Dies hilft den Übersetzern, weil Zeichenketten kleiner gehalten sind.
S("Hello @1!", player_name) .. " " .. S("You have @1 new messages.", #msgs)
Beste Verfahren und verbreitete Unwahrheiten über die Übersetzung
- Vermeiden Sie die Verkettung von Text und verwenden Sie stattdessen Formatierungsargumente. Dies gibt Übersetzer die volle Kontrolle über die Änderung der Reihenfolge der Dinge.
- Erstellen Sie Übersetzungsdateien automatisch, indem Sie update_translations verwenden.
- Es ist üblich, dass Variablen den umgebenden Text verändern, zum Beispiel durch Geschlecht und Pluralisierung. Dies ist oft schwer zu handhaben, daher wird häufig mit geschlechtsneutralen Formulierungen umgangen.
- Übersetzungen können viel länger oder viel kleiner als der englische Text sein. Stellen Sie sicher, dass Sie viel Platz lassen.
- In anderen Sprachen werden Zahlen möglicherweise anders geschrieben, zum Beispiel mit Kommas als Dezimalkomma.
1.000,23,1'000'000,32 - Gehen Sie nicht davon aus, dass andere Sprachen die Großschreibung auf die gleiche Weise verwenden.
Server-seitige Übersetzungen
Manchmal muss man z. B. die Übersetzung eines Textes auf dem Server kennen, um Text zu sortieren oder zu suchen. Sie können get_player_information benutzen, um die Sprache des Spielers zu erhalten und get_translated_string, um markierten Text zu übersetzen.
local list = {
S("Hello world!"),
S("Potato")
}
minetest.register_chatcommand("find", {
func = function(name, param)
local info = minetest.get_player_information(name)
local language = info and info.language or "en"
for _, line in ipairs(list) do
local trans = minetest.get_translated_string(language, line)
if trans:contains(query) then
return line
end
end
end,
})
Zusammenfassung
Die Übersetzungs-API ermöglicht es, Mods und Spiele besser zugänglich zu machen, aber es ist Vorsicht geboten, um sie richtig zu nutzen.
Minetest wird ständig verbessert und die Übersetzungs-API wird wahrscheinlich in Zukunft erweitert werden. Zum Beispiel wird die Unterstützung für gettext-Übersetzungsdateien die Verwendung gängiger Übersetzungswerkzeuge und -plattformen (wie weblate) ermöglichen und es wird wahrscheinlich eine Unterstützung für Pluralisierung und Geschlecht hinzugefügt werden.