🌐Custom Languages
How to define your custom languages.
Last updated
How to define your custom languages.
Last updated
When you extract the binary folder of Nitrocid KS, you may see a folder called CustomLanguages
. Inside it, you can see the Metadata.json
file that holds language metadata as described in the previous article. Before reading this, you must understand the multilingual kernel feature and how it works by clicking on the below link.
Customized languages play an important role in being a building block for making your custom localization. This feature contains two separate folders:
<KSExecutablePath>/CustomLanguages
This is the folder which you should place the source .txt
files containing all your string translations. You should implement all the translations found in the eng.txt
file, usually shipped with the Nitrocid KS binary.
<KSConfigPath>/KSLanguages
This is the folder that hosts all your custom language JSON files containing the translation metadata and the necessary translation data.
When the kernel starts up, it attempts to install all the custom languages found in the KSLanguages
path to the language store found within the language manager. This way, the kernel configuration reader will understand that your custom language exists.
Cool! So, you want to build your language? First, open the Metadata.json
︎ file found in the CustomLanguages
folder. Write details about your language in their appropriate places. For quick reference, here's an excerpt from the metadata JSON prototype:
Again, the codepage
parameter and the culture
parameter is optional. If you want your language to be able to be transliterated, make two metadata information about your target language, but append the -T
postfix to one of the metadata information name, for example:
After you filled in the metadata information about languages you want to create, make a text file with the name of the short language name (lng
and not My Language
) for each language with the .txt
extension, like this: lng.txt
Now, head to Translations/eng.txt
and use it as a reference to translate all the strings found there to your target language. Put all your translations to the newly-created file.
Both eng.txt
and your language text file MUST have the exact same line numbers!
After this is done, launch KSJsonifyLocales either by double-clicking the executable file (usually Nitrocid.LocaleGen.exe
) or by opening the terminal to the executable path and executing the dotnet Nitrocid.LocaleGen.dll
command.
You can also let this program generate only the custom locale information by passing the --CustomOnly
argument to it.
After Nitrocid.LocaleGen
finishes compiling the JSON file containing your translation, you should be able to find the resulting file in the <KSConfigPath>/KSLanguages
folder.
Open Nitrocid KS, and change your system language or your user language to your customized language.
If you want your language to be used in the entire kernel, follow these steps:
Log in to any user account that has administrative permissions or access to the kernel settings program
Execute the settings
command
Go to General
section
Go to Language
entry
Select your language. Your language should be there among the list of the kernel languages.
If you want your language to be used just for your user account, follow these steps:
Make sure that Nitrocid KS is shut down. If you skip this step, restart Nitrocid KS after you finish following this instruction.
In your host system, navigate to the kernel configuration path (%LOCALAPPDATA%/KS/
or ~/.config/ks/
)
Open your favorite text editor to Users.json
Create the preferredlanguage
key if it doesn't exist, then change its value to your three-letter language name.
Save the file, and start Nitrocid KS
Log-in to your target account. The language should change to your custom language.
This locale generator comes with options to change how it works. These switches provide the following functions: (Switches with the (INT)
suffix are reserved for internal usage only)
--CustomOnly
Restricts the generator to custom languages
--NormalOnly
(INT)
Restricts the generator to normal languages
--All
(INT)
Generates all the languages (default)
--Singular <lang>
Restricts the generator to a single custom or normal language
--CopyToResources
(INT)
Copies the resulting normal language outputs to the resources folder
If you have a custom language file and you want to quickly install it without having to restart the entire kernel, you can use the langman
command to use the following parameters:
load <lang>
Loads the custom language.
unload <lang>
Unloads the custom language.
reload <lang>
Reloads the custom language. Synonymous to the sequence of the unload
and the reload
parameters.
To check that your language is installed, use list <lang>
to verify that your language is there and that its information is available.
For mods that want to install or uninstall custom languages, you can use the API functions found within the LanguageManager
module.
Your mods can now be translated! Nitrocid KS can now detect your language files from your mods. For more information, consult the "Mod Translations" section in the below link: