Cartes
Les cartes peuvent être ajoutées à une page en utilisant le shortcode card
.
Les paramètres de ce shortcode sont :
Paramètre | Description |
---|---|
title | Le titre de la carte |
icon | Le slug de l'icône de la carte |
image | Utiliser une image personnalisée au lieu d'une icône (mutuellement exclusif avec l'icône) |
link | (Facultatif) La cible du lien de la carte, lorsqu'elle est cliquée |
description | Un texte de description, en Markdown |
NoteIl y a une limitation connue avec la description Markdown des cartes, en ce qu'elles ne peuvent pas contenir de liens relatifs, pointant vers d'autres documents .md. De tels liens ne s'afficheront pas correctement. Utilisez plutôt un lien absolu vers le chemin URL de la page que vous voulez lier.
Par exemple, au lieu de lier vers
../install/linux.md
, écrivez :/engine/install/linux/
.
Exemple
Balisage
{{< card
title="Mettez votre Docker en marche"
icon=favorite
link=https://docs.docker.com/
description="Construisez, partagez et exécutez vos applications avec Docker"
>}}
Grille
Il y a aussi un shortcode grid
intégré qui génère une... eh bien, une grille... de cartes.
La taille de la grille est de 3x3 sur les grands écrans, 2x2 sur les moyens, et une seule colonne sur les petits.
La grille est un shortcode distinct de card
, mais elle implémente le même composant sous le capot.
Le balisage que vous utilisez pour insérer une grille est légèrement non conventionnel. Le shortcode de grille ne prend aucun argument.
Tout ce qu'il fait, c'est vous permettre de spécifier où sur une page vous voulez que votre grille apparaisse.
{{< grid >}}
Les données de la grille sont définies dans le front matter de la page, sous la clé grid
, comme suit :
# section front matter d'une page
title: une page
grid:
- title: "Docker Engine"
description: Vrrrrooooommm
icon: "developer_board"
link: "/engine/"
- title: "Docker Build"
description: Clang bang
icon: "build"
link: "/build/"