Template:R/doc: Difference between revisions

From Citizendium
Jump to navigation Jump to search
imported>Chris Day
(→‎Formatting (variable3): don't complicate with changing variable 2 and 3 at the same time)
imported>Chris Day
No edit summary
Line 74: Line 74:
|}
|}
<!-- We'll stop now, we promise! :-) -->
<!-- We'll stop now, we promise! :-) -->
==Other features==
This template uses color and pictogram indicators to convey other information about the basename that might be useful for an author wishing to know the state of the potential article or cluster. These are described in the following sections.


==No article or definition==
===No article or definition===
If used on an entry that does not exist or have a definition (e.g. [[Foobar]]),   
If used on an entry that does not exist or have a definition (e.g. [[Foobar]]),   


Line 86: Line 88:
* "r" is a link to the Related Articles page for "Foobar".  If no such page exists yet, the link will be red.
* "r" is a link to the Related Articles page for "Foobar".  If no such page exists yet, the link will be red.


==No article but has a definition==
===No article but has a definition===
If used on an entry that does not exist but does have a definition:
If used on an entry that does not exist but does have a definition:


<code><nowiki>{{r|Botany}}</nowiki></code> produces: {{r|Botany}}  
<code><nowiki>{{r|Botany}}</nowiki></code> produces: {{r|Botany}}  


==Redirects==
===Redirects===
If used on an entry that is a redirect, or an article without a metadata template, the link will appear as a tan color.
If used on an entry that is a redirect, or an article without a metadata template, the link will appear as a tan color.


Line 102: Line 104:
<code><nowiki>{{r|fMRI}}</nowiki></code> produces: {{r|fMRI}} .
<code><nowiki>{{r|fMRI}}</nowiki></code> produces: {{r|fMRI}} .


==Ambiguous terms==
===Ambiguous terms===


If it is used on a term which is ambiguous (formally, there is a "{Basename} (disambiguation)" page), it instructs that one should not use that term, but pick one of the specific meanings to link to. For example:
If it is used on a term which is ambiguous (formally, there is a "{Basename} (disambiguation)" page), it instructs that one should not use that term, but pick one of the specific meanings to link to. For example:
Line 112: Line 114:
<nowiki>{{r|Cell|D}}</nowiki> gives: {{r|Cell|D}}.  
<nowiki>{{r|Cell|D}}</nowiki> gives: {{r|Cell|D}}.  


===Action1 (less work)===
====Action1 (less work)====
To advertise the fact that a disambiguation page is required for the term (in this case [[cell]]), the best practice is to add the {{tl|dabdef}} template to the terms [[Cell/Definition|definition subpage]] in the the format of <nowiki>{{dabdef|cell}}</nowiki>.  In this way, any ''related article'' subpage that links to the ''cell'' term with the {{tl|R}} template will display the need for a disambiguation page for the term (as seen above for <nowiki>{{r|Cell}}</nowiki>).
To advertise the fact that a disambiguation page is required for the term (in this case [[cell]]), the best practice is to add the {{tl|dabdef}} template to the terms [[Cell/Definition|definition subpage]] in the the format of <nowiki>{{dabdef|cell}}</nowiki>.  In this way, any ''related article'' subpage that links to the ''cell'' term with the {{tl|R}} template will display the need for a disambiguation page for the term (as seen above for <nowiki>{{r|Cell}}</nowiki>).
===Action2 (more work)===
====Action2 (more work)====
If you intend to solve the problem yourself then the color and pictograms given by the {{tl|R}} template are an indication of the current state of the basename:
If you intend to solve the problem yourself then the color and pictograms given by the {{tl|R}} template are an indication of the current state of the basename:
*The color of the basename link can be blue, tan or red and is meaningful:
*The color of the basename link can be blue, tan or red and is meaningful:

Revision as of 01:01, 30 May 2008

This template is used on CZ:Related Articles pages.

Example of use

{{r|Biology}} produces:

Adjusting name (variable 2)

The name does not have to be identical to the articles name. This might be useful when the context of the word is not in doubt. For example, on the Biology/Related Articles page it would be better to use the word Cell rather than Cell (biology).

{{r|Cell (biology)}} is seen as:

  • Cell (biology) [r]: The basic unit of life, consisting of biochemical networks enclosed by a membrane. [e]

{{r|Cell (biology)|Cell}} is seen as:

  • Cell [r]: The basic unit of life, consisting of biochemical networks enclosed by a membrane. [e]

Formatting (variable3)

The default formatting is a single non-numbered list element, but this can be overridden using a third variable, which contains a different style. Note that you don't have to give a second argument, to be able to specify the third - just set the second argument to blank, by typing "||", and the name shown will be the same as the link. Some examples include:

Code Example
{{r|Biology}}
{{r|Zoology||**}}
{{r|Animal||*::}}
{{r|Ecology||**}}

Numbering could also be used:

Code Example
{{r|Biology||#}}
{{r|Genetics||:#}}
{{r|Zoology||:#}}
{{r|Ecology||:#}}
  1. Biology [r]: The science of life — of complex, self-organizing, information-processing systems living in the past, present or future. [e]
  1. Genetics [r]: The study of the inheritance of characteristics, genes and DNA. [e]
  2. Zoology [r]: The scientific study of animals. [e]
  3. Ecology [r]: The study of the distribution and abundance of organisms and how they are affected by the environment. [e]

In fact, any text you wish can be prepended to the line, using the third argument - or even nothing at all, if that's what you need:

Code Example
{{r|Biology||''See also: ''}}
See also: Biology [r]: The science of life — of complex, self-organizing, information-processing systems living in the past, present or future. [e]
{{r|Biology||}}
Biology [r]: The science of life — of complex, self-organizing, information-processing systems living in the past, present or future. [e]
Which means you can also do this, if you think it's preferable:
{{r|Biology}}
**{{r|Zoology||}}
**{{r|Ecology||}}
  • Biology [r]: The science of life — of complex, self-organizing, information-processing systems living in the past, present or future. [e]
    • Zoology [r]: The scientific study of animals. [e]
    • Ecology [r]: The study of the distribution and abundance of organisms and how they are affected by the environment. [e]

Other features

This template uses color and pictogram indicators to convey other information about the basename that might be useful for an author wishing to know the state of the potential article or cluster. These are described in the following sections.

No article or definition

If used on an entry that does not exist or have a definition (e.g. Foobar),

{{r|Foobar}} produces:

Notice that there are four links in the above output:

  • "Foobar" is a link to a blank article to be titled "Foobar".
  • Add definition is a link to start a definition subpage for "Foobar". You would click on that link and write a definition, and save it, and then it would appear here. To learn what to write there, please see CZ:Definitions. Once you have written a definition, this link will disappear and the definition will appear in its place, as you can see above with the definition of "Biology".
  • "e" is another link to a (blank) definition page for "Foobar". But this link will not disappear. (See the "Biology" line above again; you can click the blue "e" on that line and from there, edit the definition of "Biology".
  • "r" is a link to the Related Articles page for "Foobar". If no such page exists yet, the link will be red.

No article but has a definition

If used on an entry that does not exist but does have a definition:

{{r|Botany}} produces:

Redirects

If used on an entry that is a redirect, or an article without a metadata template, the link will appear as a tan color.

If used on a redirect that does have a definition:

{{r|Supernova}} produces:

  • Supernova [r]: An astronomical object exploding to a brightness similar to that of an entire galaxy. Caused by a catastrophic explosion of either a white dwarf system or an aged star about five times the size of the sun, which occurs when the star collapses; a neutron star or a black hole may be formed as a result, or the explosion results in no remaining compact object. [e]

Or for a redirect without a definition:

{{r|fMRI}} produces:

Ambiguous terms

If it is used on a term which is ambiguous (formally, there is a "{Basename} (disambiguation)" page), it instructs that one should not use that term, but pick one of the specific meanings to link to. For example:

{{r|Cell}} gives

  • Cell [r]: Please do not use this term in your topic list, because there is no single article for it. Please substitute a more precise term. See Cell (disambiguation) for a list of available, more precise, topics. Please add a new usage if needed.

Any term that you think should have a disambiguation page can be written in the format of {{r|Cell|D}} to see the status of the disambiguation page and if there is a definition already at the basename term.

{{r|Cell|D}} gives:

  • D [r]: Please do not use this term in your topic list, because there is no single article for it. Please substitute a more precise term. See Cell (disambiguation) for a list of available, more precise, topics. Please add a new usage if needed..

Action1 (less work)

To advertise the fact that a disambiguation page is required for the term (in this case cell), the best practice is to add the {{dabdef}} template to the terms definition subpage in the the format of {{dabdef|cell}}. In this way, any related article subpage that links to the cell term with the {{R}} template will display the need for a disambiguation page for the term (as seen above for {{r|Cell}}).

Action2 (more work)

If you intend to solve the problem yourself then the color and pictograms given by the {{R}} template are an indication of the current state of the basename:

  • The color of the basename link can be blue, tan or red and is meaningful:
    • If basename is blue a cluster exists, the article should be moved to a new disambiguated basename and the basename redirected to the diambiguation page.
    • If basename is tan (and italicised too) there are three possible reasons:
      1. A redirect exists, although not necessarily to the disambiguated term.
      2. It is already a disambiguation page and needs to be moved to the the correct location of "basename (disambiguation)"
      3. It is an article without subpages (rarer). This page needs to be moved to a new disambiguated basename and the basename should be redirected to the diambiguation page.
    • If basename is red the page does not exist. This page needs to be redirected to the diambiguation page.
  • Level0.jpg indicates that a disambiguation page has been set up and the old definition page has been deleted.
  • A red "Definition" (and italicised too) below is a link to add a {{speedydelete}} template to the old definition, assuming it has been moved to the new disambiguated location first.

The goal is to have a tan basename (a redirect to the disambiguation page) followed by a green check (indicates the old definition page has been deleted). For example, {{r|Band|D}} gives:

  • D [r]: Please do not use this term in your topic list, because there is no single article for it. Please substitute a more precise term. See Band (disambiguation) for a list of available, more precise, topics. Please add a new usage if needed.

Code

To control the color of the basename link.

{{#ifeq:{{{2|}}}|D
|{{#ifexist: Image:Level{{Template:{{{1|}}}/Metadata|info=status}}.jpg
          |[[{{{1|}}}]]
          |{{#ifexist:{{{1|}}}
                 |[[{{{1|}}}|'''''<font color="#cc9900">{{{1|}}}</font>''''']]
                 |[[{{{1|}}}]] }} }}
|{{#ifexist: Image:Level{{Template:{{{1|}}}/Metadata|info=status}}.jpg
          |{{#if: {{{2|}}} 
                 |[[{{{1|}}}|{{{2|}}}]] 
                 |[[{{{1|}}}]]}}
          |{{#ifexist:{{{1|}}}
                 |{{#if: {{{2|}}} 
                       |[[{{{1|}}}|'''''<font color="#cc9900">{{{2|}}}</font>''''']] 
                       |[[{{{1|}}}|'''''<font color="#cc9900">{{{1|}}}</font>''''']]}}
                 |{{#if: {{{2|}}} 
                       |[[{{{1|}}}|{{{2|}}}]] 
                       |[[{{{1|}}}]] }} }} }}

To add the [r] link to the Related Articles subpage

<span class="plainlinks" style="font-size:0.8em;">{{#ifexist:{{{1}}}/Related Articles|[
[[{{{1}}}/Related Articles|r]]]|[
[http://en.citizendium.org/wiki?action=edit&preload=
Template%3ARelated_Articles_start&title={{urlencode:{{{1}}}}}/Related_Articles 
<font color=#CA3D10>r</font>]]}}</span>}}

To add definition.

{{ {{#ifeq:{{{2|}}}|D
|Rpl def2
|{{#ifexist: {{{1|}}} (disambiguation)
        |dabdef
        |{{#ifexist: {{{1|}}}/Definition
             |Rpl def1
             |Rpl def3}} }} }}|1={{{1|}}}|2={{{2|}}} }}

Rpl def1

{{:{{{1}}}/Definition}} <span class="plainlinks" style="font-size:0.8em;">[
[http://en.citizendium.org/wiki?title={{urlencode:{{{1}}}}}/Definition&action=edit e]]</span>}}

Rpl def2

{{#ifexist: {{{1|}}}/Definition
             |{{#ifexist: {{{1|}}} (disambiguation)
                      |Definition and disambiguation exist at [[{{{1|}}}/Definition]] and [[{{{1|}}} (disambiguation)]]
::''Definition is:'' {{def|{{{1}}}}}
                      |Definition only: exists at [[{{{1|}}}/Definition]]; [http://en.citizendium.org/wiki?
action=edit&preload=Template%3APreload-disambig&title={{urlencode:{{{1}}}}}_(disambiguation) ''<font 
color=#666666>please add a disambiguation page</font>''].
::''Definition is:'' {{def|{{{1}}}}} }}
             |{{#ifexist: {{{1|}}} (disambiguation)
                      |[[Image:Level0.jpg|15px]] Disambiguation exists at [[{{{1|}}} (disambiguation)]]
                      |[http://en.citizendium.org/wiki?action=edit&preload=Template%3APreload-
disambig&title={{urlencode:{{{1}}}}}_(disambiguation) ''<font color=#666666>Please add a disambiguation page.</font>''] }} }}

Rpl def3

[http://en.citizendium.org/wiki?action=edit&preload=Template%3ADef_preload&title=
{{urlencode:{{{1}}}}}/Definition ''<font color=#666666>Add brief definition or description</font>'']

dabdef

''<font color=#666666>Please do not use this term in your topic list, because we do not have a single article for it. 
Please substitute a more precise term. See </font> [[{{{1}}} (disambiguation)]] <font color=#666666>for a list of 
available, more precise, topics.</font>''