Module:Shortcut:修订间差异
外观
删除的内容 添加的内容
来源:求闻编者,https://www.qiuwenbaike.cn/wiki/Module:Shortcut,许可证:CC BY-SA 4.0(https://creativecommons.org/licenses/by-sa/4.0/) |
enwiki>Nux nowrap per https://en.wikipedia.org/wiki/Template_talk:Shortcut#c-FaviFake-20260803192700-ER_nowrap 标签:已被回退 |
||
| 第1行: | 第1行: | ||
-- This module implements {{shortcut}}. |
-- This module implements {{shortcut}}. |
||
-- Set constants |
|||
local CONFIG_MODULE = 'Module:Shortcut/config' |
|||
-- Load required modules |
-- Load required modules |
||
local checkType = require('libraryUtil').checkType |
local checkType = require('libraryUtil').checkType |
||
local yesno = require('Module:Yesno') |
local yesno = require('Module:Yesno') |
||
local tools = require 'Module:TableTools' |
|||
local compressArray = tools.compressArray |
|||
local function noRedirect(page) |
|||
local isRedirect = require 'Module:Redirect'.luaIsRedirect(page) |
|||
if isRedirect then |
|||
return require 'Module:Fullurl'._fullurl2(page, {redirect='no'}, page) |
|||
else |
|||
return '[[:' .. page .. ']]' |
|||
end |
|||
end |
|||
local p = {} |
local p = {} |
||
function |
local function message(msg, ...) |
||
return mw.message.newRawMessage(msg, ...):plain() |
|||
args = args or {} |
|||
end |
|||
local function makeCategoryLink(cat) |
|||
return string.format('[[%s:%s]]', mw.site.namespaces[14].name, cat) |
|||
end |
|||
function p._main(shortcuts, options, frame, cfg) |
|||
checkType('_main', 1, shortcuts, 'table') |
|||
checkType('_main', 2, options, 'table', true) |
|||
options = options or {} |
|||
frame = frame or mw.getCurrentFrame() |
frame = frame or mw.getCurrentFrame() |
||
cfg = cfg or mw.loadData(CONFIG_MODULE) |
|||
local isCategorized = not yesno(args.nocat) |
|||
local templateMode = options.template and yesno(options.template) |
|||
local redirectMode = options.redirect and yesno(options.redirect) |
|||
local isCategorized = not options.category or yesno(options.category) ~= false |
|||
-- Validate shortcuts |
|||
for i, shortcut in ipairs(shortcuts) do |
|||
if type(shortcut) ~= 'string' or #shortcut < 1 then |
|||
error(message(cfg['invalid-shortcut-error'], i), 2) |
|||
end |
|||
end |
|||
-- Make the list items. These are the shortcuts plus any extra lines such |
|||
-- as options.msg. |
|||
local listItems = {} |
|||
for i, shortcut in ipairs(shortcuts) do |
|||
local templatePath, prefix |
|||
if templateMode then |
|||
-- Namespace detection |
|||
local titleObj = mw.title.new(shortcut, 10) |
|||
if titleObj.namespace == 10 then |
|||
templatePath = titleObj.fullText |
|||
else |
|||
templatePath = shortcut |
|||
end |
|||
prefix = options['pre' .. i] or options.pre or '' |
|||
end |
|||
if options.target and yesno(options.target) then |
|||
listItems[i] = templateMode |
|||
and string.format("{{%s[[%s|%s]]}}", prefix, templatePath, shortcut) |
|||
or string.format("[[%s]]", shortcut) |
|||
else |
|||
listItems[i] = frame:expandTemplate{ |
|||
title = 'No redirect', |
|||
args = templateMode and {templatePath, shortcut} or {shortcut, shortcut} |
|||
} |
|||
if templateMode then |
|||
listItems[i] = string.format("{{%s%s}}", prefix, listItems[i]) |
|||
end |
|||
end |
|||
-- Wrap each shortcut in a nowrap span |
|||
-- e.g. [[WP:CFORK/I]] in [[Special:PermanentLink/1366587294]] |
|||
listItems[i] = string.format('<span class="nowrap">%s</span>', listItems[i]) |
|||
end |
|||
table.insert(listItems, options.msg) |
|||
-- Return an error if we have nothing to display |
|||
-- 验证快捷方式是否有效。 |
|||
if #listItems < 1 then |
|||
for i, shortcut in tools.sparseIpairs(args) do |
|||
local msg = cfg['no-content-error'] |
|||
if _G.type(shortcut) ~= 'string' or #shortcut < 1 then |
|||
msg = string.format('<strong class="error">%s</strong>', msg) |
|||
error('无效的快捷方式:“' .. tostring(shortcut) .. '”,请确保该参数必须是字符串且至少一个字符', 2) |
|||
if isCategorized and cfg['no-content-error-category'] then |
|||
msg = msg .. makeCategoryLink(cfg['no-content-error-category']) |
|||
end |
end |
||
return msg |
|||
end |
end |
||
local root = mw.html.create() |
local root = mw.html.create() |
||
root:wikitext(frame:extensionTag{ name = 'templatestyles', args = { |
root:wikitext(frame:extensionTag{ name = 'templatestyles', args = { src = 'Module:Shortcut/styles.css'} }) |
||
-- Anchors |
|||
src = type == 'mbox' and 'Template:Mbox/shortcut.css' or 'Shortcut/styles.css' |
|||
local anchorDiv = root |
|||
} }) |
|||
:tag('div') |
|||
:addClass('module-shortcutanchordiv') |
|||
for i, shortcut in ipairs(shortcuts) do |
|||
local anchor = mw.uri.anchorEncode(shortcut) |
|||
anchorDiv:tag('span'):attr('id', anchor) |
|||
end |
|||
-- Shortcut heading |
-- Shortcut heading |
||
local shortcutHeading |
local shortcutHeading |
||
do |
|||
if yesno(args.policy) then |
|||
local nShortcuts = #shortcuts |
|||
shortcutHeading = '[[Help:快捷方式|方针快捷方式]]' |
|||
if nShortcuts > 0 then |
|||
local headingMsg = options['shortcut-heading'] or |
|||
redirectMode and cfg['redirect-heading'] or |
|||
cfg['shortcut-heading'] |
|||
shortcutHeading = message(headingMsg, nShortcuts) |
|||
shortcutHeading = frame:preprocess(shortcutHeading) |
|||
end |
|||
end |
end |
||
| 第45行: | 第107行: | ||
:tag('div') |
:tag('div') |
||
:addClass('module-shortcutboxplain noprint') |
:addClass('module-shortcutboxplain noprint') |
||
:addClass(type == 'Mbox' and 'module-mboxshortcutplain' or nil) |
|||
:attr('role', 'note') |
:attr('role', 'note') |
||
if |
if options.float and options.float:lower() == 'left' then |
||
shortcutList:addClass('module- |
shortcutList:addClass('module-shortcutboxleft') |
||
end |
|||
if options.clear and options.clear ~= '' then |
|||
shortcutList:css('clear', options.clear) |
|||
end |
end |
||
if shortcutHeading then |
if shortcutHeading then |
||
| 第56行: | 第120行: | ||
:wikitext(shortcutHeading) |
:wikitext(shortcutHeading) |
||
end |
end |
||
local list = shortcutList:tag('ul') |
|||
local ubl = require('Module:List').unbulleted(listItems) |
|||
for i, shortcut in ipairs(args) do |
|||
shortcutList:wikitext(ubl) |
|||
end |
|||
return tostring(root) |
return tostring(root) |
||
end |
end |
||
| 第66行: | 第129行: | ||
local args = require('Module:Arguments').getArgs(frame) |
local args = require('Module:Arguments').getArgs(frame) |
||
-- Separate shortcuts from options |
|||
return p._main(tools.shallowClone(args), frame) |
|||
local shortcuts, options = {}, {} |
|||
end |
|||
for k, v in pairs(args) do |
|||
if type(k) == 'number' then |
|||
shortcuts[k] = v |
|||
else |
|||
options[k] = v |
|||
end |
|||
end |
|||
-- Compress the shortcut array, which may contain nils. |
|||
function p._ombx(args, frame, type) |
|||
local function compressArray(t) |
|||
error '请直接使用_main方法而非_ombox,并将type参数设为 "mbox"' |
|||
local nums, ret = {}, {} |
|||
end |
|||
for k in pairs(t) do |
|||
nums[#nums + 1] = k |
|||
-- @deprecated |
|||
end |
|||
function p.ombox(frame) |
|||
table.sort(nums) |
|||
local args = require('Module:Arguments').getArgs(frame) |
|||
for i, num in ipairs(nums) do |
|||
ret[i] = t[num] |
|||
end |
|||
return ret |
|||
end |
|||
shortcuts = compressArray(shortcuts) |
|||
return p._main( |
return p._main(shortcuts, options, frame) |
||
end |
end |
||
p.mbox = p.ombox |
|||
function p._template(args, frame, type) |
|||
error '请直接使_main(args, frame, type)而非_template' |
|||
end |
|||
function p.template(frame) |
|||
local args = require('Module:Arguments').getArgs(frame) |
|||
return p._main(tools.shallowClone(args), frame, 'template') |
|||
end |
|||
function p._ombx_template(args, frame, type) |
|||
error '请直接使用_main(args, frame, "mbox")而非_ombox_template' |
|||
end |
|||
-- @deprecated |
|||
function p.ombox_template(frame) |
|||
local args = require('Module:Arguments').getArgs(frame) |
|||
return p._main(args, frame, 'mbox') |
|||
end |
|||
p.mbox_template = p.ombox_template |
|||
return p |
return p |
||
2026年9月20日 (日) 14:55的版本
Template:Lua sidebar 本模組可以產出一個文字方塊,顯示可連結至某個頁面的捷徑。
用法
用於Wiki標記語法
如果要從Wiki標記語法引入,本模板應當從某個模板進行呼叫,通常使用的模板為模板链接:{{shortcut}}。請參考該模板的文件說明。然而,您也可以用Wiki標記語法進行呼叫:。
{{#invoke:shortcut|main|捷徑}}
用於Lua
如果要從Lua使用本模組,首先請讀取本模板。
local mShortcut = require('Module:Shortcut')
然後您可以依據下列語法建立捷徑方塊:
mShortcut._main(shortcuts, options, frame, cfg)
- shortcuts為捷徑頁的名稱陣列(必填)。
- options為表格偏好設定,支援下列參數:
msg- 顯示捷徑列表之後的訊息。category- 如果設為no,則隱藏分類,不建議使用。(調用Module:Yesno)
- frame a frame object. This is optional, and only intended to be used internally.
- cfg - 表格格式測試,正常情況下請不要使用,該參數應僅供測試。
技術細節
本模組有一份組態檔案Module:Shortcut/config。該檔案可將本模板翻譯成不同的語言,或是改變分類名稱的細節。
-- This module implements {{shortcut}}.
-- Set constants
local CONFIG_MODULE = 'Module:Shortcut/config'
-- Load required modules
local checkType = require('libraryUtil').checkType
local yesno = require('Module:Yesno')
local p = {}
local function message(msg, ...)
return mw.message.newRawMessage(msg, ...):plain()
end
local function makeCategoryLink(cat)
return string.format('[[%s:%s]]', mw.site.namespaces[14].name, cat)
end
function p._main(shortcuts, options, frame, cfg)
checkType('_main', 1, shortcuts, 'table')
checkType('_main', 2, options, 'table', true)
options = options or {}
frame = frame or mw.getCurrentFrame()
cfg = cfg or mw.loadData(CONFIG_MODULE)
local templateMode = options.template and yesno(options.template)
local redirectMode = options.redirect and yesno(options.redirect)
local isCategorized = not options.category or yesno(options.category) ~= false
-- Validate shortcuts
for i, shortcut in ipairs(shortcuts) do
if type(shortcut) ~= 'string' or #shortcut < 1 then
error(message(cfg['invalid-shortcut-error'], i), 2)
end
end
-- Make the list items. These are the shortcuts plus any extra lines such
-- as options.msg.
local listItems = {}
for i, shortcut in ipairs(shortcuts) do
local templatePath, prefix
if templateMode then
-- Namespace detection
local titleObj = mw.title.new(shortcut, 10)
if titleObj.namespace == 10 then
templatePath = titleObj.fullText
else
templatePath = shortcut
end
prefix = options['pre' .. i] or options.pre or ''
end
if options.target and yesno(options.target) then
listItems[i] = templateMode
and string.format("{{%s[[%s|%s]]}}", prefix, templatePath, shortcut)
or string.format("[[%s]]", shortcut)
else
listItems[i] = frame:expandTemplate{
title = 'No redirect',
args = templateMode and {templatePath, shortcut} or {shortcut, shortcut}
}
if templateMode then
listItems[i] = string.format("{{%s%s}}", prefix, listItems[i])
end
end
-- Wrap each shortcut in a nowrap span
-- e.g. [[WP:CFORK/I]] in [[Special:PermanentLink/1366587294]]
listItems[i] = string.format('<span class="nowrap">%s</span>', listItems[i])
end
table.insert(listItems, options.msg)
-- Return an error if we have nothing to display
if #listItems < 1 then
local msg = cfg['no-content-error']
msg = string.format('<strong class="error">%s</strong>', msg)
if isCategorized and cfg['no-content-error-category'] then
msg = msg .. makeCategoryLink(cfg['no-content-error-category'])
end
return msg
end
local root = mw.html.create()
root:wikitext(frame:extensionTag{ name = 'templatestyles', args = { src = 'Module:Shortcut/styles.css'} })
-- Anchors
local anchorDiv = root
:tag('div')
:addClass('module-shortcutanchordiv')
for i, shortcut in ipairs(shortcuts) do
local anchor = mw.uri.anchorEncode(shortcut)
anchorDiv:tag('span'):attr('id', anchor)
end
-- Shortcut heading
local shortcutHeading
do
local nShortcuts = #shortcuts
if nShortcuts > 0 then
local headingMsg = options['shortcut-heading'] or
redirectMode and cfg['redirect-heading'] or
cfg['shortcut-heading']
shortcutHeading = message(headingMsg, nShortcuts)
shortcutHeading = frame:preprocess(shortcutHeading)
end
end
-- Shortcut box
local shortcutList = root
:tag('div')
:addClass('module-shortcutboxplain noprint')
:attr('role', 'note')
if options.float and options.float:lower() == 'left' then
shortcutList:addClass('module-shortcutboxleft')
end
if options.clear and options.clear ~= '' then
shortcutList:css('clear', options.clear)
end
if shortcutHeading then
shortcutList
:tag('div')
:addClass('module-shortcutlist')
:wikitext(shortcutHeading)
end
local ubl = require('Module:List').unbulleted(listItems)
shortcutList:wikitext(ubl)
return tostring(root)
end
function p.main(frame)
local args = require('Module:Arguments').getArgs(frame)
-- Separate shortcuts from options
local shortcuts, options = {}, {}
for k, v in pairs(args) do
if type(k) == 'number' then
shortcuts[k] = v
else
options[k] = v
end
end
-- Compress the shortcut array, which may contain nils.
local function compressArray(t)
local nums, ret = {}, {}
for k in pairs(t) do
nums[#nums + 1] = k
end
table.sort(nums)
for i, num in ipairs(nums) do
ret[i] = t[num]
end
return ret
end
shortcuts = compressArray(shortcuts)
return p._main(shortcuts, options, frame)
end
return p