Difference between revisions of "Template:MediaWiki URL rules"
From Timelines
(ce) |
(in urls in citation templates (which is what this documentation template documents) the characters , ; ? \ . : ! ) are all fine, but | isn't) |
||
| Line 1: | Line 1: | ||
| − | :URLs must begin with a supported [[URI scheme]]: <code>http://</code> and <code>https://</code> will be supported by all browsers; <code>irc://</code>, <code>ircs://</code>, <code>ftp://</code>, <code>news:</code>, <code>mailto:</code> and <code>gopher://</code> will require a plugin or an external application. IPv6 host-names are currently not supported. | + | :URLs must begin with a supported [[URI scheme]]: <code>http://</code> and <code>https://</code> will be supported by all browsers; <code>irc://</code>, <code>ircs://</code>, <code>ftp://</code>, <code>news:</code>, <code>mailto:</code> and <code>gopher://</code> will require a plugin or an external application and should normally be avoided. IPv6 host-names are currently not supported. |
| − | :URLs | + | :If URLs in citation template parameters contain certain characters they will display and link incorrectly. Those characters need to be percent-encoded. For example, a space must be replaced by <code>%20</code>. To encode the URL, replace these characters: |
{| class="wikitable" style="margin-left: 5em" | {| class="wikitable" style="margin-left: 5em" | ||
| − | ! sp !! " !! ' | + | ! sp !! " !! ' !! < !! > !! [ !! ] !! <nowiki>|</nowiki> !! } |
|- | |- | ||
| − | | %20 || %22 || %27 | + | || %20 || %22 || %27 || %3c || %3e || %5b || %5d || %7c || %7d |
| − | |}<noinclude> | + | |} |
| + | :Single apostrophes do not need to be encoded; but unencoded multiples will be parsed as italic or bold markup. Single curly closing braces also do not need to be encoded; but an unencoded pair will be parsed as the double closing braces for the template transclusion.<noinclude> | ||
{{documentation}} | {{documentation}} | ||
</noinclude> | </noinclude> | ||
Revision as of 01:47, 7 June 2012
- URLs must begin with a supported URI scheme:
http://andhttps://will be supported by all browsers;irc://,ircs://,ftp://,news:,mailto:andgopher://will require a plugin 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 incorrectly. Those characters need to be percent-encoded. For example, a space must be replaced by
%20. To encode the URL, replace these characters:
| sp | " | ' | < | > | [ | ] | | | } |
|---|---|---|---|---|---|---|---|---|
| %20 | %22 | %27 | %3c | %3e | %5b | %5d | %7c | %7d |
- Single apostrophes do not need to be encoded; but unencoded multiples will be parsed as italic or bold markup. Single curly closing braces also do not need to be encoded; but 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. |
