kotlingrad icon indicating copy to clipboard operation
kotlingrad copied to clipboard

Formulas and diagrams in README not visible in dark mode

Open aSemy opened this issue 3 years ago • 0 comments

Hi 👋

I've got GitHub dark mode enabled.

When I look at the README, I'm not able to view the diagrams and formulas.

  • The formulas in the 'Math' column are black text on a transparent background image
  • I can see the blue/red arrows in the dataflow graph, but the text is also black image

When I look at the dataflow graphs directly, because they are SVGs GitHub renders them with a transparent background

image

Suggestions

SVG Images

Here are my suggestions for improving the visibility of the SVG images:

Formulas

For the formulas I see that they are images that are referenced using the GitHub API

https://github.com/breandan/kotlingrad/blob/0.4.5/README.md?plain=1#L113

https://github.com/breandan/kotlingrad/blob/0.4.5/README.md?plain=1#L134

Perhaps the GitHub syntax might support dark mode? https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/writing-mathematical-expressions

Here are some examples:

Inline expression (using dollars): $\mathbf{A}(\mathbf{B})$

Block using $$:

$$\mathbf{A}(\mathbf{B})$$

Block using code fence math code fence block:

\mathbf{A}(\mathbf{B})

They look good to me! Screenshot of the above example

image

aSemy avatar Dec 22 '22 11:12 aSemy