The Attachments shortcode displays a list of files attached to a page.
The shortcurt lists files found in a specific folder. Currently, it support two implementations for pages
If your page is a markdown file, attachements must be place in a folder named like your page and ending with .files.
- content
- _index.md
- page.files
- attachment.pdf
- page.md
If your page is a folder, attachements must be place 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.
That’s all !
| Parameter | Default | Description |
|---|---|---|
| title | “Attachments” | List’s title |
| style | ”” | Choose between “orange”, “grey”, “blue” and “green” for nice style |
| pattern | ”.*” | A regular expressions, used to filter the attachments by file name. The pattern parameter value must be regular expressions. |
For example:
{{%attachments title="Related files" pattern=".*(pdf|mp4)"/%}}
renders as
renders as renders as renders as renders asColored styled box
{{%attachments style="orange" /%}}
{{%attachments style="grey" /%}}
{{%attachments style="blue" /%}}
{{%attachments style="green" /%}}