Moduli:Citation/CS1/Configuration

Nga Wikiquote
Jump to navigation Jump to search

Documentation for this module may be created at Moduli:Citation/CS1/Configuration/doc

--[[--------------------------< U N C A T E G O R I Z E D _ N A M E S P A C E S >------------------------------

List of namespaces that should not be included in citation error categories.  Same as setting notracking = true by default

Note: Namespace names should use underscores instead of spaces.

]]
local uncategorized_namespaces = { 'User', 'Talk', 'User_talk', 'Wikipedia_talk', 'File_talk', 'Template_talk', 'Help_talk', 'Category_talk', 'Portal_talk', 'Book_talk', 'Draft_talk', 'Education_Program_talk', 'Module_talk', 'MediaWiki_talk' };

local uncategorized_subpages = {'/[Ss]andbox', '/[Tt]estcases'};				-- list of Lua patterns found in page names of pages we should not categorize



--[[--------------------------< M E S S A G E S >--------------------------------------------------------------

Translation table

The following contains fixed text that may be output as part of a citation.
This is separated from the main body to aid in future translations of this
module.

]]

local messages = {
	['agency'] = '$1 $2',														-- $1 is sepc, $2 is agency
	['archived-dead'] = 'Arkivuar nga origjinali $1 më $2',
	['archived-live'] = '$1 nga origjinali më $2',
	['archived-missing'] = 'Arkivuar nga origjinali $1 më $2',
	['archived'] = 'Arkivuar',
	['by'] = 'Nga',																-- contributions to authored works: introduction, foreword, afterword
	['cartography'] = 'Kartografi nga $1',
	['editor'] = 'red.',
	['editors'] = 'red.',
	['edition'] = '(bot. $1))',
	['episode'] = 'Episodi $1',
	['et al'] = 'etj.',
	['in'] = 'më',																-- edited works
	['inactive'] = 'jo aktiv',
	['inset'] = '$1 përfshirë',
	['interview'] = 'Intervistuar nga $1',										
	['lay summary'] = 'Përmbledhje e shkurtër',
	['newsgroup'] = '[[Usenet newsgroup|Newsgroup]]:&nbsp;$1',
	['original'] = 'origjinali',
	['origyear'] = ' [$1]',
	['published'] = ' (publikuar $1)',
	['retrieved'] = 'Marrë më $1',
	['season'] = 'Sezoni $1',
	['section'] = '§ $1',
	['sections'] = '§§ $1',
	['series'] = '$1 $2',														-- $1 is sepc, $2 is series
	['seriesnum'] = 'Seria $1',
	['translated'] = 'Përkthyer nga $1',
	['type'] = ' ($1)',															-- for titletype
	['written'] = 'Shkruar në $1',

	['vol'] = '$1 Vëll.&nbsp;$2',												-- $1 is sepc; bold journal style volume is in presentation{}
	['vol-no'] = '$1 Vëll.&nbsp;$2 no.&nbsp;$3',									-- sepc, volume, issue
	['issue'] = '$1 Nr.&nbsp;$2',												-- $1 is sepc

	['j-vol'] = '$1 $2',														-- sepc, volume; bold journal volume is in presentation{}
	['j-issue'] = ' ($1)',

	['nopp'] = '$1 $2';															-- page(s) without prefix; $1 is sepc

	['p-prefix'] = "$1 f.&nbsp;$2",												-- $1 is sepc
	['pp-prefix'] = "$1 ff.&nbsp;$2",											-- $1 is sepc
	['j-page(s)'] = ': $1',														-- same for page and pages

	['sheet'] = '$1 fletë&nbsp;$2',												-- $1 is sepc
	['sheets'] = '$1 fletë&nbsp;$2',											-- $1 is sepc
	['j-sheet'] = ': fletë&nbsp;$1',
	['j-sheets'] = ': fletë&nbsp;$1',
	
	['subscription'] = '<span class="cs1-subscription">(Kërkohet abonim (<span title="Faqja kërkon abonim me pagesë për tu hapur.">help</span>))</span>' ..
		'[[Category:Faqe me burime që kërkojnë abonim me pagesë]]',
	
	['registration']='<span class="cs1-registration">(Kërkohet regjistrim (<span title="Faqja kërkon regjistrim për tu hapur.">help</span>))</span>' ..
		'[[Category:Faqe me burime që kërkojnë regjistrim]]',
	
	['language'] = '(në $1)',
	['via'] = " &ndash; nëpërmjet $1",
	['event'] = 'Ngjarja ndodh te',
	['minutes'] = 'minuta në',
	
	['parameter-separator'] = ', ',
	['parameter-final-separator'] = ' dhe ',
	['parameter-pair-separator'] = ' dhe ',
	
	-- Determines the location of the help page
	['help page link'] = 'Ndihmë:Gabimet CS1',
	['help page label'] = 'Ndihmë!',
	
	-- Internal errors (should only occur if configuration is bad)
	['undefined_error'] = 'Thirrur me një kusht të gabuar të papërcaktuar',
	['unknown_manual_ID'] = 'Metodë manuale identifikimi e panjohur',
	['unknown_ID_mode'] = 'Metodë identifikimi e panjohur',
	['unknown_argument_map'] = 'Harta e argumenteve nuk është përcaktuar për këtë ndryshore',
	['bare_url_no_origin'] = 'Është gjetur adresë e zhveshur por treguesi i origjinës është zero ose bosh',
	}


--[=[-------------------------< E T _ A L _ P A T T E R N S >--------------------------------------------------

This table provides Lua patterns for the phrase "et al" and variants in name text
(author, editor, etc.). The main module uses these to identify and emit the 'etal' message.

TODO: detect wikilinked et al.:  [[et al]].

]=]

local et_al_patterns = {
	"[;,]? *[\"']*%f[%a][Ee][Tt]%.? *[Aa][Ll][%.\"']*$",						-- variations on the 'et al' theme
	"[;,]? *[\"']*%f[%a][Ee][Tt]%.? *[Aa][Ll][Ii][Aa][%.\"']*$",				-- variations on the 'et alia' theme
	"[;,]? *%f[%a]and [Oo]thers",												-- and alternate to et al.
	}


--[[--------------------------< E D I T O R _ M A R K U P _ P A T T E R N S >----------------------------------

This table provides Lua patterns for the phrase "ed" and variants in name text
(author, editor, etc.). The main module uses these to identify and emit the
'extra_text_names' message. (It is not the only series of patterns for this message.)

]]
local editor_markup_patterns = {												-- these patterns match annotations at end of name
	'%f[%(%[][%(%[]%s*[Ee][Dd][Ss]?%.?%s*[%)%]]?$',								-- (ed) or (eds): leading '(', case insensitive 'ed', optional 's', '.' and/or ')'
	'[,%.%s]%f[e]eds?%.?$',														-- ed or eds: without '('or ')'; case sensitive (ED could be initials Ed could be name)
	'%f[%(%[][%(%[]%s*[Ee][Dd][Ii][Tt][Oo][Rr][Ss]?%.?%s*[%)%]]?$',				-- (editor) or (editors): leading '(', case insensitive, optional '.' and/or ')'
	'[,%.%s]%f[Ee][Ee][Dd][Ii][Tt][Oo][Rr][Ss]?%.?$',							-- editor or editors: without '('or ')'; case insensitive
		
																				-- these patterns match annotations at beginning of name
	'^eds?[%.,;]',																-- ed. or eds.: lower case only, optional 's', requires '.'
	'^[%(%[]%s*[Ee][Dd][Ss]?%.?%s*[%)%]]',										-- (ed) or (eds): also sqare brackets, case insensitive, optional 's', '.'
	'^[%(%[]?%s*[Ee][Dd][Ii][Tt][Oo][Rr][Ss]?%A',								-- (editor or (editors: also sq brackets, case insensitive, optional brackets, 's'
	'^[%(%[]?%s*[Ee][Dd][Ii][Tt][Ee][Dd]%A',									-- (edited: also sq brackets, case insensitive, optional brackets
	}


--[[--------------------------< P R E S E N T A T I O N >------------------------------------------------------

Fixed presentation markup.  Originally part of citation_config.messages it has been moved into its own, more semantically
correct place.

]]

local presentation = 
	{
	-- Error output
	-- .error class is specified at https://git.wikimedia.org/blob/mediawiki%2Fcore.git/9553bd02a5595da05c184f7521721fb1b79b3935/skins%2Fcommon%2Fshared.css#L538
	-- .citation-comment class is specified at Help:CS1_errors#Controlling_error_message_display
	['hidden-error'] = '<span class="cs1-hidden-error error citation-comment">$1</span>',
	['visible-error'] = '<span class="cs1-visible-error error citation-comment">$1</span>',
	['hidden-maint'] = '<span class="cs1-maint citation-comment">$1</span>',
	
	['accessdate'] = '<span class="reference-accessdate">$1$2</span>',			-- to allow editors to hide accessdate using personal css

	['bdi'] = '<bdi$1>$2</bdi>',												-- bidirectional isolation used with |script-title= and the like

	['cite'] = '<cite class="$1">$2</cite>';									-- |ref= not set so no id="..." attribute
	['cite-id'] = '<cite id="$1" class="$2">$3</cite>';							-- for use when |ref= is set

	['format'] = ' <span class="cs1-format">($1)</span>',						-- for |format=, |chapter-format=, etc
	
																				-- various access levels, for |access=, |doi-access=, |arxiv=, ...
																				-- narrow no-break space &#8239; may work better than nowrap css. Or not? browser support?

	['ext-link-access-signal'] = '<span class="$1" title="$2">$3</span>',		-- external link with appropriate lock icon
		['free'] = {class='cs1-lock-free', title='Nuk kërkohet regjistrim'},			-- classes defined in Module:Citation/CS1/styles.css
		['registration'] = {class='cs1-lock-registration', title='Kërkohet regjistrim'},
		['limited'] = {class='cs1-lock-limited', title='Regjistrimi falas është i përkohshëm'},
		['subscription'] = {class='cs1-lock-subscription', title='Kërkohet regjistrim me pagesë'},

	['interwiki-icon'] = '<span class="$1" title="$2">$3</span>',
		['class-wikisource'] = 'cs1-ws-icon',

	['italic-title'] = "''$1''",

	['kern-left'] = '<span class="cs1-kern-left">$1</span>$2',					-- spacing to use when title contains leading single or double quote mark
	['kern-right'] = '$1<span class="cs1-kern-right">$2</span>',				-- spacing to use when title contains trailing single or double quote mark

																				-- these for simple wikilinked titles [["text]], [[text"]] and [["text"]]
																				-- span wraps entire wikilink
	['kern-wl-left'] = '<span class="cs1-kern-wl-left">$1</span>',				-- when title contains leading single or double quote mark
	['kern-wl-right'] = '<span class="cs1-kern-wl-left">$1</span>',				-- when title contains trailing single or double quote mark
	['kern-wl-both'] = '<span class="cs1-kern-wl-left cs1-kern-wl-right">$1</span>',	-- when title contains leading and trailing single or double quote marks

	['nowrap1'] = '<span class="nowrap">$1</span>',								-- for nowrapping an item: <span ...>yyyy-mm-dd</span>
	['nowrap2'] = '<span class="nowrap">$1</span> $2',							-- for nowrapping portions of an item: <span ...>dd mmmm</span> yyyy (note white space)

	['ocins'] = '<span title="$1" class="Z3988"></span>',
	
	['parameter'] = '<code class="cs1-code">&#124;$1=</code>',
 
	['ps_cs1'] = '.';															-- cs1 style postscript (terminal) character
	['ps_cs2'] = '';															-- cs2 style postscript (terminal) character (empty string)

	['quoted-text'] = '<q>$1</q>',												-- for wrapping |quote= content
	['quoted-title'] = '"$1"',

	['sep_cs1'] = '.',															-- cs1 element separator
	['sep_cs2'] = ',',															-- cs2 separator
	['sep_nl'] = ';',															-- cs1|2 style name-list separator between authors is a semicolon
	['sep_name'] = ', ',														-- cs1|2 style last/first separator is <comma><space>
	['sep_nl_vanc'] = ',',														-- Vancouver style name-list separator between authors is a comma
	['sep_name_vanc'] = ' ',													-- Vancouver style last/first separator is a space

	['trans-italic-title'] = "&#91;''$1''&#93;",
	['trans-quoted-title'] = "&#91;$1&#93;",
	['vol-bold'] = '$1 <b>$2</b>',												-- sepc, volume; for bold journal cites; for other cites ['vol'] in messages{}
	}

	

--[[--------------------------< A L I A S E S >----------------------------------------------------------------

Aliases table for commonly passed parameters

]]

local aliases = {
	['AccessDate'] = {'access-date', 'accessdate'},
	['Agency'] = 'agency',
	['AirDate'] = {'air-date', 'airdate'},
	['ArchiveDate'] = {'archive-date', 'archivedate'},
	['ArchiveFormat'] = 'archive-format',
	['ArchiveURL'] = {'archive-url', 'archiveurl'},
	['ASINTLD'] = {'ASIN-TLD', 'asin-tld'},
	['At'] = 'at',
	['Authors'] = {'authors', 'people', 'credits'},
	['BookTitle'] = {'book-title', 'booktitle'},
	['Cartography'] = 'cartography',
	['Chapter'] = {'chapter', 'contribution', 'entry', 'article', 'section'},
	['ChapterFormat'] = {'chapter-format', 'contribution-format', 'entry-format', 'article-format', 'section-format'};
	['ChapterURL'] = {'chapter-url', 'chapterurl', 'contribution-url', 'contributionurl', 'entry-url', 'article-url', 'section-url', 'sectionurl'},
	['ChapterUrlAccess'] = {'chapter-url-access', 'contribution-url-access', 'entry-url-access', 'article-url-access', 'section-url-access'},
	['Class'] = 'class',														-- cite arxiv and arxiv identifiers
	['Collaboration'] = 'collaboration',
	['Conference'] = {'conference', 'event'},
	['ConferenceFormat'] = {'conference-format', 'event-format'},
	['ConferenceURL'] = {'conference-url', 'conferenceurl', 'event-url', 'eventurl'},
	['Contribution'] = 'contribution',											-- introduction, foreword, afterword, etc; required when |contributor= set
	['Date'] = 'date',
	['Degree'] = 'degree',
	['DF'] = 'df',
	['DisplayAuthors'] = {'display-authors', 'displayauthors'},
	['DisplayContributors'] = 'display-contributors',
	['DisplayEditors'] = {'display-editors', 'displayeditors'},
	['DisplayInterviewers'] = 'display-interviewers',
	['DisplayTranslators'] = 'display-translators',
	['Docket'] = 'docket',
	['DoiBroken'] = {'doi-broken', 'doi-broken-date', 'doi-inactive-date'},
	['Edition'] = 'edition',
	['Editors'] = 'editors',
	['Embargo'] = 'embargo',
	['Encyclopedia'] = {'encyclopedia', 'encyclopaedia'},						-- this one only used by citation
	['Episode'] = 'episode',													-- cite serial only TODO: make available to cite episode?
	['Format'] = 'format',
	['ID'] = {'id', 'ID'},
	['IgnoreISBN'] = {'ignore-isbn-error', 'ignoreisbnerror'},
	['Inset'] = 'inset',
	['Issue'] = {'issue', 'number'},
	['Language'] = {'language', 'lang'},
	['LastAuthorAmp'] = {'last-author-amp', 'lastauthoramp'},
	['LayDate'] = {'lay-date', 'laydate'},
	['LayFormat'] = 'lay-format',
	['LaySource'] = {'lay-source', 'laysource'},
	['LayURL'] = {'lay-url', 'layurl'},
	['MailingList'] = {'mailinglist', 'mailing-list'},							-- cite mailing list only
	['Map'] = 'map',															-- cite map only
	['MapFormat'] = 'map-format',												-- cite map only
	['MapURL'] = {'mapurl', 'map-url'},											-- cite map only
	['MapUrlAccess'] = 'map-url-access',										-- cite map only
	['MessageID'] = 'message-id',
	['Minutes'] = 'minutes',
	['Mode'] = 'mode',
	['NameListFormat'] = 'name-list-format',
	['Network'] = 'network',
	['NoPP'] = {'no-pp', 'nopp'},
	['NoTracking'] = {'template-doc-demo', 'no-cat', 'nocat',
		'no-tracking', 'notracking'},
	['Number'] = 'number',														-- this case only for cite techreport
	['OrigYear'] = {'orig-year', 'origyear'},
	['Others'] = 'others',
	['Page'] = {'p', 'page'},
	['Pages'] = {'pp', 'pages'},
	['Periodical'] = {'journal', 'magazine', 'newspaper', 'periodical', 'website', 'work',
		'encyclopedia', 'encyclopaedia', 'dictionary', 'mailinglist'},			-- these masquerade as periodicals but aren't TODO: find a better way to handle these?
	['Place'] = {'place', 'location'},
	['PostScript'] = 'postscript',
	['PublicationDate'] = {'publicationdate', 'publication-date'},
	['PublicationPlace'] = {'publication-place', 'publicationplace'},
	['PublisherName'] = {'publisher', 'institution', 'newsgroup'},
	['Quote'] = {'quote', 'quotation'},
	['Ref'] = 'ref',
	['RegistrationRequired'] = 'registration',
	['Scale'] = 'scale',
	['ScriptChapter'] = {'script-chapter', 'script-contribution', 'script-entry', 'script-article', 'script-section'},
	['ScriptMap'] = 'script-map',
	['ScriptPeriodical'] = {'script-journal', 'script-magazine', 'script-newspaper', 'script-periodical', 'script-website', 'script-work'},
	['ScriptTitle'] = 'script-title',
	['Section'] = 'section',
	['Season'] = 'season',
	['Sections'] = 'sections',													-- cite map only
	['Series'] = {'series', 'version'},
	['SeriesSeparator'] = 'series-separator',
	['SeriesLink'] = {'series-link', 'serieslink'},
	['SeriesNumber'] = {'series-number', 'series-no', 'seriesnumber', 'seriesno'},
	['Sheet'] = 'sheet',														-- cite map only
	['Sheets'] = 'sheets',														-- cite map only
	['Station'] = 'station',
	['SubscriptionRequired'] = 'subscription',
	['Time'] = 'time',
	['TimeCaption'] = {'time-caption', 'timecaption'},
	['Title'] = 'title',
	['TitleLink'] = {'title-link', 'episode-link', 'titlelink', 'episodelink'},
	['TitleNote'] = 'department',
	['TitleType'] = {'type', 'medium'},
	['TransChapter'] = {'trans-article', 'trans-chapter', 'trans-contribution', 'trans-entry', 'trans-section'},
	['Transcript'] = 'transcript',
	['TranscriptFormat'] = 'transcript-format',
	['TranscriptURL'] = {'transcript-url', 'transcripturl'},
	['TransMap'] = 'trans-map',													-- cite map only
	['TransPeriodical'] = {'trans-journal', 'trans-magazine', 'trans-newspaper', 'trans-periodical', 'trans-website', 'trans-work'},
	['TransTitle'] = 'trans-title',
	['URL'] = {'url', 'URL'},
	['UrlAccess'] = {'url-access'},
	['UrlStatus'] = 'url-status',
	['Vauthors'] = 'vauthors',
	['Veditors'] = 'veditors',
	['Via'] = 'via',
	['Volume'] = 'volume',
	['Year'] = 'year',

	['AuthorList-First'] = {"first#", "given#", "author-first#", "author#-first"},
	['AuthorList-Last'] = {"last#", "author#", "surname#", "author-last#", "author#-last", "subject#", 'host#'},
	['AuthorList-Link'] = {"authorlink#", "author-link#", "author#-link", "subjectlink#", "author#link", "subject-link#", "subject#-link", "subject#link"},
	['AuthorList-Mask'] = {"author-mask#", "authormask#", "author#mask", "author#-mask"},
	
	['ContributorList-First'] = {'contributor-first#', 'contributor#-first', 'contributor-given#', 'contributor#-given'},
	['ContributorList-Last'] = {'contributor#', 'contributor-last#', 'contributor#-last', 'contributor-surname#', 'contributor#-surname'},
	['ContributorList-Link'] = {'contributor-link#', 'contributor#-link'},
	['ContributorList-Mask'] = {'contributor-mask#', 'contributor#-mask'},

	['EditorList-First'] = {"editor-first#", "editor#-first", "editor-given#", "editor#-given"},
	['EditorList-Last'] = {"editor#", "editor-last#", "editor#-last", "editor-surname#", "editor#-surname"},
	['EditorList-Link'] = {"editor-link#", "editor#-link", "editorlink#", "editor#link"},
	['EditorList-Mask'] = {"editor-mask#", "editor#-mask", "editormask#", "editor#mask"},
	
	['InterviewerList-First'] = {'interviewer-first#', 'interviewer#-first'},
	['InterviewerList-Last'] = {'interviewer#', 'interviewer-last#', 'interviewer#-last'},
	['InterviewerList-Link'] = {'interviewer-link#', 'interviewer#-link'},
	['InterviewerList-Mask'] = {'interviewer-mask#', 'interviewer#-mask'},

	['TranslatorList-First'] = {'translator-first#', 'translator#-first', 'translator-given#', 'translator#-given'},
	['TranslatorList-Last'] = {'translator#', 'translator-last#', 'translator#-last', 'translator-surname#', 'translator#-surname'},
	['TranslatorList-Link'] = {'translator-link#', 'translator#-link'},
	['TranslatorList-Mask'] = {'translator-mask#', 'translator#-mask'},
	}






--[[--------------------------< P U N C T _ S K I P >----------------------------------------------------------

builds a table of parameter names that the extraneous terminal punctuation check should not check.

]]

local punct_skip = {};

local meta_params = {															-- table of aliases[] keys (meta parameters); each key has a table of parameter names for a value
	'BookTitle', 'Chapter', 'ScriptChapter', 'ScriptTitle', 'Title', 'TransChapter', 'Transcript', 'TransMap',	'TransTitle',	-- title-holding parameters
	'PostScript', 'Quote',																				-- miscellaneous
	'ArchiveURL', 'ChapterURL', 'ConferenceURL', 'LayURL', 'MapURL', 'TranscriptURL', 'URL',			-- url-holding parameters
	}

	for _, meta_param in ipairs (meta_params) do								-- for each meta parameter key
		local params = aliases[meta_param];										-- get the parameter or the table of parameters associated with the meta parameter name
		if 'string' == type (params) then
			punct_skip[params] = 1;												-- just a single parameter
		else
			for _, param in ipairs (params) do									-- get the parameter name
				punct_skip[param] = 1;											-- add the parameter name to the skip table
			end
		end
	end


--[[--------------------------< S P E C I A L   C A S E   T R A N S L A T I O N S >----------------------------

This table is primarily here to support internationalization.  Translations in this table are used, for example,
when an error message, category name, etc is extracted from the English alias key.  There may be other cases where
this translation table may be useful.

]]

local special_case_translation = {
	['AuthorList'] = 'lista e autorëve',											-- these for multiple names maint categories
	['ContributorList'] = 'lista e kontribuesve',
	['EditorList'] = 'lista e redaktorëve',
	['InterviewerList'] = 'lista e intervistuesve',
	['TranslatorList'] = 'lista e përkthyesve',
	
	['authors'] = 'authors',													-- used in get_display_names()
	['contributors'] = 'contributors',
	['editors'] = 'editors',
	['interviewers'] = 'interviewers',
	['translators'] = 'translators',

	['archived_copy'] = '^archived?%s+copy$',									-- lua pattern to match pseudo title used by Internet Archive bot and others as place holder for unknown |title= value
																				-- used with CS1 maint: Archived copy as title
	}


--[[--------------------------< D E F A U L T S >--------------------------------------------------------------

Default parameter values

TODO: keep this?  Only one default?
]]

local defaults = {
	['UrlStatus'] = 'dead',
}


--[[--------------------------< D A T E _ N A M E S >----------------------------------------------------------

This table of tables lists local language date names and fallback English date names.  The code in Date_validation
will look first in the local table for valid date names.  If date names are not found in the local table, the code
will look in the English table.

Because citations can be copied to the local wiki from en.wiki, the English is required when the date-name translation
function date_name_xlate() is used.

In these tables, season numbering is defined by ISO DIS 8601:2016 part 2 §4.7 'Divisions of a year'.  The standard
defines various divisions using numbers 21-41.  cs1|2 only supports generic seasons.  ISO DIS 8601:2016 does support
the distinction between north and south hemispere seasons but cs1|2 has no way to make that distinction.

The standard does not address 'named' dates so, for the purposes of cs1|2, Christmas is defined here as 99, which
should be out of the ISO DIS 8601:2016 range of uses for a while.

]]

local date_names = {
	['en'] = {			-- English
		['long']	= {['January']=1, ['February']=2, ['March']=3, ['April']=4, ['May']=5, ['June']=6, ['July']=7, ['August']=8, ['September']=9, ['October']=10, ['November']=11, ['December']=12},
		['short']	= {['Jan']=1, ['Feb']=2, ['Mar']=3, ['Apr']=4, ['May']=5, ['Jun']=6, ['Jul']=7, ['Aug']=8, ['Sep']=9, ['Oct']=10, ['Nov']=11, ['Dec']=12},
		['season']	= {['Winter']=24, ['Spring']=21, ['Summer']=22, ['Fall']=23, ['Autumn']=23},
		['named']	= {['Christmas']=99},
		},
	['local'] = {		-- replace these English date names with the local language equivalents
		['long']	= {['janar']=1, ['shkurt']=2, ['mars']=3, ['prill']=4, ['maj']=5, ['qershor']=6, ['korrik']=7, ['gusht']=8, ['shtator']=9, ['tetor']=10, ['nëntor']=11, ['dhjetor']=12},
		['short']	= {['janar']=1, ['shkurt']=2, ['mars']=3, ['orill']=4, ['maj']=5, ['qeshor']=6, ['korrik']=7, ['gusht']=8, ['shtator']=9, ['tetor']=10, ['nëntor']=11, ['dhjetor']=12},
		['season']	= {['dimër']=24, ['pranverë']=21, ['verë']=22, ['vjeshtë']=23},
		['named']	= {['Krishtlindje']=99},
		},
	['inv_local_l'] = {},														-- used in date reformatting; copy of date_names['local'].long where k/v are inverted: [1]='<local name>' etc
	['inv_local_s'] = {},														-- used in date reformatting; copy of date_names['local'].short where k/v are inverted: [1]='<local name>' etc
	['local_digits'] = {['0'] = '0', ['1'] = '1', ['2'] = '2', ['3'] = '3', ['4'] = '4', ['5'] = '5', ['6'] = '6', ['7'] = '7', ['8'] = '8', ['9'] = '9'},	-- used to convert local language digits to Western 0-9
	['xlate_digits'] = {},
	}

for name, i in pairs (date_names['local'].long) do								-- this table is ['name'] = i
	date_names['inv_local_l'][i] = name;										-- invert to get [i] = 'name' for conversions from ymd
end

for name, i in pairs (date_names['local'].short) do								-- this table is ['name'] = i
	date_names['inv_local_s'][i] = name;										-- invert to get [i] = 'name' for conversions from ymd
end

for ld, ed in pairs (date_names.local_digits) do								-- make a digit translation table for simple date translation from en to local language using local_digits table
	date_names.xlate_digits [ed] = ld;											-- en digit becomes index with local digit as the value
end

local df_template_patterns = {													-- table of redirects to {{Use dmy dates}} and {{Use mdy dates}}
	'{{ *[Uu]se (dmy) dates *[|}]',		-- 915k									-- sorted by approximate transclusion count
	'{{ *[Uu]se *(mdy) *dates *[|}]',	-- 161k
	'{{ *[Uu]se (DMY) dates *[|}]',		-- 2929
	'{{ *[Uu]se *(dmy) *[|}]',			-- 250 + 34
	'{{ *([Dd]my) *[|}]',				-- 272
	'{{ *[Uu]se (MDY) dates *[|}]',		-- 173
	'{{ *[Uu]se *(mdy) *[|}]',			-- 59 + 12
	'{{ *([Mm]dy) *[|}]',				-- 9
	'{{ *[Uu]se (MDY) *[|}]',			-- 3
	'{{ *([Dd]MY) *[|}]',				-- 2
	'{{ *([Mm]DY) *[|}]',				-- 0
--	'{{ *[Uu]se(mdy) *[|}]',
--	'{{ *[Uu]se(mdy)dates *[|}]',
--	'{{ *[Uu]se(dmy) *[|}]',
	}

local function get_date_format ()
	local content = mw.title.getCurrentTitle():getContent() or '';				-- get the content of the article or ''; new pages edited w/ve do not have 'content' until saved; ve does not preview; phab:T221625
	for _, pattern in ipairs (df_template_patterns) do							-- loop through the patterns looking for {{Use dmy dates}} or {{Use mdy dates}} or any of their redirects
		local start, _, match = content:find(pattern);							-- match is the three letters indicating desired date format
		if match then
			content = content:match ('%b{}', start);							-- get the whole template
			if content:match ('| *cs1%-dates *= *[lsy][sy]?') then				-- look for |cs1-dates=publication date length access-/archive-date length
				return match:lower() .. '-' .. content:match ('| *cs1%-dates *= *([lsy][sy]?)');
			else
				return match:lower() .. '-all';									-- no |cs1-dates= k/v pair; return value appropriate for use in |df=
			end
		end
	end
end

local global_df = get_date_format ();



--[[--------------------------< V O L U M E ,  I S S U E ,  P A G E S >----------------------------------------

These tables hold cite class values (from the template invocation) and identify those templates that support
|volume=, |issue=, and |page(s)= parameters.  Cite conference and cite map require further qualification which
is handled in the main module.

]]

local templates_using_volume = {'citation', 'audio-visual', 'book', 'conference', 'encyclopaedia', 'interview', 'journal', 'magazine', 'map', 'news', 'report', 'techreport', 'thesis'}
local templates_using_issue = {'citation', 'conference', 'episode', 'interview', 'journal', 'magazine', 'map', 'news', 'podcast'}
local templates_not_using_page = {'audio-visual', 'episode', 'mailinglist', 'newsgroup', 'podcast', 'serial', 'sign', 'speech'}


--[[--------------------------< K E Y W O R D S >--------------------------------------------------------------

These tables hold keywords for those parameters that have defined sets of acceptible keywords.

]]

--[[--------------------------< M A K E _ K E Y W O R D S _ L I S T >------------------------------------------

this function assembles, for parameter-value validation, the list of keywords appropriate to that parameter.

keywords_lists{}, is a table of tables from keywords{}

]]

local function make_keywords_list (keywords_lists)
	local out_table = {};														-- output goes here
	
	for _, keyword_list in ipairs (keywords_lists) do							-- spin through keywords_lists{} and get a table of keywords
		for _, keyword in ipairs (keyword_list) do								-- spin through keyword_list{} and add each keyword, ...
			table.insert (out_table, keyword);									-- ... as plain text, to the output list
		end
	end
	return out_table;
end


--[[--------------------------< K E Y W O R D S   T A B L E >--------------------------------------------------

this is a list of keywords; each key in the list is associated with a table of synonymous keywords possibly from
different languages.

for i18n: add local-language keywords to value table; do not change the key.  For example, adding the German keyword 'ja':
	['affirmative'] = {'yes', 'true', 'y', 'ja'},

Because cs1|2 templates from en.wiki articles are often copied to other local wikis, it is recommended that the English
keywords remain in these tables.

]]

local keywords = {
	['affirmative'] = {'yes', 'true', 'y'},										-- ignore-isbn-error, last-author-amp, no-tracking, nopp, registration, subscription
	['afterword'] = {'afterword'},												-- contribution
	['bot: unknown'] = {'bot: unknown'},										-- url-status
	['cs1'] = {'cs1'},															-- mode
	['cs2'] = {'cs2'},															-- mode
	['dead'] = {'dead', 'mort'},												-- url-status	-- TODO: remove 'mort' fr for dead or death
	['dmy'] = {'dmy'},															-- df
	['dmy-all'] = {'dmy-all'},													-- df
	['foreword'] = {'foreword'},												-- contribution
	['free'] = {'free', 'frei'},												-- url-access	-- TODO: remove 'frei' de for free
	['introduction'] = {'introduction'},										-- contribution
	['limited'] = {'limited'},													-- url-access
	['live'] = {'live', 'vivre'},												-- url-status	-- TODO: remove 'vivre' fr for live?
	['mdy'] = {'mdy'},															-- df
	['mdy-all'] = {'mdy-all'},													-- df
	['preface'] = {'preface'},													-- contribution
	['registration'] = {'registration'},										-- url-access
	['subscription'] = {'subscription'},										-- url-access
	['unfit'] = {'unfit', 'inapte'},											-- url-status	-- TODO: remove 'inapte' fr for unfit?
	['usurped'] = {'usurped', 'usurpé'},										-- url-status	-- TODO: remove 'usurpé' fr for usurped?
	['vanc'] = {'vanc'},														-- name-list-format
	['ymd'] = {'ymd'},															-- df
	['ymd-all'] = {'ymd-all'},													-- df
--	['yMd'] = {'yMd'},															-- df; not supported at en.wiki
--	['yMd-all'] = {'yMd-all'},													-- df; not supported at en.wiki
	}


--[[--------------------------< X L A T E _ K E Y W O R D S >--------------------------------------------------

this function builds a list, keywords_xlate{}, of the keywords found in keywords{} where the values from keywords{}
become the keys in keywords_xlate{} and the keys from keywords{} become the values in keywords_xlate{}:
	['affirmative'] = {'yes', 'true', 'y'},		-- in keywords{}
becomes
	['yes'] = 'affirmative',					-- in keywords_xlate{}
	['true'] = 'affirmative',
	['y'] = 'affirmative',

the purpose of this function is to act as a translator between a non-English keyword and its English equivalent
that may be used in other modules of this suite

]]

local function xlate_keywords ()
	local out_table = {};														-- output goes here
	for k, keywords_t in pairs (keywords) do									-- spin through the keywords table
		for _, keyword in ipairs (keywords_t) do								-- for each keyword
			out_table[keyword] = k;												-- create an entry in the output table where keyword is the key
		end
	end
	
	return out_table;
end

local keywords_xlate = xlate_keywords ();										-- the list of translated keywords


--[[--------------------------< K E Y W O R D S _ L I S T S >--------------------------------------------------

this is a list of lists of valid keywords for the various parameters in [key].  Generally the keys in this table
are the canonical en.wiki parameter names though some are contrived because of use in multiple differently named
parameters: ['yes_true_y'], ['id-access'].

The function make_keywords_list() extracts the individual keywords from the appropriate list in keywords{}.

The lists in this table are used to validate the keyword assignment for the parameters named in this table's keys.

]]

local keywords_lists = {
	['yes_true_y'] = make_keywords_list ({keywords.affirmative}),
	['contribution'] = make_keywords_list ({keywords.afterword, keywords.foreword, keywords.introduction, keywords.preface}),
	['df'] = make_keywords_list ({keywords.dmy, keywords['dmy-all'], keywords.mdy, keywords['mdy-all'], keywords.ymd, keywords['ymd-all']}),
--	['df'] = make_keywords_list ({keywords.dmy, keywords['dmy-all'], keywords.mdy, keywords['mdy-all'], keywords.ymd, keywords['ymd-all'], keywords.yMd, keywords['yMd-all']}),	-- not supported at en.wiki
	['mode'] = make_keywords_list ({keywords.cs1, keywords.cs2}),
	['name-list-format'] = make_keywords_list ({keywords.vanc}),
	['url-access'] = make_keywords_list ({keywords.subscription, keywords.limited, keywords.registration}),
	['url-status'] = make_keywords_list ({keywords.dead, keywords.live, keywords.unfit, keywords.usurped, keywords['bot: unknown']}),
	['id-access'] = make_keywords_list ({keywords.free}),
	}


--[[--------------------------< S T R I P M A R K E R S >------------------------------------------------------

Common pattern definition location for stripmarkers so that we don't have to go hunting for them if (when)
MediaWiki changes their form.

]]

local stripmarkers = {
	['any'] = '\127[^\127]*UNIQ%-%-(%a+)%-[%a%d]+%-QINU[^\127]*\127',			-- capture returns name of stripmarker
	['math'] = '\127[^\127]*UNIQ%-%-math%-[%a%d]+%-QINU[^\127]*\127'			-- math stripmarkers used in coins_cleanup() and coins_replace_math_stripmarker()
	}


--[[--------------------------< I N V I S I B L E _ C H A R A C T E R S >--------------------------------------

This table holds non-printing or invisible characters indexed either by name or by Unicode group. Values are decimal
representations of UTF-8 codes.  The table is organized as a table of tables because the lua pairs keyword returns
table data in an arbitrary order.  Here, we want to process the table from top to bottom because the entries at
the top of the table are also found in the ranges specified by the entries at the bottom of the table.

Also here is a pattern that recognizes stripmarkers that begin and end with the delete characters.  The nowiki
stripmarker is not an error but some others are because the parameter values that include them become part of the
template's metadata before stripmarker replacement.

]]

local invisible_chars = {
	{'replacement', '\239\191\189'},											-- U+FFFD, EF BF BD
	{'zero width joiner', '\226\128\141'},										-- U+200D, E2 80 8D
	{'zero width space', '\226\128\139'},										-- U+200B, E2 80 8B
	{'hair space', '\226\128\138'},												-- U+200A, E2 80 8A
	{'soft hyphen', '\194\173'},												-- U+00AD, C2 AD
	{'horizontal tab', '\009'},													-- U+0009 (HT), 09
	{'line feed', '\010'},														-- U+000A (LF), 0A
	{'carriage return', '\013'},												-- U+000D (CR), 0D
	{'stripmarker', stripmarkers.any},											-- stripmarker; may or may not be an error; capture returns the stripmaker type
	{'delete', '\127'},															-- U+007F (DEL), 7F; must be done after stripmarker test
	{'C0 control', '[\000-\008\011\012\014-\031]'},								-- U+0000–U+001F (NULL–US), 00–1F (except HT, LF, CR (09, 0A, 0D))
	{'C1 control', '[\194\128-\194\159]'},										-- U+0080–U+009F (XXX–APC), C2 80 – C2 9F
--	{'Specials', '[\239\191\185-\239\191\191]'},								-- U+FFF9-U+FFFF, EF BF B9 – EF BF BF
--	{'Private use area', '[\238\128\128-\239\163\191]'},						-- U+E000–U+F8FF, EE 80 80 – EF A3 BF
--	{'Supplementary Private Use Area-A', '[\243\176\128\128-\243\191\191\189]'},	-- U+F0000–U+FFFFD, F3 B0 80 80 – F3 BF BF BD
--	{'Supplementary Private Use Area-B', '[\244\128\128\128-\244\143\191\189]'},	-- U+100000–U+10FFFD, F4 80 80 80 – F4 8F BF BD
	}

--[[
Indic script makes use of zero width joiner as a character modifier so zwj characters must be left in.  This
pattern covers all of the unicode characters for these languages:
	Devanagari					0900–097F – https://unicode.org/charts/PDF/U0900.pdf
		Devanagari extended		A8E0–A8FF – https://unicode.org/charts/PDF/UA8E0.pdf
	Bengali						0980–09FF – https://unicode.org/charts/PDF/U0980.pdf
	Gurmukhi					0A00–0A7F – https://unicode.org/charts/PDF/U0A00.pdf
	Gujarati					0A80–0AFF – https://unicode.org/charts/PDF/U0A80.pdf
	Oriya						0B00–0B7F – https://unicode.org/charts/PDF/U0B00.pdf
	Tamil						0B80–0BFF – https://unicode.org/charts/PDF/U0B80.pdf
	Telugu						0C00–0C7F – https://unicode.org/charts/PDF/U0C00.pdf
	Kannada						0C80–0CFF – https://unicode.org/charts/PDF/U0C80.pdf
	Malayalam					0D00–0D7F – https://unicode.org/charts/PDF/U0D00.pdf
plus the not-necessarily Indic scripts for Sinhala and Burmese:
	Sinhala						0D80-0DFF - https://unicode.org/charts/PDF/U0D80.pdf
	Myanmar						1000-109F - https://unicode.org/charts/PDF/U1000.pdf
		Myanmar extended A		AA60-AA7F - https://unicode.org/charts/PDF/UAA60.pdf
		Myanmar extended B		A9E0-A9FF - https://unicode.org/charts/PDF/UA9E0.pdf
the pattern is used by has_invisible_chars() and coins_cleanup()
TODO: find a better place for this?
]]

local indic_script = '[\224\164\128-\224\181\191\224\163\160-\224\183\191\225\128\128-\225\130\159\234\167\160-\234\167\191\234\169\160-\234\169\191]';




--[[--------------------------< L A N G U A G E   S U P P O R T >----------------------------------------------

These tables and constants support various language-specific functionality.

]]

local this_wiki_code = mw.getContentLanguage():getCode()						-- get this wiki's language code

local local_lang_cat_enable = true;											-- set to true to categorize cs1|2 templates where |language=<local wiki's language>


--[[--------------------------< S C R I P T _ L A N G _ C O D E S >--------------------------------------------

This table is used to hold ISO 639-1 two-character language codes that apply only to |script-title= and |script-chapter=

]]

local script_lang_codes = {
	'am', 'ar', 'be', 'bg', 'bn', 'bs', 'dv', 'el', 'fa', 'gu',					-- ISO 639-1 codes only for |script-title= and |script-chapter=
	'he', 'hi', 'hy', 'ja', 'ka', 'kk', 'km', 'kn', 'ko', 'ku',
	'mk', 'ml', 'mn', 'mr', 'my', 'ne', 'ps', 'ru', 'sd', 'si',
	'sr', 'ta', 'tg', 'th', 'ug', 'uk', 'ur', 'uz', 'yi', 'zh'
	};


--[[--------------------------< L A N G U A G E   R E M A P P I N G >------------------------------------------

These tables hold language information that is different (correct) from MediaWiki's definitions

]]

local lang_code_remap = {														-- used for |language= and |script-title= / |script-chapter=
	['als'] = 'Tosk Albanian',													-- MediaWiki returns Alemannisch 
	['bh'] = 'Bihari',															-- MediaWiki uses 'bh' as a subdomain name for Bhojpuri wWikipedia: bh.wikipedia.org
	['bn'] = 'Bengali',															-- MediaWiki returns Bangla
	['ca-valencia'] = 'Valencian',												-- IETF variant of Catalan
	['crh'] = 'Crimean Tatar',													-- synonymous with Crimean Turkish (return value from {{#language:crh|en}})
	}

local lang_name_remap = {														-- used for |language=
	['alemannisch'] = {'Swiss German', 'gsw'},									-- not an ISO or IANA language name; MediaWiki uses 'als' as a subdomain name for Alemannic Wikipedia: als.wikipedia.org
	['bangla'] = {'Bengali', 'bn'},												-- MediaWiki returns Bangla (the endonym) but we want Bengali (the exonym); here we remap
	['bengali'] = {'Bengali', 'bn'},											-- MediaWiki doesn't use exonym so here we provide correct language name and 639-1 code
	['bihari'] = {'Bihari', 'bh'},												-- MediaWiki replaces 'Bihari' with 'Bhojpuri' so 'Bihari' cannot be found
	['bhojpuri'] = {'Bhojpuri', 'bho'},											-- MediaWiki uses 'bh' as a subdomain name for Bhojpuri Wikipedia: bh.wikipedia.org
	['crimean tatar'] = {'Crimean Tatar', 'crh'},								-- MediaWiki uses 'crh' as a subdomain name for Crimean Tatar Wikipedia: crh.wikipedia.org
	['tosk albanian'] = {'Tosk Albanian', 'als'},								-- MediaWiki replaces 'Tosk Albanian' with 'Alemannisch' so 'Tosk Albanian' cannot be found
	['valencian'] = {'Valencian', 'ca'},										-- variant of Catalan; categorizes as Catalan
	}

--[[--------------------------< M A I N T E N A N C E _ C A T E G O R I E S >----------------------------------

Here we name maintenance categories to be used in maintenance messages.

]]

local maint_cats = {
	['ASIN'] = 'Mirëmbajtja CS1: ASIN përdor ISBN',
	['archived_copy'] = 'Mirëmbajtja CS1: Archived copy si titull',
	['authors'] = 'Mirëmbajtja CS1: Është përdorur parametri i autorëve',
	['bot:_unknown'] = 'Mirëmbajtja CS1: BOT: Gjendja e adresës origjinale është e panjohur',
	['date_format'] = 'Mirëmbajtja CS1: Formati i datës',
		['date_year'] = 'Mirëmbajtja CS1: Data dhe viti',
	['disp_name'] = 'Mirëmbajtja CS1: display-$1',									-- $1 is authors, contributors, editors, interviewers, translators; gets value from special_case_translation table
	['editors'] = 'Mirëmbajtja CS1: Është përdorur parametri i redaktorëve',
	['embargo'] = 'Mirëmbajtja CS1: Embargo PMC ka skaduar',
	['extra_punct'] = 'Mirëmbajtja CS1: Pikësim shtesë',
	['extra_text'] = 'Mirëmbajtja CS1: Tekst shtesë',
	['extra_text_names'] = 'Mirëmbajtja CS1: Tekst shtesë: $1',							-- $1 is <name>s list; gets value from special_case_translation table
	['ignore_isbn_err'] = 'Mirëmbajtja CS1: Gabime ISBN të injoruara',
	['mult_names'] = 'Mirëmbajtja CS1: Emra të shumëfishtë: $1',							-- $1 is <name>s list; gets value from special_case_translation table
	['others'] = 'Mirëmbajtja CS1: Është përdorur gabimisht parametri i të tjerëve',
	['pmc_format'] = 'Mirëmbajtja CS1: Formati PMC',
	['unfit'] = 'Mirëmbajtja CS1: Adresë e papërshtatshme',
	['unknown_lang'] = 'Mirëmbajtja CS1: Gjuhë e panjohur',
	['untitled'] = 'Mirëmbajtja CS1: Botim periodik i patitulluar',
	['zbl'] = 'Mirëmbajtja CS1: ZBL',
	}


--[[--------------------------< P R O P E R T I E S _ C A T E G O R I E S >------------------------------------

Here we name properties categories

]]

local prop_cats = {
	['foreign_lang_source'] = 'Faqe me burime në $1 ($2)',					-- |language= categories; $1 is language name, $2 is ISO639-1 code
	['foreign_lang_source_2'] = 'Faqe me burime në $1',	-- |language= category; a cat for ISO639-2 languages; $1 is the ISO 639-2 code used as a sort key
	['local_lang_source'] = 'Faqe me burime në $1 ($2)',						-- |language= categories; $1 is local-language name, $2 is ISO639-1 code; not emitted when local_lang_cat_enable is false
	['script'] = 'Vetitë CS1: Është përdorur kod në gjuhë të huaj',							-- when language specified by |script-title=xx: doesn't have its own category
	['script_with_name'] = 'Vetitë CS1: Është përdorur kod në $1($2)',					-- |script-title=xx: has matching category; $1 is language name, $2 is ISO639-1 code
	['jul_greg_uncertainty'] = 'Vetitë CS1: Paqartësi Julian-Gregoriane',				-- probably temporary cat to identify scope of template with dates 1 October 1582 – 1 January 1926
	['long_vol'] = 'Vetitë CS1: Vlerë e madhe vëllimi',									-- probably temporary cat to identify scope of |volume= values longer than 4 charachters
	}


--[[--------------------------< T I T L E _ T Y P E S >--------------------------------------------------------

Here we map a template's CitationClass to TitleType (default values for |type= parameter)

]]

local title_types = {
	['AV-media-notes'] = 'Shënimet mediatike',
	['interview'] = 'Intervistë',
	['mailinglist'] = 'Listë abonentësh',
	['map'] = 'Hartë',
	['podcast'] = 'Podkast',
	['pressrelease'] = 'Njoftim shtypi',
	['report'] = 'Reportazh',
	['techreport'] = 'Raport teknik',
	['thesis'] = 'Tezë',
	}


--[[--------------------------< E R R O R _ C O N D I T I O N S >----------------------------------------------

Error condition table

The following contains a list of IDs for various error conditions defined in the code.  For each ID, we specify a
text message to display, an error category to include, and whether the error message should be wrapped as a hidden comment.

Anchor changes require identical changes to matching anchor in Help:CS1 errors

]]

local error_conditions = {
	accessdate_missing_url = {
		message = '<code class="cs1-code">&#124;access-date=</code> ka nevojë për <code class="cs1-code">&#124;url=</code>',
		anchor = 'accessdate_missing_url',
		category = 'Faqe që përdorin datë aksesimi pa parametër adrese',
		hidden = false
 		},
	apostrophe_markup = {
		message = 'Nuk lejohet formatim teksti në: <code class="cs1-code">&#124;$1=</code>',
		anchor = 'apostrophe_markup',
		category = 'Gabime CS1: Formatimi',
		hidden = false
 		},
	archive_missing_date = {
		message = '<code class="cs1-code">&#124;archive-url=</code> ka nevojë për <code class="cs1-code">&#124;archive-date=</code>',
		anchor = 'archive_missing_date',
		category = 'Faqe me gabime citimesh te adresa e arkivimit',
		hidden = false
		},
	archive_missing_url = {
		message = '<code class="cs1-code">&#124;archive-url=</code> ka nevojë për <code class="cs1-code">&#124;url=</code>',
		anchor = 'archive_missing_url',
		category = 'Faqe me gabime citimesh te adresa e arkivimit',
		hidden = false
		},
	archive_url = {
		message = '<code class="cs1-code">&#124;archive-url=</code> është i keqformuar: $1',
		anchor = 'archive_url',
		category = 'Faqe me gabime citimesh te adresa e arkivimit',
		hidden = false
		},
	arxiv_missing = {
		message = 'Kërkohet <code class="cs1-code">&#124;arxiv=</code>',
		anchor = 'arxiv_missing',
		category = 'Gabime CS1: arXiv',											-- same as bad arxiv
		hidden = false
		},
	arxiv_params_not_supported = {
		message = 'Parametra të palejuar te burimi',
		anchor = 'arxiv_params_not_supported',
		category = 'Gabime CS1: arXiv',											-- same as bad arxiv
		hidden = false
		},
	bad_arxiv = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;arxiv=</code>',
		anchor = 'bad_arxiv',
		category = 'Gabime CS1: arXiv',
		hidden = false
		},
	bad_asin = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;asin=</code>',
		anchor = 'bad_asin',
		category ='Gabime CS1: ASIN',
		hidden = false
		},
	bad_bibcode = {
		message = 'Shiko <code class="cs1-code">&#124;bibcode=</code> $1',
		anchor = 'bad_bibcode',
		category = 'Gabime CS1: bibcode',
		hidden = false
		},
	bad_biorxiv = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;biorxiv=</code>',
		anchor = 'bad_biorxiv',
		category = 'Gabime CS1: bioRxiv',
		hidden = false
		},
	bad_citeseerx = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;citeseerx=</code>',
		anchor = 'bad_citeseerx',
		category = 'Gabime CS1: citeseerx',
		hidden = false
		},
	bad_date = {
		message = 'Shiko vlerat e datave në: <code class="cs1-code">$1</code>',
		anchor = 'bad_date',
		category = 'Gabime CS1: Datat',
		hidden = false
		},
	bad_doi = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;doi=</code>',
		anchor = 'bad_doi',
		category = 'Gabime CS1: DOI',
		hidden = false
		},
	bad_hdl = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;hdl=</code>',
		anchor = 'bad_hdl',
		category = 'Gabime CS1: HDL',
		hidden = false
		},
	bad_isbn = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;isbn=</code>: $1',
		anchor = 'bad_isbn',
		category = 'Gabime CS1: ISBN',
		hidden = false
		},
	bad_ismn = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;ismn=</code>',
		anchor = 'bad_ismn',
		category = 'Gabime CS1: ISMN',
		hidden = false
		},
	bad_issn = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;$1issn=</code>',
		anchor = 'bad_issn',
		category = 'Gabime CS1: ISSN',
		hidden = false
		},
	bad_jfm = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;jfm=</code>',
		anchor = 'bad_jfm',
		category = 'Gabime CS1: JFM',
		hidden = false
		},
	bad_lccn = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;lccn=</code>',
		anchor = 'bad_lccn',
		category = 'Gabime CS1: LCCN',
		hidden = false
		},
	bad_usenet_id = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;message-id=</code>',
		anchor = 'bad_message_id',
		category = 'Gabime CS1: message-id',
		hidden = false
		},
	bad_mr = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;mr=</code>',
		anchor = 'bad_mr',
		category = 'Gabime CS1: MR',
		hidden = false
		},
	bad_ol = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;ol=</code>',
		anchor = 'bad_ol',
		category = 'Gabime CS1: OL',
		hidden = false
		},
	bad_paramlink = {															-- for |title-link=, |author/editor/translator-link=, |series-link=, |episode-link=
		message = 'Shiko vlerën e <code class="cs1-code">&#124;$1=</code>',
		anchor = 'bad_paramlink',
		category = 'Gabime CS1: parametri i lidhjes',
		hidden = false
		},
	bad_pmc = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;pmc=</code>',
		anchor = 'bad_pmc',
		category = 'Gabime CS1: PMC',
		hidden = false
		},
	bad_pmid = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;pmid=</code>',
		anchor = 'bad_pmid',
		category = 'Gabime CS1: PMID',
		hidden = false
		},
	bad_oclc = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;oclc=</code>',
		anchor = 'bad_oclc',
		category = 'Gabime CS1: OCLC',
		hidden = false
		},
	bad_ssrn = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;ssrn=</code>',
		anchor = 'bad_ssrn',
		category = 'Gabime CS1: SSRN',
		hidden = false
		},
	bad_url = {
		message = 'Shiko vlerën e $1',
		anchor = 'bad_url',
		category = 'Faqe me gabime në adresë',
		hidden = false
		},
	bad_zbl = {
		message = 'Shiko vlerën e <code class="cs1-code">&#124;zbl=</code>',
		anchor = 'bad_zbl',
		category = 'Gabime CS1: ZBL',
		hidden = false
		},
	bare_url_missing_title = {
		message = '$1 i mungon titulli',
		anchor = 'bare_url_missing_title',
		category = 'Faqe me burime që përmbajnë adresa të zhveshura',
		hidden = false
		},
	biorxiv_missing = {
		message = 'Kërkohet<code class="cs1-code">&#124;biorxiv=</code>',
		anchor = 'biorxiv_missing',
		category = 'Gabime CS1: bioRxiv',										-- same as bad bioRxiv
		hidden = false
		},
	chapter_ignored = {
		message = 'Është injoruar <code class="cs1-code">&#124;$1=</code>',
		anchor = 'chapter_ignored',
		category = 'Gabime CS1: Janë injoruar kapitujt',
		hidden = false
		},
	citation_missing_title = {
		message = 'Mungon ose është bosh <code class="cs1-code">&#124;$1=</code>',
		anchor = 'citation_missing_title',
		category = 'Faqe me burime pa tituj',
		hidden = false
		},
	citeseerx_missing = {
		message = 'Kërkohet <code class="cs1-code">&#124;citeseerx=</code>',
		anchor = 'citeseerx_missing',
		category = 'Gabime CS1: citeseerx',										-- same as bad citeseerx
		hidden = false
		},
	cite_web_url = {															-- this error applies to cite web and to cite podcast
		message = 'Mungon ose është bosh <code class="cs1-code">&#124;url=</code>',
		anchor = 'cite_web_url',
		category = 'Faqe me burime interneti pa adresë',
		hidden = false
		},
	class_ignored = {
		message = 'Është injoruar <code class="cs1-code">&#124;class=</code>',
		anchor = 'class_ignored',
		category = 'Gabime CS1: klasa',
		hidden = false
		},
	contributor_ignored = {
		message = '<code class="cs1-code">&#124;contributor=</code> është injoruar',
		anchor = 'contributor_ignored',
		category = 'Gabime CS1: kontribuesi',
		hidden = false
		},
	contributor_missing_required_param = {
		message = '<code class="cs1-code">&#124;contributor=</code> ka nevojë për <code class="cs1-code">&#124;$1=</code>',
		anchor = 'contributor_missing_required_param',
		category = 'Gabime CS1: kontribuesi',
		hidden = false
		},
	deprecated_params = {
		message = 'Burimi përdor parametër të vjetëruar <code class="cs1-code">&#124;$1=</code>',
		anchor = 'deprecated_params',
		category = 'Gabime CS1: Parametra të vjetëruar',
		hidden = true
		},
	doibroken_missing_doi = {
		message = '<code class="cs1-code">&#124;$1=</code> ka nevojë për <code class="cs1-code">&#124;doi=</code>',
		anchor = 'doibroken_missing_doi',
		category = 'Gabime CS1: DOI',
		hidden = false
		},
	empty_citation = {
		message = 'Burim bosh',
		anchor = 'empty_citation',
		category = 'Faqe me burime bosh',
		hidden = false
		},
	etal = {
		message = 'Përdorim i gabuar i et al. në: <code class="cs1-code">&#124;$1=</code>',
		anchor = 'explicit_et_al',
		category = 'Gabime CS1: Përdorim i gabuar i et al.',
		hidden = false
		},
	first_missing_last = {
		message = '<code class="cs1-code">&#124;$1=</code> i mungon <code class="cs1-code">&#124;$2=</code>',	-- $1 is first alias, $2 is matching last alias
		anchor = 'first_missing_last',
		category = 'Gabime CS1: Mungon autori ose redaktori',									-- author, contributor, editor, interviewer, translator
		hidden = false
		},
	format_missing_url = {
		message = '<code class="cs1-code">&#124;$1=</code> ka nevojë për <code class="cs1-code">&#124;$2=</code>',
		anchor = 'format_missing_url',
		category = 'Faqe që përdorin burime me format dhe pa adresë',
		hidden = false
		},
	invalid_param_val = {
		message = '<code class="cs1-code">&#124;$1=$2</code> i pavlefshëm',
		anchor = 'invalid_param_val',
		category = 'Gabime CS1: Vlerë e palejuar parametri',
		hidden = false
		},
	invisible_char = {
		message = '$1 është te $2 në vend të $3',
		anchor = 'invisible_char',
		category = 'Gabime CS1: simbol i padukshëm',
		hidden = false
		},
	missing_name = {
		message = 'Mungon <code class="cs1-code">&#124;$1$2=</code>',			-- $1 is modified NameList; $2 is enumerator
		anchor = 'missing_name',
		category = 'Gabime CS1: Mungon autori ose redaktori',									-- author, contributor, editor, interviewer, translator
		hidden = false
		},
	missing_periodical = {
		message = 'Burimi $1 ka nevojë për <code class="cs1-code">&#124;$2=</code>',	-- $1 is cs1 template name; $2 is canonical periodical parameter name for cite $1
		anchor = 'missing_periodical',
		category = 'Gabime CS1: Mungon botimi periodik',
		hidden = true
		},
	missing_pipe = {
		message = 'Mungon vija ndarëse te: <code class="cs1-code">&#124;$1=</code>',
		anchor = 'missing_pipe',
		category = 'Gabime CS1: Mungon vija ndarëse',
		hidden = false
		},
	param_access_requires_param = {
		message = '<code class="cs1-code">&#124;$1-access=</code> ka nevojë për <code class="cs1-code">&#124;$1=</code>',
		anchor = 'param_access_requires_param',
		category = 'Gabime CS1: parametri i aksesimit',
		hidden = false
		},
	param_has_ext_link = {
		message = 'Lidhje e jashtme në <code class="cs1-code">$1</code>',
		anchor = 'param_has_ext_link',
		category = 'Gabime CS1: Lidhjet e jashtme',
		hidden = false
		},
	parameter_ignored = {
		message = 'Një parametër i panjohur <code class="cs1-code">&#124;$1=</code> është injoruar',
		anchor = 'parameter_ignored',
		category = 'Faqe me burime që përmbajnë parametra të palejuar',
		hidden = false
		},
	parameter_ignored_suggest = {
		message = 'Një parametër i panjohur <code class="cs1-code">&#124;$1=</code> është injoruar (<code class="cs1-code">&#124;$2=</code> suggested)',
		anchor = 'parameter_ignored_suggest',
		category = 'Faqe me burime që përmbajnë parametra të palejuar',
		hidden = false
		},
	redundant_parameters = {
		message = '$1 është specifikuar më shumë se një herë',
		anchor = 'redundant_parameters',
		category = 'Faqe me burime që përmbajnë parametra të tepërt',
		hidden = false
		},
	script_parameter = {
		message = 'Problem me <code class="cs1-code">&#124;$1=</code>: $2',
		anchor = 'script_parameter',
		category = 'Gabime CS1: parametrat script',
		hidden = false
		},
	text_ignored = {
		message = 'Është injoruar "$1"',
		anchor = 'text_ignored',
		category = 'Faqe me burime që përmbajnë parametra të pa emëruar',
		hidden = false
		},
	trans_missing_title = {
		message = '<code class="cs1-code">&#124;trans-$1=</code> ka nevojë për <code class="cs1-code">&#124;$1=</code>',
		anchor = 'trans_missing_title',
		category = 'Gabime CS1: titull i përkthyer',
		hidden = false
		},
	vancouver = {
		message = 'Gabim i stilit Vankuver: $1',
		anchor = 'vancouver',
		category = 'Gabime CS1: Stili Vankuver',
		hidden = false
		},
	wikilink_in_url = {
		message = 'konflikt URL-wikilink',										-- uses ndash
		anchor = 'wikilink_in_url',
		category = 'Gabime CS1: Konflikt URL-wikilink',							-- uses ndash
		hidden = false
		},
	language_missing = {
		message = 'Mungon ose është bosh parametri <code class="cs1-code">&#124;language=</code>',
		anchor = 'language_missing',
		category = 'Gabime CS1: Mungon parametri i gjuhës',
		hidden = false
		},
	}


--[[--------------------------< I D _ H A N D L E R S >--------------------------------------------------------

The following contains a list of values for various defined identifiers.  For each identifier we specify a
variety of information necessary to properly render the identifier in the citation.

	parameters: a list of parameter aliases for this identifier
	link: Wikipedia article name
	q: wikidata q number for the identifier
	label: the alternate name to apply to link
	mode: 	'manual' when there is a specific function in the code to handle the identifier;
			'external' for identifiers that link outside of Wikipedia;
	prefix: the first part of a url that will be concatenated with a second part which usually contains the identifier
	encode: true if uri should be percent encoded; otherwise false
	COinS: identifier link or keyword for use in COinS:
		for identifiers registered at info-uri.info use: info:....
		for identifiers that have COinS keywords, use the keyword: rft.isbn, rft.issn, rft.eissn
		for others make a url using the value in prefix, use the keyword: pre (not checked; any text other than 'info' or 'rft' works here)
		set to nil to leave the identifier out of the COinS
	separator: character or text between label and the identifier in the rendered citation
	access: use this parameter to set the access level for all instances of this identifier.
			the value must be a valid access level for an identifier (see ['id-access'] in this file).
	custom_access: to enable custom access level for an identifier, set this parameter
			to the parameter that should control it (normally 'id-access')
]]

local id_handlers = {
	['ARXIV'] = {
		parameters = {'arxiv', 'eprint'},
		q = 'Q118398',
		label = 'arXiv',
		mode = 'manual',
		prefix = '//arxiv.org/abs/', 											-- protocol relative tested 2013-09-04
		encode = false,
		COinS = 'info:arxiv',
		separator = ':',
		access = 'free',														-- free to read
		},
	['ASIN'] = {
		parameters = { 'asin', 'ASIN' },
		q = 'Q1753278',
		label = 'ASIN',
		mode = 'manual',
		prefix = '//www.amazon.',
		COinS = nil,															-- no COinS for this id (needs thinking on implementation because |asin-tld=)
		separator = '&nbsp;',
		encode = false;
		},
	['BIBCODE'] = {
		parameters = {'bibcode'},
		q = 'Q25754',
		label = 'Bibcode',
		mode = 'manual',
		prefix = 'https://ui.adsabs.harvard.edu/abs/',
		encode = false,
		COinS = 'info:bibcode',
		separator = ':',
		custom_access = 'bibcode-access',
		},
	['BIORXIV'] = {
		parameters = {'biorxiv'},
		q = 'Q19835482',
		label = 'bioRxiv',
		mode = 'manual',
		prefix = '//doi.org/10.1101/',
		COinS = 'pre',															-- use prefix value
		access = 'free',														-- free to read
		encode = true,
		separator = '&nbsp;',
		},
	['CITESEERX'] = {
		parameters = {'citeseerx'},
		q = 'Q2715061',
		label = 'CiteSeerX',
		mode = 'manual',														-- manual for custom validation of the "doi"
		prefix = '//citeseerx.ist.psu.edu/viewdoc/summary?doi=',
		COinS =  'pre',															-- use prefix value
		access = 'free',														-- free to read
		encode = true,
		separator = '&nbsp;',
		},
	['DOI'] = {
		parameters = { 'doi', 'DOI' },
		q = 'Q25670',
		label = 'doi',
		mode = 'manual',
		prefix = '//doi.org/',
		COinS = 'info:doi',
		separator = ':',
		encode = true,
		custom_access = 'doi-access',
		},
	['EISSN'] = {
		parameters = {'eissn', 'EISSN'},
		q = 'Q46339674',
		label = 'eISSN',
		mode = 'manual',
		prefix = '//www.worldcat.org/issn/',
		COinS = 'rft.eissn',
		encode = false,
		separator = '&nbsp;',
		},
	['HDL'] = {
		parameters = { 'hdl', 'HDL' },
		q = 'Q3126718',
		label = 'hdl',
		mode = 'manual',
		prefix = '//hdl.handle.net/',
		COinS = 'info:hdl',
		separator = ':',
		encode = true,
		custom_access = 'hdl-access',
		},
	['ISBN'] = {
		parameters = {'isbn', 'ISBN', 'isbn13', 'ISBN13'},
		q = 'Q33057',
		label = 'ISBN',
		mode = 'manual',
		prefix = 'Special:BookSources/',
		COinS = 'rft.isbn',
		separator = '&nbsp;',
		},
	['ISMN'] = {
		parameters = {'ismn', 'ISMN'},
		q = 'Q1666938',
		label = 'ISMN',
		mode = 'manual',
		prefix = '',															-- not currently used;
		COinS = 'nil',															-- nil because we can't use pre or rft or info:
		separator = '&nbsp;',
		},
	['ISSN'] = {
		parameters = {'issn', 'ISSN'},
		q = 'Q131276',
		label = 'ISSN',
		mode = 'manual',
		prefix = '//www.worldcat.org/issn/',
		COinS = 'rft.issn',
		encode = false,
		separator = '&nbsp;',
		},
	['JFM'] = {
		parameters = {'jfm', 'JFM'},
		q = '',
		label = 'JFM',
		mode = 'manual',
		prefix = '//zbmath.org/?format=complete&q=an:',
		COinS = 'pre',															-- use prefix value
		encode = true,
		separator = '&nbsp;',
		},
	['JSTOR'] = {
		parameters = {'jstor', 'JSTOR'},
		q = 'Q1420342',
		label = 'JSTOR',
		mode = 'external',
		prefix = '//www.jstor.org/stable/', 									-- protocol relative tested 2013-09-04
		COinS = 'pre',															-- use prefix value
		encode = false,
		separator = '&nbsp;',
		custom_access = 'jstor-access',
		},
	['LCCN'] = {
		parameters = {'LCCN', 'lccn'},
		q = 'Q620946',
		label = 'LCCN',
		mode = 'manual',
		prefix = '//lccn.loc.gov/', 											-- protocol relative tested 2015-12-28
		COinS = 'info:lccn',													-- use prefix value
		encode = false,
		separator = '&nbsp;',
		},
	['MR'] = {
		parameters = {'MR', 'mr'},
		q = 'Q211172',
		label = 'MR',
		mode = 'manual',
		prefix = '//www.ams.org/mathscinet-getitem?mr=', 						-- protocol relative tested 2013-09-04
		COinS = 'pre',															-- use prefix value
		encode = true,
		separator = '&nbsp;',
		},
	['OCLC'] = {
		parameters = {'OCLC', 'oclc'},
		q = 'Q190593',
		label = 'OCLC',
		mode = 'manual',
		prefix = '//www.worldcat.org/oclc/',
		COinS = 'info:oclcnum',
		encode = true,
		separator = '&nbsp;',
		},
	['OL'] = {
		parameters = { 'ol', 'OL' },
		q = 'Q1201876',
		label = 'OL',
		mode = 'manual',
		prefix = '//openlibrary.org/',
		COinS = nil,															-- no COinS for this id (needs thinking on implementation because /authors/books/works/OL)
		separator = '&nbsp;',
		encode = true,
		custom_access = 'ol-access',
		},
	['OSTI'] = {
		parameters = {'OSTI', 'osti'},
		q = 'Q2015776',
		label = 'OSTI',
		mode = 'external',
		prefix = '//www.osti.gov/biblio/',										-- protocol relative tested 2018-09-12
		COinS = 'pre',															-- use prefix value
		encode = true,
		separator = '&nbsp;',
		custom_access = 'osti-access',
		},
	['PMC'] = {
		parameters = {'PMC', 'pmc'},
		q = 'Q229883',
		label = 'PMC',
		mode = 'manual',
		prefix = '//www.ncbi.nlm.nih.gov/pmc/articles/PMC',
		suffix = " ",
		COinS = 'pre',															-- use prefix value
		encode = true,
		separator = '&nbsp;',
		access = 'free',														-- free to read
		},
	['PMID'] = {
		parameters = {'PMID', 'pmid'},
		q = '',
		label = 'PMID',
		mode = 'manual',
		prefix = '//www.ncbi.nlm.nih.gov/pubmed/',
		COinS = 'info:pmid',
		encode = false,
		separator = '&nbsp;',
		},
	['RFC'] = {
		parameters = {'RFC', 'rfc'},
		q = 'Q212971',
		label = 'RFC',
		mode = 'external',
		prefix = '//tools.ietf.org/html/rfc',
		COinS = 'pre',															-- use prefix value
		encode = false,
		separator = '&nbsp;',
		access = 'free',														-- free to read
		},
	['SSRN'] = {
		parameters = {'SSRN', 'ssrn'},
		q = 'Q7550801',
		label = 'SSRN',
		mode = 'manual',
		prefix = '//ssrn.com/abstract=', 										-- protocol relative tested 2013-09-04
		COinS = 'pre',															-- use prefix value
		encode = true,
		separator = '&nbsp;',
		access = 'free',														-- always free to read
		},
	['USENETID'] = {
		parameters = {'message-id'},
		q = 'Q193162',
		label = 'Usenet:',
		mode = 'manual',
		prefix = 'news:',
		encode = false,
		COinS = 'pre',															-- use prefix value
		separator = '&nbsp;',
		},
	['ZBL'] = {
		parameters = {'ZBL', 'zbl'},
		q = 'Q190269',
		label = 'Zbl',
		mode = 'manual',
		prefix = '//zbmath.org/?format=complete&q=an:',
		COinS = 'pre',															-- use prefix value
		encode = true,
		separator = '&nbsp;',
		},
	}


--[[--------------------------< E X P O R T E D   T A B L E S >------------------------------------------------
]]

return 	{
	aliases = aliases,
	special_case_translation = special_case_translation,
	defaults = defaults,
	date_names = date_names,
	error_conditions = error_conditions,
	editor_markup_patterns = editor_markup_patterns,
	et_al_patterns = et_al_patterns,
	global_df = global_df,
	id_handlers = id_handlers,
	keywords_lists = keywords_lists,
	keywords_xlate = keywords_xlate,
	stripmarkers=stripmarkers,
	invisible_chars = invisible_chars,
	indic_script = indic_script,
	local_lang_cat_enable = local_lang_cat_enable,
	maint_cats = maint_cats,
	messages = messages,
	presentation = presentation,
	prop_cats = prop_cats,
	punct_skip = punct_skip,
	script_lang_codes = script_lang_codes,
	lang_code_remap = lang_code_remap,
	lang_name_remap = lang_name_remap,
	this_wiki_code = this_wiki_code,
	title_types = title_types,
	uncategorized_namespaces = uncategorized_namespaces,
	uncategorized_subpages = uncategorized_subpages,
	templates_using_volume = templates_using_volume,
	templates_using_issue = templates_using_issue,
	templates_not_using_page = templates_not_using_page,
	}