Sur cette page

• output.dir
• output.formats
  • Formats par défaut
• output.pagetypeformats
• Exemple de configuration output
• output.postprocessors

Sortie

Définit où et dans quel format les pages sont rendues.

output.dir

Répertoire où les fichiers de pages rendues sont enregistrés (_site par défaut).

output:
  dir: _site

output.formats

Liste des définitions de formats de sortie, utilisés pour rendre les pages (par ex. HTML, Atom, RSS, JSON, XML, etc.).

output:
  formats:
    - name: <name>            # nom du format, par ex. `html` (requis)
      mediatype: <media type> # type MIME, ex. `text/html` (requis)
      rel: <rel>              # attribut `rel` du lien alternatif de la page, ex. `canonical` (facultatif, `alternate` par défaut)
      subpath: <sub path>     # sous-chemin, ex. `amp` dans `path/amp/index.html` (facultatif)
      filename: <file name>   # nom du fichier, ex. `index` dans `path/index.html` (facultatif)
      extension: <extension>  # extension du fichier, ex. `html` dans `path/index.html` (requis)
      exclude: [<variable>]   # n’applique pas ce format aux pages identifiées par les variables listées, ex. `[redirect, paginated]` (facultatif)

Ces formats sont utilisés dans la configuration output.pagetypeformats et dans la variable de page output.

Formats par défaut

Cecil fournit quelques formats par défaut, qui peuvent être surchargés dans le fichier de configuration : html (par défaut), atom, rss, json, xml, txt, amp, js, webmanifest, xsl, jsonfeed, oembed, embed, markdown, llms.

Les formats sont fusionnés par name : pour surcharger un format par défaut, définissez uniquement son name et les propriétés à modifier.

output:
  formats:
    - name: rss
      filename: feed # `feed.xml` au lieu de `rss.xml`

output.pagetypeformats

Il n’est pas nécessaire de définir la variable output pour chaque page, car Cecil applique automatiquement les formats définis pour chaque type de page (homepage, page, section, vocabulary et term).

output:
  pagetypeformats:
    page: [<format>]
    homepage: [<format>]
    section: [<format>]
    vocabulary: [<format>]
    term: [<format>]

Plusieurs formats peuvent être définis pour un même type de page. Par exemple, le type de page section peut être rendu automatiquement en HTML et Atom :

output:
  pagetypeformats:
    section: [html, atom]

Une liste remplace les formats par défaut du type de page (et s’ajoute aux formats définis par le thème). Pour ajouter ou retirer un format, utilisez plutôt un tableau de booléens :

output:
  pagetypeformats:
    homepage:
      rss: true   # ajoute RSS
      atom: false # retire Atom

Exemple de configuration output

output:
  dir: _site
  formats:
    - name: html
      mediatype: text/html
      filename: index
      extension: html
    - name: atom
      mediatype: application/atom+xml
      filename: atom
      extension: xml
      exclude: [redirect, paginated]
  pagetypeformats:
    page: [html]
    homepage: [html, atom]
    section: [html, atom]
    vocabulary: [html]
    term: [html, atom]

output.postprocessors

Liste des classes de post-processeurs de sortie, utilisés pour modifier les fichiers de sortie après leur génération.

Post-processeurs par défaut :

output:
  postprocessors:
    GeneratorMetaTag: 'Cecil\Renderer\PostProcessor\GeneratorMetaTag'
    HtmlExcerpt: 'Cecil\Renderer\PostProcessor\HtmlExcerpt'
    MarkdownLink: 'Cecil\Renderer\PostProcessor\MarkdownLink'

---