mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
c8e979f6cf
* docs: add help center article for static file 404 troubleshooting * docs: translate static-file-not-served help center article to es, fr, zh --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
42 lines
3.6 KiB
Plaintext
42 lines
3.6 KiB
Plaintext
---
|
|
title: "Corregir un archivo estático que devuelve 404 en tu sitio de documentación"
|
|
description: "Diagnostica por qué un archivo que agregaste a tu repositorio de documentación (como un JSON, PDF o imagen) no se carga en su URL esperada en tu sitio de Mintlify."
|
|
keywords: ["static file not served", "404 asset", "JSON not found", "mintignore", "static assets", "file serving"]
|
|
---
|
|
|
|
Mintlify sirve archivos estáticos desde tu repositorio de documentación en la ruta que coincide con su ubicación en el repositorio. Si un archivo como `data/prices.json` devuelve `404` cuando solicitas `https://docs.example.com/data/prices.json`, revisa las causas siguientes. Para una visión general de cómo funciona el servicio de archivos estáticos y la lista de tipos de archivo compatibles, consulta [Archivos](/es/create/files).
|
|
|
|
## Confirma que la URL coincide con la ruta del repositorio
|
|
|
|
La ruta de la URL refleja la ubicación del archivo en tu repositorio. Un archivo confirmado en la raíz del repositorio como `prices.json` se sirve en `https://docs.example.com/prices.json`. Un archivo en `data/prices.json` se sirve en `https://docs.example.com/data/prices.json`.
|
|
|
|
Errores comunes:
|
|
|
|
- Diferencia de mayúsculas. `Prices.json` y `prices.json` son URLs distintas.
|
|
- El archivo solo está en una rama de funcionalidad. Solo se sirven los archivos confirmados en la rama que Mintlify construye.
|
|
- Un error tipográfico en la extensión. Mintlify sirve el archivo con el nombre exacto que tiene en el repositorio.
|
|
|
|
Confirma que el archivo existe en la rama desplegada abriéndolo directamente en la interfaz web de tu proveedor de Git.
|
|
|
|
## Comprueba que el tipo de archivo es compatible
|
|
|
|
Mintlify solo sirve los tipos de archivo listados en [Tipos de archivo compatibles](/es/create/files#supported-file-types). Algunos tipos, como `.pdf`, `.txt`, `.xml`, `.csv` y `.zip`, solo se sirven en planes Enterprise. Un archivo con una extensión no compatible devuelve `404` aunque exista en el repositorio.
|
|
|
|
## Comprueba el tamaño del archivo
|
|
|
|
Los archivos deben ser menores de 20 MB. Los archivos más grandes no se sirven y deben alojarse en una CDN externa o en un almacén de objetos.
|
|
|
|
## Descarta la autenticación
|
|
|
|
El servicio de archivos estáticos no está disponible para sitios de documentación con [autenticación](/es/deploy/authentication-setup) habilitada. Las URLs directas a archivos devuelven `404` en sitios autenticados incluso cuando el archivo existe y el usuario ha iniciado sesión. Aloja el archivo en un servicio externo si tu sitio requiere autenticación.
|
|
|
|
## Descarta `.mintignore` y otras exclusiones
|
|
|
|
Comprueba si el archivo coincide con un patrón en `.mintignore`. Mintlify no publica archivos que coincidan con patrones de `.mintignore`, por lo que no estarán disponibles en su URL. Consulta [Excluir archivos de la publicación](/es/organize/mintignore).
|
|
|
|
Mintlify también ignora automáticamente directorios como `node_modules`, `build`, `dist` y `.git`. Un archivo dentro de uno de esos directorios no se sirve. Mueve el archivo a un directorio que no se ignore automáticamente, como `assets/` o `data/`. Consulta la lista completa de directorios ignorados por defecto en [Patrones ignorados por defecto](/es/organize/mintignore#default-ignored-patterns).
|
|
|
|
## Redespliega después de agregar el archivo
|
|
|
|
Mintlify construye tu documentación cuando envías cambios a tu rama de despliegue. Un archivo recién añadido solo está disponible después de la siguiente build exitosa. Abre el historial de despliegues de tu panel y confirma que el commit que agregó el archivo se construyó correctamente antes de volver a probar la URL.
|