Éléments Bootstrap
Posté le 12 août 2023 (Dernière modification le 6 novembre 2024) • 12 min de lecture • 2 371 motsUtilisez des shortcodes pour ajouter facilement des éléments Bootstrap courants.
Hinode propose plusieurs shortcodes qui enveloppent des composants Bootstrap courants. Consultez la documentation officielle pour plus de détails.
À titre d’exemple, le shortcode suivant affiche le texte complet d’une abréviation lorsque survolé.
{{< abbr "CI/CD" >}}
À titre d’exemple, le shortcode suivant affiche un accordéon avec trois éléments, dont le premier élément est déplié.
show
à l’argument class
.{{< accordion >}}
{{< accordion-item header="Élément d'accordéon #1" show="true" >}}
Il s'agit du contenu du corps du premier élément de l'accordéon. Il prend en charge le contenu HTML, s'il est activé dans le moteur de rendu goldmark. L'élément est affiché en ajoutant la valeur `show` à l'argument `class`.
{{< /accordion-item >}}
{{< accordion-item header="Élément d'accordéon #2" >}}
Il s'agit du contenu du corps du deuxième élément de l'accordéon.
{{< /accordion-item >}}
{{< accordion-item header="Élément d'accordéon #3" >}}
Il s'agit du contenu du corps du troisième élément de l'accordéon.
{{< /accordion-item >}}
{{< /accordion >}}
À titre d’exemple, le shortcode suivant affiche une alerte simple.
{{< alert color="danger" dismissible="true" >}}
Une simple alerte de danger — vérifiez-la !
{{< /alert >}}
Utilisez le shortcode “badge” pour afficher un badge avec un en-tête.
En-tête 1 Nouveau
En-tête 2 Nouveau
En-tête 3 Nouveau
En-tête 4 Nouveau
En-tête 5 Nouveau
En-tête 6 Nouveau
En-tête 1 {{< badge title="Nouveau" >}}
{.h1}
En-tête 2 {{< badge title="Nouveau" >}}
{.h2}
En-tête 3 {{< badge title="Nouveau" >}}
{.h3}
En-tête 4 {{< badge title="Nouveau" >}}
{.h4}
En-tête 5 {{< badge title="Nouveau" >}}
{.h5}
En-tête 6 {{< badge title="Nouveau" >}}
{.h6}
À titre d’exemple, le shortcode suivant affiche un fil d’Ariane pour la page du blog.
{{< breadcrumb path="blog" >}}
À titre d’exemple, le shortcode suivant affiche une infobulle pour un bouton sombre avec un badge.
{{< button color="secondary" tooltip="Cliquez sur la boîte de réception pour voir vos messages non lus." href="#!" badge="99+" >}}
Boîte de réception
{{< /button >}}
À titre d’exemple, le shortcode suivant affiche un groupe de trois boutons.
{{< button-group aria-label="Basic example" >}}
{{< button color="primary" href="#!" >}}Gauche{{< /button >}}
{{< button color="primary" href="#!" >}}Millieu{{< /button >}}
{{< button color="primary" href="#!" >}}Droite{{< /button >}}
{{< /button-group >}}
À titre d’exemple, le shortcode suivant affiche une carte empilée qui renvoie à la page à propos. Elle inclut un en-tête personnalisé.
17 février 2023 •1 min de lecture
À propos
{{< card path="about" padding="3" class="col-6 mx-auto" color="body-tertiary"
header="publication" footer="none" button=true />}}
À titre d’exemple, le shortcode suivant affiche un groupe de cartes avec trois éléments.
Framework Bootstrap
Recherche en texte intégral
Outils de développement
{{< card-group padding="3" gutter="3" >}}
{{< card title="Framework Bootstrap" icon="fab bootstrap" >}}
Créez des sites rapides et réactifs avec Bootstrap 5. Personnalisez facilement votre site
avec les fichiers source Sass.
{{< /card >}}
{{< card title="Recherche en texte intégral" icon="fas magnifying-glass" >}}
Recherchez votre site avec FlexSearch, une bibliothèque de recherche en texte intégral
avec zéro dépendances.
{{< /card >}}
{{< card title="Outils de développement" icon="fas code" >}}
Utilisez Node Package Manager pour automatiser le processus de construction et suivre
les dépendances.
{{< /card >}}
{{< /card-group >}}
À titre d’exemple, le shortcode suivant affiche un carrousel centré avec trois slides, un rapport hauteur/largeur de 16:9 et une largeur relative de 67 % sur les grands écrans.
{{< carousel ratio="16x9" class="col-sm-12 col-lg-8 mx-auto" >}}
{{< img src="img/coffee.jpg" caption="slide 1" >}}
{{< img src="img/phone.jpg" caption="slide 2" >}}
{{< img src="img/dunes.jpg" caption="slide 3" >}}
{{< /carousel >}}
À titre d’exemple, le shortcode suivant affiche un bouton qui, lorsqu’il est cliqué, déclenche l’apparition ou la disparition d’un panneau.
{{< button collapse="collapse-1" >}}
Déclencher le panneau
{{< /button >}}
{{< collapse id="collapse-1" class="p-3 border rounded bg-primary-subtle" >}}
Un contenu de remplacement destiné au composant de repliement. Ce panneau est initialement masqué, mais il
sera révélé lorsque l'utilisateur active le déclencheur correspondant.
{{< /collapse >}}
Utilisez le shortcode command
pour générer un bloc avec un invite de commandes bash par défaut.
export MY_VAR=123
{{< command >}}
export MY_VAR=123
{{< /command >}}
Spécifiez user
et host
pour ajouter le contexte de l’utilisateur à l’invite. De plus, utilisez (out)
pour spécifier une ligne de sortie et utilisez \
pour indiquer une continuation de ligne.
export MY_VAR=123
echo "hello"
hello
echo one \
two \
three
one two three
echo "goodbye"
goodbye
{{< command user="user" host="localhost" >}}
export MY_VAR=123
echo "hello"
(out)hello
echo one \
two \
three
(out)one two three
echo "goodbye"
(out)goodbye
{{< /command >}}
Utilisez le shortcode docs
pour afficher le contenu d’un fichier js
, scss
ou toml
:
[style]
primary = "#d43900"
secondary = "#6c757d"
success = "#198754"
info = "#0dcaf0"
warning = "#ffc107"
danger = "#dc3545"
light = "#f8f9fa"
dark = "#212529"
themeOpacity = "10"
darkModeShade = "20%"
darkModeTint = "40%"
themeFont = "Inter"
# themeFontPath = "https://fonts.googleapis.com/css2?family=Inter:wght@200;300;600&display=swap" # external path
themeFontPath = "/fonts" # local path
themeFontPreload = "/fonts/inter-v12-latin-regular.woff2"
purge = false # TODO: fix purge setting of example site
Utilisez le shortcode example
pour afficher un exemple de code et pour afficher un aperçu de la même entrée.
export MY_VAR=123
{{< command >}}
export MY_VAR=123
{{< /command >}}
Utilisez le shortcode file
pour afficher et mettre en évidence le contenu complet d’un fichier d’entrée donné.
# toml-docs-start lang-main
[en]
languageName = "English"
contentDir = "content/en"
weight = 1
# toml-docs-end lang-main
# toml-docs-start lang-param
[en.params.head]
tagline = "A Hugo Theme"
[en.params.social]
title = "Follow me"
caption = "I work on everything coding and tweet developer memes"
[en.params.footer]
# license = "Licensed under Creative Commons (<a href='https://creativecommons.org/licenses/by-nc-sa/4.0/' class='link-secondary' target='_blank' rel='noopener noreferrer nofollow'>CC BY-NC-SA 4.0</a>)."
# toml-docs-end lang-param
[en.params.sections.blog]
reference = "More Posts"
[en.params.sections.projects]
reference = "More Projects"
[nl]
languageName = "Nederlands"
contentDir = "content/nl"
weight = 2
[nl.params.opengraph]
locale = "nl_NL"
[nl.params.head]
tagline = "Een Hugo Thema"
[nl.params.social]
title = "Volg mij"
caption = "Ik doe aan programmeren en tweet memes"
[nl.params.footer]
# license = "Gelicenseerd onder Creative Commons (<a href='https://creativecommons.org/licenses/by-nc-sa/4.0/' class='link-secondary' target='_blank' rel='noopener noreferrer nofollow'>CC BY-NC-SA 4.0</a>)."
[nl.params.sections.blog]
reference = "Meer artikelen"
[nl.params.sections.projects]
title = "Projecten"
reference = "Meer projecten"
[fr]
languageName = "Français"
contentDir = "content/fr"
weight = 2
[fr.params.opengraph]
locale = "fr_FR"
[fr.params.head]
tagline = "Un thème Hugo"
[fr.params.social]
title = "Suivez-moi"
caption = "Je code et je tweet des mèmes de développeurs."
[fr.params.footer]
# license = "Gelicenseerd onder Creative Commons (<a href='https://creativecommons.org/licenses/by-nc-sa/4.0/' class='link-secondary' target='_blank' rel='noopener noreferrer nofollow'>CC BY-NC-SA 4.0</a>)."
[fr.params.sections.blog]
reference = "Plus d'articles"
[fr.params.sections.projects]
title = "Projets"
reference = "Plus de projets"
{{< file path="./config/_default/languages.toml" id="file-collapse-1" >}}
À titre d’exemple, les shortcodes suivants affichent une coche carrée, un logo de marque et une coche circulaire.
{{< fa square-check >}}
{{< fab linkedin >}}
{{< fas circle-check >}}
À titre d’exemple, le shortcode suivant affiche une image avec des coins arrondis et un ratio d’aspect de 21:9.
{{< image src="img/flowers.jpg" ratio="21x9" caption="Légende de l'image" class="rounded" >}}
À titre d’exemple, le shortcode suivant affiche une image vectorielle classique.
{{< image src="/img/logo_icon.svg" class="col-sm-6 col-lg-4" wrapper="text-center" >}}
À titre d’exemple, le shortcode suivant affiche une image vectorielle avec une référence de symbole.
{{< image src="/img/logo_var.svg#logo" class="col-sm-6 col-lg-4" wrapper="text-center" >}}
À titre d’exemple, les shortcodes suivants rendent des liens dans différents formats.
- {{< link hinode >}}Lien nommé avec les paramètres par défaut{{< /link >}}
- {{< link name=hinode cue=false tab=false >}}Lien nommé s'ouvrant dans l'onglet actuel sans icône{{< /link >}}
- {{< link name=hinode cue=true tab=true >}}Lien nommé s'ouvrant dans un nouvel onglet avec icône{{< /link >}}
- {{< link hinode />}}
- {{< link href="https://developer.mozilla.org" >}}Lien externe{{< /link >}}
- {{< link "./projects/another-project" >}}Lien interne avec titre{{< /link >}}
- {{< link url="projects/another-project" />}}
- {{< link url="/projects/another-project" />}}
- {{< link url="../projects/another-project" case=false />}}
- {{< link "about" />}}
- {{< link "/en/about/" />}}
- {{< link "/en/about" >}}About (Anglais){{< /link >}}
- {{< link "#image" />}}
- {{< link "components/#map" />}}
Utilisez le shortcode mark
pour mettre en évidence le texte. Le contenu interne est utilisé en tant qu’entrée.
mark
pour
mettre en évidence un texte spécifique.Utilisez le shortcode `mark` pour {{< mark >}}mettre en évidence{{< /mark >}} un texte spécifique.
À titre d’exemple, le shortcode suivant affiche un groupe d’onglets avec des onglets alignés verticalement.
{{< nav type="pills" vertical="true" >}}
{{< nav-item header="Élément de navigation #1" show="true" >}}
Voici le contenu de navigation du premier élément. Il prend en charge le contenu HTML, s'il est
activé dans le moteur de rendu Goldmark. L'élément est affiché en ajoutant la valeur `show` à l'argument `class`.
{{< /nav-item >}}
{{< nav-item header="Élément de navigation #2" >}}
Voici le contenu de navigation du deuxième élément.
{{< /nav-item >}}
{{< nav-item header="Élément de navigation #3" >}}
Voici le contenu de navigation du troisième élément.
{{< /nav-item >}}
{{< /nav >}}
À titre d’exemple, le shortcode suivant affiche un en-tête de navigation clair.
{{< navbar id="navbar-sample" path="blog" color="primary" size="md" search="false" menus="sample" title="Marque" mode="false" >}}
À titre d’exemple, le shortcode suivant affiche un bouton de publication par défaut.
À titre d’exemple, le raccourci suivant affiche un indicateur de chargement centré.
{{< spinner color="info" class="text-center" >}}
Chargement...
{{< /spinner >}}
À titre d’exemple, le shortcode suivant affiche du texte en indice.
H{{< sub 2 >}}O est un liquide.
À titre d’exemple, le shortcode suivant affiche du texte en exposant.
2{{< sup 10 >}} équivaut à 1024.
À titre d’exemple, le shortcode suivant affiche une chronologie avec le fichier data/timeline-fr.yml
en tant que données.
1 juillet 2023
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.
30 novembre 2022
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.
1 juillet 2023
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.
30 novembre 2022
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.
{{< timeline data="timeline-fr" background="dark" >}}
À titre d’exemple, le shortcode suivant affiche un bouton qui, lorsqu’il est cliqué, déclenche le message de notification.
markdown
.markdown
.{{< button toast="toast-example-1" >}}
Affiche la notification #1
{{< /button >}}
{{< button toast="toast-example-2" >}}
Affiche la notification #1
{{< /button >}}
{{< toast id="toast-example-1" header="Premier titre" >}}
Ceci est le premier message de notification. Il prend en charge le `markdown`.
{{< /toast >}}
{{< toast id="toast-example-2" header="Deuxième titre" >}}
Ceci est le deuxième message de notification. Il prend en charge le `markdown`.
{{< /toast >}}
À titre d’exemple, le shortcode suivant affiche une infobulle pour un lien hypertexte coloré.
{{< tooltip color="primary" title="Légende de l'infobulle" href="#!" >}}Démonstration{{< /tooltip >}} d'une infobulle
À titre d’exemple, le shortcode suivant affiche une vidéo d’éléphant hébergée par Cloudinary.
{{< video host="cloudinary" account="demo" id="elephants" autoplay=true >}}