Difference between revisions of "Module:Delink"

From Sim Football Wiki
Jump to navigation Jump to search
m (Protected "Module:Delink": Highly visible template: 55,000+ mainspace transclusions ([Edit=Allow only template editors and admins] (indefinite) [Move=Allow only template editors and admins] (indefinite)))
 
m (replace reference to "strict" with "Module:No globals")
 
(5 intermediate revisions by 3 users not shown)
Line 8: Line 8:
  
 
local function delinkReversePipeTrick(s)
 
local function delinkReversePipeTrick(s)
    if s:match("^%[%[|.*[|\n]") then -- Check for newlines or multiple pipes.
+
if s:match("^%[%[|.*[|\n]") then -- Check for newlines or multiple pipes.
        return s
+
return s
    else
+
end
        return s:match("%[%[|(.*)%]%]")
+
return s:match("%[%[|(.*)%]%]")
    end
+
 
 
end
 
end
  
 
local function delinkPipeTrick(s)
 
local function delinkPipeTrick(s)
    local linkarea, display = "", ""
+
-- We need to deal with colons, brackets, and commas, per [[Help:Pipe trick]].
    -- We need to deal with colons, brackets, and commas, per [[Help:Pipe trick]].
+
-- First, remove the text before the first colon, if any.
   
+
if s:match(":") then
    -- First, remove the text before the first colon, if any.
+
s = s:match("%[%[.-:(.*)|%]%]")
    if s:match(":") then
+
-- If there are no colons, grab all of the text apart from the square brackets and the pipe.
        s = s:match("%[%[.-:(.*)|%]%]")
+
else
    -- If there are no colons, grab all of the text apart from the square brackets and the pipe.
+
s = s:match("%[%[(.*)|%]%]")
    else
+
end
        s = s:match("%[%[(.*)|%]%]")
+
    end
+
-- Next up, brackets and commas.
   
+
if s:match("%(.-%)$") then -- Brackets trump commas.
    -- Next up, brackets and commas.
+
s = s:match("(.-) ?%(.-%)$")
    if s:match("%(.-%)$") then -- Brackets trump commas.
+
elseif s:match(",") then -- If there are no brackets, display only the text before the first comma.
        s = s:match("(.-) ?%(.-%)$")
+
s = s:match("(.-),.*$")
    elseif s:match(",") then -- If there are no brackets, display only the text before the first comma.
+
end
        s = s:match("(.-),.*$")
+
return s
    end
 
    return s
 
 
end
 
end
  
local function delinkWikilink(s)
+
-- Return wikilink target |wikilinks=target
    local result = s
+
local function getDelinkedTarget(s)
    -- Deal with the reverse pipe trick.
+
local result = s
    if result:match("%[%[|") then
+
-- Deal with the reverse pipe trick.
        return delinkReversePipeTrick(result)
+
if result:match("%[%[|") then
    end
+
return delinkReversePipeTrick(result)
   
+
end
    result = mw.uri.decode(result, "PATH") -- decode percent-encoded entities. Leave underscores and plus signs.
+
    result = mw.text.decode(result, true) -- decode HTML entities.
+
result = mw.uri.decode(result, "PATH") -- decode percent-encoded entities. Leave underscores and plus signs.
   
+
result = mw.text.decode(result, true) -- decode HTML entities.
    -- Check for bad titles. To do this we need to find the
+
    -- title area of the link, i.e. the part before any pipes.
+
-- Check for bad titles. To do this we need to find the
    local titlearea
+
-- title area of the link, i.e. the part before any pipes.
    if result:match("|") then -- Find if we're dealing with a piped link.
+
local target_area
        titlearea = result:match("^%[%[(.-)|.*%]%]")
+
if result:match("|") then -- Find if we're dealing with a piped link.
    else
+
target_area = result:match("^%[%[(.-)|.*%]%]")
        titlearea = result:match("^%[%[(.-)%]%]")
+
else
    end
+
target_area = result:match("^%[%[(.-)%]%]")
    -- Check for bad characters.
+
end
    if mw.ustring.match(titlearea, "[%[%]<>{}%%%c\n]") then
 
        return s
 
    end
 
   
 
    -- Check for categories, interwikis, and files.
 
    local colonprefix = result:match("%[%[(.-):.*%]%]") or "" -- Get the text before the first colon.
 
    local ns = mw.site.namespaces[colonprefix] -- see if this is a known namespace
 
    if mw.language.isKnownLanguageTag(colonprefix)
 
    or ( ns and ( ns.canonicalName == "File" or ns.canonicalName == "Category" ) ) then
 
        return ""
 
    end
 
   
 
    -- Remove the colon if the link is using the [[Help:Colon trick]].
 
    if result:match("%[%[:") then
 
        result = "[[" .. result:match("%[%[:(.*%]%])")
 
    end
 
   
 
    -- Deal with links using the [[Help:Pipe trick]].
 
    if mw.ustring.match(result, "^%[%[[^|]*|%]%]") then
 
        return delinkPipeTrick(result)
 
    end
 
   
 
    -- Find the display area of the wikilink
 
    if result:match("|") then -- Find if we're dealing with a piped link.
 
        result = result:match("^%[%[.-|(.+)%]%]")
 
        -- Remove new lines from the display of multiline piped links,
 
        -- where the pipe is before the first new line.
 
        result = result:gsub("\n", "")
 
    else
 
        result = result:match("^%[%[(.-)%]%]")
 
    end
 
  
    return result
+
-- Check for bad characters.
 +
if mw.ustring.match(target_area, "[%[%]<>{}%%%c\n]") and mw.ustring.match(target_area, "[%[%]<>{}%%%c\n]") ~= "?" then
 +
return s
 +
end
 +
 +
return target_area
 +
end
 +
 
 +
local function getDelinkedLabel(s)
 +
local result = s
 +
-- Deal with the reverse pipe trick.
 +
if result:match("%[%[|") then
 +
return delinkReversePipeTrick(result)
 +
end
 +
 
 +
result = mw.uri.decode(result, "PATH") -- decode percent-encoded entities. Leave underscores and plus signs.
 +
result = mw.text.decode(result, true) -- decode HTML entities.
 +
 
 +
-- Check for bad titles. To do this we need to find the
 +
-- title area of the link, i.e. the part before any pipes.
 +
local target_area
 +
if result:match("|") then -- Find if we're dealing with a piped link.
 +
target_area = result:match("^%[%[(.-)|.*%]%]")
 +
else
 +
target_area = result:match("^%[%[(.-)%]%]")
 +
end
 +
 
 +
-- Check for bad characters.
 +
if mw.ustring.match(target_area, "[%[%]<>{}%%%c\n]") and mw.ustring.match(target_area, "[%[%]<>{}%%%c\n]") ~= "?" then
 +
return s
 +
end
 +
 
 +
-- Check for categories, interwikis, and files.
 +
local colon_prefix = result:match("%[%[(.-):.*%]%]") or "" -- Get the text before the first colon.
 +
local ns = mw.site.namespaces[colon_prefix] -- see if this is a known namespace
 +
if mw.language.isKnownLanguageTag(colon_prefix) or (ns and (ns.canonicalName == "File" or ns.canonicalName == "Category")) then
 +
return ""
 +
end
 +
 
 +
-- Remove the colon if the link is using the [[Help:Colon trick]].
 +
if result:match("%[%[:") then
 +
result = "[[" .. result:match("%[%[:(.*%]%])")
 +
end
 +
 
 +
-- Deal with links using the [[Help:Pipe trick]].
 +
if mw.ustring.match(result, "^%[%[[^|]*|%]%]") then
 +
return delinkPipeTrick(result)
 +
end
 +
 +
-- Find the display area of the wikilink
 +
if result:match("|") then -- Find if we're dealing with a piped link.
 +
result = result:match("^%[%[.-|(.+)%]%]")
 +
-- Remove new lines from the display of multiline piped links,
 +
-- where the pipe is before the first new line.
 +
result = result:gsub("\n", "")
 +
else
 +
result = result:match("^%[%[(.-)%]%]")
 +
end
 +
 
 +
return result
 
end
 
end
  
 
local function delinkURL(s)
 
local function delinkURL(s)
    -- Assume we have already delinked internal wikilinks, and that
+
-- Assume we have already delinked internal wikilinks, and that
    -- we have been passed some text between two square brackets [foo].
+
-- we have been passed some text between two square brackets [foo].
   
+
    -- If the text contains a line break it is not formatted as a URL, regardless of other content.
+
-- If the text contains a line break it is not formatted as a URL, regardless of other content.
    if s:match("\n") then
+
if s:match("\n") then
        return s
+
return s
    end
+
end
   
+
    -- Check if the text has a valid URL prefix and at least one valid URL character.
+
-- Check if the text has a valid URL prefix and at least one valid URL character.
    local valid_url_prefixes = {"//", "http://", "https://", "ftp://", "gopher://", "mailto:", "news:", "irc://"}  
+
local valid_url_prefixes = {"//", "http://", "https://", "ftp://", "gopher://", "mailto:", "news:", "irc://"}  
    local url_prefix
+
local url_prefix
    for i,v in ipairs(valid_url_prefixes) do
+
for _ ,v in ipairs(valid_url_prefixes) do
        if mw.ustring.match(s, '^%[' .. v ..'[^"%s].*%]' ) then
+
if mw.ustring.match(s, '^%[' .. v ..'[^"%s].*%]' ) then
            url_prefix = v
+
url_prefix = v
            break
+
break
        end
+
end
    end
+
end
   
+
    -- Get display text
+
-- Get display text
    if not url_prefix then
+
if not url_prefix then
        return s
+
return s
    end
+
end
    s = s:match("^%[" .. url_prefix .. "(.*)%]") -- Grab all of the text after the URL prefix and before the final square bracket.
+
s = s:match("^%[" .. url_prefix .. "(.*)%]") -- Grab all of the text after the URL prefix and before the final square bracket.
    s = s:match('^.-(["<> ].*)') or "" -- Grab all of the text after the first URL separator character ("<> ).
+
s = s:match('^.-(["<> ].*)') or "" -- Grab all of the text after the first URL separator character ("<> ).
    s = mw.ustring.match(s, "^%s*(%S.*)$") or "" -- If the separating character was a space, trim it off.
+
s = mw.ustring.match(s, "^%s*(%S.*)$") or "" -- If the separating character was a space, trim it off.
   
+
    local s_decoded = mw.text.decode(s, true)
+
local s_decoded = mw.text.decode(s, true)
    if mw.ustring.match(s_decoded, "%c") then
+
if mw.ustring.match(s_decoded, "%c") then
        return s
+
return s
    else   
+
end
        return s_decoded
+
 
    end
+
return s_decoded
 +
 
 
end
 
end
  
local function delinkLinkClass(s, pattern, delinkFunction)
+
local function delinkLinkClass(text, pattern, delinkFunction)
    if not type(s) == "string" then
+
if type(text) ~= "string" then
        error("Attempt to de-link non-string input.", 2)
+
error("Attempt to de-link non-string input.", 2)
    end
+
end
    if not ( type(pattern) == "string" and mw.ustring.sub(pattern, 1, 1) == "^" ) then
+
if type(pattern) ~= "string" or mw.ustring.sub(pattern, 1, 1) ~= "^" then
        error('Invalid pattern detected. Patterns must begin with "^".', 2)
+
error('Invalid pattern detected. Patterns must begin with "^".', 2)
    end
+
end
    -- Iterate over the text string, and replace any matched text. using the  
+
-- Iterate over the text string, and replace any matched text. using the  
    -- delink function. We need to iterate character by character rather  
+
-- delink function. We need to iterate character by character rather  
    -- than just use gsub, otherwise nested links aren't detected properly.
+
-- than just use gsub, otherwise nested links aren't detected properly.
    local result = ""
+
local result = ""
    while s ~= '' do
+
while text ~= "" do
        -- Replace text using one iteration of gsub.
+
-- Replace text using one iteration of gsub.
        s = mw.ustring.gsub(s, pattern, delinkFunction, 1)
+
text = mw.ustring.gsub(text, pattern, delinkFunction, 1)
        -- Append the left-most character to the result string.
+
-- Append the left-most character to the result string.
        result = result .. mw.ustring.sub(s, 1, 1)
+
result = result .. mw.ustring.sub(text, 1, 1)
        s = mw.ustring.sub(s, 2, -1)
+
text = mw.ustring.sub(text, 2, -1)
    end
+
end
    return result
+
return result
 
end
 
end
  
 
function p._delink(args)
 
function p._delink(args)
    local text = args[1] or ""
+
local text = args[1] or ""
    if args.refs == "yes" then
+
if args.refs == "yes" then
        -- Remove any [[Help:Strip markers]] representing ref tags. In most situations  
+
-- Remove any [[Help:Strip markers]] representing ref tags. In most situations  
        -- this is not a good idea - only use it if you know what you are doing!
+
-- this is not a good idea - only use it if you know what you are doing!
        text = mw.ustring.gsub(text, "UNIQ%w*%-ref%-%d*%-QINU", "")
+
text = mw.ustring.gsub(text, "UNIQ%w*%-ref%-%d*%-QINU", "")
    end
+
end
    if not (args.comments == "no") then
+
if args.comments ~= "no" then
        text = text:gsub("<!%-%-.-%-%->", "") -- Remove html comments.
+
text = text:gsub("<!%-%-.-%-%->", "") -- Remove html comments.
    end
+
end
    if not (args.wikilinks == "no") then
+
 
        text = delinkLinkClass(text, "^%[%[.-%]%]", delinkWikilink) -- De-link wikilinks.
+
if args.wikilinks ~= "no" and args.wikilinks ~= "target" then
    end
+
-- De-link wikilinks and return the label portion of the wikilink.
    if not (args.urls == "no") then
+
text = delinkLinkClass(text, "^%[%[.-%]%]", getDelinkedLabel)
        text = delinkLinkClass(text, "^%[.-%]", delinkURL) -- De-link URLs.
+
elseif args.wikilinks == "target" then
    end
+
-- De-link wikilinks and return the target portions of the wikilink.
    if not (args.whitespace == "no") then
+
text = delinkLinkClass(text, "^%[%[.-%]%]", getDelinkedTarget)
        -- Replace single new lines with a single space, but leave double new lines
+
end
        -- and new lines only containing spaces or tabs before a second new line.
+
if args.urls ~= "no" then
        text = mw.ustring.gsub(text, "([^\n \t][ \t]*)\n([ \t]*[^\n \t])", "%1 %2")
+
text = delinkLinkClass(text, "^%[.-%]", delinkURL) -- De-link URLs.
        text = text:gsub("[ \t]+", " ") -- Remove extra tabs and spaces.
+
end
    end
+
if args.whitespace ~= "no" then
    return text
+
-- Replace single new lines with a single space, but leave double new lines
 +
-- and new lines only containing spaces or tabs before a second new line.
 +
text = mw.ustring.gsub(text, "([^\n \t][ \t]*)\n([ \t]*[^\n \t])", "%1 %2")
 +
text = text:gsub("[ \t]+", " ") -- Remove extra tabs and spaces.
 +
end
 +
return text
 
end
 
end
  
 
function p.delink(frame)
 
function p.delink(frame)
    if not getArgs then
+
if not getArgs then
    getArgs = require('Module:Arguments').getArgs
+
getArgs = require('Module:Arguments').getArgs
    end
+
end
    return p._delink(getArgs(frame, {wrappers = 'Template:Delink'}))
+
return p._delink(getArgs(frame, {wrappers = 'Template:Delink'}))
 
end
 
end
  
 
return p
 
return p

Latest revision as of 06:51, 20 March 2024

Documentation for this module may be created at Module:Delink/doc

-- This module de-links most wikitext.

require('Module:No globals')

local p = {}

local getArgs

local function delinkReversePipeTrick(s)
	if s:match("^%[%[|.*[|\n]") then -- Check for newlines or multiple pipes.
		return s
	end
	return s:match("%[%[|(.*)%]%]")

end

local function delinkPipeTrick(s)
	-- We need to deal with colons, brackets, and commas, per [[Help:Pipe trick]].
	-- First, remove the text before the first colon, if any.
	if s:match(":") then
		s = s:match("%[%[.-:(.*)|%]%]")
	-- If there are no colons, grab all of the text apart from the square brackets and the pipe.
	else
		s = s:match("%[%[(.*)|%]%]")
	end
	
	-- Next up, brackets and commas.
	if s:match("%(.-%)$") then -- Brackets trump commas.
		s = s:match("(.-) ?%(.-%)$")
	elseif s:match(",") then -- If there are no brackets, display only the text before the first comma.
		s = s:match("(.-),.*$")
	end
	return s
end

-- Return wikilink target |wikilinks=target
local function getDelinkedTarget(s)
	local result = s
	-- Deal with the reverse pipe trick.
	if result:match("%[%[|") then
		return delinkReversePipeTrick(result)
	end
	
	result = mw.uri.decode(result, "PATH") -- decode percent-encoded entities. Leave underscores and plus signs.
	result = mw.text.decode(result, true) -- decode HTML entities.
	
	-- Check for bad titles. To do this we need to find the
	-- title area of the link, i.e. the part before any pipes.
	local target_area
	if result:match("|") then -- Find if we're dealing with a piped link.
		target_area = result:match("^%[%[(.-)|.*%]%]")
	else
		target_area = result:match("^%[%[(.-)%]%]")
	end

	-- Check for bad characters.
	if mw.ustring.match(target_area, "[%[%]<>{}%%%c\n]") and mw.ustring.match(target_area, "[%[%]<>{}%%%c\n]") ~= "?" then
		return s
	end
	
	return target_area
end

local function getDelinkedLabel(s)
	local result = s
	-- Deal with the reverse pipe trick.
	if result:match("%[%[|") then
		return delinkReversePipeTrick(result)
	end

	result = mw.uri.decode(result, "PATH") -- decode percent-encoded entities. Leave underscores and plus signs.
	result = mw.text.decode(result, true) -- decode HTML entities.

	-- Check for bad titles. To do this we need to find the
	-- title area of the link, i.e. the part before any pipes.
	local target_area
	if result:match("|") then -- Find if we're dealing with a piped link.
		target_area = result:match("^%[%[(.-)|.*%]%]")
	else
		target_area = result:match("^%[%[(.-)%]%]")
	end

	-- Check for bad characters.
	if mw.ustring.match(target_area, "[%[%]<>{}%%%c\n]") and mw.ustring.match(target_area, "[%[%]<>{}%%%c\n]") ~= "?" then
		return s
	end

	-- Check for categories, interwikis, and files.
	local colon_prefix = result:match("%[%[(.-):.*%]%]") or "" -- Get the text before the first colon.
	local ns = mw.site.namespaces[colon_prefix] -- see if this is a known namespace
	if mw.language.isKnownLanguageTag(colon_prefix) or (ns and (ns.canonicalName == "File" or ns.canonicalName == "Category")) then
		return ""
	end

	-- Remove the colon if the link is using the [[Help:Colon trick]].
	if result:match("%[%[:") then
		result = "[[" .. result:match("%[%[:(.*%]%])")
	end

	-- Deal with links using the [[Help:Pipe trick]].
	if mw.ustring.match(result, "^%[%[[^|]*|%]%]") then
		return delinkPipeTrick(result)
	end
	
	-- Find the display area of the wikilink
	if result:match("|") then -- Find if we're dealing with a piped link.
		result = result:match("^%[%[.-|(.+)%]%]")
		-- Remove new lines from the display of multiline piped links,
		-- where the pipe is before the first new line.
		result = result:gsub("\n", "")
	else
		result = result:match("^%[%[(.-)%]%]")
	end

	return result
end

local function delinkURL(s)
	-- Assume we have already delinked internal wikilinks, and that
	-- we have been passed some text between two square brackets [foo].
	
	-- If the text contains a line break it is not formatted as a URL, regardless of other content.
	if s:match("\n") then
		return s
	end
	
	-- Check if the text has a valid URL prefix and at least one valid URL character.
	local valid_url_prefixes = {"//", "http://", "https://", "ftp://", "gopher://", "mailto:", "news:", "irc://"} 
	local url_prefix
	for _ ,v in ipairs(valid_url_prefixes) do
		if mw.ustring.match(s, '^%[' .. v ..'[^"%s].*%]' ) then
			url_prefix = v
			break
		end
	end
	
	-- Get display text
	if not url_prefix then
		return s
	end
	s = s:match("^%[" .. url_prefix .. "(.*)%]") -- Grab all of the text after the URL prefix and before the final square bracket.
	s = s:match('^.-(["<> ].*)') or "" -- Grab all of the text after the first URL separator character ("<> ).
	s = mw.ustring.match(s, "^%s*(%S.*)$") or "" -- If the separating character was a space, trim it off.
	
	local s_decoded = mw.text.decode(s, true)
	if mw.ustring.match(s_decoded, "%c") then
		return s
	end

	return s_decoded

end

local function delinkLinkClass(text, pattern, delinkFunction)
	if type(text) ~= "string" then
		error("Attempt to de-link non-string input.", 2)
	end
	if type(pattern) ~= "string" or mw.ustring.sub(pattern, 1, 1) ~= "^" then
		error('Invalid pattern detected. Patterns must begin with "^".', 2)
	end
	-- Iterate over the text string, and replace any matched text. using the 
	-- delink function. We need to iterate character by character rather 
	-- than just use gsub, otherwise nested links aren't detected properly.
	local result = ""
	while text ~= "" do
		-- Replace text using one iteration of gsub.
		text = mw.ustring.gsub(text, pattern, delinkFunction, 1)
		-- Append the left-most character to the result string.
		result = result .. mw.ustring.sub(text, 1, 1)
		text = mw.ustring.sub(text, 2, -1)
	end
	return result
end

function p._delink(args)
	local text = args[1] or ""
	if args.refs == "yes" then
		-- Remove any [[Help:Strip markers]] representing ref tags. In most situations 
		-- this is not a good idea - only use it if you know what you are doing!
		text = mw.ustring.gsub(text, "UNIQ%w*%-ref%-%d*%-QINU", "")
	end
	if args.comments ~= "no" then
		text = text:gsub("<!%-%-.-%-%->", "") -- Remove html comments.
	end

	if args.wikilinks ~= "no" and args.wikilinks ~= "target" then
		-- De-link wikilinks and return the label portion of the wikilink.
		text = delinkLinkClass(text, "^%[%[.-%]%]", getDelinkedLabel)
	elseif args.wikilinks == "target" then
		-- De-link wikilinks and return the target portions of the wikilink.
		text = delinkLinkClass(text, "^%[%[.-%]%]", getDelinkedTarget)
	end
	if args.urls ~= "no" then
		text = delinkLinkClass(text, "^%[.-%]", delinkURL) -- De-link URLs.
	end
	if args.whitespace ~= "no" then
		-- Replace single new lines with a single space, but leave double new lines
		-- and new lines only containing spaces or tabs before a second new line.
		text = mw.ustring.gsub(text, "([^\n \t][ \t]*)\n([ \t]*[^\n \t])", "%1 %2")
		text = text:gsub("[ \t]+", " ") -- Remove extra tabs and spaces.
	end
	return text
end

function p.delink(frame)
	if not getArgs then
		getArgs = require('Module:Arguments').getArgs
	end
	return p._delink(getArgs(frame, {wrappers = 'Template:Delink'}))
end

return p