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