Estoy ampliando el diseño de mi sphinx-book-theme agregando lo siguiente a layout.html en mi carpeta source\_templates :
{% extends "!layout.html" %} {%- block extrahead %} <script type="text/javascript" src="https://utteranc.es/client.js" async="async" repo="executablebooks/jupyter-book" issue-term="pathname" theme="github-light" label="💬 comment" crossorigin="anonymous"> </script> {% endblock %}Cuando construyo desde la fuente con el comando:
sphinx-build -b html ....La salida html no muestra la sección de comentarios en la parte inferior de las páginas.
Sin embargo, si agrego el bloque de JavaScript directamente al final de un archivo Markdown, la sección de comentarios aparece en la parte inferior de la página correspondiente.
¿Que me estoy perdiendo aqui? Cuando inspecciono la fuente de la página, puedo ver que el bloque de JavaScript está en la sección head .
Estoy usando Sphinx v4.5.0 con el tema Sphinx-book-theme en un sistema operativo Windows
Me las arreglé para encontrar una respuesta a mi propia pregunta. :-) Mirando el 'layout.html' principal, descubrí que la plantilla tenía una estructura diferente y que los bloques usaban convenciones de nomenclatura diferentes a las que se usaban en las plantillas Sphinx predeterminadas. Así que cambié mi configuración inicial agregando un bloque adicional extraScript dentro del bloque docs_main , luego agregué un bloque allí debajo de {super}:
{% block extraScript } {% endblock extraScript %}Luego adapté el código indicado en mi pregunta anterior como se muestra a continuación:
{% extends "!layout.html" %} {%- block extraScript %} <script type="text/javascript" src="https://utteranc.es/client.js" async="async" repo="executablebooks/jupyter-book" issue-term="pathname" theme="github-light" label="💬 comment" crossorigin="anonymous"> </script> {% endblock extraScript %}Si tiene un método más elegante para resolver este problema, comparta sus ideas con nosotros.