From de98f083ff898158ea5c7d5599c22fcc608689f5 Mon Sep 17 00:00:00 2001
From: Steve Piercy <web@stevepiercy.com>
Date: Mon, 18 Nov 2024 16:11:54 -0800
Subject: [PATCH] Add support for sphinxcontrib-youtube and alt tags for videos
 (#6486)

---
 docs/source/conf.py                          | 1 +
 docs/source/tutorials/index.md               | 5 ++++-
 docs/source/user-manual/copy-paste-blocks.md | 2 ++
 packages/volto/news/6486.documentation       | 1 +
 requirements-docs.txt                        | 1 +
 5 files changed, 9 insertions(+), 1 deletion(-)
 create mode 100644 packages/volto/news/6486.documentation

diff --git a/docs/source/conf.py b/docs/source/conf.py
index 8619c2a428..f2d9aed9a7 100644
--- 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
index 67360cb366..8a473b16ca 100644
--- 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
index f15f3b1616..4fbc68e769 100644
--- 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
new file mode 100644
index 0000000000..66b5bd33a6
--- /dev/null
+++ 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
index 406c7f60cd..3dad3b11f9 100644
--- 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