Add support for sphinxcontrib-youtube and alt tags for videos (#6486)

plone · Nov 19, 2024 · de98f08 · de98f08
1 parent 8ea1215
commit de98f08
Show file tree

Hide file tree

Showing 5 changed files with 9 additions and 1 deletion.
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -63,6 +63,7 @@
     "sphinx_copybutton",
     "sphinx_examples",
     "sphinxcontrib.video",
+    "sphinxcontrib.youtube",
     "sphinxext.opengraph",
 ]
 

diff --git a/docs/source/tutorials/index.md b/docs/source/tutorials/index.md
@@ -30,7 +30,10 @@ On the [Plone Training website](https://training.plone.org), you'll find Volto-d
 
 You can watch the talk during the World Plone Day 2021:
 
-<iframe width="560" height="315" src="https://www.youtube.com/embed/kHec4MXH8vo" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
+```{youtube} kHec4MXH8vo
+:privacy_mode:
+:width: 100%
+```
 
 
 ## Presentations at Plone Conferences (PloneConf) and other events

diff --git a/docs/source/user-manual/copy-paste-blocks.md b/docs/source/user-manual/copy-paste-blocks.md
@@ -28,6 +28,7 @@ This will select all the blocks between the start and end blocks, allowing you t
 
 ````{only} not text
 ```{video} ../_static/user-manual/blocks/block-copy-cut.mp4
+:alt: Copy or cut a block in Volto
 ```
 ````
 
@@ -44,5 +45,6 @@ Also if you hold the {kbd}`ctrl` key while clicking the paste button, it keeps t
 
 ````{only} not text
 ```{video} ../_static/user-manual/blocks/block-paste.mp4
+:alt: Paste a block in Volto
 ```
 ````
diff --git a/packages/volto/news/6486.documentation b/packages/volto/news/6486.documentation
@@ -0,0 +1 @@
+Add support for sphinxcontrib-youtube. @stevepiercy
diff --git a/requirements-docs.txt b/requirements-docs.txt
@@ -6,5 +6,6 @@ sphinx-autobuild
 sphinx-copybutton
 sphinx-examples
 sphinxcontrib-video
+sphinxcontrib-youtube
 sphinxext-opengraph
 vale
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Add support for sphinxcontrib-youtube. @stevepiercy