85 lines
No EOL
2.2 KiB
Markdown
85 lines
No EOL
2.2 KiB
Markdown
---
|
|
title: Attachments (Pièces jointes)
|
|
description : "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
|
|
|
|
1. 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
|
|
|
|
2. 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
|
|
|
|
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](https://en.wikipedia.org/wiki/Regular_expression). |
|
|
|
|
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" /%}} |