Hopp til innhold

Modul:Citation/CS1/Utilities

Rediger lenker
Fra Wikipedia, den frie encyklopedi
Moduldokumentasjon

Denne modulen og dens undermoduler er «motoren» bak CS1-stilen og de ulike kildemalene som følger denne ({{Kilde bok}}, {{Kilde www}}, osv…). Modulen er importert fra en:Module:Citation/CS1 og tilpasset norske forhold. De viktigste tilpasningene er i Modul:Citation/CS1/Configuration og Modul:Citation/CS1/Date validation, men det er gjort tilpasninger i omtrent alle undermodulene, så ved behov for å re-importere må man passe på dette. Re-importer alltid til sandkassene først.

Skal du gjøre endringer i denne modulen eller en av modulens undermoduler, prøv alltid i den tilhørende sandkassen først. Det finnes sandkasseversjoner av alle kildemalene som benytter Modul:Citation/CS1/sandkasse: {{Kilde bok/sandkasse}}, {{Kilde www/sandkasse}}, osv…, slik at du kan se hvordan disse blir påvirket av endringene dine.

Brukes av

Denne modulen brukes av følgende kildemaler:

Tilleggsmoduler


Vedlikeholdskategorier

Sider med feil i referansemaler
Articles with incorrect citation syntax
CS1-feil: eksterne lenker
CS1-feil: identikator-feil
CS1-feil: kapittel ignorert
CS1-feil: ugyldige parameter-verdier
CS1-feil: URL-wikilenke-konflikt
CS1-feil: usynlige tegn
CS1-vedlikehold
Pages using cite patent with unknown parameters
Sider med feil i Webarchive-malen
Sider med kildemaler hvor fornavn er angitt og ikke etternavn
Sider med kildemaler med feil i forfatterlenkeparameter
Sider med kildemaler som bruker besøksdato og mangler URL
Sider med kildemaler som bruker oversatt kapitteltittel og mangler originaltittel
Sider med kildemaler som bruker oversatt tittel og mangler originaltittel
Sider med kildemaler som bruker ubenevnte parametre
Sider med kildemaler som bruker ugyldige parametre
Sider med kildemaler som har overflødige parametre
Sider med kildemaler som inneholder datofeil
Sider med kildemaler som inneholder DOI-feil
Sider med kildemaler som inneholder format og ingen URL
Sider med kildemaler som inneholder gammel forfatterstil
Sider med kildemaler som inneholder gammel redaktørstil
Sider med kildemaler som inneholder ISBN-feil
Sider med kildemaler som inneholder ISSN-feil
Sider med kildemaler som inneholder medforfatter og mangler forfatter
Sider med kildemaler som inneholder motstridende sidespesifikasjoner
Sider med kildemaler som inneholder OL-feil
Sider med kildemaler som inneholder PMID-feil
Sider med kildemaler som inneholder rene URLer
Sider med kildemaler som inneholder URL-feil
Sider med kildemaler som inneholder utgåtte parametere
Sider med kildemaler som mangler arkivdato
Sider med kildemaler som mangler originallenke
Sider med kildemaler som mangler tittel
Sider med kildemaler uten URL
Sider med tomme kildemaler
Sider med tomme referanser
Dokumentasjonen ovenfor transkluderes fra Modul:Citation/CS1/Utilities/dok. (rediger | historikk)
Bidragsytere kan eksperimentere i denne modulens sandkasse (rediger | forskjell)- og testtilfeller (opprett)-sider.
Undersider av denne modulen.


local u = {}

local z = {
	error_categories = {};		-- for categorizing citations that contain errors
	error_ids = {};
	message_tail = {};
	maintenance_cats = {};		-- for categorizing citations that aren't erroneous per se, but could use a little work
	properties_cats = {};		-- for categorizing citations based on certain properties, language of source for instance
};

local cfg = mw.loadData ('Module:Citation/CS1/Configuration/sandbox');

--[[--------------------------< I S _ S E T >------------------------------------------------------------------

Returns true if argument is set; false otherwise. Argument is 'set' when it exists (not nil) or when it is not an empty string.
This function is global because it is called from both this module and from Date validation

]]
function is_set( var )
	return not (var == nil or var == '');
end

--[[--------------------------< I N _ A R R A Y >--------------------------------------------------------------

Whether needle is in haystack

]]

local function in_array( needle, haystack )
	if needle == nil then
		return false;
	end
	for n,v in ipairs( haystack ) do
		if v == needle then
			return n;
		end
	end
	return false;
end

--[[--------------------------< S U B S T I T U T E >----------------------------------------------------------

Populates numbered arguments in a message string using an argument table.

]]

local function substitute( msg, args )
	return args and mw.message.newRawMessage( msg, args ):plain() or msg;
end

--[[--------------------------< E R R O R _ C O M M E N T >----------------------------------------------------

Wraps error messages with css markup according to the state of hidden.

]]
local function error_comment( content, hidden )
	return substitute( hidden and cfg.presentation['hidden-error'] or cfg.presentation['visible-error'], content );
end

--[[--------------------------< S E T _ E R R O R >--------------------------------------------------------------

Sets an error condition and returns the appropriate error message.  The actual placement of the error message in the output is
the responsibility of the calling function.

]]
local function set_error( error_id, arguments, raw, prefix, suffix )
	local error_state = cfg.error_conditions[ error_id ];
	
	prefix = prefix or "";
	suffix = suffix or "";
	
	if error_state == nil then
		error( cfg.messages['undefined_error'] );
	elseif is_set( error_state.category ) then
		table.insert( z.error_categories, error_state.category );
	end
	
	local message = substitute( error_state.message, arguments );
	
	message = message .. " ([[" .. cfg.messages['help page link'] .. 
		"#" .. error_state.anchor .. "|" ..
		cfg.messages['help page label'] .. "]])";
	
	z.error_ids[ error_id ] = true;
	if in_array( error_id, { 'bare_url_missing_title', 'trans_missing_title' } )
			and z.error_ids['citation_missing_title'] then
		return '', false;
	end
	
	message = table.concat({ prefix, message, suffix });
	
	if raw == true then
		return message, error_state.hidden;
	end		
		
	return error_comment( message, error_state.hidden );
end

return {																		-- return exported functions and tables
	is_set = is_set,
	in_array = in_array,
	substitute = substitute,
	error_comment = error_comment,
	set_error = set_error,
	z = z,
	}
Hentet fra «https://no.wikipedia.org/w/index.php?title=Modul:Citation/CS1/Utilities&oldid=17426206»