Activos

A veces es posible que desee vincular activos (por ejemplo, archivos docx, imágenes, etc.) directamente desde los temas. docStatic gestiona esto a través de la carpeta static/.

Cualquier contenido colocado en la carpeta estará disponible desde la raíz del sitio publicado. Por ejemplo:

# Su documento
/website/docs/myFeature.mdx

# Algunos activos que desea utilizar
/website/assets/docstatic-asset-example.docx
/website/img/docstastic-asset-example-banner.png

Imágenes

DocStatic ofrece dos formas de añadir imágenes a los temas. Para las imágenes en línea, puede hacer clic en el icono Imagen para colocar una imagen en un tema. Esto funciona mejor con iconos () e imágenes pequeñas. Los iconos deben almacenarse como archivos SVG preescalados. Estos se invertirán y su espacio de color girará 180° en el modo oscuro.

Consejo

Puede utilizar Librsvg para escalar SVG. Por ejemplo, rsvg-convert example.svg -h 12 -f svg -o example.svg establece una altura de 12 puntos.

Para imágenes más grandes, utiliza en su lugar el componente Figura. Añade una leyenda —que también se usa como texto alternativo para lectores de pantalla—, se ajusta a la página y se abre a tamaño completo en un lightbox al hacer clic.

Ejemplo

Figura de ejemplo

Para obtener más información sobre el Administrador de medios, consulte Descripción general de los medios en la documentación de TinaCMS.

Archivos

Del mismo modo, puede enlazar a activos existentes utilizando la ruta de la carpeta static/ en la URL. Por ejemplo:

./assets/docstatic-asset-example.docx

Para obtener más información, consulte Activos estáticos en la documentación de Docusaurus.