Enlaces

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:

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

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

Se renderiza como: Introducción

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:

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

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

Se renderiza como: GitHub

Enlaces de ancla

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

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

[See Internal Links](#internal-links)

Se renderiza como: Ver Enlaces internos

Un encabezado de otra página es su URL más el id: ID de encabezado personalizados. Consulta Encabezados 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.

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

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:

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

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