Attachments

使用{{% attachments / %}}标签可以添加附件到页面上。

用法

这种方式会自动列出特定目录下的文件作为附件,目前支持下面两种用法:

  1. 如果当前页面是 Markdown 文件,则附件必须放置在与当前页面名称相同且以 .files 结尾的文件夹中,如下:

    • content
      • _index.md
      • page.files
        • attachment.pdf
      • page.md
  2. 如果当前页面是文件夹中的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).
  • 匹配以 ‘.jpg’ 或 ‘.png’结尾的文件, 使用 .*\.(jpg|png)$.

用法示例

列出以 pdf 或 mp4结尾的文件

{{%attachments title="Related files" pattern=".*\.(pdf|mp4)$"/%}}

显示如下:

彩色风格的附件框

{{%attachments style="orange" /%}}

显示为橙色:

{{%attachments style="grey" /%}}

显示为灰色:

{{%attachments style="blue" /%}}

显示为蓝色:

{{%attachments style="green" /%}}

显示为绿色: