Template:Scriptfonts/doc

This is the documentation subpage for the parent Template:Scriptfonts page.

Usage:: Utility to translate ISO 15924 script codes into a list of usable fonts that allow rendering the script on the web.

Syntax:

{{Scriptfonts

| 1=script

| 2=lang

}}

Parameters:

1=script (mandatory) – 4-letter code representing the script name, or 3-digit code, or Unicode alias (Basic English name with all words capitalized and glued by underscores) if the Unicode standard assigned one. The letter case of this parameter is not significant.
This recognizes all ISO 15924 codes (whose letter case is not significant), including numeric codes, and aliases referenced by the Unicode Character Database (with capitalized initials and underscores as word separators).
2=lang (optional) – A valid BCP 47 language tag into which the script name will be translated. Its letter case is not significant.
The default empty value will return the fonts suitable for the UI language in the current user language selected in the UI, using {{USERLANGUAGE}}.
nodefault= (optional) – if set to any non-empty value and the requested script is not Latin, this disables the addition of common fallbacks fonts supporting the Latin script (including 'sans-serif' which is a standard fallback alias supported by web browsers); the returned list may be empty (notably for scripts that still don't have known open fonts supporting them), otherwise it will be terminated by a comma. This may be used to determine is the script can be safely supported. Most scripts encoded in Unicode have now at least one open font supporting them (but transiently, for newly encoded scripts, there may still be none: those scripts will be visible in ISO 15924 with a "Status: Later", meaning that they can't be safely supported for now in translatewiki.net, except by very few users using proprietary fonts on specifically installed systems).

Notes:

For now the list of fonts are based on the generic sans-serif style as the prefered one, the list of fonts are not tuned to offer an alternative for the generic serif or monospace style.
Fonts are listed by order of coverage; they may be tuned script by script if additional fonts are available or needed for correct rendering on some platforms.
Each script has its own lists of fonts, except Latin whose fonts are always listed at end to provide additional fallback fonts. The 'Noto Sans' font families are included in the list, but as they may not be installed no many systems, some other known fonts frequenely installed for specific OSes are also present (so that users will still be able to use contents written with each supported script without using complex installation or maintenance tasks on their systems).
All font lists are terminated by a generic font style defined in standard CSS to support other defaults that users may have set up in their browsers.

Examples:

‹{{Scriptfonts|Latn}}› generates ‹'Noto Sans',Arimo,'Avrile Sans',FreeSans,'Segoe UI',Corbel,Gadugi,AfSans,'Lucida Sans Unicode','Lucida Grande','Lucida Sans','Microsoft Sans Serif',Arial,'Arial Unicode MS',Helvetica,Unifont,'Noto Serif','Avrile Serif',FreeSerif,Tinos,'Lucida Serif','Times New Roman',Times,'Lucida Console','Lucida Sans Typewriter','Lucida Typewriter Serif','Everson Mono',EversonMono,Code2000,Code2001,sans-serif›
‹{{Scriptfonts|Arab}}› generates ‹'Noto Sans Arabic',Andalus,'Noto Naskh Arabic',Amiri,'Noto Kufi Arabic','Microsoft Uighur','Noto Sans',Arimo,'Avrile Sans',FreeSans,'Segoe UI',Corbel,Gadugi,AfSans,'Lucida Sans Unicode','Lucida Grande','Lucida Sans','Microsoft Sans Serif',Arial,'Arial Unicode MS',Helvetica,Unifont,'Noto Serif','Avrile Serif',FreeSerif,Tinos,'Lucida Serif','Times New Roman',Times,'Lucida Console','Lucida Sans Typewriter','Lucida Typewriter Serif','Everson Mono',EversonMono,Code2000,Code2001,sans-serif›
‹{{Scriptfonts|Hebr}}› generates ‹'Noto Sans Hebrew',Aharoni,'Levenim MT','Noto Serif Hebrew','Ezra SIL','Ezra SIL SR','Keter Aram Tsova','Taamey Ashkenaz','Taamey David CLM','Taamey Frank CLM','Frank Ruehl CLM','Keter YG',Shofar,'David CLM','Hadasim CLM','Simple CLM',Nachlieli,'SBL BibLit','SBL Hebrew',Cardo,Alef,'David Libre',David,Gisha,'Hebrew Paleo Siloam','Noto Sans',Arimo,'Avrile Sans',FreeSans,'Segoe UI',Corbel,Gadugi,AfSans,'Lucida Sans Unicode','Lucida Grande','Lucida Sans','Microsoft Sans Serif',Arial,'Arial Unicode MS',Helvetica,Unifont,'Noto Serif','Avrile Serif',FreeSerif,Tinos,'Lucida Serif','Times New Roman',Times,'Lucida Console','Lucida Sans Typewriter','Lucida Typewriter Serif','Everson Mono',EversonMono,Code2000,Code2001,sans-serif›
‹{{Scriptfonts|Deva}}› generates ‹'Noto Sans Devanagari','Nirmala UI',Utsaah,Kokila,Mangal,Chandas,'Noto Serif Devanagari','Noto Sans',Arimo,'Avrile Sans',FreeSans,'Segoe UI',Corbel,Gadugi,AfSans,'Lucida Sans Unicode','Lucida Grande','Lucida Sans','Microsoft Sans Serif',Arial,'Arial Unicode MS',Helvetica,Unifont,'Noto Serif','Avrile Serif',FreeSerif,Tinos,'Lucida Serif','Times New Roman',Times,'Lucida Console','Lucida Sans Typewriter','Lucida Typewriter Serif','Everson Mono',EversonMono,Code2000,Code2001,sans-serif›
‹{{Scriptfonts|Thai}}› generates ‹'Noto Sans Thai','Leelawadee UI',Leelawadee,'Noto Looped Thai','Noto Serif Thai',Tahoma,'Noto Sans',Arimo,'Avrile Sans',FreeSans,'Segoe UI',Corbel,Gadugi,AfSans,'Lucida Sans Unicode','Lucida Grande','Lucida Sans','Microsoft Sans Serif',Arial,'Arial Unicode MS',Helvetica,Unifont,'Noto Serif','Avrile Serif',FreeSerif,Tinos,'Lucida Serif','Times New Roman',Times,'Lucida Console','Lucida Sans Typewriter','Lucida Typewriter Serif','Everson Mono',EversonMono,Code2000,Code2001,sans-serif›
‹{{Scriptfonts|Jamo}}› generates ‹'Noto Sans CJK KR','Noto Serif CJK KR',Gulim,'Malgun Gothic','Noto Sans',Arimo,'Avrile Sans',FreeSans,'Segoe UI',Corbel,Gadugi,AfSans,'Lucida Sans Unicode','Lucida Grande','Lucida Sans','Microsoft Sans Serif',Arial,'Arial Unicode MS',Helvetica,Unifont,'Noto Serif','Avrile Serif',FreeSerif,Tinos,'Lucida Serif','Times New Roman',Times,'Lucida Console','Lucida Sans Typewriter','Lucida Typewriter Serif','Everson Mono',EversonMono,Code2000,Code2001,sans-serif›
‹{{Scriptfonts|Cpmn}}› generates ‹'Noto Sans Cypro Minoan','Noto Sans',Arimo,'Avrile Sans',FreeSans,'Segoe UI',Corbel,Gadugi,AfSans,'Lucida Sans Unicode','Lucida Grande','Lucida Sans','Microsoft Sans Serif',Arial,'Arial Unicode MS',Helvetica,Unifont,'Noto Serif','Avrile Serif',FreeSerif,Tinos,'Lucida Serif','Times New Roman',Times,'Lucida Console','Lucida Sans Typewriter','Lucida Typewriter Serif','Everson Mono',EversonMono,Code2000,Code2001,sans-serif›
‹{{Scriptfonts|Nand}}› generates ‹'Noto Sans Nandinagari','Noto Serif Nandinagari','Noto Sans',Arimo,'Avrile Sans',FreeSans,'Segoe UI',Corbel,Gadugi,AfSans,'Lucida Sans Unicode','Lucida Grande','Lucida Sans','Microsoft Sans Serif',Arial,'Arial Unicode MS',Helvetica,Unifont,'Noto Serif','Avrile Serif',FreeSerif,Tinos,'Lucida Serif','Times New Roman',Times,'Lucida Console','Lucida Sans Typewriter','Lucida Typewriter Serif','Everson Mono',EversonMono,Code2000,Code2001,sans-serif›
‹{{Scriptfonts|Blis}}› generates ‹'Noto Sans',Arimo,'Avrile Sans',FreeSans,'Segoe UI',Corbel,Gadugi,AfSans,'Lucida Sans Unicode','Lucida Grande','Lucida Sans','Microsoft Sans Serif',Arial,'Arial Unicode MS',Helvetica,Unifont,'Noto Serif','Avrile Serif',FreeSerif,Tinos,'Lucida Serif','Times New Roman',Times,'Lucida Console','Lucida Sans Typewriter','Lucida Typewriter Serif','Everson Mono',EversonMono,Code2000,Code2001,sans-serif› (still unsupported by Unicode, so only basic fonts for Latin are returned)
‹{{Scriptfonts|Aran|nodefault=1}}› generates ‹'Noto Nastaliq Urdu','Awami Nastaliq','Amar-Nastaleeq','Urdu Typesetting','Noto Sans Arabic','Noto Naskh Arabic',Amiri,'Noto Kufi Arabic','Microsoft Uighur',›
‹{{Scriptfonts|Arab|nodefault=1}}› generates ‹'Noto Sans Arabic',Andalus,'Noto Naskh Arabic',Amiri,'Noto Kufi Arabic','Microsoft Uighur',›
‹{{Scriptfonts|Kore|nodefault=1}}› generates ‹'Noto Sans CJK KR','Noto Serif CJK KR',Gulim,'Malgun Gothic',›
‹{{Scriptfonts|Hani|nodefault=1}}› generates ‹'Noto Sans CJK JP','Noto Serif CJK JP','MS PGothic',›
‹{{Scriptfonts|Hant|nodefault=1}}› generates ‹'Noto Sans CJK TC','Noto Serif CJK TC','Microsoft JhengHei',PMingLiu,›
‹{{Scriptfonts|Hans|nodefault=1}}› generates ‹'Noto Sans CJK SC','Noto Serif CJK SC','Microsoft YaHei UI','Microsoft YaHei',SimSun,›

Useful collections of available free fonts with Unicode mappings:

See also:

ISO 15924 for the complete list of scripts supported
Template:Scriptname