Template:Film/doc
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
{{film|Supervixens}}gives Supervixens.{{film|Supervixens|year=1}}gives Supervixens (1975).{{film|Supervixens|director=1}}gives Supervixens (Russ Meyer).{{film|Supervixens|year=1|director=1}}gives Supervixens (Russ Meyer, 1975).
Non-existing film:
{{film|Non-existing film|year=1|director=1}}gives Non-existing film.
If a template for "Non-existing film" will be created some day, the full data will be displayed like in the above examples.
Filmography
Simple filmography entry (style = list)
- To use {{Film/doc}} as a simple filmography entry, set the style parameter to list.
- The style of {{Filmography start}} defaults to list, so it is not necessary to set it explicitly.
{{filmography start}}
{{film|Film/doc|style=list}}
{{filmography end}}
Full filmography entry (style = listfull)
- To use {{Film/doc}} 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 {{Filmography start}} to listfull too.
{{filmography start|style=listfull}}
{{film|Film/doc|style=listfull}}
{{filmography end}}
Infobox (style = infobox)
- To display {{Film/doc}} as an infobox, set the style parameter to infobox.
{{film|Film/doc|style=infobox}}
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. 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
{{photographer|<name>|link=<text>|location=<text>|nocategory=<text>}}
<name>
- 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.
link
- 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.
<text>or the whole parameterlink=<text>can be omitted.
location
- Any text. You can use "1", "y" or whatever you like. As soon as the parameter has any content, the location is displayed.
- Optional.
<text>or the whole parameterlocation=<text>can be omitted.
nocategory
- 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.
<text>or the whole parameternocategory=<text>can be omitted. - Important: It is highly recommended that you always specify this parameter on pages that are not model articles (e. g. on a photographer page: "His work was influenced by {{photographer|Steve Diet Goedde|nocategory=1}}."). Otherwise the photographer would be listed as a big bust model on Steve Diet Goedde'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. g. "At Glamourcon 42 she was seen together with photographer {{photographer|XY|nocategory=1}}."). Otherwise she would be listed on XY's page as if she had worked with him.
Examples
- Article exists
{{photographer|Gil Perron}}gives Gil Perron.{{photographer|Gil Perron|link=1}}gives Gil Perron.{{photographer|Gil Perron|link=ok|location=y}}gives Gil Perron.{{photographer|Gil Perron|location=yes}}gives Gil Perron.
- Article does not exist
{{photographer|The Honorable|link=1|location=1}}gives The Honorable.
- Required and optional parameters
{{photographer|link=1|location=1}}gives {{{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
{{director|Hexvoodoo|link=1|location=1}} always wanted to start a career as a director.- "Hexvoodoo always wanted to start a career as a director."
can become
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
{{photographer|<name>|header=<text>}}
<name>
- 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.
header
- 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
{{photographer|Gil Perron|header=1}}gives
Gil Perron.
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
To change Gil Perron's website,
- go to Category:Data container templates, then Category:Photographer templates;
- choose Gil Perron's template and click on the edit tab;
- follow the instructions given in the section If you want to change the photographer's data:.
See also
- Boobpedia:New film - if you want to create a new film template