使用{{% attachments / %}}
标签可以添加附件到页面上。
这种方式会自动列出特定目录下的文件作为附件,目前支持下面两种用法:
如果当前页面是 Markdown 文件,则附件必须放置在与当前页面名称相同且以 .files 结尾的文件夹中,如下:
- content
- _index.md
- page.files
- attachment.pdf
- page.md
如果当前页面是文件夹中的index页面, 那么附件必须放置在当前目录的 ‘files’ 目录下:
- content
- _index.md
- page
- index.md
- files
- attachment.pdf
另外如果启用多语言,那么目录数量应该和语言数量相同,即文件要存储多份。
Parameter | Default | Description |
---|---|---|
title | “Attachments” | 列表的标题 |
style | "" | 支持的风格: “orange”, “grey”, “blue”, “green” |
pattern | “.*” | 支持按照正则表达式过滤文件名, 模式串必须是正则表达式而不是通配符,正则表达式用法可以参考 regular expression. |
例如:
.*\.jpg$
(不是 *.jpg
)..*\.(jpg|png)$
.{{%attachments title="Related files" pattern=".*\.(pdf|mp4)$"/%}}
显示如下:
{{%attachments style="orange" /%}}
显示为橙色:
{{%attachments style="grey" /%}}
显示为灰色:
{{%attachments style="blue" /%}}
显示为蓝色:
{{%attachments style="green" /%}}
显示为绿色: