Template:Infobox Documentary/doc: Difference between revisions

From Tardis Wiki, the free Doctor Who reference
No edit summary
No edit summary
 
(38 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{inuse}}
'''{{PAGENAME}}''' is a template that can be used for any documentary, whether audio or video, broadcast or DVD special feature.
{{Infobox Doc
{{Infobox Doc
|name            = name of documentary
|image                = Image.jpg, automatically sized to 250px
|original to DVD = if the documentary debuted on DVD, put the name of the DVD here; if a DW story, the name of the DVD is deemed to be the name of the story
|series episode number = 0
|original to VHS = if the documentary debuted on VHS, put the name of the DVD here; if a DW story, the name of the VHS is deemed to be the name of the story
|subject              = a brief summary of the subject of the documentary; you must give this variable a value
|original to CD = if the documentary debuted on an audio CD, put the name of that CD here
|series                = name of series of which documentary is a part — this might be a series on DVDs (like the "Stripped for Action" series) or might be a broadcast documentary series (like "On Show")
|channel         = if the documentary debuted on broadcast radio or television, put the channel of first broadcast here
|original to DVD       = ##{{!}}if the documentary debuted on DVD, put the name of the DVD here; if a DW story, the name of the DVD is deemed to be the name of the story
|broadcast with = if the documentary debuted alongside another broadcast (as in the intermission of a ''Doctor Who at the Proms'' concert) name the "parent" programme here
|original to VHS       = ##{{!}}if the documentary debuted on VHS, put the name of the DVD here; if a DW story, the name of the VHS is deemed to be the name of the story
|home video     =
|original to CD       = ##{{!}}if the documentary debuted on an audio CD, put the name of that CD here
|home audio     =
|original to web      = ##{{!}}if the documentary debuted as a webcast, put the name of the website here
|narrator       =
|channel               = ##{{!}}if the documentary debuted on broadcast radio or television, put the channel of first broadcast here
|interviewer     =
|broadcast with       = ##{{!}}if the documentary debuted alongside another broadcast (as in the intermission of a ''Doctor Who at the Proms'' concert) name the "parent" programme here
|interviewee     =
|home video           = ##{{!}}if a documentary has been made available on home video, put the name of that video here
|uncredited narrator =
|home audio           = ##{{!}}if a documentary has been made available on home audio, put the name of the CD here
|director       =
|catno                = catalogue number
|producer       =
|isbn                  = ISBN number
|broadcast date =
|narrator             = ##{{!}}put the name of the credited narrator here
|release date   =
|interviewer           = ##{{!}}put the name of any interviewers here
|channel        =
|interviewee           = put the names of the major interviewees here
|runtime        =
|uncredited narrator   = put the name of the uncredited narrator here
|previous       =
|executive producer    = ##{{!}}put the name of the exec here
|next           =
|director             = ##{{!}}put the name of the director here
|producer             = ##{{!}}put the name of the producer here
|writer                = ##{{!}}put the name of the writer here
|broadcast date       = if documentary was originally broadcast, put broadcast date here
|release date         = if documentary was originally published as a home video/audio, put release date here
|runtime              = put length of documentary here
|prev                  = ##{{!}}if part of a series, put previous entry here
|next                 = ##{{!}}if part of a series, put next entry here
}}
}}
{{Infobox Con
{{you may|Template:Infobox Con/doc|n1=the way to use this template with ''Confidential'' episodes}}
|episode name      = Episode name (please consult [[List of Doctor Who Confidential episodes]] for this wikia's name for episodes that were technically untitled)
'''{{tlx|Infobox Documentary}}''', or '''{{tlx|Infobox Doc}}''', is a template that can be used for any documentary, whether audio or video, broadcast or DVD special feature.  Because it is a multi-media template, no single page will use all the variables the template enables. Please use the template to include information primarily about the '''original public form of the documentary'''.  However, if a documentary once available elsewhere has since been repurposed for a home audio or video release, the infobox does allow you to list details about the secondary (and in most cases, more well-known) home for the documentary.
|image          = Image from the episode at 250px; only include the file name (e.g. [[Pic.jpg]]); the template will take care of the rest
 
|series number  = Enter only the ''numeral'' of the series involved. 
== Auto-linking variables ==
|broadcast with      = related ''Doctor Who'' episode; if none, use the exact phrase "none" (minus the quotation marks)
Note that many of this template's variables are fully self-linking.  Thus, to indicate that [[Alex Price]] was the narrator of an episode, you would enter simply:
|narrator        = narrator of episode; if none, use the exact phrase "none" (minus the quotation marks)
|uncredited narrator = This variable is really only for the episode "[[Do You Remember the First Time?]]"
|director        = Director of the episode
|producer        = Producer of the episode
|broadcast date  = Original broadcast date
|channel= You should only define this variable if the episode originally debuts on a channel other than [[BBC Three]]
|runtime          = Runtime of episode
|previous  = previous episode
|next      = next episode
}}'''{{PAGENAME}}''' is to be used on pages describing individual episodes of ''[[Doctor Who Confidential]]''.   
==Auto-linking variables==
Note that this template's variables are fully self-linking.  Thus, to indicate that [[Alex Price]] was the narrator of an episode, you would enter simply:
<pre>
<pre>
narrator=Alex Price
narrator=Alex Price
Line 48: Line 40:
narrator=[[Alex Price]]
narrator=[[Alex Price]]
</pre>
</pre>
 
If you look in the sample infobox to your right, all the variables whose values are in red are auto-linking variables. All the ones in black require you to manually type in the <nowiki>[[brackets]]</nowiki> yourself.
The only variable which does not currently self link is that for the broadcast date.   These dates must be entered as:
== Non-linking variables ==
<pre>
There are, however, some cases where you must still put the brackets in yourself.
broadcast date=[[12th May]] [[2006]]
=== Dates ===
</pre>
Broadcast and release date variables do not auto-linkThese dates must be entered as:
 
===Special note about series number variable===
The '''series number''' variable is very easy to useSimply enter
<pre>
<pre>
series number=1
broadcast date=[[12 May (releases)|]] [[2006 (releases)|]]
</pre>
</pre>
and the template will auto link to [[Series 1 (Doctor Who)]].  (It is not currently anticipated that there will ever be pages on the individual series of ''Confidential''.) However, please note that series 4 includes everything from the episode having to do with ''[[Time Crash]]'' to the ones having to do with ''[[The End of Time (TV story)]]''.  ''Doctor Who Confidential'' is a behind-the-scenes programme and therefore '''the production perception of series numbering should predominate''' over the marketing/public perception.
== Usage ==
 
==Usage==
Copy and paste '''all''' of the text below onto whichever article page it is needed for (even if some fields are not needed, copy '''all''' of the text).
Copy and paste '''all''' of the text below onto whichever article page it is needed for (even if some fields are not needed, copy '''all''' of the text).
<pre>
<pre>
{{Infobox Doc
{{Infobox Doc
|name            =
|image                =
|original to DVD =
|series episode number =
|original to VHS =
|subject              =
|original to CD =
|original to DVD       =
|channel         =
|original to VHS       =
|broadcast with =
|original to CD       =
|home video     =
|original to web      =
|home audio     =
|channel               =
|narrator       =
|broadcast with       =
|interviewer     =
|home video           =
|interviewee     =
|home audio           =
|uncredited narrator =
|catno                =
|director       =
|isbn                  =
|producer       =
|narrator              =
|broadcast date =
|narrator2            =
|release date   =
|narrator3            =
|channel        =
|narrator4            =
|runtime        =
|narrator5            =
|previous        =
|narrator6            =
|next           =
|narrator7            =
|narrator8            =
|narrator9            =
|narrator10            =
|uncredited narrator   =
|interviewer           =
|interviewer2          =
|interviewer3          =
|interviewer4          =
|interviewer5          =
|interviewer6          =
|interviewer7          =
|interviewer8          =
|interviewer9          =
|interviewer10        =
|interviewee           =
|interviewee2          =
|interviewee3          =
|interviewee4          =
|interviewee5          =
|interviewee6          =
|interviewee7          =
|interviewee8          =
|interviewee9          =
|interviewee10        =
|director             =
|director2            =
|director3            =
|director4            =
|director5            =
|director6            =
|director7            =
|director8            =
|director9            =
|director10            =
|producer              =
|producer2            =
|producer3            =
|producer4            =
|producer5            =
|producer6            =
|producer7            =
|producer8            =
|producer9            =
|producer10            =
|executive producer   =
|executive producer2  =
|executive producer3  =
|executive producer4  =
|executive producer5  =
|executive producer6  =
|executive producer7  =
|executive producer8  =
|executive producer9  =
|executive producer10  =
|writer                =
|writer2              =
|writer3              =
|writer4              =
|writer5              =
|writer6              =
|writer7              =
|writer8              =
|writer9              =
|writer10              =
|broadcast date       =
|release date         =
|runtime              =
|series                =
|prev                  =
|next                 =
|series2              =
|prev2                =
|next2                =
|series3              =
|prev3                =
|next3                =
}}
}}
</pre>
</pre>


The sample output at right gives a description of what each of the fields are for. Due to the auto-linking nature of the template, some of the text may be slightly obscured by stray coding elements.
The sample output at right gives a description of what each of the fields are for.  
 
== Video and Audio ==
{{Infobox video and audio variables}}
<noinclude>[[category:template documentation|{{PAGENAME}}]]</noinclude>

Latest revision as of 20:28, 20 July 2023

{{Infobox Documentary}}, or {{Infobox Doc}}, is a template that can be used for any documentary, whether audio or video, broadcast or DVD special feature. Because it is a multi-media template, no single page will use all the variables the template enables. Please use the template to include information primarily about the original public form of the documentary. However, if a documentary once available elsewhere has since been repurposed for a home audio or video release, the infobox does allow you to list details about the secondary (and in most cases, more well-known) home for the documentary.

Auto-linking variables

Note that many of this template's variables are fully self-linking. Thus, to indicate that Alex Price was the narrator of an episode, you would enter simply:

narrator=Alex Price

not

narrator=[[Alex Price]]

If you look in the sample infobox to your right, all the variables whose values are in red are auto-linking variables. All the ones in black require you to manually type in the [[brackets]] yourself.

Non-linking variables

There are, however, some cases where you must still put the brackets in yourself.

Dates

Broadcast and release date variables do not auto-link. These dates must be entered as:

broadcast date=[[12 May (releases)|]] [[2006 (releases)|]]

Usage

Copy and paste all of the text below onto whichever article page it is needed for (even if some fields are not needed, copy all of the text).

{{Infobox Doc
|image                 =
|series episode number = 
|subject               =
|original to DVD       =
|original to VHS       =
|original to CD        =
|original to web       =
|channel               =
|broadcast with        =
|home video            =
|home audio            =
|catno                 =
|isbn                  =
|narrator              =
|narrator2             =
|narrator3             =
|narrator4             =
|narrator5             =
|narrator6             =
|narrator7             =
|narrator8             =
|narrator9             =
|narrator10            =
|uncredited narrator   =
|interviewer           =
|interviewer2          =
|interviewer3          =
|interviewer4          =
|interviewer5          =
|interviewer6          =
|interviewer7          =
|interviewer8          =
|interviewer9          =
|interviewer10         =
|interviewee           =
|interviewee2          =
|interviewee3          =
|interviewee4          =
|interviewee5          =
|interviewee6          =
|interviewee7          =
|interviewee8          =
|interviewee9          =
|interviewee10         =
|director              =
|director2             =
|director3             =
|director4             =
|director5             =
|director6             =
|director7             =
|director8             =
|director9             =
|director10            =
|producer              =
|producer2             =
|producer3             =
|producer4             =
|producer5             =
|producer6             =
|producer7             =
|producer8             =
|producer9             =
|producer10            =
|executive producer    =
|executive producer2   =
|executive producer3   =
|executive producer4   =
|executive producer5   =
|executive producer6   =
|executive producer7   =
|executive producer8   =
|executive producer9   =
|executive producer10  =
|writer                =
|writer2               =
|writer3               =
|writer4               =
|writer5               =
|writer6               =
|writer7               =
|writer8               =
|writer9               =
|writer10              =
|broadcast date        =
|release date          =
|runtime               =
|series                =
|prev                  =
|next                  =
|series2               =
|prev2                 =
|next2                 =
|series3               =
|prev3                 =
|next3                 =
}}

The sample output at right gives a description of what each of the fields are for.

Video and Audio

At Tardis, we have a fairly sophisticated system of integrating audio and video content into our infoboxes. Almost every infoboxes has the same set of variables, though the header attached to them may change depending on the infobox. For instance, the headers for {{Infobox Company}} and {{Infobox Person}} are slightly different from the rest, because these infoboxes are about the companies and crewmembers that make DWU stories. Nevertheless, the variable names remain largely the same.

Note that videos must be uploaded to this wiki locally, and that only admin can upload them. If you wish to request an upload, please do so at the video recommendation page.

Due to the fact that ogg audio doesn't play on iOS devices, some OS X browsers, and the Fandom Doctor Who app, audios must be from Soundcloud -- and Soundcloud only.

Though there are a few exceptions, most of the following variables are available for your use in every infobox.

|trailer            = usually entitled "Official trailer"
|trailer2           = usually, "Another official trailer"
|clip               = "Memorable moment", but can be value of {{{clip name}}}
|clip2              = "Another memorable moment", but can be {{{clip name2}}}
|clip3              = "One more memorable moment", but can be {{{clip name3}}}
|fullvid            = "Full video", but can be {{{fullvid name}}}
|bts                = "Behind the scenes video", but can be {{{bts name}}}
|bts2               = "More behind the scenes stuff", but can be {{{bts2 name}}}
|bts3               = "Another behind the scenes moment", but can be {{{bts3 name}}}
|soundcloudtrailer  = usually, "Official audio trailer"
|soundcloudtrailer2 = usually, "Another official audio trailer"
|musicsuite         = "Music suite"
|sample             = "Music sample"
|soundcloudbts      = "Behind the scenes interview"
|audio commentary   = "Audio commentary"
|fullaud            = "Full audio"
|leitmotif          = "Leitmotif"

You can use the following blanked-out version to copy and paste onto a page, if the above instructions for this specific infobox don't already contain this bit.

|trailer            = 
|trailer2           = 
|clip               = 
|clip2              = 
|clip3              = 
|fullvid            = 
|bts                = 
|bts2               = 
|bts3               = 
|soundcloudtrailer  = 
|soundcloudtrailer2 = 
|musicsuite         = 
|sample             = 
|soundcloudbts      = 
|audio commentary   = 
|fullaud            = 
|leitmotif          =