模板: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