Re: [Docutils-develop] Patches for html5_polyglot video support

[Guenter M. <mi...@us...>]

Dear Agata,

On 2022-05-24, Agathe Porte wrote:

>> As discussed in docutils-users, please find attached two patches to 
>> improve docutils video support. Please let me know when they are 
>> merged 

Before the next changes/improvements to Docutils "video" support, I'd
like to have a discussion on the goals and means in order to get
a sound and stable behaviour.

* Do we need dedicated support for video content 
  in Docutils,
  in reStructuredText?
  
  As the only output format that can handle video is HTML5, it may
  suffice to use ``.. raw:: html`` blocks instead of re-creating
  a complex interface for the various use cases and user preferences.
  
* How do we want to represent "video" elements and options:

  - in the document tree (<video> node or <image> node, ...)
  - in reStructuredText (``.. video::`` or ``.. image`` directive)
    if ``.. video::`` then also ``vidoe-figure``?
    
* Which "bells and whistles" shall be accessible from reStructuredText?
  What is appropriate for a "lightwight markup language"?
  How do we document/teach the feature(s)?
      

>> (I see last revision is from 2021-11-23). 

This is the last release (0.18.1).
The last revision is from 2022-05-30
(cf. https://sourceforge.net/p/docutils/code/HEAD/tree/

When working *on* Docutils, I recommend an `editable install`__ from the
repository__.

__ https://docutils.sourceforge.io/docs/dev/repository.html#editable-installs
__ https://docutils.sourceforge.io/docs/dev/repository.html#checking-out-the-repository


Thank you for sharing,

Günter