View source for Template:Authority control/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->
{{High-risk| 510,000+ }}
{{lua|Module:Authority control|Module:Check for unknown parameters}}
{{Uses Wikidata|section=Wikidata}}
{{Tracks Wikidata|P214}}
{{TOC right}}

== Description ==
{{details|Authority control|Wikipedia:Authority control}}
This metadata template links Wikipedia articles to various library catalogue systems, for biographies and other topics. 

This template draws most of its values from [[Wikidata]], but they can be overridden by locally entered data. Adding the data to Wikidata is preferable.

If there is no information in Wikidata for the specific subject, an empty instance of this template will be ''dormant'', meaning it will be invisible on the rendered page. Thus, using this template on a page with no authority information is harmless.

An empty instance of this template stays dormant in an article, until values are added to Wikidata, when it will then display them, so this template should be added to all biographies, whether or not there are authority control identifiers in Wikidata already.

=== User pages ===

The template may also be placed on user pages, but then data must be entered locally.

== Data types ==

; Supported authority files:
: [[Virtual International Authority File]] (VIAF)
: [[Library of Congress Control Number]] (LCCN)
: [[International Standard Name Identifier]] (ISNI)
: [[ORCID|Open Researcher and Contributor ID]] (ORCID; see also [[WP:ORCID]])
: [[Integrated Authority File]] (''{{lang|de|Gemeinsame Normdatei}}'' or GND)
: [[LIBRIS]] by the [[National Library of Sweden]] (SELIBR)
: [[Système universitaire de documentation|University Documentation System of France]] (''{{lang|fr|Système universitaire de documentation}}'' or SUDOC)
: [[Bibliothèque nationale de France|National Library of France]] (''{{lang|fr|Bibliothèque nationale de France}}'' or BNF) 
: [[Biografisch Portaal|Dutch Biography Portal]] (''{{lang|nl|Biografisch Portaal}}'' or BPN)
: [[ResearcherID]] (RID)
: [[BIBSYS]] (BIBSYS)
: [[Union List of Artist Names]] (ULAN)
: [[MusicBrainz|MusicBrainz Artist ID]] (MBA)
: [[National Library of Australia]] (NLA)
: [[National Diet Library]] (NDL)
: ... (30+ sources, see "local conf" list at [[Module:Authority control]])

; Deprecated: 
: [[Corporate Bodies Authority File]] (''{{lang|de|Gemeinsame Körperschaftsdatei}}'' or GKD), now part of GND
: [[Name Authority File]] (''{{lang|de|Personennamendatei}}'' or PND), now part of GND
: [[Subject Headings Authority File]] (''{{lang|de|Schlagwortnormdatei}}'' or SWD), now part of GND

Wikidata content is used as fallback for the BNF, BPN, GND, ISNI, LCCN, MBA, NDL, NLA, ORCID, SUDOC, ULAN, and VIAF identifiers.

The template validates digits in many values (such as ISNI, ORCID, SUDOC, etc.<!--see module source-->) and shows an error if the check fails.

Wherever possible, the template also generates a link to [[WorldCat Identities]], using VIAF or LCCN values.

== Position ==
{{See also|Wikipedia:Manual of Style/Layout#Standard appendices and footers{{!}}Wikipedia:Manual of Style/Layout}}
As a metadata template, the Authority control template should be placed after the [[Wikipedia:External links|external links]] section and [[Wikipedia:Navigation templates|navigation templates]], right before the categories.

==Usage==
As a rule of thumb: (1) insert the empty version, (2) click "Show preview" to see which sources are automatically pulled from Wikidata, (3a) if you know more sources, add them in the template using their named param, (3b) alternatively, consider adding them to the article's "Wikidata item" (so that all versions of Wikipedia will automatically benefit).

;Empty (reliant wholly on Wikidata) : <code><nowiki>{{Authority control}}</nowiki></code>

;Full : <code><nowiki>{{Authority control |VIAF=xxxxxx |LCCN=n/xx/xxxxxx |ISNI=xxxx xxxx xxxx xxxx |ORCID=xxxx-xxxx-xxxx-xxxx |GND=xxxxxx |SELIBR=xxxxxx |SUDOC=xxxxxxxxx |BNF=xxxxxx |BPN=xxxxx |RID=xxxxx |BIBSYS=xxxxx |ULAN=xxxxx |MBA=xxxxxx |NLA=xxxxxxx |NDL=xxxxxxxx}}</nowiki></code>

;Blank : <code><nowiki>{{Authority control |VIAF= |LCCN= |ISNI= |ORCID= |GND= |SELIBR= |SUDOC= |BNF= |BPN= |RID= |BIBSYS= |ULAN= |MBA= |NLA= |NDL=}}</nowiki></code>

;The following data sources are accepted:

{| class="wikitable"
|-
! Parameter || Scope || Name || Search || Remarks
|-
| VIAF
| People
| [[Virtual International Authority File]]
| [https://viaf.org/]
| International authority data from the Online Computer Library Center (OCLC)
|- 
| LCCN
| People
| [[Library of Congress Control Number]]
| [http://authorities.loc.gov/cgi-bin/Pwebrecon.cgi?DB=local&PAGE=First]
| See [[Wikipedia:Authority control#LCCN]] for formatting instructions
|-
| ISNI
| People
| [[International Standard Name Identifier]]
| [http://isni.org/search] 
| ISNI is a method for uniquely identifying the public identities of contributors to media content such as books, TV programmes, and newspaper articles. '''Please take care not to confuse ISNI and ORCID identifiers.'''
|-
| ORCID
| People
| [[ORCID]]
| [https://orcid.org/]
| Authority data on researchers, academics, etc. The ID range is a subset of the [[ISNI]] range. For free text links (for example when mentioning a person on page which is not about them), it is also possible to use {{tl|ORCID}}. Authors—including Wikipedia editors—may obtain an ORCID by signing up at [https://orcid.org/register orcid.org/register]. '''Please take care not to confuse ORCID and ISNI identifiers.'''
|-
| GND 
| All
| [[Integrated Authority File]] (''{{lang|de|Gemeinsame Normdatei}}'')
| [http://www.dnb.de/EN/Home/home_node.html] [http://swb.bsz-bw.de/DB=2.104/SET=4/TTL=1/LNG=EN/START_WELCOME?retrace=0]
| Authority data on people, corporations and subjects from the [[German National Library]] (DNB)
|- 
| SELIBR
| People
| [[LIBRIS]]
| [http://libris.kb.se/]
| Authority data from the [[National Library of Sweden]]
|-
| SUDOC
| People
| {{lang|fr|[[Système universitaire de documentation]]}}
| [http://www.idref.fr/autorites/autorites.html]<!--IdRef direct interface--> {{fr icon}}
| Authority data of people listed in the general catalogue of the University Documentation System of France. Also available from [http://www.sudoc.abes.fr/xslt//DB=2.1/SET=2/TTL=1/LNG=EN/ English-speaking catalog] (search author, click one book, click author name, take PPN= value of the URL)
|-
| BNF
| People
| {{lang|fr|[[Bibliothèque nationale de France]]}}
| [http://catalogue.bnf.fr/jsp/recherche_combinee_tout.jsp?host=catalogue] {{fr icon}}
| Authority data of people listed in the general catalogue of the National Library of France
|-
| BPN
| People
| [[Biografisch Portaal|Dutch Biography Portal]] (''{{lang|nl|Biografisch Portaal}}'')
| [http://www.biografischportaal.nl/en/]
| Dutch project with material for 40,000 digitized biographies, including former colonies of the Netherlands.
|-
| RID
| People
| [[ResearcherID]]
| [http://www.researcherid.com/ViewProfileSearch.action]
| An identifying system for scientific authors. The system was introduced in January 2008 by [[Thomson Reuters]]. The combined use of the [[digital object identifier]] with the ResearcherID allows for a unique association of authors and scientific articles.
<!--|-
| Scopus
| People
| [[Scopus]]
| ''Login required''
| SciVerse Scopus is a bibliographic database containing abstracts and citations for academic journal articles. It covers nearly 19,500 titles from over 5,000 international publishers, of which 16,500 are peer-reviewed journals in the scientific, technical, medical, and social sciences (including arts and humanities).-->
|-
| BIBSYS
| People
| [[BIBSYS]]
| [http://ask.bibsys.no/ask/action/smpsearch]
| BIBSYS is a supplier of library and information systems for all Norwegian university Libraries, the National Library of Norway, college libraries, and a number of research libraries and institutions.
|-
| ULAN
| Artists
| [[Union List of Artist Names]]
| [http://www.getty.edu/research/tools/vocabularies/ulan/index.html]
| ULAN is an online database using a controlled vocabulary currently containing around 293,000 names and other information about artists. Names in ULAN may include given names, pseudonyms, variant spellings, names in multiple languages, and names that have changed over time (e.g., married names).
|-
| MBA
| Artists
| [[MusicBrainz|MusicBrainz Artist ID]]
| [https://musicbrainz.org/search]
| MusicBrainz is an open music encyclopedia that collects music metadata and makes it available to the public. 
|-
| NLA
| People or groups
| [[National Library of Australia]]
| [//trove.nla.gov.au/people]
| NLA Trove’s People and Organisation view allows the discovery of biographical and other contextual information about people and organisations. Search also available via [http://viaf.org VIAF].
|-
| NDL
| People
| [[National Diet Library]]
| [http://iss.ndl.go.jp/?locale=en]
| Authority data listed in the catalog of the national library of Japan. Search also available via [http://viaf.org VIAF].
|-
| RKDartists
| Artists
| [[Netherlands Institute for Art History#Online artist pages|RKD]]'
| [https://rkd.nl/en/explore/artists/record?query]
| RKDartists is an online database using a controlled vocabulary currently containing around 200,000+ names and other information about artists. Names in RKDartists may include given names, pseudonyms, variant spellings, names in multiple languages, and names that have changed over time (e.g., married names).
|}

;The following data sources are '''deprecated'''

and will cause articles to be added to hidden tracking sub-categories of [[:Category:Wikipedia articles with authority control information]]:
{{Collapse top|title=Deprecated parameters}}
{| class="wikitable"
|-
! Deprecated<br />parameter
! Scope
! style="width:17em" | Name
! Remarks
! Tracking
|-
| {{red|GKD}}
| Corporations
| {{lang|de|[[Gemeinsame Körperschaftsdatei]]}}<br />(now part of GND)
| Authority data on corporations from the German National Library ({{red|'''deprecated''', please use GND}})
| [[:Category:Wikipedia articles with deprecated authority control identifiers (GKD)|GKD cat]]
|-
| {{red|PND}}
| People
| {{lang|de|[[Personennamendatei]]}}<br />(now part of GND)
| Authority data on people from the German National Library ({{red|'''deprecated''', please use GND}})
| [[:Category:Wikipedia articles with deprecated authority control identifiers (PND)|PND cat]]
|-
| {{red|SWD}}
| Subjects
| {{lang|de|[[Schlagwortnormdatei]]}}<br />(now part of GND)
| Authority data on subjects from the German National Library ({{red|'''deprecated''', please use GND}})
| [[:Category:Wikipedia articles with deprecated authority control identifiers (SWD)|SWD cat]]
|}
{{collapse bottom}}

==Examples==
<tt><nowiki>{{Authority control |VIAF=59263727 |LCCN=n/79/113947 |ISNI=0000 0000 8138 6064 |GND=119408643 |SUDOC=066924146 |BNF=13746617f |MBA=9dd93d09-24b4-41f1-a48b-ef48b07499c3 |NDL=00620343 }}</nowiki></tt> – for [[Alexander Graham Bell]] produces:
{{Authority control |VIAF=59263727 |LCCN=n/79/113947 |ISNI=0000 0000 8138 6064 |GND=119408643 |SUDOC=066924146 |BNF=13746617f |MBA=9dd93d09-24b4-41f1-a48b-ef48b07499c3 |NDL=00620343 }}


<tt><nowiki>{{Authority control |VIAF=66861474 |LCCN=n/87/142671 |ISNI=0000 0001 0911 2808 |GND=117421863 |SUDOC=090162897 }}</nowiki></tt> – for [[Harry Forbes Witherby]] produces: {{Authority control |VIAF=66861474 |LCCN=n/87/142671 |ISNI=0000 0001 0911 2808 |GND=117421863 |SUDOC=090162897 }}

==Wikidata==
The template can get its information from the following properties on [[Wikidata]]:

{| class="wikitable"
|-
!Parameter!!Type!!Property ID
|-
||VIAF||[[Virtual International Authority File|VIAF]]||{{Wikidata entity link|P214}}
|-
||LCCN||[[Library of Congress Control Number|LCCN]]||{{Wikidata entity link|P244}}
|-
||ISNI||[[International Standard Name Identifier|ISNI]]||{{Wikidata entity link|P213}}
|-
||ORCID||[[ORCID]]||{{Wikidata entity link|P496}}
|-
||GND||[[Integrated Authority File|GND]]||{{Wikidata entity link|P227}}
|-
||SELIBR||[[LIBRIS]]||{{Wikidata entity link|P906}}
|-
||SUDOC||[[Système universitaire de documentation|SUDOC]]||{{Wikidata entity link|P269}}
|-
||BNF||[[Bibliothèque nationale de France|BNF]]||{{Wikidata entity link|P268}}
|-
||BPN||[[Biografisch Portaal|BPN]]||{{Wikidata entity link|P651}}
|-
||ULAN||[[Union List of Artist Names|ULAN]]||{{Wikidata entity link|P245}}
|-
||MBA||[[MusicBrainz|MBID]]||{{Wikidata entity link|P434}}
|-
|NLA||[[National Library of Australia|NLA]]||{{Wikidata entity link|P409}}
|-
|NDL||[[National Diet Library|NDL]]||{{Wikidata entity link|P349}}
|-
|BIBSYS||[[BIBSYS]]||{{Wikidata entity link|P1015}}
|-
|RID||[[ResearcherID|RID]]||{{Wikidata entity link|P1053}}
|-
|RKDartists||[[Netherlands Institute for Art History#Online artist pages|RKD]]||{{Wikidata entity link|P650}}
|}

== Error reports ==
{{Template error report}}

== Microformat ==
The template wraps each UID value with the [[HTML]] markup: <code><nowiki><span class="uid">...</span></nowiki></code>, which enables the first-found value to be included in an [[hCard]] [[microformat]]. For that reason, VIAF, where present, is emitted first.

== Tracking categories ==
This template may add the following categories:
* {{clc|Pages using authority control with parameters}} – articles and categories transcluding this template with explicit parameters (not loaded from WikiData)
* {{clc|VIAF not on Wikidata}}
* {{clc|VIAF different on Wikidata}}

Additional categories may be added by [[Module:Authority control]]:
* The module documentation contains a list, see {{section link|Module:Authority control|Tracking categories}}
* Specific identifiers are in subcategories of {{cl|Pages with authority control information}}
* Faulty parameters are in subcategories of {{cl|Wikipedia articles with faulty authority control information}}

==See also==
* [[Wikipedia:Authority control]] – editor information
** [[Wikipedia:Authority control integration proposal/FAQ|FAQ]]
* [[Help:Authority control]] – reader help
* [[Template:Infobox book]] – supporting some [[library classification]] systems
* [[Template:German National Library portal]]
* For more information:
** {{lang|de|[[:de:Wikipedia:Normdaten]]}} {{De icon}}
** {{lang|de|[[:de:Hilfe:GND]]}} {{De icon}}
** [[:Commons:Template:Authority control]]

== TemplateData ==
{{TemplateDataHeader}}
<templatedata>
{
        "description": "A template to link Wikipedia articles to various library catalogue systems",
        "params": {
                "VIAF": {
                        "label": "VIAF",
                        "description": "International authority data from the Online Computer Library Center (OCLC)",
                        "type": "number"
                },
                "GND": {
                        "label": "GND",
                        "description": "Authority data on people, corporations and subjects from the German National Library",
                        "type": "string",
                        "aliases": ["PND"]
                },
                "LCCN": {
                        "label": "LCCN",
                        "description": "Library of Congress Control Number.  See [[Wikipedia:Authority control#LCCN]] for formatting instructions",
                        "type": "number"
                },
                "ISNI": {
                        "label": "ISNI",
                        "description": "ISNI is a method for uniquely identifying the public identities of contributors to media content such as books, TV programmes, and newspaper articles",
                        "type": "string"
                },
                "SELIBR": {
                        "label": "SELIBR",
                        "description": "Authority data from the National Library of Sweden",
                        "type": "string"
                },
                "ORCID": {
                        "label": "ORCID",
                        "description": "Authority data on researchers, academics, etc. The ID range has been defined as a subset of the forthcoming ISNI range",
                        "type": "string"
                },
                "SUDOC": {
                        "label": "SUDOC",
                        "description": "Authority data of people listed in the general catalogue of the University Documentation System of France",
                        "type": "string"
                },
                "BNF": {
                        "label": "BNF",
                        "description": "Authority data of people listed in the general catalogue of the National Library of France",
                        "type": "string"
                },
                "BPN": {
                        "label": "BPN",
                        "description": "Dutch project with material for 40,000 digitized biographies, including former colonies of the Netherlands",
                        "type": "number"
                },
                "RID": {
                        "label": "RID",
                        "description": "An identifying system for scientific authors. The system was introduced in January 2008 by Thomson Reuters. The combined use of the Digital Object Identifier with the ResearcherID allows for a unique association of authors and scientific articles",
                        "type": "string"
                },
                "BIBSYS": {
                        "label": "BIBSYS",
                        "description": "BIBSYS is a supplier of library and information systems for all Norwegian university Libraries, the National Library of Norway, college libraries, and a number of research libraries and institutions",
                        "type": "string"
                },
                "ULAN": {
                        "label": "ULAN",
                        "description": "ULAN is an online database using a controlled vocabulary currently containing around 293,000 names and other information about artists",
                        "type": "string"
                },
                "MBA": {
                        "label": "MBA",
                        "description": " MusicBrainz is an open music encyclopedia that collects music metadata and makes it available to the public. ",
                        "type": "string"
                },
                "NLA": {
                        "label": "NLA",
                        "description": "Authority control number issued by the National Library of Australia. ",
                        "type": "string"
                },
                "NDL": {
                        "label": "NDL",
                        "description": "Authority control number issued by the National Diet Library (National Library of Japan). ",
                        "type": "number"
                },
                "RKDartists": {
                        "label": "RKDartists",
                        "description": "RKDartists is an online database using a controlled vocabulary currently containing around 200,000+ names names and other information about artists",
                        "type": "string"
                }
        }
}
</templatedata>

== External links ==
; Maintenance reports
* [//tools.wmflabs.org/kasparbot/ac.php?select-project-enwiki=1 Authority control validator] provided by [[User:KasparBot|KasparBot]]

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<!-- CATEGORIES HERE, THANKS -->
[[Category:People and person external link templates]]
[[Category:External link templates to linked data sites with reciprocal links]]
[[Category:Templates using data from Wikidata]]
[[Category:Templates that add a tracking category]]
[[Category:External link templates using Wikidata]]
}}</includeonly>