- 本文用於介紹萌娘百科中一些特定功能的操作方法；
- 本文僅是一篇論述，不屬於方針或指引。如果本指南與相關方針或指引發生衝突或存在不一致的情況，請以方針或指引的條文為準。
這篇幫助文檔介紹如何在萌娘百科使用外部圖像。對於條目中使用的圖像，請優先將其上傳到萌娘共享，以內部圖像的方式引用。
提醒：
- 使用連結鏈入的萌娘共享圖片不會在Special:鏈入頁面和cm:Special:全域使用情況中出現，這可能導致一些條目使用中的圖片被誤判斷為未使用而被刪除。如果內部圖片寫法不能滿足需求，請嘗試在使用外鏈的頁面加入被隱藏的圖片連結或使用{{鏈入文件}}以確保內鏈。
- 目前，使用外部圖像受白名單限制，暫不支持萌娘百科及其子站（moegirl.tw）以外其他站點的外部圖像顯示。
簡單語法
簡單的使用外部圖片，可以直接將圖片地址輸入或粘貼指條目內（如下文）。
簡單顯示外部圖像
直接在文中插入圖片地址，即可顯示圖片：
https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png
效果如下：
這樣使用的時候在圖片後不要帶有URL參數。
你也可以使用 {{filepath:內部圖片文件名}}來把內部圖片以外部圖像的格式顯現，如{{filepath:2010-DEC-13MoeGirlWikiLogo.png}}
效果如下：
使用模板排版外部圖片
- 參見：模板:圖片外鏈
帶連結的外部圖像
[https://zh.moegirl.tw/ https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png]
- 注意：格式為 [連結地址(空格)圖片地址]
效果如下：
帶注釋的外部圖像
- 主頁面：Template:外部圖片注釋
萌娘百科中有一個模板，可以讓編輯者方便地為外部圖片加上框架，並且能夠對齊浮動。
語法為：{{外部圖片注釋|圖片地址|注釋文字|位置（默認為右）|寬度=尺寸（默認為400px）}}
{{外部圖片注釋|https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png|這是萌娘百科LOGO|左|寬度=150px}}
效果如下：
外部圖像畫廊
- 主頁面：Template:Gallery
基礎語法：{{Gallery|title=畫廊標題|width=單圖最大寬度|height=單圖最大高度|圖片1地址|圖片1標題|圖片2地址|圖片2標題|……}}
- 注意：如果沒有標題，僅將文字刪除，不要刪除分隔豎線。
{{Gallery|title=這是萌娘百科LOGO|width=150|height=150
|https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png|這
|https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png|是
|https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png|萌
|https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png|娘
|https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png|百
|https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png|科
|https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png|
|https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png|LOGO
}}
效果如下：
| 這是萌娘百科LOGO | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
<img />語法
<img />語法可以在插入外部圖片的同時使用 style 等屬性添加高級樣式，這是簡單語法做不到的。
注意：萌娘百科的 <img /> 並不是標準的 HTML5 標籤，而是一個 MediaWiki 擴展標籤，因此你必須正確閉合它：<img src="foo.png"><img src="foo.png" />
<img />的屬性裡不能使用wikitext語法，它們將被原樣傳遞，因此它更適合插入一個連結固定的外部圖片。如果想要在屬性中使用解析器函數，推薦使用 {{#img:}} 解析器函數。
基礎格式
<img src="https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png" />
效果如下：
這種寫法顯示出來和#簡單顯示外部圖像中的圖片無異。
圖片縮放
實現圖片縮放有兩種方式：定義圖片寬度（width屬性）或/和定義圖片高度（height屬性）。
使用寬度屬性
如果需要一個寬度為250px的圖片：
<img src="https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png" style="width:250px;" />
效果如下：
使用高度屬性
如果需要一個高度為150px的圖片：
<img src="https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png" style="height:150px;" />
效果如下：
同時使用
同時定義高度和寬度可以實現拉伸圖片的效果。
- 註：寬度屬性和高度屬性沒有先後順序之差別，即「先寫寬度後寫高度」和「先寫高度後寫寬度」沒有差別。
<img src="https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png" style="height:300px;width:500px;" />
效果如下：
- 注意1：通常過大的圖片不應該放置在條目正文內，這會不方便讀者瀏覽。大多數圖片的寬度應大約位於100至400像素之間，所以在設定圖片大小時，數值不應超過這個範圍。
- 注意2：強行放大圖片會使解析度下降，因為這我們要求圖片變成500像素寬，但圖片的實際大小並沒有500像素寬只有400像素，因此瀏覽器的排版顯示器便要將圖片強制擴大至500像素寬，其顯示效果便會較差了。所以切記永不依照這個方法來放大位圖圖片。
其它屬性
<img />語法還有其它的屬性可以選用：
| 屬性 | 值 | 描述 |
|---|---|---|
| src | URL | 必須使用。規定顯示圖像的URL。 |
| height | pixels % |
定義圖像的高度。 |
| width | pixels % |
設置圖像的寬度。 |
| alt | text | 規定圖像的替代文本（當圖片無法顯示時，顯示文本內容）。 |
| title | text | 滑鼠滑過時顯示的文字提示。 |
| longdesc | URL | 指向包含長的圖像描述文檔的URL。 |
| ismap | URL | 將圖像定義為伺服器端圖像映射。 |
| usemap | URL | 將圖像定義為客戶器端圖像映射。 |
- 各屬性詳細資料請參見：參考資料。
{{#img:}} 解析器函數
{{#img:}}解析器函數的功能類似於上述的 <img /> 語法，但是使用它時可以使用 wikitext 語法，語法如下：
{{ #img: 圖片鏈接 | class = foo | 鍵 = 值 | ... }}
其中圖片連結等同於前文中 img 標籤的 src 屬性，其他可使用的屬性與 img 標籤一致：參考此處。
你可以在{{#img:}}中使用非常複雜的語句，這種使用場景在模板中較為常見：
{{#img:<!--
-->{{ #switch: 2
| 1 = https://example.com/path/to/file.png
| 2 = https://img.moegirl.tw/common/8/87/2010-DEC-13MoeGirlWikiLogo.png
}}<!--
-->| class = test<!--
-->| title = title<!--
-->
}}
| |||||||||||||||||||||||||||||||||||
參考資料與注釋
- HTML <img> 標籤
- 更多圖像模板參見：分類:圖像模板