diff --git a/docs.json b/docs.json index 72301f897..f7fff9fba 100644 --- a/docs.json +++ b/docs.json @@ -335,6 +335,7 @@ "pages": [ "fr/text", "fr/image-embeds", + "fr/components/files", "fr/list-table", "fr/code", "fr/reusable-snippets", @@ -601,6 +602,7 @@ "pages": [ "es/text", "es/image-embeds", + "es/components/files", "es/list-table", "es/code", "es/reusable-snippets", @@ -867,6 +869,7 @@ "pages": [ "zh/text", "zh/image-embeds", + "zh/components/files", "zh/list-table", "zh/code", "zh/reusable-snippets", diff --git a/es/components/files.mdx b/es/components/files.mdx new file mode 100644 index 000000000..2b04e878c --- /dev/null +++ b/es/components/files.mdx @@ -0,0 +1,31 @@ +--- +title: "Archivos" +description: "Servir recursos estáticos desde tu documentación" +icon: "folder" +--- + +Mintlify sirve automáticamente recursos estáticos desde el repositorio de tu documentación en la ruta correspondiente de tu dominio. Por ejemplo, si tienes `/images/my-logo.png` en tu repositorio, el archivo de imagen estará disponible en `https://docs.your-project.com/images/my-logo.png`. + +Esto funciona para cualquier tipo de archivo que quieras poner a disposición de tus usuarios, incluidos imágenes, PDF, videos o esquemas. + +Los archivos deben pesar menos de 20 MB para imágenes y 100 MB para otros tipos de archivo. + +
+ ## Organización de archivos +
+ +Organiza tus archivos en carpetas para que tu repositorio sea fácil de navegar: + +```text +/tu-proyecto + |- docs.json + |- images/ + |- logo.png + |- screenshots/ + |- dashboard.png + |- assets/ + |- whitepaper.pdf + |- demo-video.mp4 +``` + +Los archivos se sirven desde la raíz de tu dominio, por lo que la estructura de tu repositorio se refleja directamente en la estructura de las URL. En el ejemplo anterior, `assets/whitepaper.pdf` estaría disponible en `https://docs.your-project.com/assets/whitepaper.pdf`. diff --git a/fr/components/files.mdx b/fr/components/files.mdx new file mode 100644 index 000000000..a99e57b2c --- /dev/null +++ b/fr/components/files.mdx @@ -0,0 +1,31 @@ +--- +title: "Fichiers" +description: "Servir des ressources statiques depuis votre documentation" +icon: "folder" +--- + +Mintlify sert automatiquement les ressources statiques de votre dépôt de documentation au chemin approprié sur votre domaine. Par exemple, si vous avez `/images/my-logo.png` dans votre dépôt, 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, PDF, vidéos ou schémas. + +La taille des fichiers est limitée à 20 Mo pour les images et à 100 Mo pour les autres types de fichiers. + +
+ ## Organisation des fichiers +
+ +Organisez vos fichiers avec des dossiers pour que votre dépôt reste facile à parcourir : + +```text +/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 domaine, si bien que la structure de votre dépôt 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`. diff --git a/zh/components/files.mdx b/zh/components/files.mdx new file mode 100644 index 000000000..98cc0a5d4 --- /dev/null +++ b/zh/components/files.mdx @@ -0,0 +1,31 @@ +--- +title: "文件" +description: "从文档中提供静态资源" +icon: "folder" +--- + +Mintlify 会自动从你的文档仓库在你的域名的相应路径下提供静态资源。例如,如果你的仓库中有 `/images/my-logo.png`,则可通过 `https://docs.your-project.com/images/my-logo.png` 访问该图片文件。 + +这适用于你希望向用户提供的任何文件类型,包括图片、PDF、视频或模式(schema)。 + +图片文件必须小于 20 MB,其他文件类型必须小于 100 MB。 + +
+ ## 文件组织 +
+ +使用文件夹来组织文件,便于浏览你的代码仓库: + +```text +/your-project + |- docs.json + |- images/ + |- logo.png + |- screenshots/ + |- dashboard.png + |- assets/ + |- whitepaper.pdf + |- demo-video.mp4 +``` + +文件从你的域名根目录提供,因此你仓库中的结构会直接映射到 URL 结构。延续前面的示例,`assets/whitepaper.pdf` 可通过 `https://docs.your-project.com/assets/whitepaper.pdf` 访问。