模块:沙盒/Artoria2e5/Infobox artist/doc

本模块用于执行{{艺人}}和{{Infobox artist}}模板，请到模板页阅读具体用法。

贡献指南

目前这个模板最重要的事情就是要抄参数填参数。常用的语法和翻译结果如下所列：

-- 帮手函数
local function _(str)
    if str ~= nil and str ~= '' then
        return str
    else
        return nil
    end
end

-- 这里演示给定参数调用模板 func 的方法，也是给下面 {{func}} 铺垫
local function func(args)
    return frame:expandTemplate{title = 'func', args = args}
end

--[[
Lua                        -- MediaWiki
]]--
_(a) or _(b) or _(c) or '' -- {{{a|{{{b|{{{c|}}}}}}}}}
_(foo) or '{{{foo}}}'      -- {{{foo}}}
_(foo) and 'a' or 'b'      -- {{#if:{{{foo|}}}|a|b}}
_(foo):lower()             -- {{lc:{{{foo|}}}}}
func({                     -- {{func
    ["1"] = 'anon_1',      --   | anon_1
    ["k"] = 'v',           --   | k = v
    ["2"] = 'anon_2'       --   | anon_2 <!-- | 2 = anon_2 -->
})                         -- }}

当然，由于我们处理的是实际传来的参数，其实还是要用args['a']获取参数，而不是处理现有的变量a。像ifeq这样的解析器函数其实也不难，看手册就好了。至于Lua语言的语法，这个官方自有教程，也不难。

arg_aliases

如果表格key部分的参数查找args找不到，那么会按照接下来key指向的备选列表一个个寻找候选内容。也就是说：

    ["foo"] = {"某", "baaar", "baz"}, -- 对应于 {{{foo|{{{某|{{{baaar|{{{baz|}}}}}}}}}}}}

多换几处，是不是整洁多了？

只可在模板中的所有对某变量的引用都以同种顺序出现时在arg_aliases加入内容。按照前面对此功能的描述，你很容易就会想通一件事——以后取这套变量，只能用头上作为key的那个字串的名字取，否则就得不到后备查找的加成。

实现上，这个模块用Lua metatable（元表）在args上面多玩了一层，实现了按照arg_aliases一个个顺序找候选参数。Lua允许给表格添加一个元表属性，决定特定函数的行为。例如，__index(table, key)这个函数，会在查找不到table[key]的时候蹦出来继续尝试查找。

现在我们一步步把注释为“magic”的地方拆开看：

    local oldArgsMeta = getmetatable(args) or {}         -- 保留旧 metatable。MediaWiki 传入的参数列表据说是用了 metatable。
    local newArgsMeta = {}                               -- 准备一个新的。
    for k, v in ipairs(oldArgsMeta) do                   -- 把旧的都复制过去。之所以不用旧的是因为担心可能只读。
        newArgsMeta[k] = v
    end
    newArgsMeta.__index = function (t, k)                -- 开始定义新的 __index 函数。
    	if oldArgsMeta.__index ~= nil then                 -- 如果旧的里面有 __index（这里旧的能在这个函数里面用到是因为 Lua 的闭包（closure））
    	    local val = oldArgsMeta.__index(t, k)            -- 我们试着用一下
    	    if val ~= nil then                               -- 如果取到了
                return val                                     -- 那就是它了，返回（return）就好
            end
        end
        for _, v in ipairs(arg_aliases[k] or {}) do        -- 对于每个在 arg_aliases 里面查到的 k 的后备 v
            if t[v] ~= nil and t[v] ~= '' then               -- 如果取到了 t[v] 且非空字符串（后者是 MediaWiki 模板参数的要求）
                return t[v]                                    -- 就是它了
            end
        end
        return nil                                         -- 没找着
    end
    setmetatable(args, newArgsMeta)                      -- 把新的 metatable 套上去，完事儿

这个实现有趣的地方在于t[v]这里本身还有可能再回到__index函数，也就是说之前的arg_aliases可以有递归查找的结构。