Документација модула[прикажи] [уреди] [историја] [освежи]

This module is used to retrieve and manage Wikimedia languages.

Until https://bugzilla.wikimedia.org/show_bug.cgi?id=8217 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.

This module provides access for other modules. To access the information from within a template, see Module:wikimedia languages/templates.

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.

Проналажење и преузимање језика уреди

Модул извози низ функција које се користе за проналажење језика.

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.

Поређење уреди

The differences between the various ways of retrieving languages can be seen here, using some examples.

Код Module:languages
.getByCode
Module:languages
.getByCode():getWikimediaLanguages()
Module:wikimedia languages
.getByCode
Module:wikimedia languages
.getByCodeWithFallback
Белешка
fr fr/Француски fr/Француски fr/Француски fr/Француски Code used by both Wikimedia and Wiktionary.
bs nil (error) bs/Bosnian bs/Bosnian Code used only by Wikimedia, not Wiktionary.
sr sr/Српски sr/Serbian
/Lua грешка in Модул:wikimedia_languages/templates at line 28: The wikimedia language code is not valid..
/Lua грешка in Модул:wikimedia_languages/templates at line 28: The wikimedia language code
is not valid..
/Lua грешка in Модул:wikimedia_languages/templates at line 28: The wikimedia language code is not valid..
sr/Serbian sr/Serbian Code used by both Wikimedia and Wiktionary.
Module:wikimedia languages returns sr as that is a valid Wikimedia code.
:getWikimediaLanguages() maps the code to multiple possible Wikimedia codes.
cmn cmn/Mandarin zh/Кинески nil zh/Кинески Code is used only by Wiktionary, not Wikimedia.
The code is mapped by :getWikimediaLanguages() to the equivalent Wikimedia code zh.
wym wym/Vilamovian nil nil nil Code is used only by Wiktionary, not Wikimedia.
The code is not mapped onto another by :getWikimediaLanguages(), so nil is returned.

WikimediaLanguage objects уреди

A WikimediaLanguage object is returned from one of the functions above. It is a Lua representation of a Wikimedia language and the data associated with it. It has a number of methods that can be called on it, using the : syntax. For example:

local m_wmlanguages = require("Модул: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()

Returns a table of all names that the language is known by, including the canonical name. The names are not guaranteed to be unique, sometimes more than one language is known by the same name. Example: {"French", "Modern French"} for French.

Language:getType уреди

:getType()

Returns "Wikimedia".

Language:getWiktionaryLanguage уреди

:getWiktionaryLanguage()

Returns a Language object (see Модул:languages) that represents the Wiktionary-native language that is equivalent to this Wikimedia language. In most cases, this will be the same code and name as the original Wikimedia language, but a few of them differ.

Note that unlike the :getWikimediaLanguages method in on Language objects, this only returns a single object. This is done so that the application of tags and script formatting is unambiguous.

Language:getRawData уреди

:getRawData()

This function is not for use in entries or other content pages.

Returns a blob of data about the language. The format of this blob is undocumented, and perhaps unstable; it's intended for things like the module's own unit-tests, which are "close friends" with the module and will be kept up-to-date as the format changes.

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("Модул:languages").getByCode(self._rawData.wiktionary_code)
	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("Модул: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("Модул:languages").getByCode(code)
		
		if not lang then
			return nil
		end
		
		rawData = {canonicalName = lang:getCanonicalName(), wiktionary_code = code}
	elseif not rawData.canonicalName then
		rawData = {canonicalName = require("Модул:languages").getByCode(rawData.wiktionary_code):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("Модул:languages").getByCode(code)
	
	if not lang then
		return nil
	end
	
	return lang:getWikimediaLanguages()[1]
end

return export