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 >}}
参数
- text
- (
string) 要编码的文本,回退到短代码开始和结束标签之间的文本。 - level
- (
string) 编码文本时使用的纠错级别,low、medium、quartile或high之一。默认值为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属性,eager或lazy。 - title
- (
string)img元素的title属性。