Merge branch 'master' into relative-width

.pre-commit-config.yaml

@@ -5,20 +5,20 @@ repos:
     rev: "22.3.0"
     hooks:
       - id: black
-        stages: [commit]
+        stages: [pre-commit]
 
   - repo: "https://github.com/pre-commit/mirrors-prettier"
     rev: "v2.7.1"
     hooks:
       - id: prettier
-        stages: [commit]
+        stages: [pre-commit]
         exclude: test_build\/.+\.html$
 
   - repo: https://github.com/charliermarsh/ruff-pre-commit
     rev: "v0.0.215"
     hooks:
       - id: ruff
-        stages: [commit]
+        stages: [pre-commit]
 
   - repo: "https://github.com/commitizen-tools/commitizen"
     rev: "v2.18.0"

docs/quickstart.rst

@@ -57,6 +57,7 @@ the video directive supports all the optional attributes from the html tag as su
     ``:preload:``,``str``,"Specifies if and how the author thinks the video should be loaded when the page loads. Can only be values from ``['auto', 'metadata', 'none']``"
     ``:width:``,``int``\ [``%``\ ], Sets the width of the video player in pixels or relative to the page's width if a percentage
     ``:class:``,``str``, Set extra class to the video html tag
+    ``:playsinline:``,,Specifies that the video will play in-line (instead of full-screen) on small devices.
 
 They can be used as any directive option:
 
@@ -65,6 +66,7 @@ They can be used as any directive option:
     .. video:: _static/video.mp4
         :nocontrols:
         :autoplay:
+        :playsinline:
         :muted:
         :loop:
         :poster: _static/image.png
@@ -73,9 +75,11 @@ They can be used as any directive option:
 .. video:: _static/video.mp4
     :nocontrols:
     :autoplay:
+    :playsinline:
     :muted:
     :loop:
     :width: 100%
+    :poster: _static/image.png
 
 And using the ``:class:`` parameter in combination with custom css, you can change the display of the html ``<video>`` tag:
 

sphinxcontrib/video/__init__.py

@@ -97,6 +97,7 @@ class Video(SphinxDirective):
         "preload": directives.unchanged,
         "width": directives.unchanged,
         "class": directives.unchanged,
+        "playsinline": directives.flag,
     }
 
     def run(self) -> List[video_node]:
@@ -160,6 +161,7 @@ def run(self) -> List[video_node]:
                 preload=preload,
                 width=width,
                 klass=self.options.get("class", ""),
+                playsinline="playsinline" in self.options,
             )
         ]