Jump to content

Module:In lang/sandbox

From Wikipedia, the free encyclopedia
This is an old revision of this page, as edited by Trappist the monk (talk | contribs) at 13:02, 13 December 2019. The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.
require ('Module:No globals');


--[[--------------------------< I S _ C J K >------------------------------------------------------------------

return true if code is one of the listed Chinese, Japanese, Korean ISO 639 codes, false else.

]]

local function is_cjk_code (code)
local cjk =
		{
		['zh'] = true, ['cdo'] = true, ['cjy'] = true, ['cmn'] = true,			-- Chinese language codes
		['cpi'] = true, ['cpx'] = true, ['czh'] = true, ['czo'] = true,
		['gan'] = true, ['hak'] = true, ['hsn'] = true, ['ltc'] = true,
		['lzh'] = true, ['mnp'] = true, ['nan'] = true, ['och'] = true,
		['wuu'] = true, ['yue'] = true, ['zhx'] = true,
		['ja'] = true, ['jpx'] = true, ['ojp'] = true,							-- Japanese language codes
		['ko'] = true, ['okm'] = true, ['oko'] = true,							-- Korean language codes
		}

	return cjk[code] or false;
end


--[[--------------------------< S E T _ I T A L I C S >--------------------------------------------------------

Created for use with Template:Infobox book and Template:Infobox document and perhaps others to replace hard-coded
italic markup in the call to {{lang}}.  This module attempts to make sure that {{lang}} correctly applies italic
markup according to MOS:FOREIGNITALIC.  

]]

local function set_italics (frame)
	local code = frame.args[1] or frame.args['code'] or '';						-- empty string causes 'yes' return; {{lang}} will handle the missing code error
	local text = frame.args[2] or frame.args['text'] or '';						-- empty string causes 'yes' return; {{lang}} will handle the missing text error
	
	local is_latn = require ("Module:Unicode data").is_Latin;
	
	if is_cjk_code (code) and not is_latn (text) then							-- is_latn() is in Module:Lang
		return  'no';															-- only case for 'no' 
	end
	return 'yes';																-- everything else is yes
end


--[[--------------------------< I N _ L A N G >----------------------------------------------------------------

implements {{in lang}}

Module entry point from an {{#invoke:lang/utilities/sanbox|in_lang|<code>|<code2>|<code3>|<code...>|link=yes|template=Link language}}

<span class="languageicon">(in <language>)</span>

]]

local function in_lang (frame)
	local getArgs = require ('Module:Arguments').getArgs;
	local args = getArgs(frame);
	local list = {};
	local cats = {};
	
	if not args[1] then
		local template = (args['template'] and table.concat ({'{{', args['template'], '}}: '})) or '';	-- make template name (if provided by the template)
		return table.concat ({'<span style=\"font-size:100%; font-style:normal;\" class=\"error\">error: ', template, 'missing language tag</span>'});
	end

	local module = 'Module:Lang' .. (frame:getTitle():match ('/sandbox') or '');	-- if this module is the sandbox,
	local name_from_tag = require (module)._name_from_tag;						-- use Module:Lang/sandbox; Module:Lang else

	local namespace = mw.title.getCurrentTitle().namespace;						-- used for categorization
	local this_wiki_lang = mw.language.getContentLanguage().code;				-- get this wiki's language code

	for i, lang in ipairs (args) do
		local t = {args[i], ['link'] = args['link'], ['template'] = args['template']};	-- build an 'args' table
		lang = name_from_tag (t)												-- get the language name
		table.insert (list, lang)												-- add this language or error message to the list

		if lang:find ('error') or (this_wiki_lang == args[i]) or (0 ~= namespace) then	-- for these, no categorization
		else
			if lang:match ('%[%[.-|.-%]%]') then								-- wikilinked individual language
				lang = lang:match ('%[%[.-|(.-)%]%]');
			elseif lang:match ('%[%[.-%]%]') then								-- wikilinked collective languages
				lang = lang:match ('%[%[(.-)%]%]');
			end																	-- neither of these then plain text language

			if lang:find ('languages') then
				table.insert (cats, table.concat ({'[[Category:Articles with ', lang, '-collective sources (', args[i], ')]]'}));
			else
				table.insert (cats, table.concat ({'[[Category:Articles with ', lang, '-language sources (', args[i], ')]]'}));
			end
		end
	end
	
	local result = {'<span class="languageicon">('};							-- opening span and (
	table.insert (result, 'yes' == args['cap'] and 'In ' or 'in ');				-- add capitalized or uncapitalized 'in'
	table.insert (result, mw.text.listToText (list, ', ', (2 < #list) and ', and ' or ' and ' ));	-- and concatenated the language list

	table.insert (result, ')</span>');											-- add closing ) and closing span
	table.insert (result, table.concat (cats));									-- add categories
	return table.concat (result);												-- make a big string and done
end


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

implements combined is_ietf_tag() and tag_from_name() in Module:Lang for various infoboxen that support a 
|native_name_lang= parameter.

if {{{1}}} is a valid ietf language tag, returns that tag;
if {{{1}}} is a properly spelled (case agnostic) language name, returns the ietf language tag associated with that name
error messages else

entry point from an {{#invoke:Lang|native_name_lang|<language name or tag>|template=<template name>}}

]]

local function native_name_lang (frame)
	local lang_module = require ('Module:Lang/sandbox');
	local getArgs = require ('Module:Arguments').getArgs;
	local args = getArgs(frame);
	
	if lang_module._is_ietf_tag (args[1]) then
		return args[1];															-- if a tag, return the tag
	else
		return lang_module._tag_from_name (args);								-- not a tag, attempt to get a tag from the args[1] input value; return tag or error message
	end
end


--[[--------------------------< N I H O N G O _ R E N D E R E R >----------------------------------------------

shared support function for nihingo() and nihongo3() does final assembly and rendering

]]

local function nihongo_renderer (args, formatting, extra2)
	local output;
	local index = 0;															-- index into formatting{}
	local param_weight = {8, 4, 2, 1};											-- binary parameter weights: [1] = english (8), [2] = japanese (4), [3] = romaji (2), [4] = extra (1)

	for i=1, 5 do																-- calculate an index into formatting{}
		index = index + (args[i] and param_weight[i] or 0);
	end

	output = (0 ~= index) and string.format (formatting[index][1] and formatting[index][1], formatting[index][2][1], formatting[index][2][2], formatting[index][2][3], formatting[index][2][4]) or nil;
	if extra2 then
		output = output and (output .. ' ' .. extra2) or extra2;
	end
	
	return output;
end


--[=[-------------------------< N I H O N G O >----------------------------------------------------------------

An experiment to see how to implement {{nihongo}} using Module:Lang for language and transliteration markup

{{Nihongo|<English>|<kanji/kana>|<rōmaji>|<extra>|<extra2>|lead=yes}}

<English>, <kanji/kana>, and <rōmaji> are positional parameters
	<English>: rendered as presented; purports to be English translation of <kanji/kana>
	<kanji/kana>: Japanese language text using Japanese script; TODO: require?
	<rōmaji>: Hepburn romanization (transliteration); TODO: in Module:Lang/data change tooltip text to 'Hepburn romanization'?
<extra> and <extra2> are positional or named: |extra= and |extra2=; mixing can be problematic
	<extra> is rendered as presented preceeded with <comma><space>
	<extra2> is rendered as presented preceeded with <space>
|lead=: takes one value 'yes'; renders language name same as {{lang-ja}} but also adds [[Hepburn romanization|Hepburn]]:<space> ahead of the romanization; TODO: in Module:Lang, turnoff tooltip for transl when |lead=yes

]=]

local function nihongo (frame)
	local lang_module = require ('Module:Lang');
	local args = require ('Module:Arguments').getArgs (frame);
	
	local english = args[1];													-- meaningful names
	local japanese = args[2];
	local romaji = args[3];
	local extra = args[4] or args.extra;
	local extra2 = args[5] or args.extra2;
	local lead = 'yes' == args.lead;											-- make boolean

	if japanese then
		japanese = lead and lang_module._lang_xx_inherit ({['code']='ja', japanese}) or lang_module._lang ({'ja', japanese});	-- add ja script with/without language prefix
	end
	if romaji then
		romaji = (lead and english and '[[Hepburn romanization|Hepburn]]: ' or '') .. lang_module._transl ({'ja', 'hepburn', romaji}) or nil;
	end
	
	local formatting = {
		{'(%s)', {extra}}, 														-- 1 - (extra)
		{'%s', {romaji}},														-- 2 - romaji
		{'%s (%s)', {romaji, extra}},											-- 3 - romaji (extra)
		{'(%s)', {japanese}},													-- 4 - japanese
		{'(%s, %s)', {japanese, extra}},										-- 5 - (japanese, extra)
		{'%s (%s)', {romaji, japanese}},										-- 6 - romaji (japanese)
		{'%s (%s, %s)', {romaji, japanese, extra}},								-- 7 - romaji (japanese, extra)
		{'%s', {english}},														-- 8 - english
		{'%s (%s)', {english, extra}},											-- 9 - english (extra)
		{'%s (%s)', {english, romaji}},											-- 10 - english (romaji)
		{'%s (%s, %s)', {english, romaji, extra}},								-- 11 - english (romaji, extra)
		{'%s (%s)', {english, japanese}},										-- 12 - english (japanese)
		{'%s (%s, %s)', {english, japanese, extra}},							-- 13 - english (japanese, extra)
		{'%s (%s, %s)', {english, japanese, romaji}},							-- 14 - english (japanese, romaji)
		{'%s (%s, %s, %s)', {english, japanese, romaji, extra}},				-- 15 - english (japanese, romaji, extra)
		}

	return nihongo_renderer (args, formatting, extra2);
end


--[=[-------------------------< N I H O N G O 3 >--------------------------------------------------------------

An experiment to see how to implement {{nihongo3}} using Module:Lang for language and transliteration markup

Similar to {{nihongo}} but changes rendered order and does not support |lead=

{{Nihongo3|<English>|<kanji/kana>|<rōmaji>|<extra>|<extra2>}}

<English>, <kanji/kana>, and <rōmaji> are positional parameters
	<English>: rendered as presented; purports to be English translation of <kanji/kana>
	<kanji/kana>: Japanese language text using Japanese script; TODO: require?
	<rōmaji>: Hepburn romanization (transliteration); TODO: in Module:Lang/data change tooltip text to 'Hepburn romanization'?
<extra> and <extra2> are positional or named: |extra= and |extra2=; mixing can be problematic
	<extra> is rendered as presented preceeded with <comma><space>
	<extra2> is rendered as presented preceeded with <space>

]=]

local function nihongo3 (frame)
	local lang_module = require ('Module:Lang');
	local args = require ('Module:Arguments').getArgs (frame);
	
	local english = args[1];													-- meaningful names
	local japanese = args[2];
	local romaji = args[3];
	local extra = args[4] or args.extra;
	local extra2 = args[5] or args.extra2;

	japanese = japanese and lang_module._lang ({'ja', japanese}) or nil;
	romaji = romaji and lang_module._transl ({'ja', 'hepburn', romaji}) or nil;
	
	local formatting = {
		{'(%s)', {extra}}, 														-- 1 - (extra)
		{'%s', {romaji}},														-- 2 - romaji
		{'%s (%s)', {romaji, extra}},											-- 3 - romaji (extra)
		{'(%s)', {japanese}},													-- 4 - japanese
		{'(%s, %s)', {japanese, extra}},										-- 5 - (japanese, extra)
		{'%s (%s)', {romaji, japanese}},										-- 6 - romaji (japanese)
		{'%s (%s, %s)', {romaji, japanese, extra}},								-- 7 - romaji (japanese, extra)
		{'%s', {english}},														-- 8 - english
		{'%s (%s)', {english, extra}},											-- 9 - english (extra)
		{'%s (%s)', {romaji, english}},											-- 10 - romaji (english)
		{'%s (%s, %s)', {romaji, english, extra}},								-- 11 - romaji (english, extra)
		{'%s (%s)', {english, japanese}},										-- 12 - english (japanese)
		{'%s (%s, %s)', {english, japanese, extra}},							-- 13 - english (japanese, extra)
		{'%s (%s, %s)', {romaji, japanese, english}},							-- 14 - romaji (japanese, english)
		{'%s (%s, %s, %s)', {romaji, japanese, english, extra}},				-- 15 - romaji (japanese, english, extra)
		}

	return nihongo_renderer (args, formatting, extra2);
end


--[[--------------------------< E X P O R T E D   F U N C T I O N S >------------------------------------------
]]

return {
	in_lang = in_lang,
	native_name_lang = native_name_lang,
	nihongo = nihongo,
	nihongo3 = nihongo3,
	set_italics = set_italics,
	}