Template:Cite source: Difference between revisions

From Tardis Wiki, the free Doctor Who reference
Line 28: Line 28:
Unamed parts are cited in a very similar way: <tt><nowiki>{{</nowiki>{{PAGENAME}}|source's page name|part=part number}}</tt>. 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.  
Unamed parts are cited in a very similar way: <tt><nowiki>{{</nowiki>{{PAGENAME}}|source's page name|part=part number}}</tt>. 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 <tt>|sect=</tt> parameter. For example, to cite part 2 of ''[[The Klepton Parasites (comic story)|The Klepton Parasites]]'' which has the section title "Part Two: 16th November 1964", you would type:<pre>([[COMIC]]: {{User:Bongolium500/cite source|The Klepton Parasites (comic story)|part=One|sect=Part Two: 16th November 1964}})</pre>This produces:
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 <tt>|sect=</tt> parameter. For example, to cite part 2 of ''[[The Klepton Parasites (comic story)|The Klepton Parasites]]'' which has the section title "Part Two: 16th November 1964", you would type:<pre>([[COMIC]]: {{User:Bongolium500/cite source|The Klepton Parasites (comic story)|part=Two|sect=Part Two: 16th November 1964}})</pre>This produces:
: ([[COMIC]]: {{User:Bongolium500/cite source|The Klepton Parasites (comic story)|part=One|sect=Part Two: 16th November 1964}})
: ([[COMIC]]: {{User:Bongolium500/cite source|The Klepton Parasites (comic story)|part=Two|sect=Part Two: 16th November 1964}})


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

Revision as of 18:47, 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

to be added

Precise citations

to be added

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".)