From ffa08bad76741005e0a6a46329a895f8b6c34856 Mon Sep 17 00:00:00 2001 From: hallzyx Date: Thu, 20 Mar 2025 20:03:31 -0500 Subject: [PATCH 1/4] fix: Corrected OpenGraph metadata generation in sphinxtxt --- _templates/page.html | 21 ++++++++++++++++----- conf.py | 2 ++ 2 files changed, 18 insertions(+), 5 deletions(-) diff --git a/_templates/page.html b/_templates/page.html index 4a59ca1..6b3c830 100644 --- a/_templates/page.html +++ b/_templates/page.html @@ -1,7 +1,18 @@ {%- extends "!page.html" %} -{%- block extrahead %} - - -{{ super() }} -{% endblock extrahead %} +{% block extrahead %} + {{ super() }} + + {# Verifica la disponibilidad de sphinx_version antes de renderizar metatags + Esta verificación es crucial para evitar errores durante la generación + del sitio cuando la extensión sphinxext.opengraph no está disponible #} + {% if sphinx_version %} + {{ metatags }} + {% endif %} + + {# Meta tags estáticos definidos manualmente para garantizar consistencia + Estos tags permanecerán invariables independientemente de la configuración + de Sphinx o sus extensiones, asegurando una identidad constante del sitio #} + + +{% endblock %} \ No newline at end of file diff --git a/conf.py b/conf.py index 06e4b74..f547811 100644 --- a/conf.py +++ b/conf.py @@ -432,3 +432,5 @@ "line_color": "#4078c0", "image": "_static/logo/logo.png", } +# Asegura la generación del meta tag og:image que no siempre es generado por sphinxext.opengraph +ogp_image = "_static/logo/logo.png" \ No newline at end of file From 5bfc2cd69afba1c4a7da7c63f6eb79b335aa03db Mon Sep 17 00:00:00 2001 From: hallzyx Date: Thu, 20 Mar 2025 20:20:29 -0500 Subject: [PATCH 2/4] fix: Corrected OpenGraph metadata generation in sphinxtxt - update page.html static metadata --- _templates/page.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_templates/page.html b/_templates/page.html index 6b3c830..00caedf 100644 --- a/_templates/page.html +++ b/_templates/page.html @@ -13,6 +13,6 @@ {# Meta tags estáticos definidos manualmente para garantizar consistencia Estos tags permanecerán invariables independientemente de la configuración de Sphinx o sus extensiones, asegurando una identidad constante del sitio #} - - + + {% endblock %} \ No newline at end of file From b00f583d8aeed16cd60db22836bf8b275386e71c Mon Sep 17 00:00:00 2001 From: hallzyx Date: Thu, 20 Mar 2025 21:21:10 -0500 Subject: [PATCH 3/4] docs: translate comments to English --- _templates/page.html | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/_templates/page.html b/_templates/page.html index 00caedf..07ae95c 100644 --- a/_templates/page.html +++ b/_templates/page.html @@ -3,16 +3,16 @@ {% block extrahead %} {{ super() }} - {# Verifica la disponibilidad de sphinx_version antes de renderizar metatags - Esta verificación es crucial para evitar errores durante la generación - del sitio cuando la extensión sphinxext.opengraph no está disponible #} + {# Verifies sphinx_version availability before rendering metatags + This check is crucial to prevent errors during site generation + when sphinxext.opengraph extension is not available #} {% if sphinx_version %} {{ metatags }} {% endif %} - {# Meta tags estáticos definidos manualmente para garantizar consistencia - Estos tags permanecerán invariables independientemente de la configuración - de Sphinx o sus extensiones, asegurando una identidad constante del sitio #} + {# Static meta tags manually defined to ensure consistency + These tags will remain unchanged regardless of Sphinx configuration + or its extensions, ensuring a constant site identity #} {% endblock %} \ No newline at end of file From f5f1ea77e464bc4b58951861384f200a922f1144 Mon Sep 17 00:00:00 2001 From: hallzyx Date: Thu, 20 Mar 2025 21:22:49 -0500 Subject: [PATCH 4/4] docs: translate comment to English in conf.py --- conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/conf.py b/conf.py index f547811..75b904c 100644 --- a/conf.py +++ b/conf.py @@ -432,5 +432,5 @@ "line_color": "#4078c0", "image": "_static/logo/logo.png", } -# Asegura la generación del meta tag og:image que no siempre es generado por sphinxext.opengraph +# Ensures og:image meta tag generation which is not always generated by sphinxext.opengraph ogp_image = "_static/logo/logo.png" \ No newline at end of file