Fix documentation

1. Important fix

Equations on the current website are broken, e.g. http://ift.pages.mpcdf.de/nifty/user/volume.html but by commenting out the sphinx.ext.imgmath' extension in the conf.py this is resolved. (at least on my machine) @parras : was there are specific reason for rendering the equations to images. If not and if it generally works without this line I would stick with this fix.

2. other fixes:

found some broken links to the ducc repository and matched some style.

@mtr , @gedenhof : I marked this MR as Draft because I'm not sure if we need further adjustment in the first fix.

requested review from @mtr

assigned to @parras

I think the reason for building images was to avoid a dependence on Cloudflare scripts. If at all possible, I'd still favour a standalone solution, but I don't know an imediate fix...

Since they introduced "dark-mode" we'd need to generate two sets of images an then select respectively the matching image, right?

Another solution would be to disable dark-mode within the conf.py. (One can set the default to the light mode and remove the switch to the dark mode)

But still I don't know why the rendering doesn't work at all...

So, the redering works, but the directory which the images are saved in is not the same as the one the links in the text are pointing at. I also found the Issue on Sphinx https://github.com/sphinx-doc/sphinx/issues/10944

Unfortunately the rendered equations are also right aligned, which is not so pretty....

added 2 commits

• 211ee7e5 - change language to English
• d2dfc909 - render as images in html as base64

Compare with previous version

as far as I understand the math expressions are now rendered as base64 images. Is this fine for everyone? @mtr, @gedenhof ?

This would enable functionality again. In a next step I'd think about switching off the darkmode..

changed the description

as far as I understand the math expressions are now rendered as base64 images.

What does this mean? That the images are inlined into the HTML as base64-encoded blobs? If so, that sounds fine to me.

Nevermind, found the answer :)

I'm happy with this.

approved this merge request

added 1 commit

• 77def031 - default to light-mode

Compare with previous version

added 2 commits

• f81308ef - changed gitlab symbol to fontawesome
• f0b13f2a - switch off the switch-off

Compare with previous version

resolved all threads

approved this merge request

marked this merge request as ready

I leave clicking the merge button to you, @mtr .

enabled an automatic merge when the pipeline for f0b13f2a succeeds

merged

mentioned in commit 9e496ee1

mentioned in commit 2ed1818c

mentioned in merge request !815 (merged)