mirror of
https://github.com/fish-shell/fish-shell.git
synced 2026-04-21 00:31:15 -03:00
aa8f5fc77e
Based on the discussion in https://github.com/fish-shell/fish-shell/pull/11967 Introduce a `status language` builtin, which has subcommands for controlling and inspecting fish's message localization status. The motivation for this is that using only the established environment variables `LANGUAGE`, `LC_ALL`, `LC_MESSAGES`, and `LANG` can cause problems when fish interprets them differently from GNU gettext. In addition, these are not well-suited for users who want to override their normal localization settings only for fish, since fish would propagate the values of these variables to its child processes. Configuration via these variables still works as before, but now there is the `status language set` command, which allows overriding the localization configuration. If `status language set` is used, the language precedence list will be taken from its remaining arguments. Warnings will be shown for invalid arguments. Once this command was used, the localization related environment variables are ignored. To go back to taking the configuration from the environment variables after `status language set` was executed, users can run `status language unset`. Running `status language` without arguments shows information about the current message localization status, allowing users to better understand how their settings are interpreted by fish. The `status language list-available` command shows which languages are available to choose from, which is used for completions. This commit eliminates dependencies from the `gettext_impl` module to code in fish's main crate, allowing for extraction of this module into its own crate in a future commit. Closes #12106
53 lines
1.8 KiB
ReStructuredText
53 lines
1.8 KiB
ReStructuredText
_ - call fish's translations
|
|
============================
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
.. synopsis::
|
|
|
|
_ STRING
|
|
|
|
Description
|
|
-----------
|
|
|
|
``_`` translates its arguments into the current language, if possible.
|
|
|
|
This only works with messages which are translated as part of fish's own sources, so using it as part of your own fish scripts which are not upstreamed into the fish repo will not work unless the exact same message also exists upstream.
|
|
|
|
It requires fish to be built with gettext support. If that support is disabled or there is no translation it will echo the argument back.
|
|
|
|
The language depends on the current locale, set with :envvar:`LANG`, :envvar:`LC_MESSAGES`, :envvar:`LC_ALL`, and :envvar:`LANGUAGE`.
|
|
These variables do not have to be exported for fish to use them, and fish's variable scopes are supported.
|
|
If other programs launched via fish should respect these locale variables they have to be exported to make them available outside of fish.
|
|
|
|
For :envvar:`LANGUAGE` you can use a list, or use colons to separate multiple languages.
|
|
|
|
If the :ref:`status language set <status-language>` command was used, its arguments specify the language precedence, and the environment variables are ignored.
|
|
|
|
Options
|
|
-------
|
|
|
|
``_`` takes no options.
|
|
|
|
Examples
|
|
--------
|
|
|
|
Use German translations::
|
|
|
|
> set LANG de_DE.UTF-8
|
|
> _ file
|
|
Datei
|
|
|
|
Specify a precedence of languages (only works with :envvar:`LANGUAGE`)::
|
|
|
|
> set LANGUAGE pt de
|
|
> _ file # This message has a Portuguese translation.
|
|
arquivo
|
|
> _ "Invalid arguments" # This message does not have a Portuguese translation, but a German one.
|
|
Ungültige Argumente
|
|
> _ untranslatable # No translation in Portuguese, nor in German.
|
|
untranslatable
|
|
|
|
Note that the specific examples may change if translations are added/modified.
|