From ced0cb43b6b4b4f6fba583990e428ddedbf52af3 Mon Sep 17 00:00:00 2001 From: welpo Date: Mon, 1 Jul 2024 14:20:29 +0200 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20docs:=20deprecate=20JS=20footnot?= =?UTF-8?q?e=20backlinks?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit In favour of native `bottom_footnotes` available in Zola 0.19.0. --- README.md | 1 - config.toml | 2 ++ content/blog/javascript/index.ca.md | 3 +-- content/blog/javascript/index.es.md | 3 +-- content/blog/javascript/index.md | 3 +-- content/blog/mastering-tabi-settings/index.ca.md | 4 +++- content/blog/mastering-tabi-settings/index.es.md | 4 +++- content/blog/mastering-tabi-settings/index.md | 4 +++- content/projects/tabi/index.md | 1 - theme.toml | 2 ++ 10 files changed, 16 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index c35d43fb5..cb577d596 100644 --- a/README.md +++ b/README.md @@ -58,7 +58,6 @@ tabi has a perfect score on Google's Lighthouse audit: - [X] [Custom canonical URLs](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#canonical-url). - [X] [Custom shortcodes](https://welpo.github.io/tabi/blog/shortcodes/). - [X] [Customizable skins](https://welpo.github.io/tabi/blog/customise-tabi/). -- [X] [Footnote backlinks](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#footnote-backlinks). - [X] [Social media cards](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#social-media-cards). - [X] Responsive design. - [X] [Projects page](https://welpo.github.io/tabi/projects/). diff --git a/config.toml b/config.toml index d77c9acd3..11debe653 100644 --- a/config.toml +++ b/config.toml @@ -145,6 +145,8 @@ show_reading_time = true # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy show_date = true +# DEPRECATED! +# Use Zola's built-in `bottom_footnotes = true` in the [markdown] section instead. (Available since v0.19.0) # Adds backlinks to footnotes (loads ~500 bytes of JavaScripts). # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy footnote_backlinks = false diff --git a/content/blog/javascript/index.ca.md b/content/blog/javascript/index.ca.md index 9f6f45959..efd210290 100644 --- a/content/blog/javascript/index.ca.md +++ b/content/blog/javascript/index.ca.md @@ -1,7 +1,7 @@ +++ title = "Sense JavaScript obligatori" date = 2023-01-06 -updated = 2024-05-03 +updated = 2024-07-01 description = "JavaScript només s'utilitza quan HTML i CSS no són suficients." [taxonomies] @@ -29,7 +29,6 @@ Les següents opcions es poden especificar per a publicacions, seccions i global - [**Suport de KaTeX**](@/blog/markdown/index.ca.md#katex). Habilitat configurant `katex = true` (274 KB). - [**Còpia de blocs de codi amb un sol clic**](@/blog/markdown/index.ca.md#bloc-de-codi). Habilitada configurant `copy_button = true`. (~700 bytes) - [**Mostrar ruta/URL a blocs de codi**](@/blog/shortcodes/index.ca.md#mostrar-ruta-o-url). S'activa configurant `add_src_to_code_block = true`. (~400 bytes) -- [**Enllaços de retorn per a notes a peu de pàgina**](@/blog/markdown/index.ca.md#1). Habilitats configurant `footnote_backlinks = true` (~500 bytes). Per especificar aquestes opcions: diff --git a/content/blog/javascript/index.es.md b/content/blog/javascript/index.es.md index d574717a8..66c03201b 100644 --- a/content/blog/javascript/index.es.md +++ b/content/blog/javascript/index.es.md @@ -1,7 +1,7 @@ +++ title = "Sin JavaScript obligatorio" date = 2023-01-06 -updated = 2024-05-03 +updated = 2024-07-01 description = "JavaScript solo se utiliza cuando HTML y CSS no son suficientes." [taxonomies] @@ -29,7 +29,6 @@ Las siguientes opciones pueden especificarse para publicaciones, secciones y a n - [**Soporte de KaTeX**](@/blog/markdown/index.es.md#katex). Habilitado al configurar `katex = true` (274 KB). - [**Copia de bloques de código con un solo clic**](@/blog/markdown/index.es.md#bloque-de-codigo). Habilitado al configurar `copy_button = true` (~700 bytes). - [**Mostrar ruta/URL en bloques de código**](@/blog/shortcodes/index.es.md#mostrar-ruta-o-url). Se activa configurando `add_src_to_code_block = true`. (~400 bytes) -- [**Enlaces de retorno de notas al pie**](@/blog/markdown/index.es.md#1). Habilitado al configurar `footnote_backlinks = true` (~500 bytes). Para especificar estas opciones: diff --git a/content/blog/javascript/index.md b/content/blog/javascript/index.md index 9217a5545..23d0c8bde 100644 --- a/content/blog/javascript/index.md +++ b/content/blog/javascript/index.md @@ -1,7 +1,7 @@ +++ title = "No mandatory JavaScript" date = 2023-01-06 -updated = 2024-05-03 +updated = 2024-07-01 description = "JavaScript is only used when HTML and CSS aren't enough." [taxonomies] @@ -29,7 +29,6 @@ The following settings can be specified for posts, sections and globally, follow - [**KaTeX support**](@/blog/markdown/index.md#katex). Enabled by setting `katex = true` (274 KB). - [**One-click copy of code blocks**](@/blog/markdown/index.md#code-block). Enabled by setting `copy_button = true`. (~700 bytes) - [**Showing source (path or URL) in code blocks**](@/blog/shortcodes/index.md#show-source-or-path). Enabled by setting `add_src_to_code_block = true`. (~300 bytes) -- [**Footnote backlinks**](@/blog/markdown/index.md#1). Enabled by setting `footnote_backlinks = true` (~500 bytes). To specify these settings: diff --git a/content/blog/mastering-tabi-settings/index.ca.md b/content/blog/mastering-tabi-settings/index.ca.md index 473b1afcf..3bb9a291d 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-06-28 +updated = 2024-07-01 description = "Descobreix les múltiples maneres en què pots personalitzar tabi." [taxonomies] @@ -527,6 +527,8 @@ Totes aquestes configuracions segueixen la jerarquia. ### Enllaços de retorn a les notes a peu de pàgina +{{ admonition(type="warning", title="ADVERTÈNCIA DE DEPRECACIÓ", text="Zola v0.19.0 i posterior pot fer això de forma nativa. Estableix `bottom_footnotes = true` a la secció `[markdown]` de la teva configuració.") }} + | Pàgina | Secció | `config.toml` | Segueix la jerarquia | Requereix JavaScript | |:------:|:------:|:-------------:|:------------------:|:--------------------:| | ✅ | ✅ | ✅ | ✅ | ✅ | diff --git a/content/blog/mastering-tabi-settings/index.es.md b/content/blog/mastering-tabi-settings/index.es.md index 2b00ab78a..b09852208 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-06-28 +updated = 2024-07-01 description = "Descubre las múltiples maneras en que puedes personalizar tabi." [taxonomies] @@ -527,6 +527,8 @@ Todas estas configuraciones siguen la jerarquía. ### Enlaces de retorno en notas al pie +{{ admonition(type="warning", title="ADVERTENCIA DE DEPRECACIÓN", text="Zola v0.19.0 y posterior puede hacer esto de forma nativa. Establece `bottom_footnotes = true` en la sección `[markdown]` de tu configuración.") }} + | Página | Sección | `config.toml` | Sigue la jerarquía | Requiere JavaScript | |:------:|:-------:|:-------------:|:---------------:|:-------------------:| | ✅ | ✅ | ✅ | ✅ | ✅ | diff --git a/content/blog/mastering-tabi-settings/index.md b/content/blog/mastering-tabi-settings/index.md index f66c31478..287612b4c 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-06-28 +updated = 2024-07-01 description = "Discover the many ways you can customise your tabi site." [taxonomies] @@ -531,6 +531,8 @@ All of these settings follow the hierarchy. ### Footnote Backlinks +{{ admonition(type="warning", title="DEPRECATION WARNING", text="Zola v0.19.0 and later can do this natively. Set `bottom_footnotes = true` in your config's `[markdown]` section.") }} + | Page | Section | `config.toml` | Follows Hierarchy | Requires JavaScript | |:----:|:-------:|:-------------:|:-----------------:|:-------------------:| | ✅ | ✅ | ✅ | ✅ | ✅ | diff --git a/content/projects/tabi/index.md b/content/projects/tabi/index.md index 556fb44a6..7a5e9aee0 100644 --- a/content/projects/tabi/index.md +++ b/content/projects/tabi/index.md @@ -38,7 +38,6 @@ social_media_card = "social_cards/projects_tabi.jpg" - [Custom canonical URLs](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#canonical-url). - [Customizable skins](https://welpo.github.io/tabi/blog/customise-tabi/). - [Custom shortcodes](https://welpo.github.io/tabi/blog/shortcodes/). -- [Footnote backlinks](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#footnote-backlinks). - [Social media cards](https://welpo.github.io/tabi/blog/mastering-tabi-settings/#social-media-cards). - Responsive design. - [Projects page](https://welpo.github.io/tabi/projects/). diff --git a/theme.toml b/theme.toml index 12cf60c26..a806e1309 100644 --- a/theme.toml +++ b/theme.toml @@ -103,6 +103,8 @@ show_reading_time = true # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy show_date = true +# DEPRECATED! +# Use Zola's built-in `bottom_footnotes = true` in the [markdown] section instead. (Available since v0.19.0) # Adds backlinks to footnotes (loads ~500 bytes of JavaScripts). # Can be set at page or section levels, following the hierarchy: page > section > config. See: https://welpo.github.io/tabi/blog/mastering-tabi-settings/#settings-hierarchy footnote_backlinks = false