Module:PageSummary

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

local p = {}

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 firstImage = string.match(content, "%[%[([Ff]ile:.-)[|%]]") or 
                       string.match(content, "%[%[([Ii]mage:.-)[|%]]") or
                       string.match(content, "%[%[(文件:.-)[|%]]") or
                       string.match(content, "%[%[(圖像:.-)[|%]]")

    -- 2. 清理正文：移除所有圖片標籤、模板、注釋、引用
    local cleanText = content
    cleanText = string.gsub(cleanText, "<ref.-</ref>", "")
    cleanText = string.gsub(cleanText, "<ref.->", "")
    cleanText = string.gsub(cleanText, "<!%-%-.-%-%->", "")
    -- 移除所有圖片鏈接，防止摘要中出現多餘圖片
    cleanText = string.gsub(cleanText, "%[%[[Ff]ile:.-%]%]", "")
    cleanText = string.gsub(cleanText, "%[%[[Ii]mage:.-%]%]", "")
    cleanText = string.gsub(cleanText, "%[%[文件:.-%]%]", "")
    cleanText = string.gsub(cleanText, "%[%[圖像:.-%]%]", "")
    
    -- 移除模板
    local limit = 10
    while string.find(cleanText, "{{.-}}") and limit > 0 do
        cleanText = string.gsub(cleanText, "{{[^{}]+}}", "")
        limit = limit - 1
    end
    
    cleanText = mw.text.trim(cleanText)
    cleanText = string.gsub(cleanText, "\n", " ")

    -- 3. 智能截斷邏輯：如果 100 字處於連結中間，則延展到連結結束
    local targetLen = 100
    local summary = ""
    local fullLen = mw.ustring.len(cleanText)

    if fullLen <= targetLen then
        summary = cleanText
    else
        summary = mw.ustring.sub(cleanText, 1, targetLen)
        
        -- 檢查是否截斷在了連結 [[...]] 中間
        local restText = mw.ustring.sub(cleanText, targetLen + 1)
        
        -- 判斷 summary 中最後一個 [[ 是否有對應的 ]]
        local lastOpen = 0
        local lastClose = 0
        local tempPos = 0
        while true do
            local found = string.find(summary, "%[%[", tempPos + 1)
            if not found then break end
            lastOpen = found
            tempPos = found
        end
        tempPos = 0
        while true do
            local found = string.find(summary, "%]%]", tempPos + 1)
            if not found then break end
            lastClose = found
            tempPos = found
        end

        -- 如果 [[ 在 ]] 之後，說明截斷點在連結內
        if lastOpen > lastClose then
            -- 在剩餘文本中尋找第一個出現的 ]]
            local endOfLink = string.find(restText, "%]%]")
            if endOfLink then
                summary = summary .. string.sub(restText, 1, endOfLink + 1)
            end
        end

        -- 檢查粗體 ''' 的處理 (同理)
        local _, boldTags = string.gsub(summary, "'''", "")
        if boldTags % 2 ~= 0 then
            local endOfBold = string.find(restText, "'''")
            if endOfBold then
                summary = summary .. string.sub(restText, 1, endOfBold + 2)
            end
        end

        summary = summary .. "..."
    end

    -- 4. 構建輸出容器
    local container = mw.html.create('div')
        :css({
            ['border'] = '1px solid #a2a9b1',
            ['background-color'] = '#f8f9fa',
            ['padding'] = '15px',
            ['margin'] = '10px 0',
            ['display'] = 'flow-root',
            ['border-radius'] = '4px'
        })

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

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

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

    return tostring(container)
end

return p