Template:Cite source/doc

 is a powerful template for generating in-universe, inline citations. In its most basic usage, it produces a collapsible bit of information about the source being cited, pulled directly from the infobox, intended to supplement the prefix. However, the template also has options for citing specific parts and episodes, variants of sources that don't have their own page, exact page numbers and timestamps and paths of "choose your own adventure" books.

Basic usage is very simple. When citing a source, instead of linking to the source like usual, wrap it in this template, like this:  . For example, if citing The Daleks, you would type: (TV: ) This produces the following:
 * (TV: )

The template will automatically strip the dab term in the display text. To specifiy custom display text, you would type the following:  . For example, if citing Project: Lazarus, which, for technical reasons, has the pagename Project Lazarus (audio story), you would type: (AUDIO: ) This produces the following:
 * (AUDIO: )

Clicking the [+] to the right of the source's name will reveal additional information about the source, intended to provide context to the reader regarding the origin of the source, allowing them to easily decide if it is something they're interested in. This information is automatically pulled from the infobox and generally requires no editor intervention (although you can customise the additional information if desired). For this to work, the page for the source being cited must be using. If it is not, an error will be produced. Information about finetuning the text displayed here can be found in the Infobox's documentation.

Exact nature of the additional information
The collapsible additional information can include the following:
 * writer(s)
 * what the source is adapted from
 * the original source's writer(s)
 * series
 * anthology
 * publisher
 * premiere network
 * release year(s)

If there are 4 or more writers, only one will be displayed with the rest replaced by "et al.". Hovering over the "et al." on desktop will show the other writers. For example:
 * (PROSE: )

Citing parts and episodes
Sources are often serialised across a number of parts. Sometimes, it can be useful to cite specific parts and episodes. Where possible, this is prefered over generic citations as it makes checking the citation and looking for the information within the source much easier (to make this even easier, consider adding a precise citation).

Named parts and episodes
To cite a specific named episode, use the following format:  . For example, to cite "The Dead Planet" from The Daleks, you would type: (TV: ) This produces:
 * (TV: )

The text provided to the |namedep= parameter must exactly match the episode's section title on the source's page, including any bracketed episode numbers. These bracketed episode numbers will be automatically stripped in the output.

The |namedpart= parameter is very similar. However, it does not produce a link to any specific sections. It has the following format:  . For example, to cite "The House Military" from The Book of the War, you would type: (PROSE: ) This produces:
 * (PROSE: )

Unamed parts and episodes
To cite a specific unnamed episode, use the following format:  . The episode number must be in the exact same format used for that episode's section title on the source's page, including capitalisation. For example, to cite part 7 of The War Games, you would type: (TV: ) This produces:
 * (TV: )

Sometimes, the episode or part's section title isn't simply in the format "Episode " or "Part " and so the link produced using this feature will be incorrect. In these situations, provide the full section's title using the |sect=</tt> parameter. For example, to cite part 2 of The Klepton Parasites, which has the section title "Part Two: 16th November 1964", you would type: (COMIC: ) This produces:
 * (COMIC: )

|sect=</tt> can also be used for linking to arbitrary sections outside of the context of episodes and parts, if desired.

Citing variants
Sources sometimes have one or more variants that aren't deserving of their own source page and so are covered on the same page as their "parent" source, such as animated reconstructions or audiobook readings. Occasionally, these variants can present unique information and so may want to be specifically cited. To do so, the variant should first be defined on the source's page using. Then, the variant being cited should specified as follows:  </tt>. The variant name used by the |var=</tt> parameter should be exactly the same as the variant name set in as the |variant=</tt> parameter. For example, to cite the special edition of The Five Doctors, you would type: (TV: ) This produces:
 * (TV: )

This works with citing parts as well. For example, if you wanted to cite part 3 of the animated reconstruction of The Faceless Ones, you would type: (TV: ) This produces:
 * (TV: )

Precise citations
It can sometimes be useful to cite specific editions, chapters, page numbers or timestamps. The information being cited is rarely from the source as a whole, so being as precise as possible makes verifying information much easier. The precise citations can be used alongside citing parts and citing variants.

Books
To perform precise citations for books, use the |ed=</tt> and |page=</tt> parameters to define the edition and page number being cited. These can be used independetly, although it is often preferable to use |ed=</tt> with |page=</tt> as page numbers can change between editions. For example, to cite page 10 of The Eight Doctors, you would type: (PROSE: ) This produces:
 * (PROSE: )

You can also cite multiple pages. For example, to cite pages 10-20 of The Eight Doctors, you would type: (PROSE: ) This produces:
 * (PROSE: )

Note the inclusion of the "s" in "pages" in the produced citation. This "s" is added if the template detects any of the following: ",", "-", "and", "&".

Chapters can also be specified. Chapter numbers can be specified with |chaptnum=</tt> and chapter names with |chaptname=</tt>. For example, to cite chapter 1 of Doctor Who in an Exciting Adventure with the Daleks, you would type: (PROSE: ) This produces:
 * (PROSE: )

|chaptnum=</tt> follows the same logic of pluralisation that page=</tt> uses.

Using |chaptname=</tt> requires that |chaptnum=</tt> is also used. To just specify just a chapter name, or any other custom chapter text, use chapt=</tt>.

Video and audio sources
To perform precise citations for video (including TV stories, webcasts and films) and audio sources, you can define a timestamp using the <tt>|hour=</tt>, <tt>|minute=</tt> and <tt>|second=</tt> parameters. These can be used in any combination. For example, to cite the timestamp 34 minutes and 2 second of Rosa, you would type: (TV: ) This produces:
 * (TV: )

You can also define entirely custom timestamps using <tt>|timestamp=</tt>. For example, to cite the timestamp 26:54 of The Boundless Sea, you would type: (AUDIO: ) This produces:
 * (AUDIO: )

It can sometimes also be a good idea to use <tt>|ed=</tt> in these precise citations, particuarly with video sources, as exact timestamps can change between versions, such as the broadcast version, homemedia releases and oversea edits, and these don't always qualify as their own variants.

Custom precise citation text
Alternatively to everything discussed in the prior two sections, you can define entirely custom precise citation text using the <tt>|precisecite=</tt> parameter.

Citing "choose your own adventure" books
In line with the currently unpassed User:OttselSpy25/Multipath Sandbox, you can cite specific "markers" (the terminology used in this opening post) within "choose your own adventure" gamebooks such as those in the Make Your Own Adventure with Doctor Who/Find Your Fate, Decide Your Destiny and Choose the Future series. To do this, specify the marker using <tt>|marker=</tt>. If there are marker sections on the page, make sure that the marker specified exactly matches the bit of the section header after "Marker ". For example, to cite the 2nd marker of Search for the Doctor, you would type: (PROSE: ) This produces the following:

(PROSE: )

Multiple markers should be cited in different uses of the template. To reduce clutter, the title of the story can be hidden by setting <tt>|notital=</tt> to any value. For example, to cite markers 32 and 33 of Search for the Doctor, you would type: (PROSE:, ) This produces the following:

(PROSE:, )

Customising the additional information
It is possible to overwrite specific bits of information in the collapsible additional information for a specific citation using the following parameters: You only have to specify the information that you wish to change from the default. Others will be filled in automatically. For example, if you wished to be a little more precise about the release year when citing "The Dead Planet", you would type the following: (TV: ) This produces:
 * <tt>|writer=</tt>
 * <tt>|adapted from=</tt>
 * <tt>|series=</tt>
 * <tt>|anthology=</tt>
 * <tt>|publisher=</tt>
 * <tt>|network=</tt>
 * <tt>|release year=</tt>
 * (TV: )

If any of the values you wish to use for any of these bits of information contain a comma (","), you must specify the <tt>|separator=</tt> parameter with a different separator (such as ";") that then should be used when you need to specify multiple values for a bit of information, such as multiple writers.

Using this feature repeatedly on the same page may cause performance issues, but occasional usage shouldn't have much impact.

It is also possible to provide fully customised additional information using the <tt>|citationtext=</tt> parameter.

Reusing citations
Due to the number of options available, uses of this template can sometimes become very long. Therefore, much like with <tt> </tt> references, it is possible to define named citations that can be reused within the page they were defined on. This is done using the <tt>|name=</tt> parameter. To define a named citation, simply add this parameter to the template usage with a short name. For example, to define a citation named "TFOAR1" for episode 1 of the DVD edition of the animated reconstruction of The Faceless Ones at the timestamp 3 minutes and 4 seconds, you would type: (TV: ) This produces the following output as normal:
 * (TV: )

Then, to reuse this citation, you would only have to type: (TV: ) This produces:
 * (TV: )

When <tt>|name=</tt> is being used to access an already defined citation, any other parameters passed to the template are ignored. In other words, you cannot alter a named citation in later uses.

Errors and troubleshooting
Due to the complex nature of this large template, there are a number of ways in which it could go wrong and produce an error. This section details these errors, providing potential solutions.

Lua errors
If you see any errors like this, please remove the use of this template that is causing it and report it on the |talk page with as much detail as you can as soon as possible. These errors generally mean that there is some form of mistake with the template's actual code.

Error: code 1
data table empty This error means that the source's infobox was unable to collect any data to put the additional information together. To fix this, first purge the cache of the source's page and the page the citation is being used on. If that doesn't work, make sure that the infobox contains at least one of the pieces of data listed here. If all else fails, manually define the additional information using the <tt>|citation text=</tt> parameter within the infobox.

Error: Code 2
no data stored in variables, cache or SMW This error means that the template is unable to get the additional information from the source's infobox. To fix this, first purge the cache of the source's page and the page the citation is being used on. If this doesn't work, check that the source's page is actually using and, if it isn't, convert it so that it is. If this doesn't work, report the error on the |talk page.

Error: code 3
no story given in template transclusion This is a simple one and means that the template has been used without providing a source to actually be cited. To fix this, include a source like is shown in the first few paragraphs of this page.

Error: Code 4
no data in variables or cache and SMW returned information for multiple variants, the one required here not being clear This rather verbose error is an extreme edge case that should never occur. It means that you've attempted to cite a variant where more than one variant for that source exist and, for whatever reason, there is no additional information provided for said variant in the 2 preferred means of storing this information yet Semantic MediaWiki, the last resort, does have this information, the problem being that it is not possible to properly distinguish the multiple variants coming from SMW. To fix this, first purge the cache of the source's page and the page the citation is being used on. If that doesn't work, report the error on the |talk page.

Other issues
There are some other problems that are not automatically detectable and have no automatic fix.
 * Only some of the citation information is in the collapsible. The rest is always visible.
 * This is most likely caused by the template being used in a block of italics. For example:
 * [...](TV: [...]
 * [...](TV: )[...]
 * This is not the intended behavior. To fix this, try closing the italics before the citation and opening them again after. For example:
 * [...](TV: [...]
 * [...](TV: )[...]
 * Pretty much, this template just can't be used within italics.

Full parameters list
This section lists all parameters offered by this template.

Technical documentation
This template relies upon Module:Cite source, a module written in Lua. Documentation for this module can be found on its page.