package
CLI tools for LittlevGL i18n support.
npm install lv_i18nGitHub-flavored package documentation.
Across all versions.
Download trend unavailable.
Runtime metadata.
Tagged topics.
Lightweight gettext replacement tools for C. Add multi-language support to your embedded projects with ease.
_("some text") (singular) and _p("%d item", item_cnt) (plural)yml files for the translations you are interested inextract to fill the yml files with the texts in _() and _p()yml filescompile to convert the yml files to a C and H file. They will contain the translations and all the background functions you need.node.js required.
Global install of the last version, execute as "lv_i18n"
npm i lv_i18n -gAlternatives:
Install from github's repo, master branch
npm i littlevgl/lv_i18n -gIf you wish local install for your project, do in project root:
npm init private
npm i lv_i18n -s
# now available at ./node_modules/.bin/lv_i18nThen commit package.json & put /node_modules into .gitignore. Next time
use just npm i to install.
run via npx
node.js has built-in npx utility to
execute packages "without install":
# run from github master
npx github:littlevgl/lv_i18n -h
# run from npm registry
npx lv_i18n -h#include "lv_i18n/lv_i18n.h" /*Assuming you have the translations here. (See below)*/
/* Load translations & default locale (usually, done once) */
lv_i18n_init(lv_i18n_language_pack);
/* Set active locale (can be switched anytime) */
lv_i18n_set_locale("ru-RU");
/* The translation of "title1" will be returned according to the selected locale.
* ("title1" is only a unique ID of the text.) Example:
* en-GB: "Main menu"
* ru_RU: "Главное меню"
*/
gui_set_text(label, _("title1"));
/* According to `user_cnt` different text can be returned
* en-GB `user_cnt == 1` : "One user is logged in"
* `user_cnt == 6` : "%d users are logged in"
*/
char buf[64];
sprintf(buf, _p("user_logged_in", user_cnt)), user_cnt); /*E.g. buf == "7 users are logged in"*/
_ and _p are normal functions. They just have this short name to enable fast typing of texts.
Rules of getting the translation:
For each translation, you need to create a yml file with "language code" name. For example:
Here is a list of the language and locale codes.
Add the locale-name: ~ line to the yml files. Replace "language-code" with the actual language code.
E.g.: en-GB: ~ or simply en: ~
Technically you can have one yml file where you list all language codes you need but its more modular to separate them.
Run extract like this (assuming your source files are in the src folder an the yml files in the translations folder):
lv_i18n extract -s 'src/**/*.+(c|cpp|h|hpp)' -t 'translations/*.yml'It will fill the yml files the texts marked with _ and _p.
For example:
en-GB:
title1: ~
user_logged_in:
one: ~
other: ~The naming conventions in the yml files follow the rules of CLDR so most of the translation offices will know them.
Example:
'en-GB':
title1: Main menu
user_logged_in:
one: One user is logged in
other: %d users are logged inOnce you have the translations in the yml files you only need to run the compile to generate a C and H files from the yml files. No other library will be required to get the translation with _() and _p.
Running compile:
lv_i18n compile -t 'translations/*.yml' -o 'src/lv_i18n'The deafult locale is en-GB but you change it with -l 'language-code'.
To change a text id in the yml files use:
lv_i18n rename -t src/i18n/*.yml --from 'Hillo wold' --to 'Hello world!'Attach generated translations to be used by lv_i18n_get_text().
Set locale to be used by lv_i18n_get_text().
en-GB, ru-RU).Mapped to _(...) or _t(...) via #define
Get translated text. If not translated, return fallback (try default locale first, then input param if default not exists)
"title1")Mapped to _p(...) or _tp(...) via #define
Get the plural form of translated text. Use current locale to select plural algorithm. If not translated, fallback to default locale first, then to input param.
"title1")To understand i18n principles better, you may find useful links below:
kisvegabor
kisvegabor@gmail.com
Estimated unpacked size across 35 packages.
14.1 MB
Includes dependencies.