refactor: website docs **translation needed** (#9287)

Co-authored-by: wlwxj <d1ve_wh4le@outlook.com> Co-authored-by: Rbqwow <55343783+Rbqwow@users.noreply.github.com> Co-authored-by: Constrat <56174894+Constrat@users.noreply.github.com> Co-authored-by: HX3N <scarlet7518@gmail.com> Co-authored-by: Wallsman <63186641+wallsman@users.noreply.github.com> Co-authored-by: Loong <wangl.cc@outlook.com> Co-authored-by: 神代綺凛 <i@loli.best> Co-authored-by: SherkeyXD <57581480+SherkeyXD@users.noreply.github.com>
2026-07-16 01:40:46 +08:00 · 2024-07-08 01:57:20 +08:00
parent 24a73759ad
commit 67bbf9aac5
288 changed files with 10256 additions and 6210 deletions
--- a/docs/en-us/develop/linux-tutorial.md
+++ b/docs/en-us/develop/linux-tutorial.md
@@ -0,0 +1,84 @@
+---
+order: 2
+icon: teenyicons:linux-alt-solid
+---
+
+# Linux Compiling Tutorial
+
+**The tutorial requires some basic knowledge about Linux OS!**
+If you just want to install MAA directly instead of compiling it yourself, please read [Emulator Support for Linux](../manual/device/linux.md).
+
+::: info Note
+Linux build of MAA is still under discussion, some of the content might be outdated, please follow the script in [GitHub workflow file](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/.github/workflows/ci.yml#L134), also reference [AUR PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=maa-assistant-arknights), [nixpkgs](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-assistant-arknights/package.nix)
+:::
+
+## Compiling MAA
+
+1. Download build depends
+
+    - Ubuntu/Debian
+
+        ```bash
+        sudo apt install gcc-12 g++-12 cmake zlib1g-dev
+        ```
+
+    - Arch Linux
+
+        ```bash
+        sudo pacman -S --needed gcc cmake zlib
+        ```
+
+2. Build or download third-party libraries
+
+   You may either download pre-built dependencies or build them from scratch
+
+    - Download pre-built libraries (recommended)
+
+        > **Note**
+        > It contains shared objects built on a relatively new linux distro (Ubuntu 22.04), which may cause ABI incompatibility if you are working on a system with older version of libstdc++.
+
+        ```bash
+        python maadeps-download.py
+        ```
+
+    If this does not work for you due to ABI issue, and containerization is not an option, you may build them from scratch
+
+    - Build from source
+
+        ```bash
+        git submodule update --init --recursive
+        cd MaaDeps
+       python build.py
+        ```
+
+3. Build MAA
+
+    ```bash
+    CC=gcc-12 CXX=g++-12 cmake -B build \
+        -DINSTALL_THIRD_LIBS=ON \
+        -DINSTALL_RESOURCE=ON \
+        -DINSTALL_PYTHON=ON
+    cmake --build build
+    ```
+
+    To install MAA to the target location, note that MAA is recommended to run by specifying `LD_LIBRARY_PATH`, do not use administrator privileges to load MAA into `/`
+
+    ```bash
+    cmake --install build --prefix <target_directory>
+    ```
+
+## Integration
+
+[~~Maybe not a doc~~](../protocol/integration.md)
+
+### Python
+
+Refer to the implementation of `__main__` in [Python demo](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Python/sample.py)
+
+### C
+
+Refer to the implementation of [CppSample](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/CppSample/main.cpp)
+
+### C Sharp
+
+Refer to the implementation of [MaaWpfGui](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/MaaWpfGui/Helper/AsstProxy.cs)