Модуль:wikimedia languages

This module is used to retrieve and manage Wikimedia languages.

Until phab:T10217 is fixed there is a mis-match between the codes used by ISO 639, and those used by Wikimedia, for certain languages. There are also some languages that are recognised as distinct by Wikimedia, but are combined into other languages on Wiktionary (see Wiktionary:Language treatment). This module aids in mapping between the two.

The information itself is stored in Module:wikimedia languages/data. This modules should not be used directly by any other module, the data should only be accessed through the functions provided by Module:wikimedia languages.

Finding and retrieving languages

The module exports a number of functions that are used to find languages.

getByCode

getByCode(code)

Finds the Wikimedia language whose code matches the one provided. If it exists, it returns a WikimediaLanguage object representing the language. Otherwise, it returns nil.

getByCodeWithFallback

getByCodeWithFallback(code)

This does the same as getByCode. However, if that function returns nil, then the regular language with that code is retrieved, if it exists. The function then returns the first element of the list returned by a call to the :getWikimediaLanguages() method of that language. If that method returns no elements, the function returns nil.

Language objects' getWikimediaLanguages method

The :getWikimediaLanguages() method is available on regular Language objects (as returned by Module:languages). This method returns WikimediaLanguage objects that represent that language outside Wiktionary.

Comparison

Тилдерди издөөнүн ар кандай жолдорунун ортосундагы айырмачылыктарды кээ бир мисалдар менен бул жерден көрүүгө болот.

Code	Module:languages `.getByCode`	Module:languages `.getByCode():getWikimediaLanguages()`	Module:wikimedia languages `.getByCode`	Module:wikimedia languages `.getByCodeWithFallback`	Notes
`fr`	`fr`/Франсузча	`fr`/Франсузча	`fr`/Франсузча	`fr/Франсузча`	Код Викимедиа жана Уикисөздүк тарабынан колдонулат.
`bs`	`nil`	(error)	`bs`/Bosnian	`bs`/Bosnian	Код Викимедиа жана Уикисөздүк тарабынан колдонулат.
`sh`	`sh`/Сербче-Хорватча	`sh`/Сербче-Хорватча `bs`/Бошнакча `hr`/Хорватча `sr`/Сербче	`sh`/Сербче-Хорватча	`sh`/Сербче-Хорватча	Код Викимедиа жана Уикисөздүк тарабынан колдонулат. Module:wikimedia languages кайтарат `sh` анткени бул жарактуу Wikimedia коду. `:getWikimediaLanguages()` кодду бир нече мүмкүн болгон Wikimedia коддору менен салыштырат.
`cmn`	`cmn/Мандарин`	`zh`/Кытайча	`nil`	`zh`/Кытайча	Код Викимедиа тарабынан эмес, Wiktionary тарабынан гана колдонулат. Код `:getWikimediaLanguages()` тарабынан эквиваленттүү Wikimedia кодун `zh` менен салыштырылган.
`wym`	`wym`/Виламовианче	`nil`	`nil`	`nil`	Код Викимедиа тарабынан эмес, Wiktionary тарабынан гана колдонулат. Код `:getWikimediaLanguages()` тарабынан башка код менен салыштырылган эмес, андыктан `nil` кайтарылып берилет.

WikimediaLanguage objects

WikimediaLanguage объекти жогорудагы функциялардын биринен кайтарылды. Бул Wikimedia тилинин жана ага байланышкан маалыматтардын Lua өкүлчүлүгү. Анын : синтаксисин колдонуу менен чакыра турган бир нече ыкмалары бар. Мисалы:

local m_wmlanguages = require("Module:wikimedia languages")
local lang = m_wmlanguages.getByCode("bs")
local name = lang:getCanonicalName()
-- "name" will now be "Bosnian"

Language:getCode

:getCode()

Returns the language code of the language. Example: "fr" for French.

Language:getCanonicalName

:getCanonicalName()

Returns the canonical name of the language. This is the name used to represent that language on Wiktionary. Example: "French" for French.

Language:getAllNames

:getAllNames()

Тили белгилүү болгон бардык аталыштардын, анын ичинде канондук аталыштын таблицасын кайтарат. Аттардын уникалдуу болушу кепилдикке алынбайт, кээде бир эле ат менен бир нече тилдер белгилүү. Мисал: {"Французча", "Заманбап французча"} французча.

Language:getType

:getType()

"Wikimedia" кайтарат.

Language:getWiktionaryLanguage

:getWiktionaryLanguage()

Language объектин кайтарат (Module:languages караңыз), бул Wikimedia тилине эквиваленттүү Wiktionary-эне тилди билдирет. Көпчүлүк учурларда, бул түпнуска Wikimedia тили менен бирдей код жана аталыш болот, бирок алардын айрымдары айырмаланат.

Language объекттериндеги :getWikimediaLanguages ыкмасынан айырмаланып, бул бир гана объектти кайтарарын эске алыңыз. Бул тегдерди колдонуу жана скрипт форматтоо бир түшүнүктүү болушу үчүн жасалат.

Language:getRawData

:getRawData()

Бул функция жазууларда же башка мазмун барактарында колдонуу үчүн эмес.

Тил жөнүндө маалымат топтомун кайтарат. Бул блоктун форматы документтештирилбеген жана балким туруксуз; ал модулдун "жакын достору" болгон жана формат өзгөргөн сайын актуалдуу болуп турган модулдун өзүнүн бирдик тесттери сыяктуу нерселерге арналган.

local export = {}

local WikimediaLanguage = {}

function WikimediaLanguage:getCode()
	return self._code
end

function WikimediaLanguage:getCanonicalName()
	return self._rawData.canonicalName
end

--function WikimediaLanguage:getAllNames()
--	return self._rawData.names
--end

--[==[Given a list of types as strings, returns true if the Wikimedia language has all of them. Possible types are explained in [[Module:wikimedia languages/data]].]==]
function WikimediaLanguage:hasType(...)
	if not self._type then
		self._type = {["Wikimedia language"] = true}
		if self._rawData.type then
			for _, type in ipairs(mw.text.split(self._rawData.type, "%s*,%s*")) do
				self._type[type] = true
			end
		end
	end
	for _, type in ipairs{...} do
		if not self._type[type] then
			return false
		end
	end
	return true
end

function WikimediaLanguage:getWiktionaryLanguage()
	if not self._wiktionaryLanguageObject then
		self._wiktionaryLanguageObject = require("Module:languages").getByCode(self._rawData.wiktionary_code, nil, "allow etym")
	end
	
	return self._wiktionaryLanguageObject
end

-- Do NOT use this method!
-- All uses should be pre-approved on the talk page!
function WikimediaLanguage:getRawData()
	return self._rawData
end

WikimediaLanguage.__index = WikimediaLanguage

function export.getByCode(code)
	-- Only accept codes the software recognises
	if not mw.language.isKnownLanguageTag(code) then
		return nil
	end
	
	local rawData = mw.loadData("Module:wikimedia languages/data")[code]
	
	-- If there is no specific Wikimedia code, then "borrow" the information
	-- from the general Wiktionary language code
	if not rawData then
		local lang = require("Module:languages").getByCode(code, nil, "allow etym")
		
		if not lang then
			return nil
		end
		
		rawData = {canonicalName = lang:getCanonicalName(), wiktionary_code = code}
	elseif not rawData.canonicalName then
		rawData = {
			canonicalName = require("Module:languages").getByCode(rawData.wiktionary_code, nil, "allow etym"):getCanonicalName(),
			wiktionary_code = rawData.wiktionary_code
		}
	end
	
	return setmetatable({_rawData = rawData, _code = code}, WikimediaLanguage)
end

function export.getByCodeWithFallback(code)
	local object = export.getByCode(code)
	
	if object then
		return object
	end
	
	local lang = require("Module:languages").getByCode(code, nil, "allow etym")
	
	if not lang then
		return nil
	end
	
	return lang:getWikimediaLanguages()[1]
end

return export