Video embeddings have broken layout and missing controls by default

[michaelosthege]

Describe the problem/need and solution

Context In some documentation files (written in Markdown) we embedded videos showing how to do certain things.

The videos are shown when the Markdown is viewed on GitLab/GitHub, which is nice.

Now we want to render our docs with Sphinx and extensions = ["myst_parser"] so we can include the existing Markdown content.

Problem The videos become HTML <video> tags, but by default the layout is crap and no controls are shown to start playback.

From this Markdown:

This video doesn't render in the VS Code preview, but on GitLab:

![](videotest.mp4)

This renders in the VS Code preview, and on GitLab, but the Sphinx-generated HTML doesn't get the filepath updated to `src="_images/videotest.mp4"`:

<video src="videotest.mp4" style="width:100%" controls></video>

We get the following HTML:

<p>This video doesn’t render in the VS Code preview, but on GitLab:</p>
<p><video src="_images/videotest.mp4" title=""><a href="_images/videotest.mp4"></a></video></p>
<p>This renders in the VS Code preview, and on GitLab, but the Sphinx-generated HTML doesn’t get the filepath updated to <code class="docutils literal notranslate"><span class="pre">src="_images/videotest.mp4"</span></code>:</p>
<p><video src="videotest.mp4" style="width:100%" controls=""></video></p>
</section>

Solution The generated video tags should include style="width:100%" controls="" by default.

It's probably a tiny change, but I have no idea where.

Benefit Video embeddings from local files would show up in a nice layout right away.

Guide for implementation

No response

Tasks and updates

No response

[welcome[bot]]

Thanks for opening your first issue here! Engagement like this is essential for open source projects! :hugs:
If you haven't done so already, check out EBP's Code of Conduct. Also, please try to follow the issue template as it helps other community members to contribute more effectively.
If your issue is a feature request, others may react to it, to raise its prominence (see Feature Voting).
Welcome to the EBP community! :tada:

[chrisjsewell]

Heya, yeh it is certainly possible, the pain point is that I don't believe docutils/sphinx have any "standard" node for videos, so we can't just generate that and "hand it off" for those do deal with the rendering etc (as for images)

[michaelosthege]

But somewhere there's already a video tag being created. Where is that in which codebase and can't this place be modified accordingly?

The style could be set via CSS, but the attribute can't.