feat: add xdelta guide (#225)

* feat: create xdelta guide

* feat: add page link to `tutorials/xdelta.md`

docs/advanced/release-standards.md

@@ -457,7 +457,7 @@ Anime.Name.2022.S01.E12-E23.1080p.BluRay.FLAC2.0.H.265-Group | Alternate Name
 
 ## Patches/Revisions
 
-- For making patches, use [dan0v/xdelta3-cross-gui](https://github.com/dan0v/xdelta3-cross-gui).
+- For making patches, see the [xDelta guide](/tutorials/xdelta).
 - Append `v2` at the end of `SXXEYY`, e.g, `S01E01v2`.
 - Do **NOT** alter episode files that don't need a revision.
 - This will also change the `CRC32` value of the file.

docs/resources/tutorials.md

@@ -14,6 +14,7 @@ order: -3
 - [How To Use IRC/XDCC](/tutorials/irc)
 - [Manage LN/WN using Calibre](/tutorials/calibre)
 - [mpv Setup and Config](/tutorials/mpv)
+- [Patching files with xDelta](/tutorials/xdelta)
 - [Plex Player Modding](/tutorials/plex)
 - [Propolis](/tutorials/propolis)
 - [qBittorrent](/tutorials/qbittorrent)

docs/tutorials/xdelta.md

@@ -0,0 +1,114 @@
+---
+label: xDelta
+description: Learn how to create and use patch files to fix media
+---
+
+# xDelta
+
+An xDelta patch contains difference data between two separate versions of a file.
+
+xDelta patches are commonly used to correct minor issues in the original file without requiring the user to download the new file entirely, such as amending minor grammatical errors in subtitles or correcting a couple of typesettings in anime releases.
+
+This guide will show you how to use [xDelta3 Cross GUI](https://github.com/dan0v/xdelta3-cross-gui), a tool for creating and using `xdelta3` patches.
+
+## Installation
+
++++ Windows
+
+1. Download the latest release of [xDelta3 Cross GUI](https://github.com/dan0v/xdelta3-cross-gui/releases). *For Windows, this will be `xdelta3-cross-gui_win_x86.zip`*
+
+2. Extract the `.zip` archive's contents. In the destination folder, find and launch `xdelta3_cross_gui.exe`
+
++++ macOS
+
+1. Download the latest release of [xDelta3 Cross GUI](https://github.com/dan0v/xdelta3-cross-gui/releases). *For macOS, this will be `xdelta3-cross-gui_macOS_x86_64.tar.gz`*
+
+2. Extract the `.tar.gz` archive's contents. In the destination folder, find and launch `xDelta3 Cross GUI.app`
+
++++ Linux
+
+1. Download the latest release of [xDelta3 Cross GUI](https://github.com/dan0v/xdelta3-cross-gui/releases). *For Linux, this will be `xdelta3-cross-gui_linux_AppImage_x86_64.tar.gz`*
+
+2. Extract the `.tar.gz` archive's contents. In the destination folder, find and launch `xDelta3_Cross_Gui-x86_64.AppImage`
+
++++
+
+## Creating Patches
+
+### Prerequisities
+
+To create an xDelta3 patch, you will need two files: the original version to be changed and the new version including your fixes.
+
+Your patched version should be named properly to distinguish it from the original. For anime, version identifiers usually go after the season/episode number:
+
+- Including `v#` in the file name: `[Group] Anime - S01E01v2.mkv`, `[Group] Anime - S01E01v3.mkv`, etc.
+- Including `REPACK#` in the file name: `Anime.S01E01.REPACK-GROUP.mkv`, `Anime.S01E01.REPACK2-GROUP.mkv`, etc.
+
+!!!
+Making changes to your files will change its CRC32 value. This should be changed if used in your file name.
+!!!
+
+### Process
+
+1. In [xDelta3 Cross GUI](https://github.com/dan0v/xdelta3-cross-gui), navigate to *Files* and add the old and new versions of your file(s). *You must have an equal number of files on both sides (i.e. two old files must be accompanied by two new files)*
+   - If you are patching multiple files, make sure that their indexes match on both sides. If they do not match, check the box of the file you want to move and use the arrows below to move the file up/down
+
+2. Set your patch file destination. *You can paste the exact location or select it by pressing the three dots (...) on the side*
+
+3. At the bottom, select *Go!* to start creating your patch file(s)
+
+4. Once complete, share the patch file(s) (`.vcdiff`/`.xdelta`) found in your output folder -> `vcdiff`. *Alternatively, you may compress and share the entire output folder for [automatic patching](#automatic)*
+
+![xDelta3 Cross GUI](/static/tutorials/xdelta/xdelta3-cross-gui.png)
+
+## Using Patches
+
+### Automatic
+
+Patches created using [xDelta3 Cross GUI](https://github.com/dan0v/xdelta3-cross-gui) include `xdelta3` executables and pre-configured scripts in the output folder.
+
+1. Download and extract the patch
+
+2. Add your current files to the `original` folder
+
+3. Run the patch script for your operating system:
+   - For Windows, this will be `2.Apply Patch-Windows.bat`
+   - For macOS, this will be `2.Apply Patch-Mac.command`
+   - For Linux, this will be `2.Apply Patch-Linux.sh`
+
+4. Your patched files will be available in the `output` folder
+
+==- :icon-video: Video tutorial
+
+![Automatic patching](/static/tutorials/xdelta/xdelta3-automatic.gif)
+
+==-
+
+### Manual
+
+1. Download the latest release of [xdelta-gpl](https://github.com/jmacd/xdelta-gpl/releases):
+   - For Windows, this will be `xdelta3-3.1.0-x86_64.exe.zip`
+
+2. Extract the archive's contents
+
+3. Add your current files and patches to your working folder
+
+4. Launch a terminal window in your working directory. Run the following command, replacing `<input_file>` with the location of the current file, `<diff_name>` with the name of the `.vcdiff` or `.xdelta` patch, and `<output_file>` with the name of the final file:
+
+   ==- Windows
+
+   Single file:
+
+   ```powershell
+   .\xdelta3-3.1.0-x86_64.exe -d -s "<input_file>" "<diff_name>" "<output_file>"
+   ```
+
+   ==-
+
+5. Your patched files will be available in your working directory
+
+==- :icon-video: Video tutorial
+
+[!embed text="Manual patching"](/static/tutorials/xdelta/xdelta3-manual.mp4)
+
+==-