Template:Url/doc

勤求古训,博采众方
入我相思门留言 | 贡献2022年5月7日 (六) 18:23的版本 (创建页面,内容为“{{Documentation subpage}} {{High-use|31923}} <!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE --> {{lua|模块:URL}} 本模版用于生成格式化的外部链接。本模板生成的链接会使用{{tag|wbr|o}}进行处理,方便浏览器自动换行。 <!--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>}}</nowi…”)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)

本模版用于生成格式化的外部链接。本模板生成的链接会使用<wbr>进行处理,方便浏览器自动换行。

用法

{{URL|1=url name|2=optional display text}}

  • 第一个参数用于写入相应的URL外链,并对其分析,如果没附带相应的协议名的话,默认添加为「http://」协议头,如果有相应协议头的话,则根据协议头显示相应的连接图标,现支持「 http:// 」,「 https:// 」和「 ftp:// 」三种协议。
  • 第二个参数为可选参数,可以改变链接显示时的名称,若留空,则直接显示连接。
:如果没指定第一个参数的话,第二个参数直接显示填入值,但不生成链接。
  • 如果不填任何参数,则自动生成模板的例子写法。
警告:
  • 强烈建议显式标明参数名来写入参数(尤其链接中有类似等号时),避免错误解释,导致无法显示连接。如果存在第二参数的话,更加需要显式参数名,以免错误覆盖第一参数的值。
  • 如果链接中含有包含问号或井号的查询字符串的话,强烈建议链接后加「/」做结束,以免解释错误,「/」不会被显示出来的,请放心。为防止错误将查询字符串被改变(如小写化),强烈建议使用显式参数名写入参数。

範例

Code Result
{{ Url }} {{URL|example.com|可选的显示文本}}
{{ Url | }} {{URL|example.com|可选的显示文本}}
{{Url ||example}} example
{{ Url | EXAMPLE.com }} example.com
{{ Url | example.com }} example.com
{{ Url | www.example.com }} www.example.com
{{ Url | http://www.example.com }} www.example.com
{{ Url | https://www.example.com }} www.example.com
{{ Url | ftp://www.example.com }} www.example.com
{{ Url | ftp://ftp.example.com }} ftp.example.com
{{ Url | http://www.example.com/ }} www.example.com
{{ Url | http://www.example.com/path }} www.example.com/path
{{ Url | www.example.com/foo }} www.example.com/foo
{{ Url | http://www.example.com/foo | link }} link
{{ Url | www.example.com/foo | link }} link
{{ Url | http://www.example.com/path/ }} www.example.com/path/
{{ Url | www.example.com/foo/ }} www.example.com/foo/
{{ Url | http://www.example.com/foo/ | link }} link
{{ Url | www.example.com/foo/ | link }} link

微格式

The template wraps the displayed URL with a class="url" so that it is included in any parent microformat which takes a URL parameter - see our microformats project.

參見

Template:Organization infoboxes