Template:Infobox Documentary/doc: Difference between revisions

From Tardis Wiki, the free Doctor Who reference
no edit summary
No edit summary
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Infobox Doc
{{Infobox Doc
|image               = Image.jpg, automatically sized to 250px
|image                 = Image.jpg, automatically sized to 250px
|subject             = a brief summary of the subject of the documentary; you must give this variable a value
|series episode number = 0
|name               = name of documentary; if you don't put anything, it will default to the pagename (which usually is fine)
|subject               = a brief summary of the subject of the documentary; you must give this variable a value
|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")
|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")
|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
|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
|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
|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
|original to CD     = if the documentary debuted on an audio CD, put the name of that CD here
|original to CD       = ##{{!}}if the documentary debuted on an audio CD, put the name of that CD here
|original to web     = if the documentary debuted as a webcast, put the name of the website here
|original to web       = ##{{!}}if the documentary debuted as a webcast, put the name of the website here
|channel             = if the documentary debuted on broadcast radio or television, put the channel of first broadcast here
|channel               = ##{{!}}if the documentary debuted on broadcast radio or television, put the channel of first broadcast here
|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
|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
|home video         = if a documentary has been made available on home video, put the name of that video here
|home video           = ##{{!}}if a documentary has been made available on home video, put the name of that video here
|home audio         = if a documentary has been made available on home audio, put the name of the CD here
|home audio           = ##{{!}}if a documentary has been made available on home audio, put the name of the CD here
|catno               = catalogue number
|catno                 = catalogue number
|isbn               = ISBN number
|isbn                 = ISBN number
|narrator           = put the name of the credited narrator here
|narrator             = ##{{!}}put the name of the credited narrator here
|multiple narrators  = if there's more than one narrator, use this unlinked variable
|interviewer           = ##{{!}}put the name of any interviewers here
|interviewer         = put the name of any interviewers here
|interviewee           = put the names of the major interviewees here
|multiple interviewers = if there's more than one interviewer, use this unlinked variable
|uncredited narrator   = put the name of the uncredited narrator here
|interviewee         = put the names of the major interviewees here
|executive producer   = ##{{!}}put the name of the exec here
|uncredited narrator = put the name of the uncredited narrator here
|director             = ##{{!}}put the name of the director here
|executive producer = put the name of the exec here
|producer             = ##{{!}}put the name of the producer here
|multiple execs      = if multiple exec producers, use this unlinked variable instead
|writer               = ##{{!}}put the name of the writer here
|director           = put the name of the director here
|broadcast date       = if documentary was originally broadcast, put broadcast date here
|producer           = put the name of the producer here
|release date         = if documentary was originally published as a home video/audio, put release date here
|multiple producers  = if there's more than one producer, use this unlinked variable instead. 
|runtime               = put length of documentary here
|writer             = put the name of the writer here
|prev                 = ##{{!}}if part of a series, put previous entry here
|broadcast date     = if documentary was originally broadcast, put broadcast date here
|next                 = ##{{!}}if part of a series, put next entry here
|release date       = if documentary was originally published as a home video/audio, put release date here
|channel            = put original channel of broadcast 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
}}
}}
{{you may|Template:Infobox Con/doc|n1=the way to use this template with ''Confidential'' episodes}}
{{you may|Template:Infobox Con/doc|n1=the way to use this template with ''Confidential'' episodes}}
'''{{PAGENAME}}''' 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.
'''{{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.


== Auto-linking variables ==
== Auto-linking variables ==
Line 51: Line 46:
Broadcast and release date variables do not auto-link.  These dates must be entered as:
Broadcast and release date variables do not auto-link.  These dates must be entered as:
<pre>
<pre>
broadcast date=[[12th May]] [[2006]]
broadcast date=[[12 May (releases)|]] [[2006 (releases)|]]
</pre>
</pre>
=== Variables which can have multiple responses ===
In cases where more than one individual is expected by a variable, the variable is not auto-linking.  The most obvious example of this is the interviewee variable.  Almost every documentary has more than one interviewee, so this variable doesn't link.  It would be entered thus:
<pre>interviewee = [[David Tennant]], [[Catherine Tate]], [[Russell T Davies]]</pre>
There are a whole class of variables which ordinarily expect only one person, but which can, in special cases, take more than one.  For example, there's normally only one narrator on a project.  However, for those cases where there's more than one, you'd use the non-linking variable, "multiple narrators".  Here's a simple list.
{|align=center
!width=50%|Singular <br />''the template <br />links for you''
!width=50%|Plural<br />''you supply <br />the <nowiki>[[brackets]]</nowiki>
|-align=center
|narrator||multiple narrators
|-align=center
|producer||multiple producers
|-align=center
|executive producer||multiple execs
|-align=center
|interviewer||multiple interviewers
|-
|}
Also, the narrator, interviewer and interviewee variables are non-linking to allow for the entry of more than one person.  Likewise, the subject variable is free-form, as is the variable "original to web".
== 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).
Line 78: Line 53:
{{Infobox Doc
{{Infobox Doc
|image                =
|image                =
|series episode number =
|subject              =
|subject              =
|original to DVD      =
|original to DVD      =
Line 92: Line 68:
|narrator2            =
|narrator2            =
|narrator3            =
|narrator3            =
|narrator4            =
|narrator5            =
|narrator6            =
|narrator7            =
|narrator8            =
|narrator9            =
|narrator10            =
|uncredited narrator  =
|interviewer          =
|interviewer          =
|multiple interviewers =
|interviewer2          =
|interviewer3          =
|interviewer4          =
|interviewer5          =
|interviewer6          =
|interviewer7          =
|interviewer8          =
|interviewer9          =
|interviewer10        =
|interviewee          =
|interviewee          =
|uncredited narrator  =
|interviewee2          =
|interviewee3          =
|interviewee4          =
|interviewee5          =
|interviewee6          =
|interviewee7          =
|interviewee8          =
|interviewee9          =
|interviewee10        =
|director              =
|director              =
|director2            =
|director3            =
|director4            =
|director5            =
|director6            =
|director7            =
|director8            =
|director9            =
|director10            =
|producer              =
|producer              =
|multiple producers    =
|producer2            =
|producer3            =
|producer4            =
|producer5            =
|producer6            =
|producer7            =
|producer8            =
|producer9            =
|producer10            =
|executive producer    =
|executive producer    =
|multiple execs        =
|executive producer2  =
|executive producer3  =
|executive producer4  =
|executive producer5  =
|executive producer6  =
|executive producer7  =
|executive producer8  =
|executive producer9  =
|executive producer10  =
|writer                =
|writer                =
|writer2              =
|writer3              =
|writer4              =
|writer5              =
|writer6              =
|writer7              =
|writer8              =
|writer9              =
|writer10              =
|broadcast date        =
|broadcast date        =
|release date          =
|release date          =
Line 117: Line 151:
</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.  
 
=== Navigation ===
As with {[tl|Infobox Story}}, this template allows you to set multiple points of navigation.  This could allow you to set one navigation point as"''Black Orchid'' DVD documentaries'' and another as "''Stripped for Action''" — thus giving the Fifth Doctor's edition of ''Stripped for Action'' two points of navigation. 
====What if there is no navigation?====
If the documentary is completely standalone, you'll probably want to turn navigation off entirely, which can be done by adding this line to the infobox:
<pre>
|nav                  = 0
</pre>
 
====The next documentary is showing up in the previous column====
With pages that are about the first item in a series, chances are that the "next" item is showing up in the "previous" column.  To fix this, set <code>prev = none</code>.  Likewise, the last item in a series should have <code>next = none</code>.


To see this in operation, please click through to ''[[The Making of The Trial of a Time Lord: Part One - Mysterious Planet]]''.
== Video and Audio ==
{{Infobox video and audio variables}}
<noinclude>[[category:template documentation|{{PAGENAME}}]]</noinclude>
<noinclude>[[category:template documentation|{{PAGENAME}}]]</noinclude>
Cookies help us deliver our services. By using our services, you agree to our use of cookies.