# Enlaces

> Enlaces internos, externos y de ancla, URL de las páginas y la ruta base.

Cada página se sirve en la URL de su propia carpeta: `guides/build.html` en `/guides/build/`, e `index.html` en su carpeta, `guides/index.html` en `/guides/`. Cada nombre de carpeta y de archivo se convierte en slug, como en Livemark: `User Guide/Getting Started.html` se sirve en `/user-guide/getting-started/`. Enlaza a una página por su URL o por su archivo: un enlace que nombra el archivo de una página, relativo o relativo a la raíz, se reescribe a la URL de la página, y cualquier otra URL relativa se resuelve desde el archivo fuente.

## Enlaces internos

Enlaza a otras páginas de tu documentación, de forma relativa a la raíz o relativa a la página:

**HTML**

```html
<a href="/introduction/">Introduction</a>
<a href="headings.html">Headings</a>
```

**Markdown**

```md
[Introduction](/introduction/)
[Headings](headings.html)
```

Se renderiza como: [Introducción](/es/introduction/)

Con `base` definido en `htmlpress.yaml`, cada URL relativa a la raíz de la compilación (en `href`, `src`, `srcset`, `poster` y `action`, tanto en las páginas como en el layout y en el HTML de la configuración) lo recibe como prefijo: escribe `/guide/` y el sitio enlaza a `/repo/guide/`. Las URL relativas y absolutas no se tocan, ni tampoco los `url()` del CSS propio de una página. `start` y `preview` también sirven el sitio bajo la base, y redirigen `/` allí.

La navegación agrupa las páginas de una carpeta bajo su `index.html`, con el título de esa página como nombre. El nombre de un grupo enlaza a esa página índice, y el chevrón que hay a su lado pliega el grupo. Una carpeta sin `index.html` no forma grupo: sus páginas quedan arriba, junto a las de la raíz.

## Enlaces externos

Enlaza a recursos externos:

**HTML**

```html
<a href="https://github.com">GitHub</a>
```

**Markdown**

```md
[GitHub](https://github.com)
```

Se renderiza como: [GitHub](https://github.com)

## Enlaces de ancla

Enlaza a un encabezado concreto de la página actual por su id:

**HTML**

```html
<a href="#internal-links">See Internal Links</a>
```

**Markdown**

```md
[See Internal Links](#internal-links)
```

Se renderiza como: [Ver Enlaces internos](#enlaces-internos)

Un encabezado de otra página es su URL más el id: [ID de encabezado personalizados](/es/authoring/headings/#custom-ids). Consulta [Encabezados](/es/authoring/headings/) para ver cómo se generan los id.

## Enlaces automáticos

Una URL suelta en la prosa se convierte en un enlace al compilar, como en el Markdown de GitHub: las URL `http://` y `https://`, las direcciones `www.` y los correos electrónicos. La puntuación final queda fuera del enlace.

**HTML**

```html
<p>See https://htmlpress.dev, or mail team@example.com.</p>
```

**Markdown**

```md
See https://htmlpress.dev, or mail team@example.com.
```

Se renderiza como: Visita <https://htmlpress.dev>, o escribe a <team@example.com>.

El texto de los enlaces, el código, los bloques de código y los terminales se queda tal como está escrito, igual que cualquier elemento con `data-literal`, para la prosa que debe mostrar una URL sin convertir:

**HTML**

```html
<p data-literal>Type https://htmlpress.dev in the address bar.</p>
```

**Markdown**

```html
<p data-literal>Type https://htmlpress.dev in the address bar.</p>
```
