From b7a038dcab2a142d6c0d7a120324c4b1da12fce3 Mon Sep 17 00:00:00 2001
From: il <il@ilnmors.internal>
Date: Wed, 25 Mar 2026 00:01:06 +0900
Subject: [PATCH] docs: update paperless-ngx.md to add how to deal with
 non-standard format pdf such as korean government documents

---
 docs/services/app/paperless-ngx.md | 45 ++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/docs/services/app/paperless-ngx.md b/docs/services/app/paperless-ngx.md
index 04b4b11..c46d48b 100644
--- a/docs/services/app/paperless-ngx.md
+++ b/docs/services/app/paperless-ngx.md
@@ -59,3 +59,48 @@ ALTER DATABASE paperless_db OWNER TO paperless;
 - My Profiles: Connect new social account: Authelia
   - Continue
   - Login with Authelia
+
+## The non-standard pdf file
+
+- Some pdf files doesn't follow the standard, for example korean court or government pdf files.
+- Before upload this kind of non-standard pdf files, convert it first.
+- This process uses ghostscript and powershell in Windows for console
+
+```PowerShell
+# 1. The engine
+$gsPath = "C:\Program Files\gs\gs10.07.0\bin\gswin64c.exe"
+
+# 2. new folder which the converted file will be stored
+$outputDirName = "converted_pdfs"
+$outputDir = Join-Path (Get-Location) $outputDirName
+if (!(Test-Path $outputDir)) { New-Item -ItemType Directory -Path $outputDir }
+
+# 3. Find all pdf files
+$files = Get-ChildItem -Filter *.pdf
+
+foreach ($file in $files) {
+    if ($file.FullName -like "*$outputDirName*") { continue }
+    
+    $inputPath = $file.FullName
+    $outputPath = Join-Path $outputDir $file.Name
+    
+    Write-Host "convert: $($file.Name)" -ForegroundColor Cyan
+    
+    $gsArgs = @(
+        "-sDEVICE=pdfwrite",
+        "-dCompatibilityLevel=1.4",
+        "-dPDFSETTINGS=/default",
+        "-dNOPAUSE",
+        "-dQUIET",
+        "-dBATCH",
+        "-dNoOutputFonts", # Change all text as image
+        "-sOutputFile=$outputPath",
+        "$inputPath"
+    )
+    
+    # 실행
+    & $gsPath @gsArgs
+}
+
+Write-Host "`n[Complete] All file is stored in '$outputDirName'." -ForegroundColor Green
+```