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

    از ویکی پاسخ
    (parse pages for section-only links as nil - this prevents section-only links that have an italicized page parameter from having empty <i></i> tags)
    جز (۱ نسخه واردشده)
     
    (۳ نسخهٔ میانی ویرایش شده توسط ۲ کاربر نشان داده نشد)
    خط ۱۲: خط ۱۲:
    local mArguments -- lazily initialise [[Module:Arguments]]
    local mArguments -- lazily initialise [[Module:Arguments]]
    local yesno -- lazily initialise [[Module:Yesno]]
    local yesno -- lazily initialise [[Module:Yesno]]
    local formatLink -- lazily initialise [[Module:Format link]] ._formatLink


    local p = {}
    local p = {}
    خط ۱۸: خط ۱۹:
    -- Helper functions
    -- Helper functions
    --------------------------------------------------------------------------------
    --------------------------------------------------------------------------------
    local curNs = mw.title.getCurrentTitle().namespace
    p.missingTargetCat =
    --Default missing target category, exported for use in related modules
    ((curNs ==  0) or (curNs == 14)) and
    'مقاله‌های دارای الگوهای سرنویس با صفحه هدف ناموجود' or nil


    local function getArgs(frame)
    local function getArgs(frame)
    خط ۲۸: خط ۳۵:
    local function removeInitialColon(s)
    local function removeInitialColon(s)
    -- Removes the initial colon from a string, if present.
    -- Removes the initial colon from a string, if present.
    return s:match('^:?(.*)')
    return mw.ustring.match(s, '^:?(.*)')
    end
    end


    خط ۴۱: خط ۴۸:
    link = removeInitialColon(link)
    link = removeInitialColon(link)
    end
    end
    local namespace = link:match('^(.-):')
    local namespace = mw.ustring.match(link, '^(.-):')
    if namespace then
    if namespace then
    local nsTable = mw.site.namespaces[namespace]
    local nsTable = mw.site.namespaces[namespace]
    خط ۴۹: خط ۵۶:
    end
    end
    return 0
    return 0
    end
    function p.formatPages(...)
    -- Formats a list of pages using formatLink and returns it as an array. Nil
    -- values are not allowed.
    local pages = {...}
    local ret = {}
    for i, page in ipairs(pages) do
    ret[i] = p._formatLink{link = page}
    end
    return ret
    end
    function p.formatPageTables(...)
    -- Takes a list of page/display tables and returns it as a list of
    -- formatted links. Nil values are not allowed.
    local pages = {...}
    local links = {}
    for i, t in ipairs(pages) do
    checkType('formatPageTables', i, t, 'table')
    local link = t[1]
    local display = t[2]
    links[i] = p._formatLink{link = link, display = display}
    end
    return links
    end
    end


    خط ۸۸: خط ۷۰:
    local helpText
    local helpText
    if helpLink then
    if helpLink then
    helpText = ' ([[' .. helpLink .. '|help]])'
    helpText = ' ([[' .. helpLink .. '|راهنما]])'
    else
    else
    helpText = ''
    helpText = ''
    خط ۹۸: خط ۸۰:
    and yesno(addTrackingCategory) ~= false -- Allow opting out
    and yesno(addTrackingCategory) ~= false -- Allow opting out
    then
    then
    category = 'Hatnote templates with errors'
    category = 'الگو:سرنویس همراه خطا'
    category = string.format(
    category = mw.ustring.format(
    '[[%s:%s]]',
    '[[%s:%s]]',
    mw.site.namespaces[14].name,
    mw.site.namespaces[14].name,
    خط ۱۰۷: خط ۸۹:
    category = ''
    category = ''
    end
    end
    return string.format(
    return mw.ustring.format(
    '<strong class="error">Error: %s%s.</strong>%s',
    '<strong class="error">خطا: %s%s.</strong>%s',
    msg,
    msg,
    helpText,
    helpText,
    خط ۱۲۰: خط ۱۰۲:
    checkType('disambiguate', 1, page, 'string')
    checkType('disambiguate', 1, page, 'string')
    checkType('disambiguate', 2, disambiguator, 'string', true)
    checkType('disambiguate', 2, disambiguator, 'string', true)
    disambiguator = disambiguator or 'disambiguation'
    disambiguator = disambiguator or 'ابهام‌زدایی'
    return string.format('%s (%s)', page, disambiguator)
    return mw.ustring.format('%s (%s)', page, disambiguator)
    end
     
    --------------------------------------------------------------------------------
    -- Format link
    --
    -- Makes a wikilink from the given link and display values. Links are escaped
    -- 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 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]
    if not link then
    return p.makeWikitextError(
    'no link specified',
    'Template:Format link#Errors',
    args.category
    )
    end
    return p._formatLink{
    link = link,
    display = args[2],
    italicizePage = yesno(args.italicizepage),
    italicizeSection = yesno(args.italicizesection),
    }
    end
     
    local function italicize(s)
    -- Italicize a string.
    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
     
    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.
    local prePipe, display = link:match('^(.-)|(.*)$')
    link = prePipe or link
     
    -- Find the page, if it exists.
    -- For links like [[#Bar]], the page will be nil.
    local preHash, postHash = link:match('^(.-)#(.*)$')
    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 section, if it exists.
    local section
    if postHash and postHash ~= '' then
    section = postHash
    end
    return {
    link = link,
    page = page,
    section = section,
    display = display,
    }
    end
     
    function p._formatLink(options)
    -- The formatLink export function, for use in modules.
    checkType('_formatLink', 1, options, 'table')
    checkTypeForNamedArg('_formatLink', 'link', options.link, 'string', false)
    checkTypeForNamedArg(
    '_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 string.format('[[:%s]]', parsed.link)
    end
    -- Find the display text for piped links
    if not display then
    local page = maybeItalicize(parsed.page, options.italicizePage)
    local section = maybeItalicize(parsed.section, options.italicizeSection)
    if not page then
    display = string.format('§&nbsp;%s', section)
    elseif section then
    display = string.format('%s §&nbsp;%s', page, section)
    else
    display = page
    end
    end
    return string.format('[[:%s|%s]]', parsed.link, display)
    end
    end


    خط ۲۶۶: خط ۱۱۵:
    local args = getArgs(frame)
    local args = getArgs(frame)
    local s = args[1]
    local s = args[1]
    local options = {}
    if not s then
    if not s then
    return p.makeWikitextError(
    return p.makeWikitextError(
    'no text specified',
    'متنی تعریف نشده‌آست',
    'Template:Hatnote#Errors',
    'الگو:سرنویس#خطاها',
    args.category
    args.category or args['رده']
    )
    )
    end
    end
    options.extraclasses = args.extraclasses
    return p._hatnote(s, {
    options.selfref = args.selfref
    extraclasses = args.extraclasses or args['کلاس‌های بیشتر'],
    return p._hatnote(s, options)
    selfref = args.selfref or args['خودارجاع']
    })
    end
    end


    خط ۲۸۳: خط ۱۳۲:
    checkType('_hatnote', 2, options, 'table', true)
    checkType('_hatnote', 2, options, 'table', true)
    options = options or {}
    options = options or {}
    local classes = {'hatnote', 'navigation-not-searchable'}
    local inline = options.inline
    local extraclasses = options.extraclasses
    local hatnote = mw.html.create(inline == 1 and 'span' or 'div')
    local selfref = options.selfref
    local extraclasses
    if type(extraclasses) == 'string' then
    if type(options.extraclasses) == 'string' then
    classes[#classes + 1] = extraclasses
    extraclasses = options.extraclasses
    end
    end
    if selfref then
     
    classes[#classes + 1] = 'selfref'
    hatnote
    end
    :attr('role', 'note')
    return string.format(
    :addClass(inline == 1 and 'hatnote-inline' or 'hatnote')
    '<div role="note" class="%s">%s</div>',
    :addClass('navigation-not-searchable')
    table.concat(classes, ' '),
    :addClass(extraclasses)
    s
    :addClass(options.selfref and 'selfref')
    )
    :wikitext(s)
    return mw.getCurrentFrame():extensionTag{
    name = 'templatestyles', args = { src = 'پودمان:Hatnote/styles.css' }
    } .. tostring(hatnote)
    end
    end


    return p
    return p

    نسخهٔ کنونی تا ‏۱۳ دسامبر ۲۰۲۲، ساعت ۱۸:۴۹

    توضیحات این پودمان می‌تواند در پودمان:Hatnote/توضیحات قرار گیرد.

    --------------------------------------------------------------------------------
    --                              Module:Hatnote                                --
    --                                                                            --
    -- This module produces hatnote links and links to related articles. It       --
    -- implements the {{hatnote}} and {{format link}} meta-templates and includes --
    -- helper functions for other Lua hatnote modules.                            --
    --------------------------------------------------------------------------------
    
    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 formatLink -- lazily initialise [[Module:Format link]] ._formatLink
    
    local p = {}
    
    --------------------------------------------------------------------------------
    -- Helper functions
    --------------------------------------------------------------------------------
    
    local curNs = mw.title.getCurrentTitle().namespace
    p.missingTargetCat =
    	--Default missing target category, exported for use in related modules
    	((curNs ==  0) or (curNs == 14)) and
    	'مقاله‌های دارای الگوهای سرنویس با صفحه هدف ناموجود' or nil
    
    local function getArgs(frame)
    	-- Fetches the arguments from the parent frame. Whitespace is trimmed and
    	-- blanks are removed.
    	mArguments = require('Module:Arguments')
    	return mArguments.getArgs(frame, {parentOnly = true})
    end
    
    local function removeInitialColon(s)
    	-- Removes the initial colon from a string, if present.
    	return mw.ustring.match(s, '^:?(.*)')
    end
    
    function p.findNamespaceId(link, removeColon)
    	-- Finds the namespace id (namespace number) of a link or a pagename. This
    	-- function will not work if the link is enclosed in double brackets. Colons
    	-- are trimmed from the start of the link by default. To skip colon
    	-- trimming, set the removeColon parameter to false.
    	checkType('findNamespaceId', 1, link, 'string')
    	checkType('findNamespaceId', 2, removeColon, 'boolean', true)
    	if removeColon ~= false then
    		link = removeInitialColon(link)
    	end
    	local namespace = mw.ustring.match(link, '^(.-):')
    	if namespace then
    		local nsTable = mw.site.namespaces[namespace]
    		if nsTable then
    			return nsTable.id
    		end
    	end
    	return 0
    end
    
    function p.makeWikitextError(msg, helpLink, addTrackingCategory, title)
    	-- Formats an error message to be returned to wikitext. If
    	-- addTrackingCategory is not false after being returned from
    	-- [[Module:Yesno]], and if we are not on a talk page, a tracking category
    	-- is added.
    	checkType('makeWikitextError', 1, msg, 'string')
    	checkType('makeWikitextError', 2, helpLink, 'string', true)
    	yesno = require('Module:Yesno')
    	title = title or mw.title.getCurrentTitle()
    	-- Make the help link text.
    	local helpText
    	if helpLink then
    		helpText = ' ([[' .. helpLink .. '|راهنما]])'
    	else
    		helpText = ''
    	end
    	-- Make the category text.
    	local category
    	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 = mw.ustring.format(
    			'[[%s:%s]]',
    			mw.site.namespaces[14].name,
    			category
    		)
    	else
    		category = ''
    	end
    	return mw.ustring.format(
    		'<strong class="error">خطا: %s%s.</strong>%s',
    		msg,
    		helpText,
    		category
    	)
    end
    
    function p.disambiguate(page, disambiguator)
    	-- Formats a page title with a disambiguation parenthetical,
    	-- i.e. "Example" → "Example (disambiguation)".
    	checkType('disambiguate', 1, page, 'string')
    	checkType('disambiguate', 2, disambiguator, 'string', true)
    	disambiguator = disambiguator or 'ابهام‌زدایی'
    	return mw.ustring.format('%s (%s)', page, disambiguator)
    end
    
    --------------------------------------------------------------------------------
    -- Hatnote
    --
    -- Produces standard hatnote text. Implements the {{hatnote}} template.
    --------------------------------------------------------------------------------
    
    function p.hatnote(frame)
    	local args = getArgs(frame)
    	local s = args[1]
    	if not s then
    		return p.makeWikitextError(
    			'متنی تعریف نشده‌آست',
    			'الگو:سرنویس#خطاها',
    			args.category or args['رده']
    		)
    	end
    	return p._hatnote(s, {
    		extraclasses = args.extraclasses or args['کلاس‌های بیشتر'],
    		selfref = args.selfref or args['خودارجاع']
    	})
    end
    
    function p._hatnote(s, options)
    	checkType('_hatnote', 1, s, 'string')
    	checkType('_hatnote', 2, options, 'table', true)
    	options = options or {}
    	local inline = options.inline
    	local hatnote = mw.html.create(inline == 1 and 'span' or 'div')
    	local extraclasses
    	if type(options.extraclasses) == 'string' then
    		extraclasses = options.extraclasses
    	end
    
    	hatnote
    		:attr('role', 'note')
    		:addClass(inline == 1 and 'hatnote-inline' or 'hatnote')
    		:addClass('navigation-not-searchable')
    		:addClass(extraclasses)
    		:addClass(options.selfref and 'selfref')
    		:wikitext(s)
    	
    	return mw.getCurrentFrame():extensionTag{
    		name = 'templatestyles', args = { src = 'پودمان:Hatnote/styles.css' }
    	} .. tostring(hatnote)
    end
    
    return p