Wikipedia>BarrelProof: /* Known limitations */ Misspelling

2021-11-22T01:47:06Z

Known limitations: Misspelling

New page

{{Documentation subpage}}
{{template shortcut|url2wiki|u2w}}
{{lua|Module:Urltowiki}}


This template takes a wiki URL and outputs the equivalent wikilink, with optional display text. It is useful for quickly creating properly formatted wikilinks to talk page sections or external wikis. It accepts URLs from most Wikimedia wikis. The template should usually be [[WP:SUBST|substituted]], but will work with [[WP:TRANSCLUSION|transclusion]] as well.

If given a partial URL (without the protocol and the host name) the template will remove any underlines and decode [[percent-encoded]] characters. If given a valid URL that is not recognised as a Wikimedia wiki, it will output the URL unlinked. See [[#Known limitations|below]] for how to add new wikis.

The shortcut {{tld|u2w}} is available.

A similar URL-to-wikitext transformation can be done directly in the edit window using the [[User:Js/urldecoder]] user script.

== Usage ==

;Quick usage
:CAUTION: This syntax will not work if the URL contains "=".

<pre>{{subst:u2w||}}</pre>

;Basic usage
:The following will work for all URLs.

<pre>{{subst:u2w|1=|2=}}</pre>

<pre>{{subst:u2w|url=|display=}}</pre>

;All parameters

<pre>{{subst:u2w
| url =
| display =
| link =
| section =
| colontrick =
| error =
}}</pre>

== Parameters ==

* '''url''' - the URL you wish to be converted into wikitext. This parameter is required. You can also use the first positional parameter for the URL, but this will not work if the URL contains an equals sign.
* '''display''' - the text you would like to be displayed, if not the interwiki link itself. This is equivalent to the text that comes after the pipe in a piped link. You can also use the second positional parameter for the display text, but this will only work if the first positional parameter is also present. Therefore, if you use this for the display value there must be no equals sign in the URL.
* '''link''' - if this is set to "no", the template will not link the interwiki link, and will not display the display text.
* '''section''' - if this is set to "no", no section links will be produced.
* '''colontrick''' - if this is set to "no" the template will not use the [[Help:Colon trick|colon trick]] for files and category pages. Note that if {{para|link|no}} then the colon trick will not be used anyway - this is necessitated by a [[phab:T14974|longstanding bug]] in Mediawiki.
* '''error''' - if this is set to "no" the template will return nothing instead of producing error messages if there is missing or invalid input.

== Examples ==

{| class = "wikitable"
|-
! Code
! Result
|-
| <code><nowiki>{{subst:u2w|error=no}}</nowiki></code>
| {{u2w|error=no}}
|-
| <code><nowiki>{{subst:u2w|url=https://en.wikipedia.org/wiki/Pearl_Jam}}</nowiki></code>
| {{u2w|url=https://en.wikipedia.org/wiki/Pearl_Jam}}
|-
| <code><nowiki>{{subst:u2w|url=https://en.wikipedia.org/w/index.php?title=Pearl_Jam&action=history}}</nowiki></code>
| {{u2w|url=https://en.wikipedia.org/w/index.php?title=Pearl_Jam&action=history}}
|-
| <code><nowiki>{{subst:u2w|url=https://en.wikipedia.org/wiki/Wikipedia:Village_pump_%28policy%29/Archive_102#Using_.7B.7BComment.7D.7D_on_articles}}</nowiki></code>
| {{u2w|url=https://en.wikipedia.org/wiki/Wikipedia:Village_pump_%28policy%29/Archive_102#Using_.7B.7BComment.7D.7D_on_articles}}
|-
| <code><nowiki>{{subst:u2w|url=https://en.wikipedia.org/wiki/Wikipedia:Village_pump_%28policy%29/Archive_102#Using_.7B.7BComment.7D.7D_on_articles|display=the village pump}}</nowiki></code>
| {{u2w|url=https://en.wikipedia.org/wiki/Wikipedia:Village_pump_%28policy%29/Archive_102#Using_.7B.7BComment.7D.7D_on_articles|display=the village pump}}
|-
| <code><nowiki>{{subst:u2w|url=https://es.wikivoyage.org/wiki/Bogot%C3%A1#En_avi.C3.B3n}}</nowiki></code>
| {{u2w|url=https://es.wikivoyage.org/wiki/Bogot%C3%A1#En_avi.C3.B3n}}
|-
| <code><nowiki>{{subst:u2w|url=https://es.wikivoyage.org/wiki/Bogot%C3%A1#En_avi.C3.B3n|link=no}}</nowiki></code>
| {{u2w|url=https://es.wikivoyage.org/wiki/Bogot%C3%A1#En_avi.C3.B3n|link=no}}
|-
| <code><nowiki>{{subst:u2w|url=https://es.wikivoyage.org/wiki/Bogot%C3%A1#En_avi.C3.B3n|display=Bogota by plane}}</nowiki></code>
| {{u2w|url=https://es.wikivoyage.org/wiki/Bogot%C3%A1#En_avi.C3.B3n|display=Bogota by plane}}
|-
| <code><nowiki>{{subst:u2w|url=https://en.wikipedia.org/wiki/Category:Wikipedians}}</nowiki></code>
| {{u2w|url=https://en.wikipedia.org/wiki/Category:Wikipedians}}
|-
| <code><nowiki>{{subst:u2w|url=https://en.wikipedia.org/wiki/Category:Wikipedians|colontrick=no}}</nowiki></code>
| 
|-
| <code><nowiki>{{subst:u2w|url=https://en.wikipedia.org/wiki/Wikipedia:Village_pump_%28policy%29/Archive_102#Using_.7B.7BComment.7D.7D_on_articles|section=no}}</nowiki></code>
| {{u2w|url=https://en.wikipedia.org/wiki/Wikipedia:Village_pump_%28policy%29/Archive_102#Using_.7B.7BComment.7D.7D_on_articles|section=no}}
|-
|}

== Known limitations ==

This template will not work correctly if the original section name contains anything that looks [[percent-encoded]]. This usually means a period followed by two characters that could be [[hexadecimal]]. For example, the code <code><nowiki>{{subst:u2w|url=https://en.wikipedia.org/wiki/Wikipedia:Sandbox#Pi_equals_3.14}}</nowiki></code> produces {{u2w|url=https://en.wikipedia.org/wiki/Wikipedia:Sandbox#Pi_equals_3.14}}. To work around this you can set {{para|section|no}} and {{para|link|no}}, and add the link and the proper section name yourself. However, bear in mind that the actual link will still work properly even if it is displayed incorrectly, so it is not necessary to use the workaround if you also set the {{para|display}} parameter.

Additionally, some Wikimedia sites may not be supported yet. If you come across a site that isn't supported, please consider adding it to [[Module:InterwikiTable]], as then it will work for all users.

== See also ==

* [[User:Js/urldecoder]], a user script that does a similar conversion directly in the edit window
* [[Template:Url to diff]], for converting diff URLs to use the {{tl|diff}} template

<includeonly>{{Sandbox other||

[[Category:Internal link templates]]
}}</includeonly>

Template:Urltowiki/doc - Revision history

Wikipedia>BarrelProof: /* Known limitations */ Misspelling