Movatterモバイル変換


[0]ホーム

URL:


Jump to content
WikipediaThe Free Encyclopedia
Search

Module:URL

Permanently protected module
From Wikipedia, the free encyclopedia
Module documentation[view] [edit] [history] [purge]
WarningThis Lua module is used inMediaWiki:Titleblacklist-custom-URL, and onapproximately 649,000 pages, or roughly 1% of all pages.
Changes to it can cause immediate changes to the Wikipedia user interface.
To avoid major disruption and server load, any changes should be tested in the module's/sandbox or/testcases subpages, or in your ownmodule sandbox. The tested changes can be added to this page in a single edit. Please discuss changes on thetalk page before implementing them.
Thismodule is rated asready for general use. It has reached a mature state, is considered relatively stable and bug-free, and may be used wherever appropriate. It can be mentioned onhelp pages and other Wikipedia resources as an option for new users. To minimise server load and avoid disruptive output, improvements should be developed throughsandbox testing rather than repeated trial-and-error editing.
Page template-protectedThis module is currentlyprotected from editing.
See theprotection policy andprotection log for more details. Please discuss any changes on thetalk page; you maysubmit an edit request to ask anadministrator to make an edit if it isuncontroversial or supported byconsensus. You may alsorequest that this page be unprotected.

This module implements{{URL}} and{{URL2}}. Please see the template page for documentation.

Lua interface

Thep._url(url, text, msg) function may be used by other Lua modules. It returns a formatted Wikitext for the given URL, made suitable for line wrapping using. It takes the following parameters:

url
REQUIRED. The URL to format.
text
OPTIONAL. Display text to put in the Wikitext link. Defaults to a pretty version of the URL.
msg
OPTIONAL. String. If content isfalse,n orN, do not emit a help message (using{{tlx}}) when URL is not given.

Example

The following module emits a prettified link to log the user out. It will wrap correctly to most widths.

localurl=require('Module:URL')._urllocalp={}p.main=function(frame)returnurl("https://en.wikipedia.org/wiki/Special:UserLogout")endreturnp

See also

The abovedocumentation istranscluded fromModule:URL/doc.(edit |history)
Editors can experiment in this module'ssandbox(edit |diff) andtestcases(edit |run) pages.
Subpages of this module.

---- This module implements {{URL}}---- See unit tests at [[Module:URL/testcases]]localp={}localfunctionsafeUri(s)localsuccess,uri=pcall(function()returnmw.uri.new(s)end)ifsuccessthenreturnuriendendlocalfunctionextractUrl(args)forname,valinpairs(args)doifname~=2andname~="msg"thenlocalurl=name.."="..val;url=mw.ustring.gsub(url,'^[Hh][Tt][Tt][Pp]([Ss]?):(/?)([^/])','http%1://%3')localuri=safeUri(url);ifurianduri.hostthenreturnurlendendendendfunctionp._url(url,text,msg)url=mw.text.trim(urlor'')text=mw.text.trim(textor'')-- Check for pre-formatted url. Catches '{{url|{{url|google.com}}}}' that can occur via templateif(mw.ustring.match(url,'^<span class="url">'))thenreturnurl,text,msgendlocalnomsg=(msgor''):sub(1,1):lower()=="n"ormsg=='false'-- boolean: true if msg is "false" or starts with n or Nifurl==''theniftext==''thenifnomsgthenreturnnilelsereturnmw.getCurrentFrame():expandTemplate{title='tlx',args={'URL',"''example.com''","''optional display text''"}}endelsereturntextendend-- 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)returnmw.uri.encode(s,'PATH')end)-- If there is an empty query string or fragment id, remove it as it will cause mw.uri.new to throw an errorurl=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')localuri=safeUri(url)-- Handle URL's without a protocol and URL's that are protocol-relative,-- e.g. www.example.com/foo or www.example.com:8080/foo, and //www.example.com/fooifuriand(noturi.protocolor(uri.protocolandnoturi.host))andurl:sub(1,2)~='//'thenurl='http://'..urluri=safeUri(url)endiftext==''thenifurithenifuri.path=='/'thenuri.path=''endlocalport=''ifuri.portthenport=':'..uri.portendtext=mw.ustring.lower(uri.hostor'')..port..(uri.relativePathor'')-- Add <wbr> before _/.-# sequencestext=mw.ustring.gsub(text,"(/+)","<wbr/>%1")-- This entry MUST be the first. "<wbr/>" has a "/" in it, you know.text=mw.ustring.gsub(text,"(%.+)","<wbr/>%1")-- text = mw.ustring.gsub(text,"(%-+)","<wbr/>%1") -- DISABLED for nowtext=mw.ustring.gsub(text,"(%#+)","<wbr/>%1")text=mw.ustring.gsub(text,"(_+)","<wbr/>%1")else-- URL is badly-formed, so just display whatever was passed intext=urlendendreturnmw.ustring.format('<span class="url">[%s %s]</span>',url,text)end--[[The main entry point for calling from Template:URL.--]]functionp.url(frame)localtemplateArgs=frame.argslocalparentArgs=frame:getParent().argslocalurl=templateArgs[1]orparentArgs[1]localtext=templateArgs[2]orparentArgs[2]or''localmsg=templateArgs.msgorparentArgs.msgor''url=urlorextractUrl(templateArgs)orextractUrl(parentArgs)or''returnp._url(url,text,msg)end--[[The entry point for calling from the forked Template:URL2.This function returns no message by default.It strips out wiki-link markup, html tags, and everything after a space.--]]functionp.url2(frame)localtemplateArgs=frame.argslocalparentArgs=frame:getParent().argslocalurl=templateArgs[1]orparentArgs[1]localtext=templateArgs[2]orparentArgs[2]or''-- default to no messagelocalmsg=templateArgs.msgorparentArgs.msgor'no'url=urlorextractUrl(templateArgs)orextractUrl(parentArgs)or''-- if the url came from a Wikidata call, it might have a pen icon appended-- we want to keep that and add it back at the end.localu1,penicon=mw.ustring.match(url,"(.*)(&nbsp;<span class='penicon.*)")ifpeniconthenurl=u1end-- strip out html tags and [ ] from urlurl=(urlor''):gsub("<[^>]*>",""):gsub("[%[%]]","")-- truncate anything after a spaceurl=url:gsub("%%20"," "):gsub(" .*","")return(p._url(url,text,msg)or"")..(peniconor"")endreturnp
Retrieved from "https://en.wikipedia.org/w/index.php?title=Module:URL&oldid=1321826357"
Categories:
Hidden category:

[8]ページ先頭

©2009-2025 Movatter.jp