Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,17 @@ export default defineConfig({
// },
// ],
// },
{
label: "Git・GitHub",
link: "/textbook/git/version-control",
icon: "seti:git",
items: [
{
label: "Git入門",
autogenerate: { directory: "textbook/git" },
},
],
},
{
label: "Web",
link: "/textbook/web/for-classes/html-structure-basic",
Expand Down
91 changes: 91 additions & 0 deletions src/content/docs/textbook/git/01--version-control.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
---
title: バージョン管理ツールとは何か?
description: Gitの基本概念とバージョン管理ツールの必要性について解説します
slug: textbook/git/version-control
sidebar:
order: 1
---

## Gitとは何か?

Gitは**バージョン管理システム**の1つです。

- ファイルの**変更履歴**を管理してくれる
- チーム開発の**コード管理**をしてくれる

## Gitはどういうときに使うのか

- データを**戻したい**とき
- データを**混ぜ合わせる**とき
- コードの**バックアップ**をとるとき

## 例1: データをバックアップから戻したい時

### 従来の方法の欠点

課題などで、途中まで出来て一応バックアップを取りたい時、とりあえずフォルダごとコピーを取る方法には以下の欠点があります:

- どれが最新かわからないときも
- 戻す時に、コピペで戻すため事故るときがある(バックアップを消すなど)

![](./_images/vscode-page-011.png)

### Gitを使った場合の利点

Gitを用いると、ブランチを分けて簡単に戻せます。

- グラフで簡単に最新のコードが何かわかる
- ブランチを変えることでコードを戻すこともできる
- GitHubに上げることで、リモートでバックアップもできる

![](./_images/vscode-page-012.png)

## 例2: データを混ぜる時

### 従来の方法の欠点

みんなで開発をしている時に、コードを一つにまとめたい時がある。その時に、どこが変わっているのか差分を自分で見て直す必要がある。

- どこが変更されたか手動でみる
- どのファイルがマージ対象か自分で見極めないといけない
- 複数ファイルあると地獄をみる

### Gitを使った場合の利点

Gitを用いると、コマンド一つでまとめたり、差分を簡単に表示をしてくれる。

- グラフで簡単にどのような混ざり方をしているか見れる
- マージを間違えた時に簡単に戻せる
- 差分を表示したり、混ぜたりするツールが揃っている

## 例3: チームで共同開発をするとき

### 従来の方法の欠点

変更点だったり、コードの状態をクラウドストレージで管理をする方法には以下の欠点があります:

- ファイルが乱立してどれかわからん
- プロジェクト全体でコードを最新に保てない
- 勝手にコードを混ぜられる危険がある

![](./_images/vscode-page-015.png)

### Git・GitHubを使った場合の利点

Git・GitHubを用いると、コードの管理をWeb上でまとめることができる。

- Git Cloneでプロジェクトを簡単に持ってこれる
- Git pullで簡単に最新にできる
- GitHubの便利なWebツールでコードを管理できる

![](./_images/vscode-page-016.png)

## コラム: チーム開発をする時に大事なこと

- 些細な問題でも、**違和感を感じたら**、すぐに連絡をする
- コミュニケーションが大事
- マージをする時は、**勝手にマージをしない**
- プロジェクト全体で連絡をする
- こまめにバックアップ、コミット、プルリクを出す
- **大きすぎる変更点は事故の元**
- ビッグバン変更点は出さないように
106 changes: 106 additions & 0 deletions src/content/docs/textbook/git/02--git-install.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,106 @@
---
title: Gitのインストール
description: Mac/WindowsでのGitのインストール手順を解説します
slug: textbook/git/git-install
sidebar:
order: 2
---

## ターミナル/コマンドプロンプトを起動しよう

### Macの場合

1. `Command` + `Space` キーを押す
2. 「ターミナル」と入力
3. Enterを押す

ターミナルが起動します。

![](./_images/vscode-page-019.png)

### Windowsの場合

1. `Windows` キー + `R` キーを押す
2. 「cmd」と入力
3. OKを押す

コマンドプロンプトが立ち上がるはずです。

![](./_images/vscode-page-020.png)

## Gitが入っているか確認してみよう

以下のコマンドを入力して、Gitがインストールされているか確認しましょう。

```bash
git version
```

出力例:
```
git version 2.33.0.windows.2
```

![](./_images/vscode-page-022.png)

Gitのバージョンが帰ってこない場合、インストールが出来ていません。インストールから始めましょう!

## Gitをインストールしてみる(Mac)

Homebrewを使ってGitをインストールします。

```bash
brew install git
```

インストール後、バージョンを確認します。

```bash
git -v
```

出力例:
```
git version 2.37.0
```

![](./_images/vscode-page-023.png)

バージョンが帰ってきたらインストール完了です。

### Homebrewが入っていない方へ

Homebrewが入っていない方は以下のコマンドを実行してください。

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

```bash
echo 'eval $(/opt/homebrew/bin/brew shellenv)' >> ~/.zprofile
```

```bash
eval $(/opt/homebrew/bin/brew shellenv)
```

Homebrewがインストールされたか確認します。

```bash
brew -v
```

出力例:
```
Homebrew 3.5.4
Homebrew/homebrew-core (git revision 7d69acd3065; last commit 2022-07-13)
Homebrew/homebrew-cask (git revision ce084d024b; last commit 2022-07-13)
```

## インストール手順(Windows)

Windowsの場合は、以下のURLを参照してください。

https://prog-8.com/docs/git-env-win

チャプター1「Gitのインストール」まで行ってください。
105 changes: 105 additions & 0 deletions src/content/docs/textbook/git/03--github-account.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
---
title: GitHubアカウントを作成しよう
description: GitHubアカウントの作成手順を解説します
slug: textbook/git/github-account
sidebar:
order: 3
---

## GitHubとは?

GitHub上にコードをあげてネットに**公開**したり、チーム開発でコードを**集結**させるのに用います。

![](./_images/vscode-page-027.png)

## GitHubとGitの違いは?

| GitHub | Git |
|--------|-----|
| オンラインでソースコードを保存してくれるサービスの名前 | バージョン管理をするシステムの名前 |

Gitは「プロジェクトやソースコードのバージョン管理を行うツール」です。過去に書いたコードの内容を復元したり、複数人での同時作業を効率的に進められる。

一方で、GitHubはGitを利用した開発者向けのウェブサービスです。GitHubには開発者にとって便利な機能が多く提供されている。Gitを使った他のウェブサービスも存在しますが、世界的に最も広く使われているのはGitHubである。

## アカウントを作成しましょう

プログラミングを行うに当たって便利なものです。アカウントを持っていない方は作っていきましょう。

## GitHubアカウントを作成する

### 1. GitHubにアクセス

https://github.com にアクセスする

### 2. サインアップを押す

画面右上の「Sign up」ボタンを押しましょう。

![](./_images/vscode-page-031.png)

### 3. メールアドレスを入力

メールアドレスを入力します。

:::tip
大学のメールにすると自動でPro版になります
:::

### 4. 必要情報を入力

以下の情報を入力します:

- **メールアドレス**: 大学のメールにすると自動でPro版になります
- **パスワード**: 大文字、小文字、数字、記号を入れる
- **ユーザー名**: 後で使うので控えておいてください
- **キャンペーンメールの許可**: 基本は「n」で大丈夫

![](./_images/vscode-page-033.png)

### 5. 認証をクリア

認証をクリアして、人間だと証明しましょう。

### 6. アカウント作成

「Create account」ボタンを押してアカウントを作成します。

![](./_images/vscode-page-035.png)

### 7. 確認コードを入力

メールアドレスに届いたコードを入力します。

![](./_images/vscode-page-036.png)

### 8. アンケートに答える

3つのアンケートに答えましょう:

1. **チーム開発はどれくらいの人数で行うのか?**
- Just me / 2-5 / 5-10 / 10-20 / 20-50 / 50+ から選択

2. **学生か先生か?**
- Student / Teacher から選択

3. **GitHubで気になるサービスを選択**
- よくわからない方は、画面のチェックに合わせてもらえれば大丈夫です

![](./_images/vscode-page-037.png)

### 9. プランを選択

プランを選択します。**Freeプラン**を選択しましょう。

「Continue for free」をクリックします。

![](./_images/vscode-page-039.png)

### 10. 完了

アカウントを作成することができました!

![](./_images/vscode-page-040.png)

これでGitHubを使う準備が整いました。
Loading