查看“模板:URL/doc”的源代码

本模版用于生成格式化的外部链接。
<!--This template can be used to create a formatted external link.-->

== 用法 ==
<code><nowiki>{{URL|</nowiki>1=''url name''<nowiki>|</nowiki>2=''optional display text''<nowiki>}}</nowiki></code>
:*第一个参数用于写入相应的URL外链，并对其分析，如果没附带相应的协议名的话，默认添加为「<nowiki>http://</nowiki>」协议头，如果有相应协议头的话，则根据协议头显示相应的连接图标，现支持「 <nowiki> http:// </nowiki> 」，「 <nowiki> https:// </nowiki> 」和「 <nowiki> ftp:// </nowiki> 」三种协议。
:*第二个参数为可选参数，可以改变链接显示时的名称，若留空，则直接显示连接。
::''注''：如果没指定第一个参数的话，第二个参数直接显示填入值，但不生成链接。
:*如果不填任何参数，则自动生成模板的例子写法。

: '''警告：'''
:*强烈建议显式标明参数名来写入参数（尤其链接中有类似等号时），避免错误解释，导致无法显示连接。如果存在第二参数的话，更加需要显式参数名，以免错误覆盖第一参数的值。
<!--:* It is strongly advised to number the parameters explicitly (notably when the value of the URL is unknown, for example when this template is used in another template specifying the effective URL as a variable value), because many URLs contain an equal sign (in their query string). In that case, the second parameter for the displayed text, if present, '''must''' also be explicitly numbered ; otherwise it will override the value of the explicitly numbered first parameter.-->
:*如果链接中含有包含问号或井号的查询字符串的话，强烈建议链接后加「/」做结束，以免解释错误，「/」不会被显示出来的，请放心。为防止错误将查询字符串被改变（如小写化），强烈建议使用显式参数名写入参数。
<!--:* If you specify a query string (starting by "?", up to the end of the string or up to the first "#" character) or an anchor (starting by '"#" up to the end of the string) in the first parameter then you '''must''' specify at least the default path "/" immediately after the domain name ; otherwise the resulting link target will be unpredictable, as the query string and/or the anchor may be unexpectedly converted to all lowercase ; it is strongly recommended to use full and canonical URLs in the first parameter, (without depending on the tentative detection of a missing URI scheme or path). Don't worry, this default "/" path won't be visible in the default display text.-->

=== 範例 ===
{|class="wikitable"
|-
! Code !! Result
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| EXAMPLE.com }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | EXAMPLE.com }} 
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| example.com }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | example.com }} 
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| www.example.com }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | www.example.com }}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| http://www.example.com }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | http://www.example.com }}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| https://www.example.com }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | https://www.example.com }}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| ftp://www.example.com }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | ftp://www.example.com }}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| ftp://ftp.example.com }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | ftp://ftp.example.com }}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| http://www.example.com/ }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | http://www.example.com/ }}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| http://www.example.com/path }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | http://www.example.com/path }}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| www.example.com/foo }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | www.example.com/foo }}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| http://www.example.com/foo | link }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | http://www.example.com/foo | link }}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| www.example.com/foo | link }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | www.example.com/foo | link}}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| http://www.example.com/path/ }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | http://www.example.com/path/ }}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| www.example.com/foo/ }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | www.example.com/foo/ }}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| http://www.example.com/foo/ | link }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | http://www.example.com/foo/ | link }}
|-
| <tt><nowiki>{{</nowiki> {{BASEPAGENAME}} <nowiki>| www.example.com/foo/ | link }}</nowiki></tt>
| {{ {{BASEPAGENAME}} | www.example.com/foo/ | link}}
|}

<noinclude>[[Category:模板文档]]</noinclude>
<includeonly>
[[Category:样式模板]]
</includeonly>