Module:PageSummary

2026-02-18T04:07:42Z

240D:C010:132:2:0:0:0:A6：

local p = {}

-- 供其他 Lua 模块调用的内部函数
function p._getSummary(pageName)
if not pageName or pageName == "" then
return "<span class='error'>请输入有效的条目名称。</span>"
end

local title = mw.title.new(pageName)
if not title or not title.exists then
return "<span class='error'>条目“" .. pageName .. "”不存在。</span>"
end

local content = title:getContent()
if not content then
return "<span class='error'>无法获取条目内容。</span>"
end

-- 1. 提取首张图片 (匹配常用图片命名空间)
-- 注意：不区分大小写，使用简单的正则匹配查找最早出现的文件
local firstImage = mw.ustring.match(content, "%[%[%s*[Ff][Ii][Ll][Ee]%s*:([^|%]]+)")
or mw.ustring.match(content, "%[%[%s*[Ii][Mm][Aa][Gg][Ee]%s*:([^|%]]+)")
or mw.ustring.match(content, "%[%[%s*文件%s*:([^|%]]+)")
or mw.ustring.match(content, "%[%[%s*檔案%s*:([^|%]]+)")
or mw.ustring.match(content, "%[%[%s*图片%s*:([^|%]]+)")
or mw.ustring.match(content, "%[%[%s*图像%s*:([^|%]]+)")

-- 2. 纯文本清理流程
local text = content

-- 屏蔽重定向页面
if mw.ustring.match(text, "^%s*#REDIRECT") or mw.ustring.match(text, "^%s*#重定向") then
return "该页面是一个重定向页面。"
end

-- 去除 HTML 注释
text = mw.ustring.gsub(text, "<!%-%-.-%-%->", "")

-- 去除部分可能干扰正文的 HTML 标签及其内容
text = mw.ustring.gsub(text, "<ref[^>]*>.-</ref>", "")
text = mw.ustring.gsub(text, "<ref[^>]-/>", "")
text = mw.ustring.gsub(text, "<math[^>]*>.-</math>", "")
text = mw.ustring.gsub(text, "<gallery[^>]*>.-</gallery>", "")
text = mw.ustring.gsub(text, "<div[^>]*>.-</div>", "")
text = mw.ustring.gsub(text, "<table[^>]*>.-</table>", "")

-- 循环去除模板 {{ ... }} (添加计数器防死循环)
local prev, count
count = 0
repeat
prev = text
text = mw.ustring.gsub(text, "{{[^{}]-}}", "")
count = count + 1
until text == prev or count > 50

-- 循环去除表格 {| ... |}
count = 0
repeat
prev = text
text = mw.ustring.gsub(text, "{|.-|}", "")
count = count + 1
until text == prev or count > 30

-- 去除章节标题 == 标题 ==
text = mw.ustring.gsub(text, "==+.-==+", "")

-- 核心逻辑：由内向外剥离中括号 [[ ... ]]
-- 这样可以安全处理诸如 [[File:xx.jpg|thumb|这是一个[[内链]]]] 的嵌套情况
count = 0
repeat
prev = text
text = mw.ustring.gsub(text, "%[%[([^%[%]]-)%]%]", function(inner)
local upperInner = mw.ustring.upper(inner)
-- 如果是文件、图片或分类，直接整块抹除
if mw.ustring.match(upperInner, "^%s*FILE%s*:") or
mw.ustring.match(upperInner, "^%s*IMAGE%s*:") or
mw.ustring.match(inner, "^%s*文件%s*:") or
mw.ustring.match(inner, "^%s*檔案%s*:") or
mw.ustring.match(inner, "^%s*图片%s*:") or
mw.ustring.match(inner, "^%s*图像%s*:") or
mw.ustring.match(upperInner, "^%s*CATEGORY%s*:") or
mw.ustring.match(inner, "^%s*分类%s*:") or
mw.ustring.match(inner, "^%s*分類%s*:") then
return ""
end
-- 如果是普通内链 [[链接|显示文本]]，保留最后的显示文本
local parts = mw.text.split(inner, "|")
return parts[#parts]
end)
count = count + 1
until text == prev or count > 50

-- 去除粗体和斜体 (''' 和 '')
text = mw.ustring.gsub(text, "''+", "")

-- 去除残留的单层 HTML 标签 (如 <br>, <span>)
text = mw.ustring.gsub(text, "<[^>]+>", "")

-- 合并多余的换行和空格
text = mw.ustring.gsub(text, "%s+", " ")

-- 去除开头可能残留的乱码标点（因为移除了前面的信息框，这里容易留下逗号或右括号）
text = mw.ustring.gsub(text, "^[%s,%.:;%?!)］】」》”’>|]+", "")
text = mw.ustring.gsub(text, "^[，。、；：？！]+", "")
text = mw.text.trim(text)

-- 3. 截取前约 100 个字符 (由于使用的是 mw.ustring，完美支持中文字符计算)
local summary = mw.ustring.sub(text, 1, 100)
if mw.ustring.len(text) > 100 then
summary = summary .. "..."
end

-- 4. 使用 mw.html 组装最终输出的 UI
local container = mw.html.create('div')
:cssText('display: flex; gap: 15px; align-items: flex-start; padding: 15px; border: 1px solid #eaecf0; border-radius: 6px; background: #f8f9fa; margin-bottom: 1em;')

if firstImage then
container:tag('div')
:cssText('flex: 0 0 120px; border-radius: 4px; overflow: hidden;')
:wikitext("[[File:" .. firstImage .. "|120px|frameless]]")
end

container:tag('div')
:cssText('flex-grow: 1; font-size: 0.95em; line-height: 1.6; color: #202122;')
:wikitext(summary)

return tostring(container)
end

-- 供 Wikitext 中 {{#invoke:}} 调用的主函数
function p.main(frame)
-- 优先获取模板传递的参数，如果没有，再尝试获取直接 Invoke 传递的参数
local args = frame:getParent().args
if not args[1] or args[1] == "" then
args = frame.args
end

return p._getSummary(args[1])
end

return p

武外梗百科 - 用户贡献 [zh]

Module:PageSummary