模块:QueryCharacters

模块文档[查看] [编辑] [查看历史] [清除缓存] [跳转到代码]

本模块用于根据Semantic MediaWiki的语义化数据，给定角色的在漫画中的出场话数和出场类型（可选），返回格式化的出场角色列表。

用法

{{#invoke: QueryCharacters|queryOnNumber|[出场话数]|<出场类型>}}

参数

• [出场话数]：必需；欲查询角色出场的话数。
• <出场类型>：可选；应为“主要”“次要”“背景”之一。若填写，则仅返回符合所查询出场类型的角色，否则返回所有出场类型的角色。

返回值

符合条件的格式化的角色列表。

上述文档内容嵌入自Module:QueryCharacters/doc。（编辑 | 历史）
编者可以在本模块的沙盒（创建 | 镜像）和测试样例（创建）页面进行实验。
请将模块自身所属的分类添加在文档中。本模块的子页面。

-- 作者：华纹 (User:Blossomstripe on youshou.wiki)
local p = {}

function p.queryOnNumber(frame)
    local function queryOnNumberAndType(number, camera_type)
        --[[ 给定出场话数和类型，查询出场角色
        number：出场话数
        camera_type：出场类型 --]]
        local args = string.format('[[OnCamera:number::%d]]|[[OnCamera:type::%s]]|?OnCamera:character_name', number, camera_type)
        local results = mw.smw.ask(args)

        return results
    end

    local function prettyList(node, results)
        --[[ 将results给出的角色列表显示出来。要修改角色显示方式，只需修改该函数
        node：mw.html
        results：mw.smw.ask返回的查询结果 --]]
        local ul = node:tag('ul')
        for _, item in pairs(results) do
            local li = ul:tag('li')
            li:wikitext('[[' .. item['OnCamera:character name'] .. ']]')
        end

        return node
    end

    local number = frame.args[1]
    local camera_type = frame.args[2]
    local node = mw.html.create('')

    -- 若给定出场类型，则仅查询相应出场类型的角色，否则分别查询所有出场类型的角色
    if (camera_type and camera_type ~= '') then
        local results = queryOnNumberAndType(number, camera_type)
        if (type(results) == 'table') then
        	node = prettyList(node, results)
        end
    else
        for idx_type, camera_type in pairs({ '主要', '次要', '背景' }) do
            local results = queryOnNumberAndType(number, camera_type)
            if (type(results) == 'table') then
                local title = string.format('%s角色', camera_type)
                local h4 = node:tag('h4')
                h4:wikitext(title)
                node = prettyList(node, results)
            end
        end
    end

    return node
end

return p