Passer au contenu principal
Mintlify diffuse automatiquement les ressources statiques depuis votre référentiel de documentation au chemin approprié sur votre domain. Par exemple, si vous avez /images/my-logo.png dans votre référentiel, le fichier image est disponible à l’URL https://docs.your-project.com/images/my-logo.png. Vous pouvez mettre à disposition de vos utilisateurs n’importe quel type de fichier pris en charge, notamment des spécifications OpenAPI, des images, des vidéos, et plus encore. Les fichiers doivent faire moins de 20 Mo pour les images et 100 Mo pour les autres types de fichiers.
La diffusion de fichiers n’est pas prise en charge pour les sites de documentation avec authentification activée. Si votre site nécessite une authentification, les fichiers statiques ne seront pas accessibles via leurs URL directes.

​
Types de fichiers pris en charge

​
Formats d’images

  • .jpeg, .jpg, .jfif, .pjpeg, .pjp
  • .png
  • .svg, .svgz
  • .ico
  • .webp
  • .gif, .apng
  • .avif
  • .bmp
  • .tiff, .tif

​
Formats vidéo

  • .mp4
  • .webm
  • .ogg
  • .avi
  • .mov
  • .wmv
  • .flv
  • .mkv
  • .m4v

​
Formats audio

  • .mp3
  • .wav
  • .flac
  • .aac
  • .ogg
  • .wma
  • .m4a

​
Formats de polices

  • .woff
  • .woff2
  • .ttf
  • .otf
  • .eot

​
Formats de documents

Les formats de documents ne sont disponibles qu’avec les formules Custom et ne sont pas pris en charge lorsque l’authentification est activée.
  • .pdf
  • .txt
  • .doc, .docx
  • .xls, .xlsx
  • .ppt, .pptx
  • .rtf
  • .odt, .ods, .odp

​
Formats de données

Les formats de données sont disponibles uniquement avec les offres Custom et ne sont pas pris en charge lorsque l’authentification est activée.
  • .csv
  • .tsv
  • .xml

​
Formats d’archive

Les formats d’archive sont disponibles uniquement avec les plans Custom et ne sont pas pris en charge lorsque l’authentification est activée.
  • .zip
  • .rar
  • .7z
  • .tar
  • .gz
  • .bz2

​
Organisation des fichiers

Organisez vos fichiers à l’aide de dossiers pour que votre référentiel reste facile à naviguer : 
/votre-projet
  |- docs.json
  |- images/
    |- logo.png
    |- screenshots/
      |- dashboard.png
  |- assets/
    |- whitepaper.pdf
    |- demo-video.mp4
Les fichiers sont servis depuis la racine de votre domain, de sorte que la structure de votre référentiel corresponde directement à la structure des URL. Dans l’exemple précédent, assets/whitepaper.pdf serait accessible à l’adresse https://docs.your-project.com/assets/whitepaper.pdf.