uv-{publish, remove, run, self, sync}: add Korean translation (#23771)

Author: IMHOJEONG

pages.ko/common/uv-publish.md

@@ -0,0 +1,28 @@
+# uv publish
+
+> 배포 패키지를 패키지 인덱스에 업로드.
+> 더 많은 정보: <https://docs.astral.sh/uv/reference/cli/#uv-publish>.
+
+- `dist/` 디렉터리의 패키지 배포 (기본 동작):
+
+`uv publish`
+
+- 지정한 저장소 URL에 패키지 배포:
+
+`uv publish --publish-url {{https://upload.pypi.org/legacy/}}`
+
+- 지정한 사용자 이름과 비밀번호를 사용하여 패키지 배포:
+
+`uv publish {{[-u|--username]}} {{사용자명}} {{[-p|--password]}} {{비밀번호}}`
+
+- API 토큰을 사용하여 패키지 배포:
+
+`uv publish {{[-t|--token]}} {{사용자_api_토큰}}`
+
+- 지정한 배포 파일 배포:
+
+`uv publish {{경로/대상/목적지/*.whl}} {{경로/대상/목적지/*.tar.gz}}`
+
+- 테스트를 위해 TestPyPI에 패키지 배포:
+
+`uv publish --publish-url https://test.pypi.org/legacy/`

pages.ko/common/uv-remove.md

@@ -0,0 +1,28 @@
+# uv remove
+
+> 프로젝트의 `pyproject.toml` 파일에서 의존성을 제거.
+> 더 많은 정보: <https://docs.astral.sh/uv/reference/cli/#uv-remove>.
+
+- 프로젝트에서 의존성을 제거:
+
+`uv remove {{패키지}}`
+
+- 여러 의존성 제거:
+
+`uv remove {{패키지1 패키지2 ...}}`
+
+- 개발 의존성 제거:
+
+`uv remove --dev {{패키지}}`
+
+- 선택적인 의존성 그룹에서 의존성 제거:
+
+`uv remove --optional {{선택_의존성_이름}} {{패키지}}`
+
+- 지정한 의존성 그룹에서 의존성 제거:
+
+`uv remove --group {{그룹_이름}} {{패키지}}`
+
+- 가상 환경을 동기화하지 않고 의존성 제거:
+
+`uv remove --no-sync {{패키지}}`

pages.ko/common/uv-run.md

@@ -0,0 +1,28 @@
+# uv run
+
+> 프로젝트 환경에서 명령 또는 스크립트 실행.
+> 더 많은 정보: <https://docs.astral.sh/uv/reference/cli/#uv-run>.
+
+- Python 스크립트 실행:
+
+`uv run {{경로/대상/스크립트.py}}`
+
+- Python 모듈 실행:
+
+`uv run {{[-m|--module]}} {{모듈_이름}}`
+
+- 추가 패키지를 임시로 설치하여 명령 실행:
+
+`uv run {{[-w|--with]}} {{패키지}} {{명령어}}`
+
+- requirements 파일의 패키지를 사용하여 스크립트 실행:
+
+`uv run --with-requirements {{경로/대상/requirements.txt}} {{경로/대상/스크립트.py}}`
+
+- 격리된 환경에서 실행 (프로젝트 의존성 사용하지 않음):
+
+`uv run --isolated {{경로/대상/스크립트.py}}`
+
+- 환경을 먼저 동기화하지 않고 명령 실행:
+
+`uv run --no-sync {{명령어}}`

pages.ko/common/uv-self.md

@@ -0,0 +1,32 @@
+# uv self
+
+> `uv` 실행 파일 자체를 관리.
+> 더 많은 정보: <https://docs.astral.sh/uv/reference/cli/#uv-self>.
+
+- `uv`를 최신 버전으로 업데이트:
+
+`uv self update`
+
+- `uv`를 지정한 버전으로 업데이트:
+
+`uv self update {{0.4.0}}`
+
+- 설치하지 않고 사용 가능한 `uv` 업데이트 확인:
+
+`uv self update --dry-run`
+
+- 자세한 출력을 표시하며 `uv` 업데이트:
+
+`uv self update {{[-v|--verbose]}}`
+
+- 현재 `uv` 버전 표시:
+
+`uv self version`
+
+- 버전 번호만 표시:
+
+`uv self version --short`
+
+- 버전 정보를 JSON 형식으로 표시:
+
+`uv self version --output-format json`

pages.ko/common/uv-sync.md

@@ -0,0 +1,36 @@
+# uv sync
+
+> 프로젝트 환경을 lockfile과 일치하도록 업데이트.
+> 더 많은 정보: <https://docs.astral.sh/uv/reference/cli/#uv-sync>.
+
+- 프로젝트 환경을 lockfile과 동기화:
+
+`uv sync`
+
+- 모든 선택적 의존성을 포함하여 동기화:
+
+`uv sync --all-extras`
+
+- 지정한 선택적 의존성을 포함하여 동기화:
+
+`uv sync --extra {{선택_의존성_이름}}`
+
+- 개발 의존성만 동기화:
+
+`uv sync --only-dev`
+
+- 개발 의존성을 제외하고 동기화:
+
+`uv sync --no-dev`
+
+- 지정한 의존성 그룹을 동기화:
+
+`uv sync --group {{그룹_이름}}`
+
+- 환경이 이미 동기화되어 있는지 확인 (변경 없이):
+
+`uv sync --check`
+
+- 실제 변경 없이 동기화될 내용을 미리 확인:
+
+`uv sync --dry-run`