[rtems-docs commit] Render math via JavaScript in HTML output

Sebastian Huber sebastian.huber at embedded-brains.de
Wed Feb 22 06:18:46 UTC 2017



On 22/02/17 01:03, Chris Johns wrote:
>
>> -
>>  version = '4.11.99'
>>  release = '4.11.99'
>>
>> diff --git a/common/conf.py b/common/conf.py
>> index 9f6bace..03cfa44 100644
>> --- a/common/conf.py
>> +++ b/common/conf.py
>> @@ -31,7 +31,8 @@ extensions = [
>>         "sphinx.ext.doctest",
>>         "sphinx.ext.graphviz",
>>         "sphinx.ext.intersphinx",
>> -       "sphinx.ext.pngmath",
>> +       "sphinx.ext.mathjax",
>> +       "sphinxcontrib.bibtex",
>>         "rtemsext",
>>         "rtemsdomain",
>>  ]
>
> The other solution which Amar suggested is to embed the extension in 
> the repo. I suspect this is what he has done with 
> sphinx.ext.intersphinx etc. My only concern is managing any version 
> skew between the user installed Sphinx and our local extensions. I 
> have no idea if this is an issue and how stable the APIs in Sphinx are 
> the extensions use.

We already test that as sphinx version X is installed, so I guess we can 
safely assume that the sphinx.ext.* stuff is there. For 
sphinxcontrib.bibtex we need a test. Its easy to install it via pip.

-- 
Sebastian Huber, embedded brains GmbH

Address : Dornierstr. 4, D-82178 Puchheim, Germany
Phone   : +49 89 189 47 41-16
Fax     : +49 89 189 47 41-09
E-Mail  : sebastian.huber at embedded-brains.de
PGP     : Public key available on request.

Diese Nachricht ist keine geschäftliche Mitteilung im Sinne des EHUG.




More information about the devel mailing list