QR
v0.141.0 中的新功能
qr
短代码使用指定的选项将给定的文本编码为QR 码,并渲染生成的图像。
此短代码在内部调用 images.QR
函数。请阅读相关文档以了解实现细节和指南。
示例
使用自闭合语法传递文本作为参数
{{< qr text="https://gohugo.com.cn" />}}
或在开始和结束标签之间插入文本
{{< qr >}}
https://gohugo.com.cn
{{< /qr >}}
以上两种方法都会生成此图像

要为电话号码创建 QR 码
{{< qr text="tel:+12065550101" />}}

要创建包含 vCard 格式联系信息的 QR 码
{{< qr level="low" scale=2 alt="QR code of vCard for John Smith" >}}
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:[email protected]
END:VCARD
{{< /qr >}}

参数
- text
- (
字符串
)要编码的文本,默认为开始和结束短代码标签之间的文本。 - level
- (
字符串
)编码文本时要使用的纠错级别,可以是low
、medium
、quartile
或high
之一。默认值为medium
。 - scale
- (
整数
)每个 QR 码模块的图像像素数。必须大于或等于 2。默认值为4
。 - targetDir
- (
字符串
)Hugo 将生成的图像放置在publishDir
中的子目录。
- alt
- (
字符串
)img
元素的alt
属性。 - class
- (
字符串
)img
元素的class
属性。 - id
- (
字符串
)img
元素的id
属性。 - title
- (
字符串
)img
元素的title
属性。