Résumés de Contenu

Avec l’usage de la [variable de page][pagevariables] .Summary, Hugo génère des résumés de contenu à utiliser comme version courte dans les vues résumées.

Options de Fractionnement du Résumé

Fractionnement de Résumé défini-par-Hugo
Fractionnement de Résumé défini par l’utilisateur

Il est naturel d’accompagner le résumé avec des liens vers le contenu d’origine, et un modèle de conception commun est de voir ce lien sous la forme d’un bouton “Lire la suite …”. Voir les variables de page .RelPermalink, .Permalink et .Truncated.

Défini-par-Hugo : Le Fractionnement de Résumé Automatique

Par défaut, Hugo prend automatiquement les 70 premiers mots de votre contenu en tant que résumé et le stocke dans la variable de page .Summary à utiliser dans vos modèles. Prendre l’approche définie par Hugo pour les résumés peut faire gagner du temps, mais il y a des avantages et des inconvénients :

Avantages : Automatique, aucun travail supplémentaire à faire de votre côté.
Inconvénients : Tous les tags HTML sont retirés du résumé, et les 70 premiers mots, qu’ils appartiennent à un titre ou à des paragraphes différents, sont tous mis en un seul paragraphe.

Défini-par-l’utilisateur : Fractionnement de Résumé Manuel

Sinon, vous pouvez ajouter le diviseur de résumé  où vous souhaitez diviser l’article. Pour l’organisation de contenu, utilisez # more à l’endroit où vous voulez diviser l’article. Le contenu qui vient avant le diviseur de résumé sera utilisé comme résumé de ce contenu et stocké dans la variable de page .Summary avec toute la mise en forme HTML intacte.

Avantages : Liberté, précision, et rendu amélioré. Toutes les balises HTML et la mise en page sont préservées.
Inconvénients : Travail en plus pour les auteurs de contenu, parce qu’ils ont beson de taper  (ou # more pour l’organisation de contentu) dans chaque fichier de contenu. Cela peut s’automatiser en ajoutant le diviseur de résumé en dessous du front matter d’un archetype.

Exemple : Les 10 Premiers Articles avec Résumés

Vous pouvez afficher les résumés de contenu avec le code suivant. Vous pouvez utiliser l’extrait suivant, par exemple, dans un modèle de section.

page-list-with-summaries.html

{{ range first 10 .Data.Pages }}
    <article>
      <!-- this <div> includes the title summary -->
      <div>
        <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
        {{ .Summary }}
      </div>
      {{ if .Truncated }}
      <!-- This <div> includes a read more link, but only if the summary is truncated... -->
      <div>
        <a href="{{ .RelPermalink }}">Lire la suite…</a>
      </div>
      {{ end }}
    </article>
{{ end }}

Notez comment la valeur booléenne .Truncated peut être utilisée pour cacher le lien “Lire la suite…” lorsque le contenu n’est pas tronqué ; c’est-à-dire lorsque le résumé contient l’article entier.