Module:English variant notice/sandbox
Appearance
This is the module sandbox page for Module:English variant notice (diff). |
This Lua module is used on 67,000+ pages and changes may be widely noticed. Test changes in the module's /sandbox or /testcases subpages, or in your own module sandbox. Consider discussing changes on the talk page before implementing them. |
This module is for generating various english variant notice templates.
Automatically generates "variant" from title template that invokes it (e.g invoking from "Template:American English" gives "American English" as variant).
All templates using this support a |Oxford=
parameter for oxford spelling and |IUPAC=
automatically.
Usage
[edit]- small, form and including – unnecessary to use in templates as grabbed when passed in from talk pages
- id – the HTML id used in editnotices; "editnotice" is automatically appended
- image – name of file to be used as an icon, without the File: prefix.
- variant – defaults to the template name; the variant of English, which should be a Wikipedia article.
- spelling examples –gives spelling examples in parentheses
- compare –comparison variants of english
- text – custom text, set only if required to be different from the default
- doc if set to no, will not load the automatic documentation at Template:English variant notice/documentation
- editnotice_cat if set to yes, categorizes in edit notice category
- nocat disables documentation if set to true
- size set the size of the image (example:
|size=60px
)
Example
[edit]As of March 2018, Template:Hiberno-English uses the following parameters:
{{#invoke:English variant notice|main | id = hie | image = Four Provinces Flag.svg{{!}}border | spelling_examples = ''colour'', ''realise'', ''travelled'' | compare = [[British English|English]], [[Scottish English|Scottish]] and }}
which produces:
This module is written in Hiberno-English, which has its own spelling conventions (colour, realise, travelled) and some terms that are used in it may be different or absent from English, Scottish and other varieties of English. According to the relevant style guide, this should not be changed without broad consensus. |
See also
[edit]- The {{Use X English}} templates
local p = {}
local categoryHandler = require( 'Module:Category handler' ).main
local yesno = require('Module:Yesno')
local mArguments = require('Module:Arguments')
local n
function p.main (frame)
local fulltitle = frame:getParent():getTitle()
local templatetitle = string.sub(fulltitle, 10)
local title = mw.title.getCurrentTitle()
if mw.title.equals(title, mw.title.makeTitle('Template', title.rootText)) then --if it is on the main template page, load doc
n = mArguments.getArgs(frame, {parentFirst = true})
n.variant = n.variant or templatetitle --automatically use title generated from template name
if n.doc ~= 'no' then
return frame:expandTemplate {title = 'English variant notice/documentation', args = n}
end
end
return p._main (frame, templatetitle)
end
function p._main (frame, templatetitle)
n = mArguments.getArgs(frame, {parentFirst = true})
n.variant = n.variant or templatetitle --automatically use title generated from template name
n.category = ''
n.spelling_examples = n.spelling_examples or n['spelling examples']
n.bid = not not n.id --bool of n.id, for making iupac and oxford not be added to the id if it doesn't exist
--Generate the text if it isn't specified
if not n.text then
p.modify_text ()
p.base_text (frame)
end
p.cat ('Wikipedia articles that use '..n.variant)
return p.style(frame)..(n.category or '')
end
function p.cat (category)
category = string.format ('[[Category:%s]]', category)
n.category = n.category..(categoryHandler{category, nocat = n.nocat, page = n.page, talk = category, template = category} or '')
end
function p.modify_text ()
n.spelling = ''
n.extravariant = ''
n.extraguide = ''
bOxford = yesno(n.Oxford)
bIUPAC = yesno(n.IUPAC)
chemtext = "; ''aluminium'', ''sulfur'', and ''caesium''"
if bOxford then
n.spelling_examples = "''colour'', ''realize'', ''organization'', ''analyse''; note that '''-ize''' is used instead of -ise"
p.cat ('Wikipedia articles that use Oxford spelling')
if n.bid then n.id = n.id..n.Oxford end
if bIUPAC then
n.extravariant = ' with [[Oxford spelling|Oxford]] and [[IUPAC]] spelling'
n.spelling_examples= n.spelling_examples..chemtext
p.IUPAC ()
return
end
n.extravariant = n.extravariant..' with [[Oxford spelling]]'
return
elseif bIUPAC then
n.extravariant = ' with [[IUPAC]] spelling'
n.spelling_examples = n.spelling_examples and n.spelling_examples..chemtext or "''aluminium'', ''sulfur'', and ''caesium''"
p.IUPAC ()
return
end
--only if there are spelling examples, put 'has its own spelling conventions'
if n.spelling_examples then n.spelling = ', which has its own spelling conventions' end
end
function p.IUPAC ()
n.extraguide = ' and [[Wikipedia:Naming conventions (chemistry)|chemistry naming conventions]]'
p.cat('Wikipedia articles that use IUPAC spelling')
n.flag = 'no'
if n.bid then n.id = n.id..'iupac' end
end
function p.base_text (frame)
n.subjectspace = require('Module:Pagetype').main()
n.spelling_examples = n.spelling_examples and string.format(' (%s)', n.spelling_examples) or ''
n.terms = n[1] or n.terms
n.terms = n.terms and string.format(' (including %s)', n.terms) or ''
n.compare = n.compare and (n.compare..' ') or ''
n.text = string.format([=[This %s is '''written in [[%s]]%s'''%s%s, and some terms that are used in it%s may be different or absent from %sother [[List of dialects of the English language|varieties of English]]. According to the [[Wikipedia:Manual of Style#National varieties of English|relevant style guide]]%s, this should not be changed without broad consensus.]=],
n.subjectspace, n.variant, n.extravariant, n.spelling, n.spelling_examples, n.terms, n.compare, n.extraguide)
end
function p.style (frame)
local size
if yesno(n.small) then size = '30px'
elseif n.size then size = n.size
else size = '50px'
end
if n.image then
if n.flag == nil or yesno(n.flag) then
n.image = string.format('[[File:%s|%s]]', n.image, size)
else
--check if the globe should be "color" instead of "colour"
if yesno(n.color) then
n.image = string.format('[[File:Globe spelling color.png|%s]]', size)
else
n.image = string.format('[[File:Globe spelling colour.svg|%s]]', size)
end
end
end
if n.form == 'editnotice' then
if n.bid then n.id = n.id..'editnotice' end
n.expiry = n.expiry or 'indefinite'
--categorize editnotice if specified
if yesno(n.editnotice_cat) then
p.cat(string.format('Pages with editnotice %s editnotice', n.variant))
end
return frame:expandTemplate{title = 'editnotice', args = n}
else
local message_box = require('Module:Message box').main
if not n.image then n.image = 'none' end
n['type'] = 'style'
return message_box ('tmbox', n)
end
end
return p