模板:Url
此模板被引用于 许多页面。 为了避免造成大规模的影响,所有对此模板的编辑应先于沙盒、测试样例或您的用户页上测试。 测试后无误的版本可以一次性地加入此模板中,但是修改前请务必于讨论页发起讨论。 模板引用数量暂由人工统计更新。 |
此模板使用Lua语言: |
本模版用于生成格式化的外部链接。本模板生成的链接会使用<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 |
{{ Url | example.com }} | example |
{{ Url | www.example.com }} | www |
{{ Url | http://www.example.com }} | www |
{{ Url | https://www.example.com }} | www |
{{ Url | ftp://www.example.com }} | www |
{{ Url | ftp://ftp.example.com }} | ftp |
{{ Url | http://www.example.com/ }} | www |
{{ Url | http://www.example.com/path }} | www |
{{ Url | www.example.com/foo }} | www |
{{ Url | http://www.example.com/foo | link }} | link |
{{ Url | www.example.com/foo | link }} | link |
{{ Url | http://www.example.com/path/ }} | www |
{{ Url | www.example.com/foo/ }} | www |
{{ Url | http://www.example.com/foo/ | link }} | link |
{{ Url | www.example.com/foo/ | link }} | link |
微格式
模板用一个 class="url"
包装显示的URL,以便它包含在任何接受URL参数的父微格式中——请参阅我们的微格式项目。
上述文档嵌入自Template:Url/doc。 (编辑 | 历史) 编者可以在本模板的沙盒 (创建 | 镜像)和测试样例 (创建)页面进行实验。 请在/doc子页面中添加分类。本模板的子页面。 |