Skip to content

Commit 4f2a2d5

Browse files
committed
docs: readmeを日本語化
1 parent 31099db commit 4f2a2d5

File tree

9 files changed

+275
-271
lines changed

9 files changed

+275
-271
lines changed

00-quick-start/README.md

Lines changed: 52 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,44 @@
11
![Chapter 00: Quick Start](images/chapter-header.png)
22

3-
Welcome! In this chapter, you'll get GitHub Copilot CLI (Command Line Interface) installed, signed in with your GitHub account, and verified that everything works. This is a quick setup chapter. Once you're up and running, the real demos start in Chapter 01!
3+
ようこそ。この章では、GitHub Copilot CLI (Command Line Interface) のインストール、GitHub account での sign in、そして正常に動作することの確認までを行います。まずは短い setup 編です。準備ができたら、本格的な demo は Chapter 01 から始まります。
44

5-
## 🎯 Learning Objectives
5+
## 🎯 学習目標
66

7-
By the end of this chapter, you'll have:
7+
この章を終える頃には、次のことができるようになります。
88

9-
- Installed GitHub Copilot CLI
10-
- Signed in with your GitHub account
11-
- Verified it works with a simple test
9+
- GitHub Copilot CLI を install する
10+
- GitHub account で sign in する
11+
- 簡単な test で動作確認する
1212

13-
> ⏱️ **Estimated Time**: ~10 minutes (5 min reading + 5 min hands-on)
13+
> ⏱️ **想定時間**: 10 分 (読む時間 5 分 + hands-on 5 分)
1414
1515
---
1616

17-
## Prerequisites
17+
## 前提条件
1818

19-
- **GitHub Account** with Copilot access. [See subscription options](https://github.com/features/copilot/plans). Students/Teachers can access Copilot Pro for [free via GitHub Education](https://education.github.com/pack).
20-
- **Terminal basics**: Comfortable with commands like `cd` and `ls`
19+
- **GitHub Account** Copilot access を持っていること。[subscription options](https://github.com/features/copilot/plans) はこちら。学生・教職員は [GitHub Education](https://education.github.com/pack) 経由で Copilot Pro を無料利用できます。
20+
- **Terminal の基本操作**: `cd` `ls` のようなコマンドに慣れていること
2121

22-
### What "Copilot Access" Means
22+
### Copilot Access」とは
2323

24-
GitHub Copilot CLI requires an active Copilot subscription. You can check your status at [github.com/settings/copilot](https://github.com/settings/copilot). You should see one of:
24+
GitHub Copilot CLI を使うには、有効な Copilot subscription が必要です。状態は [github.com/settings/copilot](https://github.com/settings/copilot) で確認できます。次のいずれかが表示されているはずです。
2525

2626
- **Copilot Individual** - Personal subscription
2727
- **Copilot Business** - Through your organization
2828
- **Copilot Enterprise** - Through your enterprise
2929
- **GitHub Education** - Free for verified students/teachers
3030

31-
If you see "You don't have access to GitHub Copilot," you'll need to use the free option, subscribe to a plan, or join an organization that provides access.
31+
もし "You don't have access to GitHub Copilot" と表示された場合は、free option の利用、plan への subscription、または access を提供している organization への参加が必要です。
3232

3333
---
3434

3535
## Installation
3636

37-
> ⏱️ **Time estimate**: Installation takes 2-5 minutes. Authentication adds another 1-2 minutes.
37+
> ⏱️ **目安時間**: Installation は 2〜5 分ほどです。Authentication にはさらに 1〜2 分かかります。
3838
3939
### GitHub Codespaces (Zero Setup)
4040

41-
If you don't want to install any of the prerequisites you can use GitHub Codespaces, which has the GitHub Copilot CLI ready to go (you'll need to sign in), and pre-installs Python and pytest.
41+
前提ソフトを local に install したくない場合は、GitHub Codespaces を利用できます。GitHub Copilot CLI がすぐ使える状態で用意されており、Python と pytest もあらかじめ install されています。必要なのは sign in だけです。
4242

4343
1. [Fork this repository](https://github.com/github/copilot-cli-for-beginners/fork) to your GitHub account
4444
2. Select **Code** > **Codespaces** > **Create codespace on main**
@@ -49,7 +49,7 @@ If you don't want to install any of the prerequisites you can use GitHub Codespa
4949
5050
### Local Installation
5151

52-
Follow these steps if you'd like to run Copilot CLI on your local machine with the course samples.
52+
course sample を使いながら local machine 上で Copilot CLI を動かしたい場合は、次の手順に従ってください。
5353

5454
1. Clone the repo to get the course samples on your machine:
5555

@@ -91,7 +91,7 @@ Follow these steps if you'd like to run Copilot CLI on your local machine with t
9191

9292
## Authentication
9393

94-
Open a terminal window at the root of the `copilot-cli-for-beginners` repository, start the CLI and allow access to the folder.
94+
`copilot-cli-for-beginners` repository の root で terminal を開き、CLI を起動して folder への access を許可します。
9595

9696
```bash
9797
copilot
@@ -101,33 +101,33 @@ You'll be asked to trust the folder containing the repository (if you haven't al
101101

102102
<img src="images/copilot-trust.png" alt="Trusting files in a folder with the Copilot CLI" width="800"/>
103103

104-
After trusting the folder, you can sign in with your GitHub account.
104+
folder を trust したら、GitHub account で sign in できます。
105105

106106
```
107107
> /login
108108
```
109109

110-
**What happens next:**
110+
**このあと起きること:**
111111

112-
1. Copilot CLI displays a one-time code (like `ABCD-1234`)
113-
2. Your browser opens to GitHub's device authorization page. Sign in to GitHub if you haven't already.
114-
3. Enter the code when prompted
115-
4. Select "Authorize" to grant GitHub Copilot CLI access
116-
5. Return to your terminal - you're now signed in!
112+
1. Copilot CLI が 1 回限りの code (例: `ABCD-1234`) を表示します
113+
2. browser GitHubdevice authorization page を開きます。まだなら GitHub に sign in してください
114+
3. 表示された code を入力します
115+
4. "Authorize" を選んで GitHub Copilot CLI への access を許可します
116+
5. terminal に戻れば sign in 完了です
117117

118118
<img src="images/auth-device-flow.png" alt="Device Authorization Flow - showing the 5-step process from terminal login to signed-in confirmation" width="800"/>
119119

120-
*The device authorization flow: your terminal generates a code, you verify it in the browser, and Copilot CLI is authenticated.*
120+
*device authorization flow では、terminal code を生成し、それを browser で確認することで Copilot CLI が認証されます。*
121121

122-
**Tip**: The sign-in persists across sessions. You only need to do this once unless your token expires or you explicitly sign out.
122+
**Tip**: sign-in 状態は session をまたいで保持されます。token が期限切れになるか、明示的に sign out しない限り、通常は 1 回だけで大丈夫です。
123123

124124
---
125125

126-
## Verify It Works
126+
## 動作確認
127127

128-
### Step 1: Test Copilot CLI
128+
### Step 1: Copilot CLI を test する
129129

130-
Now that you're signed in, let's verify that Copilot CLI is working for you. In the terminal, start the CLI if you haven't already:
130+
sign in が完了したので、Copilot CLI が正しく動いているか確認しましょう。まだ起動していない場合は terminalCLI を開始します。
131131

132132
```bash
133133
> Say hello and tell me what you can help with
@@ -152,11 +152,11 @@ After you receive a response, you can exit the CLI:
152152
153153
---
154154
155-
**Expected output**: A friendly response listing Copilot CLI's capabilities.
155+
**期待される出力**: Copilot CLI ができることを案内する、フレンドリーな応答が返ってきます。
156156
157-
### Step 2: Run the Sample Book App
157+
### Step 2: Sample Book App を動かす
158158
159-
The course provides a sample app that you'll explore and improve throughout the course using the CLI *(You can see the code for this in /samples/book-app-project)*. Check that the *Python book collection terminal app* works before you get started. Run `python` or `python3` depending on your system.
159+
この course では、CLI を使って継続的に確認・改善していく sample app を用意しています *(code /samples/book-app-project にあります)*。始める前に、この *Python book collection terminal app* が動くことを確認してください。system に応じて `python` または `python3` を使用します。
160160
161161
> **Note:** The primary examples shown throughout the course use Python (`samples/book-app-project`) so you'll need to have [Python 3.10+](https://www.python.org/downloads/) available on your local machine if you chose that option (the Codespace already has it installed). JavaScript (`samples/book-app-project-js`) and C# (`samples/book-app-project-cs`) versions are also available if you prefer to work with those languages. Each sample has a README with instructions for running the app in that language.
162162

@@ -165,9 +165,9 @@ cd samples/book-app-project
165165
python book_app.py list
166166
```
167167

168-
**Expected output**: A list of 5 books including "The Hobbit", "1984", and "Dune".
168+
**期待される出力**: "The Hobbit""1984""Dune" を含む 5 冊の本の一覧が表示されます。
169169

170-
### Step 3: Try Copilot CLI with the Book App
170+
### Step 3: Book App と一緒に Copilot CLI を試す
171171

172172
Navigate back to the repository root first (if you ran Step 2):
173173

@@ -177,9 +177,9 @@ copilot
177177
> What does @samples/book-app-project/book_app.py do?
178178
```
179179

180-
**Expected output**: A summary of the book app's main functions and commands.
180+
**期待される出力**: book app の主な機能と command を要約した説明が返ってきます。
181181

182-
If you see an error, check the [troubleshooting section](#troubleshooting) below.
182+
もし error が出た場合は、下の [troubleshooting section](#troubleshooting) を確認してください。
183183

184184
Once you're done you can exit the Copilot CLI:
185185
@@ -189,19 +189,19 @@ Once you're done you can exit the Copilot CLI:
189189
190190
---
191191
192-
## ✅ You're Ready!
192+
## ✅ 準備完了です
193193
194-
That's it for installation. The real fun starts in Chapter 01, where you'll:
194+
installation はこれで完了です。本番は Chapter 01 から始まります。次のことを体験します。
195195
196-
- Watch AI review the book app and find code quality issues instantly
197-
- Learn three different ways to use Copilot CLI
198-
- Generate working code from plain English
196+
- AI book app を review して code quality の課題をすぐ見つける
197+
- Copilot CLI の 3 つの使い方を学ぶ
198+
- plain English から動く code を生成する
199199
200200
**[Continue to Chapter 01: First Steps →](../01-setup-and-first-steps/README.md)**
201201
202202
---
203203
204-
## Troubleshooting
204+
## トラブルシューティング
205205
206206
### "copilot: command not found"
207207
@@ -229,11 +229,11 @@ copilot
229229
> /login
230230
```
231231

232-
### Browser doesn't open automatically
232+
### Browser が自動で開かない場合
233233

234234
Manually visit [github.com/login/device](https://github.com/login/device) and enter the code shown in your terminal.
235235

236-
### Token expired
236+
### Token の期限が切れた場合
237237

238238
Simply run `/login` again:
239239

@@ -242,19 +242,19 @@ copilot
242242
> /login
243243
```
244244

245-
### Still stuck?
245+
### まだ解決しない場合
246246

247-
- Check the [GitHub Copilot CLI documentation](https://docs.github.com/copilot/concepts/agents/about-copilot-cli)
248-
- Search [GitHub Issues](https://github.com/github/copilot-cli/issues)
247+
- [GitHub Copilot CLI documentation](https://docs.github.com/copilot/concepts/agents/about-copilot-cli) を確認する
248+
- [GitHub Issues](https://github.com/github/copilot-cli/issues) を検索する
249249

250250
---
251251

252-
## 🔑 Key Takeaways
252+
## 🔑 重要なポイント
253253

254-
1. **A GitHub Codespace is a quick way to get started** - Python, pytest, and GitHub Copilot CLI are all pre-installed so you can jump right into the demos
255-
2. **Multiple installation methods** - Choose what works for your system (Homebrew, WinGet, npm, or install script)
256-
3. **One-time authentication** - Login persists until token expires
257-
4. **The book app works** - You'll use `samples/book-app-project` throughout the entire course
254+
1. **GitHub Codespace は最短の始め方です** - PythonpytestGitHub Copilot CLI pre-install 済みなので、すぐに demo を始められます
255+
2. **複数の installation 方法があります** - HomebrewWinGetnpminstall script から環境に合うものを選べます
256+
3. **authentication は基本 1 回です** - token の期限が切れるまで login 状態が保持されます
257+
4. **book app が今後の教材になります** - `samples/book-app-project` course 全体で使います
258258

259259
> 📚 **Official Documentation**: [Install Copilot CLI](https://docs.github.com/copilot/how-tos/copilot-cli/cli-getting-started) for installation options and requirements.
260260

0 commit comments

Comments
 (0)