commit 4f6198094cf4134179d1f9c9fa8f79759a27c87e
[project/luci.git] / libs / web / luasrc / i18n.lua
1 --[[
2 LuCI - Internationalisation
3
4 Description:
5 A very minimalistic but yet effective internationalisation module
6
7 FileId:
8 $Id$
9
10 License:
11 Copyright 2008 Steven Barth <steven@midlink.org>
12
13 Licensed under the Apache License, Version 2.0 (the "License");
14 you may not use this file except in compliance with the License.
15 You may obtain a copy of the License at
16
17 http://www.apache.org/licenses/LICENSE-2.0
18
19 Unless required by applicable law or agreed to in writing, software
20 distributed under the License is distributed on an "AS IS" BASIS,
21 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
22 See the License for the specific language governing permissions and
23 limitations under the License.
24
25 ]]--
26
27 module("luci.i18n", package.seeall)
28 require("luci.sys")
29
30 table = {}
31 i18ndir = luci.sys.libpath() .. "/i18n/"
32
33 -- Clears the translation table
34 function clear()
35 table = {}
36 end
37
38 -- Loads a translation and copies its data into the global translation table
39 function load(file)
40 local f = loadfile(i18ndir .. file)
41 if f then
42 setfenv(f, table)
43 f()
44 return true
45 else
46 return false
47 end
48 end
49
50 -- Same as load but autocompletes the filename with .LANG from config.lang
51 function loadc(file)
52 return load(file .. "." .. require("luci.config").main.lang)
53 end
54
55 -- Returns the i18n-value defined by "key" or if there is no such: "default"
56 function translate(key, default)
57 return table[key] or default
58 end
59
60 -- Translate shourtcut with sprintf/string.format inclusion
61 function translatef(key, default, ...)
62 return translate(key, default):format(...)
63 end