Argus in your Language

Localization support was added in version 3.3

Argus has the ability to display its web pages in the language of your choice. Argus ships with support for several languages, and support for additional languages can be easily added.

Configuring

When displaying web pages, the argus cgi program uses the language value set in the config file (lang), or set in the environment, and uses that to load a file.

The cgi program checks the environment variables LC_ALL, LC_ARGUS, and then LANG, in order and uses the first one it finds. If none are set, it uses the value default. Often, one of these environment variables will already be set correctly.

It then looks in the directory $datadir/locale for a file by that name. If it cannot load the specified file, it will use english.

So, to configure your language of choice, you have 3 options:

add a line to your argus config like:
```
    lang: en_us
```
adjust the environment variables to match the correct filename. the variable will need to be set before starting your web server. how exactly to set environment variables for your web server is beyond the scope of this document.
adjust the name of the file in $datadir/locale to match what argus is looking for (either to the environment variable that is already configured or the value default). you can either rename or symlink the correct file to the desired name.

Adding a new language

If there is not currently support for the language you want to use, it is fairly simple to add a new language.

In the $datadir/locale you will find a file called template. Copy this file to a new file, and load it into your favorite editor. Following the instructions and examples contained in the file, enter the words and phrases correct for your language.

Follow the instructions above to get argus to use your new file.

Send your file to the author so it may be included in the next version.