Module:PageSummary

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

local p = {}

-- 辅助函数：只移除不必要的干扰项（如模板、注释、引文），保留链接和加粗
local function cleanWikitextForDisplay(text)
    if not text then return "" end
    
    -- 1. 移除 <ref> 及其内容（避免摘要里出现 [1][2] 或引文列表）
    text = string.gsub(text, "<ref.-</ref>", "")
    text = string.gsub(text, "<ref.->", "")
    
    -- 2. 移除 HTML 注释
    text = string.gsub(text, "<!%-%-.-%-%->", "")

    -- 3. 移除模板 {{...}}（大部分模板在摘要里会显示异常）
    local limit = 10
    while string.find(text, "{{.-}}") and limit > 0 do
        text = string.gsub(text, "{{[^{}]+}}", "")
        limit = limit - 1
    end

    -- 4. 移除行首的标题符号（如 == 标题 ==）
    text = string.gsub(text, "\n==+.-==+", " ")
    
    -- 5. 将换行符转为空格，确保摘要连贯
    text = string.gsub(text, "\n", " ")

    return mw.text.trim(text)
end

-- 智能截断函数：在不破坏 [[ ]] 或 ''' ''' 的前提下截取字数
local function smartTruncate(text, length)
    local count = 0
    local result = ""
    local i = 1
    local len = mw.ustring.len(text)
    
    -- 简单的截取，如果刚好在标签中间截断，MediaWiki 解析器通常会自动修复
    -- 但为了保险，我们只截取纯文本长度，或者简单按长度切断
    if len <= length then return text end
    
    return mw.ustring.sub(text, 1, length) .. "..."
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()
    
    -- 1. 提取第一张图片
    local imagePattern = "%[%[(%a+:.-)[|%]]"
    local firstImage = string.match(content, imagePattern)
    
    -- 检查是否是合法的图片命名空间
    if firstImage then
        local ns = string.match(firstImage, "^([^:]+):")
        local validNs = {File=true, Image=true, ["文件"]=true, ["图像"]=true}
        if not ns or not validNs[ns] then firstImage = nil end
    end

    -- 2. 处理内容（保留链接和粗体）
    local processedText = cleanWikitextForDisplay(content)
    
    -- 3. 截取前 100 字
    local summary = smartTruncate(processedText, 100)

    -- 4. 渲染输出
    local container = mw.html.create('div')
        :css({
            ['border'] = '1px solid #a2a9b1',
            ['background-color'] = '#f8f9fa',
            ['padding'] = '12px',
            ['margin'] = '10px 0',
            ['border-radius'] = '2px',
            ['overflow'] = 'hidden'
        })

    if firstImage then
        container:tag('div')
            :css({['float'] = 'right', ['margin-left'] = '15px'})
            :wikitext('[[' .. firstImage .. '|120px|border]]')
    end

    container:tag('div')
        :css({['margin-bottom'] = '5px', ['font-weight'] = 'bold', ['font-size'] = '1.2em'})
        :wikitext('[[' .. pageName .. ']]')

    container:tag('div')
        :css({['line-height'] = '1.5'})
        :wikitext(summary)

    return tostring(container)
end

return p