Template:Font/doc

This is a documentation subpage for Template:Font.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used in system messages, and on approximately 7,700 pages.
Changes to it can cause immediate changes to the Wikipedia user interface.
To avoid major disruption, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Please discuss changes on the talk page before implementing them.

About

{{font}} is used to define text styles, for example, size and color. It can also be used to inject CSS. This can be useful when needed to change "I" in Arial to "I" in Times New Roman, since in Arial, uppercase "I" looks the same as lowercase "L".

Use

{{font|TEXT(or「text=TEXT」)|font=FONT|size=SIZE（px/em/pt/%|color=COLOR|bgcolor=BACKGROUND COLOR|css=CSS}}

Parameter list

text: The text to be changed.
font: The text's font.
A list of fonts supported by Wikipedia can be found here: Wikipedia:Typography#Available fonts.
size: The size of the text. Possible unit include px, em, pt, %.
color: The color of the text.
bgcolor: The background color.
css: A CSS style.

Examples

Markup	Display
`{{font\|text=Some text.\|font=\|size=\|color=}}`	Some text.
`{{font\|text=Some text.\|font=Comic Sans MS\|size=20px\|color=#7f5620}}`	Some text.
`{{font\|Illinois\|font=Times New Roman\|size=20px}}`	Illinois
`{{font\|Illinois\|font=Arial\|size=20px}}`	Illinois
`{{font\|啡色的文字。\|font=標楷體\|size=20px\|color=#7f5620}}`	啡色的文字。
`{{font\|text=Hello World!\|font=Century Gothic\|size=35px\|color=#bf00bf}}`	Hello World!
`{{font\|text=囧囧囧囧囧\|font=Simhei\|color=#c9b295\|bgcolor=#364d6a}}`	囧囧囧囧囧
`{{font\|text=可以選用全部選項。\|font=Simhei\|size=20px\|color=#5a7aad\|bgcolor=#f9f9ef}}`	可以選用全部選項，
`{{font\|text=也可以只選用其中一項選項。\|size=25px}}`	也可以只選用其中一項選項。

Defaults

Parameter	Default
`font`	Sans-serif
`size`	100%
`color`	black
`bgcolor`	transparent

Limitations

This template should not be used around multiple paragraphs. For example, it should not be used around multiple bullet or numbered points or more than one cell of a table. It may, however, surround as many uses of <br /> as desired.

Template data

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for this template in articles based on this TemplateData.

TemplateData for Font

Template data parameterlist

Set text font, size, and color.

Template parameters
Parameter		Description	Type	Status
text	`text`	no description	Unknown	optional
1	`1`	no description	Unknown	optional
font	`font`	no description	Unknown	optional
size	`size`	no description	Unknown	optional
color	`color`	no description	Unknown	optional
bgcolor	`bgcolor`	no description	Unknown	optional
title	`title`	no description	Unknown	optional
css	`css`	no description	Unknown	optional

Code for inline content	Code for block content	Size	Result
`{{small\|text}}` `{{smaller\|text}}`	`{{smalldiv\|text}}`	85%	text
`{{resize\|text}}`	`{{resizediv\|text}}`	90%	text
`{{midsize\|text}}`		92%	text
none	none	100%	text
`{{large\|text}}` `{{larger\|text}}` `{{big\|text}}`	`{{largediv\|text}}`	120%	text
`{{huge\|text}}`		180%	text
`{{resize\|x%\|text}}`	`{{resizediv\|x%\|text}}`	custom	varies
`{{font\|size=x%}}`		custom	varies