luci-base: add support for plural translations and contexts in Lua api
authorJo-Philipp Wich <jo@mein.io>
Thu, 23 Jan 2020 20:53:26 +0000 (21:53 +0100)
committerJo-Philipp Wich <jo@mein.io>
Sat, 25 Jan 2020 22:21:35 +0000 (23:21 +0100)
commit9939fc5a26d07da4756497bb6a7dc51dcf379e98
treee79785f03912d2cec48fdf59f132a42528bd4c6f
parent6f6f3e84ca0bc04cd69433f723371fdd3416add9
luci-base: add support for plural translations and contexts in Lua api

 - Introduce a new luci.template.parser.ntranslate() function which
   takes a count, a singular and a plural translation string as well
   as an optional context argument and returns the appropriate,
   language specific plural translation.

 - Introduce an optional translation context argument in the existing
   luci.template.parser.translate() function

 - Support translation contexts in LuCI template directives.
   Translation messages are split on the first unescaped pipe
   character and the reamining string after the pipe is treated
   as context.

Examples:

 - `string.format(p.ntranslate(n, "1 apple", "%d apples"), n)` will
   return an appropriate plural translation for the given amount.

 - `translate("Load", "The system load")` will return an appropiate
   translation for `Load`, using `The system load` as disambiguation
   context (a `msgctxt` directive in *.po files).

 - Likewise `<%:Load|The system load%>` will translate the word
   `Load` while using the remainder of the string as context.

 - To use pipes in translations strings literally, they must be
   escaped: `<%:Use the "\|" character%>` will translate the literal
   string `Use the "|" character`.

Signed-off-by: Jo-Philipp Wich <jo@mein.io>
.gitignore
build/i18n-scan.pl
modules/luci-base/src/Makefile
modules/luci-base/src/contrib/lemon.c [new file with mode: 0644]
modules/luci-base/src/contrib/lempar.c [new file with mode: 0644]
modules/luci-base/src/plural_formula.y [new file with mode: 0644]
modules/luci-base/src/template_lmo.c
modules/luci-base/src/template_lmo.h
modules/luci-base/src/template_lualib.c
modules/luci-base/src/template_utils.c