文件

从文档中提供静态资产。

Mintlify 会自动从你的文档存储库中，在你的 domain 上的相应路径提供静态资产。例如，如果你的仓库中有 /images/my-logo.png，该图片文件可通过 https://docs.your-project.com/images/my-logo.png 访问。

你可以向用户提供任何受支持的文件类型，包括 OpenAPI 规范、图片、视频等。

图片大小必须小于 20 MB，其他文件类型必须小于 100 MB。

对于启用了认证的文档站点，不支持文件服务。如果你的站点需要认证，静态文件将无法通过其直接 URL 访问。

​

支持的文件类型

所有方案支持的文件类型：

• 图片：.png、.jpg、.jpeg、.gif、.webp、.svg、.ico
• 视频：.mp4、.webm
• 音频：.mp3、.wav
• 数据：.json、.yaml
• 样式表：.css
• 脚本：.js
• 字体：.woff、.woff2、.ttf、.eot

Custom 方案支持的文件类型：

• 文档：.pdf、.txt
• 数据：.xml、.csv
• 压缩包：.zip

​

文件结构

使用文件夹来组织文件，使你的存储库更易于浏览：

/your-project
  |- docs.json
  |- images/
    |- logo.png
    |- screenshots/
      |- dashboard.png
  |- assets/
    |- whitepaper.pdf
    |- demo-video.mp4

文件从你的 domain 根目录提供，因此存储库中的结构会直接映射到 URL 结构。依据前面的示例，assets/whitepaper.pdf 可通过 https://docs.your-project.com/assets/whitepaper.pdf 访问。