Re: [Docutils-users] <img> instead of <video> tag inserted for image:: foo.mp4

[Agathe P. <mic...@mi...>]

Hi,

29/04/2022 10:54, Guenter Milde :
>> However, according to the documentation [1], this should export a
>> <video> tag instead of a <img> tag given that the file extension is ".mp4".
> It seems that Pelican (at least with your configuration) uses the
> traditional HTML4 writer for HTML export.
>
> Only the `HTML5 writer`_ supports video. Finding out how/whether Pelican
> can be configured to use the HTML5 writer is left as an exercise for the
> reader.
>
I was able to configure pelican to use html5_polyglot using 
rst_with_html5 Pelican plugin [1]. As I dig further and further into 
html5_polyglot, I am sad to see that <video> has no first class support 
in reStructuredText. I did a local patch to add more attributes to the 
renderer, then another patch for allowing alternative source format, but 
I think that a new video class should be added instead of hacking the 
image class so deeply.

This has been done in a plugin for sphinx [2]: full support of a 
distinct video node that can support extra attributes. One quirk of 
using "classes" for detecting {loop,controls,autoplay} is that the video 
keeps the "loop" CSS style class, which seems not useful and can 
conflict with CSS classes.

I was not able to see prior discussion for proper video support in 
docutils using a search engine. Please enlighten my light if anything 
seems wrong with this proposal. I can volonteer to implement this 
feature and document it for docutils. I think it would be better than 
the current two alternatives: using out-of-tree plugins or hacking image 
nodes.

Bests,

Agata

[1] https://github.com/bekcpear/pelican-rst_with_html5

[2] 
https://github.com/sphinx-contrib/video/blob/master/sphinxcontrib/video.py