├── Basics ├── README.md ├── githubws_vscode.pdf ├── hands-on.zip └── setup_githubws_vscode.pdf ├── CUI ├── README.md ├── githubws_cui.pdf ├── hands-on.zip └── setup_git_cui_mac.pdf ├── Old ├── README.md ├── githubws_gui.pdf ├── hands-on.zip ├── setup_sourcetree_mac.pdf ├── setup_sourcetree_mac_for_event.pdf ├── setup_sourcetree_windows.pdf └── setup_sourcetree_windows_for_event.pdf ├── README.md └── Team ├── README.md ├── code.txt ├── githubws_allin.pdf ├── githubws_team.pdf ├── setup_team.pdf └── team_hands-on.zip /Basics/README.md: -------------------------------------------------------------------------------- 1 | # GitHub ワークショップ VSCode版 2 | 3 | ## 資料概要 4 | 5 | ``` 6 | . 7 | ├── README.md //この資料 8 | ├── githubws_vscode.pdf // メイン資料 9 | ├── hands-on.zip // 演習で使用するサンプルプログラムをまとめたzipファイル 10 | └── setup_githubws_vscode.pdf // 事前資料 11 | 12 | ``` 13 | 14 | ## 学習の進め方 15 | 16 | こちらの資料は、VSCodeとGit Bashまたはターミナルを使用しています。 17 | 18 | 自身の環境で、エディタやコマンドツールを既に用意できている方はそちらを使用しても問題ありません。 19 | 20 | メイン資料末尾にGitコマンドでの実行方法を記載しているのでGitの操作はそちらを参考にしてください。 21 | 22 | ### 事前準備 23 | 24 | #### 独自で学びたい方へ 25 | 26 | [セットアップ資料](./setup_githubws_vscode.pdf)を参考に、以下の事前準備を行ってください。 27 | 28 | - [VSCode](https://code.visualstudio.com/download) のインストール 29 | - [Windowsの人のみ] [Git Bash](https://gitforwindows.org/) のインストール 30 | - [GitHub](https://github.co.jp/) のアカウント作成 31 | - Gitの環境構築 32 | - GitHubへの疎通確認 33 | 34 | 準備が完了したら、[学習資料](./githubws_vscode.pdf) をダウンロードして、学習しましょう。 35 | 36 | #### イベント参加者の方へ 37 | 38 | イベントに参加される方は、こちらの[イベント参加の事前準備](https://github.com/hackujp/setup_for_event/blob/main/setup_tools_for_event.pdf)を参考に、イベントで使うツールや推奨環境を準備してください。 39 | 40 | - [Zoom](https://zoom.us/) のセットアップ 41 | - Slack のセットアップ 42 | - 招待リンクは connpass で登録後にご連絡します。 43 | - 推奨環境の確認 44 | 45 | 準備が完了したら、 46 | 上記同様に[セットアップ資料](./setup_githubws_vscode.pdf)の内容を行い、[メイン資料](./githubws_vscode.pdf) をダウンロードしておきましょう。 47 | 48 | ### メイン資料の内容 49 | 50 | #### Step.1 GitHubの基本動作 51 | 52 | - README.mdを作成/index.html を編集してみよう 53 | - 作成/変更したファイルを add してみよう 54 | - 変更したファイルの差分を確認しよう 55 | - インデックスされたファイルを commit してみよう 56 | - コミットメッセージを他の人が見て、わかりやすいように意識して記述しよう 57 | - ローカルリポジトリの変更 を push してみよう 58 | - リモートリポジトリを確認してみよう 59 | - コミットツリーを確認してみよう 60 | 61 | #### Step.2 作業ブランチを作成して、変更内容の Pull Request を作成 62 | 63 | ##### Step.2-1 作業ブランチを作成し、ファイルを Push 64 | - ブランチを作成してみよう 65 | - 作業ブランチでファイルを更新して Push してみよう 66 | - GitHub で作成したブランチと push したファイルを確認しよう 67 | 68 | ##### Step.2-2 Pull Request を作成して master に反映 69 | - GitHub で Pull Request を作成してみよう 70 | - Pull Request の中身を確認しよう 71 | - こだわった点をコメントしよう 72 | - Pull Request を merge しよう 73 | - GitHub 上で main ブランチのファイル内容を確認しよう 74 | - ローカルリポジトリの main ブランチを更新するため Pull しよう 75 | - ローカルリポジトリで main ブランチの変更を確認しよう 76 | 77 | ## 参考資料リンク 78 | - [サル先生のGit入門](https://backlog.com/ja/git-tutorial/) 79 | - [git Book 日本語版](https://git-scm.com/book/ja/v2) 80 | -------------------------------------------------------------------------------- /Basics/githubws_vscode.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Basics/githubws_vscode.pdf -------------------------------------------------------------------------------- /Basics/hands-on.zip: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Basics/hands-on.zip -------------------------------------------------------------------------------- /Basics/setup_githubws_vscode.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Basics/setup_githubws_vscode.pdf -------------------------------------------------------------------------------- /CUI/README.md: -------------------------------------------------------------------------------- 1 | # GitHub ワークショップ CUI版 2 | 3 | ## 資料概要 4 | 5 | ``` 6 | . 7 | ├── README.md //この資料 8 | ├── githubws_cui.pdf // メイン資料 9 | ├── hands-on.zip // 演習で使用するプログラムをまとめたzipファイル 10 | └── setup_git_cui_mac.pdf.pdf // セットアップ資料(MacOS版) 11 | ``` 12 | 13 | ## 学習の進め方 14 | 15 | ### 事前準備 16 | 17 | セットアップ資料 ([MacOS](./setup_git_cui_mac.pdf)) を参考に、以下の事前準備を行ってください。 18 | （Windows版は未完成です。ご了承ください） 19 | 20 | - [GitHub](https://github.co.jp/) のアカウント作成 21 | - 演習準備 22 | - GitHubへの疎通確認 23 | 24 | 準備が完了したら、[学習資料](./githubws_cui.pdf) をダウンロードして、学習しましょう。 25 | 26 | ### メイン資料の内容 27 | 28 | #### Step.1 GitHubの基本動作 29 | 30 | - README.mdを作成/index.html を編集してみよう 31 | - 作成/変更したファイルを add してみよう 32 | - 変更したファイルの差分を確認しよう 33 | - インデックスされたファイルを commit してみよう 34 | - コミットメッセージを他の人が見て、わかりやすいように意識して記述しよう 35 | - ローカルリポジトリの変更 を push してみよう 36 | - リモートリポジトリを確認してみよう 37 | 38 | #### Step.2 作業ブランチを作成して、変更内容の Pull Request を作成 39 | 40 | ##### Step.2-1 作業ブランチを作成し、ファイルを Push 41 | - ブランチを作成してみよう 42 | - 作業ブランチでファイルを更新して Push してみよう 43 | - GitHub で作成したブランチと push したファイルを確認しよう 44 | 45 | ##### Step.2-2 Pull Request を作成して master に反映 46 | - GitHub で Pull Request を作成してみよう 47 | - Pull Request の中身を確認しよう 48 | - こだわった点をコメントしよう 49 | - Pull Request を merge しよう 50 | - GitHub 上で master ブランチのファイル内容を確認しよう 51 | - ローカルリポジトリの master ブランチを更新するため Pull しよう 52 | - ローカルリポジトリで master ブランチの変更を確認しよう 53 | 54 | ## 参考資料リンク 55 | - [サル先生のGit入門](https://backlog.com/ja/git-tutorial/) 56 | - [git Book 日本語版](https://git-scm.com/book/ja/v2) 57 | -------------------------------------------------------------------------------- /CUI/githubws_cui.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/CUI/githubws_cui.pdf -------------------------------------------------------------------------------- /CUI/hands-on.zip: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/CUI/hands-on.zip -------------------------------------------------------------------------------- /CUI/setup_git_cui_mac.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/CUI/setup_git_cui_mac.pdf -------------------------------------------------------------------------------- /Old/README.md: -------------------------------------------------------------------------------- 1 | # こちらの資料は非推奨です 2 | 3 | 下記のリンクから別のツールを使う資料を参考にしてください。 4 | 5 | 推奨環境はVSCodeを用いたものになっています。 6 | 7 | - [ver_VSCode](../ver_VSCode): Windows/MacのVisual Studio Code環境 8 | - [ver_CUI](../ver_CUI): Macのターミナル環境 9 | 10 | 11 | # GitHub ワークショップ GUI版 12 | 13 | ## 資料概要 14 | 15 | ``` 16 | . 17 | ├── README.md //この資料 18 | ├── githubws_gui.pdf // メイン資料 19 | ├── hands-on.zip // 演習で使用するプログラムをまとめたzipファイル 20 | ├── setup_sourcetree_mac.pdf // セットアップ資料(MacOS版) 21 | ├── setup_sourcetree_mac_for_event.pdf // イベント参加者向けセットアップ資料(MacOS版) 22 | ├── setup_sourcetree_windows.pdf // セットアップ資料(Windows版) 23 | └── setup_sourcetree_windows_for_event.pdf // イベント参加者向けセットアップ資料(Windows版) 24 | ``` 25 | 26 | ## 学習の進め方 27 | 28 | ### 事前準備 29 | 30 | #### 独自で学びたい方へ 31 | 32 | セットアップ資料 ([Windows](./setup_sourcetree_windows.pdf), [MacOS](./setup_sourcetree_mac.pdf)) を参考に、以下の事前準備を行ってください。 33 | 34 | - [GitHub](https://github.co.jp/) のアカウント作成 35 | - [Sourcetree](https://www.sourcetreeapp.com/) のインストール 36 | - 演習準備 37 | - GitHubへの疎通確認 38 | 39 | 準備が完了したら、[学習資料](./githubws_gui.pdf) をダウンロードして、学習しましょう。 40 | 41 | 42 | #### イベント参加者の方へ 43 | 44 | イベントに参加される方は、こちらのセットアップ資料([Windows](./setup_sourcetree_windows_for_event.pdf), [MacOS](./setup_sourcetree_mac_for_event.pdf)) を参考に、上記に追加で準備を行ってください。 45 | 46 | - [zoom](https://zoom.us/) のセットアップ 47 | - slack のセットアップ 48 | - 招待リンクは connpass で登録後にご連絡します。 49 | 50 | 準備が完了したら、[学習資料](./githubws_gui.pdf) の資料をダウンロードしておきましょう。 51 | 52 | ### メイン資料の内容 53 | 54 | #### Step.1 GitHubの基本動作 55 | 56 | - README.mdを作成/index.html を編集してみよう 57 | - 作成/変更したファイルを add してみよう 58 | - 変更したファイルの差分を確認しよう 59 | - インデックスされたファイルを commit してみよう 60 | - コミットメッセージを他の人が見て、わかりやすいように意識して記述しよう 61 | - ローカルリポジトリの変更 を push してみよう 62 | - リモートリポジトリを確認してみよう 63 | - コミットツリーを確認してみよう 64 | 65 | #### Step.2 作業ブランチを作成して、変更内容の Pull Request を作成 66 | 67 | ##### Step.2-1 作業ブランチを作成し、ファイルを Push 68 | - ブランチを作成してみよう 69 | - 作業ブランチでファイルを更新して Push してみよう 70 | - GitHub で作成したブランチと push したファイルを確認しよう 71 | 72 | ##### Step.2-2 Pull Request を作成して master に反映 73 | - GitHub で Pull Request を作成してみよう 74 | - Pull Request の中身を確認しよう 75 | - こだわった点をコメントしよう 76 | - Pull Request を merge しよう 77 | - GitHub 上で master ブランチのファイル内容を確認しよう 78 | - ローカルリポジトリの master ブランチを更新するため Pull しよう 79 | - ローカルリポジトリで master ブランチの変更を確認しよう 80 | 81 | ## 参考資料リンク 82 | - [サル先生のGit入門](https://backlog.com/ja/git-tutorial/) 83 | - [git Book 日本語版](https://git-scm.com/book/ja/v2) 84 | -------------------------------------------------------------------------------- /Old/githubws_gui.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Old/githubws_gui.pdf -------------------------------------------------------------------------------- /Old/hands-on.zip: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Old/hands-on.zip -------------------------------------------------------------------------------- /Old/setup_sourcetree_mac.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Old/setup_sourcetree_mac.pdf -------------------------------------------------------------------------------- /Old/setup_sourcetree_mac_for_event.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Old/setup_sourcetree_mac_for_event.pdf -------------------------------------------------------------------------------- /Old/setup_sourcetree_windows.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Old/setup_sourcetree_windows.pdf -------------------------------------------------------------------------------- /Old/setup_sourcetree_windows_for_event.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Old/setup_sourcetree_windows_for_event.pdf -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # github_tutorial 2 | Hack U ワークショップイベントで使用する資料になります。 3 | 4 | イベント参加者でなくても一通り理解できるように資料を揃えています。 5 | 6 | ワークショップイベントでは、Visual Studio Code（VSCode）を使用する環境を推奨しています。 7 | 8 | ## 学習の目標 9 | GitHubを使って制作物の管理を行えるようになっていること。 10 | 11 | ## ディレクトリ構成 12 | ``` 13 | . 14 | ├── Basics // [基礎編] Visual Studio Codeを使った資料 15 | ├── CUI // [基礎編] ターミナルを使った資料 16 | ├── Old // 過去に使用したSourcetreeを使った資料(更新なし) 17 | └── Team // [チーム開発編] チーム開発ワークショップ用の資料 18 | ``` 19 | 20 | ## 学習の進め方 21 | 22 | ### 入門編 23 | 24 | Git･GitHubのセットアップから基本的な操作を学べます。 25 | 26 | Gitの構築環境によって資料が変わります。 27 | 28 | - （推奨）[Basics](./Basics): Windows/MacのVisual Studio Code環境 29 | - [CUI](./CUI): Macのターミナル環境 30 | 31 | 自身の環境に対応したフォルダにアクセスした後、READMEに従って進めていきましょう。 32 | 33 | ### チーム開発編 34 | 35 | GitHubを使ってチーム開発をする基本的な流れを学べます。 36 | 37 | 資料は、複数人で行うことを前提にしているため、チームメンバーと一緒行いましょう。 38 | 39 | - [Team](./Team) のフォルダにアクセスした後、READMEに従って進めてください。 40 | 41 | 42 | ## イベント実施日 43 | 44 | * 2021年度開催 45 | * 2021/7/16 46 | * [【Open Hack U 2021 出場者限定】Git/GitHubチーム開発ワークショップ](https://hacku.connpass.com/event/215324/) 47 | * 2021/6/18 48 | * [【学生限定】【VSCode】ソースコード管理ツール Git/GitHub 基礎 ワークショップ](https://hacku.connpass.com/event/215318/) 49 | 50 | * 2020年度開催 51 | * 2021/2/17 52 | * [【Open Hack U 2020 出場者限定】Git/GitHub チーム開発ワークショップ](https://hacku.connpass.com/event/201550/) 53 | * 2020/12/14 54 | * [【学生限定】はじめての GitHub ワークショップ 〜ソースコードを管理しよう〜](https://hacku.connpass.com/event/197276/) 55 | * 2020/11/17 56 | * [【学生限定】はじめての GitHub ワークショップ 〜ソースコードを管理しよう〜](https://hacku.connpass.com/event/192228/) 57 | -------------------------------------------------------------------------------- /Team/README.md: -------------------------------------------------------------------------------- 1 | # GitHub ワークショップ チーム開発 2 | 3 | GitHub を用いたチーム開発について一通りの手順を体験してもらう内容になっています。 4 | チームメンバー間の GitHub への理解度をチーム内で共有するために使用してください。 5 | 6 | ## 資料概要 7 | ``` 8 | . 9 | ├── README.md //この資料 10 | ├── githubws_team.pdf // チーム開発のみの資料 11 | ├── githubws_allin.pdf // 基礎編とチーム開発編を合わせた資料 12 | ├── hands-on.zip // 演習で使用するプログラムをまとめたzipファイル 13 | └── setup_team.pdf // チーム開発のセットアップ資料 14 | ``` 15 | 16 | ## 学習の進め方 17 | 18 | ### 前提知識 19 | 20 | **チームメンバーの全員が「GitHub への add/commit/push」と「branch 作成 ~ PR の作成」を行える必要があります。** 21 | 22 | 前提知識ついて学ぶ際は以下の資料を参考にしてください。 23 | - 推奨環境（VSCode環境）は[こちら](https://github.com/hackujp/github_tutorial/tree/main/ver_VSCode/) 24 | - CUI（MacOSのみ）は[こちら](https://github.com/hackujp/github_tutorial/tree/main/ver_CUI/) 25 | 26 | ### 事前準備 27 | 28 | **Gitの環境構築を行っていない方**は、[こちら](https://github.com/hackujp/github_tutorial/tree/main/Basics)のREADMEを参考に環境構築を行ってください 29 | 30 | チーム開発演習の準備として[セットアップ資料](./setup_team.pdf)を参考に、以下の事前準備を行ってください。 31 | 32 | - [GitHub](https://github.co.jp/) でチーム共有のリポジトリ作成 33 | - 作成したリポジトリにチームメンバーをアサイン 34 | - [演習ファイル](./team_hands-on.zip)を解凍して、作成したリポジトリに push 35 | - チームメンバー全員のローカルリポジトリの作成 36 | 37 | 準備が完了したら、[学習資料](./githubws_allin.pdf) の資料をダウンロードしておきましょう。 38 | 39 | ### メイン資料の内容 40 | 41 | #### Git/GitHubの基本機能おさらい（[ver_VScode](https://github.com/hackujp/github_tutorial/blob/main/Basics/githubws_vscode.pdf)の内容になります） 42 | - Gitとは 43 | - GitHubの基本操作（clone, add, commit, push） 44 | - 作業用ブランチの作成 （ブランチ, チェックアウト） 45 | - mainブランチに変更を反映する（Pull Request, pull） 46 | 47 | #### GitHub をチームで使うには 48 | - GitHubをチームで使う 49 | - Conflict について 50 | - Conflictを起こさない 51 | - Conflictの解消方法 52 | 53 | #### チーム演習 54 | **Webページ で動く電卓 をチーム開発** 55 | JavaScript を使ったサンプルプログラムに追加の実装をして電卓アプリを作成します。 56 | 手順や実装コードは資料内に記載してありますので、JavaScript 未経験でも問題はありません。 57 | 58 | **進め方** 59 | チーム内で役割を決め、作業を行っていきます。 60 | 61 | 分担の例: 62 | - コーダー 2人 63 | - レビュアー 1人以上 64 | 65 | 1. 演習開始時に指定されたブランチを作成 66 | 2. コーダーはそれぞれ並列で指定されたコードを実装して、PR を作成 67 | 3. PR をレビュアーが確認 68 | 1. Conflict やその他修正箇所があればコメントで指摘 69 | 2. 修正箇所が合った場合はそれぞれの実装者が修正して再度レビュー 70 | 4. すべての実装が済んだら、index.html を手元のブラウザで動作確認 71 | 72 | この演習は複数人で作業することを前提とした作りになっています。 73 | 個人で行う際には、ブランチを切り替えて行うことで学習可能です。 74 | 75 | #### Appendix 76 | - gitignore の使い方 77 | - ロールバック 78 | - ブランチの使い方 79 | - コードレビューについて 80 | -------------------------------------------------------------------------------- /Team/code.txt: -------------------------------------------------------------------------------- 1 | //足し算用の関数 add 2 | function add(){ 3 | eqlNum.value = parseFloat(midNum[0].value) + parseFloat(midNum[1].value); 4 | } 5 | 6 | 7 | //引き算用の関数 sub 8 | function sub(){ 9 | eqlNum.value = parseFloat(midNum[0].value) - parseFloat(midNum[1].value); 10 | } 11 | 12 | //掛け算用の関数 mul 13 | function mul(){ 14 | eqlNum.value = parseFloat(midNum[0].value) * parseFloat(midNum[1].value); 15 | } 16 | 17 | 18 | //割り算用の関数 div 19 | function div(){ 20 | if(parseFloat(midNum[1].value) == 0){ 21 | eqlNum.value = "ERROR"; 22 | }else{ 23 | eqlNum.value = parseFloat(midNum[0].value) / parseFloat(midNum[1].value); 24 | } 25 | } -------------------------------------------------------------------------------- /Team/githubws_allin.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Team/githubws_allin.pdf -------------------------------------------------------------------------------- /Team/githubws_team.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Team/githubws_team.pdf -------------------------------------------------------------------------------- /Team/setup_team.pdf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Team/setup_team.pdf -------------------------------------------------------------------------------- /Team/team_hands-on.zip: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hackujp/github_tutorial/7dc6f05b5dd6b34a4b4682a1481ae95e7dda9647/Team/team_hands-on.zip --------------------------------------------------------------------------------