hugo-theme-relearn/exampleSite/content/shortcodes/attachments.en.md
Sören Weber 8551ee2738
shortcodes: revamp shortcodes #260 #261
- supply named parameter if missing #260
- fix boolean parameter if given as string #261
- revise documentation
2022-06-05 19:31:59 +02:00

3 KiB

+++ description = "List of files attached to a page" title = "Attachments" +++

The attachments shortcode displays a list of files attached to a page with adjustable color, title and icon.

{{% attachments /%}}

Usage

{{%/* attachments /*/%}}

The shortcurt lists files found in a specific folder.

Currently, it supports two implementations for pages

  1. If your page is a Markdown file, attachements must be placed in a folder named like your page and ending with .files.

    • content
      • _index.md
      • page.files
        • attachment.pdf
      • page.md
  2. If your page is a folder, attachements must be placed in a nested files folder.

    • content
      • _index.md
      • page
        • index.md
        • files
          • attachment.pdf

Be aware that if you use a multilingual website, you will need to have as many folders as languages.

Parameter

Name Default Notes
style transparent The color scheme used to highlight the box content.

- by severity: info, note, tip, warning<nd color: primary, secondary
- by color: blue, green, grey, orange, red
- by special color: default,t`
title see notes Arbitray text for the box title. Depending on the style there may be a default title. Any given value will overwault.

- for severity styles: the matching title for the severity
- for all other colors: Attachments

If you wa you have to set this parameter to " " (a non empty string filled with spaces)
icon see notes [Font Awesome icon name]({{%relref "cont/icons#finding-an-icon" %}}) set to the left of the title. Depending le** there may be a default icon. Any given value will overwrite the default.

- for severity styles: a nice matching iseverity
- for all other colors: paperclip

If you want no icon, you have to set this parameter to " " (a non empty d with spaces)
sort asc Sorting the output in ascending or descending order.
pattern .* A regular expressions, used to filter the attachments by file name. For example:

- to match a file suffix of 'jpg', use .*jpg (not *.jpg)
- to match file names ending in jpg or png, use .*(jpg|png)

Examples

Custom Title, List of Attachments Ending in pdf or mp4

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

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

Info Styled Box, Descending Sort Order

{{%/* attachments style="info" sort="desc" /*/%}}

{{% attachments style="info" sort="desc" /%}}

Style and Icons

For further examples for style, title and icon, see the [notice shortcode]({{% relref "shortcodes/notice" %}}) documentation. The parameter are working the same way for both shortcodes, besides having different defaults.