Aller au contenu principal

Actifs statiques

Les ressources statiques sont les fichiers non liés au code qui sont directement copiés dans le résultat de la compilation. Elles comprennent les images, les feuilles de style, les favicons, les polices, etc.

Vous devez placer ces ressources dans le dossier static. Chaque fichier que vous placez dans ce dossier est copié à la racine du dossier de compilation généré, en conservant la hiérarchie des dossiers. Par exemple, si vous ajoutez un fichier nommé sun.jpg au dossier static, il sera copié dans build/sun.jpg.

Cela signifie que :

  • Pour un site dont la baseUrl est « '/' », l’image /static/img/sun.jpg sera servie à l’adresse /img/sun.jpg.
  • Pour un site dont baseUrl: '/subpath/', l’image /static/img/sun.jpg sera accessible à l’adresse /subpath/img/sun.jpg.

Référencer votre ressource statique​

Dans le CMS​

  1. Insérez un lien.
  2. Saisissez le chemin absolu, par exemple /files/note.docx.
  3. Saisissez le texte à afficher.

En Markdown​

You write a link like this: [Download this document](/files/note.docx)

Docusaurus changes that to: <a href={require('static/files/note.docx')}>Download this document</a>

Pour plus d’informations, consultez la section Ressources statiques dans la documentation de Docusaurus.