In Literate-generated tutorials the input code and the output have the same style

[CarloLucibello]

In tutorials like
https://juliagraphs.org/GraphNeuralNetworks.jl/docs/GraphNeuralNetworks.jl/dev/tutorials/gnn_intro/
the input code and the output both have a grey background and are not distinguishable.

Normally the output would have a white background instead, see
https://fredrikekre.github.io/Literate.jl/v2/generated/example/

I have no clue why this happens, we are not using any custom style in Documeter.

cc @aurorarossi

[aurorarossi]

I found that the appearance of the generated Markdown file depends on when the evaluation occurs. As we were already generating the Markdown output locally with cell evaluation enabled, Documenter renders it using a single color. However, if we generate the Markdown so that Documenter evaluates the cells, different colors are used.

I agree that having two colors is better, but making Documenter evaluate the tutorials every time is inefficient—especially for temporal ones(perhaps a better solution would be to create lighter temporal tutorials)

There is already an open issue fredrikekre/Literate.jl#178 on Literate and also Documenter, but it doesn’t seem to be receiving attention.

[CarloLucibello]

One solution is to remove Literate.jl entirely and use Documenter's @example block: https://documenter.juliadocs.org/stable/man/syntax/#reference-at-example
If we do this, the documentation will be generated entirely by CI, so tutorials cannot take too long to execute.