Skip to content

Conversation

@furqan463
Copy link

@furqan463 furqan463 commented Jan 28, 2026

Fixes issue: #1278

Changes proposed in this PR include:

multi-line equations inside $$ delimiter do not render properly. I've replaced them with multiple $$ math blocks.

Checks

  • review other pages.

Signed-off-by: furqan463 <ahmadfurqanc@gmail.com>
@furqan463
Copy link
Author

I could fix equation rendering in components.md, but I've also observed the same issue in calculations.md with multi-line arrays inside $$ delimiter. However, I'm unable to find a solution for that.

@nitbharambe nitbharambe added the bug Something isn't working label Jan 29, 2026
@nitbharambe
Copy link
Member

There are errors in other files too like LU solver and in calculations.

Initial idea about the ticket was to find out a way which does not require modifying each equation with such issue. Maybe there is a way we can resolve this at sphinx or myst or mathjax side directly.

@furqan463
Copy link
Author

There are errors in other files too like LU solver and in calculations.

Initial idea about the ticket was to find out a way which does not require modifying each equation with such issue. Maybe there is a way we can resolve this at sphinx or myst or mathjax side directly.

I had the same intention but couldn't find a way.

Comment on lines 1388 to 1402
$$
\begin{eqnarray}
& P_{\text{gen}} = P_{\text{specified}} \\
& Q_{\text{gen}} = Q_{\text{min}} \text{ or } Q_{\text{max}} \\
& P_{\text{gen}} = P_{\text{specified}}
\end{eqnarray}
$$
$$
\begin{eqnarray}
& Q_{\text{gen}} = Q_{\text{min}} \text{ or } Q_{\text{max}}
\end{eqnarray}
$$
$$
\begin{eqnarray}
& |U_{\text{node}}| = \text{calculated from power flow}
\end{eqnarray}
$$
Copy link
Member

@nitbharambe nitbharambe Jan 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you try this instead?

$$\begin{eqnarray}
      & P_{\text{gen}} = P_{\text{specified}} \\
      & Q_{\text{gen}} = Q_{\text{min}} \text{ or } Q_{\text{max}} \\
      & |U_{\text{node}}| = \text{calculated from power flow}
  \end{eqnarray}$$

See https://stackoverflow.com/questions/18860693/mathjax-multi-line-equation-rendering-issue

(Edit: It also suggests changing to align instead of eqnarray though)

Copy link
Author

@furqan463 furqan463 Jan 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you try this instead?

$$\begin{eqnarray}
      & P_{\text{gen}} = P_{\text{specified}} \\
      & Q_{\text{gen}} = Q_{\text{min}} \text{ or } Q_{\text{max}} \\
      & |U_{\text{node}}| = \text{calculated from power flow}
  \end{eqnarray}$$

See https://stackoverflow.com/questions/18860693/mathjax-multi-line-equation-rendering-issue

(Edit: It also suggests changing to align instead of eqnarray though)

This makes no difference. align* works after building the document, however live preview while editing is not available.

Signed-off-by: furqan463 <ahmadfurqanc@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants