2.2 KiB
| title | description |
|---|---|
| Attachments (Pièces jointes) | The Attachments shortcode displays a list of files attached to a page. |
Le shortcode Attachments affiche une liste de pièces jointes d'une page.
{{% attachments /%}}
Utilisation
Le shortcode affiche la liste de fichiers trouvés dans un dossier spécifique A l'heure actuelle, il supporte deux implémentations
-
Si votre page est un fichier Markdown, les pièces jointes doivent être placée dans un dossier nommé comme le nom de la page et suffixé par .files.
- content
- _index.md
- page.files
- attachment.pdf
- page.md
- content
-
Si votre page est un dossier, les pièces jointes doivent être placées dans un dossier fils 'files'.
- content
- _index.md
- page
- index.md
- files
- attachment.pdf
- content
Attention, si votre site est multi-langue, vous devrez avec autant de dossier qu'il y a de langues.
C'est tout !
Paramètres
| Paramètre | Défaut | Description |
|---|---|---|
| title | "Pièces jointes" | Titre de la liste |
| style | "" | Choisir entre "orange", "grey", "blue" et "green" pour un style plus sympa |
| pattern | ".*" | Une expression régulière, utilisée pour filtrer les pièces jointes par leur nom de fichier. Le paramètre pattern doit être une expression régulière. |
Par exemple:
- Pour trouver les fichiers avec le suffixe '.jpg', utilisez
.*\.jpg$(pas*.jpg). - Pour trouver les fichiers avec les suffixe '.jpg' ou '.png', utilisez
.*\.(jpg|png)$.
Exemples
Lister les pièces jointes de type pdf ou mp4
{{%/*attachments title="Fichiers associés" pattern=".*\.(pdf|mp4)$"/*/%}}
s'affiche comme
{{%attachments title="Fichiers associés" pattern=".*.(pdf|mp4)$"/%}}
Modifier le style
{{%/*attachments style="orange" /*/%}}
s'affiche comme
{{% attachments style="orange" /%}}
{{%/*attachments style="grey" /*/%}}
s'affiche comme
{{% attachments style="grey" /%}}
{{%/*attachments style="blue" /*/%}}
s'affiche comme
{{% attachments style="blue" /%}}
{{%/*attachments style="green" /*/%}}
s'affiche comme
{{% attachments style="green" /%}}