Adjuntos de documentación

Adjunta imágenes y archivos directamente a cualquier página de documentación. Suelta una captura de pantalla en el editor y se inserta en el texto; adjunta un PDF, una especificación o un archivo comprimido y aparece como una tarjeta descargable. Los archivos se guardan en un almacenamiento de objetos, sin inflar nunca tu base de datos, y acompañan a la página allá donde se consulte o se comparta.

Añadir adjuntos

Abre una página de documentación en el editor (Nuevo documento o Editar) y añade archivos de la forma que te resulte más rápida:

  • Arrastra y suelta uno o varios archivos sobre el editor
  • Pega una imagen directamente desde el portapapeles (p. ej., una captura de pantalla)
  • Haz clic en Adjuntar archivo en la barra de herramientas del editor y elige los archivos

Puedes adjuntar varios archivos a la vez. Un documento nuevo se guarda automáticamente la primera vez que adjuntas un archivo, así que nunca pierdes una subida.

Imágenes frente a archivos

Archyl trata los dos casos como cabría esperar:

  • Las imágenes se insertan en el texto de tu Markdown en el punto donde las añades, de modo que se muestran directamente en la página.
  • Los demás archivos (PDFs, documentos, archivos comprimidos…) se añaden al panel Adjuntos como tarjetas descargables en lugar de insertarse en el texto.

Ver los adjuntos

Al leer una página, los adjuntos aparecen en un panel Adjuntos en la parte superior del documento, justo debajo del título, para que los lectores vean lo que hay disponible antes de desplazarse. Cada archivo muestra:

  • Un icono de tipo con código de color, o una miniatura de la imagen
  • El nombre, el tipo y el tamaño del archivo
  • Una acción de descarga con un solo clic

Las imágenes también se muestran en el texto allí donde las colocaste en el contenido.

Gestionar los adjuntos

Desde el editor, el panel Adjuntos te permite:

  • Descargar cualquier archivo
  • Eliminar un archivo (con una confirmación rápida en línea); esto también lo borra del almacenamiento

Al eliminar un documento también se eliminan sus adjuntos.

Archivos soportados

Puedes adjuntar cualquier tipo de archivo. Las imágenes se insertan en el texto; todo lo demás aparece como una tarjeta descargable. Ejemplos habituales:

  • Imágenes — PNG, JPEG, GIF, WebP, SVG, AVIF
  • Documentos — PDF, Word, Excel, PowerPoint, texto plano, Markdown, CSV
  • Datos y archivos comprimidos — JSON, YAML, ZIP, logs

El tamaño máximo predeterminado es de 10 MB por archivo (configurable en las instancias autoalojadas).

Consejo: Si tu navegador no reconoce un tipo de archivo, igualmente se acepta y se ofrece como descarga.

Almacenamiento y privacidad

Los adjuntos se guardan en un almacenamiento de objetos y no en la base de datos de la aplicación. En Archyl Cloud, ese almacenamiento es Google Cloud Storage, totalmente gestionado y sin nada que configurar. En las instancias autoalojadas, eliges tu propio proveedor compatible con S3 (ver más abajo).

En ambos casos:

  • El bucket es privado. Los archivos se sirven mediante enlaces firmados de corta duración que se generan bajo demanda; los objetos subyacentes nunca se pueden listar públicamente.
  • Los enlaces insertados en una página se mantienen estables, así que la documentación compartida y pública sigue funcionando sin exponer el bucket.
  • El cifrado en reposo está activado por defecto. Google Cloud Storage cifra cada objeto automáticamente; en las instancias autoalojadas también puedes aportar tus propias claves (por ejemplo, una CMEK de Cloud KMS en GCS).

Para instancias autoalojadas

En Archyl Cloud, los adjuntos funcionan desde el primer momento. Si alojas Archyl tú mismo, aportas tu propio almacenamiento de objetos y puedes apuntar Archyl a cualquier proveedor compatible con S3 (Google Cloud Storage, Amazon S3, MinIO, Cloudflare R2…).

Hasta que el almacenamiento esté configurado, la acción Adjuntar archivo no está disponible y las subidas devuelven un mensaje claro: "File storage is not configured". Define las variables de entorno STORAGE_* en el backend (endpoint, bucket, clave de acceso, clave secreta) para activar la función; para Google Cloud Storage, usa el endpoint de interoperabilidad (HMAC). Consulta la configuración de tu despliegue para ver la lista completa de opciones.

Próximos pasos