پودمان:Native name

از اسلامیکال
نسخهٔ تاریخ ‏۲۸ مارس ۲۰۲۴، ساعت ۱۴:۵۳ توسط Shahroudi (بحث | مشارکت‌ها) (صفحه‌ای تازه حاوی «-- بخش‌هایی از این پودمان به‌منظور بومی‌سازی و سازگاری با زبان فارسی تغییر کرده‌است. در زمان بروزرسانی دقت کنید require('Module:No globals'); local getArgs = require ('Module:Arguments').getArgs; local lang_module = require ('Module:Lang'); local numConvert = require('Module:Numeral converter').convert local defined_values = { italic = {['n...» ایجاد کرد)
(تفاوت) → نسخهٔ قدیمی‌تر | نمایش نسخهٔ فعلی (تفاوت) | نسخهٔ جدیدتر ← (تفاوت)
پرش به ناوبری پرش به جستجو

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

-- بخش‌هایی از این پودمان به‌منظور بومی‌سازی و سازگاری با زبان فارسی تغییر کرده‌است. در زمان بروزرسانی دقت کنید
require('Module:No globals');

local getArgs = require ('Module:Arguments').getArgs;
local lang_module = require ('Module:Lang');
local numConvert = require('Module:Numeral converter').convert

local defined_values = {
	italic = {['no']='no', ['off']='no', ['خیر']='no', ['خاموش']='no'},			-- values accepted by |italic= and |italics=; {{lang}} expects 'no' so 'off' must be translated
	nbsp = {['no']=true, ['omit']=true, ['خیر']=true, ['حذف']=true},			-- values accepted by |nbsp=
	paren = {['no']=true, ['off']=true, ['omit']=true, ['خیر']=true, ['خاموش']=true, ['حذف']=true},							-- values accepted by |paren=
	}

local messages_t = {													
	tag_required = 'یک برچسب زبان IETF باید در پارامتر {{{1}}} وارد شود',		-- for {{native name}}
	name_required = 'یک نام باید در پارامتر {{{2}}} وارد شود',
																
	tag_required_idx = 'یک برچسب زبان IETF باید در پارامتر |tag%s= وارد شود',	-- for {{native name}} when called from {{native name list}}
	name_required_idx = 'یک نام باید در پارامتر |name%s= وارد شود',

	empty_list = 'فهرست خالی است',												-- for {{native name list}}
	positional = 'پارامترهای مکانی پشتیبانی نمی‌شوند',

	br_list = '<br /> فهرست مجاز نیست',										-- for {{native name checker}}
	list_markup = 'برای نام‌های چندگانه، نشانه‌گذاری فهرست مورد انتظار است',
	malformed_param = 'مقدار پارامتر، بدریخت است',
	}

local help_links_t = {
	['native name'] = '[[الگو:نام بومی|راهنما]]',
	['نام بومی'] = '[[الگو:نام بومی|راهنما]]',
	['native name checker'] = '[[الگو:بررسی‌کننده نام بومی|راهنما]]',
	['بررسی‌کننده نام بومی'] = '[[الگو:بررسی‌کننده نام بومی|راهنما]]',
	['native name list'] = '[[الگو:فهرست نام بومی|راهنما]]',
	['فهرست نام بومی'] = '[[الگو:فهرست نام بومی|راهنما]]',
	}

local error_cats_t = {
	['native name'] = '[[رده:خطاهای الگوی نام بومی]]',
	['نام بومی'] = '[[رده:خطاهای الگوی نام بومی]]',
	['native name checker'] = '[[رده:خطاهای الگوی بررسی‌کننده نام بومی]]',
	['بررسی‌کننده نام بومی'] = '[[رده:خطاهای الگوی بررسی‌کننده نام بومی]]',
	['native name list'] = '[[رده:خطاهای الگوی فهرست نام بومی]]',
	['فهرست نام بومی'] = '[[رده:خطاهای الگوی فهرست نام بومی]]',
	}


--[[--------------------------< E R R O R _ M S G >------------------------------------------------------------

returns a formatted error message

]]

local function error_msg (msg, template, index)
	local cat = ((0 == mw.title.getCurrentTitle().namespace) and error_cats_t[template]) or '';
	if index then
		local message = mw.ustring.format (msg, index);
		return mw.ustring.format ('<span style="color:#d33">خطای {{%s}}: %s (%s)</span>%s', template, message, help_links_t[template], cat)
	end
	return mw.ustring.format ('<span style="color:#d33">خطای {{%s}}: %s (%s)</span>%s', template, msg, help_links_t[template], cat)
end


--[=[-------------------------< _ N A T I V E _ N A M E >------------------------------------------------------

implements {{native name}}; entry point from a module

<args_t> is a table of parameter name/value pairs.  Parameters that are supported are:
	args_t[1] - IETF language tag (required)
	args_t[2] - the native name (required)
	args_t.italic - accepts string values 'no' or 'off'; {{lang}} expects 'no' so 'off' must be translated
	args_t.italics - alias of |italic=
	args_t.paren - accepts 'omit', 'off', or 'no'
	args_t.icon - alias of paren
	args_t.nbsp - accepts 'omit' or 'no'
	args_t.parensize - 
	args_t.fontsize - deprecated alias of |parensize=
	args_t.nolink - any value inhibits wikilinking of language name

this function calls these functions in Module:lang:
	_is_ietf_tag
	_lang
	_name_from_tag

TODO:
	add support for romanization and transliteration?
	add support for postfix so that 'mis' can render something like this:
		{{native|name|mis|Chotilapacquen|parent=omit|postfix=&#32;([[Coahuiltecan languages|Coahuiltecan]])}}
			Chotilapacquen (Coahuiltecan)

]=]

local function _native_name (args_t)
	local template = (args_t.template and args_t.template) or 'نام بومی';		-- for error messaging; use 'native name list' when called from native_name_list(), etc

	if not args_t[1] then
		return error_msg ((args_t.index and messages_t.tag_required_idx) or messages_t.tag_required, template, args_t.index)
	end
	if not args_t[2] then
		return error_msg ((args_t.index and messages_t.name_required_idx) or messages_t.name_required, template, args_t.index)
	end

	args_t.italic = args_t.italics or args_t.italic;							-- plural form first in {{native name}} but singular form for {{lang}}
	args_t.italic = defined_values.italic[args_t.italic] or nil;				-- translate assigned value
	args_t.italics = nil;														-- so unset as unneeded

	args_t.paren = args_t.paren or args_t.icon;
	args_t.icon = nil;															-- unset as unneeded

	args_t.parensize = args_t.parensize or args_t.fontsize or '100%';
	args_t.fontsize = nil;														-- unset as unneeded

	local out_t = {};

	table.insert (out_t, lang_module._lang ({args_t[1], args_t[2], ['italic']=args_t.italic, ['template']=template}));
	if not defined_values.paren[args_t.paren] then
		table.insert (out_t, '&nbsp;');
		if not defined_values.italic[args_t.italic] and not defined_values.nbsp[args_t.nbsp] then
			table.insert (out_t, '&nbsp;');
		end

		table.insert (out_t, table.concat ({
			'<span class="languageicon" style="font-size:',
			numConvert('en', args_t.parensize),									-- make Sure persian digits and "%" converted
			'; font-weight:normal">'}));

		if args_t.nolink then
			table.insert (out_t, table.concat ({'(', lang_module._name_from_tag ({args_t[1], ['template']=template}), ')'}));
		else
			if lang_module._is_ietf_tag (args_t[1]) then
				table.insert (out_t,  table.concat ({'(', lang_module._name_from_tag ({args_t[1], ['link'] ='yes', ['template']=template}), ')'}));
			else
				table.insert (out_t, '(زبان؟)');							-- TODO: any reason to keep this?
			end
		end

		table.insert (out_t, '</span>');
	end

	return table.concat (out_t);
end


--[[--------------------------< N A T I V E _ N A M E >--------------------------------------------------------

implements {{native name}}; entry point from the template

{{#invoke:native name|native_name|<tag>|<name>|italic=|paren=|parensize=|nbsp=|nolink=}}

]]

local function native_name (frame)
	local args = getArgs(frame)
	
	-- Translate local arguments
	if args['ایتالیک'] then args.italic = args['ایتالیک'] end
	if args['پرانتز'] then args.paren = args['پرانتز'] end
	if args['آیکون'] then args.icon = args['آیکون'] end
	if args['فاصله نشکن'] then args.nbsp = args['فاصله نشکن'] end
	if args['اندازه پرانتز'] then args.parensize = args['اندازه پرانتز'] end
	if args['اندازه قلم'] then args.fontsize = args['اندازه قلم'] end
	if args['بدون پیوند'] then args.nolink = args['بدون پیوند'] end
	
	return _native_name (args);
end


--[[--------------------------> _ N A T I V E _ N A M E _ L I S T >--------------------------------------------

implements {{native name list}}; entry point from a module

<args_t> is a table of parameter name/value pairs.  Supports enumerated forms of the {{native name}} parameters:
	args_t.tagn - IETF language tag (|tag1= required)
	args_t.namen - the native name (|name1= required)
	args_t.italicn - accepts string values 'no' or 'off'
	args_t.italicsn - alias of |italicn=
	args_t.parenn - accepts 'omit', 'off', or 'no'
	args_t.iconn - alias of paren
	args_t.nbspn - accepts 'omit' or 'no'
	args_t.parensizen - 
	args_t.fontsizen - deprecated alias of |parensizen=
	args_t.nolinkn - any value inhibits wikilinking of language name

also supports:
	args_t.postfixn - wikitext to be appended to list item n (references other appropriate text)

]]

local function _native_name_list (args_t)
	if args_t[1] then
		return error_msg (messages_t.positional, 'فهرست نام بومی')
	end

	local max_enum = 0;															-- accumulate the value to the enumerator with the greatest value

	for param, _ in pairs (args_t) do											-- loop through all parameters
		local n = tonumber(numConvert('en', mw.ustring.match (param, '%d+$')));					-- extract the required enumerator
		max_enum = ((n and (n > max_enum)) and n) or max_enum;					-- bump <max_enum> if <n> is greater
	end

	local list_t = {};															-- list of formatted native names goes here
	local n = 1;																-- initialize an enumerator

	while n <= max_enum do
		table.insert (list_t, table.concat ({
			'<li>',																-- open the list item
			_native_name ({														-- go render the native name
				args_t['tag'..n] or args_t['برچسب'..numConvert('fa', n)],
				args_t['name'..n] or args_t['نام'..numConvert('fa', n)],
				['italic'] = args_t['italic'..n] or args_t['ایتالیک'..numConvert('fa', n)],
				['italics'] = args_t['italics'..n] or args_t['ایتالیک'..numConvert('fa', n)],
				['paren'] = args_t['paren'..n] or args_t['پرانتز'..numConvert('fa', n)],
				['icon'] = args_t['icon'..n] or args_t['آیکون'..numConvert('fa', n)],
				['nbsp'] = args_t['nbsp'..n] or args_t['فاصله نشکن'..numConvert('fa', n)],
				['parensize'] = args_t['parensize'..n] or args_t['اندازه پرانتز'..numConvert('fa', n)],
				['fontsize'] = args_t['fontsize'..n] or args_t['اندازه قلم'..numConvert('fa', n)],
				['nolink'] = args_t['nolink'..n] or args_t['بدون پیوند'..numConvert('fa', n)],
				['template'] = 'فهرست نام بومی',								-- for error messaging
				['index'] = n,													-- for error messaging
				}),
			args_t['postfix'..n] or args_t['پسوند'..numConvert('fa', n)] or '',
			'</li>'																-- close the list item
		}));
		n = n + 1;																-- bump the enumerator
	end

	if 0 < #list_t then
		if 1 < #list_t then
			table.insert (list_t, 1, '<div class="plainlist"><ul>');			-- open the div; open the unordered list
			table.insert (list_t, '</ul></div>');								-- close the unordered list; close the div
		else																	-- here when only one list item; no need for list markup; TODO: error message for this case?
			local out = table.concat (list_t):gsub ('<li>', ''):gsub ('</li>', '');
			return out;															-- to avoid replacement count contaminating the output
		end
	else
		return error_msg (messages_t.empty_list, 'فهرست نام بومی');
	end
	
	return table.concat (list_t);												-- make a big string and done
end


--[[--------------------------< N A T I V E _ N A M E _ L I S T >----------------------------------------------

implements {{native name list}}; entry point from the template

{{#invoke:native name list|native_name_list|tag1=<tag>|name1=<name>|italic1=|paren1=|parensize1=|nbsp1=|nolink1=}}

]]

local function native_name_list (frame)
	return _native_name_list (getArgs (frame));
end


--[[--------------------------< _ N A T I V E _ N A M E _ C H E C K E R >--------------------------------------

entry point from a module

implements {{native name checker}}

for use inside infoboxen:
	|dataxx = {{native name checker|{{{native_name|}}}}}

inspects rendered content of {{{native_name}}}:
	expects: at least one lang="<valid IETF tag>" html attribute; tag must begin with 2 or three letters followed
			by a hyphen or double quote character: lang="zh-Hant" or lang="nav" or lang="oj"
	emits error message when 2 or more lang="<valid IETF tag>" html attribute but list markup <li> tag not found
	emits error message if any form of '<br />' tag is found per MOS:NOBREAK

returns:
	nothing when |native_name= is omitted or empty
	assigned value when no error
	error message on error

]]

local function _native_name_checker (args_t)
	local value = args_t[1];
	
	if not value then															-- if |native_name= is omitted or empty
		return;																	-- return nothing
	end
	
	local _, count = value:gsub ('lang="%a%a%a?[%-"]%a*', '%1');
	if 0 == count then
		return table.concat ({value, error_msg (messages_t.malformed_param, 'بررسی‌کننده نام بومی')}, ' ');	-- no {{lang}} or {{native_name}} template
	end
	if 1 < count then
		if not value:find ('<div class="plainlist *" *>') or not value:find ('</div>$') then	-- must be wrapped in 'plainlist' div
			return table.concat ({value, error_msg (messages_t.list_markup, 'بررسی‌کننده نام بومی')}, ' ');
		end
	end
	
	if value:find ('< */? *[Bb][Rr] */? *>') then								-- look for something that vaguely resembles a <br /> tag
		return table.concat ({value, error_msg (messages_t.br_list, 'بررسی‌کننده نام بومی')}, ' ');
	end

	return value;																-- no failed tests, return the value as is
end


--[[--------------------------< N A T I V E _ N A M E _ C H E C K E R >--------------------------------------

entry point from a module

implements {{native name checker}}

]]

local function native_name_checker (frame)
	return _native_name_checker (getArgs (frame));
end


--[[--------------------------< E X P O R T S >----------------------------------------------------------------
]]

return {
	native_name = native_name,													-- template interface
	native_name_list = native_name_list,
	native_name_checker = native_name_checker,
	
	_native_name = _native_name,												-- other module interface
	_native_name_list = _native_name_list,
	_native_name_checker = _native_name_checker,
	}
برگرفته از «https://www.islamical.org/w/index.php?title=پودمان:Native_name&oldid=78306»