پودمان:Hatnote: تفاوت میان نسخه‌ها

پودمان:Hatnote (نمایش مبدأ)

نسخهٔ ‏۱۳ اکتبر ۲۰۲۱، ساعت ۰۷:۰۵

۲٬۱۱۳ بایت اضافه‌شده ، ‏۱۳ اکتبر ۲۰۲۱

بدون خلاصۀ ویرایش

کاربر ناشناس

fa.wikipedia>Jeeputer

@@ خط ۹: / خط ۹: @@
 local libraryUtil = require('libraryUtil')
 local checkType = libraryUtil.checkType
+local checkTypeForNamedArg = libraryUtil.checkTypeForNamedArg
 local mArguments -- lazily initialise [[Module:Arguments]]
 local yesno -- lazily initialise [[Module:Yesno]]
@@ خط ۲۷: / خط ۲۸: @@
 local function removeInitialColon(s)
 	-- Removes the initial colon from a string, if present.
-	return s:match('^:?(.*)')
+	return mw.ustring.match(s, '^:?(.*)')
 end
@@ خط ۴۰: / خط ۴۱: @@
 		link = removeInitialColon(link)
 	end
-	local namespace = link:match('^(.-):')
+	local namespace = mw.ustring.match(link, '^(.-):')
 	if namespace then
 		local nsTable = mw.site.namespaces[namespace]
@@ خط ۵۶: / خط ۵۷: @@
 	local ret = {}
 	for i, page in ipairs(pages) do
-		ret[i] = p._formatLink(page)
+		ret[i] = p._formatLink{link = page}
 	end
 	return ret
@@ خط ۷۰: / خط ۷۱: @@
 		local link = t[1]
 		local display = t[2]
-		links[i] = p._formatLink(link, display)
+		links[i] = p._formatLink{link = link, display = display}
 	end
 	return links
@@ خط ۹۳: / خط ۹۴: @@
 	-- Make the category text.
 	local category
-	if not title.isTalkPage and yesno(addTrackingCategory) ~= false then
+	if not title.isTalkPage -- Don't categorise talk pages
+		and title.namespace ~= 2 -- Don't categorise userspace
+		and yesno(addTrackingCategory) ~= false -- Allow opting out
+	then
 		category = 'الگو:سرنویس همراه خطا'
-		category = string.format(
+		category = mw.ustring.format(
 			'[[%s:%s]]',
 			mw.site.namespaces[14].name,
@@ خط ۱۰۳: / خط ۱۰۷: @@
 		category = ''
 	end
-	return string.format(
+	return mw.ustring.format(
 		'<strong class="error">خطا: %s%s.</strong>%s',
 		msg,
@@ خط ۱۱۳: / خط ۱۱۷: @@
 function p.disambiguate(page, disambiguator)
 	-- Formats a page title with a disambiguation parenthetical,
-	-- i.e. "Example" → "Example (ابهام‌زدایی)".
+	-- i.e. "Example" → "Example (disambiguation)".
-	checkType('ابهام‌زدایی', 1, page, 'string')
+	checkType('disambiguate', 1, page, 'string')
-	checkType('ابهام‌زدایی', 2, disambiguator, 'string', true)
+	checkType('disambiguate', 2, disambiguator, 'string', true)
 	disambiguator = disambiguator or 'ابهام‌زدایی'
-	return string.format('%s (%s)', page, disambiguator)
+	return mw.ustring.format('%s (%s)', page, disambiguator)
 end
@@ خط ۱۲۶: / خط ۱۳۰: @@
 -- with colons if necessary, and links to sections are detected and displayed
 -- with " § " as a separator rather than the standard MediaWiki "#". Used in
--- the {{format hatnote link}} template.
+-- the {{format link}} template.
 --------------------------------------------------------------------------------
 function p.formatLink(frame)
+	-- The formatLink export function, for use in templates.
+	yesno = require('Module:Yesno')
 	local args = getArgs(frame)
 	local link = args[1]
-	local display = args[2]
 	if not link then
 		return p.makeWikitextError(
@@ خط ۱۴۰: / خط ۱۴۵: @@
 		)
 	end
-	return p._formatLink(link, display)
+	return p._formatLink{
+		link = link,
+		display = args[2],
+		italicizePage = yesno(args.italicizepage),
+		italicizeSection = yesno(args.italicizesection),
+	}
 end
-function p._formatLink(link, display)
+local function italicize(s)
-	checkType('_formatLink', 1, link, 'string')
+	-- Italicize a string.
-	checkType('_formatLink', 2, display, 'string', true)
+	return '<i>' .. s .. '</i>'
+end
+local function maybeItalicize(s, shouldItalicize)
+	-- italicize s if s is a string and the shouldItalicize parameter is true.
+	if s and shouldItalicize then
+		return italicize(s)
+	else
+		return s
+	end
+end
-	-- Remove the initial colon for links where it was specified manually.
+local function parseLink(link)
+	-- Parse a link and return a table with the link's components.
+	-- These components are:
+	-- - link: the link, stripped of any initial colon (always present)
+	-- - page: the page name (always present)
+	-- - section: the page name (may be nil)
+	-- - display: the display text, if manually entered after a pipe (may be nil)
 	link = removeInitialColon(link)
 	-- Find whether a faux display value has been added with the {{!}} magic
 	-- word.
-	if not display then
+	local prePipe, display = mw.ustring.match(link, '^(.-)|(.*)$')
-		local prePipe, postPipe = link:match('^(.-)|(.*)$')
+	link = prePipe or link
-		link = prePipe or link
-		display = postPipe
+	-- Find the page, if it exists.
+	-- For links like [[#Bar]], the page will be nil.
+	local preHash, postHash = mw.ustring.match(link, '^(.-)#(.*)$')
+	local page
+	if not preHash then
+		-- We have a link like [[Foo]].
+		page = link
+	elseif preHash ~= '' then
+		-- We have a link like [[Foo#Bar]].
+		page = preHash
 	end
-	-- Find the display value.
+	-- Find the section, if it exists.
-	if not display then
+	local section
-		local page, section = link:match('^(.-)#(.*)$')
+	if postHash and postHash ~= '' then
-		if page then
+		section = postHash
-			display = page .. ' §&nbsp;' .. section
-		end
 	end
+	return {
+		link = link,
+		page = page,
+		section = section,
+		display = display,
+	}
+end
-	-- Assemble the link.
+function p._formatLink(options)
-	local cat
+	-- The formatLink export function, for use in modules.
-	if not mw.title.new(link).exists then
+	checkType('_formatLink', 1, options, 'table')
-		cat = '[[رده:صفحه‌های استفاده‌کننده از سرنویس با پیوند قرمز]]'
+	checkTypeForNamedArg('_formatLink', 'link', options.link, 'string', false)
-	else
+	checkTypeForNamedArg(
-		cat = ''
+		'_formatLink',
+		'display',
+		options.display,
+		'string',
+		true
+	)
+	checkTypeForNamedArg(
+		'_formatLink',
+		'italicizePage',
+		options.italicizePage,
+		'boolean',
+		true
+	)
+	checkTypeForNamedArg(
+		'_formatLink',
+		'italicizeSection',
+		options.italicizeSection,
+		'boolean',
+		true
+	)
+	local parsed = parseLink(options.link)
+	local display = options.display or parsed.display
+	-- Deal with the case where we don't have to pipe the link
+	if not display and not parsed.section and not options.italicizePage then
+		return mw.ustring.format('[[:%s]]', parsed.link)
 	end
-	if display then
-		return string.format(
+	-- Find the display text for piped links
-			'[[:%s|%s]]',
+	if not display then
-			string.gsub(link, '|(.*)$', ''), --display overwrites manual piping
+		local page = maybeItalicize(parsed.page, options.italicizePage)
-			display
+		local section = maybeItalicize(parsed.section, options.italicizeSection)
-		) .. cat
+		if not page then
-	else
+			display = mw.ustring.format('§&nbsp;%s', section)
-		return string.format('[[:%s]]', link) .. cat
+		elseif section then
+			display = mw.ustring.format('%s §&nbsp;%s', page, section)
+		else
+			display = page
+		end
 	end
+	return mw.ustring.format('[[:%s|%s]]', parsed.link, display)
 end
@@ خط ۲۱۹: / خط ۲۹۲: @@
 		classes[#classes + 1] = 'selfref'
 	end
-	return string.format(
+	return mw.ustring.format(
-		'<div role="note" class="%s">%s</div>',
+		'%s<div role="note" class="%s">%s</div>',
+		mw.getCurrentFrame():extensionTag{
+			name = 'templatestyles', args = { src = 'Module:Hatnote/styles.css' }
+		},
 		table.concat(classes, ' '),
 		s