# Multimedia

> Imágenes, imágenes con zoom y contenido incrustado de YouTube y SoundCloud.

Las imágenes son elementos `<img>` simples, escalados al ancho del contenido. Envuelve una en `<figure>` con un `<figcaption>` para añadirle un pie.

## Imágenes internas

Referencia imágenes de tu proyecto; cada archivo que no es una página se copia a la salida en la misma ruta:

**HTML**

```html
<img src="/screenshots/docs.webp" alt="An htmlpress docs page">
```

**Markdown**

```md
![An htmlpress docs page](/screenshots/docs.webp)
```

Un `src`, `srcset` o `poster` relativo se resuelve desde el archivo fuente de la página, así que sigue funcionando en la URL de carpeta de la página, bajo un prefijo de idioma o en otra `<meta name="path">`.

Se renderiza como:

![Una página de documentación de htmlpress con la navegación, un bloque de código y la tabla de contenidos](/screenshots/docs.webp)

Una página de documentación de htmlpress.

## Imágenes externas

Referencia imágenes desde URL externas:

**HTML**

```html
<img src="https://picsum.photos/seed/htmlpress/800/300" alt="Placeholder">
```

**Markdown**

```md
![Placeholder](https://picsum.photos/seed/htmlpress/800/300)
```

Se renderiza como:

![Imagen de ejemplo](https://picsum.photos/seed/htmlpress/800/300)

## Imágenes en Base64

Incrusta imágenes pequeñas directamente con URI de datos:

**HTML**

```html
<img src="data:image/png;base64,iVBORw0KGgo…" alt="banner">
```

**Markdown**

```md
![banner](data:image/png;base64,iVBORw0KGgo…)
```

Se renderiza como:

![banner](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAMgAAABQCAIAAADTD63nAAABU0lEQVR4nO3csU3DUBRAUUCIGVJlHLcwAVV2YIbsQJUJUmccJCRmoKKgthOR3IDNOe138WxdveZLvn0c3m/g0u5+ewCWSVgkhEVCWCSERUJYJIRFQlgkhEXifvr47eP1OnMwR+vVZuzIxiJxZGN9e3p+qedgXva77fQDNhYJYZEQFglhkRAWCWGREBYJYZEQFglhkRAWCWGROOkSeswwPFxqjr/jcPgcO1rk+06b+BrTbCwSwiIhLBLCIiEsEsIiISwSwiIhLBLCIiEsEsIiISwSwiIhLBLCIiEsEsIiISwSwiIhLBLCIiEsEsIiISwSwiIhLBLCIiEsEsIicdZvjH78j5uZ+m/vew4bi4SwSAiLhLBICIuEsEgIi4SwSAiLhLBICIuEsEicdAm9323rOVgYG4vEkY21Xm2uMwcLY2OREBYJYZEQFglhkRAWCWGREBaJL1tnFXf+b+eSAAAAAElFTkSuQmCC)

## Imágenes según el tema

`data-theme="light"` o `data-theme="dark"` en un `<img>` lo muestra solo en ese tema, siguiendo tanto el selector de tema de la cabecera como la configuración del sistema; las terminaciones `#light` y `#dark` de Livemark en el `src` también funcionan. Pon la pareja una junto a otra:

**HTML**

```html
<img src="/screenshots/docs.webp" alt="The docs" data-theme="light">
<img src="/screenshots/docs-dark.webp" alt="The docs" data-theme="dark">
```

**Markdown**

```md
![The docs](/screenshots/docs.webp#light)
![The docs](/screenshots/docs-dark.webp#dark)
```

Se renderiza como (cambia el tema para alternar):

![El sitio de documentación en modo claro](/screenshots/docs.webp)

La copia en Markdown de la página conserva solo la imagen clara.

## Zoom de imágenes

Toda imagen de una página se abre a pantalla completa al hacer clic, salvo si la envuelve un enlace; un clic en cualquier sitio la cierra. Funciona igual con imágenes internas, externas y en base64.

**HTML**

```html
<img src="screenshot.png" alt="The docs site">
```

**Markdown**

```md
![The docs site](screenshot.png)
```

Se renderiza como (haz clic):

![La página de componentes de htmlpress con avisos en cuatro colores](/screenshots/components.webp)

## Bloques de vídeo

`<htmlpress-video type="youtube" url>` reproduce el vídeo de su `url` (una URL `watch`, `youtu.be`, `embed`, `shorts` o `live`); sin el script sigue siendo un enlace:

**HTML**

```html
<htmlpress-video type="youtube" url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"></htmlpress-video>
```

**Markdown**

```md
::video{type="youtube" url="https://www.youtube.com/watch?v=dQw4w9WgXcQ"}
```

Se renderiza como:

<https://www.youtube.com/watch?v=dQw4w9WgXcQ>

## Bloques de audio

`<htmlpress-audio type="soundcloud" url>` reproduce la pista de su `url`; sin el script sigue siendo un enlace:

**HTML**

```html
<htmlpress-audio type="soundcloud" url="https://soundcloud.com/flume/never-be-like-you-feat-kai"></htmlpress-audio>
```

**Markdown**

```md
::audio{type="soundcloud" url="https://soundcloud.com/flume/never-be-like-you-feat-kai"}
```

Se renderiza como:

<https://soundcloud.com/flume/never-be-like-you-feat-kai>
