docutils-develop

[Docutils-develop] Patches for html5_polyglot video support

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

Hi,

As discussed in docutils-users, please find attached two patches to 
improve docutils video support. Please let me know when they are merged 
(I see last revision is from 2021-11-23). I will send other patches to 
improve video support further while trying to keep the "image" node.

Bests,

Agata.

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

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

Find attached missing patches.

24/05/2022 18:20, Agathe Porte :
> Hi,
>
> As discussed in docutils-users, please find attached two patches to 
> improve docutils video support. Please let me know when they are 
> merged (I see last revision is from 2021-11-23). I will send other 
> patches to improve video support further while trying to keep the 
> "image" node.
>
> Bests,
>
> Agata.

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

[Adam T. <aat...@ou...>]

Agata,

Your patches didn't apply, attached is rebased on r9058. I also reworked your second patch a little.

Please can you add some tests for the new behaviour?

A

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

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

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

Attached are the patches I forgot to join.

24/05/2022 18:20, Agathe Porte :
> Hi,
>
> As discussed in docutils-users, please find attached two patches to 
> improve docutils video support. Please let me know when they are 
> merged (I see last revision is from 2021-11-23). I will send other 
> patches to improve video support further while trying to keep the 
> "image" node.
>
> Bests,
>
> Agata.
>