HUGO
Menu
GitHub 87548 stars Mastodon

Hugo QR 短代碼

使用 qr 短代碼在你的內容中插入 QR 碼。
New in v0.141.0

要覆蓋 Hugo 內置的 qr 短代碼,請將 源代碼 復制到 layouts/_shortcodes 目錄中同名文件中。

qr 短代碼使用指定的選項將給定的文本編碼為 QR 碼 並渲染生成的圖片。

在內部,此短代碼調用 images.QR 函數。請閱讀 相關文檔 以了解實現細節和指導。

示例

使用自閉合語法將文本作為參數傳遞:

{{< qr text="https://www.hugodoc.com" />}}

或者在開始和結束標簽之間插入文本:

{{< qr >}}
https://www.hugodoc.com
{{< /qr >}}

以上兩者都會生成此圖片:

要為電話號碼創建 QR 碼:

{{< qr text="tel:+12065550101" />}}

要以 vCard 格式創建包含聯系信息的 QR 碼:

{{< qr level="low" scale=2 alt="John Smith 的 vCard 的 QR 碼" >}}
BEGIN:VCARD
VERSION:2.1
N;CHARSET=UTF-8:Smith;John;R.;Dr.;PhD
FN;CHARSET=UTF-8:Dr. John R. Smith, PhD.
ORG;CHARSET=UTF-8:ABC Widgets
TITLE;CHARSET=UTF-8:Vice President Engineering
TEL;TYPE=WORK:+12065550101
EMAIL;TYPE=WORK:jsmith@example.org
END:VCARD
{{< /qr >}}
John Smith 的 vCard 的 QR 碼

參數

text
(string) 要編碼的文本,回退到短代碼開始和結束標簽之間的文本。
level
(string) 編碼文本時使用的糾錯級別,lowmediumquartilehigh 之一。默認值為 medium
scale
(int) 每個 QR 碼模塊的圖像像素數。必須大於或等於 2。默認值為 4
targetDir
(string) Hugo 將在 publishDir 內的子目錄中放置生成的圖像。
alt
(string) img 元素的 alt 屬性。
class
(string) img 元素的 class 屬性。
id
(string) img 元素的 id 屬性。
loading
(string) img 元素的 loading 屬性,eagerlazy
title
(string) img 元素的 title 屬性。

Last updated: January 1, 0001
Improve this page