SVGS that are autogenerated for the ES|QL docs are being improperly displayed

[georgewallace]

Describe the bug

SVGs from the ES|QL sections are showing up all black. . They are generated by the following code. https://github.com/elastic/elasticsearch/blob/main/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/RailRoadDiagram.java.

Nik Everett thinks that the following is what might be breaking it. https://github.com/elastic/elasticsearch/blob/main/x-pack/plugin/esql/src/test/java/org/elasticsearch/xpack/esql/expression/function/RailRoadDiagram.java#L129.

He states that "we need the font during the build because we need to size the image. which is annoying, but it's thing"

Expected behavior

We expect the SVGS to show like:

Steps to reproduce

locally build the ES|QL docs and view any of the functions or commands pages.

Tooling

• docs-builder
• migration tooling
• I'm not sure

[georgewallace]

On the existing docs site it looks like we don't embed the SVGs and we style the class appropriately.

[bmorelli25]

Example:

• Legacy docs: https://www.elastic.co/guide/en/elasticsearch/reference/current/esql-functions-operators.html#esql-avg
• V3 docs: https://docs-v3-preview.elastic.dev/elastic/asciidocalypse/tree/main/elasticsearch/docs/reference/query-languages/esql-functions-operators
• SVG w/out CSS: https://github.com/elastic/elasticsearch/blob/8.17/docs/reference/esql/functions/signature/avg.svg

[bmorelli25]

Could these be mermaid instead?

[bmorelli25]

Potentially fixed by https://github.com/elastic/asciidocalypse/pull/109