Passer au contenu principal
Mintlify diffuse automatiquement les ressources statiques depuis votre référentiel de documentation à l’emplacement approprié sur votre domain. Par exemple, si vous avez /images/my-logo.png dans votre référentiel, le fichier image est accessible à 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, y compris 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’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 documents

  • .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 à 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.
I