1.0.8 • Published 7 months ago
hexo-album-card v1.0.8
hexo-album-card
一個專門用於在 Hexo 部落格中展示同人音樂專輯資訊的標籤插件。
本插件提供簡潔的專輯卡片展示功能,支援專輯基本資訊、曲目列表及製作人員資訊的展示。
我沒想到這個自用的 Hexo 插件會有數百次 Down,但是我并不打算進一步適配。
若您在使用中遇見問題和錯誤,可使用電郵聯絡我:magsticwind@gmail.com
。
您可以隨意下載原始碼進行二次開發,但我不接受任何的功能擴展委托。
GitHub Copilot 幫助我完成了README.me,我也不想深度檢查了,就這樣吧XD
功能特點
- 支援專輯基本資訊展示
- 支援自定義專輯封面
- 內建多種下載資源圖示
- 支援摺疊式曲目列表
- 響應式設計,完美適配移動裝置
環境要求
- Node.js >= 12.0.0
- Hexo >= 5.0.0
- 主題需要集成 Font Awesome 圖示庫
安裝方式
npm i hexo-album-card
使用方法
{% album "CD名" "CD編號" "發行時間" "發行展會" "版本備注" "簡要描述" "夾克URL" "下載URL" %}{% endalbum %}
參數說明
參數 | 必填 | 說明 | 示例 |
---|---|---|---|
CD名稱 | 是 | 專輯完整名稱 | "annihilate" |
CD編號 | 是 | 專輯識別碼 | "ADSH-013" |
發行時間 | 是 | 發行日期(YYYY-MM-DD) | "2004-10-09" |
發行展會 | 是 | 首發展會名稱 | "秋M3" |
版本備註 | 否 | 特殊版本說明 | "CD-R版" |
簡要描述 | 是 | 專輯簡介 | "RPG 全滅鋼琴曲集。" |
封面URL | 是 | 專輯封面圖片連結 | "/images/jacket.jpg" |
下載URL | 否 | 資源連結 | "https://example.com" |
下載圖示說明
下載URL 的顯示規則如下:
NO
:不顯示任何圖示- 空值:顯示無資源圖示
- 包含
dlsite
:顯示購買圖示 - 包含
archive
/khinside
/doujinstyle
:顯示下載圖示 - 其他情況:顯示未知來源圖示
進階用法
支援結合 Hexo 的摺疊標籤使用,可完整展示曲目列表和製作人員資訊:
{% album "專輯名稱" "編號" "日期" "展會" "版本" "描述" "封面URL" "下載URL" %}
{% hideToggle 曲目列表,#303030,white %}
1. 第一曲
2. 第二曲【RED】
3. 第三曲
{% endhideToggle %}
{% hideToggle 製作人員,#303030,white %}
- 編曲:XXX
- 插畫:YYY
- 製作:ZZZ
{% endhideToggle %}
{% endalbum %}
特殊標記:
- 使用【RED】可為曲目添加特殊樣式
- 製作人員資訊使用無序列表
- 曲目列表使用有序列表
注意事項
- 圖片路徑支援相對路徑和絕對路徑
- 建議封面圖片寬高比為 1:1
- 摺疊標籤需要主題支援 hideToggle 功能
渲染示例
開源許可
MIT License © 2024 Magstic