Acorni at 10:15, 14 August 2010

2010-08-14T10:15:34Z

← Older revision		Revision as of 10:15, 14 August 2010
Line 41:		Line 41:
	* [[w:HTML_element#Official\|<small>]]		* [[w:HTML_element#Official\|<small>]]
	* [[w:HTML_element#Official\|<strike>]]		* [[w:HTML_element#Official\|<strike>]]
	* [[w:HTML_element#General_phrase_elements\|<strong>]]		* [[w:HTML_element#General_phrase_elements\|<strong>]]http://dii.ing.unimo.it/wiki/index.php?title=Help:HTML_in_wikitext&action=edit
	* [[w:HTML_element#Special_inline_elements\|<sub>]]		* [[w:HTML_element#Special_inline_elements\|<sub>]]
	* [[w:HTML_element#Special_inline_elements\|<sup>]]		* [[w:HTML_element#Special_inline_elements\|<sup>]]
Line 62:		Line 62:
	:'''Update:''' In 1.5, the removeHTMLtags function is now located in Sanitizer.php.		:'''Update:''' In 1.5, the removeHTMLtags function is now located in Sanitizer.php.

	For many HTML elements, more convenient wikitext code is available, see [[Help:Editing]]. On the other hand, HTML tags allow an id that can be referenced in one's ~~User style~~ css, and allows the tag to be used as link target.		For many HTML elements, more convenient wikitext code is available, see [[Help:Editing]]. On the other hand, HTML tags allow an id that can be referenced in one's le css, and allows the tag to be used as link target.
	<br clear="all"><!-- stop floating navbox before pre -->		<br clear="all"><!-- stop floating navbox before pre -->
	<pre>		<pre>
Line 194:		Line 194:

	==Style pages==		==Style pages==
	CSS and JS pages ~~(see [[Help:~~User style~~]])~~ are not interpreted as wikitext, and therefore can have arbitrary HTML.		CSS and JS pages User style are not interpreted as wikitext, and therefore can have arbitrary HTML.

	==External links==		==External links==

Acorni: /* Permitted HTML */

2010-08-14T10:13:03Z

Permitted HTML

← Older revision		Revision as of 10:13, 14 August 2010
Line 62:		Line 62:
	:'''Update:''' In 1.5, the removeHTMLtags function is now located in Sanitizer.php.		:'''Update:''' In 1.5, the removeHTMLtags function is now located in Sanitizer.php.

	For many HTML elements, more convenient wikitext code is available, see [[Help:Editing]]. On the other hand, HTML tags allow an id that can be referenced in one's ~~[[Help:~~User style~~\|user style]]~~ css, and allows the tag to be used as link target.		For many HTML elements, more convenient wikitext code is available, see [[Help:Editing]]. On the other hand, HTML tags allow an id that can be referenced in one's User style css, and allows the tag to be used as link target.
	<br clear="all"><!-- stop floating navbox before pre -->		<br clear="all"><!-- stop floating navbox before pre -->
	<pre>		<pre>

Corni: 1 revision(s)

2006-11-18T17:33:43Z

1 revision(s)

← Older revision

Revision as of 17:33, 18 November 2006

Corni: 1 revision(s)

2006-11-18T17:30:39Z

1 revision(s)

New page

{{H:h|editor toc}}

==Permitted HTML==
The following [[w:HTML element|HTML element]]s are currently permitted:

{| border="0" cellpadding="5"
| valign="top"|
* [[w:HTML_element#Official|<b>]]
* [[w:HTML_element#Official|<big>]]
* [[w:HTML_element#General_block_elements|<blockquote>]]
* [[w:HTML_element#Images_and_objects|<br>]]
* [[w:HTML_element#Tables|<caption>]]
* [[w:HTML_element#Official|<center>]]
* [[w:HTML_element#General_phrase_elements|<cite>]]
* [[w:HTML_element#Computer_code_phrase_elements|<code>]]
* [[w:HTML_element#Lists|<dd>]]
* [[w:HTML_element#Other_containers|<div>]]
* [[w:HTML_element#Lists|<dl>]]
* [[w:HTML_element#Lists|<dt>]]
* [[w:HTML_element#General_phrase_elements|<em>]]
* [[w:HTML_element#Official|<font>]]
* [[w:HTML_element#Headings|<h1>]]
| valign="top"|
* [[w:HTML_element#Headings|<h2>]]
* [[w:HTML_element#Headings|<h3>]]
* [[w:HTML_element#Headings|<h4>]]
* [[w:HTML_element#Headings|<h5>]]
* [[w:HTML_element#Headings|<h6>]]
* [[w:HTML_element#General_block_elements|<hr>]]
* [[w:HTML_element#Official|<i>]]
* [[w:HTML_element#Lists|<li>]]
* [[w:Ordered list|<ol>]]
* [[w:HTML_element#General_block_elements|<p>]]
* [[w:HTML_element#Other_containers|<pre>]]
* [http://www.w3.org/TR/1999/WD-ruby-19990322/ <rb>]
* [http://www.w3.org/TR/1999/WD-ruby-19990322/ <rp>]
* [http://www.w3.org/TR/1999/WD-ruby-19990322/ <rt>]
* [http://www.w3.org/TR/1999/WD-ruby-19990322/ <ruby>]
| valign="top"|
* [[w:HTML_element#Official|<s>]]
* [[w:HTML_element#Official|<small>]]
* [[w:HTML_element#Official|<strike>]]
* [[w:HTML_element#General_phrase_elements|<strong>]]
* [[w:HTML_element#Special_inline_elements|<sub>]]
* [[w:HTML_element#Special_inline_elements|<sup>]]
* [[w:HTML_element#Tables|<table>]]
* [[w:HTML_element#Tables|<td>]]
* [[w:HTML_element#Tables|<th>]]
* [[w:HTML_element#Tables|<tr>]]
* [[w:HTML_element#Presentational_markup|<tt>]]
* [[w:HTML_element#Presentational_markup|<u>]]
* [[w:Ordered list|<ul>]]
* [[w:HTML_element#Computer_code_phrase_elements|<var>]]
* [[w:HTML_element#HTML_Comment|]]
|}

The following excerpt from [http://svn.wikimedia.org/viewvc/mediawiki/tags/REL1_6_6/phase3/includes/Sanitizer.php Sanitizer.php] additionally shows which attributes are allowed.

:'''Update:''' In 1.4rc1, the removeHTMLtags function is located in Parser.php.

:'''Update:''' In 1.5, the removeHTMLtags function is now located in Sanitizer.php.

For many HTML elements, more convenient wikitext code is available, see [[Help:Editing]]. On the other hand, HTML tags allow an id that can be referenced in one's [[Help:User style|user style]] css, and allows the tag to be used as link target.
<br clear="all">
<pre>
/* private */ function removeHTMLtags( $text )
{
wfProfileIn( "OutputPage::removeHTMLtags" );
$htmlpairs = array( # Tags that must be closed
"b", "i", "u", "font", "big", "small", "sub", "sup", "h1",
"h2", "h3", "h4", "h5", "h6", "cite", "code", "em", "s", "span",
"strike", "strong", "tt", "var", "div", "center",
"blockquote", "ol", "ul", "dl", "table", "caption", "pre",
"ruby", "rt" , "rb" , "rp"
);
$htmlsingle = array(
"br", "p", "hr", "li", "dt", "dd"
);
$htmlnest = array( # Tags that can be nested--??
"table", "tr", "td", "th", "div", "blockquote", "ol", "ul",
"dl", "font", "big", "small", "sub", "sup"
);
$tabletags = array( # Can only appear inside table
"td", "th", "tr"
);

$htmlsingle = array_merge( $tabletags, $htmlsingle );
$htmlelements = array_merge( $htmlsingle, $htmlpairs );

$htmlattrs = array( # Allowed attributes--no scripting, etc.
"title", "align", "lang", "dir", "width", "height",
"bgcolor", "clear", /* BR */ "noshade", /* HR */
"cite", /* BLOCKQUOTE, Q */ "size", "face", "color",
/* FONT */ "type", "start", "value", "compact",
/* For various lists, mostly deprecated but safe */
"summary", "width", "border", "frame", "rules",
"cellspacing", "cellpadding", "valign", "char",
"charoff", "colgroup", "col", "span", "abbr", "axis",
"headers", "scope", "rowspan", "colspan", /* Tables */
"id", "class", "name", "style" /* For CSS */
);
</pre>

For example, the anchor element "a" is not allowed, so the wikitext

: <code><nowiki><a href="http://meta.wikimedia.org/wiki/Main_Page">Main Page</a></nowiki></code>

is treated like the wikitext

: <code><nowiki>&lt;a href="http://meta.wikimedia.org/wiki/Main_Page"&gt;Main Page&lt;/a&gt;</nowiki></code>

and is therefore displayed as

: <a href="http://meta.wikimedia.org/wiki/Main_Page">Main Page</a>

which is unlikely to be what the editor intended. Instead of using the anchor element (<a>) the wiki markup for external reference is recommended (enclosed in square brackets with the URL separated from the contents by a single space):

: <code><nowiki>[http://meta.wikimedia.org/wiki/Main_Page Main Page]</nowiki></code>

displays as:

: [http://meta.wikimedia.org/wiki/Main_Page Main Page]

==Span==

<code><nowiki><span></nowiki></code>, a generic inline text container, is now allowed on default MediaWiki installations (as of version 1.5). Span can be ID'd, classed, or styled:

<nowiki>This is <span style="color:red">red</span> text.</nowiki>

<nowiki>This is <span id="randomfooid">identified</span> text.</nowiki>

<nowiki>This is <span class="importantmessage">classed</span> text.</nowiki>
produces:

<blockquote>

This is <span style="color:red">red</span> text.

This is <span id="randomfooid">identified</span> text.

This is <span class="importantmessage">classed</span> text.

</blockquote>

IDs and classes are used in conjunction with stylesheets to give a piece of text a descriptive class (or unique identifier) and to refer to that in a stylesheet.

Note that in most cases, one can use a more descriptive tag, for instance, <strong><nowiki><strong></nowiki></strong> (which can be classed, identified, and styled, as well) to indicate an important piece of text, or <em><nowiki><em></nowiki></em> (subject to the same things as strong) to indicate an emphasized piece of text. For instance, the above might be better reformulated as

<nowiki>This is <em style="color:red;font-style:normal">red</em> text.</nowiki>

<blockquote>This is <em style="color:red;font-style:normal">red</em> text.</blockquote>

This not only draws the user's attention to the text, but can also alert those who are using nonvisual browsers or have sight impairments, etc. to the fact that that is <em>emphasized text</em>.

Using {{timc|H:title}}, <nowiki>"a height of {{h:title|6.1 km|20000 ft}} above sea level"</nowiki> gives "a height of {{h:title|6.1 km|20000 ft}} above sea level" (note the hover box over "20000 ft").

==Font==

''Note: This element is [[w:Deprecation|deprecate]]d (should not be used) in favor of [[#Span|<nowiki><span></nowiki>]].''

For some attributes, like color, one can also use

<pre>
a <font color="red">red</font> word.
</pre>

giving

a <font color="red">red</font> word

It's pointless to combine the legacy tag <tt><font></tt>
with inline CSS; legacy browsers would ignore the CSS, while
modern browsers support <tt><span></tt> (see above).

==Div==

E.g. to assign the class "red" to a text one can put

<div class="red">example text</div>

which gives <div class="red">example text</div> which is in red if the css line

.red {color:red}

is applicable.

This is suitable if the color is specifically intended to be red; if it is just for emphasis a more general term for the class would be more appropriate, because css allows the user to choose another method of emphasis (another color, bold, enlarged, etc.).

Note that many readers will not have their own css with such lines as ".red {color:red}", so one cannot refer to "the red text above", etc.

==MediaWiki namespace==
In some pages in the MediaWiki namespace HTML does not work, and e.g. <span id=abc> produces the HTML &lt;span id=abc&gt; rendered by the browser as <span id=abc>.

==Style pages==
CSS and JS pages (see [[Help:User style]]) are not interpreted as wikitext, and therefore can have arbitrary HTML.

==External links==

* [http://www.w3.org/TR/html401/index/elements.html elements] | [http://www.w3.org/TR/html401/index/attributes.html attributes]

{{H:f|langs=|enname=HTML in wikitext}}

Help:HTML in wikitext - Revision history

Acorni at 10:15, 14 August 2010

Acorni: /* Permitted HTML */

Corni: 1 revision(s)

Corni: 1 revision(s)