Module:I18n: Difference between revisions

--  The module is designed to enable message separation from modules &

--  templates. It has support for handling language fallbacks. This

--   

--  @module        i18n

--  @require        Module:Entrypoint

--  @require        Module:Fallbacklist

--  @attribution    [[User:Cqm|Cqm]]

--  @release        stable

--  <nowiki>

local i18n, _i18n = {}, {}

--  Module variables & dependencies.

local title = mw.title.getCurrentTitle()

local uselang

Data.__index = Data

--  This method returns localized messages from the datastore corresponding

--  to a `key`. These messages may have `$n` parameters, which can be

--  verbosity; it can be used to select message language & source(s).

--  @function          Data:msg

--  @usage

--   

     local lang = self.tempLang or self.defaultLang

     self.tempLang = nil

     -- Message fetching.

     local msg

     for i, messages in ipairs(self._messages) do

         -- Message data.

         -- Fallback support (experimental).

         for _, l in ipairs((fallbacks[lang] or {})) do

         if msg and source_i[i] and lang ~= 'qqx' then

             return frame and _i18n.isWikitext(msg)

         end

     end

end

--  This method, given a table of arguments, tries to find a parameter's

--  localized name in the datastore and returns its value, or nil if

end

--  By default, messages are fetched from the datastore in the same

--  order of priority as `i18n.loadMessages`.

end

--  @function          Data:getLang

--  @return            {string} Default language to serve datastore messages in.

end

--  @function          Data:useUserLang

--  @return            {Data} Datastore instance.

end

--  @function          Data:useContentLang

--  @return            {Data} Datastore instance.

function Data:useContentLang()

     return self

end

--  @function          Data:useLang

--  @param              {string} code Language code to use.

end

--  @{Data:msg} call.

--  @function          Data:inUserLang

end

--  Only affects the next @{Data:msg} call.

--  @function          Data:inContentLang

--  @return            {Data} Datastore instance.

function Data:inContentLang()

     return self

end

--  Only affects the next @{Data:msg} call.

--  @function          Data:inLang

--  Package functions.

--  Can be used to fetch messages in a specific language code through `uselang`

--  parameter. Extra numbered parameters can be supplied for substitution into

--  @function          i18n.getMsg

--  @param              {table} frame Frame table from invocation.

end

   

--  @function          i18n.loadMessages

--  @param              {string} ... ROOTPAGENAME/path for target i18n

             source = mw.ustring.find(source, ':')

                 and source

             ds._messages[i] = mw.loadData(source)

         end

end

--  Can validate a template's language code through `uselang` parameter.

--  @function          i18n.getLang

     local parentFrame = frame.getParent and frame:getParent() or {}

     -- Language argument test.

     if _i18n.isValidCode(langOverride) then

         code = langOverride

     -- User language test.