Bonsaibauer: Importing a new version from external source

2026-11-07T01:35:40Z

Importing a new version from external source

New page

<languages />



[[File:ShroudForge-Wiki-modding-locales.svg|thumb|left|600px|Translate mod text]]

 

Tłumacz widoczny tekst Modloadera i tekst Lua z tych samych plików locale w folderze moda. Odczytaj język Modloadera przez <code>shroudforge.locale()</code>, dodane w PR #42.


== Pliki locale ==

Dodaj jeden plik <code>locales/<code>.json</code> dla każdego języka. Bieżące kody z selektora języka Modloadera to <code>de</code>, <code>de-AT</code>, <code>de-CH</code>, <code>en-GB</code>, <code>en-US</code>, <code>es</code>, <code>fr</code>, <code>hi</code>, <code>it</code>, <code>ja</code>, <code>nl</code>, <code>pl</code>, <code>sv</code> i <code>zh</code>. Nazwa pliku musi dokładnie odpowiadać kodowi. Pliki te znajdują się obok <code>mod.json</code> i <code>extended.mod.json</code>.

Schemat jest opublikowany jako [https://bonsaibauer.github.io/shroudforge/schemas/mod-locale.schema.json <code>mod-locale.schema.json</code>]. Katalog locale może tłumaczyć <code>mod.name</code> i <code>mod.description</code>, etykiety ustawień i opcji, grupy, akcje, wpisy dziennika zmian oraz Lua <code>strings</code>. Katalogi mogą być częściowe. Wpisy bez tłumaczenia zachowują tekst źródłowy.

<pre>
{
"$schema": "https://bonsaibauer.github.io/shroudforge/schemas/mod-locale.schema.json",
"settings": {
"severity": {
"label": "Log level",
"options": { "info": "Information", "warn": "Warning" }
}
},
"groups": [
{ "label": "Logging", "actions": { "write": { "label": "Write message" } } }
],
"strings": { "overlay.ready": "Ready" }
}
</pre>

Klucze ustawień i opcji pozostają takie same jak w <code>extended.mod.json</code>. Tłumaczenia grup zachowują kolejność grup w tym pliku. Tłumaczenia akcji używają istniejącego identyfikatora akcji. Zapisane wartości się nie zmieniają.


== Używanie tego samego tekstu w Lua ==

<pre>
local locale = shroudforge.locale()
local ready = shroudforge.i18n.get("overlay.ready", locale, "Ready")
</pre>

<code>shroudforge.i18n.get(key, locale, fallback)</code> używa tego samego katalogu załadowanego przez Modloader. Najpierw sprawdza kod regionalny, taki jak <code>de-AT</code>, a następnie język <code>de</code>. Jeśli brakuje tekstu, zwraca tekst zastępczy lub klucz, gdy nie podano tekstu zastępczego. Wyszukiwanie nie odczytuje plików ponownie. PR #42 udostępnia API języka, a ta funkcja łączy je z katalogiem każdego moda.

Jeśli <code>shroudforge.locale()</code> zwraca <code>en</code>, ponieważ nie można odczytać konfiguracji, katalog najpierw sprawdza <code>en-GB.json</code>, a potem <code>en.json</code>. <code>en-GB</code> jest domyślną odmianą angielskiego w Modloaderze. <code>en-US</code> pozostaje dostępne jako jawnie wybrany wariant.

Pliki locale nie wymagają możliwości runtime. Tekst interfejsu ShroudForge pozostaje we wspólnych tłumaczeniach Modloadera.

[[Category:guide:Shroudforge]]

Translate mod text/pl - Revision history

Bonsaibauer: Importing a new version from external source