Template:a or an/doc
This template is used on approximately 8,200 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
This is a documentation subpage for Template:A or an. It may contain usage information, categories and other content that is not part of the original template page. |
This template uses Lua: |
This template determines whether the first word in the argument provided begins with a vowel or consonant and returns with it "a" or "an" depending on the assessment.
Usage
[edit]In general, it returns "an" if the first letter is a, e, i, o, or u, and "a" if any other:
"{{a or an|word}}"
→ "a word""{{a or an|elephant}}"
→ "an elephant"
To capitalize "a", wrap the template in {{ucfirst:...}}
.
"{{ucfirst:{{a or an|word}}}}"
→ "A word""{{ucfirst:{{a or an|elephant}}}}"
→ "An elephant"
Words beginning with a vowel letter
[edit]Words that begin with eu, ew, uni, etc., and others like one, once, and U are exceptions:
"{{a or an|European}}"
→ "a European""{{a or an|one-sided game}}"
→ "a one-sided game""{{a or an|U-turn}}"
→ "a U-turn""{{a or an|Ukrainian}}"
→ "a Ukrainian""{{a or an|university}}"
→ "a university"
Some exceptions are made to the above rule.
"{{a or an|Euler diagram}}"
→ "an Euler diagram""{{a or an|unimportant case}}"
→ "an unimportant case"
Words beginning with a consonant letter
[edit]Words that begin with a consonant letter also have some exceptions:
"{{a or an|heir}}"
→ "an heir""{{a or an|hour}}"
→ "an hour""{{a or an|honor}}"
→ "an honor""{{a or an|honour}}"
→ "an honour""{{a or an|nth degree}}"
→ "an nth degree""{{a or an|x-ray image}}"
→ "an x-ray image""{{a or an|Xbox}}"
→ "an Xbox""{{a or an|ytterbium fiber}}"
→ "an ytterbium fiber"
Abbreviations
[edit]Words in all caps are treated as initialisms. If an initialism begins with F, H, L, M, N, R, S, or X, it returns "an". If it begins with U, it returns "a". Thus:
"{{a or an|LED}}"
→ "an LED""{{a or an|led}}"
→ "a led""{{a or an|URL}}"
→ "a URL""{{a or an|url}}"
→ "an url"
Some notable acronyms are made exceptions.
"{{a or an|FIFA referee}}"
→ "a FIFA referee""{{a or an|NASA program}}"
→ "a NASA program""{{a or an|UNRWA ambulance}}"
→ "an UNRWA ambulance"
Numbers
[edit]If the first word begins with 8, 11, or 18, it returns "an", unless it is read with "hundred", "thousand", etc. at the beginning.
"{{a or an|11}}"
→ "an 11""{{a or an|18th}}"
→ "an 18th""{{a or an|110}}"
→ "a 110""{{a or an|1800}}"
→ "an 1800" (assumes it's a year)"{{a or an|1,800}}"
→ "a 1,800""{{a or an|180,000}}"
→ "a 180,000""{{a or an|180000}}"
→ "a 180000""{{a or an|18,000,000}}"
→ "an 18,000,000""{{a or an|18000000}}"
→ "an 18000000"
Currency signs at the beginning are ignored.
"{{a or an|£8}}"
→ "an £8"
Ambiguous cases
[edit]If |variety=us
is set, herb(s) and herbal are treated as starting with a vowel sound.
"{{a or an|herb}}"
→ "a herb""{{a or an|herb|variety=us}}"
→ "an herb"
Words before which people have not settled on whether to use "a" or "an" are generally not made exceptions, so the general rules apply.
"{{a or an|FAQ}}"
→ "an FAQ""{{a or an|upsilon}}"
→ "an upsilon"
If the first letter is a non-Latin character, it returns "a" by default.
"{{a or an|あ}}"
→ "a あ"
If the parameter is not entered, it returns an empty string.
"{{a or an}}"
→ ""