diff --git a/content/blog/mastering-tabi-settings/index.ca.md b/content/blog/mastering-tabi-settings/index.ca.md index 7035554..6f94d6b 100644 --- a/content/blog/mastering-tabi-settings/index.ca.md +++ b/content/blog/mastering-tabi-settings/index.ca.md @@ -1,7 +1,7 @@ +++ title = "Domina la configuració de tabi: guia completa" date = 2023-09-18 -updated = 2024-11-13 +updated = 2024-11-14 description = "Descobreix les múltiples maneres en què pots personalitzar tabi." [taxonomies] @@ -167,7 +167,9 @@ Per fixar una entrada, afegeix el següent al seu front matter: pinned = true ``` -{{ admonition(type="note", text="Aquesta configuració només afecta les pàgines que utilitzen la plantilla predeterminada `section.html`. En aquesta demo, això inclou la pàgina principal i `blog/`. Altres seccions —pàgines d'etiquetes, `archive/` o sèries— ignoren aquesta configuració.") }} +{{ admonition(type="info", text="Aquesta configuració només afecta les pàgines principals del lloc (com `/`, `/es/`, `/fr/`). Altres seccions com `blog/`, `tags/` o `archive/` mostren les publicacions en el seu ordre habitual.") }} + +{{ admonition(type="warning", text='Quan s'utilitza la paginació (`paginate_by`), les entrades fixades poden aparèixer dues vegades: una vegada a la part superior de la primera pàgina, i una altra en la seva posició cronològica normal en pàgines posteriors.') }} ##### Mostrar la data dels articles al llistat diff --git a/content/blog/mastering-tabi-settings/index.es.md b/content/blog/mastering-tabi-settings/index.es.md index d2917b3..6faa913 100644 --- a/content/blog/mastering-tabi-settings/index.es.md +++ b/content/blog/mastering-tabi-settings/index.es.md @@ -1,7 +1,7 @@ +++ title = "Domina la configuración de tabi: guía completa" date = 2023-09-18 -updated = 2024-11-13 +updated = 2024-11-14 description = "Descubre las múltiples maneras en que puedes personalizar tabi." [taxonomies] @@ -167,7 +167,9 @@ Para fijar una publicación, añade lo siguiente a su front matter: pinned = true ``` -{{ admonition(type="note", text='Este ajuste solo afecta a las páginas que usan la plantilla predeterminada `section.html`. En esta demo, esto incluye la página principal y `blog/`. Otras secciones —páginas de etiquetas, `archive/` o series— ignoran este ajuste.') }} +{{ admonition(type="info", text="Este ajuste solo afecta a las páginas principales del sitio (como `/`, `/es/`, `/fr/`). Otras secciones como `blog/`, `tags/` o `archive/` muestran las publicaciones en su orden habitual.") }} + +{{ admonition(type="warning", text='Cuando se utiliza la paginación (`paginate_by`), las publicaciones destacadas pueden aparecer dos veces: una vez en la parte superior de la primera página, y otra en su posición cronológica normal en páginas posteriores.') }} ##### Mostrar la fecha de los artículos en el listado diff --git a/content/blog/mastering-tabi-settings/index.md b/content/blog/mastering-tabi-settings/index.md index af66ec5..ac9c97e 100644 --- a/content/blog/mastering-tabi-settings/index.md +++ b/content/blog/mastering-tabi-settings/index.md @@ -1,7 +1,7 @@ +++ title = "Mastering tabi Settings: A Comprehensive Guide" date = 2023-09-18 -updated = 2024-11-13 +updated = 2024-11-14 description = "Discover the many ways you can customise your tabi site." [taxonomies] @@ -167,7 +167,9 @@ To pin a post, add the following to its front matter: pinned = true ``` -{{ admonition(type="note", text='This setting only affects pages using the default `section.html` template. In this demo, this includes the main page and `blog/`. Other sections —tags, archives, or series pages— ignore this setting.') }} +{{ admonition(type="info", text="This setting only affects your site's main pages (like `/`, `/es/`, `/fr/`). Other sections like `blog/`, `tags/`, or `archive/` show posts in their normal order.") }} + +{{ admonition(type="warning", text='When using pagination (`paginate_by`), pinned posts may appear twice: once on top of page 1, and again in their normal chronological position on subsequent pages.') }} ##### Display the Date of Posts in Listing diff --git a/templates/macros/list_posts.html b/templates/macros/list_posts.html index fc5e8dd..ade5a18 100644 --- a/templates/macros/list_posts.html +++ b/templates/macros/list_posts.html @@ -3,30 +3,42 @@ {# It would also work with arrays (e.g. ["dates"] or ["indexes"] or even ["indexes","dates"]). #} {# Nevertheless, arrays cannot be used as a default value for a macro parameter in Tera (see https://github.com/Keats/tera/issues/710). #} {# `paginator` is only used to compute indexes metadata and can be let empty otherwise. #} -{% macro list_posts(posts, max, metadata="dates", language_strings="", section_path="blog", paginator="", pinned_first=false) %} +{% macro list_posts(posts, all_posts="", max=999999, metadata="dates", language_strings="", section_path="blog", paginator="", pinned_first=false, current_page=1) %} {%- set separator = config.extra.separator | default(value="•") -%} -{# Separate pinned and regular posts #} -{% set all_posts = [] %} +{# Separate pinned and regular posts from all_posts if available, otherwise from posts #} {% if pinned_first %} + {% set source_posts = all_posts | default(value=posts) %} {% set pinned_posts = [] %} {% set regular_posts = [] %} - {% for post in posts %} + {% for post in source_posts %} {% if post.extra.pinned %} {% set_global pinned_posts = pinned_posts | concat(with=post) %} {% else %} {% set_global regular_posts = regular_posts | concat(with=post) %} {% endif %} {% endfor %} - {% set all_posts = pinned_posts | concat(with=regular_posts) %} + + {# On page 1 or when no pagination, show pinned then regular #} + {% if current_page == 1 %} + {% if paginator %} + {# With pagination: pinned + current page's posts #} + {% set display_posts = pinned_posts | concat(with=posts) %} + {% else %} + {# Without pagination: pinned + regular (no duplicates) #} + {% set display_posts = pinned_posts | concat(with=regular_posts) %} + {% endif %} + {% else %} + {% set display_posts = posts %} + {% endif %} {% else %} - {% set all_posts = posts %} + {% set display_posts = posts %} {% endif %}