Module:PageSummary

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

local p = {}

-- 安全剥离函数：专门处理嵌套的 [[ ]]，防止图片碎片
local function ultraStrip(text)
    if not text then return "" end
    local result = text

    -- 1. 移除引用和注释
    result = string.gsub(result, "<ref.-</ref>", "")
    result = string.gsub(result, "<ref.->", "")
    result = string.gsub(result, "<!%-%-.-%-%->", "")

    -- 2. 移除图片标签（处理嵌套链接）
    local prefixes = {"[[File:", "[[Image:", "[[文件:", "[[图像:"}
    for _, pre in ipairs(prefixes) do
        while true do
            local startPos = string.find(result, pre, 1, true)
            if not startPos then break end
            
            -- 寻找匹配的闭合括号
            local level = 0
            local endPos = nil
            for j = startPos, mw.ustring.len(result) do
                local char2 = mw.ustring.sub(result, j, j + 1)
                if char2 == "[[" then
                    level = level + 1
                elseif char2 == "]]" then
                    level = level - 1
                    if level == 0 then
                        endPos = j + 1
                        break
                    end
                end
            end
            
            if endPos then
                result = mw.ustring.sub(result, 1, startPos - 1) .. mw.ustring.sub(result, endPos + 1)
            else
                -- 语法错误熔断：只切掉起始符
                result = mw.ustring.sub(result, 1, startPos - 1) .. mw.ustring.sub(result, startPos + 2)
            end
        end
    end

    -- 3. 移除模板 (不递归，只跑3次，确保性能)
    for i = 1, 3 do
        result = string.gsub(result, "{{[^{}]+}}", "")
    end

    -- 4. 移除 Wiki 格式符号
    result = string.gsub(result, "\n==+.-==+", " ")
    result = string.gsub(result, "\n%s*[*#:]+", " ")
    result = string.gsub(result, "&[Nn][Bb][Ss][Pp];", " ")
    result = string.gsub(result, "\n", " ")
    result = string.gsub(result, "%s+", " ")
    
    return mw.text.trim(result)
end

function p.getSummaryAndImage(frame)
    local pageName = frame.args[1] or ""
    local title = mw.title.new(pageName)
    if not title or not title.exists then return "" end
    
    local content = title:getContent()
    local rawExcerpt = mw.ustring.sub(content, 1, 500)

    -- 提取第一张图名（用于卡片显示）
    local firstImage = string.match(rawExcerpt, "%[%[([Ff]ile:[^|%]]+)") or 
                       string.match(rawExcerpt, "%[%[(文件:[^|%]]+)")

    -- 执行安全清理
    local cleanText = ultraStrip(rawExcerpt)

    -- 截断 150 字
    local targetLen = 150
    local summary = mw.ustring.sub(cleanText, 1, targetLen)
    
    -- 补全或切断末尾链接
    local _, opens = string.gsub(summary, "%[%[", "")
    local _, closes = string.gsub(summary, "%]%]", "")
    if opens > closes then
        local rest = mw.ustring.sub(cleanText, targetLen + 1, targetLen + 100)
        local endLink = string.find(rest, "]]", 1, true)
        if endLink then
            summary = summary .. string.sub(rest, 1, endLink + 1)
        else
            local lastOpen = string.find(summary:reverse(), "%[%[")
            if lastOpen then 
                summary = string.sub(summary, 1, #summary - lastOpen - 1) 
            end
        end
    end
    
    summary = mw.text.trim(summary)
    if mw.ustring.len(cleanText) > targetLen then 
        summary = summary .. "..." 
    end

    -- 渲染
    local container = mw.html.create('div'):css({['margin-bottom']='25px', ['display']='flow-root'})
    if firstImage then
        container:wikitext('[[' .. firstImage .. '|150px|right|link=' .. pageName .. ']]')
    end
    container:tag('div')
        :css({['font-size']='1.35em', ['font-weight']='bold', ['margin-bottom']='6px'})
        :wikitext('[[' .. pageName .. ']]')
    container:tag('div')
        :css({['line-height']='1.6', ['color']='#202122'})
        :wikitext(summary)

    return tostring(container)
end

return p