Passer au contenu principal
Mintlify sert 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’adresse https://docs.your-project.com/images/my-logo.png. Cela fonctionne pour tout type de fichier que vous souhaitez mettre à disposition de vos utilisateurs, notamment les images, les PDF, les vidéos ou les schémas. Les fichiers doivent peser moins de 20 Mo pour les images et 100 Mo pour les autres types de fichiers.

Extensions de fichiers prises en charge

Mintlify prend en charge les extensions de fichiers statiques suivantes.

Formats d’image

  • .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 document

  • .pdf
  • .txt
  • .doc, .docx
  • .xls, .xlsx
  • .ppt, .pptx
  • .rtf
  • .odt, .ods, .odp

Formats de données

  • .csv
  • .tsv
  • .xml

Organisation des fichiers

Organisez vos fichiers en utilisant des dossiers pour que votre référentiel reste facile à parcourir :
/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, si bien que la structure de votre référentiel correspond 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.
I