From b5c582a3f3d792f32234e687b37a4acb5493b9b8 Mon Sep 17 00:00:00 2001
From: Hari Rana <theevilskeleton@riseup.net>
Date: Wed, 28 Jun 2023 21:34:49 -0400
Subject: [PATCH] a11y: Prevent screen readers from reading twice

This is a quick and dirty hack to prevent screen readers from reading
the content inside the `<figure>` tag twice.

Credit to @jcsteh (Jamie) at
https://matrix.to/#/!jmuErVonajdNMbgdeY:mozilla.org/$Esj2fvpJ5e2cJPZKQrCyzPBS8lnL0ZQc25vMMvW4lAM?via=mozilla.org&via=matrix.org&via=tchncs.de
---
 src/_includes/image.html | 6 +-----
 src/_includes/video.html | 5 +++--
 2 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/src/_includes/image.html b/src/_includes/image.html
index f4f8327a9b..df8162406a 100644
--- a/src/_includes/image.html
+++ b/src/_includes/image.html
@@ -1,8 +1,4 @@
-{% if include.caption != nil %}
-<figure>
-{% else %}
-<figure aria-hidden="true">
-{% endif %}
+<figure aria-label="&nbsp;">
   <img src="{{ include.url }}"
     alt=""/>
   <figcaption>{{ include.caption | markdownify }}</figcaption>
diff --git a/src/_includes/video.html b/src/_includes/video.html
index dde17a3e41..ef97746d9e 100644
--- a/src/_includes/video.html
+++ b/src/_includes/video.html
@@ -1,5 +1,6 @@
-<figure>
-  <video src="{{ include.url }}"
+<figure aria-label="&nbsp;">
+  <video aria-hidden="true"
+    src="{{ include.url }}"
     controls="controls"
     alt="">
   </video>