马一丁

Update README-EN.md

@@ -386,84 +386,11 @@ uv venv --python 3.11 # Create Python 3.11 environment @@ -386,84 +386,11 @@ uv venv --python 3.11 # Create Python 3.11 environment
386 386
387 ### 2. Install System Dependencies for PDF Export (Optional) 387 ### 2. Install System Dependencies for PDF Export (Optional)
388 388
389 -> ⚠️ **Note**: If you need to use the PDF export function, please install system dependencies following the steps below. If you don't need PDF export, you can skip this step, and other system functions will not be affected.  
390 -  
391 -<details>  
392 -<summary><b>📦 macOS Installation Steps</b></summary>  
393 -  
394 -```bash  
395 -# 1. Install system dependencies (execute on host machine)  
396 -brew install pango gdk-pixbuf libffi  
397 -  
398 -# 2. Set environment variable (required)  
399 -# Apple Silicon  
400 -export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH  
401 -# Intel Mac  
402 -export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH  
403 -  
404 -# Or permanently add to ~/.zshrc  
405 -echo 'export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc  
406 -# Intel users: echo 'export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc  
407 -source ~/.zshrc  
408 -```  
409 -  
410 -</details>  
411 -  
412 -<details>  
413 -<summary><b>🐧 Ubuntu/Debian Installation Steps</b></summary>  
414 -  
415 -```bash  
416 -# 1. Install system dependencies (execute on host machine)  
417 -sudo apt-get update  
418 -sudo apt-get install -y \  
419 - libpango-1.0-0 \  
420 - libpangoft2-1.0-0 \  
421 - libgdk-pixbuf2.0-0 \  
422 - libffi-dev \  
423 - libcairo2  
424 -```  
425 -  
426 -</details>  
427 -  
428 -<details>  
429 -<summary><b>🎩 CentOS/RHEL Installation Steps</b></summary>  
430 -  
431 -```bash  
432 -# 1. Install system dependencies (execute on host machine)  
433 -sudo yum install -y pango gdk-pixbuf2 libffi-devel cairo  
434 -```  
435 -  
436 -</details>  
437 -  
438 -<details>  
439 -<summary><b>🪟 Windows Installation Steps</b></summary>  
440 -  
441 -```powershell  
442 -# 1. Download and install GTK3 Runtime (execute on host machine)  
443 -# Visit: https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases  
444 -# Download the latest .exe file and install  
445 -  
446 -# 2. Add the GTK installation bin directory to PATH (open a new terminal afterwards)  
447 -# Default path example (replace with your custom install path if different)  
448 -set PATH=C:\Program Files\GTK3-Runtime Win64\bin;%PATH%  
449 -  
450 -# Optional: persist the setting  
451 -setx PATH "C:\Program Files\GTK3-Runtime Win64\bin;%PATH%"  
452 -  
453 -# If installed to a custom path, replace with your actual path, or set GTK_BIN_PATH=<your-bin-path>, then reopen the terminal  
454 -  
455 -# 3. Verify in a new terminal  
456 -python -m ReportEngine.utils.dependency_check  
457 -# You should see “✓ Pango dependency check passed”  
458 -```  
459 -  
460 -</details>  
461 -  
462 -> 💡 **Tip**: If using Docker deployment, no need to manually install these dependencies, the Docker image already contains all necessary system dependencies. 389 +This section contains detailed configuration instructions:[Configure the dependencies required for "Export to PDF"](./static/Partial%20README%20for%20PDF%20Exporting/README-EN.md)
463 390
464 ### 3. Install Dependencies 391 ### 3. Install Dependencies
465 392
466 -> If you skip step 2, the weasyprint library will fail to install, which is expected. 393 +> If Step 2 is skipped, the WeasyPrint library may not install correctly, and the PDF functionality may be unavailable.
467 394
468 ```bash 395 ```bash
469 # Basic dependency installation 396 # Basic dependency installation
  1 +> ⚠️ **Note**: If you need to use the PDF export function, please install system dependencies following the steps below. If you don't need PDF export, you can skip this step, and other system functions will not be affected.
  2 +
  3 +<details>
  4 +<summary><b>🪟 Windows Installation Steps</b></summary>
  5 +
  6 +```powershell
  7 +# 1. Download and install GTK3 Runtime (execute on host machine)
  8 +# Visit: https://github.com/tschoonj/GTK-for-Windows-Runtime-Environment-Installer/releases
  9 +# Download the latest .exe file and install
  10 +# Installing it in the default path is strongly advised, as it may help prevent various unforeseen errors.
  11 +
  12 +# 2. Add the GTK installation bin directory to PATH (open a new terminal afterwards)
  13 +# Default path example (replace with your custom install path if different)
  14 +set PATH=C:\Program Files\GTK3-Runtime Win64\bin;%PATH%
  15 +
  16 +# Optional: persist the setting
  17 +setx PATH "C:\Program Files\GTK3-Runtime Win64\bin;%PATH%"
  18 +
  19 +# If installed to a custom path, replace with your actual path, or set GTK_BIN_PATH=<your-bin-path>, then reopen the terminal
  20 +
  21 +# 3. Verify in a new terminal
  22 +python -m ReportEngine.utils.dependency_check
  23 +# You should see “✓ Pango dependency check passed”
  24 +```
  25 +
  26 +</details>
  27 +
  28 +<details>
  29 +<summary><b>📦 macOS Installation Steps</b></summary>
  30 +
  31 +```bash
  32 +# 1. Install system dependencies (execute on host machine)
  33 +brew install pango gdk-pixbuf libffi
  34 +
  35 +# 2. Set environment variable (required)
  36 +# Apple Silicon
  37 +export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH
  38 +# Intel Mac
  39 +export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH
  40 +
  41 +# Or permanently add to ~/.zshrc
  42 +echo 'export DYLD_LIBRARY_PATH=/opt/homebrew/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc
  43 +# Intel users: echo 'export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH' >> ~/.zshrc
  44 +source ~/.zshrc
  45 +```
  46 +
  47 +</details>
  48 +
  49 +<details>
  50 +<summary><b>🐧 Ubuntu/Debian Installation Steps</b></summary>
  51 +
  52 +```bash
  53 +# 1. Install system dependencies (execute on host machine)
  54 +sudo apt-get update
  55 +sudo apt-get install -y \
  56 + libpango-1.0-0 \
  57 + libpangoft2-1.0-0 \
  58 + libgdk-pixbuf2.0-0 \
  59 + libffi-dev \
  60 + libcairo2
  61 +```
  62 +
  63 +</details>
  64 +
  65 +<details>
  66 +<summary><b>🎩 CentOS/RHEL Installation Steps</b></summary>
  67 +
  68 +```bash
  69 +# 1. Install system dependencies (execute on host machine)
  70 +sudo yum install -y pango gdk-pixbuf2 libffi-devel cairo
  71 +```
  72 +
  73 +</details>
  74 +
  75 +
  76 +> 💡 **Tip**: If using Docker deployment, no need to manually install these dependencies, the Docker image already contains all necessary system dependencies.