From 655403c1a52a3f91084f6f0342b07b55591b536d Mon Sep 17 00:00:00 2001
From: robxnano <89391914+robxnano@users.noreply.github.com>
Date: Sat, 21 Oct 2023 17:34:15 +0100
Subject: [PATCH] docs: Add instructions for Mageia

---
 .../en/latest/developer/build-linux.markdown  |  1 +
 .../install-dependencies-mageia.markdown      | 85 +++++++++++++++++++
 .../docs/en/latest/table-of-contents.markdown |  2 +-
 3 files changed, 87 insertions(+), 1 deletion(-)
 create mode 100644 source/docs/en/latest/developer/install-dependencies-mageia.markdown

diff --git a/source/docs/en/latest/developer/build-linux.markdown b/source/docs/en/latest/developer/build-linux.markdown
index 72caab61..565c2540 100644
--- a/source/docs/en/latest/developer/build-linux.markdown
+++ b/source/docs/en/latest/developer/build-linux.markdown
@@ -29,6 +29,7 @@ Dependency installation instructions are available for the following distributio
 - [Debian](install-dependencies-debian.html)
 - [Fedora](install-dependencies-fedora.html)
 - [Gentoo](install-dependencies-gentoo.html)
+- [Mageia](install-dependencies-mageia.html)
 - [Ubuntu](install-dependencies-ubuntu.html)
 - [Void](install-dependencies-void.html)
 
diff --git a/source/docs/en/latest/developer/install-dependencies-mageia.markdown b/source/docs/en/latest/developer/install-dependencies-mageia.markdown
new file mode 100644
index 00000000..d09b16c2
--- /dev/null
+++ b/source/docs/en/latest/developer/install-dependencies-mageia.markdown
@@ -0,0 +1,85 @@
+---
+Type:            article
+Title:           Installing dependencies on Mageia
+Project:         HandBrake
+Project_URL:     https://handbrake.fr/
+Project_Version: Latest
+Language:        English
+Language_Code:   en
+Authors:         [ Rob (robxnano) ]
+Copyright:       2023 HandBrake Team
+License:         Creative Commons Attribution-ShareAlike 4.0 International
+License_Abbr:    CC BY-SA 4.0
+License_URL:     https://handbrake.fr/docs/license.html
+---
+
+Installing dependencies on Mageia
+=================================
+
+The following instructions are for [Mageia](https://mageia.org) 9.
+
+Basic requirements to run commands:
+
+- sudo (for normal user accounts)
+
+Dependencies:
+
+- automake
+- autoconf
+- cmake
+- dnf-plugins-core
+- gcc-c++
+- git
+- jansson-devel
+- lame-devel
+- libass-devel
+- libogg-devel
+- libtheora-devel
+- libtool
+- libvorbis-devel
+- libvpx-devel
+- m4
+- make
+- meson
+- nasm
+- ninja
+- numa-devel
+- opus-devel
+- patch
+- speex-devel
+
+Additional dependencies not available in the base repository:
+
+- x264-devel [mageia-tainted]
+
+Intel Quick Sync Video dependencies (optional):
+
+- libva-devel
+- libdrm-devel
+
+Graphical interface dependencies:
+
+- desktop-file-utils
+- gtk+3.0-devel
+- gstreamer1.0-libav
+- gstreamer1.0-plugins-good
+- gstreamer1.0-plugins-base-devel
+
+Install dependencies.
+
+    sudo dnf install automake autoconf cmake dnf-plugins-core gcc-c++ git jansson-devel lame-devel libass-devel libogg-devel libtheora-devel libtool libvorbis-devel libvpx-devel m4 make meson nasm ninja numa-devel opus-devel patch speex-devel
+
+Enable the Mageia Tainted repository and install related additional dependencies.
+
+    sudo dnf config-manager --enable mageia-x86_64-tainted updates-x86_64-tainted
+    sudo dnf install x264-devel
+
+To build with Intel Quick Sync Video support, install the QSV dependencies.
+
+    sudo dnf install libva-devel libdrm-devel
+
+To build the GTK [GUI](abbr:Graphical User Interface), install the graphical interface dependencies.
+
+    sudo dnf install desktop-file-utils gtk+3.0-devel gstreamer1.0-libav gstreamer1.0-plugins-good gstreamer1.0-plugins-base-devel
+
+Mageia is now prepared to build HandBrake. See [Building HandBrake for Linux](build-linux.html) for further instructions.
diff --git a/source/docs/en/latest/table-of-contents.markdown b/source/docs/en/latest/table-of-contents.markdown
index a22f7234..22522769 100644
--- a/source/docs/en/latest/table-of-contents.markdown
+++ b/source/docs/en/latest/table-of-contents.markdown
@@ -162,7 +162,7 @@ Table of contents
   - [Building HandBrake for BSD](developer/build-bsd.html)
     - Installing dependencies on [FreeBSD](developer/install-dependencies-freebsd.html) / [NetBSD](developer/install-dependencies-netbsd.html) / [OpenBSD](developer/install-dependencies-openbsd.html)
   - [Building HandBrake for Linux](developer/build-linux.html)
-    - Installing dependencies on [Alpine](developer/install-dependencies-alpine.html) / [Arch](developer/install-dependencies-arch.html) / [CentOS](developer/install-dependencies-centos.html) / [Clear](developer/install-dependencies-clear.html) / [Debian](developer/install-dependencies-debian.html) / [Fedora](developer/install-dependencies-fedora.html) / [Gentoo](developer/install-dependencies-gentoo.html) / [Ubuntu](developer/install-dependencies-ubuntu.html) / [Void](developer/install-dependencies-void.html)
+    - Installing dependencies on [Alpine](developer/install-dependencies-alpine.html) / [Arch](developer/install-dependencies-arch.html) / [CentOS](developer/install-dependencies-centos.html) / [Clear](developer/install-dependencies-clear.html) / [Debian](developer/install-dependencies-debian.html) / [Fedora](developer/install-dependencies-fedora.html) / [Gentoo](developer/install-dependencies-gentoo.html) / [Mageia](developer/install-dependencies-mageia.html) / [Ubuntu](developer/install-dependencies-ubuntu.html) / [Void](developer/install-dependencies-void.html)
   - [Building HandBrake for Mac](developer/build-mac.html)
   - [Building HandBrake for Windows](developer/build-windows.html)
 - Packaging HandBrake