lingora

Site | GitHub | API | Coverage Report

Lingora is a free and open-source localization management program that analyses fluent translation files highlighting discrepancies between reference and target languages.

Lingora is designed primarily to be used as a command line tool, but also provides a graphical user interface.

Instructions

• To get the current options:

  lingora --help

• The default run looks at all ftl files in the ./i18n/ folder, looking for a <current system locale>.ftl for the reference file. Only one <current system locale>.ftl must exist for this command to run successfully. Output is to stdout.

  lingora
  # or, by redirecting stdout:
  lingora > i18n-errors.txt

• To get the result of an analysis, but not see the details use the --output=silent option. This command does not output anything unless there are inconsistencies in or between the reference and/or target folders, in which case an error return of Error: IntegrityErrorsDetected is displayed.

  lingora -o silent

• To specify the reference locale: note this looks for target ftl files in the ./i18n/ folder.

  lingora -r ./i18n/en/en-GB.ftl

• To specify reference and target(s): note -t ... can be a folder, in which case a deep search for all .ftl files within the folder is performed.

  lingora -r ./i18n/en/en-GB.ftl -t ./i18n/en/en-AU.ftl -t ./i18n/it/it.ftl

• To output an opininated I18nConfig initialisation function: Output is to the provide path. The output settings can be modified in the Lingora.toml configuration file.

  lingora --dioxus-i18n=path/to/i18n_config.rs

• To run the desktop application, use the --output=gui option:

  lingora -o gui

Developmemt

cargo test
cargo llvm-cov