Las advertencias (o "llamadas de atención") son una opción que los redactores pueden utilizar para incluir contenidos secundarios en un artículo sin interrumpir el flujo del documento.
Ejemplo de Advertencia
Este es un ejemplo de una advertencia. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor massa, nec semper lorem quam in massa.
Ejemplo de Advertencia Plegable
Este es un ejemplo de advertencia plegable. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor massa, nec semper lorem quam in massa.
Formato¶
Para añadir una advertencia a una página, puedes utilizar el siguiente código:
<div class="admonition TYPE" markdown>
<p class="admonition-title">TÍTULO</p>
TEXTO INCLUIDO
</div>
<details class="TYPE" markdown>
<summary>TÍTULO</summary>
TEXTO INCLUIDO
</details>
Debe especificarse el TÍTULO, si no deseas un título específico puedes establecerlo con el mismo texto que el TIPO (véase más abajo) en el caso del título, por ejemplo, Nota. El "TEXTO INCLUIDO" debe tener formato Markdown.
Tipos habituales¶
Reemplaza TYPE en los ejemplos anteriores con uno de los siguientes:
note¶
Nota
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
abstract¶
Resumen
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
info¶
Detalles
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
tip¶
Consejo
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
success¶
Éxito
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
question¶
Pregunta
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
warning¶
Advertencia
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
failure¶
Fallo
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
danger¶
Peligro
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
bug¶
Bug
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
example¶
Ejemplo
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
quote¶
Cita
Lorem ipsum dolor sit amet, consectetur adipiscing elit.
Tipos Especiales¶
recommendation¶
Este formato se utiliza para generar tarjetas de recomendación. En particular, falta el elemento <p class="admonition-title">.
<div class="admonition recommendation" markdown>
{ align=right }
**PhotoPrism** es una plataforma autoalojable para la gestión de fotos. Admite la sincronización y compartición de álbumes, así como una variedad de otras [características](https://www.photoprism.app/features). No incluye E2EE, por lo que es mejor alojarlo en un servidor en el que confíes y que esté bajo tu control.
[:octicons-home-16: Página Principal](https://photoprism.app){ .md-button .md-button--primary }
[:octicons-eye-16:](https://photoprism.app/privacy){ .card-link title="Política de Privacidad" }
[:octicons-info-16:](https://photoprism.app/kb){ .card-link title=Documentación}
[:octicons-code-16:](https://github.com/photoprism){ .card-link title="Código Fuente" }
<details class="downloads" markdown>
<summary>Downloads "Descargas</summary>
- [:simple-github: GitHub](https://github.com/photoprism)
</details>
</div>
downloads¶
Se trata de un tipo especial de advertencia plegable, utilizada para generar la sección de enlaces de descarga. Solo se utiliza dentro de las tarjetas de recomendación, como se muestra en el ejemplo anterior.
<details class="downloads" markdown>
<summary>Downloads</summary>
- [:simple-googleplay: Google Play](https://play.google.com/store/apps/details?id=ch.protonmail.android)
- [:simple-appstore: App Store](https://apps.apple.com/app/id979659905)
- [:simple-github: GitHub](https://github.com/ProtonMail/proton-mail-android/releases)
- [:fontawesome-brands-windows: Windows](https://proton.me/mail/bridge#download)
- [:simple-apple: macOS](https://proton.me/mail/bridge#download)
- [:simple-linux: Linux](https://proton.me/mail/bridge#download)
- [:octicons-browser-16: Web](https://mail.proton.me)
</details>
Old Format¶
Throughout the site, you may see some admonitions formatted similarly to these examples:
!!! nota
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod
nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor
massa, nec semper lorem quam in massa.
Nota
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor massa, nec semper lorem quam in massa.
??? ejemplo "Título Personalizado"
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod
nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor
massa, nec semper lorem quam in massa.
Título Personalizado
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla et euismod nulla. Curabitur feugiat, tortor non consequat finibus, justo purus auctor massa, nec semper lorem quam in massa.
Este formato ya no se utiliza en adelante, porque es incompatible con las nuevas versiones de nuestro software de traducción en Crowdin. Al añadir una nueva página al sitio, solo debe utilizarse el nuevo formato basado en HTML.
No hay prisa por convertir las advertencias con el formato antiguo al nuevo. Las páginas que actualmente utilizan este formato deberían seguir funcionando, pero las iremos actualizando para que utilicen el nuevo formato basado en HTML a medida que sigamos actualizando el sitio.