Imágenes, vídeo, audio y descargas¶
Mantenga los recursos cerca del documento que los explica. Use rutas relativas o empiece por / para referirse a la raíz de fuentes. Guidedog copia los recursos usados. El vídeo sigue siendo vídeo en la web; el PDF identifica la grabación.
Imágenes¶
.. image:: diagrams/pipeline.png
:alt: The build pipeline
:width: 480px
.. figure:: /screenshots/search.png
Searching the site.
Las páginas copian las imágenes en _images; el libro las incrusta. PNG, JPEG, GIF, SVG y WebP funcionan en ambos. Una imagen ausente genera una advertencia: la página conserva el texto alternativo y el libro omite la imagen.
Vídeo y audio¶
Una imagen o figura que apunta a vídeo (.mp4, .webm, .ogv, .mov, .m4v) o audio (.mp3, .ogg, .oga, .m4a, .opus, .wav, .flac, .aac) lo reproduce, como hace Docutils con el vídeo:
.. figure:: media/tour.mp4
:alt: A tour of the site
:width: 640
The two-minute tour.
.. image:: media/pronunciation.mp3
Las páginas muestran el reproductor del navegador y un enlace al archivo por si no puede reproducirse. Un libro no reproduce multimedia, por lo que identifica la grabación en un recuadro. La salida de texto escribe [video: ...] o [audio: ...].
Descargas¶
El rol download enlaza cualquier archivo y lo copia en _downloads:
Get :download:`the example project <examples/project.zip>`.
Archivos del tema¶
_static contiene hojas de estilo, scripts, fuentes y logotipos del tema, que se copian sin cambios a _static del sitio. html_static_path indica la carpeta; html_css_files, html_js_files, html_logo y html_favicon nombran sus archivos. El contenido multimedia debe ir junto a los documentos para conservar los enlaces al moverlos.