Agregar una etiqueta de script de JavaScript en algún lugar para que funcione para cada archivo en la documentación de esfinge

Estoy usando Sphinx para escribir algunas notas. Estoy usando la extensión Mathjax para matemáticas en las notas. El tamaño predeterminado de las matemáticas es un poco más grande de lo que me gustaría. En la página de Mathjax descubrí que puedo cambiar ese tamaño agregando la siguiente secuencia de comandos al archivo HTML.Agregar una etiqueta de script de JavaScript en algún lugar para que funcione para cada archivo en la documentación de esfinge

MathJax.Hub.Config({ 
    "HTML-CSS": {scale: 90} 
});

tanto, he intentado añadiendo lo siguiente en un archivo .rst:

.. raw:: html 

    <script type="text/javascript" > 
     MathJax.Hub.Config({ 
      "HTML-CSS": { 
       scale: 90 
      } 
     }); 
    </script> 

========== 
Objective 
========== 

To change math size \\(\\alpha \\).

Lo anterior funciona muy bien para las matemáticas en ese archivo específico .rst. Pero quiero hacer esto para muchos archivos .rst diferentes que son todos parte del mismo documento de esfinge. ¿Es posible hacer esto sin agregar el script anterior a cada archivo .rst?

Gracias por leer esto y le agradecería si puede ayudar.

Fuente

2012-02-25 Curious2learn

Esto se puede hacer con una plantilla:

Crear una carpeta llamada templates en el directorio del proyecto Esfinge.
En conf.py, añadir
```
templates_path = ["templates"] 
```

En el directorio templates, crear un archivo llamado layout.html con el siguiente contenido:

{% extends "!layout.html" %} 

{%- block extrahead %} 
<script type="text/javascript"> 
     MathJax.Hub.Config({ 
      "HTML-CSS": { 
       scale: 90 
      } 
     }); 
    </script>  
{% endblock %}

se incluirá el elemento <script> en el <head> de cada página HTML generada. El bloque de plantilla extrahead está vacío de forma predeterminada Vea el Sphinx templating documentation para más detalles.

Fuente

2012-02-26 16:11:00 mzjn

Muchas gracias. Esto funcionó muy bien! Gracias especialmente por los pasos detallados. ¿Por qué hay un '-' en la línea' {% - bloque extrahead} '. Sin el tablero, no funciona. Los ejemplos de código que he visto en el enlace no tienen este '-'. – Curious2learn

El bloque 'extrahead' predeterminado en sphinx/themes/basic/layout.html tiene el guión/guión/menos adicional (se trata de [control de espacio en blanco] (http://jinja.pocoo.org/docs/templates/#whitespace) -controlar)). Pero realmente no puedo explicar por qué no funciona para ti sin él ... – mzjn

Gracias. Voy a investigar eso. De todos modos, funciona muy bien con el tablero. Gracias de nuevo por responder. – Curious2learn

Otro método:

Utilice el ajuste script_files en su archivo se reemplaza layout.html.

Fuente

2012-03-21 16:38:51

Y un tercer enfoque, que no implica plantillas:

llamada add_javascript en la función setup en conf.py de su proyecto Sphinx:

# conf.py 

# ... other settings ... 

def setup(app): 
    # (create a setup() function if you don't already have one; 
    # or add to the existing setup() ...) 
    app.add_javascript("mathjax-config.js")

crear el archivo "mathjax-config.js" en su directorio de origen estático. (Compruebe la configuración conf.py html_static_path para verificar los directorios estáticos, o defina uno si es necesario). Sphinx lo copiará en el directorio de salida durante la compilación.

También hay un método add_stylesheet para archivos css. Y ambos pueden tomar rutas relativas a sus directorios fuente estáticos, o direcciones URL completas a recursos externos.

Fuente

2017-01-27 01:37:02 medmunds

Parece que esto requiere configurar una extensión, ¿es correcto? – NirIzr

No se requiere extensión: puede colocar una función 'setup()' en el conf.py propio de su proyecto (Su proyecto se permite de manera efectiva como su propia extensión). – medmunds

Agregar una etiqueta de script de JavaScript en algún lugar para que funcione para cada archivo en la documentación de esfinge

Respuesta

Cuestiones relacionadas