Difference between revisions of "Template:MediaWiki URL rules"
From Timelines
(Other URI schemes do not necessarily require a plug-in) |
|||
(5 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
− | :URLs must begin with a supported [[URI scheme]] | + | :URLs must begin with a supported [[URI scheme]]. <code>http://</code> and <code>https://</code> will be supported by all browsers; however, <code>ftp://</code>, <code>gopher://</code>, <code>irc://</code>, <code>ircs://</code>, <code>mailto:</code> and <code>news:</code> may require a plug-in or an external application and should normally be avoided. [[IPv6]] host-names are currently not supported. |
− | :If URLs in citation template parameters contain certain characters they will display and link | + | :If URLs in citation template parameters contain certain characters, then they will not display and link correctly. Those characters need to be [[percent-encoded]]. For example, a space must be replaced by <code>%20</code>. To encode the URL, replace the following characters with: |
{| class="wikitable" style="margin-left: 5em" | {| class="wikitable" style="margin-left: 5em" | ||
− | ! sp !! " !! ' !! < !! > !! [ !! ] !! <nowiki>|</nowiki> !! } | + | ! sp !! " !! ' !! < !! > !! [ !! ] !! { !! <nowiki>|</nowiki> !! } |
|- | |- | ||
− | || %20 || %22 || %27 || %3c || %3e || %5b || %5d || %7c || %7d | + | || %20 || %22 || %27 || %3c || %3e || %5b || %5d || %7b || %7c || %7d |
|} | |} | ||
− | :Single apostrophes do not need to be encoded; | + | :Single apostrophes do not need to be encoded; however, unencoded multiples will be parsed as italic or bold markup. Single curly closing braces also do not need to be encoded; however, an unencoded pair will be parsed as the double closing braces for the template transclusion.<noinclude> |
{{documentation}} | {{documentation}} | ||
</noinclude> | </noinclude> |
Latest revision as of 09:07, 14 January 2016
- URLs must begin with a supported URI scheme.
http://
andhttps://
will be supported by all browsers; however,ftp://
,gopher://
,irc://
,ircs://
,mailto:
andnews:
may require a plug-in or an external application and should normally be avoided. IPv6 host-names are currently not supported. - If URLs in citation template parameters contain certain characters, then they will not display and link correctly. Those characters need to be percent-encoded. For example, a space must be replaced by
%20
. To encode the URL, replace the following characters with:
sp | " | ' | < | > | [ | ] | { | | | } |
---|---|---|---|---|---|---|---|---|---|
%20 | %22 | %27 | %3c | %3e | %5b | %5d | %7b | %7c | %7d |
- Single apostrophes do not need to be encoded; however, unencoded multiples will be parsed as italic or bold markup. Single curly closing braces also do not need to be encoded; however, an unencoded pair will be parsed as the double closing braces for the template transclusion.
Template documentation[create]
Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages. Please add categories to the /doc subpage. Subpages of this template. |