<== documentation - 2/2 Blog notebook (8) sphinx (13)
documentation - 2/2¶
Conversion to latex is taking for ever¶
2015-04-16
The unit tests are now scheduled using Jenkins. When the documentation is generated for the first time after a fresh installation of the machine (latex, sphinx…), the compilation can take for ever. This is due to extra packages needed by latex. When the process is run from a command line, a windows shows up asking for approval before going on installing the missing latex packages. As this command line is showing up in the output, it is just needed to executed from a command line window to import the missing package. After this short break, the latex compilation runs fine on Jenkins.
Anaconda does not have the latest version of Sphinx¶
2015-04-16
As of today, when I type conda update sphinx
,
The Anaconda distribution does not upgrade to 1.3
and I need it to get the extension
sphinx.ext.napoleon. So I need to type
pip install sphinx --upgrade
instead.
Insert plot from bokeh in the documentation¶
2015-04-12
As graphs from matplotlib, graphs from bokeh can be inserted in the documentation with the extension bokeh.sphinxext.bokeh_plot.
…
Sphinx fails because of some weird encoding¶
2015-04-07
I have been generating many times the documentation of this module and I can tell I went through many errors due to encoding, French accents may be sometimes painful to deal with. However, I now check every time that every file I produce has either no encoding, either is encoded with utf-8 and no BOM. After I checked that, I’m sure the error come from something else.
…
An example of a blog post included in the documentation¶
2015-04-04
This blog post is an example of a blogpost which can be added to the documentation. Unfortunately, it does not rely on an existing python blog generator as it was difficult to entirely change the existing framework and to keep track on references.
…
<== documentation - 2/2 2020-08 (2) 2020-09 (1) 2021-01 (1) 2022-03 (1) 2023-05 (1)