Template:Cite source: Difference between revisions

From Tardis Wiki, the free Doctor Who reference
Line 56: Line 56:


=== Video and audio sources ===
=== 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, although, if you use <tt>|hour=</tt> and <tt>|second=</tt>, you should also use <tt>|minute=</tt>. For example, to cite the timestamp 34 minutes and 2 second of ''[[Rose (TV story)|Rose]]'', you would type:<pre>([[TV]]: {{User:Bongolium500/cite source|Rose (TV story)|minute=34|second=2}})</pre>This produces:
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, although, if you use <tt>|hour=</tt> and <tt>|second=</tt>, you should also use <tt>|minute=</tt>. For example, to cite the timestamp 34 minutes and 2 second of ''[[Rosa (TV story)|Rosa]]'', you would type:<pre>([[TV]]: {{User:Bongolium500/cite source|Rosa (TV story)|minute=34|second=2}})</pre>This produces:
:([[TV]]: {{User:Bongolium500/cite source|Rose (TV story)|minute=34|second=2}})
:([[TV]]: {{User:Bongolium500/cite source|Rosa (TV story)|minute=34|second=2}})


You can also define entirely custom timestamps using <tt>|timestamp=</tt>. For example, to cite the timestamp 26:54 of ''[[The Boundless Sea (audio story)|The Boundless Sea]]'', you would type:<pre>([[AUDIO]]: {{User:Bongolium500/cite source|The Boundless Sea (audio story)|timestamp=26:54}})</pre>This produces:
You can also define entirely custom timestamps using <tt>|timestamp=</tt>. For example, to cite the timestamp 26:54 of ''[[The Boundless Sea (audio story)|The Boundless Sea]]'', you would type:<pre>([[AUDIO]]: {{User:Bongolium500/cite source|The Boundless Sea (audio story)|timestamp=26:54}})</pre>This produces:
:([[AUDIO]]: {{User:Bongolium500/cite source|The Boundless Sea (audio story)|timestamp=26:54}})
:([[AUDIO]]: {{User:Bongolium500/cite source|The Boundless Sea (audio story)|timestamp=26:54}})


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 [[#Citing variants|variants]].  
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 [[#Citing variants|variants]].


=== Custom precise citation text ===
=== Custom precise citation text ===

Revision as of 20:14, 18 February 2023

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: Script error: No such module "Bongolium500/story cite".)

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: Script error: No such module "Bongolium500/story cite".)

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.

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: Script error: No such module "Bongolium500/story cite".)

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: Script error: No such module "Bongolium500/story cite".)

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: Script error: No such module "Bongolium500/story cite".)

|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: Script error: No such module "Bongolium500/story cite".)

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: Script error: No such module "Bongolium500/story cite".)

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: Script error: No such module "Bongolium500/story cite".)

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: Script error: No such module "Bongolium500/story cite".)

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: Script error: No such module "Bongolium500/story cite".)

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: Script error: No such module "Bongolium500/story cite".)

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: Script error: No such module "Bongolium500/story cite".)

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 discusses in the prior two sections, you can define entirely custom precise citation text using the |precisecite= parameter.

Customising the additional information

to be added

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: Script error: No such module "Bongolium500/story cite".). Here is another example:

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

It produces (PROSE: Script error: No such module "Bongolium500/story cite".). 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: Script error: No such module "Bongolium500/story cite".). 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: Script error: No such module "Bongolium500/story cite".). 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: Script error: No such module "Bongolium500/story cite".). 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: Script error: No such module "Bongolium500/story cite".)

(TV: Script error: No such module "Bongolium500/story cite".)

(TV: Script error: No such module "Bongolium500/story cite".)

You can also cite parts with variants:

(TV: Script error: No such module "Bongolium500/story cite".)

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: Script error: No such module "Bongolium500/story cite".).

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

This produces (PROSE: Script error: No such module "Bongolium500/story cite".).

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

This produces (PROSE: Script error: No such module "Bongolium500/story cite".). 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: Script error: No such module "Bongolium500/story cite".)

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

(AUDIO: Script error: No such module "Bongolium500/story cite".)

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

(AUDIO: Script error: No such module "Bongolium500/story cite".)