Template:Nonperformer/doc: Difference between revisions
(New page: {{Documentation subpage}} <!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE --> == Inserting a photographer's name using the photographer template == The {{tl|photograp...) |
|||
| (6 intermediate revisions by the same user not shown) | |||
| Line 2: | Line 2: | ||
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE --> | <!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE --> | ||
The templates {{tl|photographer}}, {{tl|director}}, {{tl|fashion designer}}, {{tl|sculptor}}, {{tl|painter}} and {{tl|make-up artist}} are metatemplates that use the information stored in [[:Category:Data container templates|data container templates]]. They work | |||
The {{tl|photographer}} | * as [[:Category:Inline templates|inline templates]] to display a person's name and additional information, | ||
* as | * as [[:Category:Category header templates|category header templates]] to display a header for the person's own category, like '''XY models''' or '''XY actresses'''. | ||
* as | |||
* automatically displays a link to the | == Inline == | ||
* displays only normal text if the | === Functionality === | ||
* automatically displays further information on the | 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 new | |||
* automatically adds a category to the article the | * 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, | * offers the possibility to suppress the category addition to an article, | ||
* displays an error if you do not specify a name. | * displays an error if you do not specify a name. | ||
=== Syntax === | |||
<nowiki>{{</nowiki>photographer|''<name>''|link=''<text>''|location=''<text>''|nocategory=''<text>''}} | <nowiki>{{</nowiki>photographer|''<name>''|link=''<text>''|location=''<text>''|nocategory=''<text>''}} | ||
<code>'''''<name>'''''</code> | <code>'''''<name>'''''</code> | ||
* Text. The name of the | * Text. The name of the person. | ||
* Required. | * Required. | ||
* Please note that this parameter has no name. Simply type the | * Please note that this parameter has no name. Simply type the person's name '''without''' a parameter name. | ||
<code>'''link'''</code> | <code>'''link'''</code> | ||
| Line 39: | Line 39: | ||
* Optional. <code>''<text>''</code> or the whole parameter <code>nocategory=''<text>''</code> can be omitted. | * Optional. <code>''<text>''</code> or the whole parameter <code>nocategory=''<text>''</code> 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 <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:''' 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 <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 | * '''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 <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 | ; Article exists | ||
* <code><nowiki>{{photographer|Gil Perron}}</nowiki></code> gives {{photographer|Gil Perron|nocategory=1}}. | * <code><nowiki>{{photographer|Gil Perron}}</nowiki></code> gives {{photographer|Gil Perron|nocategory=1}}. | ||
| Line 54: | Line 54: | ||
* <code><nowiki>{{photographer|link=1|location=1}}</nowiki></code> gives {{photographer|link=1|location=1|nocategory=1}}. | * <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. | 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 | 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>{{ | : <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 | : "Hexvoodoo always wanted to start a career as a director." | ||
can become | can become | ||
: "[[user:Hexvoodoo|Hexvoodoo]] ([http://www.boobpedia.com home page]), Boobtown, Boobland always wanted to start a career as a | : "[[user:Hexvoodoo|Hexvoodoo]] ([http://www.boobpedia.com home page]), Boobtown, Boobland always wanted to start a career as a director." | ||
if he really gets | if he really gets his own director page some day. :-) | ||
== | == Header == | ||
=== Functionality === | |||
If used as a | 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) | |||
* '''make-ups''' (for make-up artists) | |||
=== Syntax === | |||
<nowiki>{{</nowiki>photographer|''<name>''|header=''<text>''}} | <nowiki>{{</nowiki>photographer|''<name>''|header=''<text>''}} | ||
<code>'''''<name>'''''</code> | <code>'''''<name>'''''</code> | ||
* Text. The name of the | * Text. The name of the person. | ||
* Required. | * Required. | ||
* Please note that this parameter has no name. Simply type the | * Please note that this parameter has no name. Simply type the person's name '''without''' a parameter name. | ||
<code>'''header'''</code> | <code>'''header'''</code> | ||
| Line 86: | Line 94: | ||
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. | 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 | * <code><nowiki>{{photographer|Gil Perron|header=1}}</nowiki></code> gives | ||
{{photographer|Gil Perron|header=1}}. | {{photographer|Gil Perron|header=1}}. | ||
=== Usability === | |||
If used as a header, the template should only be added at the top of category pages. | 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 | 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 | 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 {{photographer|Gil Perron|nocategory=1}}'s website, | ||
* go to {{cl|Photographer templates}}; | * go to {{cl|Data container templates}}, then {{cl|Photographer templates}}; | ||
* choose Gil Perron's template and click on the '''edit''' tab; | * 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:'''. | * follow the instructions given in the section '''If you want to change the photographer's data:'''. | ||
Latest revision as of 04:19, 23 November 2008
The templates {{Photographer}}, {{Director}}, {{Fashion designer}}, {{Sculptor}}, {{Painter}} and {{Make-up artist}} are metatemplates that use the information stored in data container templates. They work
- as inline templates to display a person's name and additional information,
- as category header templates to display a header for the person's own category, like XY models or XY actresses.
Inline
Functionality
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)
- make-ups (for make-up artists)
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:.