Difference between revisions of "Template:Maths rating/doc"

From blackwiki
Jump to navigation Jump to search
imported>MSGJ
(→‎Usage: simplify/update)
imported>MSGJ
Line 36: Line 36:
  
 
The template also supports a <code>importance</code> parameter which functions identically to <code>priority</code> except for where the template displays the word 'priority' it will instead say 'importance.' Beyond that, there is no reason to use one over the other and no reason to use both together. If they are both used, the <code>importance</code> parameter will be ignored. If the <code>priority</code> parameter is set to blank - if <code>{{!}}priority=</code> appears with no argument - then the code considers this a use of <code>priority</code> and ignores <code>importance</code>, except when assigning categories.
 
The template also supports a <code>importance</code> parameter which functions identically to <code>priority</code> except for where the template displays the word 'priority' it will instead say 'importance.' Beyond that, there is no reason to use one over the other and no reason to use both together. If they are both used, the <code>importance</code> parameter will be ignored. If the <code>priority</code> parameter is set to blank - if <code>{{!}}priority=</code> appears with no argument - then the code considers this a use of <code>priority</code> and ignores <code>importance</code>, except when assigning categories.
 
==Notes for editors==
 
===Categories===
 
The <code>|category=no</code> parameter works by surrounding each category with code so that it is only added if the parameter is not set. To add a category somewhere, use <br />
 
<code><nowiki>{{#ifeq:{{lc:{{{category|}}} }}|no||<!-- Category added here -->}}</nowiki></code><br />
 
or add it inside the large, already existing section wrapped in the <code>ifeq</code> parser function near the end, where the code for the <code>vital</code>, <code>portal</code>, and <code>historical</code> categories is.
 
 
===Case-sensitivity===
 
The case-insensitivity for the <code>class</code> and <code>priority</code> is somewhat sensitive. For <code>class</code>, it is assumed that any parameter two or fewer characters long is "intended" to be in all caps (<code>FA</code>, <code>FL</code>, <code>GA</code>), or that the relevant pages and categories linked to have these in their names - for example, [[:Category:FA-Class mathematics articles]]. It assumes that any longer values are intended to have only the first letter capitalized. For <code>priority</code>, any value except for 'NA' is supposed to have the first letter only capitalized. If adding other values for these parameters, make sure they fit into this scheme or edit the code as needed.
 
 
===Tables, whitespace, and newlines===
 
The tables in the template have been mostly converted to html-style since the readability benefits of wiki table style are lost when there is so much complexity inside and around the cells, especially since pipes (|) must be replaced with {{tl|!}} inside parser functions and templates. However, two cells require wiki tables inside them. Please be aware that introducing or removing newlines in those areas can break the template, so be careful and test your edits somewhere else first. Also, introducing newlines within <code>&lt;td&gt;</code> tags or outside the <code>&lt;table&gt;</code> tags can change spacing as well. If a particular newline is causing a problem but removing it would make the code much less readable, the newline can be commented out by placing <code>&lt;!--</code> at the end of the upper line and <code>--&gt;</code> at the beginning of the lower one. You may also wish to view [[Help:Table]] and [[Wikipedia:Line-break handling|Wikipedia:Line&#8209;break handling]] for more information.
 
  
 
== Categories ==
 
== Categories ==

Revision as of 08:12, 30 October 2020

Usage

This template is used to categorize and assess articles within WikiProject Mathematics. To classify an article, place the template {{maths rating}} on the article's talk page and fill in the class, priority, and field parameters.

Please do not simply add this template without filling in the parameters. The purpose of this template is to carry article assessment data.

Anyone can add a maths rating or change an existing rating. These parameters will place the article in the appropriate subcategories of Category:Mathematics articles by priority, Category:Mathematics articles by quality and Category:Mathematics articles by field.

Syntax overview

When using the maths rating template, please set each of the three following parameters:

  • Class: choose one: FA, FL, GA, A, B, C, Start, Stub, List, e.g. |class=B
  • Priority: choose one: Top, High, Mid, Low, e.g. |priority=high

The following parameters are also available. In general, if you don't know what they mean then you don't need them.

  • |historical=Y for an article on a topic with historical interest.
  • |vital=Y for an article that is in the Vital articles collection.
  • |portal=Y for an article that is a selected article on Portal:Mathematics.
  • |category=no if the template is being used as a demonstration and you do not want the page it is on to be added to any categories.

Standard template syntax

{{maths rating
| class=            <!--FA, FL, GA, A, B, Start, Stub, List-->
| priority =        <!--Top, High, Mid, Low-->
<!--optional or special purpose-->
| historical=       <!--set to Y for articles on a topic with historical interest-->
| vital=            <!--set to Y for articles that are in the Vital articles collection; be sure of consensus before setting-->
| portal=           <!--set to Y to place the article in Category:Featured articles on Mathematics Portal-->
| category=         <!--set to "no" to prevent the template from adding categories to a page-->
}}

Syntax details

The main purpose of this template is to show the classifications of articles on their talk pages, as well as to place talk pages in the appropriate categories. Only the first three parameters are required for this. However, other flags can be used to show additional information and categorize the page further.

The template also supports a importance parameter which functions identically to priority except for where the template displays the word 'priority' it will instead say 'importance.' Beyond that, there is no reason to use one over the other and no reason to use both together. If they are both used, the importance parameter will be ignored. If the priority parameter is set to blank - if |priority= appears with no argument - then the code considers this a use of priority and ignores importance, except when assigning categories.

Categories

The following categories are populated by the field parameter:

See also