Template:Cite source

New documentation

{{Cite source}} 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 and exact page numbers and timestamps.

Basic usage is very simple. When citing a source, instead of linking to the source like usual, wrap in this template, like this: {{Cite source|source's page name}}. For example, if citing The Daleks, you would type:

([[TV]]: {{User:Bongolium500/cite source|The Daleks (TV story)}})

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: {{Cite source|source's page name|display name}}. For example, if citing Project: Lazarus, which, for technical reasons, has the pagename Project Lazarus (audio story), you would type:

([[AUDIO]]: {{User:Bongolium500/cite source|Project Lazarus (audio story)|Project: Lazarus}})

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 {{Bongolium500/Infobox Story SMW}}. 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

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:

)

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 episodes

To cite a specific named episode, use the following format: {{Cite source|source's page name|namedep=episode's section title}}. For example, to cite "The Dead Planet" from The Daleks, you would type:

([[TV]]: {{User:Bongolium500/cite source|The Daleks (TV story)|namedep=The Dead Planet (1)}})

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.

|namedpart= acts as an alias to |namedep=. They are currently identical in function, although this might change in future.

Unamed parts and episodes

To cite a specific unamed episode, use the following format: {{Cite source|source's page name|ep=episode number}}. 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]]: {{User:Bongolium500/cite source|The War Games (TV story)|ep=seven}})

This produces:

(TV: )

Unamed parts are cited in a very similar way: {{Cite source|source's page name|part=part number}}. Again, the part number must be in the exact same format used for that part's section title on the source's page, including capitalisation.

Sometimes, the episode or part's section title isn't simply in the format "Episode <number>" or "Part <number>" and so the link produced using this feature will be incorrect. In these situations, provide the full section's title using the |sect= 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]]: {{User:Bongolium500/cite source|The Klepton Parasites (comic story)|part=Two|sect=Part Two: 16th November 1964}})

This produces:

(COMIC: )

|sect= 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 {{User:Bongolium500/store variant data}}. Then, the variant being cited should specified as follows: {{Cite source|source's page name|var=variant name}}. The variant name used by the |var= parameter should be exactly the same as the variant name set in {{User:Bongolium500/store variant data}} as the |variant= parameter. For example, to cite the special edition of The Five Doctors, you would type:

([[TV]]: {{User:Bongolium500/cite source|The Five Doctors (TV story)|var=special edition}})

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]]: {{User:Bongolium500/cite source|The Faceless Ones (TV story)|var=animated reconstruction|ep=3}})

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 and 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=, |chapt= and |page= parameters to define the edition, chapter and page number being cited. These can be used in any combination, although it is often preferable to use |ed= with |page= as page numbers can change between editions. For example, to cite chapter 1 of Doctor Who in an Exciting Adventure with the Daleks, you would type:

([[PROSE]]: {{User:Bongolium500/cite source|Doctor Who in an Exciting Adventure with the Daleks (novelisation)|ed=1965 Armada edition|chapt=1. A Meeting on the Common}})

This produces:

(PROSE: )

To cite page 10 of The Eight Doctors, you would type:

([[PROSE]]: {{User:Bongolium500/cite source|The Eight Doctors (novel)|page=10}})

This produces:

(PROSE: )

You can also cite multiple pages. For example, to cite pages 10-20 of The Eight Doctors, you would type:

([[PROSE]]: {{User:Bongolium500/cite source|The Eight Doctors (novel)|page=10-20}})

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", "&".

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 |hour=, |minute= and |second= parameters. These can be used in any combination, although, if you use |hour= and |second=, you should also use |minute=. For example, to cite the timestamp 34 minutes and 2 second of Rosa, you would type:

([[TV]]: {{User:Bongolium500/cite source|Rosa (TV story)|minute=34|second=2}})

This produces:

(TV: )

You can also define entirely custom timestamps using |timestamp=. For example, to cite the timestamp 26:54 of The Boundless Sea, you would type:

([[AUDIO]]: {{User:Bongolium500/cite source|The Boundless Sea (audio story)|timestamp=26:54}})

This produces:

(AUDIO: )

It can sometimes also be a good idea to use |ed= 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 |precisecite= parameter.

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:

• |writer=
• |adapted from=
• |series=
• |anthology=
• |publisher=
• |premiere network=
• |release year=

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 wish to be a little more precise about the release year when citing "The Dead Planet", you would type the following:

([[TV]]: {{User:Bongolium500/cite source|The Daleks (TV story)|namedep=The Dead Planet (1)|release year=1963}})

This produces:

(TV: )

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

Reusing citations

Due to the number of options available, uses of this template can sometimes become very long. Therefore, much like with <ref> references, it is possible to define named citations that can be reused within the page they were defined on. This is done using the |name= 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]]: {{User:Bongolium500/cite source|The Faceless Ones (TV story)|var=animated reconstruction|ep=1|minute=3|second=4|ed=DVD|name=TFOAR1}})

This produces the following output as normal:

(TV: )

Then, to reuse this citation, you would only have to type:

([[TV]]: {{User:Bongolium500/cite source|name=TFOAR1}})

This produces:

(TV: )

When |name= 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

to be added

Full parameters list

to be added

Technical documentation

to be added

Old documentation

Basic usage of {{Cite source}} is extremely simple. Once the story you wish to cite has been converted to using the correct infobox, simply cite the source using the format shown below:

([[TV]]: {{User:Bongolium500/cite source|The Daleks (TV story)}})

This produces (TV: ). Here is another example:

([[PROSE]]: {{User:Bongolium500/cite source|Doctor Who in an Exciting Adventure with the Daleks (novelisation)}})

It produces (PROSE: ). The ⁺ can be clicked in order to uncollapse some information about the cited story, taken from the infobox.

Citing parts of serials and comics

Sometimes, it can be benneficial to cite specific parts of stories. For serials with named episodes, use the following format:

([[TV]]: {{User:Bongolium500/cite source|The Daleks (TV story)|namedep=The Dead Planet (1)}})

This produces (TV: ). Note that the {{{namedep}}} field must match the section header on the stories page exactly. The episode number in the brackets is stripped automatically when displayed.

For parts of comics, use the following format:

([[COMIC]]: {{User:Bongolium500/cite source|The Klepton Parasites (comic story)|part=One}})

This produces (COMIC: ). Unamed episodes of serials can be cited in a similar way. Simply swap out {{{part}}} for {{{ep}}}. Note that the field must match the exact format used on the section header, sans "Part" or "Episode". This includes capitalisation.

Citing variants

Some stories have variants with slight differences. To accurately cite these, this template must be filled out with information about the variant and placed on the stories page below the infobox. Take note of the {{{variant}}} field. Variant citations use the following format:

([[TV]]: {{User:Bongolium500/cite source|The Five Doctors (TV story)|var=special edition}})

This produces (TV: ). The {{{var}}} field should be exactly the same as the {{{variant}}} field on the {{store variant data}} template.

Multiple variants can also co-exist for the same story. For example,

(TV: )

(TV: )

(TV: )

You can also cite parts with variants:

(TV: )

Accurate citations

Sometimes, with books, it can be useful to cite specific editions, chapters and pages. This is done with the {{{ed}}}, {{{chapt}}} and {{{page}}} fields, used for the edition, chapter and page(s) respectively. They can be used in any combination, but it is encouraged to always use {{{ed}}} with {{{page}}} as page numbers can change between editions. Some examples are below:

([[PROSE]]: {{User:Bongolium500/cite source|Doctor Who in an Exciting Adventure with the Daleks (novelisation)|ed=1965 Armada edition|chapt=1. A Meeting on the Common}})

This produces (PROSE: ).

([[PROSE]]: {{User:Bongolium500/cite source|The Eight Doctors (novel)|page=10}})

This produces (PROSE: ).

([[PROSE]]: {{User:Bongolium500/cite source|The Eight Doctors (novel)|page=10-20}})

This produces (PROSE: ). Note how "page" becomes "pages" when the dash is added.

The same that has just been said about books also applies to TV and audios. In edition to {{{ed}}} and {{{chapt}}}, you can also add timestamps:

([[AUDIO]]: {{User:Bongolium500/cite source|The Boundless Sea (audio story)|timestamp=12:10}})

(AUDIO: )

([[AUDIO]]: {{User:Bongolium500/cite source|The Boundless Sea (audio story)|minute=12|second=2}})

(AUDIO: )

([[AUDIO]]: {{User:Bongolium500/cite source|The Boundless Sea (audio story)|hour=one}})

(AUDIO: )