模板:Url/doc
此頁面是Template:Url的Templatedocumentation。 此頁面可能包含了模板的使用說明、分類和其他內容。 |
此模板被引用於 許多頁面。 為了避免造成大規模的影響,所有對此模板的編輯應先於沙盒、測試樣例或您的使用者頁面上測試。 測試後無誤的版本可以一次性地加入此模板中,但是修改前請務必於討論頁發起討論。 模板引用數量暫由人工統計更新。 |
此模板使用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參數的父微格式中——請參閱我們的微格式項目。