Template:Infobox Story SMW/doc

{{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, |writer display= 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".
• Including the text "unknown", "various" or "unclear" as one of the things listed in these comma-separated fields will cause that thing to not be autolinked. That allows for arbitrary wiki markup to be used, as long as one of these phrases are present. Additionally, "see authorship" has the same behaviour for |writer= only.
• If these fields are detected to contain commas, their label will automatically be pluralised. You can force these labels to be pluralised by setting fields like |plural writer=, |plural publisher=, plural network=, etc. to any value.
• For scenarios that are too complicated to represent with one of the above fields, set the problematic field to the text that should be saved to SMW and used in citations. Then, set the display text with a field like |writer display=, |publisher display=, |network display=, etc.
  • There is a depracated |contributors= that is the same as |writer display=, but that also sets |plural writer=. This is being phased out.
• 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=...). Note that only the original, un-numbered, field is saved to SMW and used in citations.
  • If the date is accompanied by a citation, you can add that by using |release date ref=, |broadcast date ref=, etc. This will add the contents of that field to the end of the date, or list of dates if multiple numbered fields are used.
  • For scenarios too complicated to represent with the above fields, set the primary date field (e.g. |release date=, |broadcast date=, etc.) to the date to be saved to SMW and used for citations. Then, set |release date display= (or |broadcast date display=, etc.) to the display text for the infobox.

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.