View source for Template:Acad/doc

{{Documentation subpage}}

{{redirect3|Template:Alumni Cantabrigienses}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

== Usage ==

This template is a wrapper template for {{tlx|cite encyclopedia}}. It links to the website [http://venn.lib.cam.ac.uk/ ACAD] (A Cambridge Alumni Database), which is an online enhanced version of ''[[Alumni Cantabrigienses]]'', a book that catalogues graduates of [[Cambridge University]] through 1900.

<code><nowiki>{{</nowiki>acad |id= |name= {{xtd|{{para|volume}}}} {{xtd|{{para|year}}}} |ref= |accessdate= |hide errors=}}</code>

===Required parameters===
* '''id''' : the alphanumeric ID (eg, "DNKS873WA") of the person's biographical entry. It appears in small print in the right-hand column header for each ACAD search result, and can be hard to spot (search within the web page for the phrase "unique identifier").
* '''name''' : name of the person/biography

For example:
:<code><nowiki>{{</nowiki>{{BASEPAGENAME}}<nowiki>|id=MLN900AA|name=Milne, Alan Alexander}}</nowiki></code>
::{{{{BASEPAGENAME}}|id=MLN900AA|name=Milne, Alan Alexander}}
and may also be written:
:<code><nowiki>{{</nowiki>{{BASEPAGENAME}}|MLN900AA|Milne, Alan Alexander}}</code>
::{{{{BASEPAGENAME}}|MLN900AA|Milne, Alan Alexander}}
===Optional parameters===
* '''ref''': see {{tlx|cite encyclopedia}}. This can be used in combination with {{tl|harv}}, {{tl|harvnb}} and {{tl|sfn}} templates to link short format citations to this one. Unless overridden by the content of {{para|ref}}, {{tld|acad}} creates an anchor id using the content of {{para|id}}.  To link to the {{tld|acad}} citation, use, for example, <code><nowiki>{{</nowiki>sfn|ACAD|<''id''>}}</code> where <code><''id''></code> is the value from {{para|id}}.
* '''accessdate''': full date that ACAD was consulted
* '''hide errors''': when set to <code>yes</code>, hides error messages

===Error messages===
If required parameters are empty or omitted, the template will add appropriate error messages to the end of the citation.
*<span style="font-size:100%" class="error citation-comment">missing <code>id</code>.</span> – {{para|id}} is required to create the proper url link to the database; defaults to the database search page;
*<span style="font-size:100%" class="error citation-comment">missing <code>name</code>.</span> – {{para|name}} is required to create the correct title in the rendered citation;
*<span style="font-size:100%" class="error citation-comment"><code>|ref=harv</code> not recommended.</span> – Because {{tld|acad}} does not support a {{para|date}} or {{para|year}} parameter, {{para|ref|harv}} won't produce a meaningful CITEREF anchor id.  See {{para|ref}} under [[#Optional parameters|§Optional parameters]].

{{tld|acad}} citations with missing {{para|name}} or {{para|id}} are placed in the hidden maintenance category {{cl|ACAD citations missing parameters}} when those pages are in article namespace.

== Related templates ==
*{{tlx|vennAC}} – a template for citing ''Alumni Cantabrigienses'' facsimiles held at [[Internet Archive]]

<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:External link templates]]
[[Category:Citation Style 1 specific-source templates]]

[[ca:Template:Venn]]
[[fr:Modèle:Alumni Cantabrigienses]]
[[ja:Template:Venn]]
[[la:Formula:Venn]]

</includeonly>