attachments

The Attachments shortcode displays a list of files attached to a page. Example : <div class=“alert alert-success”

role=“alert”>

        <li>
            <a href="//hugo-theme/shortcodes/attachments.files/BachGavotteShort.mp3" >
                BachGavotteShort.mp3
            </a>
            (357 kB)
        </li>




        <li>
            <a href="//hugo-theme/shortcodes/attachments.files/Carroll_AliceAuPaysDesMerveilles.pdf" >
                Carroll_AliceAuPaysDesMerveilles.pdf
            </a>
            (175 kB)
        </li>




        <li>
            <a href="//hugo-theme/shortcodes/attachments.files/adivorciarsetoca00cape.pdf" >
                adivorciarsetoca00cape.pdf
            </a>
            (361 kB)
        </li>




        <li>
            <a href="//hugo-theme/shortcodes/attachments.files/hugo.png" >
                hugo.png
            </a>
            (17 kB)
        </li>




        <li>
            <a href="//hugo-theme/shortcodes/attachments.files/movieselectricsheep-flock-244-32500-2.mp4" >
                movieselectricsheep-flock-244-32500-2.mp4
            </a>
            (340 kB)
        </li>

Usage

The shortcurt lists files found in a specific folder. Currently, it support two implementations for pages

  1. 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
  2. If your page is a folder, attachements must be place in a nested ‘files’ folder.

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

That’s all !

parameters

Parameter Default Description
title “Attachments” List’s title
pattern ”.*” A regular expressions, used to filter the attachments by file name.

<div class=“alert
alert-warning"

role=“alert”>The pattern parameter value must be regular expressions.

For example:

|

Demo

List of attachments ending in pdf or mp4

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

renders as

  • Carroll_AliceAuPaysDesMerveilles.pdf (175 kB)
  • adivorciarsetoca00cape.pdf (361 kB)
  • movieselectricsheep-flock-244-32500-2.mp4 (340 kB)