customize equations

[12rambau]

Fix #699

I force the equation wrapper to fit the article width. I needed to tweek the display of equations number and link to display them on the same line.

The math element is done in the following order:

• number
• link
• equation

Unless we use obsolute positionning (what was previously done) the number need to be displayed first. IMO that's not disturbing at all but if people are used to scientific publication they will surely complain. Let me know

[choldgraf]

I think that this would get the numbers back on the right side, would that work? I think folks will definitely prefer equation numbers on the right (it also looks better with the hyperlink that way)

[choldgraf]

Also at least on my phone, the header button still goes off to the right. This is because the hyperlink in this text:

presented here are just a sample of the many reStructuredText Directives. For others, please see: http://docutils.sourceforge.net/docs/ref/rst/directives.html.

spills off to the right of the page. So it seems like it isn't just equations?

[12rambau]

So it seems like it isn't just equations?

In my case I see the btn even though article is more that 100% width:

That being said I don't think we want to cut long link names, instead, people should wrap them in readable links. Let me do it in our docs

[choldgraf]

So for some reason, I can only replicate this on my computer when I do two things:

1. Make the screen width narrow
2. Set the "device type" to "mobile"

Here's an example:

[12rambau]

I'm unable to reproduce it on Safari or my iphone, and I'm not sure we want to go down every edge case in this PR. On the other hand the main issue is not being able to see the full navbar and specifically the menu btn. In my last commit I forced the max-width of the navbar to never exceed the width of the viewport. Could you test it and let me know ?

If it works I would say we merge this one and deal with the edge cases in other issues.

[choldgraf]

That seems to have worked! This LGTM

[larsoner]

I think this PR (and specifically the display:flex made inline rendered objects display on a new line:

https://github.com/pydata/pydata-sphinx-theme/blame/4791bd83eb52a12c08f1d81390f7ab3e8bc2ac97/src/pydata_sphinx_theme/assets/styles/content/_math.scss#L6

For example https://mne.tools/dev/overview/implementation.html#the-forward-solution produces something wrong

Removing the display: flex from CSS fixes it

@12rambau any ideas on a correct fix?

[drammock]

is there a way to target just display math and not inline math? Looking at the browser inspector, it looks like display math is a div and inline is a span... but the first child mjx-container has a display="true" attribute that maybe is what we want to detect?

[choldgraf]

I opened an issue to track this one! #809