ഘടകം:Location/ml

This is the documentation of Module:Location in English.

This module adds a referent to a location or administrative entity, for example it fetches ബെർലിൻ (Q64) as "Berlin, Germany".

Syntax തിരുത്തുക

On a sandbox page:
{{#invoke:Location|debug|<Qid>|<Qid2>|lang=<code>}}
From another module:
require('Module:Location').naming(<label>, _, <lang>, <Qid>, <Qid2>)
With syntax of Module:Wikidades#Function claim:
case=location

case=locationcontext

Parameters:

<Qid>, requested, is the Wikidata id of the location. With case=location only this parameter is used considering that the referent is not time dependent, that the current administrative structure is valid.
<Qid2>, optional, is the Wikidata id with a context date to be used for avoiding anachronistic references. With case=locationcontext this parameter is fetched from the current page.
<lang> is the language code, by default the language of local wiki.
<label>, used from another module, is used to avoid redundant referents.

When used with Module:Wikidades and case parameter, all parameters are obtained by that module.

It is not intented to be used with a template. Comment on the talk page if needed.

Data തിരുത്തുക

Data is fetched from Wikidata based on definition of രാജ്യം (P17). In cases with more detail, it uses Module:Wikidades function getParentValues with definition of സ്ഥിതിചെയ്യുന്ന ഭരണസ്ഥലം (P131) used recursively. See the documentation Module:Wikidades#Function getParentValues. In you found any supposed inconsistency, check first how these properties are defined on Wikidata.

If the referent is conditioned to a context date, for example in biographical infobox with case=locationcontext, this date is obtained from the current page:

The context date is compared with the referent date that indicates from when the referent is valid. The referent date can be defined in the criteria by language, for example the countries of UK are considered from year 1000. Otherwise:

From table anachronic_date with particular cases.
From property Creació (P571).
By default 1945.

Criteria തിരുത്തുക

The general referent is the country. Criteria may change in some cases according to style rules in each language. Currently languages available are: Catalan, English. You can request specific rules for other languages on the talk page.

Rules applied in English are:

United Kingdom by (Q3336843) or (Q46395).
United States by (Q35657) or (Q783733).
Canada by (Q11828004).
Australia by (Q5852411), (Q14192234) or (Q11687019).

Otherwise by രാജ്യം (P17).

There is an exception table for cases where any referent is considered unnecessary as too obvious. Currently if avoids "Washington, D.C., USA".

Categoria:Mòduls amb dades de Wikidata

local p = {}

-- locations where any referent is redundant or innecessary
function p.namingExceptions(id)
	local exc_id = {
		['Q61'] = true, -- Washington, D.C., USA
	}
	return exc_id[id]
end

---- Cases by state

-- Australia, by state/territory
local function namingLocationAUS(qid, label, c_date, main)
	local adm = main.fetchAdministrativeEntity(qid, 'en')
	local adm_entity = main.getAdmByID(adm, 'Q5852411', label) -- state of Australia
	if adm_entity == nil then
		adm_entity = main.getAdmByID(adm, 'Q14192234', label) -- mainland territory of Australia
		if adm_entity == nil then
			adm_entity = main.getAdmByID(adm, 'Q11687019', label) -- external territory of Australia
		end
	end
	return main.addReferent(label, adm_entity or 'Australia')
end

-- Canada, by province
local function namingLocationCA(qid, label, c_date, main)
	local adm = main.fetchAdministrativeEntity(qid, 'en')
	local adm_entity = main.getAdmByID(adm, 'Q11828004', label) -- province of Canada
	return main.addReferent(label, adm_entity or 'Canada')
end

-- UK, by country/territory
local function namingLocationUK(qid, label, c_date, main)
	if c_date < 1000 then
		return label
	end
	local adm = main.fetchAdministrativeEntity(qid, 'en')
	local adm_entity = main.getAdmByID(adm, 'Q3336843', label) -- constituent part of the United Kingdom
	if adm_entity == nil then
		if c_date < 1700 then
			return label
		else
			adm_entity = main.getAdmByID(adm, 'Q46395', label) -- British Overseas Territories
		end
	end
	return main.addReferent(label, adm_entity or 'United Kingdom')
end

-- USA, by state/territory
local function namingLocationUSA(qid, label, c_date, main)
	local adm = main.fetchAdministrativeEntity(qid, 'en')
	local adm_entity = main.getAdmByID(adm, 'Q35657', label) -- state of the United States
	if adm_entity == nil then
		adm_entity = main.getAdmByID(adm, 'Q783733', label) -- unincorporated territory
	end
	return main.addReferent(label, adm_entity or 'USA')
end

function p.namingLocation(state_id, loc_id, loc_label, context_date, main)
	if state_id == 'Q16' then -- Canada
		return namingLocationCA(loc_id, loc_label, context_date, main)
	elseif state_id == 'Q30' then -- USA
		return namingLocationUSA(loc_id, loc_label, context_date, main)
	elseif state_id == 'Q145' then -- United Kingdom
		return namingLocationUK(loc_id, loc_label, context_date, main)
	elseif state_id == 'Q408' then -- Australia
		return namingLocationAUS(loc_id, loc_label, context_date, main)
	end
	
	return
end

return p