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