Transation/kor

.firebaserc

@@ -0,0 +1,5 @@
+{
+  "projects": {
+    "default": "angular-kr-docs"
+  }
+}

.gitignore

@@ -56,3 +56,4 @@ baseline.json
 
 # Ignore cache created with the Angular CLI.
 .angular/
+.env

README.md

@@ -1,10 +1,11 @@
-<h1 align="center">Angular - The modern web developer's platform</h1>
+<h1 align="center">Angular - 현대 웹 개발자를 위한 플랫폼</h1>
+<h2 align="center">비공식 한글 문서 번역 프로젝트</h2>
 
 <p align="center">
   <img src="adev/src/assets/images/press-kit/angular_icon_gradient.gif" alt="angular-logo" width="120px" height="120px"/>
   <br>
-  <em>Angular is a development platform for building mobile and desktop web applications
-    <br> using TypeScript/JavaScript and other languages.</em>
+  <em>Angular는 모바일 및 데스크톱 웹 애플리케이션 개발을 위한 플랫폼입니다.
+    <br> TypeScript/JavaScript 및 기타 언어로 개발할 수 있습니다.</em>
   <br>
 </p>
 
@@ -14,133 +15,156 @@
 </p>
 
 <p align="center">
-  <a href="CONTRIBUTING.md">Contributing Guidelines</a>
+  <a href="CONTRIBUTING.md">기여 가이드</a>
   ·
-  <a href="https://github.com/angular/angular/issues">Submit an Issue</a>
+  <a href="https://github.com/angular/angular/issues">이슈 제출</a>
   ·
-  <a href="https://blog.angular.dev/">Blog</a>
+  <a href="https://blog.angular.dev/">블로그</a>
   <br>
   <br>
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/@angular/core">
-    <img src="https://img.shields.io/npm/v/@angular/core.svg?logo=npm&logoColor=fff&label=NPM+package&color=limegreen" alt="Angular on npm" />
+    <img src="https://img.shields.io/npm/v/@angular/core.svg?logo=npm&logoColor=fff&label=NPM+package&color=limegreen" alt="npm의 Angular" />
   </a>&nbsp;
   <a href="https://discord.gg/angular">
-    <img src="https://img.shields.io/discord/463752820026376202.svg?logo=discord&logoColor=fff&label=Discord&color=7389d8" alt="Discord conversation" />
+    <img src="https://img.shields.io/discord/463752820026376202.svg?logo=discord&logoColor=fff&label=Discord&color=7389d8" alt="Discord 채널" />
   </a>
 </p>
 
 <hr>
 
-## Documentation
+## 한글 문서 프로젝트 소개
 
-Get started with Angular, learn the fundamentals and explore advanced topics on our documentation website.
+이 프로젝트는 Angular 공식 문서를 한국어로 번역하는 커뮤니티 주도형 프로젝트입니다. 한국 개발자들이 Angular를 더 쉽게 배우고 활용할 수 있도록 돕는 것을 목표로 합니다.
 
-- [Getting Started][quickstart]
-- [Architecture][architecture]
-- [Components and Templates][componentstemplates]
-- [Forms][forms]
-- [API][api]
+### 번역 진행 상황
 
-### Advanced
+현재 이 저장소의 문서들은 대부분 AI를 이용한 초벌 번역만 진행된 상태입니다. 정확하고 자연스러운 번역을 위해 커뮤니티 구성원들의 검토와 수정이 필요합니다. 함께 양질의 한글 Angular 문서를 만들어 나가요!
 
-- [Angular Elements][angularelements]
-- [Server Side Rendering][ssr]
-- [Schematics][schematics]
-- [Lazy Loading][lazyloading]
-- [Animations][animations]
+- 최근 업데이트: 2025-03-21
 
-### Local Development
+### 사용 도구
 
-To contribute to the Angular Docs, check out the [Angular.dev README](adev/README.md)
+- [ai-markdown-translator](https://github.com/h7ml/ai-markdown-translator)
+- [Cursor](https://www.cursor.com/)
 
-## Development Setup
+### 번역 참여하기
 
-### Prerequisites
+이 프로젝트에 기여하고 싶으시다면:
 
-- Install [Node.js] which includes [Node Package Manager][npm]
+1. 이 저장소를 포크(Fork)하세요
+2. 번역 작업을 수행하세요
+3. Pull Request를 제출하세요
 
-### Setting Up a Project
+자세한 내용은 [번역 기여 가이드](TRANSLATION_CONTRIBUTING.md)를 참조하세요.
 
-Install the Angular CLI globally:
+## 문서
+
+Angular를 시작하고 기본 원리를 배우며, 문서 웹사이트에서 고급 주제를 탐색해 보세요.
+
+- [시작하기][quickstart]
+- [아키텍처][architecture]
+- [컴포넌트 및 템플릿][componentstemplates]
+- [폼][forms]
+- [API 참조][api]
+
+### 고급 주제
+
+- [Angular 엘리먼트][angularelements]
+- [서버 사이드 렌더링][ssr]
+- [스키매틱][schematics]
+- [지연 로딩][lazyloading]
+- [애니메이션][animations]
+
+### 로컬 개발
+
+Angular 문서에 기여하려면 [Angular.dev README](adev/README.md)를 확인하세요.
+
+## 개발 환경 설정
+
+### 필수 요소
+
+- [Node.js] 설치 (여기에는 [Node Package Manager][npm]이 포함되어 있습니다)
+
+### 프로젝트 설정하기
+
+Angular CLI 전역 설치:
 
 ```
 npm install -g @angular/cli
 ```
 
-Create workspace:
+워크스페이스 생성:
 
 ```
-ng new [PROJECT NAME]
+ng new [프로젝트 이름]
 ```
 
-Run the application:
+애플리케이션 실행:
 
 ```
-cd [PROJECT NAME]
+cd [프로젝트 이름]
 ng serve
 ```
 
-Angular is cross-platform, fast, scalable, has incredible tooling, and is loved by millions.
+Angular는 크로스 플랫폼이며, 빠르고 확장 가능하며, 다양한 도구를 제공하여 전 세계 수백만 개발자들에게 사랑받고 있습니다.
 
-## Quickstart
+## 빠른 시작
 
-[Get started in 5 minutes][quickstart].
+[5분 안에 시작하기][quickstart]
 
-## Ecosystem
+## 생태계
 
 <p>
   <img src="/contributing-docs/images/angular-ecosystem-logos.png" alt="angular ecosystem logos" width="500px" height="auto">
 </p>
 
-- [Angular Command Line (CLI)][cli]
+- [Angular CLI][cli]
 - [Angular Material][angularmaterial]
 
-## Changelog
+## 변경 이력
 
-[Learn about the latest improvements][changelog].
+[최신 개선 사항 알아보기][changelog]
 
-## Upgrading
+## 업그레이드
 
-Check out our [upgrade guide](https://angular.dev/update-guide/) to find out the best way to upgrade your project.
+프로젝트 업그레이드를 위한 최적의 방법은 [업그레이드 가이드](https://angular.dev/update-guide/)를 확인하세요.
 
-## Contributing
+## 기여하기
 
-### Contributing Guidelines
+### 기여 가이드라인
 
-Read through our [contributing guidelines][contributing] to learn about our submission process, coding rules, and more.
+[기여 가이드][contributing]를 읽고 제출 절차, 코딩 규칙 등에 대해 알아보세요.
 
-### Want to Help?
+### 도움을 주고 싶으신가요?
 
-Want to report a bug, contribute some code, or improve the documentation? Excellent! Read up on our guidelines for [contributing][contributing] and then check out one of our issues labeled as <kbd>[help wanted](https://github.com/angular/angular/labels/help%20wanted)</kbd> or <kbd>[good first issue](https://github.com/angular/angular/labels/good%20first%20issue)</kbd>.
+버그를 신고하거나, 코드를 기여하거나, 문서를 개선하고 싶으신가요? 훌륭합니다! [기여 가이드][contributing]를 읽은 후, <kbd>[도움이 필요함](https://github.com/angular/angular/labels/help%20wanted)</kbd> 또는 <kbd>[초보자에게 적합](https://github.com/angular/angular/labels/good%20first%20issue)</kbd> 라벨이 붙은 이슈를 확인해보세요.
 
-### Code of Conduct
+### 행동 강령
 
-Help us keep Angular open and inclusive. Please read and follow our [Code of Conduct][codeofconduct].
+Angular를 개방적이고 포용적인 커뮤니티로 유지할 수 있도록 도와주세요. [행동 강령][codeofconduct]을 읽고 준수해 주세요.
 
-## Community
+## 커뮤니티
 
-Join the conversation and help the community.
+대화에 참여하고 커뮤니티에 기여하세요.
 
-- [X (formerly Twitter)][X (formerly Twitter)]
+- [X (구 Twitter)][X (formerly Twitter)]
 - [Bluesky][bluesky]
 - [Discord][discord]
 - [Gitter][gitter]
 - [YouTube][youtube]
 - [StackOverflow][stackoverflow]
-- Find a Local [Meetup][meetup]
+- 지역 [밋업][meetup] 찾기
 
 [![Love Angular badge](https://img.shields.io/badge/angular-love-blue?logo=angular&angular=love)](https://www.github.com/angular/angular)
 
-**Love Angular? Give our repo a star :star: :arrow_up:.**
+**Angular를 좋아하시나요? 저장소에 별표를 눌러주세요! :star: :arrow_up:**
 
 [contributing]: CONTRIBUTING.md
 [quickstart]: https://angular.dev/tutorials/learn-angular
 [changelog]: CHANGELOG.md
-[ng]: https://angular.dev
-[documentation]: https://angular.dev/overview
 [angularmaterial]: https://material.angular.io/
 [cli]: https://angular.dev/tools/cli
 [architecture]: https://angular.dev/essentials

TRANSLATION_CONTRIBUTING.md

@@ -0,0 +1,60 @@
+# Angular 한글 문서 번역 기여 가이드
+
+Angular 공식 문서의 한글 번역 프로젝트에 참여해 주셔서 감사합니다! 이 문서는 번역 작업에 참여하는 방법과 번역 시 지켜야 할 규칙에 대한 안내입니다.
+
+## 번역 참여 방법
+
+1. 이 저장소를 포크(Fork)합니다.
+2. 포크한 저장소를 로컬에 클론합니다.
+3. 번역할 문서를 선택합니다.
+4. 번역 작업을 수행합니다.
+5. 변경사항을 커밋하고 푸시합니다.
+6. 원본 저장소로 Pull Request를 제출합니다.
+
+## 번역 규칙
+
+### 기본 원칙
+
+1. 원문의 의미를 정확하게 전달하는 것을 최우선으로 합니다.
+2. 기술 용어는 가능한 한 한글로 번역하되, 필요시 영문을 병기합니다.
+3. 번역된 문장은 자연스러운 한글 문장이 되도록 합니다.
+4. 존칭(~합니다, ~입니다 등)을 사용합니다.
+
+### 기술 용어 번역
+
+일관성 있는 번역을 위해 다음과 같은 기술 용어 번역 사전을 참고하세요:
+
+| 영문 | 한글 번역 |
+|------|----------|
+| component | 컴포넌트 |
+| directive | 지시자 |
+| pipe | 파이프 |
+| service | 서비스 |
+| dependency injection | 의존성 주입 |
+| template | 템플릿 |
+| binding | 바인딩 |
+| router | 라우터 |
+| module | 모듈 |
+| decorator | 데코레이터 |
+
+위 목록에 없는 용어는 [용어 토론 이슈](https://github.com/your-username/angular/issues)를 통해 논의할 수 있습니다.
+
+### 번역 검토 프로세스
+
+1. Pull Request가 제출되면 다른 기여자들이 코드 리뷰를 진행합니다.
+2. 리뷰어는 다음 사항을 확인합니다:
+   - 원문의 의미가 정확하게 전달되었는지
+   - 번역 규칙이 준수되었는지
+   - 문법적 오류가 없는지
+   - 용어 사용이 일관적인지
+3. 리뷰를 통과한 번역은 메인 브랜치에 병합됩니다.
+
+## 번역 진행 상황 확인
+
+현재 번역 진행 상황은 [이슈 페이지](https://github.com/your-username/angular/issues)에서 확인할 수 있습니다. 번역을 시작하기 전에 다른 기여자가 이미 해당 문서를 번역하고 있는지 확인하세요.
+
+## 문의 및 도움말
+
+번역 작업 중 질문이나 도움이 필요하시면 [이슈](https://github.com/your-username/angular/issues)를 등록하거나 [디스코드 채널](#)에 참여하세요.
+
+함께 Angular 공식 문서의 한글화를 완성해 나가요!

adev/README.md

@@ -1,53 +1,51 @@
 # [Angular.dev](https://www.angular.dev)
 
-This site is built with Angular.
+이 사이트는 Angular로 구축되었습니다.
 
-The content is written primarily in Markdown format located in `src/content`. For simple edits, you can directly edit the file on GitHub and generate a Pull Request.
+내용은 주로 `src/content`에 위치한 Markdown 형식으로 작성되어 있습니다. 간단한 수정의 경우, GitHub에서 파일을 직접 수정하고 Pull Request를 생성할 수 있습니다.
 
-## Local Development
+## 로컬 개발
 
-For local development, [yarn](https://yarnpkg.com/) is the preferred package manager. You can set up a local environment with the following commands
-:
+로컬 개발을 위해 [yarn](https://yarnpkg.com/)이 선호되는 패키지 관리자입니다. 다음 명령어로 로컬 환경을 설정할 수 있습니다:
 
 ```bash
-# Clone Angular repo
+# Angular 레포지토리 클론
 git clone https://github.com/angular/angular.git
 
-# Navigate to project directory
+# 프로젝트 디렉토리로 이동
 cd angular
 
-# Install dependencies
+# 의존성 설치
 yarn
 
-# Build and run local dev server
-# Note: Initial build will take some time
+# 로컬 개발 서버 빌드 및 실행
+# 주의: 초기 빌드는 시간이 걸릴 수 있습니다
 yarn docs
 ```
 
-If you are having issues with the docs building, see the [FAQs](#faqs) section.
+문서 빌드에 문제가 있는 경우, [자주 묻는 질문(FAQs)](#faqs) 섹션을 참조하세요.
 
-## Contributing
+## 기여
 
-Want to report a bug, contribute some code, or improve the documentation? Excellent!
+버그를 보고하거나, 코드를 기여하거나, 문서를 개선하고 싶으신가요? 훌륭합니다!
 
-Read through our [contributing guidelines](/CONTRIBUTING.md) to learn about our submission process, coding rules, and more.
+우리의 [기여 가이드라인](/CONTRIBUTING.md)을 읽고 제출 프로세스, 코딩 규칙 등을 알아보세요.
 
-And if you're new, check out one of our issues labeled as <kbd>[help wanted](https://github.com/angular/angular/labels/help%20wanted)</kbd> or <kbd>[good first issue](https://github.com/angular/angular/labels/good%20first%20issue)</kbd>.
+그리고 새로 오셨다면, <kbd>[도움 필요](https://github.com/angular/angular/labels/help%20wanted)</kbd> 또는 <kbd>[좋은 첫 문제](https://github.com/angular/angular/labels/good%20first%20issue)</kbd>로 라벨이 붙은 문제 중 하나를 확인해 보세요.
 
-### Code of Conduct
+### 행동 강령
 
-Help us keep Angular open and inclusive. Please read and follow our [Code of Conduct](/CODE_OF_CONDUCT.md).
+Angular를 개방적이고 포용적으로 유지하는 데 도움을 주세요. 우리의 [행동 강령](/CODE_OF_CONDUCT.md)을 읽고 따르세요.
 
-## FAQs
+## 자주 묻는 질문(FAQs)
 
-### The build is failing and I'm seeing `bazel:bazel failed: missing input file` messages.
+### 빌드에 실패하고 `bazel:bazel failed: missing input file` 메시지가 표시됩니다.
 
-This is most likely due to a bazel dependency / caching issue. To resolve this, run the following command:
+이는 대부분 bazel 의존성 / 캐싱 문제 때문일 가능성이 높습니다. 이를 해결하려면 다음 명령어를 실행하세요:
 
 ```
-# Try this first
+# 먼저 이걸 시도하세요
 yarn bazel clean
 
-# If that doesn't work, try it with the expunge flag
-yarn bazel clean --expunge
-```
+# 그것이 작동하지 않으면, expunge 플래그와 함께 시도하세요
+yarn bazel clean --expunge

adev/scripts/update-cli-help/README.md

@@ -1,3 +1,3 @@
-# Generating data for `angular.dev/cli`
+# `angular.dev/cli`를 위한 데이터 생성
 
-This script updates the Angular CLI help JSON files stored in `adev/src/content/cli/help`. This files are used to generate the [angular.dev CLI](https://angular.dev/cli) pages.
+이 스크립트는 `adev/src/content/cli/help`에 저장된 Angular CLI 도움말 JSON 파일을 업데이트합니다. 이 파일들은 [angular.dev CLI](https://angular.dev/cli) 페이지를 생성하는 데 사용됩니다.

adev/shared-docs/pipeline/api-gen/rendering/regions/README.md

@@ -1,3 +1,3 @@
-# Code Regions
+# 코드 영역
 
-All the files in the regions folder were implemented based on angular.io: <https://github.com/angular/angular/tree/17.2.x/aio/tools/transforms/examples-package/services>.
+regions 폴더의 모든 파일은 angular.io를 기반으로 구현되었습니다: <https://github.com/angular/angular/tree/17.2.x/aio/tools/transforms/examples-package/services>.