feature: add audio and video media extension

Signed-off-by: squidfunk <martin.donath@squidfunk.com>

python/tests/integration/test_api_generators.py

@@ -482,8 +482,12 @@ def test_serve_discovers_added_renamed_and_removed_modules(
         def wait_for(condition: Callable[[], bool]) -> None:
             deadline = time.monotonic() + 15
             while time.monotonic() < deadline:
-                if condition():
-                    return
+                try:
+                    if condition():
+                        return
+                except FileNotFoundError:
+                    # A rebuild can remove output between checking and reading.
+                    pass
                 if process.poll() is not None:
                     break
                 time.sleep(0.02)

python/tests/integration/test_media.py

@@ -0,0 +1,129 @@
+# Copyright (c) 2025-2026 Zensical and contributors
+#
+# SPDX-License-Identifier: MIT
+# All contributions are certified under the DCO
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to
+# deal in the Software without restriction, including without limitation the
+# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+# sell copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+# IN THE SOFTWARE.
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from bs4 import BeautifulSoup
+
+import zensical
+
+if TYPE_CHECKING:
+    from pathlib import Path
+
+
+_BUILD_OPTS: dict[str, Any] = {"clean": False, "strict": False}
+
+
+def test_both_legacy_plugins_render_through_media_extension(
+    tmp_path: Path,
+) -> None:
+    docs = tmp_path / "docs"
+    docs.mkdir()
+    (docs / "index.md").write_text(
+        "# Media\n\n"
+        "![type:video](https://example.com/movie.ogg)\n\n"
+        "![type:audio](sound.mp3)\n",
+        encoding="utf-8",
+    )
+    config = tmp_path / "mkdocs.yml"
+    config.write_text(
+        "site_name: Media\n"
+        "plugins:\n"
+        "  - mkdocs-video:\n"
+        "      is_video: true\n"
+        "      video_type: ogg\n"
+        "  - mkdocs-audio:\n"
+        "      audio_controls: false\n",
+        encoding="utf-8",
+    )
+
+    zensical.build(str(config), _BUILD_OPTS)
+
+    html = (tmp_path / "site" / "index.html").read_text(encoding="utf-8")
+    page = BeautifulSoup(html, "html.parser")
+    video = page.select_one(".video-container video")
+    audio = page.select_one(".audio-container audio")
+    assert video is not None
+    assert audio is not None
+    assert video.source is not None
+    assert audio.source is not None
+    assert video.source["src"] == "https://example.com/movie.ogg"
+    assert video.source["type"] == "video/ogg"
+    assert audio.source["src"] == "sound.mp3"
+    assert not audio.has_attr("controls")
+
+
+def test_native_media_config_enables_audio_independently(
+    tmp_path: Path,
+) -> None:
+    docs = tmp_path / "docs"
+    docs.mkdir()
+    (docs / "index.md").write_text(
+        "# Media\n\n![type:video](movie.mp4)\n\n![type:audio](sound.mp3)\n",
+        encoding="utf-8",
+    )
+    config = tmp_path / "zensical.toml"
+    config.write_text(
+        "[project]\n"
+        'site_name = "Media"\n'
+        '[project.markdown_extensions."zensical.extensions.media".video]\n'
+        "enabled = false\n"
+        '[project.markdown_extensions."zensical.extensions.media".audio]\n'
+        "enabled = true\n",
+        encoding="utf-8",
+    )
+
+    zensical.build(str(config), _BUILD_OPTS)
+
+    html = (tmp_path / "site" / "index.html").read_text(encoding="utf-8")
+    page = BeautifulSoup(html, "html.parser")
+    assert page.select_one(".audio-container audio") is not None
+    assert page.select_one(".video-container") is None
+    assert page.select_one('img[alt="type:video"]') is not None
+
+
+def test_shared_marker_uses_legacy_plugin_order(tmp_path: Path) -> None:
+    docs = tmp_path / "docs"
+    docs.mkdir()
+    (docs / "index.md").write_text(
+        "# Media\n\n![shared](sound.mp3)\n", encoding="utf-8"
+    )
+    config = tmp_path / "mkdocs.yml"
+    config.write_text(
+        "site_name: Media\n"
+        "plugins:\n"
+        "  - mkdocs-audio:\n"
+        "      mark: shared\n"
+        "  - mkdocs-video:\n"
+        "      mark: shared\n",
+        encoding="utf-8",
+    )
+
+    zensical.build(str(config), _BUILD_OPTS)
+
+    html = (tmp_path / "site" / "index.html").read_text(encoding="utf-8")
+    page = BeautifulSoup(html, "html.parser")
+    assert page.select_one(".audio-container audio") is not None
+    assert page.select_one(".video-container") is None