diff --git a/content/blog/mastering-tabi-settings/img/pinned_post_dark.webp b/content/blog/mastering-tabi-settings/img/pinned_post_dark.webp new file mode 100644 index 00000000..afa3f6bb Binary files /dev/null and b/content/blog/mastering-tabi-settings/img/pinned_post_dark.webp differ diff --git a/content/blog/mastering-tabi-settings/img/pinned_post_light.webp b/content/blog/mastering-tabi-settings/img/pinned_post_light.webp new file mode 100644 index 00000000..f73e183f Binary files /dev/null and b/content/blog/mastering-tabi-settings/img/pinned_post_light.webp differ diff --git a/content/blog/mastering-tabi-settings/index.ca.md b/content/blog/mastering-tabi-settings/index.ca.md index 45eee50a..21cd64e4 100644 --- a/content/blog/mastering-tabi-settings/index.ca.md +++ b/content/blog/mastering-tabi-settings/index.ca.md @@ -1,13 +1,14 @@ +++ title = "Domina la configuració de tabi: guia completa" date = 2023-09-18 -updated = 2024-10-20 +updated = 2024-11-08 description = "Descobreix les múltiples maneres en què pots personalitzar tabi." [taxonomies] tags = ["funcionalitat", "tutorial", "preguntes freqüents"] [extra] +pinned = true quick_navigation_buttons = true social_media_card = "social_cards/ca_blog_mastering_tabi_settings.jpg" +++ @@ -153,6 +154,23 @@ Notes addicionals: - El `title` al front matter estableix el títol que apareix sobre les publicacions. - Utilitza la ruta completa a l'arxiu `_index.md` de la secció per a `section_path`. Usar `section_path = "blog/"` no funcionarà. +##### Fixar entrades + +Pots fixar entrades per mantenir-les a la part superior de la pàgina principal. En aquesta demo, aquesta entrada està fixada, així que apareix primera amb una icona i etiqueta de "fixat": + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/pinned_post_light.webp", dark_src="blog/mastering-tabi-settings/img/pinned_post_dark.webp", alt="Entrada fixada", full_width=true) }} + +Les entrades fixades es mostren primer, mantenint el seu ordre relatiu segons el `sort_by` de la secció, seguides per les entrades regulars. + +Per fixar una entrada, afegeix el següent al seu front matter: + +```toml +[extra] +pinned = true +``` + +{{ admonition(type="note", text='Aquesta configuració només afecta la pàgina principal (`template = "section.html"`). En altres seccions (p.ex. `blog/`, `archive/`), aquest configuració no té cap efecte.') }} + ##### Mostrar la data dels articles al llistat Per defecte, quan es llisten els articles, es mostra la data de creació. Pots configurar quina(es) data(es) mostrar utilitzant l'opció `post_listing_date`. Configuracions disponibles: diff --git a/content/blog/mastering-tabi-settings/index.es.md b/content/blog/mastering-tabi-settings/index.es.md index bb7a6100..ab28e502 100644 --- a/content/blog/mastering-tabi-settings/index.es.md +++ b/content/blog/mastering-tabi-settings/index.es.md @@ -1,13 +1,14 @@ +++ title = "Domina la configuración de tabi: guía completa" date = 2023-09-18 -updated = 2024-10-20 +updated = 2024-11-08 description = "Descubre las múltiples maneras en que puedes personalizar tabi." [taxonomies] tags = ["funcionalidad", "tutorial", "preguntas frecuentes"] [extra] +pinned = true quick_navigation_buttons = true social_media_card = "social_cards/es_blog_mastering_tabi_settings.jpg" +++ @@ -153,6 +154,23 @@ Notas adicionales: - El `title` en el front matter establece el título que aparece sobre las publicaciones. - Usa la ruta completa al archivo `_index.md` de la sección para `section_path`. Usar `section_path = "blog/"` no funcionará. +##### Fijar publicaciones + +Puedes fijar publicaciones para mantenerlas en la parte superior de la página principal. En esta demo, esta publicación está fijada, por lo que aparece primera con un icono y etiqueta de "fijado": + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/pinned_post_light.webp", dark_src="blog/mastering-tabi-settings/img/pinned_post_dark.webp", alt="Entrada fijada", full_width=true) }} + +Las publicaciones fijadas se muestran primero, manteniendo su orden relativo según el `sort_by` de la sección, seguidas por el resto de las publicaciones. + +Para fijar una publicación, añade lo siguiente a su front matter: + +```toml +[extra] +pinned = true +``` + +{{ admonition(type="note", text='Este ajuste solo afecta a la página principal (`template = "section.html"`). En otras secciones (p.ej. `blog/`, `archive/`), este ajuste no tiene ningún efecto.') }} + ##### Mostrar la fecha de los artículos en el listado Por defecto, cuando se listan los artículos, se muestra la fecha de creación. Puedes configurar qué fecha(s) mostrar usando la opción `post_listing_date`. Configuraciones disponibles: diff --git a/content/blog/mastering-tabi-settings/index.md b/content/blog/mastering-tabi-settings/index.md index 341a3bc2..fbe4c767 100644 --- a/content/blog/mastering-tabi-settings/index.md +++ b/content/blog/mastering-tabi-settings/index.md @@ -1,13 +1,14 @@ +++ title = "Mastering tabi Settings: A Comprehensive Guide" date = 2023-09-18 -updated = 2024-10-20 +updated = 2024-11-08 description = "Discover the many ways you can customise your tabi site." [taxonomies] tags = ["showcase", "tutorial", "FAQ"] [extra] +pinned = true quick_navigation_buttons = true social_media_card = "social_cards/blog_mastering_tabi_settings.jpg" +++ @@ -153,6 +154,23 @@ Additional notes: - The `title` in the front matter sets the header that appears above the posts. - Use the full path to the section's `_index.md` file for `section_path`. Using `section_path = "blog/"` will not work. +##### Pinning Posts + +You can pin posts to keep them at the top of the main page listing. In this demo, this post is pinned, so it appears first with a "pinned" icon and label: + +{{ dual_theme_image(light_src="blog/mastering-tabi-settings/img/pinned_post_light.webp", dark_src="blog/mastering-tabi-settings/img/pinned_post_dark.webp", alt="Pinned post", full_width=true) }} + +Pinned posts are shown first, maintaining their relative order of the section's `sort_by`, followed by regular posts. + +To pin a post, add the following to its front matter: + +```toml +[extra] +pinned = true +``` + +{{ admonition(type="note", text='This setting only affects the main page (`template = "section.html"`). On other sections (e.g. `blog/`, `archive/`), this setting makes no difference.') }} + ##### Display the Date of Posts in Listing By default, when listing posts, the date of post creation is shown. You can configure which date(s) to display using the `post_listing_date` option. Available settings: diff --git a/i18n/ar.toml b/i18n/ar.toml index 55bc5e55..8cdd0c37 100644 --- a/i18n/ar.toml +++ b/i18n/ar.toml @@ -30,6 +30,7 @@ few_results = "تم العثور على $NUMBER نتائج" # for 3 to 10 searc many_results = "تم العثور على $NUMBER نتيجة" # 11 or more search results. # Navigation. +pinned = "مثبت" jump_to_posts = "الإنتقال إلى التدوينات" read_more = "إقرأ المزيد" one_posts = "تدوينة واحدة" #One blog post. diff --git a/i18n/ca.toml b/i18n/ca.toml index 14841789..855b95be 100644 --- a/i18n/ca.toml +++ b/i18n/ca.toml @@ -23,6 +23,7 @@ one_results = "$NUMBER resultat" # "1 result" many_results = "$NUMBER resultats" # "3 results" # Navigation. +pinned = "Fixat" jump_to_posts = "Saltar als articles" read_more = "Llegir més" one_posts = "$NUMBER entrada" diff --git a/i18n/de.toml b/i18n/de.toml index fdafcad9..4adb6a28 100644 --- a/i18n/de.toml +++ b/i18n/de.toml @@ -27,6 +27,7 @@ one_results = "$NUMBER Ergebnis" # "1 result" many_results = "$NUMBER Ergebnisse" # "3 results" # Navigation. +pinned = "Angeheftet" jump_to_posts = "Zu den Beiträgen springen" read_more = "Weiterlesen" one_posts = "$NUMBER Beitrag" diff --git a/i18n/en.toml b/i18n/en.toml index 745335a9..178ea934 100644 --- a/i18n/en.toml +++ b/i18n/en.toml @@ -23,6 +23,7 @@ one_results = "$NUMBER result" # "1 result" many_results = "$NUMBER results" # "3 results" # Navigation. +pinned = "Pinned" jump_to_posts = "Jump to posts" read_more = "Read more" one_posts = "$NUMBER post" diff --git a/i18n/es.toml b/i18n/es.toml index 36fdd945..f5443218 100644 --- a/i18n/es.toml +++ b/i18n/es.toml @@ -23,6 +23,7 @@ one_results = "$NUMBER resultado" many_results = "$NUMBER resultados" # Navigation. +pinned = "Fijado" jump_to_posts = "Saltar a las entradas" read_more = "Leer más" one_posts = "$NUMBER entrada" diff --git a/i18n/et.toml b/i18n/et.toml index 77a9a19e..8af04678 100644 --- a/i18n/et.toml +++ b/i18n/et.toml @@ -23,6 +23,7 @@ one_results = "$NUMBER tulemus" # "1 result" many_results = "$NUMBER tulemust" # "3 results" # Navigation. +pinned = "Kinnitatud" jump_to_posts = "Hüppa postitusteni" read_more = "Loe edasi" one_posts = "$NUMBER postitus" diff --git a/i18n/fa.toml b/i18n/fa.toml index 13fdd58f..5f2073fa 100644 --- a/i18n/fa.toml +++ b/i18n/fa.toml @@ -23,6 +23,7 @@ one_results = "$NUMBER نتیجه" # "1 result" many_results = "$NUMBER نتیجه" # "3 results" # Navigation. +pinned = "سنجاق‌شده" jump_to_posts = "پرش به نوشته‌ها" read_more = "ادامه مطلب" one_posts = "$NUMBER مطلب" diff --git a/i18n/fr.toml b/i18n/fr.toml index 88469e12..62917a54 100644 --- a/i18n/fr.toml +++ b/i18n/fr.toml @@ -23,6 +23,7 @@ one_results = "$NUMBER résultat" # "1 result" many_results = "$NUMBER résultats" # "3 results" # Navigation. +pinned = "Épinglé" jump_to_posts = "Aller aux articles" read_more = "Lire plus" one_posts = "$NUMBER article" diff --git a/i18n/hi.toml b/i18n/hi.toml index eabfe77d..c144d43d 100644 --- a/i18n/hi.toml +++ b/i18n/hi.toml @@ -25,6 +25,7 @@ one_results = "$NUMBER परिणाम" # "1 result" many_results = "$NUMBER परिणाम" # "3 results" # Navigation. +pinned = "पिन किया गया" jump_to_posts = "पोस्ट पर जाएं" read_more = "और पढ़ें" one_posts = "$NUMBER पोस्ट" diff --git a/i18n/it.toml b/i18n/it.toml index a6db4243..be00d124 100644 --- a/i18n/it.toml +++ b/i18n/it.toml @@ -23,6 +23,7 @@ one_results = "$NUMBER risultato" many_results = "$NUMBER risultati" # Navigation. +pinned = "In evidenza" jump_to_posts = "Vai ai post" read_more = "Leggi di più" one_posts = "$NUMBER post" diff --git a/i18n/ja.toml b/i18n/ja.toml index 5969bf3d..95c13619 100644 --- a/i18n/ja.toml +++ b/i18n/ja.toml @@ -27,6 +27,7 @@ one_results = "$NUMBER 結果" # "1 result" many_results = "$NUMBER 結果" # "3 results" # Navigation. +pinned = "固定" jump_to_posts = "投稿へジャンプ" read_more = "続きを読む" one_posts = "$NUMBER 投稿" diff --git a/i18n/ko.toml b/i18n/ko.toml index 9172796b..02e737c9 100644 --- a/i18n/ko.toml +++ b/i18n/ko.toml @@ -27,6 +27,7 @@ one_results = "$NUMBER 결과" # "1 result" many_results = "$NUMBER 결과" # "3 results" # Navigation. +pinned = "고정됨" jump_to_posts = "게시물로 이동" read_more = "더 읽기" one_posts = "$NUMBER 게시물" diff --git a/i18n/nl.toml b/i18n/nl.toml index 772e8129..95bb1e2c 100644 --- a/i18n/nl.toml +++ b/i18n/nl.toml @@ -23,6 +23,7 @@ one_results = "$NUMBER resultaat" # "1 result" many_results = "$NUMBER resultaten" # "3 results" # Navigation. +pinned = "Vastgezet" jump_to_posts = "Naar berichten springen" read_more = "Lees meer" one_posts = "$NUMBER bericht" # "1 post" diff --git a/i18n/or.toml b/i18n/or.toml index 1cb535ef..4400c962 100644 --- a/i18n/or.toml +++ b/i18n/or.toml @@ -23,6 +23,7 @@ one_results = "$NUMBER ପରିଣାମ" # "1 result" many_results = "$NUMBER ପରିଣାମଗୁଡ଼ିକ" # "3 results" # Navigation. +pinned = "ପିନ୍ କରାଯାଇଛି" jump_to_posts = "ପୋଷ୍ଟକୁ ଯାଆନ୍ତୁ" read_more = "ଆହୁରି ପଢ଼ନ୍ତୁ" one_posts = "$NUMBER ପୋଷ୍ଟ" diff --git a/i18n/pt-PT.toml b/i18n/pt-PT.toml index 164ef49a..62b38679 100644 --- a/i18n/pt-PT.toml +++ b/i18n/pt-PT.toml @@ -23,6 +23,7 @@ one_results = "$NUMBER resultado" # "1 result" many_results = "$NUMBER resultados" # "3 results" # Navigation. +pinned = "Fixado" jump_to_posts = "Ir para as publicações" read_more = "Ler mais" one_posts = "$NUMBER publicação" diff --git a/i18n/ru.toml b/i18n/ru.toml index e8a3ad3f..c8a0e440 100644 --- a/i18n/ru.toml +++ b/i18n/ru.toml @@ -28,6 +28,7 @@ few_results = "$NUMBER результата" # 2, 3, 4 but not 12-14 many_results = "$NUMBER результатов" # 5-9, 0, 11-14, and others # Navigation. +pinned = "Закреплено" jump_to_posts = "Перейти к записям" read_more = "Читать далее" post = "пост" diff --git a/i18n/uk.toml b/i18n/uk.toml index fada833d..62f565d7 100644 --- a/i18n/uk.toml +++ b/i18n/uk.toml @@ -33,6 +33,7 @@ few_results = "$NUMBER результати" many_results = "$NUMBER результатів" # Navigation. +pinned = "Закріплено" jump_to_posts = "Перейти до дописів" read_more = "Читати далі" one_posts = "$NUMBER пост" diff --git a/i18n/zh-Hans.toml b/i18n/zh-Hans.toml index 29d70772..af6ba122 100644 --- a/i18n/zh-Hans.toml +++ b/i18n/zh-Hans.toml @@ -23,6 +23,7 @@ one_results = "$NUMBER 个结果" many_results = "$NUMBER 个结果" # Navigation. +pinned = "置顶" jump_to_posts = "跳转到文章" read_more = "阅读全文" one_posts = "$NUMBER 篇文章" diff --git a/i18n/zh-Hant.toml b/i18n/zh-Hant.toml index 7c41eaa5..dd887c2d 100644 --- a/i18n/zh-Hant.toml +++ b/i18n/zh-Hant.toml @@ -23,6 +23,7 @@ one_results = "$NUMBER 個結果" many_results = "$NUMBER 個結果" # Navigation. +pinned = "釘選" jump_to_posts = "跳轉到文章" read_more = "閱讀全文" one_posts = "$NUMBER 篇文章" diff --git a/sass/parts/_posts_list.scss b/sass/parts/_posts_list.scss index 92cfe467..ca303a3d 100644 --- a/sass/parts/_posts_list.scss +++ b/sass/parts/_posts_list.scss @@ -3,6 +3,17 @@ grid-template-columns: 1fr 8fr; } +.pinned-label { + display: flex; + align-items: center; + gap: 0.3rem; +} + +.pinned-label svg { + width: 1rem; + height: 1rem; +} + .bloglist-meta { display: flex; align-items: flex-start; @@ -100,9 +111,13 @@ grid-template-columns: 1fr; } + .pinned-label svg { + margin-bottom: -2px; + } + .bloglist-meta { - padding-block: 2rem; border-bottom: 0; + padding-block: 2rem; ul { margin-block-end: 0; diff --git a/templates/macros/list_posts.html b/templates/macros/list_posts.html index 6fd7be04..4d5ab22a 100644 --- a/templates/macros/list_posts.html +++ b/templates/macros/list_posts.html @@ -7,8 +7,21 @@ {%- set separator = config.extra.separator | default(value="•") -%} +{# Separate pinned and regular posts #} +{% set pinned_posts = [] %} +{% set regular_posts = [] %} +{% for post in 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 %} +
- {% for post in posts %} + {# Display all posts (pinned first, then regular) #} + {% set all_posts = pinned_posts | concat(with=regular_posts) %} + {% for post in all_posts %} {% if loop.index <= max %} {% if loop.index == max or loop.last %} {% set bottom_divider = false %} @@ -16,81 +29,93 @@ {% set bottom_divider = true %} {% endif %} -
- +
+ +
+
+

+ {{ post.title }} +

+ + {% if post.taxonomies.tags %} +
+ {% for tag in post.taxonomies.tags %} + {{ tag }} + {% endfor %} +
+ {% endif %} + +
+ {% if post.description %} +

{{ post.description }}

+ {% elif post.summary %} +

{{ post.summary | striptags | trim_end_matches(pat=".") | safe }}…

+ {% endif %} +
+ {{ macros_translate::translate(key="read_more", default="Read more", language_strings=language_strings) }} →
- {{ macros_translate::translate(key="read_more", default="Read more", language_strings=language_strings) }} → -
- - {% endif %} + + {% endif %} {% if not loop.last %} {% if loop.index == max %}
@@ -100,5 +125,4 @@ {% endif %} {% endfor %}
- {% endmacro %}