Skip to content

Commit b81a1e0

Browse files
Copilotjustinyoo
andauthored
[WIP] Add Korean localisation for all markdown files (#21)
* Initial plan for issue * Add Korean localization for root files and complete directories Co-authored-by: justinyoo <1538528+justinyoo@users.noreply.github.com> * Add Korean localization for docs directory (partial) Co-authored-by: justinyoo <1538528+justinyoo@users.noreply.github.com> * Complete Korean localization for all required markdown files Co-authored-by: justinyoo <1538528+justinyoo@users.noreply.github.com> * Fix hero image path in Korean README.md to point to correct relative path Co-authored-by: justinyoo <1538528+justinyoo@users.noreply.github.com> * Fix image paths in Korean localized docs to point to correct relative paths Co-authored-by: justinyoo <1538528+justinyoo@users.noreply.github.com> * Complete Korean localization of JavaScript documentation with all missing sections Co-authored-by: justinyoo <1538528+justinyoo@users.noreply.github.com> * Complete Korean localization of Java documentation with all missing sections Co-authored-by: justinyoo <1538528+justinyoo@users.noreply.github.com> * Complete Korean localization for .NET and Containerization documentation with all missing sections Co-authored-by: justinyoo <1538528+justinyoo@users.noreply.github.com> * Complete localization of all English prompts in Korean documentation Co-authored-by: justinyoo <1538528+justinyoo@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: justinyoo <1538528+justinyoo@users.noreply.github.com>
1 parent 7167bce commit b81a1e0

24 files changed

Lines changed: 2387 additions & 0 deletions

File tree

localisation/ko/README.md

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,100 @@
1+
# GitHub Copilot Vibe 코딩 워크샵
2+
3+
![GitHub Copilot - Ghiblifiled](../../images/ghcp.jpg)
4+
5+
Python, JavaScript, Java, .NET 등 다양한 프로그래밍 언어에서 [GitHub Copilot](https://docs.github.com/copilot/about-github-copilot/what-is-github-copilot)과 최신 기능들로 바이브 코딩을 하고, 컨테이너화를 통해 앱을 클라우드 네이티브로 만들어 보세요. 뛰어들 준비가 되셨나요?
6+
7+
## 배경
8+
9+
Contoso는 다양한 야외 활동 제품을 판매하는 회사입니다. Contoso의 마케팅 부서는 기존 고객과 잠재 고객에게 제품을 홍보하기 위한 마이크로 소셜 미디어 웹사이트를 런칭하고자 합니다. 첫 번째 MVP로서, 웹사이트를 빠르게 구축하고자 합니다. Contoso의 IT 부서에는 현재 각각 Python과 JavaScript를 사용하는 두 명의 개발자가 있습니다. 출시일이 빠르게 다가오고 있어서, 두 개발자 모두 애플리케이션을 빠르게 개발해야 합니다.
10+
11+
하지만 상황은 다음과 같습니다...
12+
13+
## 워크샵 목표
14+
15+
- GitHub Copilot 에이전트 모드를 사용하여 애플리케이션 구축하기.
16+
- GitHub Copilot에 커스텀 지시사항을 추가하여 GitHub Copilot을 더 잘 제어하기.
17+
- GitHub Copilot에 다양한 MCP 서버를 추가하여 애플리케이션을 더 정확하게 구축하기.
18+
19+
## 전제 조건
20+
21+
이 워크샵에서는 웹 브라우저 외에 별도의 준비가 필요 없기 때문에 [GitHub Codespaces](https://docs.github.com/en/codespaces/about-codespaces/what-are-codespaces)를 적극 권장합니다. 하지만 정말로 본인의 머신을 사용해야 한다면, 아래에서 확인된 모든 것들을 설치했는지 확인하세요.
22+
23+
### 공통
24+
25+
- [Visual Studio Code](https://code.visualstudio.com/)
26+
- VS Code [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) 확장
27+
- VS Code [GitHub Copilot Chat](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot-chat) 확장
28+
- 💥 Windows 사용자용 👉 [PowerShell 7](https://learn.microsoft.com/powershell/scripting/install/installing-powershell)
29+
- [git CLI](https://git-scm.com/downloads)
30+
- [GitHub CLI](https://cli.github.com/)
31+
- [Docker Desktop](https://docs.docker.com/get-started/introduction/get-docker-desktop/)
32+
33+
### Python
34+
35+
- [pyenv](https://github.com/pyenv/pyenv) 또는 [pyenv for Windows](https://github.com/pyenv-win/pyenv-win)
36+
- pyenv를 통한 Python 3.12+
37+
- `uv` 패키지 관리자 (권장) 또는 `pip`
38+
- VS Code [Python](https://marketplace.visualstudio.com/items/?itemName=ms-python.python) 확장
39+
- VS Code [Pylance](https://marketplace.visualstudio.com/items/?itemName=ms-python.vscode-pylance) 확장
40+
- VS Code [Python Debugger](https://marketplace.visualstudio.com/items/?itemName=ms-python.debugpy) 확장
41+
- VS Code [autopep8](https://marketplace.visualstudio.com/items/?itemName=ms-python.autopep8) 확장
42+
43+
### JavaScript
44+
45+
- [nvm](https://github.com/nvm-sh/nvm) 또는 [nvm for Windows](https://github.com/coreybutler/nvm-windows)
46+
- nvm을 통한 최신 LTS [Node.js](https://nodejs.org/)
47+
48+
### Java
49+
50+
- [SDKMAN](https://sdkman.io/)
51+
- SDKMAN을 통한 [OpenJDK 21](https://learn.microsoft.com/java/openjdk/download)
52+
- SDKMAN을 통한 [Apache Maven](https://maven.apache.org/download.cgi)
53+
- SDKMAN을 통한 [Gradle Build Tool](https://docs.gradle.org/current/userguide/installation.html)
54+
- SDKMAN을 통한 [Spring Boot Initializr](https://docs.spring.io/spring-boot/cli/installation.html)
55+
- VS Code [Extension Pack for Java](https://marketplace.visualstudio.com/items/?itemName=vscjava.vscode-java-pack) 확장
56+
- VS Code [Spring Boot Extension Pack](https://marketplace.visualstudio.com/items/?itemName=vmware.vscode-boot-dev-pack) 확장
57+
58+
### .NET
59+
60+
- [.NET SDK 9](https://dotnet.microsoft.com/download/dotnet/9.0)
61+
- [VS Code C# Dev Kit](https://marketplace.visualstudio.com/items/?itemName=ms-dotnettools.csdevkit) 확장
62+
63+
## 제품 요구사항 문서
64+
65+
먼저 시작할 곳은 이 [PRD (제품 요구사항 문서)](./product-requirements.md)입니다. 이 문서는 무엇을 해야 하고 어떻게 해야 하는지에 대한 더 나은 이해를 제공할 것입니다.
66+
67+
## 워크샵 지침
68+
69+
아래 링크를 따라 진행하는 자기 주도 워크샵입니다:
70+
71+
| 단계 | 링크 |
72+
|------------------------------------|---------------------------------------------------------|
73+
| 00: 개발 환경 | [00-setup.md](./docs/00-setup.md) |
74+
| 01: Python 백엔드 | [01-python.md](./docs/01-python.md) |
75+
| 02: JavaScript 프론트엔드 | [02-javascript.md](./docs/02-javascript.md) |
76+
| 03: Python에서 Java로 마이그레이션 | [03-java.md](./docs/03-java.md) |
77+
| 04: JavaScript에서 .NET으로 마이그레이션 | [04-dotnet.md](./docs/04-dotnet.md) |
78+
| 05: 컨테이너화 | [05-containerization.md](./docs/05-containerization.md) |
79+
80+
## 완성된 샘플
81+
82+
각 애플리케이션의 완성된 예제를 확인해보세요. 이들도 GitHub Copilot으로 바이브 코딩되었기 때문에 완벽하지 않을 수 있으며, 앱을 따라할 필요는 없습니다.
83+
84+
| 언어 | 애플리케이션 | 위치 |
85+
|---------------------|-------------|--------------------------------------|
86+
| Python 백엔드 | FastAPI | [python](./complete/python/) |
87+
| JavaScript 프론트엔드 | React | [javascript](./complete/javascript/) |
88+
| Java 백엔드 | Spring Boot | [java](./complete/java/) |
89+
| .NET 프론트엔드 | Blazor | [dotnet](./complete/dotnet/) |
90+
| 컨테이너화 | Container | [containerization](./complete/) |
91+
92+
## 더 읽어보기...
93+
94+
- [GitHub Codespaces](https://docs.github.com/en/codespaces/about-codespaces/what-are-codespaces)
95+
- [GitHub Copilot](https://docs.github.com/en/copilot/about-github-copilot/what-is-github-copilot)
96+
- [GitHub Copilot: Agent Mode](https://code.visualstudio.com/blogs/2025/04/07/agentMode)
97+
- [GitHub Copilot: MCP](https://code.visualstudio.com/blogs/2025/05/12/agent-mode-meets-mcp)
98+
- [GitHub Copilot: Custom Instructions](https://code.visualstudio.com/docs/copilot/copilot-customization)
99+
- [GitHub Copilot: Changing AI Models](https://docs.github.com/en/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat?tool=vscode)
100+
- [Curated MCP Servers](https://github.com/modelcontextprotocol/servers)

localisation/ko/complete/README.md

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# 완성된 앱 샘플
2+
3+
완성된 앱 샘플 목록입니다. 이들도 바이브 코딩으로 만들어졌기 때문에, 어떻게 구축되었는지 확인할 수 있습니다.
4+
5+
| 애플리케이션 | 위치 |
6+
|-------------|-----------------------------|
7+
| FastAPI | [python](./python/) |
8+
| React | [javascript](./javascript/) |
9+
| Spring Boot | [java](./java/) |
10+
| Blazor | [dotnet](./dotnet/) |
11+
12+
## 컨테이너화 샘플
13+
14+
### 전제 조건
15+
16+
준비를 위해 [README](../README.md) 문서를 참조하세요.
17+
18+
### 시작하기
19+
20+
1. Docker가 실행 중인지 확인하세요.
21+
22+
```bash
23+
docker info
24+
```
25+
26+
1. 저장소 루트를 가져오세요.
27+
28+
```bash
29+
# bash/zsh
30+
REPOSITORY_ROOT=$(git rev-parse --show-toplevel)
31+
```
32+
33+
```powershell
34+
# PowerShell
35+
$REPOSITORY_ROOT = git rev-parse --show-toplevel
36+
```
37+
38+
1. `complete` 디렉터리로 이동하세요.
39+
40+
```bash
41+
cd $REPOSITORY_ROOT/complete
42+
```
43+
44+
1. 컨테이너화된 앱을 실행하세요.
45+
46+
```bash
47+
docker compose up --build -d
48+
```
49+
50+
1. 웹 브라우저를 열고 `http://localhost:3030`으로 이동하세요.
51+
1. 웹 애플리케이션이 제대로 실행되는지 확인하세요.
52+
1. 다음 명령을 실행하여 컨테이너화된 앱을 제거하고 정리하세요.
53+
54+
```bash
55+
docker compose down --rmi all
56+
```
Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# .NET 앱 샘플
2+
3+
## 전제 조건
4+
5+
준비를 위해 [README](../../README.md) 문서를 참조하세요.
6+
7+
## 시작하기
8+
9+
### Spring Boot 백엔드 실행
10+
11+
[Java 앱 샘플](../java/)을 사용하세요.
12+
13+
> **참고**: GitHub Codespaces를 사용하는 경우, Java 앱 포트 `8080`**public**으로 설정되어 있는지 확인하세요.
14+
15+
### Blazor 프론트엔드 실행
16+
17+
1. 저장소 루트를 가져오세요.
18+
19+
```bash
20+
# bash/zsh
21+
REPOSITORY_ROOT=$(git rev-parse --show-toplevel)
22+
```
23+
24+
```powershell
25+
# PowerShell
26+
$REPOSITORY_ROOT = git rev-parse --show-toplevel
27+
```
28+
29+
1. 앱을 실행하세요.
30+
31+
```bash
32+
dotnet watch run --project $REPOSITORY_ROOT/complete/dotnet/Contoso.BlazorApp
33+
```
34+
35+
1. 웹 애플리케이션이 제대로 실행되는지 확인하세요.

0 commit comments

Comments
 (0)