DC 於 2025年5月13日 (二) 17:03

2025-05-13T17:03:14Z

←上個修訂		於 2025年5月14日 (三) 01:03 的修訂
第9行：		第9行：

	local mArguments --initialize lazily		local mArguments --initialize lazily
			local mFormatLink = require('Module:Format link')
	local mHatnote = require('Module:Hatnote')		local mHatnote = require('Module:Hatnote')
	local libraryUtil = require('libraryUtil')		local libraryUtil = require('libraryUtil')
第28行：		第29行：
	altSeparator = "；",		altSeparator = "；",
	space = "",		space = "",
	formatted = false		formatted = false,
			boldfaced = false,
			quotes = false
	}		}

			--Searches display text only
			local function searchDisp(haystack, needle)
			return string.find(
			string.sub(haystack, (string.find(haystack, '\|') or 0) + 1), needle
			)
			end

	-- Stringifies a list generically; probably shouldn't be used directly		-- Stringifies a list generically; probably shouldn't be used directly
	function stringifyList(list, options)		local function stringifyList(list, options)
	-- Type-checks, defaults, and a shortcut		-- Type-checks, defaults, and a shortcut
	checkType("stringifyList", 1, list, "table")		checkType("stringifyList", 1, list, "table")
第43行：		第53行：
	local s = options.space		local s = options.space
	-- Format the list if requested		-- Format the list if requested
	if options.formatted then list = ~~mHatnote~~.formatPages(~~unpack(~~list)) end		if options.formatted then
			list = mFormatLink.formatPages(
			{}, list
			)
			end
	-- Set the separator; if any item contains it, use the alternate separator		-- Set the separator; if any item contains it, use the alternate separator
	local separator = options.separator		local separator = options.separator
	~~--searches display text only~~
	~~function searchDisp(t, f)~~
	~~return string.find(string.sub(t, (string.find(t, '\|') or 0) + 1), f)~~
	~~end~~
	for k, v in pairs(list) do		for k, v in pairs(list) do
			-- 本地化注意
			if options.boldfaced then
			list[k] = '\'\'\'' .. list[k] .. '\'\'\''
			end
			if options.quotes then
			list[k] = '「' .. list[k] .. '」'
			end
	if searchDisp(v, separator) then		if searchDisp(v, separator) then
	separator = options.altSeparator		separator = options.altSeparator
第68行：		第85行：

	--DRY function		--DRY function
	function conjList (conj, list, fmt)		-- 本地化注意
	return stringifyList(list, {conjunction = conj, formatted = fmt})		function conjList (conj, list, fmt, bold, quo)
			return stringifyList(list, {conjunction = conj, formatted = fmt, boldfaced = bold, quotes=quo})
	end		end

第90行：		第108行：
	title = mw.title.getCurrentTitle().text,		title = mw.title.getCurrentTitle().text,
	otherText = '其他用法',		otherText = '其他用法',
	forSeeForm = '關於%~~s，請參見~~%s。',		forSeeForm = '关于%s，请见%s。',
	}		}

第154行：		第172行：
	-- until the "and"'s stop. Blanks are ignored: "1\|and\|\|and\|3" → {1, 3}		-- until the "and"'s stop. Blanks are ignored: "1\|and\|\|and\|3" → {1, 3}
	while args[i + 2] == options.andKeyword do		while args[i + 2] == options.andKeyword do
	if args[i + 3] then		if args[i + 3] then
	table.insert(forRow.pages, args[i + 3])		table.insert(forRow.pages, args[i + 3])
	end		end
第165行：		第183行：
	table.insert(forTable, forRow)		table.insert(forTable, forRow)
	until terminated or i > maxArg		until terminated or i > maxArg

	return forTable		return forTable
	end		end
第183行：		第201行：
	for k, v in pairs(forSeeTable) do		for k, v in pairs(forSeeTable) do
	local useStr = v.use or options.otherText		local useStr = v.use or options.otherText
	local pagesStr = p.andList(v.pages, true) or ~~mHatnote~~._formatLink(mHatnote.disambiguate(options.title))		-- 本地化注意
			local pagesStr = p.andList(v.pages, true, true, true) or '「\'\'\'' .. mFormatLink._formatLink{link = mHatnote.disambiguate(options.title)} .. '\'\'\'」'
	local forSeeStr = string.format(options.forSeeForm, useStr, pagesStr)		local forSeeStr = string.format(options.forSeeForm, useStr, pagesStr)
	forSeeStr = punctuationCollapse(forSeeStr)		forSeeStr = punctuationCollapse(forSeeStr)
第189行：		第208行：
	end		end
	end		end
	if options.extratext then table.insert(strList, punctuationCollapse(options.extratext..'.')) end		if options.extratext then table.insert(strList, punctuationCollapse(options.extratext..'。')) end
	-- Return the concatenated list		-- Return the concatenated list
	return table.concat(strList~~, ' '~~)		return table.concat(strList)
	end		end

imported>DC：建立內容為「-------------------------------------------------------------------------------- -- Module:Hatnote list --…」的新頁面

2021-03-31T14:32:07Z

建立內容為「-------------------------------------------------------------------------------- -- Module:Hatnote list --…」的新頁面

新頁面

--------------------------------------------------------------------------------
-- Module:Hatnote list --
-- --
-- This module produces and formats lists for use in hatnotes. In particular, --
-- it implements the for-see list, i.e. lists of "For X, see Y" statements, --
-- as used in {{about}}, {{redirect}}, and their variants. Also introduced --
-- are andList & orList helpers for formatting lists with those conjunctions. --
--------------------------------------------------------------------------------

local mArguments --initialize lazily
local mHatnote = require('Module:Hatnote')
local libraryUtil = require('libraryUtil')
local checkType = libraryUtil.checkType
local p = {}

--------------------------------------------------------------------------------
-- List stringification helper functions
--
-- These functions are used for stringifying lists, usually page lists inside
-- the "Y" portion of "For X, see Y" for-see items.
--------------------------------------------------------------------------------

--default options table used across the list stringification functions
-- 本地化注意
local stringifyListDefaultOptions = {
conjunction = "和",
separator = "、",
altSeparator = "；",
space = "",
formatted = false
}

-- Stringifies a list generically; probably shouldn't be used directly
function stringifyList(list, options)
-- Type-checks, defaults, and a shortcut
checkType("stringifyList", 1, list, "table")
if #list == 0 then return nil end
checkType("stringifyList", 2, options, "table", true)
options = options or {}
for k, v in pairs(stringifyListDefaultOptions) do
if options[k] == nil then options[k] = v end
end
local s = options.space
-- Format the list if requested
if options.formatted then list = mHatnote.formatPages(unpack(list)) end
-- Set the separator; if any item contains it, use the alternate separator
local separator = options.separator
--searches display text only
function searchDisp(t, f)
return string.find(string.sub(t, (string.find(t, '|') or 0) + 1), f)
end
for k, v in pairs(list) do
if searchDisp(v, separator) then
separator = options.altSeparator
break
end
end
-- Set the conjunction, apply Oxford comma, and force a comma if #1 has "§"
local conjunction = s .. options.conjunction .. s
-- 本地化注意
-- separator .. conjunction的结果是“、和”
-- if #list == 2 and searchDisp(list[1], "§") or #list > 2 then
-- conjunction = separator .. conjunction
-- end
-- Return the formatted string
return mw.text.listToText(list, separator .. s, conjunction)
end

--DRY function
function conjList (conj, list, fmt)
return stringifyList(list, {conjunction = conj, formatted = fmt})
end

-- Stringifies lists with "and" or "or"
-- 本地化注意
function p.andList (...) return conjList("和", ...) end
function p.orList (...) return conjList("或", ...) end

--------------------------------------------------------------------------------
-- For see
--
-- Makes a "For X, see [[Y]]." list from raw parameters. Intended for the
-- {{about}} and {{redirect}} templates and their variants.
--------------------------------------------------------------------------------

--default options table used across the forSee family of functions
-- 本地化注意
local forSeeDefaultOptions = {
andKeyword = '和',
title = mw.title.getCurrentTitle().text,
otherText = '其他用法',
forSeeForm = '關於%s，請參見%s。',
}

--Collapses duplicate punctuation
-- 本地化注意
function punctuationCollapse (text)
local replacements = {
["%.%.$"] = ".",
["%?%.$"] = "?",
["%!%.$"] = "!",
["%.%]%]%.$"] = ".]]",
["%?%]%]%.$"] = "?]]",
["%!%]%]%.$"] = "!]]",
["%。%。$"] = "。",
["%？%。$"] = "?",
["%！%。$"] = "！",
["%。%]%]%。$"] = "。]]",
["%？%]%]%。$"] = "？]]",
["%！%]%]%。$"] = "！]]"
}
for k, v in pairs(replacements) do text = string.gsub(text, k, v) end
return text
end

-- Structures arguments into a table for stringification, & options
function p.forSeeArgsToTable (args, from, options)
-- Type-checks and defaults
checkType("forSeeArgsToTable", 1, args, 'table')
checkType("forSeeArgsToTable", 2, from, 'number', true)
from = from or 1
checkType("forSeeArgsToTable", 3, options, 'table', true)
options = options or {}
for k, v in pairs(forSeeDefaultOptions) do
if options[k] == nil then options[k] = v end
end
-- maxArg's gotten manually because getArgs() and table.maxn aren't friends
local maxArg = 0
for k, v in pairs(args) do
if type(k) == 'number' and k > maxArg then maxArg = k end
end
-- Structure the data out from the parameter list:
-- * forTable is the wrapper table, with forRow rows
-- * Rows are tables of a "use" string & a "pages" table of pagename strings
-- * Blanks are left empty for defaulting elsewhere, but can terminate list
local forTable = {}
local i = from
local terminated = false
-- If there is extra text, and no arguments are given, give nil value
-- to not produce default of "For other uses, see foo (disambiguation)"
if options.extratext and i > maxArg then return nil end
-- Loop to generate rows
repeat
-- New empty row
local forRow = {}
-- On blank use, assume list's ended & break at end of this loop
forRow.use = args[i]
if not args[i] then terminated = true end
-- New empty list of pages
forRow.pages = {}
-- Insert first pages item if present
table.insert(forRow.pages, args[i + 1])
-- If the param after next is "and", do inner loop to collect params
-- until the "and"'s stop. Blanks are ignored: "1|and||and|3" → {1, 3}
while args[i + 2] == options.andKeyword do
if args[i + 3] then
table.insert(forRow.pages, args[i + 3])
end
-- Increment to next "and"
i = i + 2
end
-- Increment to next use
i = i + 2
-- Append the row
table.insert(forTable, forRow)
until terminated or i > maxArg

return forTable
end

-- Stringifies a table as formatted by forSeeArgsToTable
function p.forSeeTableToString (forSeeTable, options)
-- Type-checks and defaults
checkType("forSeeTableToString", 1, forSeeTable, "table", true)
checkType("forSeeTableToString", 2, options, "table", true)
options = options or {}
for k, v in pairs(forSeeDefaultOptions) do
if options[k] == nil then options[k] = v end
end
-- Stringify each for-see item into a list
local strList = {}
if forSeeTable then
for k, v in pairs(forSeeTable) do
local useStr = v.use or options.otherText
local pagesStr = p.andList(v.pages, true) or mHatnote._formatLink(mHatnote.disambiguate(options.title))
local forSeeStr = string.format(options.forSeeForm, useStr, pagesStr)
forSeeStr = punctuationCollapse(forSeeStr)
table.insert(strList, forSeeStr)
end
end
if options.extratext then table.insert(strList, punctuationCollapse(options.extratext..'.')) end
-- Return the concatenated list
return table.concat(strList, ' ')
end

-- Produces a "For X, see [[Y]]" string from arguments. Expects index gaps
-- but not blank/whitespace values. Ignores named args and args < "from".
function p._forSee (args, from, options)
local forSeeTable = p.forSeeArgsToTable(args, from, options)
return p.forSeeTableToString(forSeeTable, options)
end

-- As _forSee, but uses the frame.
function p.forSee (frame, from, options)
mArguments = require('Module:Arguments')
return p._forSee(mArguments.getArgs(frame), from, options)
end

return p

模組:Hatnote list - 修訂歷史

DC 於 2025年5月13日 (二) 17:03

imported>DC：​建立內容為「-------------------------------------------------------------------------------- -- Module:Hatnote list --…」的新頁面

imported>DC：建立內容為「-------------------------------------------------------------------------------- -- Module:Hatnote list --…」的新頁面