Misplaced Pages

Revision as of 12:43, 1 December 2020

This is the module sandbox page for Module:Wikt-lang (diff). See also the companion subpage for test cases (run).

This module is rated as beta, and is ready for widespread use. It is still new and should be used with some caution to ensure the results are as expected.

This module depends on the following other modules: Module:Wikt-lang/data (sandbox) Module:Unicode data (sandbox)

This module is used by {{Wikt-lang}}. It is inspired by the templates {{m}} and {{l}} and their associated modules on Wiktionary. It has a Wiktionary link function that links to the correct section of the Wiktionary entry, and applies correct language formatting and italics. The language-tagging function does most of what {{Lang}} does, except that italics can't be customized and categories aren't added.

The module uses Module:Wikt-lang/data to retrieve the language name for a language code, and to perform the necessary entry-name replacements (for instance, removing macrons from Latin entry names). These are unfortunately not automatically retrieved from Wiktionary's Wikt-lang data modules. For language codes that do not have a name value in this module, the language name is fetched with mw.language.fetchLanguage. When mw.language.fetchLanguage does not fetch the correct language name (or any language name at all), please add it to Module:Wikt-lang/data, and similarly when the correct entry name is not generated, please add the entry name replacements to the module.

Examples

• {{#invoke:Wikt-lang|wiktlang|en|language}} -> language
• {{#invoke:Wikt-lang|wiktlang|en|language|languages}} -> languages
• {{#invoke:Wikt-lang|wiktlang|fr|bourguignon}} -> bourguignon
• {{#invoke:Wikt-lang|wiktlang|la|homō}} -> homō
• {{#invoke:Wikt-lang|wiktlang|grc|δημοκρατίᾱ}} -> δημοκρατίᾱ
• {{#invoke:Wikt-lang|wiktlang|ru|язы́к}} -> язы́к
• {{#invoke:Wikt-lang|wiktlang|ar|العَرَبِيَّة}} -> ‏العَرَبِيَّة‎
• {{#invoke:Wikt-lang|wiktlang|fa|فارسی}} -> فارسی
• {{#invoke:Wikt-lang|wiktlang|ine-x-proto|*h₂enǵʰ-}} -> *h₂enǵʰ-

Invalid codes

• {{#invoke:Wikt-lang|wiktlang|EN|language}} -> language
• {{#invoke:Wikt-lang|wiktlang|En|language|languages}} -> languages
• {{#invoke:Wikt-lang|wiktlang|La|homō}} -> homō
• {{#invoke:Wikt-lang|wiktlang|Grc|δημοκρατίᾱ}} -> δημοκρατίᾱ
• {{#invoke:Wikt-lang|wiktlang|Ru|язы́к}} -> язы́к
• {{#invoke:Wikt-lang|wiktlang|Ar|العَرَبِيَّة}} -> ‏العَرَبِيَّة‎
• {{#invoke:Wikt-lang|wiktlang|Fa|فارسی}} -> فارسی

Errors

• {{#invoke:Wikt-lang|wiktlang|en-Latin|language}} -> language

Comparison of codes

Tracking categories

• Template:Tracking/wikt-lang/reconstructed with no asterisk

require("Module:No globals")
local m_data = mw.loadData("Module:Language/data/sandbox")
local langModule = require("Module:Lang/sandbox")
local langData = m_data.languages or m_data

local strings = {
	 = "Reconstruction:%s/%s",
	 = "Appendix:%s/%s",
	 = "]",
	 = "]",
}

local errorMessages = {
	 = "No language code.",
	 = "No Wiktionary entry.",
	 = "The language name for the language code <code>%s</code> was not found.",
}

local trackingCategories = {
	 = "]",
	 = "]",
	 = "]",
}

local activeTrackingCategories = {}

local p = {}

local function get_error_message(message)
	return string.format('<span style="font-size: 100%%; font-style: normal;" class="error">Error: %s</span>', message) .. trackingCategories
end

local function getCodes(code, text)
	local redirectCode = m_data.redirects
	if redirectCode then
		code = redirectCode
		table.insert(activeTrackingCategories, trackingCategories)
	end

	local _, _, _, _, private, errorText = langModule.get_ietf_parts(code)

	-- Temp code to handle custom private codes until added properly to Module:Lang.
	if errorText and m_data.languages and m_data.languages.private then
		errorText = nil
	end

	return code, errorText
end	

local function cleanWiktionaryText(wiktionaryText, languageCode)
	local data = langData
	wiktionaryText = tostring(wiktionaryText)

	-- Remove bold and italics, so that words that contain bolding or emphasis can be linked without piping.
	wiktionaryText = wiktionaryText:gsub("\'\'\'", "")
	wiktionaryText = wiktionaryText:gsub("\'\'", "")
	
	-- If the language is not found, return wiktionaryText.
	if data == nil then
		return wiktionaryText
	end

	-- If the language does not have diacritics, return wiktionaryText.
	local replacements = data and data
	if replacements == nil then
		return wiktionaryText
	end

	-- Decompose so that the diacritics of characters such
	-- as á can be removed in one go.
	-- No need to compose at the end, because the MediaWiki software
	-- will handle that.
	local ugsub = mw.ustring.gsub
	if replacements.decompose then
		wiktionaryText = mw.ustring.toNFD(wiktionaryText)
		for i, from in ipairs(replacements.from) do
			wiktionaryText = ugsub(wiktionaryText, from, replacements.to and replacements.to or "")
		end
	else
		for regex, replacement in pairs(replacements) do
			wiktionaryText = ugsub(wiktionaryText, regex, replacement)
		end
	end

	return wiktionaryText
end

local function createWiktionaryLink(wiktionaryText, displayText, languageCode)
	local nameFromTag = langModule._name_from_tag({languageCode})
	if languageCode then
		local data = langData
		local name
		if data and data.name then
			name = data.name
		elseif nameFromTag and not nameFromTag:find("error") then
			name = nameFromTag
		else
			-- On other languages' wikis, use mw.getContentLanguage():getCode(),
			-- or replace 'en' with that wiki's language code.
			-- name = mw.language.fetchLanguageName(languageCode, mw.getContentLanguage():getCode())
			name = mw.language.fetchLanguageName(languageCode, 'en')
		end

		if name == "" then
			return get_error_message(string.format(errorMessages, languageCode))
		end

		if wiktionaryText:sub(1, 1) == "*" then
			wiktionaryText = string.format(strings, name, wiktionaryText:sub(2))

		elseif data and data.type == "reconstructed" then
			-- Track reconstructed entries with no asterisk by transcluding
			table.insert(activeTrackingCategories, trackingCategories)
			wiktionaryText = string.format(strings, name, wiktionaryText)

		elseif data and data.type == "appendix" then
			wiktionaryText = string.format(strings, name, wiktionaryText)
		end

		return string.format(strings, wiktionaryText, name, displayText)
	else
		return string.format(strings, wiktionaryText, displayText)
	end
end

function p.wikt(frame)
	frame = true
	return p.wiktlang(frame)
end

function p.wiktlang(frame)
	local getArgs = require('Module:Arguments').getArgs
	local args = getArgs(frame)

	local code = args and mw.text.trim(args)
	if not code then
		return get_error_message(errorMessages)
	end

	local wiktionaryText = args
	if not wiktionaryText then
		return get_error_message(errorMessages)
	end

	local displayText = args
	local languageCode, errorMessage = getCodes(code, displayText or wiktionaryText)

	if errorMessage then
		return get_error_message(errorMessage)
	end

	local italics = args.italics or args.i
	italics = not (italics == "n" or italics == "-")

	local wiktionaryTextCleaned = cleanWiktionaryText(wiktionaryText, languageCode)

	if not displayText then
		displayText = wiktionaryText
	end

	local wiktionaryLink = createWiktionaryLink(wiktionaryTextCleaned, displayText, languageCode)
	if not args then
		local langArgs = {code = languageCode, text = wiktionaryLink, italic = italics}
		wiktionaryLink = langModule._lang(langArgs)
	end
	
	-- Used for testing
	if args then
		return wiktionaryLink
	else
		return wiktionaryLink .. table.concat(activeTrackingCategories)
	end
end

return p

• Module sandboxes