Template:Infobox Story SMW/doc: Difference between revisions

From Tardis Wiki, the free Doctor Who reference
No edit summary
Tags: Mobile edit Mobile web edit
 
(18 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== Properties used ==
'''{{tlx|{{PAGENAME}}}}''' is an adapation of {{tlx|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 {{tlx|cite source}}. Therefore, this template is a '''requirement''' to use {{tlx|cite source}}. The data is also stored to [[T:SMW|Semantic MediaWiki]], providing the potential for it to be used elsewhere by other templates in the future.
* [[Property:Pagename]] - [[Special:Types/Text]]
* [[Property:Anthology]] - [[Special:Types/Page]]
* [[Property:Issues]] - [[Special:Types/Text]] (needs to be text due to potential edge cases that can occur with comics)
* [[Property:Season]] - already used in infobox
* [[Property:Range]] - already used in infobox
* [[Property:Audio series]] - already used in infobox
* [[Property:Writer]]
* [[Property:Publisher]] - already used in infobox
* [[Property:Release date]]
* [[Property:Series]] - [[Special:Types/Text]] (needs to be text due to the fact that the field that provides this property is free-form)
* [[Property:Novelisation of]] - [[Special:Types/Page]]
* [[Property:Adapted from]] - [[Special:Types/Page]]
* [[Property:Citation series]] - [[Special:Types/Text]] (needs to be text due to the fact that the field that provides this property is free-form)
* [[Property:Premiere network]]


== Differences in usage ==
== Usage ==
* Links should be removed from <nowiki>{{{anthology}}}</nowiki>, <nowiki>{{{audio anthology}}}</nowiki> and <nowiki>{{{network}}}</nowiki>.
This template is used almost identically to {{tlx|Infobox Story}} with a few important changes. If you're converting a page from using {{tlx|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 {{tlx|Infobox Story}} and then switch it over to this one with the steps below.
* Links should be removed from <nowiki>{{{writer}}}</nowiki>. If there are a multiple, a non-linking, comma separated list, should be used. Display text for each item can be specified using <nowiki>{{!}}</nowiki> between the page name and the display text. Simple dabs are automatically removed from the display.
* <nowiki>{{{publisher}}}</nowiki>, <nowiki>{{{publisher2}}}</nowiki> and <nowiki>{{{publisher3}}}</nowiki> should be merged into just <nowiki>{{{publisher}}}</nowiki> as a comma seperated list. This also means that more then 3 publishers can be specified. Display text can be specified using <nowiki>{{!}}</nowiki> between the page name and the display text. Simple dabs are automatically removed from the display.
* If a anything that would otherwise be in a one of the 2 comma seperated list detailed above contains a comma in it's page name or display text, <nowiki>{{{seperator}}}</nowiki> should be specified as a suitable seperator (such as ";") for both of the 2 lists. The separating commas in these lists should be changed to the new specified seperator.
* Links should be removed from '''all''' date fields (such as <nowiki>{{{release date}}}</nowiki> and <nowiki>{{{broadcast date}}}</nowiki>) in accordance with the documentation found at {{tlx|Date link}}.
* If <nowiki>{{{range}}}</nowiki>, <nowiki>{{{series in range}}}</nowiki> and <nowiki>{{{series}}}</nowiki> offer no suitable series for a citation or if the series is more complicated then can be entered into any of these fields (in the case where there are multiple series, for example), <nowiki>{{{citation series}}}</nowiki> should be set as an override. This field is not displayed in the infobox.


== Performance tests ==
* <tt>|writer=</tt> should be converted into an unlinked, comma separated list, if it is used. For example, "<tt><nowiki>|writer=[[Malorie Blackman]] and [[Chris Chibnall]]</nowiki></tt>" would become "<tt>|writer=Malorie Blackman, Chris Chibnall</tt>".
Values collected over 5 page previews from the parser profiling data dropdown.
** 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>|writer display=</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.
{| class="wikitable"
* <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.
! Page || {{tlx|Infobox Story}} || This infobox || Difference
* 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.
|[[Skywatch-7 (comic story)]]
* 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>".
|Average CPU time usage: 0.205s<br />Average real time usage: 0.234
* 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 <tt>|writer=</tt> only.
|0.233s<br />0.277s
* 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 <tt>|plural writer=</tt>, <tt>|plural publisher=</tt>, <tt>plural network=</tt>, etc. to any value.
| +0.072s<br />+0.043s
* 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 <tt>|writer display=</tt>, <tt>|publisher display=</tt>, <tt>|network display=</tt>, etc.
|}
** There is a depracated <tt>|contributors=</tt> that is the same as <tt>|writer display=</tt>, but that also sets <tt>|plural writer=</tt>. This is being phased out.
* Links and dab terms should be removed from all date fields (such as <tt>|release date=</tt> and <tt>|broadcast date=</tt>) that are used. For example, "<tt><nowiki>[[23 November (releases)|23 November]] - [[14 December (releases)|14 December]] [[1963 (releases)|1963]]</nowiki></tt>" would become "<tt>23 November - 14 December 1963</tt>". For more details, see the documentation at {{tlx|date link}}.
** If there are multiple dates or date ranges separated by commas or <tt><nowiki><br></nowiki></tt>s, or wrapped in {{tlx|il}}, split the field into multiple, numbered fields such as <tt>|release date=</tt>, <tt>|release date2=</tt>, <tt>|release date3=</tt>, etc. The same is true for other date fields (e.g. <tt>|broadcast date2=</tt>...). 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 <tt>|release date ref=</tt>, <tt>|broadcast date ref=</tt>, 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. <tt>|release date=</tt>, <tt>|broadcast date=</tt>, etc.) to the date to be saved to SMW and used for citations. Then, set <tt>|release date display=</tt> (or <tt>|broadcast date display=</tt>, 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 {{tlx|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 <tt>|range=</tt> or <tt>|series=</tt>, in that order of preference. If these fail to produce satisfactory text, custom series text can be set using <tt>|citation series=</tt>. This parameter is not displayed anywhere in the infobox: it's only used in {{tlx|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 <tt>|citation text=</tt>. This parameter is not displayed anywhere in the infobox, only in {{tlx|cite source}}. It can contain arbitrary wiki markup.


<noinclude>[[Category:Template documentation]]</noinclude>
<noinclude>[[Category:Template documentation]]</noinclude>

Latest revision as of 08:04, 13 April 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[[edit source]]

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[[edit source]]

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.