Add initial Korean translation draft for documentation

* Translate multiple .po files using Cursor's agent functionality
* Performed regex editing and initial review

Author: simneol

docs/about-feature-matrix.rst

@@ -549,6 +549,80 @@
 
 
 
+            } else if (lang == "ko") {
+                if (str=="Feature") {
+                    return "기능";
+                } else if (str=="Supports Multiple Document Formats") {
+                    return "다중 문서 형식 지원";
+                } else if (str=="Image") {
+                    return "이미지";
+                } else if (str=="Implementation") {
+                    return "구현";
+                } else if (str=="and") {
+                    return "및";
+                } else if (str=="Render Document Pages") {
+                    return "문서 페이지 렌더링";
+                } else if (str=="All document types") {
+                    return "모든 문서 유형";
+                } else if (str=="No rendering") {
+                    return "렌더링 없음";
+                } else if (str=="Extract Text") {
+                    return "텍스트 추출";
+                } else if (str=="Write Text to PDF Page") {
+                    return "PDF 페이지에 텍스트 쓰기";
+                } else if (str=="only") {
+                    return "만";
+                } else if (str=="Extract Vector Graphics") {
+                    return "벡터 그래픽 추출";
+                } else if (str=="Draw Vector Graphics (PDF)") {
+                    return "벡터 그래픽 그리기 (PDF)";
+                } else if (str=="Based on Existing, Mature Library") {
+                    return "기존의 성숙한 라이브러리 기반";
+                } else if (str=="Automatic Repair of Damaged PDFs") {
+                    return "손상된 PDF 자동 복구";
+                } else if (str=="Encrypted PDFs") {
+                    return "암호화된 PDF";
+                } else if (str=="Limited") {
+                    return "제한적";
+                } else if (str=="Linerarized PDFs") {
+                    return "선형화된 PDF";
+                } else if (str=="Incremental Updates") {
+                    return "증분 업데이트";
+                } else if (str=="Integrates with Jupyter and IPython Notebooks") {
+                    return "Jupyter 및 IPython Notebooks 통합";
+                } else if (str=="Joining / Merging PDF with other Document Types") {
+                    return "다른 문서 유형과 PDF 결합 / 병합";
+                } else if (str=="OCR API for Seamless Integration with Tesseract") {
+                    return "Tesseract와의 원활한 통합을 위한 OCR API";
+                } else if (str=="Integrated Checkpoint / Restart Feature (PDF)") {
+                    return "통합 체크포인트 / 재시작 기능 (PDF)";
+                } else if (str=="PDF Optional Content") {
+                    return "PDF 선택적 콘텐츠";
+                } else if (str=="PDF Embedded Files") {
+                    return "PDF 임베디드 파일";
+                } else if (str=="PDF Redactions") {
+                    return "PDF 편집";
+                } else if (str=="PDF Annotations") {
+                    return "PDF 주석";
+                } else if (str=="Full") {
+                    return "전체";
+                } else if (str=="PDF Form Fields") {
+                    return "PDF 양식 필드";
+                } else if (str=="Create, read, update") {
+                    return "생성, 읽기, 업데이트";
+                } else if (str=="Limited, no creation") {
+                    return "제한적, 생성 불가";
+                } else if (str=="PDF Page Labels") {
+                    return "PDF 페이지 레이블";
+                } else if (str=="Support Font Sub-Setting") {
+                    return "폰트 서브셋 지원";
+                } else if (str=="Extract Tables") {
+                    return "테이블 추출";
+                } else if (str=="Supports CJK characters") {
+                    return "CJK 문자 지원";
+                } else if (str == "Extract Text as Markdown (.md)") {
+                    return "텍스트를 Markdown (.md) 으로 추출";
+                }
             }
 
             return str;

docs/about-performance.rst

@@ -354,6 +354,28 @@
 
 
 
+            } else if (langB == "ko") {
+                if (str=="Copying") {
+                    return "복사";
+                } else if (str == "This refers to opening a document and then saving it to a new file. This test measures the speed of reading a <cite>PDF</cite> and re-writing as a new <cite>PDF</cite>. This process is also at the core of functions like merging / joining multiple documents. The numbers below therefore apply to <cite>PDF</cite> joining and merging.") {
+                    return "이것은 문서를 열고 새 파일로 저장하는 것을 의미합니다. 이 테스트는 <cite>PDF</cite> 를 읽고 새 <cite>PDF</cite> 로 다시 쓰는 속도를 측정합니다. 이 프로세스는 여러 문서를 병합 / 결합하는 기능의 핵심이기도 합니다. 따라서 아래 숫자는 <cite>PDF</cite> 결합 및 병합에도 적용됩니다.";
+                } else if (str == "The results for all 7,031 pages are:") {
+                    return "모든 7,031 페이지에 대한 결과:";
+                } else if (str == "seconds") {
+                    return "초";
+                } else if (str == "fastest") {
+                    return "가장 빠름";
+                } else if (str == "slowest") {
+                    return "가장 느림";
+                } else if (str == "Text Extraction") {
+                    return "텍스트 추출";
+                } else if (str == "This refers to extracting simple, plain text from every page of the document and storing it in a text file.") {
+                    return "이것은 문서의 모든 페이지에서 간단한 일반 텍스트를 추출하여 텍스트 파일에 저장하는 것을 의미합니다.";
+                } else if (str == "Rendering") {
+                    return "렌더링";
+                } else if (str == "This refers to making an image (like PNG) from every page of a document at a given DPI resolution. This feature is the basis for displaying a document in a GUI window.") {
+                    return "이것은 주어진 DPI 해상도로 문서의 모든 페이지에서 이미지 (예: PNG)를 만드는 것을 의미합니다. 이 기능은 GUI 창에서 문서를 표시하는 기반입니다.";
+                }
             }
 
             return str;

docs/footer.rst

@@ -22,6 +22,15 @@
                   return "このソフトウェアは無保証で提供されており、明示または黙示を問わず、いかなる保証もありません。このソフトウェアはライセンスの下で配布され、ライセンスの条件に明示的に許可されている場合を除き、コピー、変更、または配布してはなりません。ライセンシング情報については、<a href='https://www.artifex.com?utm_source=rtd-pymupdf&utm_medium=rtd&utm_content=footer-link'>artifex.com</a>でライセンス情報を参照するか、アメリカ合衆国カリフォルニア州サンフランシスコのArtifex Software Inc. までお問い合わせください。"
 
               }
+          } else if (docLanguage == "ko") {
+              if (str == "Find <b>#pymupdf</b> on <b>Discord</b>") {
+                  return "<b>Discord</b> 에서 <b>#pymupdf</b> 찾기";
+              } else if (str == "Have a <b>&nbsp;question</b>? Need some <b>&nbsp;answers</b>?&nbsp;") {
+                  return "<b>&nbsp;질문</b>이 있으신가요? <b>&nbsp;답변</b>이 필요하신가요?&nbsp;";
+              }
+              else if (str == "This software is provided AS-IS with no warranty, either express or implied. This software is distributed under license and may not be copied, modified or distributed except as expressly authorized under the terms of that license. Refer to licensing information at <a href='https://www.artifex.com?utm_source=rtd-pymupdf&utm_medium=rtd&utm_content=footer-link'>artifex.com</a> or contact Artifex Software Inc., 39 Mesa Street, Suite 108A, San Francisco CA 94129, United States for further information.") {
+                  return "이 소프트웨어는 명시적이든 묵시적이든 어떠한 보증도 없이 있는 그대로 제공됩니다. 이 소프트웨어는 라이선스에 따라 배포되며, 해당 라이선스 조건에 명시적으로 승인된 경우를 제외하고는 복사, 수정 또는 배포할 수 없습니다. 라이선스 정보는 <a href='https://www.artifex.com?utm_source=rtd-pymupdf&utm_medium=rtd&utm_content=footer-link'>artifex.com</a> 에서 참조하거나, 미국 캘리포니아주 샌프란시스코 Mesa Street 39, Suite 108A 소재 Artifex Software Inc. 에 문의하시기 바랍니다."
+              }
           }
 
           return str;

docs/locales/ko/LC_MESSAGES/404.mo

@@ -21,33 +21,33 @@ msgstr ""
 
 #: ../../header-404.rst:-1 a1916335a5274785a49dd5e339d92fe7
 msgid "Artifex"
-msgstr ""
+msgstr "Artifex"
 
 #: ../../header-404.rst:-1 5d84ec96284f4e3f94e9c1b238269f04
 msgid ""
 "PyMuPDF is a high-performance Python library for data extraction, "
 "analysis, conversion & manipulation of PDF (and other) documents."
-msgstr ""
+msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다."
 
 #: ../../header-404.rst:-1 4576f08a21cd47f79352fb20f6583d87
 msgid ""
 "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, "
 "PDF Splitting, PDF Creation, Pyodide, PyScript"
-msgstr ""
+msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript"
 
 #: ../../404.rst:4 924f32c8351f4a62978ec14c16c351b5
 msgid "404!"
-msgstr ""
+msgstr "404!"
 
 #: ../../404.rst:7 6d3e16ada64f4502aa193e221a595c34
 msgid "**This page is not available.**"
-msgstr ""
+msgstr "**이 페이지를 사용할 수 없습니다.**"
 
 #: ../../404.rst:10 dbddaa0e43f144ebbea819e2466410b9
 msgid "Please use the menu or search to find what you are looking for."
-msgstr ""
+msgstr "메뉴 또는 검색을 사용하여 찾고 있는 내용을 검색해 주세요."
 
 #: ../../footer.rst:46 a4c037a234b44cbe8461dba8e47036a1
 msgid "This documentation covers all versions up to |version|."
-msgstr ""
+msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다."
 

docs/locales/ko/LC_MESSAGES/404.po

@@ -21,90 +21,90 @@ msgstr ""
 
 #: ../../header.rst:-1 f19dada9348f4b02a8e7f37161295aed
 msgid "Artifex"
-msgstr ""
+msgstr "Artifex"
 
 #: ../../header.rst:-1 3a2fd52dfdbe4ef0ba2277d3dc5ce9cd
 msgid ""
 "PyMuPDF is a high-performance Python library for data extraction, "
 "analysis, conversion & manipulation of PDF (and other) documents."
-msgstr ""
+msgstr "PyMuPDF는 PDF 및 기타 문서의 데이터 추출, 분석, 변환, 조작을 위한 고성능 Python 라이브러리입니다."
 
 #: ../../header.rst:-1 6457f182efd342f9971c29ded21b19cd
 msgid ""
 "PDF Text Extraction, PDF Image Extraction, PDF Conversion, PDF Tables, "
 "PDF Splitting, PDF Creation, Pyodide, PyScript"
-msgstr ""
+msgstr "PDF 텍스트 추출, PDF 이미지 추출, PDF 변환, PDF 테이블, PDF 분할, PDF 생성, Pyodide, PyScript"
 
 #: ../../about.rst:10 6bf350a1548242f08f4231816b75ae9e
 msgid "Features Comparison"
 msgstr "기능 비교"
 
 #: ../../about.rst:16 e6e0680f36684a24b35c48e7756b8ee2
 msgid "Feature Matrix"
-msgstr "기능 매트릭스"
+msgstr "기능 비교표"
 
 #: ../../about.rst:18 fdad9ebd21e342da9d1b6b35ca5ad4e9
 msgid ""
 "The following table illustrates how |PyMuPDF| compares with other typical"
 " solutions."
-msgstr "다음 표는  |PyMuPDF| 가 다른 일반적인 솔루션들과 어떻게 비교되는지 보여줍니다."
+msgstr "다음 표는 |PyMuPDF| 가 다른 일반적인 솔루션과 어떻게 비교되는지 보여줍니다."
 
 #: ../../about.rst:47 5f1d6f3b09ac43e1ae7043dc7a879c02
 msgid ""
 "A note about **Office** document types (DOCX, XLXS, PPTX) and **Hangul** "
 "documents (HWPX). These documents can be loaded into |PyMuPDF| and you "
 "will receive a :ref:`Document <Document>` object."
-msgstr ""
+msgstr "**Office** 문서 유형(DOCX, XLXS, PPTX) 및 **한글** 문서(HWPX)에 대한 참고사항입니다. 이러한 문서는 |PyMuPDF| 에 로드할 수 있으며 :ref:`Document <Document>` 객체를 받게 됩니다."
 
 #: ../../about.rst:49 9add749bf1d7451aabfcb79190677ddb
 msgid "There are some caveats:"
-msgstr ""
+msgstr "다음과 같은 주의사항이 있습니다:"
 
 #: ../../about.rst:52 a610a8b3f5cf4333938a9e7a75157f1d
 msgid "we convert the input to **HTML** to layout the content."
-msgstr ""
+msgstr "내용을 배치하기 위해 입력을 **HTML** 로 변환합니다."
 
 #: ../../about.rst:53 a71abef4bb604e3b8f1065200afb7907
 msgid "because of this the original page separation has gone."
-msgstr ""
+msgstr "이로 인해 원본 페이지 구분이 사라집니다."
 
 #: ../../about.rst:55 255d6618e34f4f11ae7a1a0f54f57322
 msgid ""
 "When saving out the result any faithful representation of the original "
 "layout cannot be expected."
-msgstr ""
+msgstr "결과를 저장할 때 원본 레이아웃의 정확한 표현을 기대할 수 없습니다."
 
 #: ../../about.rst:57 59954cbab9914471b64ad43b7eb7a58b
 msgid ""
 "Therefore input files are mostly in a form that's useful for text "
 "extraction."
-msgstr ""
+msgstr "따라서 입력 파일은 주로 텍스트 추출에 유용한 형태입니다."
 
 #: ../../about.rst:65 f3ad21fdc6c841f090824af510994edb
 msgid "Performance"
-msgstr ""
+msgstr "성능"
 
 #: ../../about.rst:69 482ba1a4696f429da50d900517f9001b
 msgid ""
 "To benchmark |PyMuPDF| performance against a range of tasks a test suite "
 "with a fixed set of :ref:`8 PDFs with a total of 7,031 "
 "pages<Appendix4_Files_Used>` containing text & images is used to obtain "
 "performance timings."
-msgstr ""
+msgstr "다양한 작업에 대해 |PyMuPDF| 성능을 벤치마크하기 위해 텍스트와 이미지가 포함된 :ref:`총 7,031페이지의 8개 PDF 파일<Appendix4_Files_Used>` 로 구성된 고정된 테스트 스위트를 사용하여 성능 타이밍을 측정합니다."
 
 #: ../../about.rst:72 11c5e7e482204c7682f05223297c6488
 msgid "Here are current results, grouped by task:"
-msgstr ""
+msgstr "다음은 작업별로 그룹화된 현재 결과입니다:"
 
 #: ../../about.rst:81 9f36f4db74ab492ba26cc4fb9946f818
 msgid ""
 "For more detail regarding the methodology for these performance timings "
 "see: :ref:`Performance Comparison Methodology<Appendix4>`."
-msgstr ""
+msgstr "이러한 성능 타이밍 방법론에 대한 자세한 내용은 :ref:`성능 비교 방법론<Appendix4>` 을 참조하세요."
 
 #: ../../about.rst:89 e86ca33131a544e8a4cc0821737a9a86
 msgid "License and Copyright"
-msgstr ""
+msgstr "라이선스 및 저작권"
 
 #: ../../about.rst:93 061c6a01a19c40198fd34033af39cc6d
 msgid ""
@@ -118,50 +118,50 @@ msgid ""
 "<https://artifex.com/contact/pymupdf-inquiry.php?utm_source=rtd-"
 "pymupdf&utm_medium=rtd&utm_content=inline-link>`_ for more information "
 "regarding a commercial license."
-msgstr ""
+msgstr "|PyMuPDF| 와 |MuPDF| 는 이제 오픈소스 |AGPL| 및 상용 라이선스 계약 모두에서 사용할 수 있습니다. 사용 사례가 라이선스 지침을 준수하는지 확인하려면 배포 자료(COPYING 파일) 및 `GNU 라이선스 페이지 <https://www.gnu.org/licenses/agpl-3.0.html>`_ 에서 제공되는 |AGPL| 라이선스 계약 전문을 읽어보세요. |AGPL| 의 요구사항을 충족할 수 없다고 판단되는 경우, 상용 라이선스에 대한 자세한 정보는 `Artifex <https://artifex.com/contact/pymupdf-inquiry.php?utm_source=rtd-pymupdf&utm_medium=rtd&utm_content=inline-link>`_ 에 문의하세요."
 
 #: ../../about.rst:111 0cf7adfbbbe6404aae5016ba8cf4ca79
 msgid ""
 ":title:`Artifex` is the exclusive commercial licensing agent for "
 ":title:`MuPDF`."
-msgstr ""
+msgstr ":title:`Artifex` 는 :title:`MuPDF` 의 독점 상용 라이선스 대리인입니다."
 
 #: ../../about.rst:113 1206bde366264e91900de44a990e7b13
 msgid ""
 ":title:`Artifex`, the :title:`Artifex` logo, :title:`MuPDF`, and the "
 ":title:`MuPDF` logo are registered trademarks of :title:`Artifex Software"
 " Inc.`"
-msgstr ""
+msgstr ":title:`Artifex`, :title:`Artifex` 로고, :title:`MuPDF`, :title:`MuPDF` 로고는 :title:`Artifex Software Inc.` 의 등록 상표입니다."
 
 #: ../../version.rst:1 b23f02d66d164eb195ed6512c8e9ff6c
 msgid "This documentation covers PyMuPDF |version|."
-msgstr ""
+msgstr "이 문서는 PyMuPDF |version| 을 다룹니다."
 
 #: ../../version.rst:3 ca881a8c265b46618c644701ea14c695
 msgid ""
 "The major and minor versions of PyMuPDF and MuPDF will always be the "
 "same. Only the third qualifier (patch level) may deviate from that of "
 "MuPDF."
-msgstr ""
+msgstr "PyMuPDF와 MuPDF의 주 버전과 부 버전은 항상 동일합니다. 세 번째 한정자(패치 레벨)만 |MuPDF| 와 다를 수 있습니다."
 
 #: ../../version.rst:5 a91d12805e42498fb4eebcb3f7923eb8
 msgid ""
 "Typically PyMuPDF is released more frequently than MuPDF so it will often"
 " be the case that the patch level of PyMuPDF will be greater than the "
 "embedded MuPDF."
-msgstr ""
+msgstr "일반적으로 PyMuPDF는 MuPDF보다 더 자주 릴리스되므로, PyMuPDF의 패치 레벨이 내장된 MuPDF보다 높은 경우가 많습니다."
 
 #: ../../version.rst:9 2e3b5e5955fc4cba8aafc25d3d650e7a
 msgid "For example PyMuPDF-1.24.5 contains MuPDF-1.24.2."
-msgstr ""
+msgstr "예를 들어 PyMuPDF-1.24.5는 MuPDF-1.24.2를 포함합니다."
 
 #: ../../version.rst:11 a60af2aa03494194b19ecf8e3bc095fc
 msgid "Also see `pymupdf_version` and `mupdf_version`."
-msgstr ""
+msgstr "`pymupdf_version` 및 `mupdf_version` 도 참조하세요."
 
 #: ../../footer.rst:48 ea2d1136af82416baa3286db6ed38f96
 msgid "This documentation covers all versions up to |version|."
-msgstr ""
+msgstr "이 문서는 |version| 버전까지의 모든 버전을 다룹니다."
 
 #~ msgid ""
 #~ "The major and minor versions of "