From 18ce6bc28d3df5e18fcdef8b4db9c3d3b6f5e308 Mon Sep 17 00:00:00 2001
From: HoJeong Im <39ghwjd@naver.com>
Date: Mon, 7 Sep 2026 18:02:57 +0900
Subject: [PATCH] poetry-{self, shell, show, source, sync}: add Korean
 translation (#23852)

---
 pages.ko/common/poetry-self.md   | 38 ++++++++++++++++++++++++++++++++
 pages.ko/common/poetry-shell.md  |  9 ++++++++
 pages.ko/common/poetry-show.md   | 37 +++++++++++++++++++++++++++++++
 pages.ko/common/poetry-source.md | 25 +++++++++++++++++++++
 pages.ko/common/poetry-sync.md   | 36 ++++++++++++++++++++++++++++++
 5 files changed, 145 insertions(+)
 create mode 100644 pages.ko/common/poetry-self.md
 create mode 100644 pages.ko/common/poetry-shell.md
 create mode 100644 pages.ko/common/poetry-show.md
 create mode 100644 pages.ko/common/poetry-source.md
 create mode 100644 pages.ko/common/poetry-sync.md

diff --git a/pages.ko/common/poetry-self.md b/pages.ko/common/poetry-self.md
new file mode 100644
index 0000000000..24a3e154c4
--- /dev/null
+++ b/pages.ko/common/poetry-self.md
@@ -0,0 +1,38 @@
+# poetry-self
+
+> Poetry 자체 설치/런타임 환경을 관리.
+> Poetry 설정 디렉터리의 `pyproject.toml`과 `poetry.lock` 파일을 사용.
+> 관련 항목: `asdf`.
+> 더 많은 정보: <https://python-poetry.org/docs/cli/#self>.
+
+- 패키지 설치:
+
+`poetry self add {{패키지_이름}}`
+
+- Poetry 설치 환경의 `pyproject.toml` 파일에 정의된 의존성 설치:
+
+`poetry self install`
+
+- Poetry 설치 환경의 `pyproject.toml` 파일에 정의된 의존성 잠금:
+
+`poetry self lock`
+
+- 패키지 제거:
+
+`poetry self remove {{패키지_이름}}`
+
+- 설치된 모든 패키지 목록 표시:
+
+`poetry self show`
+
+- 설치된 모든 플러그인 목록 표시:
+
+`poetry self show plugins`
+
+- Poetry 런타임 환경을 설치 환경의 `poetry.lock` 파일과 동기화:
+
+`poetry self sync`
+
+- Poetry 설치 환경의 `pyproject.toml` 파일을 기준으로 의존성 업데이트:
+
+`poetry self update`
diff --git a/pages.ko/common/poetry-shell.md b/pages.ko/common/poetry-shell.md
new file mode 100644
index 0000000000..451ad83de5
--- /dev/null
+++ b/pages.ko/common/poetry-shell.md
@@ -0,0 +1,9 @@
+# poetry shell
+
+> 가상 환경 내부에서 새로운 쉘을 실행.
+> 참고: `shell` 명령은  `poetry-plugin-shell` 플러그인으로 이동됨.
+> 더 많은 정보: <https://python-poetry.org/docs/cli/#shell>.
+
+- 가상 환경 내부에서 새로운 쉘 실행:
+
+`poetry shell`
diff --git a/pages.ko/common/poetry-show.md b/pages.ko/common/poetry-show.md
new file mode 100644
index 0000000000..bd1dd68c9e
--- /dev/null
+++ b/pages.ko/common/poetry-show.md
@@ -0,0 +1,37 @@
+# poetry show
+
+> Poetry 프로젝트의 패키지 상세 정보를 표시.
+> 관련 항목: `asdf`.
+> 더 많은 정보: <https://python-poetry.org/docs/cli/#show>.
+
+- 모든 패키지 표시:
+
+`poetry show`
+
+- 지정한 패키지의 상세 정보 표시:
+
+`poetry show {{패키지_이름}}`
+
+- 의존성 트리 형식으로 상세 정보 표시:
+
+`poetry show {{[-t|--tree]}}`
+
+- 최상위 패키지만 표시 (`pyproject.toml`에 명시적으로 정의된 패키지):
+
+`poetry show {{[-T|--top-level]}}`
+
+- 오래된 패키지 표시:
+
+`poetry show {{[-o|--outdated]}}`
+
+- 모든 패키지의 최신 버전 표시:
+
+`poetry show {{[-l|--latest]}}`
+
+- 지정한 의존성 그룹 제외:
+
+`poetry show --without {{그룹1,그룹2,...}}`
+
+- 지정한 의존성 그룹만 표시:
+
+`poetry show --only {{그룹1,그룹2,...}}`
diff --git a/pages.ko/common/poetry-source.md b/pages.ko/common/poetry-source.md
new file mode 100644
index 0000000000..7d89c7451c
--- /dev/null
+++ b/pages.ko/common/poetry-source.md
@@ -0,0 +1,25 @@
+# poetry source
+
+> Poetry 프로젝트의 패키지 소스 설정을 관리.
+> 관련 항목: `asdf`.
+> 더 많은 정보: <https://python-poetry.org/docs/cli/#source>.
+
+- 소스 설정 추가:
+
+`poetry source add {{소스_이름}} {{소스_주소}}`
+
+- 소스의 우선순위 설정:
+
+`poetry source add --priority {{primary|supplemental|explicit}} {{소스_이름}} {{소스_주소}}`
+
+- 모든 소스 정보 표시:
+
+`poetry source show`
+
+- 지정한 소스 정보 표시:
+
+`poetry source show {{소스_이름}}`
+
+- `pyproject.toml` 파일에서 지정한 소스 제거:
+
+`poetry source remove {{소스_이름}}`
diff --git a/pages.ko/common/poetry-sync.md b/pages.ko/common/poetry-sync.md
new file mode 100644
index 0000000000..79c5dea191
--- /dev/null
+++ b/pages.ko/common/poetry-sync.md
@@ -0,0 +1,36 @@
+# poetry sync
+
+> 프로젝트 환경을 `poetry.lock` 파일과 일치하도록 동기화.
+> 더 많은 정보: <https://python-poetry.org/docs/cli/#sync>.
+
+- 프로젝트 환경을 `poetry.lock` 파일과 동기화:
+
+`poetry sync`
+
+- 설치에서 하나 이상의 의존성 그룹 제외:
+
+`poetry sync --without {{test|docs|...}}`
+
+- 선택적 의존성 그룹을 포함하여 설치:
+
+`poetry sync --with {{test|docs|...}}`
+
+- 선택적 그룹을 포함한 모든 의존성 그룹 설치:
+
+`poetry sync --all-groups`
+
+- 지정한 의존성 그룹만 설치:
+
+`poetry sync --only {{test|docs|...}}`
+
+- 의존성 없이 프로젝트 자체만 설치:
+
+`poetry sync --only-root`
+
+- 설치할 extra 지정:
+
+`poetry sync {{[-E|--extras]}}`
+
+- 프로젝트 자체 설치 없이 의존성만 동기화:
+
+`poetry sync --no-root`