# 找牌插件使用說明：Hexo Tag Plugin – MtGCard

> 本文章為修改後版本，原始文章：[Hexo Tag Plugin -- MtGCard](https://hackmd.io/@mbcoguno/S1vvGyFK0)

**<font color="FF0000">所有參數請用空白分隔！</font>**
**<font color="FF0000">所有參數請用空白分隔！</font>**
**<font color="FF0000">所有參數請用空白分隔！</font>**

## 使用方法

### mtgcard

{% mtgcard "卡名" [系列代號] [language=zht] [tooltip=true|false] [alt="替代名稱"] %}

標籤名稱 mtgcard 為 Hexo 識別各種標籤外掛的依據，務必填寫。
此標籤以卡名為依據顯示卡牌圖片。

卡名為完整的英文卡名，務必填寫正確，並用英文引號括起來，否則會改為顯示錯誤訊息。
卡名可以是非英文語系的卡名，必須是完整的卡名，且 Scryfall 網站有紀錄在內的名稱。 若使用非英文語系的卡名，則必須在後面的參數位置加上 `language` 並設定該名稱的語系，例如 `language=zht`。本外掛無法自動辨別語系。

系列代號為可選參數，若使用，則必須緊跟著卡名後面。系列代號必須是紀錄於 Scryfall 網站上的三個英文字母代號，大小寫不限。若不使用，則使用 Scryfall 的預設結果。若無指定版本需求，建議「*不要*」使用。

`language` 參數為可選，指卡名的語系，必須設定在卡名和系列符號後面。多個可選參數可同時使用且順序可變（系列代號除外）。參數後面緊接著一個等號（`=`）。等號後接上欲設定的值，必須是 Scryfall 網站規定的文字。若設定為繁體中文，值為 `zht`；若設定為日文，值為 `ja`。
`language` 參數會影響渲染卡圖的語系，或渲染文字的語系。

`tooltip` 參數為可選，指改為顯示卡片的連結，連結名稱為卡片的卡名，連結目標為 Scryfall 單卡展示網頁。必須設定在卡名和系列符號後面，多個可選參數可同時使用且順序可變（系列代號除外）。參數後面緊接著一個等號（`=`）。等號後接上欲設定的值，必須是 `true` 或 `false`。
當設定為 `true` 時，會改為顯示卡片的連結。該連結會榜定滑鼠的 hover 事件，當滑鼠游標移到連結上時，會出現一個彈跳介面，顯示該連接關聯的卡圖。
當設定為 `false` 時，和整個參數沒設定時一致。

`alt` 參數為可選，將聯結名稱改為指定名稱。必須設定在卡名和系列符號後面，多個可選參數可同時使用且順序可變（系列代號除外）。參數後面緊接著一個等號（`=`）。等號後接上欲設定的值。

渲染出的卡圖為 Scryfall large 格式，並強制縮小成寬度為 300 px 的圖片。

使用範例：

{% mtgcard "Circle of Protection: Red" "9ed" %}
{% mtgcard "Counterspell" %}
{% mtgcard "+2 Mace" "afr" tooltip=true %}
{% mtgcard "注定" "cmr" language=zht %}
{% mtgcard "竊冠甌柯" "eld" language=zht tooltip=true %}
{% mtgcard "Sheoldred, the Apocalypse" tooltip=true alt="Sheoldred" %}

### mtgpick

{% mtgpick 系列代號 蒐集編號 [language=zht] [tooltip=true|false] %}

標籤名稱 mtgpick 為 Hexo 識別各種標籤外掛的依據，務必填寫。

第一個參數為系列代號，內容與限制與上述相同，但在此處為必填參數。

第二個參數為蒐集編號，數字不用補零，不必填等同於總數的分母。不必轉化為字串格式。

可選參數目前有 `language` 與 `tooltip` 兩種，使用方式與上述相同。

使用範例：

{% mtgpick "sta" 78 %}
{% mtgpick "neo" 365 language=zht %}

### mtglink

{% mtglink "卡名" [language=zht] [alt="替代名稱"] %}

標籤名稱 mtglink 為 Hexo 識別各種標籤外掛的依據，務必填寫。

第一個參數為卡名，內容與限制和 [mtgcard](#mtgcard) 相同。

第二個參數 `language` 和第三個參數 `alt` 為可選，內容與限制和 [mtgcard](#mtgcard) 相同。

可將 `mtglink` 視為將 `tooltip` 設定為 `true` 的 `mtgcard`。

使用範例：

{% mtglink "Counterspell" %}
{% mtglink "Sheoldred, the Apocalypse" alt="Sheoldred" %}