跳转到内容

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 p._main(args, frame, type)
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("&#123;&#123;%s[[%s|%s]]&#125;&#125;", 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("&#123;&#123;%s%s&#125;&#125;", 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 = '[[Help:快捷方式|快捷方式]]'
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 args.float == 'left' then
if options.float and options.float:lower() == 'left' then
shortcutList:addClass('module-shortcutboxplain-left')
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
list:tag('li'):wikitext(noRedirect(shortcut))
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(tools.shallowClone(args), frame, 'mbox')
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("&#123;&#123;%s[[%s|%s]]&#125;&#125;", 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("&#123;&#123;%s%s&#125;&#125;", 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