From e8381d05cc29beeed114cf26dc55db92fd9ee169 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar?= Date: Thu, 7 Nov 2024 14:33:06 +0100 Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20feat(shortcodes):=20support=20body?= =?UTF-8?q?=20admonitions=20(#423)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/blog/shortcodes/index.ca.md | 20 ++++++++++++++++++-- content/blog/shortcodes/index.es.md | 20 ++++++++++++++++++-- content/blog/shortcodes/index.md | 20 ++++++++++++++++++-- templates/shortcodes/admonition.html | 1 + 4 files changed, 55 insertions(+), 6 deletions(-) diff --git a/content/blog/shortcodes/index.ca.md b/content/blog/shortcodes/index.ca.md index 64aa415..4677767 100644 --- a/content/blog/shortcodes/index.ca.md +++ b/content/blog/shortcodes/index.ca.md @@ -1,7 +1,7 @@ +++ title = "Shortcodes personalitzats" date = 2023-02-19 -updated = 2024-10-18 +updated = 2024-11-07 description = "Aquest tema inclou alguns shortcodes personalitzats útils que pots utilitzar per millorar les teves publicacions. Ja sigui per mostrar imatges que s'adapten als temes clar i fosc, o per donar format a una secció de referències amb un aspecte professional, aquests shortcodes personalitzats t'ajudaran." [taxonomies] @@ -275,10 +275,26 @@ Pots canviar el `title` i la `icon` de l'advertència. Ambdós paràmetres accep #### Ús -``` +Pots utilitzar les advertències de dues maneres: + +1. En línia amb paràmetres: + +```md {{/* admonition(type="danger", icon="tip", title="Un consell important", text="Mantingues-te hidratat") */}} ``` +2. Amb contingut al cos: + +```md +{%/* admonition(type="danger", icon="tip", title="Un consell important") */%} +Mantingues-te hidratat + +Aquest mètode és especialment útil per a contingut llarg o múltiples paràgrafs. +{%/* end */%} +``` + +Ambdós mètodes admeten els mateixos paràmetres (`type`, `icon`, i `title`). + ### Cites multillenguatge Aquest shortcode permet mostrar una cita traduïda i en el llenguatge original: diff --git a/content/blog/shortcodes/index.es.md b/content/blog/shortcodes/index.es.md index 7abd4ca..571ca5d 100644 --- a/content/blog/shortcodes/index.es.md +++ b/content/blog/shortcodes/index.es.md @@ -1,7 +1,7 @@ +++ title = "Shortcodes personalizados" date = 2023-02-19 -updated = 2024-10-18 +updated = 2024-11-07 description = "Este tema incluye algunos shortcodes personalizados útiles que puedes utilizar para mejorar tus publicaciones. Puedes mostrar imágenes que se adapten a los temas claro y oscuro, dar formato a una sección de referencias con un aspecto profesional, y más." [taxonomies] @@ -274,10 +274,26 @@ Puedes cambiar el `title` y el `icon` de la advertencia. Ambos parámetros acept #### Uso -``` +Puedes usar las advertencias de dos formas: + +1. En línea con parámetros: + +```md {{/* admonition(type="danger", icon="tip", title="Un consejo importante", text="Mantente hidratado") */}} ``` +2. Con contenido en el cuerpo: + +```md +{%/* admonition(type="danger", icon="tip", title="Un consejo importante") */%} +Mantente hidratado + +Este método es especialmente útil para contenido largo o múltiples párrafos. +{%/* end */%} +``` + +Ambos métodos admiten los mismos parámetros (`type`, `icon`, y `title`). + ### Citas multilenguaje Este shortcode permite mostrar una cita traducida y en su lenguaje original: diff --git a/content/blog/shortcodes/index.md b/content/blog/shortcodes/index.md index b8608b4..c78a781 100644 --- a/content/blog/shortcodes/index.md +++ b/content/blog/shortcodes/index.md @@ -1,7 +1,7 @@ +++ title = "Custom shortcodes" date = 2023-02-19 -updated = 2024-10-18 +updated = 2024-11-07 description = "This theme includes some useful custom shortcodes that you can use to enhance your posts. Whether you want to display images that adapt to light and dark themes, or format a professional-looking reference section, these custom shortcodes have got you covered." [taxonomies] @@ -275,10 +275,26 @@ You can change the `title` and `icon` of the admonition. Both parameters take a #### Usage -``` +You can use admonitions in two ways: + +1. Inline with parameters: + +```md {{/* admonition(type="danger", icon="tip", title="An important tip", text="Stay hydrated~") */}} ``` +2. With a content body: + +```md +{%/* admonition(type="danger", icon="tip", title="An important tip") */%} +Stay hydrated~ + +This method is particularly useful for longer content or multiple paragraphs. +{%/* end */%} +``` + +Both methods support the same parameters (`type`, `icon`, and `title`), with the content either passed as the `text` parameter or as the body between tags. + ### Multilingual quotes This shortcode allows you to display both the translated and original text for a quote. The quotation marks will be added automatically: diff --git a/templates/shortcodes/admonition.html b/templates/shortcodes/admonition.html index ce6758e..3519527 100644 --- a/templates/shortcodes/admonition.html +++ b/templates/shortcodes/admonition.html @@ -1,6 +1,7 @@ {%- set type = type | default(value="info") -%} {%- set title = title | default(value=type | upper) -%} {%- set icon = icon | default(value=type) -%} +{%- set text = text | default(value=body) -%}