وحدة:UrlToWiki
يمكن إنشاء صفحة توثيق الوحدة في وحدة:UrlToWiki/شرح
-- This module takes a URL from a Wikimedia project and returns the equivalent wikitext.
-- Any actions such as edit, history, etc., are stripped, and percent-encoded characters
-- are converted to normal text.
p = {}
local interwiki_table = mw.loadData("Module:InterwikiTable")
local function getHostId(host)
if type(host) ~= "string" then
error("Non-string value for host name detected.")
end
-- Find the entry for the host in the interwiki table.
local id
for k,v in pairs(interwiki_table) do
if mw.ustring.match(host, interwiki_table[k].domain) then
id = k
break
end
end
return id
end
local function getInterwiki(host)
-- This function returns the value of the interwiki prefix.
if type(host) ~= "string" then
error("Non-string value for host name detected.")
end
host = mw.language.getContentLanguage():lc(host)
local host_id = getHostId(host)
if not host_id then return end -- If the host isn't valid then the language and the interwiki are also invalid.
-- Find the language in the interwiki prefix, if applicable.
local lang = mw.ustring.match(host, "^(.-)%.") -- Find the text before the first period.
if not lang or not mw.language.isSupportedLanguage(lang) then -- Check if lang is a valid language code.
lang = false
end
-- A language prefix is not necessary if there is already a language prefix for the host in the interwiki table.
local domain_lang = mw.ustring.match(interwiki_table[host_id].domain, "^(.-)%.") -- Find the text before the first period.
if mw.language.isSupportedLanguage(domain_lang) then
lang = false
end
-- No need for an interwiki link if we are on the same site as the URL.
local current_host = mw.uri.new(mw.title.getCurrentTitle():fullUrl()).host -- Get the host portion of the current page URL.
if host == current_host then
return nil, lang, host_id
end
-- Check if the URL language is the same as the current language.
local same_lang
if lang and lang == mw.ustring.match(current_host, "^(.-)%.") then
same_lang = true
end
-- Check if the project is the same as the current project (but a different language).
local current_host_id = getHostId(current_host)
local same_project
if current_host_id == host_id then
same_project = true
end
-- Return the interwiki prefix, omitting the language or the project code if
-- it is not necessary.
local project = interwiki_table[host_id].iw_prefix[1]
if same_lang or ( not lang and interwiki_table[host_id].takes_lang_prefix == false ) then
return project, lang, host_id
elseif same_project then
return lang, lang, host_id
elseif not lang then -- If the language code is bad but the rest of the host name is ok.
return nil, nil, host_id
else
return project .. ":" .. lang, lang, host_id
end
end
local function _urlToWiki(args)
local url = args[1] or error("No URL specified")
url = mw.text.trim(url) -- Trim whitespace.
url = mw.uri.new(url)
local host = url.host -- Get the host name.
-- Get the interwiki prefix. Lang and host_id are passed through so we don't have to work them out again.
local interwiki, lang, host_id
if host then
interwiki, lang, host_id = getInterwiki(host)
end
local link = true -- This decides whether the resulting wikitext will be linked or not. Default is yes.
if args.link == "no" then
link = false -- Let users override the default.
end
-- Get the page title.
local pagetitle, title_prefix
if host_id and not ( interwiki_table[host_id].takes_lang_prefix == true and not lang ) then
title_prefix = interwiki_table[host_id].title_prefix
end
-- If the URL path starts with the title prefix in the interwiki table, use that to get the title.
if title_prefix and mw.ustring.sub(url.path, 1, mw.ustring.len(title_prefix)) == title_prefix then
pagetitle = mw.ustring.sub(url.path, mw.ustring.len(title_prefix) + 1, -1)
-- Else, if the URL is a history "index.php", use url.query.title. Check for host_id
-- in case the URL isn't of a Wikimedia site.
elseif host_id and mw.ustring.match(url.path, "index%.php") and url.query.title then
pagetitle = url.query.title
-- Special case for Bugzilla.
elseif host_id == "bugzilla" and url.query.id then
pagetitle = url.query.id
elseif host_id == "bugzilla" and not url.query.id then
interwiki = false -- disable the interwiki prefix as we are returning a full URL.
link = false -- don't use double square brackets for URLs.
pagetitle = tostring(url)
-- If the URL is valid but not a recognised interwiki, return the URL and don't link it.
elseif host and not host_id then
link = false -- Don't use double square brackets for URLs.
pagetitle = tostring(url)
-- Otherwise, return whatever text we were passed and link it.
else
pagetitle = tostring(url)
end
-- Get the fragment and pre-process percent-encoded characters.
local fragment = url.fragment
if fragment then
fragment = mw.ustring.gsub(fragment, "%.([0-9A-F][0-9A-F])", "%%%1")
end
-- Assemble the wikilink.
local wikitext = pagetitle
if interwiki then
wikitext = interwiki .. ":" .. wikitext
end
if fragment and not (args.section == "no") then
wikitext = wikitext .. "#" .. fragment
end
-- Decode percent-encoded characters and convert underscores to spaces.
wikitext = mw.uri.decode(wikitext, "WIKI")
-- If the wikitext is to be linked, re-encode illegal characters. Don't re-encode
-- characters from invalid URLs to make the default [[{{{1}}}]] display correctly.
if link and host then
wikitext = mw.ustring.gsub(wikitext, "[<>%[%]|{}%c\n]", mw.uri.encode)
end
-- Use the [[مساعدة:Colon trick]] with categories, interwikis, and files.
local colon_prefix = mw.ustring.match(wikitext, "^(.-):.*$") or "" -- Get the text before the first colon.
local current_lang = mw.language.getContentLanguage()
local ns = mw.site.namespaces
local need_colon_trick
if mw.language.isSupportedLanguage(colon_prefix) -- Check for interwiki links.
or current_lang:lc(ns[6].name) == current_lang:lc(colon_prefix) -- Check for files.
or current_lang:lc(ns[14].name) == current_lang:lc(colon_prefix) then -- Check for categories.
need_colon_trick = true
end
for i,v in ipairs(ns[6].aliases) do -- Check for file namespace aliases.
if current_lang:lc(v) == current_lang:lc(colon_prefix) then
need_colon_trick = true
break
end
end
for i,v in ipairs(ns[14].aliases) do -- Check for category namespace aliases.
if current_lang:lc(v) == current_lang:lc(colon_prefix) then
need_colon_trick = true
break
end
end
-- Don't use the colon trick if the user says so or if we are not linking
-- (due to [[bugzilla:12974]]).
if need_colon_trick and link and not (args.colontrick == "no") then
wikitext = ":" .. wikitext
end
-- Add the link
if link then
local display = args[2] -- The display text in piped links.
if display then
if type(display) ~= "string" then
error("Non-string display value detected")
end
display = mw.text.trim(display) -- Trim whitespace.
wikitext = wikitext .. "|" .. display
end
wikitext = "[[" .. wikitext .. "]]"
end
return wikitext
end
function p.urlToWiki(frame)
local origArgs
if frame == mw.getCurrentFrame() then
-- We're being called via #invoke. If the invoking template passed any args, use
-- them. Otherwise, use the args that were passed into the template.
origArgs = frame:getParent().args
for k, v in pairs(frame.args) do
origArgs = frame.args
break
end
else
-- We're being called from another module or from the debug console, so assume
-- the args are passed in directly.
origArgs = frame
end
-- ParserFunctions considers the empty string to be false, so to preserve the previous
-- behavior of the template, change any empty arguments to nil, so Lua will consider
-- them false too.
local args = {}
for k, v in pairs(origArgs) do
if mw.ustring.match(v, '%S') then
args[k] = v
end
end
return _urlToWiki(args)
end
return p