模块:CharacterJsonLD

此模块的文档可以在模块:CharacterJsonLD/doc创建

local p = {}

local function clean(value)
    if type(value) ~= 'string' then
        return nil
    end

    value = mw.text.trim(value)

    if value == '' then
        return nil
    end

    return value
end

local function fileUrl(filename)
    filename = clean(filename)

    if not filename then
        return nil
    end

    filename = filename:gsub('^文件:', '')
    filename = filename:gsub('^[Ff]ile:', '')
    filename = mw.text.trim(filename)

    return 'https://blockland.wiki/wiki/Special:FilePath/'
        .. mw.uri.encode(filename, 'PATH')
end

local function addImage(images, filename, label)
    local url = fileUrl(filename)

    if url then
        table.insert(images, {
            ["@type"] = "ImageObject",
            ["url"] = url,
            ["name"] = label
        })
    end
end

function p.main(frame)

    -- Support both template and direct #invoke
    local args = frame.args
    local parent = frame:getParent()

    if not clean(args['名称']) and parent then
        args = parent.args
    end

    local title = mw.title.getCurrentTitle()

    -- Only main namespace articles
    if title.namespace ~= 0 then
        return ''
    end

    local name = clean(args['名称']) or title.text
    local pageUrl = tostring(title:fullUrl())

    local entity = {
        ["@type"] = "Person",
        ["@id"] = pageUrl .. '#character',
        ["name"] = name,
        ["url"] = pageUrl
    }

    local description = clean(args['简介'])

    if description then
        entity.description = description
    end

    -- Alternate names
    local aliases = {}

    for _, key in ipairs({
        '本名',
        '英文名',
        '别名',
        '其他名称'
    }) do
        local value = clean(args[key])

        if value and value ~= name then
            table.insert(aliases, value)
        end
    end

    if #aliases > 0 then
        entity.alternateName = aliases
    end

    -- Images
    local images = {}

    addImage(images, args['头像'], name .. '的头像')
    addImage(images, args['立绘'], name .. '的角色立绘')

    if #images > 0 then
        entity.image = images
    end

    -- Optional music group
    local group = clean(args['所属组合'])

    if group then
        entity.memberOf = {
            ["@type"] = "MusicGroup",
            ["name"] = group
        }

        local groupUrl = clean(args['组合链接'])

        if groupUrl then
            entity.memberOf.url = groupUrl
        end
    end

    -- DynamicJsonLD integration
    if not mw.ext or not mw.ext.JsonLD then
        return '<strong class="error">' ..
            'CharacterJsonLD: DynamicJsonLD Lua API unavailable' ..
            '</strong>'
    end

    local JsonLD = mw.ext.JsonLD

    if type(JsonLD.setMainEntity) ~= 'function' then
        return '<strong class="error">' ..
            'CharacterJsonLD: setMainEntity unavailable' ..
            '</strong>'
    end

    local ok, err = pcall(function()
        JsonLD.setMainEntity(entity)
    end)

    if not ok then
        return '<strong class="error">' ..
            'CharacterJsonLD: ' ..
            mw.text.encode(tostring(err)) ..
            '</strong>'
    end

    -- Temporary debug mode: |调试=1
    if clean(args['调试']) == '1' then
        return 'JSONLD_SUCCESS: ' .. name
    end

    return ''
end

return p