Template:Infobox Story SMW/doc: Difference between revisions

From Tardis Wiki, the free Doctor Who reference
Line 7: Line 7:
** In more complex scenarios, such as when parentheticals and/or footnotes are used, or if {{tlx|il}} is used, <tt>|writer=</tt> should be set as above, without links, parentheticals, footnotes or templates like {{tlx|il}}. In addition, <tt>|contributors=</tt> should be set with the old text of <tt>|writer=</tt>, including all parentheticals, footnotes, templates and links that were used. This parameter will be used as the display text.
** In more complex scenarios, such as when parentheticals and/or footnotes are used, or if {{tlx|il}} is used, <tt>|writer=</tt> should be set as above, without links, parentheticals, footnotes or templates like {{tlx|il}}. In addition, <tt>|contributors=</tt> should be set with the old text of <tt>|writer=</tt>, including all parentheticals, footnotes, templates and links that were used. This parameter will be used as the display text.
* <tt>|publisher=</tt>, <tt>|publisher2=</tt> and <tt>|publisher3=</tt> should be merged into <tt>|publisher=</tt> as an unlinked, comma separated list, if they are used.
* <tt>|publisher=</tt>, <tt>|publisher2=</tt> and <tt>|publisher3=</tt> should be merged into <tt>|publisher=</tt> as an unlinked, comma separated list, if they are used.
* Links should be removed from <tt>|anthology=</tt>, <tt>audio anthology=</tt> and <tt>|network=</tt>, if they are used. If there are multiple items for any of these fields, use a comma separated list.
* Links should be removed from <tt>|anthology=</tt>, <tt>|audio anthology=</tt> and <tt>|network=</tt>, if they are used. If there are multiple items for any of these fields, use a comma separated list.
* If any of the individual items (even if it is the only item) in <tt>|writer=</tt>, <tt>|publisher=</tt>, <tt>|anthology=</tt>, <tt>|audio anthology=</tt> or <tt>|network=</tt> contain a comma, set <tt>|separator=</tt> to some other suitable deliminator, such as "<tt>;</tt>", and replace all commas used for separating items in each of those fields with this new separator.
* If any of the individual items (even if it is the only item) in <tt>|writer=</tt>, <tt>|publisher=</tt>, <tt>|anthology=</tt>, <tt>|audio anthology=</tt> or <tt>|network=</tt> contain a comma, set <tt>|separator=</tt> to some other suitable deliminator, such as "<tt>;</tt>", and replace all commas used for separating items in each of those fields with this new separator.
* Simple [[T:DAB|dab terms]] are automatically removed from the display text of the unlinked fields mentioned so far. In more complex scenarios, custom display text can be specified by adding "<nowiki>{{!}}</nowiki>" after the unlinked page name, followed by the display text. Note that any pipes ("|") that appear in the display text should also be replaced with "<nowiki>{{!}}</nowiki>". For example, to produce [[2 entertain|2|entertain]], you would type "<tt><nowiki>2 entertain{{!}}2{{!}}entertain</nowiki></tt>".
* Simple [[T:DAB|dab terms]] are automatically removed from the display text of the unlinked fields mentioned so far. In more complex scenarios, custom display text can be specified by adding "<nowiki>{{!}}</nowiki>" after the unlinked page name, followed by the display text. Note that any pipes ("|") that appear in the display text should also be replaced with "<nowiki>{{!}}</nowiki>". For example, to produce [[2 entertain|2|entertain]], you would type "<tt><nowiki>2 entertain{{!}}2{{!}}entertain</nowiki></tt>".

Revision as of 20:49, 1 March 2024

{{Infobox Story SMW/doc}} is an adapation of {{Infobox Story}} that collects a large amount of additional data that can be accessed by other templates on other pages. One of the main things that this data is used for is to produce the additional information that forms the core of {{cite source}}. Therefore, this template is a requirement to use {{cite source}}. The data is also stored to Semantic MediaWiki, providing the potential for it to be used elsewhere by other templates in the future.

Usage

This template is used almost identically to {{Infobox Story}} with a few important changes. If you're converting a page from using {{Infobox Story}} to using this template, simply run through the steps below. If you're implementing this template on a new page, first setup this template like {{Infobox Story}} and then switch it over to this one with the steps below.

  • |writer= should be converted into an unlinked, comma separated list, if it is used. For example, "|writer=[[Malorie Blackman]] and [[Chris Chibnall]]" would become "|writer=Malorie Blackman, Chris Chibnall".
    • In more complex scenarios, such as when parentheticals and/or footnotes are used, or if {{il}} is used, |writer= should be set as above, without links, parentheticals, footnotes or templates like {{il}}. In addition, |contributors= should be set with the old text of |writer=, including all parentheticals, footnotes, templates and links that were used. This parameter will be used as the display text.
  • |publisher=, |publisher2= and |publisher3= should be merged into |publisher= as an unlinked, comma separated list, if they are used.
  • Links should be removed from |anthology=, |audio anthology= and |network=, if they are used. If there are multiple items for any of these fields, use a comma separated list.
  • If any of the individual items (even if it is the only item) in |writer=, |publisher=, |anthology=, |audio anthology= or |network= contain a comma, set |separator= to some other suitable deliminator, such as ";", and replace all commas used for separating items in each of those fields with this new separator.
  • Simple dab terms are automatically removed from the display text of the unlinked fields mentioned so far. In more complex scenarios, custom display text can be specified by adding "{{!}}" after the unlinked page name, followed by the display text. Note that any pipes ("|") that appear in the display text should also be replaced with "{{!}}". For example, to produce 2|entertain, you would type "2 entertain{{!}}2{{!}}entertain".
  • Links and dab terms should be removed from all date fields (such as |release date= and |broadcast date=) that are used. For example, "[[23 November (releases)|23 November]] - [[14 December (releases)|14 December]] [[1963 (releases)|1963]]" would become "23 November - 14 December 1963". For more details, see the documentation at {{date link}}.
    • If there are multiple dates or date ranges separated by commas or <br>s, or wrapped in {{il}}, split the field into multiple, numbered fields such as |release date=, |release date2=, |release date3=, etc. The same is true for other date fields (e.g. |broadcast date2=...).

Customising the additional information

As previously mentioned, data collected from this template is used to produce the additional information that forms the core of {{cite source}}. While this usually works fine without making any adjustments, sometimes it doesn't; in those cases, the additional information can be customised.

The source's series is normally taken from |range= or |series=, in that order of preference. If these fail to produce satisfactory text, custom series text can be set using |citation series=. This parameter is not displayed anywhere in the infobox: it's only used in {{cite source}}, and it can contain arbitrary wiki markup. Very common series overrides can be set globally to apply to all pages according to the documentation at Module:Cite source/series overrides.

The entire additional information text can be overridden fully using |citation text=. This parameter is not displayed anywhere in the infobox, only in {{cite source}}. It can contain arbitrary wiki markup.