Sur cette page

• assets.dir
• assets.target
• assets.fingerprint
• assets.compile
• assets.minify
• assets.images
• assets.images.cdn
• assets.remote.useragent

Assets

Gestion des ressources (images, fichiers CSS et JS).

assets.dir

Répertoire source des ressources (assets par défaut).

assets:
  dir: assets

assets.target

Répertoire où les fichiers de ressources distants et redimensionnés sont enregistrés (root par défaut).

assets:
  target: ''

assets.fingerprint

Active le fingerprinting (cache busting) pour les fichiers de ressources (true par défaut).

assets:
  fingerprint: true

assets.compile

Active la compilation des fichiers Sass (true par défaut). Voir la documentation de scssphp pour les détails des options.

assets:
  compile:
    style: expanded      # style de compilation (`expanded` ou `compressed`, `expanded` par défaut)
    import: [sass, scss] # liste des chemins importés (`[sass, scss, node_modules]` par défaut)
    sourcemap: false     # active les sourcemaps en mode debug (`false` par défaut)
    variables: []        # liste de variables préconfigurées (vide par défaut)

assets.minify

Active la minification CSS et JS (true par défaut).

assets:
  minify: true

assets.images

Gestion des images.

assets:
  images:
    optimize: false # active l’optimisation d’images avec JpegOptim, Optipng, Pngquant 2, SVGO 1, Gifsicle, cwebp, avifenc (`false` par défaut)
    quality: 75     # qualité d’image pour `optimize` et `resize` (`75` par défaut)
    responsive:
      widths: [480, 640, 768, 1024, 1366, 1600, 1920] # largeurs d’image pour l’attribut `srcset`
      sizes:
        default: '100vw' # attribut `sizes` par défaut (`100vw` par défaut)

assets.images.cdn

L’URL des ressources image peut être facilement remplacée par une url de CDN fournie.

assets:
  images:
    cdn:
      enabled: false  # active Image CDN (`false` par défaut)
      canonical: true # `image_url` est canonique (au lieu d’un chemin relatif) (`true` par défaut)
      remote: true    # prend aussi en charge les images non locales (`true` par défaut)
      account: 'xxxx' # compte du fournisseur
      url: 'https://provider.tld/%account%/%image_url%?w=%width%&q=%quality%&format=%format%'

url est un modèle qui contient des variables :

• %account% remplacé par l’option assets.images.cdn.account
• %image_url% remplacé par l’URL canonique de l’image ou par path
• %width% remplacé par la largeur de l’image
• %quality% remplacé par l’option assets.images.quality
• %format% remplacé par le format de l’image

Voir les fournisseurs CDN.

assets.remote.useragent

User agent utilisé pour télécharger les ressources distantes.

assets:
  remote:
    useragent:
      default: <string> # user agent par défaut
      useragent1: <string>
      useragent2: <string>