Template:Film/doc: Difference between revisions

Boobpedia - Encyclopedia of big boobs
Jump to navigationJump to search
(New page: {{Documentation subpage}} <!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE --> The {{tl|film}} template is a metatemplate that uses the information stored in [[:Catego...)
 
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 21: Line 21:
* <code><nowiki>{{film|Non-existing film|year=1|director=1}}</nowiki></code> gives {{film|Non-existing film|year=1|director=1}}.
* <code><nowiki>{{film|Non-existing film|year=1|director=1}}</nowiki></code> gives {{film|Non-existing film|year=1|director=1}}.


If a template for "Non-existing film" will be created some day, the full data will be displayed like in the above examples.
If a template for "Non-existing film" is created some day, the full data will be displayed like in the above examples.{{Filmography start/doc}}== Infobox (style = infobox) ==
;Usage
To display an infobox for a film, set the '''style''' parameter to ''infobox''. If used with the infobox style, the template should only be placed at the very top of an article - just where you would normally write the code for the infobox.


== Filmography ==
You will never have to edit the infobox on your article page. As soon as the data in the film's template is changed, you article will display the new data in the infobox.


=== Simple filmography entry (style = list) ===
;Example
* To use {{tl|{{PAGENAME}}}} as a simple filmography entry, set the '''style''' parameter to ''list''.
<code><nowiki>{{film|Supervixens|style=infobox}}</nowiki></code>
* The style of {{tl|filmography start}} defaults to ''list'', so it is not necessary to set it explicitly.


<code><nowiki>{{filmography start}}</nowiki><br><nowiki>
creates an infobox for [[Supervixens]] on your page.
{{film|</nowiki>{{PAGENAME}}<nowiki>|style=list}}</nowiki><br><nowiki>
{{filmography end}}</nowiki></code>


<includeonly>{{filmography start}}
== Changing film data ==
{{film|{{PAGENAME}}|style=list}}
Please note that {{tl|film}} does '''not''' store any information about a single film itself. It is only a metatemplate that uses the specific container templates to display the desired data.
{{filmography end}}</includeonly>


=== Full filmography entry (style = listfull) ===
If you want to change the data of a film (for example if you want to add a person to the cast), go to the film's own data container template and change it.
* To use {{tl|{{PAGENAME}}}} as a full filmography entry, set the '''style''' parameter to ''listfull'' (adds the "Director" and "Starring" column).
* Do not forget to set the style parameter of {{tl|filmography start}} to ''listfull'' too.
 
<code><nowiki>{{filmography start|style=listfull}}</nowiki><br><nowiki>
{{film|</nowiki>{{PAGENAME}}<nowiki>|style=listfull}}</nowiki><br><nowiki>
{{filmography end}}</nowiki></code>
 
<includeonly>{{filmography start|style=listfull}}
{{film|{{PAGENAME}}|style=listfull}}
{{filmography end}}</includeonly>
 
 
=== Infobox (style = infobox) ===
* To display {{tl|{{PAGENAME}}}} as an infobox, set the '''style''' parameter to ''infobox''.
 
<code><nowiki>{{film|</nowiki>{{PAGENAME}}<nowiki>|style=infobox}}</nowiki></code>
 
 
 
 
 
 
In the simplest case, the template only displays the person's name as if you wrote it in plain text. But is has several extra featues. It
 
* automatically displays a link to the person's article if this article exists,
* displays only normal text if the person does not have an article yet, but will automatically turn into a link if such an article is created,
* automatically displays further information on the person (website link, location) if you activate this feature,
* automatically displays new personal data in your article if it changes (e.&nbsp;g. new website) so that you will never have to rewrite your article,
* automatically adds a category to the article the person is mentioned in, so that your model or actress is listed on the person's page,
* offers the possibility to suppress the category addition to an article,
* displays an error if you do not specify a name.
 
=== Syntax ===
<nowiki>{{</nowiki>photographer|''&lt;name&gt;''|link=''&lt;text&gt;''|location=''&lt;text&gt;''|nocategory=''&lt;text&gt;''}}
 
<code>'''''<name>'''''</code>
* Text. The name of the person.
* Required.
* Please note that this parameter has no name. Simply type the person's name '''without''' a parameter name.
 
<code>'''link'''</code>
* Any text. You can use "1", "y" or whatever you like. As soon as the parameter has any content, the home page link is displayed.
* Optional. <code>''&lt;text&gt;''</code> or the whole parameter <code>link=''&lt;text&gt;''</code> can be omitted.
 
<code>'''location'''</code>
* Any text. You can use "1", "y" or whatever you like. As soon as the parameter has any content, the location is displayed.
* Optional. <code>''&lt;text&gt;''</code> or the whole parameter <code>location=''&lt;text&gt;''</code> can be omitted.
 
<code>'''nocategory'''</code>
* Any text. You can use "1", "y" or whatever you like. As soon as the parameter has any content, no category is added to your article.
* Optional. <code>''&lt;text&gt;''</code> or the whole parameter <code>nocategory=''&lt;text&gt;''</code> can be omitted.
* '''Important:''' It is highly recommended that you '''always''' specify this parameter on pages that are '''not''' model articles (e.&nbsp;g. on a photographer page: ''"His work was influenced by <nowiki>{{photographer|Steve Diet Goedde|</nowiki>'''nocategory=1'''}}."''). Otherwise the photographer would be listed as a big bust model on {{photographer|Steve Diet Goedde|nocategory=1}}'s page.
* '''Important:''' You should also specify this parameter if you mention a person on the page of a model that has '''not''' worked with him, but is otherwise related to him (e.&nbsp;g. ''"At Glamourcon 42 she was seen together with photographer <nowiki>{{photographer|XY|</nowiki>'''nocategory=1'''}}."''). Otherwise she would be listed on XY's page as if she had worked with him.
 
=== Examples ===
; Article exists
* <code><nowiki>{{photographer|Gil Perron}}</nowiki></code> gives {{photographer|Gil Perron|nocategory=1}}.
* <code><nowiki>{{photographer|Gil Perron|link=1}}</nowiki></code> gives {{photographer|Gil Perron|link=1|nocategory=1}}.
* <code><nowiki>{{photographer|Gil Perron|link=ok|location=y}}</nowiki></code> gives {{photographer|Gil Perron|link=ok|location=y|nocategory=1}}.
* <code><nowiki>{{photographer|Gil Perron|location=yes}}</nowiki></code> gives {{photographer|Gil Perron|location=yes|nocategory=1}}.
 
; Article does not exist
* <code><nowiki>{{photographer|The Honorable|link=1|location=1}}</nowiki></code> gives {{photographer|The Honorable|link=1|location=1|nocategory=1}}.
 
; Required and optional parameters
* <code><nowiki>{{photographer|link=1|location=1}}</nowiki></code> gives {{photographer|link=1|location=1|nocategory=1}}.
 
=== Usability ===
There are no restrictions. The template can be used anywhere within the text of an article.
 
You should, however, be aware that the layout of your text may change in an undesirable way if you specify all parameters for a person who does not have a page yet. The simple sentence
 
: <code><nowiki>{{director|Hexvoodoo|link=1|location=1}}</nowiki> always wanted to start a career as a director.</code>
: "Hexvoodoo always wanted to start a career as a director."
 
can become
 
: "[[user:Hexvoodoo|Hexvoodoo]] ([http://www.boobpedia.com home page]), Boobtown, Boobland always wanted to start a career as a director."
 
if he really gets his own director page some day. :-)
 
== Header ==
=== Functionality ===
If used as a header, the template shows a typical category header with the person's data in it, along with existing sister categories associated with this person. Categories displayed:
* '''models''' (for photographers)
* '''actresses''' (for directors)
* '''films''' (for directors)
* '''photos''' (for photographers)
* '''fashion''' (for fashion designers)
* '''sculptures''' (for sculptors)
* '''paintings''' (for painters)
 
=== Syntax ===
<nowiki>{{</nowiki>photographer|''&lt;name&gt;''|header=''&lt;text&gt;''}}
 
<code>'''''<name>'''''</code>
* Text. The name of the person.
* Required.
* Please note that this parameter has no name. Simply type the person's name '''without''' a parameter name.
 
<code>'''header'''</code>
* Any text. You can use "1", "y" or whatever you like. As soon as the parameter has any content, a category header will be displayed instead of the inline text.
* Required (if a header is to be displayed).
 
All other parameters are ignored. The '''nocategory''' parameter is not necessary; a category will not be added to the page the template is used on as a header.
 
=== Examples ===
* <code><nowiki>{{photographer|Gil Perron|header=1}}</nowiki></code> gives
 
{{photographer|Gil Perron|header=1}}.
 
=== Usability ===
If used as a header, the template should only be added at the top of category pages.
 
== Changing a person's data ==
Please note that this template itself does '''not''' store any information about a single person. It is only a metatemplate that uses the specific data container templates to display the desired data.
 
If you want to change the data of a person (for example when his website has changed), go to the person's own data container template and change it.


;Example:
;Example:
To change {{photographer|Gil Perron|nocategory=1}}'s website,
To change data of {{film|Supervixens}},
* go to {{cl|Data container templates}}, then {{cl|Photographer templates}};
* go to {{cl|Film templates}};
* choose Gil Perron's template and click on the '''edit''' tab;
* choose Template:Supervixens and click on the '''edit''' tab;
* follow the instructions given in the section '''If you want to change the photographer's data:'''.
* follow the instructions given in the section '''If you want to change film data:'''.


== See also ==
== See also ==

Latest revision as of 14:16, 3 August 2008

This is a documentation subpage for Template:Film (see that page for the template itself).
It contains usage information, categories and other content that is not part of the original template page.

The {{Film}} template is a metatemplate that uses the information stored in film templates. It can use different styles to

  • display a film name and additional information inline,
  • display an entry in a filmography,
  • display a whole infobox for the film.

For a guide how to create a film template so that you can use it together with {{Film}}, see Boobpedia:New film.

Inline

Usage

To mention a film in an article's text, use {{Film}} without the style parameter. You can set year and/or director to display additional data. There are no restrictions to the use of the inline style. The template can be placed anywhere within the text of an article.

Examples

Non-existing film:

  • {{film|Non-existing film|year=1|director=1}} gives Non-existing film.

If a template for "Non-existing film" is created some day, the full data will be displayed like in the above examples.

This is a documentation subpage for Template:Film (see that page for the template itself).
It contains usage information, categories and other content that is not part of the original template page.

Filmography

Together with the {{Film}} template, {{Filmography start}} and {{Filmography end}} can be used to create filmographies with a unified layout and format.

Simple filmography (style = list)

Usage

To create a simple filmography without "Director" and "Starring" columns,

  • {{Filmography start}}: do nothing. The default style is list, so no style parameter is needed,
  • {{Film}}: set the style parameter to list.
Example

{{filmography start}}
{{film|Supervixens|style=list}}
{{filmography end}}

gives

Title Released Company Notes
Supervixens April 2, 1975


Full filmography (style = listfull)

Usage

To create a full filmography including "Director" and "Starring" columns,

  • {{Filmography start}}: set the style parameter to listfull,
  • {{Film}}: set the style parameter to listfull.
Example

{{filmography start|style=listfull}}
{{film|Supervixens|style=listfull}}
{{filmography end}}

gives

Title Released Company Director Starring Notes
Supervixens April 2, 1975 Russ Meyer Ann Marie, Christy Hartburg, Deborah McGuire, Shari Eubank, Sharon Kelly, Uschi Digard


Creating filmographies without film templates

You may want to use the predefined filmography style without having to create a template for each single film. You can do so by specifying the parameters manually.

Example

{{filmography start|style=listfull}}
{{film|Example film|style=listfull|image=NoImageAvailable.png|released=[[March 19]], [[2008]]|company=Boobpedia films|starring=Actress|director=Director|notes=Notes}}
{{filmography end}}

gives

Title Released Company Director Starring Notes
Example film March 19, 2008 Boobpedia films Director Actress Notes


As soon as a template is created for "Example film" some day, the title will turn into a link and all data you specified manually will be overridden by the data of the new film template. So even if a film template did not exist at the time you wrote the filmography, you will not have to edit your filmography later. It will automatically import the data from the film template.

Infobox (style = infobox)

Usage

To display an infobox for a film, set the style parameter to infobox. If used with the infobox style, the template should only be placed at the very top of an article - just where you would normally write the code for the infobox.

You will never have to edit the infobox on your article page. As soon as the data in the film's template is changed, you article will display the new data in the infobox.

Example

{{film|Supervixens|style=infobox}}

creates an infobox for Supervixens on your page.

Changing film data

Please note that {{Film}} does not store any information about a single film itself. It is only a metatemplate that uses the specific container templates to display the desired data.

If you want to change the data of a film (for example if you want to add a person to the cast), go to the film's own data container template and change it.

Example

To change data of Supervixens,

  • go to Category:Film templates;
  • choose Template:Supervixens and click on the edit tab;
  • follow the instructions given in the section If you want to change film data:.

See also