Модуль:ResolveEntityId

Документація модуля[перегляд] [редагувати] [історія] [очистити кеш]

Використання

Функції подібні до mw.wikibase.resolvePropertyId, але для сутностей Вікіданих замість властовостей.

Повертає id сутності для надоної мітки чи id. Це дозволяє використовувати мітки сутностей замість id у всіх місцях. Якщо не знайдено жодної сутності для мітки або id, або якщо мітка є неоднозначною, то повертається значення nil.

При спробі опрацювати мітку, лише сутність з посиланням української Вікіпедії враховуються в пошуку. Якщо мітка існує у Вікіданих, але не містить необхідне мовне посилання, то повертається значення nil.

Виклик в іншому модулі (_id)

Приклади викликів всередині модуля можуть виглядати наступним чином:

Код	Результат	Коментарі
local resolveEntityId = require( "Module:ResolveEntityId" )._id id = resolveEntityId('Q42')	id = Q42	«Q42» є дісними ID Вікіданих, а елемент Вікіданих існує з такими Id, тому повернене значення не змінилося
local resolveEntityId = require( "Module:ResolveEntityId" )._id id = resolveEntityId('Q0')	id = nil	«Q0» не є дісними ID Вікіданих, і хоча стаття у Вікіпедії Q0 існує (приклад з англ. вікі, де стаття існує), але це сторінка значень, тому повернено nil
local resolveEntityId = require( "Module:ResolveEntityId" )._id id = resolveEntityId('Q404')	id = Q404	«Q404» є перенаправленням Вікіданих на Q395, тому повернуто останнє значення
local resolveEntityId = require( "Module:ResolveEntityId" )._id id = resolveEntityId('Q2147483647')	id = nil	Q2147483647 є дісними ID Вікіданих, але жодної сутності з цим ID не існує, тому повернено nil
local resolveEntityId = require( "Module:ResolveEntityId" )._id id = resolveEntityId('Дуглас Адамс')	id = Q42	Стаття Дуглас Адамс існує та має ID Вікіданих «Q42», тому це значення повернуто.
local resolveEntityId = require( "Module:ResolveEntityId" )._id id = resolveEntityId('ЦеНеСправжнійЕлементВікіданих')	id = nil	«ЦеНеСправжнійЕлементВікіданих» не є дісними ID Вікіданих і жодної статті Вікіпедії не існує за назвою ЦеНеСправжнійЕлементВікіданих, тому повернуто nil
local resolveEntityId = require( "Module:ResolveEntityId" )._id id = resolveEntityId('ЦеНеСправжнійЕлементВікіданих', 'ID Вікіданих не знайдено!')	id = 'ID Вікіданих не знайдено!'	Таке саме, що і вище, але повернути власне повідомлення про помилку ID Вікіданих не знайдено!
local resolveEntityId = require( "Module:ResolveEntityId" )._id id = resolveEntityId('Адамс Дуглас')	id = Q42	«Дуглас адамс» не є дісними ID Вікіданих, і хоча Адамс Дуглас (з перестановкою місцями імення і прізвища) існує, але це перенаправлення на Дуглас Адамс. Тому повернуто ID Вікіданих для останньої сторінки
local resolveEntityId = require( "Module:ResolveEntityId" )._id id = resolveEntityId('Вікіпедія:Кнайпа (технічні питання)/Архів 1')	id = nil	«Вікіпедія:Кнайпа (технічні питання)/Архів 1» не є дісними ID Вікіданих, і хоча Вікіпедія:Кнайпа (технічні питання)/Архів 1 існує, але не має прив'язаного ID Вікіданих, тому повернуто nil

Використання всередині шаблону (entityid)

Наступне поверне id сутності (або нічого, якщо ID не існує): {{#invoke:ResolveEntityId|entityid|id}}

Наступне поверне id сутності (або альтернативний текст, якщо ID не існує): {{#invoke:ResolveEntityId|entityid|id|альтернативний текст, якщо id є nil}}

Колишня функція _entityid

Функція _entityid, яка вимагає передачі frame як першого аргументу, була видалено з модуля, бо більше цей обхідний шлях не потрібен для phab:T143970.

local p = {}

function p._id(idOrTitle, alt)
	local function checkId(id)
		if id and mw.wikibase.entityExists(id) then
			local sitelink = mw.wikibase.getSitelink(id)
			if sitelink then
				return mw.wikibase.getEntityIdForTitle(sitelink) or mw.wikibase.getEntity(id).id
			end
			return mw.wikibase.getEntity(id).id
		else
			return alt
		end
	end

	if type(idOrTitle) == 'string' then
		idOrTitle = mw.ustring.upper(mw.ustring.sub(idOrTitle, 1, 1)) .. mw.ustring.sub(idOrTitle, 2)
		if mw.wikibase.isValidEntityId(idOrTitle) then
			-- idOrTitle is in the proper format for a Wikidata entity ID
			return checkId(idOrTitle)
		else
			local eid = mw.wikibase.getEntityIdForTitle(idOrTitle)
			if eid then
				-- idOrTitle is a title that matches a Wikidata entity
				local instanceOf = mw.wikibase.getBestStatements(eid, 'P31')[1] --instance of
				if not instanceOf or instanceOf.mainsnak.datavalue.value.id ~= 'Q4167410' then
					-- instance-of value is missing or is not "disambiguation"
					return checkId(eid)
				end
			else
				-- idOrTitle is a title, but no wikidata item exists for that title
				local page = mw.title.new(idOrTitle)
				if page then -- valid title
					local rtarget = page.redirectTarget
					if rtarget then	-- title is a Wikipedia redirect
						return p._id(rtarget.fullText, alt)
					end
				end
			end
		end
	end
	return alt
end

function p.entityid(frame)
	return p._id(frame.args[1], frame.args[2])
end

return p