From Wayne County (OH) Wiki
Jump to navigation Jump to search

The module “URL” contains (specify) available calls that make so and such.

Usage[edit source]


Parameters[edit source]

The text below assumes that functions are declared as

function p.function_name( frame )
  • Positional parameters – the value of frame.args[1] is passed after function name and vertical bar, the value of frame.args[2] is passed after the value of frame.args[1] and vertical bar, and so on.
  • Named parameters (specify them) – the same name=value syntax as in MediaWiki templates, are accessible inside the function as frame.args["name"].

Examples[edit source]

Further information: Module:URL/testcases

-- This module implements {{URL}}
-- See unit tests at [[Module:URL/tests]]

local p = {}
function trim(s)
    return (mw.ustring.gsub(s, "^%s*(.-)%s*$", "%1"))

function safeUri(s)
    local success, uri = pcall(function()
    if success then
        return uri

function p._url(url, text)
    url = trim(url or '')
    text = trim(text or '')
    if url == '' then
        if text == '' then
            return mw.getCurrentFrame():expandTemplate{ title = 'tlx', args = { 'URL', "''''", "''optional display text''" } }
            return text
    -- If the URL contains any unencoded spaces, encode them, because MediaWiki will otherwise interpret a space as the end of the URL.
    url = mw.ustring.gsub(url, '%s', function(s) return mw.uri.encode(s, 'PATH') end)
    -- If there is an empty query string or fragment id, remove it as it will cause to throw an error
    url = mw.ustring.gsub(url, '#$', '')
    url = mw.ustring.gsub(url, '%?$', '')
    -- If it's an HTTP[S] URL without the double slash, fix it.
    url = mw.ustring.gsub(url, '^[Hh][Tt][Tt][Pp]([Ss]?):(/?)([^/])', 'http%1://%3')

    -- Handle URLs from Wikidata of the format http://
    url = mw.ustring.gsub(url, '^[Hh][Tt][Tt][Pp]([Ss]?)://', 'http%1://')
    local uri = safeUri(url)
    -- Handle URL's without a protocol and URL's that are protocol-relative, 
    -- e.g. or, and //
    if uri and (not uri.protocol or (uri.protocol and not and url:sub(1, 2) ~= '//' then
        url = 'http://' .. url
        uri = safeUri(url)
    if text == '' then
        if uri then
            if uri.path == '/' then uri.path = '' end
            local port = ''
            if uri.port then port = ':' .. uri.port end
            text = mw.ustring.lower( or '') .. port .. (uri.relativePath or '')
        else -- URL is badly-formed, so just display whatever was passed in
            text = url

    return mw.ustring.format('<span class="url">[%s %s]</span>', url, text)

function p.url(frame)
    local templateArgs = frame.args
    local url = templateArgs[1] or ''
    local text = templateArgs[2] or ''
    return p._url(url, text)

return p