Template:Antibody/doc: Difference between revisions

From OpenWetWare
Jump to navigationJump to search
mNo edit summary
mNo edit summary
Line 5: Line 5:
<!---->
<!---->
== Purpose ==
== Purpose ==
This template should be added to the main page of all antibodies documented on this wiki (and only the main page).  It will add a useful infobox using the information supplied (see below) and will automatically add the antibody to [[:Category:All antibodies]], plus the appropriate [[:Category:Antibodies by status|status]] and [[:Category:Antibodies by implementation type|implementation type]] categories.
This template should be added to the main page of all antibodies documented on this wiki (and only the main page).  It will add a useful infobox using the information supplied (see below) and will automatically add the antibody to [[:Category:All antibodies]].


== Usage ==  
== Usage ==  
Line 74: Line 74:
* ''[[:Category:Antibodies with unknown status|unknown]]'' (default)
* ''[[:Category:Antibodies with unknown status|unknown]]'' (default)
If the status is anything other than the above, it will be ignored and the default value of 'Unknown' will be displayed in the template instead.  In cases where the value is omitted, it will be categorised as [[:category:antibodies with unknown status|unknown]].  In cases where the value is invalid, it will be placed in a [[:category:antibodies with invalid status|special category]] so that the error can be caught and fixed.
If the status is anything other than the above, it will be ignored and the default value of 'Unknown' will be displayed in the template instead.  In cases where the value is omitted, it will be categorised as [[:category:antibodies with unknown status|unknown]].  In cases where the value is invalid, it will be placed in a [[:category:antibodies with invalid status|special category]] so that the error can be caught and fixed.
|-
| '''type1'''<br/>''type2''<br/>''type3''<br/>''type4''<br/>''type5''<br/>''type6''<br/> || <span id="type">'''implementation type'''</span><!-- id here so at top of documentation -->
The  implementation strategy(s) employed in building this antibody. This parameter is used to create categories that help programmers find examples of various MediaWiki specific implementation strategies or patterns.  Although the values of this parameter sometimes coincide with the use case or purpose of an antibody, that is not reason for this parameter.  If the values you have chosen for this parameter do not adequately identify the [[w:Requirements|purpose]] or possible [[w:Use case|use case]]s, we recommend you add additional [[Help:Categories|category links]] as needed.
Any other value for 'type' is invalid, and will cause the antibody to be placed in [[:Category:Antibodies with invalid or missing type]].
Note: Many antibodies have more than one type, if this applies to yours,replace <code><nowiki>|type=</nowiki></code> with <code><nowiki>|type1=|type2=|type3=...</nowiki></code>.  You may define up to six types for an antibody.
|-
|-
| <span id="description">'''description'''</span>|| '''short description'''
| <span id="description">'''description'''</span>|| '''short description'''
Line 150: Line 142:
In general:
In general:
* To make this template easy to use, each label in the infobox is linked to documentation on the template parameter(s) it displays.  If you add a parameter, please be sure to also add it to the [[Template:Antibody/Doc#Content parameters|content parameter documentation]] and link its label to that documentation.
* To make this template easy to use, each label in the infobox is linked to documentation on the template parameter(s) it displays.  If you add a parameter, please be sure to also add it to the [[Template:Antibody/Doc#Content parameters|content parameter documentation]] and link its label to that documentation.
To change/correct/add to the implementation type parameters:
* Check the [[Template_talk:Antibody|talk page]] - there have been some extensive discussions about this field.
* '''[[Template:Antibody/TypeSwitch]]:''' Stores the possible values for the type field.  Multiple values are implemented by calling this template with [[Template:Foreach]].
* '''[[Template:Antibody/TypeSwitchNoCats]]:''' Used instead of [[Template:Antibody/TypeSwitch]] when this template is used in <code>templatemode=nocats</code>.  Templates used with [[Template:Foreach]] can only take one parameter so we need to wrap the call to [[Template:Antibody/TypeSwitch]] with another template that sets the mode.
* '''[[Template:Antibody/Doc]]:''' Documentation for this template needs to be kept in sync with any changes to the implementation type taxonomy.


== Test case ==
== Test case ==

Revision as of 05:09, 19 June 2009

Template:Antibody (talk, backlinks, edit)


Purpose

This template should be added to the main page of all antibodies documented on this wiki (and only the main page). It will add a useful infobox using the information supplied (see below) and will automatically add the antibody to Category:All antibodies.

Usage

Cut and paste:

{{Antibody|templatemode =
|name          = 
|type          =
|description   =
|target        =
|species       =
|against       =
|xreactive     =
|nonxreactive  =
|westernblot   = 
|ip            = 
|icc           = 
|ihc-paraffin  = 
|ihc-cryo      = 
}}}

For help with parameter values, see below.

                 
List of OpenWetWare Antibodies
anti {{{name}}}
Cross-Reactive w  {{{xreactive}}}
Not Cross-Reactive w  {{{nonxreactive}}}
Raised Against  {{{against}}}
Suitability for..
Western Blot  {{{westernblot}}}
Immunoprecipitation  {{{ip}}}
Staining fixed cells   {{{icc}}}
Staining cryo-sections  {{{ihc-cryo}}}
Staining paraffin sections  {{{ihc-paraffin}}}
Help



Content parameters

This section describes parameters that govern infobox content. For help with templatemode and other control parameters, please see Control parameters.

Content parameters
name name of the antibody
status current release status

One of:

  • unstable (broken - documentation of this antibody is not complete)
  • In-Progress (early stages of development, may change drastically.)
  • stable (stable version)
  • unknown (default)

If the status is anything other than the above, it will be ignored and the default value of 'Unknown' will be displayed in the template instead. In cases where the value is omitted, it will be categorised as unknown. In cases where the value is invalid, it will be placed in a special category so that the error can be caught and fixed.

description short description
target target species
species species tested
against works against
xreactive cross-reactive
nonxreactive non-cross-reactive
westernblot Is the antibody suitable for Western Blotting? Possible values: failed, worked, uncertain, untested
immunoprecipitation ip
immunocytochemistry icc
immuno-histo-cryo-chemistry immunohistocryochemistry
immuno-histo-paraffin-chemistry ihc-paraffin

Control parameters

Control parameters
templatemode Controls auto-categorization of host page.

Normally left blank. Alternate values are:

  • nocats - suppresses categorization. Use this value if you are adding this template to subpages of an antibody or to how-to documentation of antibodies. For example, the usage image above sets templatemode=nocats because this isn't an actual antibody page and we don't want to add this page to any categories on account of it.


If this is left blank, this template will add the host page to Category:All antibodies and to one or more additional categories, depending on the values assigned to the Content parameters.

Using the infobox

Existing antibody pages

If you want to add the infobox to an existing page, copy and paste the code at the top of this page.

Create a new antibody article

If you want to create a new antibody page, enter the name below and click the button. A new page will be created with the infobox template already in place.


Please replace "MyAntibody" with the antibody name:



Enhancing this template

If you would like to improve on this template, thanks! This is a complicated template so here is some help along the way:

Fixing documentation

If you would like to fix documentation, please be aware that documentation and code is split into two files:

  • Template:Antibody/Doc - stores all documentation.
  • Template:Antibody - stores only the code for the template and a small amount of non-included material (category links, transcluded documentation link).


In addition, Template:Antibody/Sample stores the boiler plate that is preloaded into newly created pages and contains some basic documentation on how to fill in the template parameters. It needs to be kept in sync with Template:Antibody/Doc.

The Create antibody button

To improve the create antibody button behavior:

Infobox parameters

In general:

  • To make this template easy to use, each label in the infobox is linked to documentation on the template parameter(s) it displays. If you add a parameter, please be sure to also add it to the content parameter documentation and link its label to that documentation.

Test case

See if the following pages are still ok, after edited this template.