resources - 附件

resources - 附件简码显示附加到页面的文件列表,具有可调整的颜色、标题和图标.

附件
警告

要想使用resources附件简码,需要HUGO版本>=0.112.0.如果需要安装最新版HUGO,请点击 安装HUGO

用法

当示例使用带有命名参数的简码时,您也可以自由地从自己的部分调用此简码.

​
{{% resources sort="asc" /%}}
{{ partial "shortcodes/resources.html" (dict
  "page" .
  "sort" "asc"
)}}

参数

名字 默认值 注释
style transparent 用于框的样式方案.

- 按严重程度: info, note, tip, warning
- 按品牌颜色: primary, secondary, accent
- 按颜色: blue, green, grey, orange, red
- 按特殊颜色: default, transparent, code
color 请参阅注释 要使用的 CSS 颜色值.如果未设置,则所选颜色取决于style.任何给定值都将覆盖默认值.

- 对于严重性样式：严重性的颜色匹配良好
- 对于所有其他样式：相应的颜色
title 请参阅注释 框标题的任意文本.根据 style,可能会有一个默认标题.任何给定值都将覆盖默认值.

- 对于严重性样式：严重性的匹配标题
- 适用于所有其他样式: resources

如果不希望严重性样式的标题,则必须将此参数设置为 " "(填充空格,非空字符串)
icon 请参阅注释 字体真棒图标名称 设置在标题的左侧.根据 style,可能会有一个默认图标.任何给定值都将覆盖默认值.

- 对于严重性样式：严重性的一个很好的匹配图标
- 对于所有其他样式: paperclip

如果你不想图标,你必须将此参数设置为 " "(填充空格,非空字符串)
sort asc 对输出进行排序:asc升序 或 desc降序.
pattern .* 正则表达式,用于按文件名过滤附件.例如:

- 要匹配文件后缀jpg,请使用.*.jpg(而不是*.\.jpg)
- 要匹配以jpg或png结尾的文件名,请使用 .*\.(jpg|png)

安装

单语言

简码列出了在特定文件夹中找到的文件.文件夹的名称取决于您的页面类型(分支捆绑包、叶捆绑包或页面).

  1. 如果您的page1.md在子目录,则必须相应地将附件放置在嵌套的page1.files文件夹中.

    • content
      • _index.md
      • page
        • _index.md
        • _index.files
          • demo.pdf
          • demo.png
          • demo.txt
          • tunetank.com_1922_time-flies_by_melancholicbird.mp3

  2. 如果您的.md文件在子文件夹,则必须相应地将附件放置在嵌套的_index.files文件夹中.

    • content
      • _index.md
      • page
        • index.md
        • index.files
          • demo.pdf
          • demo.png
          • demo.txt
          • tunetank.com_1922_time-flies_by_melancholicbird.mp3

  3. 对于简单页面,附件必须放置在名称类似于页面并以.files结尾的文件夹中.

    • content
      • _index.md
      • _index.files
        • demo.pdf
        • demo.png
        • demo.txt
        • tunetank.com_1922_time-flies_by_melancholicbird.mp3
      • page.md

多种语言

请注意,如果您使用多语言网站,则需要拥有与语言一样多的文件夹,并且语言代码必须是文件夹名称的一部分.

例如.对于简体和繁体的网站：

  • content
    • index.zh-cn.md
    • index.zh-tw.md
    • page
      • index.zh-cn.md
      • index.zh-tw.md
      • index.zh-cn.files
        • demo.pdf
        • demo.png
        • demo.txt
        • tunetank.com_1922_time-flies_by_melancholicbird.mp3
      • index.zh-tw.files
        • demo.pdf
        • demo.png
        • demo.txt
        • tunetank.com_1922_time-flies_by_melancholicbird.mp3

示例

自定义标题,以pdf或mp4结尾的附件列表

{{% resources title="指定扩展名**文件**" pattern=".*\.(pdf|mp4)" /%}}
指定扩展名文件

信息样式框,降序排序

{{% resources style="info" sort="desc" /%}}
信息

具有用户定义的颜色和 字体真棒品牌图标

{{% resources color="fuchsia" icon="fab fa-hackerrank" /%}}
附件

样式、颜色、标题和图标

有关 style、color、title 和 icon 的更多示例,请参阅 notice 简码 文档.该参数对于两个短代码的工作方式相同,只是具有不同的默认值.