View source for Template:Infobox typeface/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) --><includeonly>
</includeonly>
{{auto short description}}
'''{{Tlx|Infobox typeface}}''' adds an [[WP:INFOBOX|Infobox]] to an article on a [[typeface]].

==Usage==
<!--Newer attributes to be incorporated soon!-->
{{Parameter names example|_template=|name|image|image_size|caption|imagesize|alt|style|classifications|creator|commissioned_by|foundry|creationdate|releasedate|foundries|license|based_on|variations|aka|trademark|sample|shown_here|sample_fullimage|website|arabic|cyrillic|devangari|greek|hebrew|ipa|latin}}
<syntaxhighlight lang="wikitext" style="overflow: auto;">
{{Infobox typeface
| name             = 
| image            = 
| image_size       = 
| alt              = 
| caption          =
| style            = 
| classifications  = 
| creator          = 
| commissioned_by  = 
| foundry          = 
| creationdate     = 
| releasedate      = 
| foundries        = 
| characters       = 
| glyphs           = 
| license          = 
| based_on         = 
| variations       = 
| aka              = 
| metrically_compatible_with = 
| trademark        = 
| sample           = 
| shown_here       = 
| sample_fullimage = 
| website          = {{url|www.example.com}}
| latest_release_version = 
| latest_release_date    = 
| arabic           = 
| cyrillic         = 
| devangari        = 
| greek            = 
| hebrew           = 
| ipa              = 
| latin            = 
}}
</syntaxhighlight>

===Attributes===

====Required====
; name : Name of the typeface. Please be specific so the font preview works well.
; style : Style of the typeface: Serif, Sans-serif, Script, Blackletter, Display, Symbol

====Optional ''(Not required, but recommended)''====
; image : Image of name of the font, set in its own face. This is different than the '''sample''' attribute below. <br />''[[SVG]] file format is recommended.''
; imagesize : Width of the image to display (default is 300px).
; caption : Caption for image, if needed.
; classifications : The [[Vox-ATypI classification]] for the typeface, such as "Humanist", "Didone", "Geometric", or "Lineal humanist".
; creator : Name of this font's designer(s), if known. Otherwise leave blank and fill in foundry name.
; commissioned_by : Name of organization or individual who originally commissioned the typeface to be created.
; foundry : The original distributor and license owners of the typeface.<!-- Include current owners, if known. Otherwise, just write "Unknown".
--><br />Note: [[Monotype]] doesn't link to the foundry.
; creationdate : The year the font was created.
; releasedate : The year the typeface was first released, if different than the creation date.
; foundries : The names of foundries that have re-issued the typeface in the same format or formats differing from the original, e.g., [[computer font|digital]].
; glyphs : The number of [[glyph]]s the font contains, or an estimate if not available.
; characters : The number of unique [[Character (computing)|characters]]; specify encoding if other than [[Unicode]].
; license : The license the font is published under, e.g. "[[SIL Open Font License|OFL]]", "[[CC0#Seven_regularly_used_licenses|CC0]]", or "[[Proprietary software|Proprietary]]".
; based_on : Refers to the original design on which a revival, reinterpretation, homage or extension is based upon. This is not the same as a clone, for which the "aka" attribute should be used.
; variations : List of alternate foundry type designs based on the [[letterform]]s of this typeface. For instance, "[[Garamond]]", "Adobe Garamond", and "ITC Garamond" are different designs, yet are all based on the same original typeface.
; aka : Alternate (or imitation) names for other fonts based on this typeface. For instance, "[[Swiss 721]]" is [[Bitstream Inc.|Bitstream]]'s name for its release of [[Helvetica]].
; metrically_compatible_with : A [[metric-compatible|metrically compatible]] typeface, or a [[Template:Plainlist|plainlist]] of such typefaces. Where the typeface has an article in Wikipedia, wikilink it. See this [https://wiki.archlinux.org/index.php/Metric-compatible_fonts ArchWiki page] for examples, but avoid linking clones lacking notability.
; trademark : The owner of the font name, or the holder of the font's trademark.
; sample : A sample of the font, displaying a single large character ("g"), the [[The quick brown fox jumps over the lazy dog|"quick brown fox" pangram]], and a set of characters (A–Z, a–z, 0-9, basic punctuation). <br />''[[SVG]] file format is recommended.''
; shown here : Names the version of the font pictured in the illustration.
; sample_fullimage : A large sample image of the font, displaying its full character set (typically, the standard 256 glyphs of a [[TrueType]] font). <br />''[[SVG]] file format is recommended.''
; website : The web site URL, if any, of the font.<br />Use <code><nowiki>{{URL|http://www.example.com}}</nowiki></code>
; latest_release_version : most recent release of the font
; latest_release_date : date when the most recent version was published.<br />Use <code><nowiki>{{release date and age|YYYY|MM|DD}}</nowiki></code>

=== Coverage ===
; arabic : Set ''yes'' if it contains these characters.
; cyrillic : Set ''yes'' if it contains these characters.
; devangari : Set ''yes'' if it contains these characters.
; greek : Set ''yes'' if it contains these characters.
; emoji : <!-- Set the emoji-Version number 4, 5, or 11 ???-->  ''Proposed TBD?''
; hebrew : Set ''yes'' if it contains these characters.
; ipa : Set ''yes'' if it contains these characters.
; latin : Set ''yes'' if it contains these characters.

==Examples==

===Normal syntax===
{{Infobox typeface
| name             = Bookman
| image            = Bookman font.svg
| style            = [[Serif]]
| classifications  = [[Slab serif]]
| releasedate      = 1860
| creator          = [[Alexander Phemister]]
| foundry          = [[International Typeface Corporation|ITC]]
| sample           = [[File:Bookman_sample.svg|220px|Bookman sample text]]
| sample_fullimage = Bookman.png
}}

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox typeface
| name             = Bookman
| image            = Bookman font.svg
| style            = [[Serif]]
| classifications  = [[Slab serif]]
| releasedate      = 1860
| creator          = [[Alexander Phemister]]
| foundry          = [[International Typeface Corporation|ITC]]
| sample           = [[File:Bookman_sample.svg|220px|Bookman sample text]]
| sample_fullimage = Bookman.png
}}
</syntaxhighlight>
{{clear}}

===Minimal syntax===
{{Infobox typeface
| name  = Comic Sans
| style = [[Script (typefaces)|Script]]
}}

<syntaxhighlight lang="wikitext" style="overflow:auto;">
{{Infobox font
| name  = Comic Sans
| style = [[Script (typefaces)|Script]]
}}
</syntaxhighlight>
{{clear}}

===Optimal syntax===
{{Infobox typeface
| name         = Helvetica
| image        = Helvetica font.svg
| style        = [[Sans-serif]]
| aka          = [[Swiss 721]]
| creationdate = 1957
| creator      = [[Max Miedinger]]
| foundry      = {{plainlist|
* [[Haas Type Foundry|Haas’sche Schriftgießerei]]
* [[Mergenthaler Linotype Company|Linotype]]
}}
| variations   = {{plainlist|
* [[Helvetica Neue]]
* [[Helvetica Rounded]]
* [[Nimbus Sans]]
}}
 | metrically_compatible_with = {{plainlist|
* [[Arial]]
* [[Liberation Sans]]
}}
| sample       = [[File:Helvetica sample.svg|220px|Sample text]]
}}

<syntaxhighlight lang="wikitext" style="overflow:auto;">
 {{Infobox typeface
 | name         = Helvetica
 | image        = Helvetica font.svg
 | style        = [[Sans-serif]]
 | aka          = [[Swiss 721]]
 | creationdate = 1957
 | creator      = [[Max Miedinger]]
 | foundry      = {{plainlist|
 * [[Haas Type Foundry|Haas’sche Schriftgießerei]]
 * [[Mergenthaler Linotype Company|Linotype]]
 }}
 | variations   = {{plainlist|
 * [[Helvetica Neue]]
 * [[Helvetica Rounded]]
 * [[Nimbus Sans]]
 }}
 | metrically_compatible_with = {{plainlist|
 * [[Arial]]
 * [[Liberation Sans]]
 }}
 | sample       = [[File:Helvetica sample.svg|220px|Sample text]]
 }}
</syntaxhighlight>
{{clear}}

==TemplateData==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"name": {
			"label": "Name",
			"required": true
		},
		"image": {
			"label": "Image",
			"description": "Specimen image of the font, or an image of the name of the font set in its own type",
			"type": "wiki-file-name",
			"suggested": true
		},
		"image_size": {
			"description": "width of the image to display",
			"default": "300px"
		},
		"caption": {
			"description": "Caption for image, if needed. Try to include the date of image, some context (check the File: or Commons page for the image). Image credit should generally not be included per [[MOS:CREDITS]].",
			"type": "string"
		},
		"alt": {},
		"style": {
			"label": "Category",
			"description": "Style of the typeface",
			"type": "string",
			"required": true,
			"example": "Serif, Sans-serif, Script, Blackletter, Display, Symbol"
		},
		"classifications": {
			"label": "Classification",
			"description": "The Vox-ATypI classification for the typeface",
			"example": "Humanist, Didone, Geometric, or Lineal humanist"
		},
		"creator": {
			"label": "Designer(s)",
			"description": "Name of this font's designer(s), if known."
		},
		"commissioned_by": {
			"label": "Commissioned by",
			"description": "Organization or individual who commissioned the typeface to be created"
		},
		"foundry": {
			"label": "Foundry",
			"description": "Original distributor and license owner",
			"suggested": true
		},
		"creationdate": {
			"label": "Date created",
			"type": "date",
			"suggested": true
		},
		"releasedate": {
			"label": "Date released",
			"type": "date"
		},
		"foundries": {
			"label": "Re-issuing foundries"
		},
		"characters": {
			"label": "Characters",
			"description": "number of unique characters"
		},
		"glyphs": {
			"label": "Glyphs",
			"description": "The number of glyphs the font contains, or an estimate",
			"type": "number"
		},
		"license": {
			"label": "License",
			"example": "OFL, CC0, or Proprietary"
		},
		"based_on": {
			"label": "Design based on",
			"description": "original design on which a revival, reinterpretation, homage or extension is based upon"
		},
		"variations": {},
		"aka": {
			"label": "Also known as",
			"description": "Alternate (or imitation) names for other fonts based on this typeface"
		},
		"trademark": {},
		"sample": {},
		"shown_here": {},
		"sample_fullimage": {},
		"website": {
			"label": "Website",
			"description": "web site URL, if any, of the font",
			"type": "url"
		},
		"latest_release_version": {
"description": "The version number of the most recent version of this typeface."
		},

"latest_release_date": {

"description": "The date that most recent version of this typeface was released."
		},

"metrically_compatible_with": {
			"description": "A metrically compatible typeface, or a plainlist of such typefaces"
		},
		"arabic": {
			"description": "Set yes if it contains these characters"
		},
		"cyrillic": {
			"description": "Set yes if it contains these characters"
		},
		"devangari": {
			"description": "Set yes if it contains these characters"
		},
		"greek": {
			"description": "Set yes if it contains these characters"
		},
		"hebrew": {
			"description": "Set yes if it contains these characters"
		},
		"ipa": {
			"description": "Set yes if it contains these characters"
		},
		"latin": {
			"description": "Set yes if it contains these characters"
		}
	},
	"description": "Infobox for typefaces (font families)",
	"paramOrder": [
		"name",
		"image",
		"image_size",
		"alt",
        "caption",
		"style",
		"classifications",
		"creator",
		"commissioned_by",
		"foundry",
		"creationdate",
		"releasedate",
		"foundries",
		"characters",
		"glyphs",
		"license",
		"based_on",
		"variations",
		"aka",
		"trademark",
		"sample",
		"shown_here",
		"sample_fullimage",
		"website",
		"latest_release_version",
		"latest_release_date",
		"metrically_compatible_with",
		"arabic",
		"cyrillic",
		"devangari",
		"greek",
		"hebrew",
		"ipa",
		"latin"
	],
	"format": "block"
}
</templatedata>

==Redirects==
* {{lts|Infobox font}}
* {{lts|TypeBox}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Arts and culture infobox templates|Typeface]]
[[Category:Computing infobox templates|Typeface]]
[[Category:Publishing infobox templates|Typeface]]
}}</includeonly>