Bonsaibauer: Importing a new version from external source

2026-11-07T01:35:35Z

Importing a new version from external source

New page

<languages />



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

 

मॉड फ़ोल्डर में मौजूद समान locale फ़ाइलों से दिखाई देने वाले Modloader टेक्स्ट और Lua टेक्स्ट का अनुवाद करें। PR #42 में जोड़ी गई <code>shroudforge.locale()</code> से Modloader की भाषा पढ़ें।


== Locale फ़ाइलें ==

हर भाषा के लिए <code>locales/<code>.json</code> में एक फ़ाइल जोड़ें। Modloader भाषा चयनकर्ता में मौजूदा कोड <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> और <code>zh</code> हैं। फ़ाइल का नाम उसके कोड से बिल्कुल मेल खाता है। ये फ़ाइलें <code>mod.json</code> और <code>extended.mod.json</code> के साथ रहती हैं।

स्कीमा [https://bonsaibauer.github.io/shroudforge/schemas/mod-locale.schema.json <code>mod-locale.schema.json</code>] के रूप में प्रकाशित है। Locale कैटलॉग <code>mod.name</code> और <code>mod.description</code>, सेटिंग और विकल्प लेबल, समूह, कार्रवाइयाँ, changelog पंक्तियाँ और Lua <code>strings</code> का अनुवाद कर सकता है। कैटलॉग आंशिक हो सकते हैं। जिन प्रविष्टियों का अनुवाद नहीं है, वे स्रोत टेक्स्ट ही दिखाती हैं।

<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>

सेटिंग और विकल्प की कुंजियाँ <code>extended.mod.json</code> जैसी ही रहती हैं। समूहों के अनुवाद उसी फ़ाइल में दिए समूह क्रम का पालन करते हैं। कार्रवाई के अनुवाद में मौजूदा action ID उपयोग होती है। सहेजे गए मान नहीं बदलते।


== Lua में वही टेक्स्ट उपयोग करें ==

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

<code>shroudforge.i18n.get(key, locale, fallback)</code> Modloader द्वारा लोड किए गए उसी कैटलॉग का उपयोग करता है। यह पहले <code>de-AT</code> जैसे क्षेत्रीय कोड को और फिर उसकी भाषा <code>de</code> को जाँचता है। स्ट्रिंग न मिलने पर fallback टेक्स्ट लौटता है, या fallback न दिया हो तो कुंजी लौटती है। लुकअप फ़ाइलों को दोबारा नहीं पढ़ता। PR #42 भाषा API देता है और यह सुविधा उसे हर मॉड के कैटलॉग से जोड़ती है।

यदि कॉन्फ़िगरेशन पढ़ा न जा सके और <code>shroudforge.locale()</code> <code>en</code> लौटाए, तो कैटलॉग लुकअप पहले <code>en-GB.json</code> और फिर <code>en.json</code> जाँचता है। <code>en-GB</code> Modloader की डिफ़ॉल्ट अंग्रेज़ी है। <code>en-US</code> को स्पष्ट रूप से चुने गए विकल्प के रूप में रखा गया है।

Locale फ़ाइलों के लिए runtime क्षमता आवश्यक नहीं है। ShroudForge इंटरफ़ेस टेक्स्ट साझा Modloader अनुवादों में रहता है।

[[Category:guide:Shroudforge]]

Translate mod text/hi - Revision history

Bonsaibauer: Importing a new version from external source