PHPackages                             jelix/locales-tools - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. jelix/locales-tools

ActiveLibrary[CLI & Console](/categories/cli)

jelix/locales-tools
===================

Command line tools to manage or convert locales of a Jelix application.

1.1.0(3y ago)0498MITPHPPHP >=7.2

Since Jan 7Pushed 3y ago1 watchersCompare

[ Source](https://github.com/jelix/LocalesTools)[ Packagist](https://packagist.org/packages/jelix/locales-tools)[ RSS](/packages/jelix-locales-tools/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (2)Used By (0)

Command line tools to manage locales of a Jelix application.

- convertion from properties format to PO or POT format
- convertion from PO format to properties format

installation
============

[](#installation)

You can install it from Composer. In your project:

```
composer require "jelix/locales-tools"

```

configuration
=============

[](#configuration)

In your projects that contains modules for Jelix, with some locales, you should put a `.jelixlocales.ini` file.

Here is its content:

```
; the path of a jelix application or '.4 if you have only modules into your project
applicationPath=.

; a project id : can be a name with the version of your project
projectId=jelix 1.6.33

; header to add into each generated properties files
propertiesFileHeader="Please don't modify this file."

; default value for all modules. You can specify specifics values in sections
; of modules
[default]
; main locale used to translate from
mainLocale=en_US

; where translations should be stored. See below.
translationLocation=@module

; a section for each modules, having this name : "module:".
[module:jelix]
; path to the module, relative to the applicationPath path
path=jelix/core-modules/jelix/

; list of properties files to not translate.
excludePropertiesFiles=format.UTF-8.properties
;translationLocation=@module
;mainLocale=en_US
```

`translationLocation` should be a path, relative to the path of `.jelixlocales.ini`, or an absolute path (not recommended). It can contain keywords `:locale` and `:module`, they will be replaced respectively by the locale and the module name. If you want a path relative to the application path, prepend the path with `@app:`.

Example:

```
translationLocation=somewhere/:locale/:module/
; or
translationLocation=@app:var/locales/:locale/:module/
```

Most of time, you may want to store translations in locations recognized by Jelix. You can use some specific keywords that will be replace by the real path:

- `@module`, equivalent to `/locales/:locale/`
- `@app-overloads`, equivalent to `/app/overloads/:module/locales/:locale/`
- `@app-locales`, equivalent to `/locales/:locale/:module/`
- `@var-overloads`, equivalent to `/var/overloads/:module/locales/:locale/`
- `@var-locales`, equivalent to `/var/locales/:locale/:module/`

commands
========

[](#commands)

Run `vendor/bin/jelixlocales` to have helo and the list of possible commands.

###  Health Score

22

—

LowBetter than 23% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

1218d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ae8142be36568660282368ce7c1eec904ecbc515ab5b58c759a487f3a6f1d114?d=identicon)[laurentj](/maintainers/laurentj)

![](https://www.gravatar.com/avatar/baa42c7323bbc9245b0c70f770031383879941a1a813f678f2835699fd50b375?d=identicon)[mdouchin](/maintainers/mdouchin)

---

Top Contributors

[![laurentj](https://avatars.githubusercontent.com/u/336034?v=4)](https://github.com/laurentj "laurentj (4 commits)")

### Embed Badge

![Health badge](/badges/jelix-locales-tools/health.svg)

```
[![Health](https://phpackages.com/badges/jelix-locales-tools/health.svg)](https://phpackages.com/packages/jelix-locales-tools)
```

###  Alternatives

[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[crazywhalecc/static-php-cli

Build single static PHP binary, with PHP project together, with popular extensions included.

1.8k13.9k](/packages/crazywhalecc-static-php-cli)[matthiasnoback/symfony-console-form

Use Symfony forms for Console command input

368264.8k8](/packages/matthiasnoback-symfony-console-form)[phpcr/phpcr-shell

Shell for PHPCR

721.3M8](/packages/phpcr-phpcr-shell)[jelix/jelix

Jelix PHP framework

83101.5k4](/packages/jelix-jelix)[madewithlove/license-checker

CLI tool to verify allowed licenses for composer dependencies

54449.8k21](/packages/madewithlove-license-checker)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)