Locales: Difference between revisions

(6 intermediate revisions by 4 users not shown)

Line 1:

~~== Notes when setting supportedLocales and extraLocaleSettings ==~~

NixOS allows to set the default [https://en.wikipedia.org/wiki/Locale_(computer_software) locale] as well as individual locales in the system configuration file:

~~Beaware when setting up your locale variables~~. ~~The setting <code>i18n~~.~~supportedLocales<~~/~~code> requires a different format to <code>i18n.extraLocaleSettings<~~/~~code>.~~

~~The setting~~ <~~code~~>i18n.~~supportedLocales</code> requries the requires the language string '''with''' the added <code>/~~UTF-8~~</code>~~

{{file|/etc/nixos/configuration.nix|nix|<nowiki>

# Mandatory

i18n.defaultLocale = "en_US.UTF-8";

~~<syntaxhighlight lang~~="~~bash~~">

# Optionally (BEWARE: requires a different format with the added /UTF-8)

"en_US.UTF-8/UTF-8"

i18n.extraLocales = ["es_VE.UTF-8/UTF-8"];

"~~nl_NL~~.UTF-8/UTF-8"

</~~syntaxhighlight~~>

# Optionally

i18n.extraLocaleSettings = {

# LC_ALL = "en_US.UTF-8"; # This overrides all other LC_* settings.

LC_CTYPE = "en_US.UTF8";

LC_ADDRESS = "es_VE.UTF-8";

LC_MEASUREMENT = "es_VE.UTF-8";

LC_MESSAGES = "en_US.UTF-8";

LC_MONETARY = "es_VE.UTF-8";

LC_NAME = "es_VE.UTF-8";

LC_NUMERIC = "en_US.UTF-8";

LC_PAPER = "es_VE.UTF-8";

LC_TELEPHONE = "es_VE.UTF-8";

LC_TIME = "es_VE.UTF-8";

LC_COLLATE = "es_VE.UTF-8";

};

</nowiki>

}}

{{nixos:option|i18n.defaultLocale}} will set the language and the character set systemwide to the desired value. Specifically, defaultLocale will define the <code>LANG</code> environment variable.

In addition, with {{nixos:option|i18n.extraLocales}}, the system will also support Venezuelan Spanish. The value <code>"all"</code> means that all locales supported by Glibc will be installed. A full list of supported locales can be found at https://sourceware.org/git/?p=glibc.git;a=blob;f=localedata/SUPPORTED.

~~The setting <code>~~i18n.extraLocaleSettings~~</code>~~, ~~however, requires~~ the ~~language string '''without''' any suffix~~.

And in the {{nixos:option|i18n.extraLocaleSettings}}, it is possible to set the LC locales individually. This does allow fine-grained adjustments of the used locales. In the above example a mix of American English and Venezuelan Spanish is used. It is also possible to find these settings at [https://search.nixos.org/options NixOS options]. Just search for i18 locale.

<~~syntaxhighlight lang="bash"~~>

{{note|The setting <code>i18n.extraLocales</code> requires a different format to <code>i18n.extraLocaleSettings</code> with the added <code>/UTF-8</code>. Otherwise, your locale settings will likely not work.}}

~~LC_MESSAGES = "en_US~~.~~UTF-8"~~

~~LC_TIME = "de_DE~~.UTF-8"

</~~syntaxhighlight~~>Otherwise, your locale settings will likely not work.

== Troubleshooting when using nix on non-NixOS linux distributions ==

Line 49:

Line 67:

}

</syntaxhighlight>

[[Category:Configuration]]

@@ Line 1: / Line 1: @@
-== Notes when setting supportedLocales and extraLocaleSettings ==
+NixOS allows to set the default [https://en.wikipedia.org/wiki/Locale_(computer_software) locale] as well as individual locales in the system configuration file:
-Beaware when setting up your locale variables. The setting <code>i18n.supportedLocales</code> requires a different format to <code>i18n.extraLocaleSettings</code>.
-The setting <code>i18n.supportedLocales</code> requries the requires the language string '''with''' the added <code>/UTF-8</code>
+{{file|/etc/nixos/configuration.nix|nix|<nowiki>
+  # Mandatory
+  i18n.defaultLocale = "en_US.UTF-8";
-<syntaxhighlight lang="bash">
+  # Optionally (BEWARE: requires a different format with the added /UTF-8)
-"en_US.UTF-8/UTF-8"
+  i18n.extraLocales = ["es_VE.UTF-8/UTF-8"];
-"nl_NL.UTF-8/UTF-8"
-</syntaxhighlight>
+  # Optionally
+  i18n.extraLocaleSettings = {
+    # LC_ALL = "en_US.UTF-8"; # This overrides all other LC_* settings.
+    LC_CTYPE = "en_US.UTF8";
+    LC_ADDRESS = "es_VE.UTF-8";
+    LC_MEASUREMENT = "es_VE.UTF-8";
+    LC_MESSAGES = "en_US.UTF-8";
+    LC_MONETARY = "es_VE.UTF-8";
+    LC_NAME = "es_VE.UTF-8";
+    LC_NUMERIC = "en_US.UTF-8";
+    LC_PAPER = "es_VE.UTF-8";
+    LC_TELEPHONE = "es_VE.UTF-8";
+    LC_TIME = "es_VE.UTF-8";
+    LC_COLLATE = "es_VE.UTF-8";
+  };
+</nowiki>
+}}
+{{nixos:option|i18n.defaultLocale}} will set the language and the character set systemwide to the desired value. Specifically, defaultLocale will define the <code>LANG</code> environment variable.
+In addition, with {{nixos:option|i18n.extraLocales}}, the system will also support Venezuelan Spanish. The value <code>"all"</code> means that all locales supported by Glibc will be installed. A full list of supported locales can be found at https://sourceware.org/git/?p=glibc.git;a=blob;f=localedata/SUPPORTED.
-The setting <code>i18n.extraLocaleSettings</code>, however, requires the language string '''without''' any suffix.
+And in the {{nixos:option|i18n.extraLocaleSettings}}, it is possible to set the LC locales individually. This does allow fine-grained adjustments of the used locales. In the above example a mix of American English and Venezuelan Spanish is used. It is also possible to find these settings at [https://search.nixos.org/options NixOS options]. Just search for i18 locale.
-<syntaxhighlight lang="bash">
+{{note|The setting <code>i18n.extraLocales</code> requires a different format to <code>i18n.extraLocaleSettings</code>  with the added <code>/UTF-8</code>. Otherwise, your locale settings will likely not work.}}
-LC_MESSAGES = "en_US.UTF-8"
-LC_TIME = "de_DE.UTF-8"
-</syntaxhighlight>Otherwise, your locale settings will likely not work.
 == Troubleshooting when using nix on non-NixOS linux distributions ==
@@ Line 49: / Line 67: @@
 }
 </syntaxhighlight>
+[[Category:Configuration]]