Help:Extension:Linter/obsolete-tag

From MediaWiki.org
Jump to navigation Jump to search

Other languages:
English • ‎dansk • ‎français • ‎українська • ‎日本語

The obsolete-tag error is the result of deprecated HTML elements.[1]

Since it is unclear to us at this time how far we want to push this goal of HTML5 compliance, this category is marked low priority. Some wikis might choose to not address this right away. Other wikis might want to get ahead and want to be HTML5 compliant. It is possible that some wikis might write bots to address this. So, please use your judgement and wiki-specific policies to guide you in how much effort you want to spend on this. If, in the future, there is greater clarity about pursuing this more aggressively, we will reflect that by updating the severity of this linter issue appropriately.

Currently, the deprecated elements with their alternatives are:

Deprecated tag Replacement Example Example display
<center> <div style="text-align: center;"> <div style="text-align: center;">Centered</div>
Centered
<font color="x" size="y" face="z"> <span style="color: x; font-size: y; font-family: z;"> <span style="color: red;">Red Alert!</span> Red Alert!
<span style="font-family: Times New Roman;">This is Times New Roman</span> This is Times New Roman
<strike> <del> (for marking an edit) <del>Yes</del> No Yes No
<s> (for anything else) Photon Torpedoes <s>$44.99</s> '''now just $24.99!''' each Photon Torpedoes $44.99 now just $24.99! each
<tt> <code> (preferred for source code) use <code>&nbsp;</code> for nonbreaking space use &nbsp; for nonbreaking space
<kbd> (preferred for user input) <kbd>mypasswd</kbd> mypasswd
<var> (preferred for variables) <var>age</var>=65 age=65
<samp> (preferred for output, function and tag names, etc.) <samp>nowiki</samp> nowiki
<span style="font-family: monospace;"> (preferred for everything else) <span style="font-family: monospace;">Typed text</span> Typed text

Font sizes[edit]

<font size=...> <span style="font-size: ...;"> <span style="font-size: ...;"> <span style="font-size: ...;">
font-size: xx-small font-size: 71% font-size: 0.71em
font size=1 font-size: x-small font-size: 79% font-size: 0.79em
font size=2 font-size: small font-size: 102% font-size: 1.02em
font size=3 font-size: medium font-size: 126% font-size: 1.26em
font size=4 font-size: large font-size: 142% font-size: 1.42em
font size=5 font-size: x-large font-size: 189% font-size: 1.89em
font size=6 font-size: xx-large font-size: 252% font-size: 2.52em
size=7 size: 378% size: 3.78em

Values above 7 are equivalent to 7. Sizes with percent or em are approximate matches and may depend slightly on browser and other variables.

Font sizes prefixed by plus or hyphen, e.g. <font size=+2> or <font size=-1>, are equivalent to 3 plus or minus that number.

Multi-big[edit]

<big>...</big> <span style="font-size:...">...</span>
1 big 120%
2 big 150%
3 big 175%
4 big 200%
5 big 250%
6 big 300%

Rationale[edit]

Mediawiki currently whitelists these elements, and they tend to be output the same way as input. This means that when browser vendors decide to remove these they will simply display as regular undecorated text. Examples of some "popular" html tags that had visual effects and have been removed from major browsers include <blink>[2] and <basefont>[3]. A further problem is that different browser vendors may remove them independently so editors or readers may have inconsistent views of the same page, leading to confusion.

Such removal of styling or unique treatment of html tags by browser vendors can happen at any time and without prior notice.

Helpful hints[edit]

<font color="x"> accepts numeric font colors without the standard pound sign prefix. However, with <span style="color: x;">, the pound sign before numeric font colors is mandatory:

Markup Display
<font color="#FF0000">Red</font> Red
<font color="FF0000">Red</font> Red
<span style="color: #FF0000;">Red</span> Red
<span style="color: FF0000;">Red</span> Red

<font color="x"> accepts some nonstandard font color names such as burntorange and vermillion, which are not on the list of 16 HTML colors or the list of 124 X11 colors. The replacement <span style="color: ..."> markup recognizes only color names on these lists.

<font color="x"> accepts 4-digit and 5-digit hexadecimal codes, which need 00 and 0, respectively, appended in <span style="color: ..."> markup.

font markup font display span markup span display
<font color="#FF88">Hello</font> Hello <span style="color: #FF8800;">Hello</span> Hello
<font color="#D0208">Hello</font> Hello <span style="color: #D02080;">Hello</span> Hello

Tools[edit]

The following tools can help fix obsolete HTML tags:

References[edit]