https://github.com/jenkinsci/locale-plugin

Jenkins locale plugin
https://github.com/jenkinsci/locale-plugin

localization ui

Last synced: 8 months ago
JSON representation

Jenkins locale plugin

• Host: GitHub
• URL: https://github.com/jenkinsci/locale-plugin
• Owner: jenkinsci
• License: mit
• Created: 2010-12-13T05:43:52.000Z (over 15 years ago)
• Default Branch: main
• Last Pushed: 2025-01-28T04:16:38.000Z (over 1 year ago)
• Last Synced: 2025-01-28T05:20:30.873Z (over 1 year ago)
• Topics: localization, ui
• Language: Java
• Homepage: https://plugins.jenkins.io/locale
• Size: 406 KB
• Stars: 14
• Watchers: 98
• Forks: 18
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          
# Locale Plugin for Jenkins

[![Build Status](https://ci.jenkins.io/job/Plugins/job/locale-plugin/job/main/badge/icon)](https://ci.jenkins.io/job/Plugins/job/locale-plugin/job/main/)

[![Coverage](https://ci.jenkins.io/job/Plugins/job/locale-plugin/job/main/badge/icon?status=${instructionCoverage}&subject=coverage&color=${colorInstructionCoverage})](https://ci.jenkins.io/job/Plugins/job/locale-plugin/job/main)

[![LOC](https://ci.jenkins.io/job/Plugins/job/locale-plugin/job/main/badge/icon?job=test&status=${lineOfCode}&subject=line%20of%20code&color=blue)](https://ci.jenkins.io/job/Plugins/job/locale-plugin/job/main)

[![Jenkins Plugin](https://img.shields.io/jenkins/plugin/v/locale.svg)](https://plugins.jenkins.io/locale)

[![GitHub release](https://img.shields.io/github/release/jenkinsci/locale-plugin.svg?label=changelog)](https://github.com/jenkinsci/locale-plugin/releases/latest)

[![GitHub license](https://img.shields.io/github/license/jenkinsci/locale-plugin)](https://github.com/jenkinsci/locale-plugin/blob/main/LICENSE.md)

This plugin controls the language of Jenkins.

Normally, Jenkins honors the browser's language preference if a translation is available for the preferred language 

and uses the system default locale for messages during a build.

This plugin allows you to:

* override the system default locale to the language of your choice

* ignore browser's language preference completely

* allow users to use their own language preferences

This feature is sometimes convenient for multilingual environment.

### Usage

Under _Manage Jenkins > Appearance_ there should be a "Locale" section.

Here you can enter the _Default Language_: this should be a language code

or locale code like "fr" (for French), or "de_AT" (German, in Austria).

The system will use this value, for example, for messages that are printed

to the log during a build (assuming that the Jenkins features and plugins that

you're using have been translated into the specified language).

To additionally force this language on all users, overriding their browser language,

you can check the "Ignore browser preference and force this language to all users" option.

To enable users to use their own language preference, overriding their browser language,

you can check the "Allow all users to use their own language preference" option.

JCasC configuration example:

```

appearance:

  locale:

    systemLocale: en

    ignoreAcceptLanguage: true

    allowUserPreferences: false

```

### Changelog

* See [GitHub releases](https://github.com/jenkinsci/locale-plugin/releases) for new releases

* For versions 1.4 and older, see the [changelog archive](docs/CHANGELOG.old.md)

## License

Licensed under MIT, see [LICENSE](LICENSE.md)