Skip to content

Commit 4a88b77

Browse files
yas-akoyas-ako
authored
はじめにと第1章のファイルを複製 (#52)
1 parent 69cae71 commit 4a88b77

7 files changed

Lines changed: 671 additions & 7 deletions

File tree

‎docs/.vitepress/config.ts‎

Lines changed: 23 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,26 @@ export default withMermaid({
3737
{ text: 'テキスト', link: '/text/chapter-0/' }
3838
],
3939

40-
sidebar: [
40+
sidebar: {
41+
'/cpp/': [
42+
{
43+
text: 'はじめに',
44+
link: '/cpp/preface/',
45+
items: [
46+
{ text: 'この講習会について', link: '/cpp/preface/1' },
47+
{ text: 'このテキストについて', link: '/cpp/preface/2' },
48+
]
49+
},
50+
{
51+
text: '1. 環境構築',
52+
link: '/cpp/chapter-1/',
53+
items: [
54+
{ text: '1-A. Macの環境構築', link: '/cpp/chapter-1/1-A' },
55+
{ text: '1-B. Windowsの環境構築', link: '/cpp/chapter-1/1-B' },
56+
]
57+
},
58+
],
59+
'/text/': [
4160
{
4261
text: 'About',
4362
items: [
@@ -203,10 +222,11 @@ export default withMermaid({
203222
// { text: 'Chapter 6', link: '/guide/chapter-6' },
204223
]
205224
},
206-
{
225+
{
207226
text: 'プライバシーポリシー', link: '/privacy-policy'
208227
}
209-
],
228+
],
229+
},
210230

211231
socialLinks: [
212232
{

‎docs/cpp/chapter-1/1-A.md‎

Lines changed: 107 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,107 @@
1-
# 1.1-A Macの環境構築
1+
# 環境構築 Mac
2+
3+
## Step 1: Clang Install
4+
5+
1. 「⌘ + スペース」
6+
2. 「Spotlight　を検索」が表示される
7+
![](https://md.trap.jp/uploads/upload_adc9c2a774516259a1da6fe5b39d8644.png)
8+
9+
3. **ターミナル** と入力
10+
4. ターミナルを起動する。
11+
5. `clang --version` と入力
12+
13+
::: tip
14+
なにかインストールを求められた時は、指示に従ってインストールしてください。心配なら TA を呼んでください。
15+
:::
16+
17+
6. `command not found` と表示されなければOK
18+
![](https://md.trap.jp/uploads/upload_3ba7721f3d474e631fa3d24018524aff.png)
19+
20+
21+
7. traQ の tasks チャンネルで :cpp: スタンプをつける
22+
23+
## Step 2: Install VSCode
24+
25+
1. https://code.visualstudio.com/download でダウンロード
26+
27+
2. `⌘+Shift+P` を同時押しして、出てきた画面に `shell command` と入力する。 `Install 'code' command in PATH` を選択。
28+
29+
![](https://md.trap.jp/uploads/upload_2abb6541a6553eba592d6ebb50d48f42.png)
30+
31+
3. ターミナルで `code hello.txt` を入力し、VSCode が起動できたら成功！
32+
![](https://md.trap.jp/uploads/upload_4fedaae551ed06599c053eab0df1961a.png)
33+
![](https://md.trap.jp/uploads/upload_b0f12162818c84b840635422dcb0b2e5.png)
34+
35+
4. `⌘+,` を押して、出てきた画面に「Auto Save」と入力
36+
37+
5. 「Files: Auto Save」の項目を探して、「afterDelay」に変更する
38+
![](https://md.trap.jp/uploads/upload_8a51ad57ec7b6d396cb610c9bbb17040.png)
39+
40+
41+
6. `⌘+Shift+X` を押して、出てきた画面に `Japanese` と入力。 `Japanese Language Pack for Visual Studio Code` をインストールする。インストール完了後、右下の `Change Language and Restart` を押して VSCode を再起動する。
42+
![](https://md.trap.jp/uploads/upload_6c5cfaf6aadcc679382c966d4bccb753.png)
43+
44+
5. 日本語でVSCode が表示されるようになったら :vscode: スタンプをつける
45+
46+
## Step 3: 拡張機能の設定
47+
48+
1. VSCodeの 画面で `⌘` + `Shift` + `X`
49+
50+
2. 「C++」と入力し、「C/C++ Extenstion」の拡張機能を追加
51+
52+
3. `Code Runner` と入力して、「Code Runner」拡張機能を追加
53+
54+
4. `⌘` + `,` で設定を開く。下記画像の赤丸で囲んだ部分を押して `settings.json` を開く。
55+
![](https://md.trap.jp/uploads/upload_bbdd65cb92c5c57bb38f797676aaea8f.png)
56+
57+
5. もし`"cpp": `で始まる行がなければ、一番最後の行の1つ前の行（ `}` の前！）に次のコードを追加する。その前の行に `,` がなかったら追加する。
58+
59+
```
60+
"code-runner.executorMap": {
61+
"cpp": "cd $dir && clang++ -std=c++17 $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
62+
},
63+
```
64+
65+
![](https://md.trap.jp/uploads/upload_6123c7ce669910790a06b98cc664b827.png)
66+
67+
::: tip
68+
69+
もしすでに`"cpp": ` で始まる行があった場合、以下のように`g++` を `clang++` に置き換える。
70+
71+
```diff
72+
- "cpp": "cd $dir && g++ $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
73+
+ "cpp": "cd $dir && clang++ -std=c++17 $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
74+
```
75+
76+
:::
77+
78+
6. `"code-runner.executorMap": {` の行の前に `"code-runner.runInTerminal": true,` を書く（コピペ推奨！！）
79+
80+
7. こんな感じになっていれば OK
81+
![](https://md.trap.jp/uploads/upload_1444ef8d082128cc2723db31555f3960.png)
82+
83+
8. ターミナル を開き、 `code main.cpp` と入力する
84+
85+
9. 次のように書く（コピペでも OK ）
86+
87+
```cpp
88+
#include <iostream>
89+
using namespace std;
90+
91+
int main() {
92+
cout << "Hello, World!" << endl;
93+
}
94+
```
95+
96+
10. 画像の赤丸で実行してみる。下側の画面に `Hello, World!` が出れば成功！
97+
![](https://md.trap.jp/uploads/upload_750a50362d2ae00ffcf2f4b041446ed9.png)
98+
99+
::: tip
100+
なにか出てきた場合は、代わりに三角の隣の`v` を押して、「Run Code」を押す！
101+
102+
![](https://md.trap.jp/uploads/upload_2b042cfaa37207457e419a5380ccd466.png)
103+
:::
104+
105+
11. traQ の tasks チャンネルで :done: を押す
106+
107+
12. 環境構築はこれで完了です！お疲れ様でした。 :blob_pyon:

‎docs/cpp/chapter-1/1-B.md‎

Lines changed: 163 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,163 @@
1-
# 1.1-B Windowsの環境構築
1+
# 環境構築 Windows
2+
3+
## Step 1: Install WSL
4+
5+
1. https://apps.microsoft.com/detail/9N0DX20HK701?hl=ja-jp&gl=JP&ocid=pdpshare で Windows Terminal をインストール（既にインストールされていれば飛ばしてOKです）
6+
7+
1. アプリ検索の画面で、 `Terminal` と入力し 「管理者として実行」
8+
![](https://md.trap.jp/uploads/upload_367dc95b2cd3e74c808320a907977237.png)
9+
10+
11+
2. `wsl --install -d Ubuntu` と入力して、エンターキーを押す。
12+
![](https://md.trap.jp/uploads/upload_7266a7465d2df1dbc341237b2e4983b3.png)
13+
14+
:::warning TA向け
15+
WSL インストールトラブルシューティング
16+
https://learn.microsoft.com/ja-jp/windows/wsl/troubleshooting
17+
18+
`wsl --install` に失敗した際の手動インストールマニュアル
19+
（Windowsバージョンの要件なども書いてあります）
20+
https://learn.microsoft.com/ja-jp/windows/wsl/install-manual
21+
:::
22+
23+
:::warning TA向け
24+
極稀に、BIOS で virtualization 設定が切られている為に WSL がインストールできない事があります（`Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS.` と表示されます）
25+
この場合は BIOS に入って、 Advanced -> Virtualization の順で有効化してください。
26+
:::
27+
28+
3. Ubuntu のアカウント設定
29+
1. ターミナルの下部に `Enter new UNIX username:` と表示されていなければ `wsl -d Ubuntu` と入力してエンターキーを押す。
30+
1. それでも `Enter new UNIX username` が表示されない場合（例えば「ディストリビューションが見つからない」という内容のエラーが表示される場合）は、インストールが失敗している可能性があるので Step 1 の 1. からやり直してみる（これでも上手くいかない場合は TA を呼んでください）
31+
1. `Enter new UNIX username:` が表示されるので、**半角英数小文字** でユーザーネームを入れる。（ `take` とか `takemura` とか `ryugo` とか短い方が良い。フォルダの名前になります）
32+
2. `New Password:` WSL 内で使いたいパスワードを入力。何も表示されませんが入力されています。入力できたら エンターキーを押す。
33+
3. `Retype New password:` もう一度入力。
34+
35+
![](https://md.trap.jp/uploads/upload_0fb105e906b7670d57ba0d0810418a95.png)
36+
37+
4. ウィンドウを閉じる
38+
39+
6. スタートから Windows Terminal を起動
40+
41+
7. `Ctrl` + `,` で設定画面を開く
42+
43+
8. 「規定のプロファイル」を「Ubuntu」に変更（複数あるならどれでも良い）
44+
![](https://md.trap.jp/uploads/upload_0ce2e7b6aa4468178d034ffc65934316.png)
45+
46+
9. 「保存」ボタンを押す
47+
48+
10. Windows Terminal を閉じて、もう一度開く
49+
50+
11. traQ の tasks チャンネルで :wsl: スタンプを押す
51+
52+
## Step 2: Install Clang
53+
54+
1. WSL上で `sudo apt update`
55+
56+
3. パスワードを求められるので、WSLで設定したパスワードを入力
57+
4. WSL上で `sudo apt install clang zip curl -y` を実行する
58+
5. `clang --version` で clang のバージョンが表示されれば成功
59+
6. 11. traQ の tasks チャンネルで :cpp: を押す
60+
61+
## Step 3: VSCode Install & Init
62+
63+
1. https://code.visualstudio.com/download から VSCode をインストール
64+
65+
2. 起動後、 `Ctrl` + `Shift` + `X` を押す
66+
67+
3. `Japanese` と入力し、 `Japanese Language Pack for Visual Studio Code` をインストール。
68+
![](https://md.trap.jp/uploads/upload_b54bb733b3bf68010e033d30f2bf57c2.png)
69+
70+
4. VSCode の右下「Change Language and Restart」を押してインストール。
71+
72+
5. もう一度、 `Ctrl` + `Shift` + `X` を押す
73+
74+
6. `WSL` を入力し、 `WSL` をインストール
75+
![](https://md.trap.jp/uploads/upload_80d3b7bc083b103d30d372ba8dabbe5b.png)
76+
77+
7. `Ctrl+,` を押して、出てきた画面に「Auto Save」と入力
78+
79+
8. 「Files: Auto Save」の項目を探して、「afterDelay」に変更する
80+
![](https://md.trap.jp/uploads/upload_8a51ad57ec7b6d396cb610c9bbb17040.png)
81+
82+
9. ターミナルで `code hello.txt` を入力し、VSCode が起動できたら成功！
83+
![](https://md.trap.jp/uploads/upload_b00fe65803252e719a394f50527731d9.png)
84+
85+
::: tip
86+
VSCode が起動しない場合は、一度ターミナルを閉じて開きなおしてからコマンドを再度実行してみてください。
87+
:::
88+
89+
8. traQ の tasks チャンネルで :vscode: スタンプを押す
90+
91+
## Step 4： 拡張機能の設定
92+
93+
1. VSCodeの 画面で `Ctrl` + `Shift` + `X`
94+
95+
2. 「C++」と入力し、「C/C++ Extenstion Pack」の拡張機能を追加
96+
97+
3. `Code Runner` と入力して、「Code Runner」拡張機能を追加
98+
99+
4. `Ctrl` + `,` で設定を開く。下記画像の赤丸で囲んだ部分を押して `settings.json` を開く。
100+
![](https://md.trap.jp/uploads/upload_bbdd65cb92c5c57bb38f797676aaea8f.png)
101+
102+
5. もし`"cpp": `で始まる行がなければ、一番最後の行の1つ前の行（ `}` の前！）に次のコードを追加する。その前の行に `,` がなかったら追加する。
103+
104+
```
105+
"code-runner.executorMap": {
106+
"cpp": "cd $dir && clang++ -std=c++17 $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
107+
},
108+
```
109+
110+
![](https://md.trap.jp/uploads/upload_6123c7ce669910790a06b98cc664b827.png)
111+
112+
::: tip
113+
114+
もしすでに`"cpp": ` で始まる行があった場合、以下のように`g++` を `clang++` に置き換える。
115+
116+
```diff
117+
- "cpp": "cd $dir && g++ $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
118+
+ "cpp": "cd $dir && clang++ -std=c++17 $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
119+
```
120+
121+
:::
122+
123+
6. `"code-runner.executorMap": {` の行の前に `"code-runner.runInTerminal": true,` を書く（コピペ推奨！！）
124+
125+
6. 編集画面に赤い波線が出ていないことを確認する。出ている場合は入力にミスがある可能性が高いので、もう一度確認してみる。 (それでも解決しない場合はTAを呼んでください)
126+
127+
7. こんな感じになっていれば OK
128+
![](https://md.trap.jp/uploads/upload_1444ef8d082128cc2723db31555f3960.png)
129+
130+
8. WSL を開き、 `code main.cpp` と入力する
131+
132+
9. 次のように書く（コピペでも OK ）
133+
134+
```cpp
135+
#include <iostream>
136+
using namespace std;
137+
138+
int main() {
139+
cout << "Hello, World!" << endl;
140+
}
141+
```
142+
143+
10. 画像の赤丸で実行してみる。下側の画面に `Hello, World!` が出れば成功！
144+
![](https://md.trap.jp/uploads/upload_750a50362d2ae00ffcf2f4b041446ed9.png)
145+
146+
::: tip
147+
三角のボタンが表示されない場合、ウィンドウの左下に「制限モード」と表示されていないか確認してみてください。
148+
149+
表示されている場合にはそこをクリックして、その先の画面で「信頼する」をクリックしてください。
150+
(画像の赤枠部分)
151+
152+
![](https://md.trap.jp/uploads/upload_90b63cfdbe22831b9c2f838152fab403.png)
153+
:::
154+
155+
::: tip
156+
ボタンを押してもうまくいかない場合は、代わりに三角の隣の `v` を押して、「Run Code」を押してみてください！
157+
158+
![](https://md.trap.jp/uploads/upload_2b042cfaa37207457e419a5380ccd466.png)
159+
:::
160+
161+
11. traQ の tasks チャンネルで :done: スタンプを押す
162+
163+
12. 環境構築はこれで完了です！お疲れ様でした。 :blob_pyon:

‎docs/cpp/chapter-1/index.md‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1 +1,41 @@
11
# 1. 環境構築
2+
3+
プログラミングとは、という話をする前にまず**環境構築**を行っていきます。これにかなり時間がかかると考えられるので、環境構築を済ませてから講習を進めていきます。
4+
5+
:::tip
6+
プログラミングをする為の**環境**を**構築**する → **環境構築**
7+
:::
8+
9+
以下は基本的に読みながら各自で進めてください。
10+
11+
**もし手が止まった・わからない所があったらすぐに手を上げるか何かしてTAを呼んでください。**
12+
**終わったら隣の人の様子を見てみてください。**
13+
14+
:::warning
15+
このセクション内の黄色囲みは **TA向けのトラブルシューティング**
16+
です。自分で読んでも構いませんが、ケースバイケースで難しいところがあるので、難しそうなら無理せずTAを呼んでください。
17+
:::
18+
19+
[**Mac** はこちら](./1-A)
20+
21+
[**Windows** はこちら](./1-B)
22+
23+
----
24+
25+
:::tip
26+
環境構築は個人間の時間差が大きいので、早く終わった人は 第1章の内容を自力で進めてみましょう。わからなければ気軽に TA
27+
を呼んでください。
28+
29+
また、ダウンロードの時間等もある程度あって暇な時間ができるので、開始してからある程度経過したら講習を始めます。手を動かす必要がない部分の解説を進めていくので、
30+
**各自受講しながら手順どおりに作業を進めてください。**
31+
:::
32+
33+
:::tip
34+
それも終わってしまって暇な人は **HackMD** で遊んでみましょう。
35+
36+
* md.trap.jp を開く
37+
* 右上の「新規ノート」を押す
38+
* 自由に使えるメモ帳が出てくる
39+
* 新しい行に `## aaa` と書くと…？
40+
* いろんな使い方があります。[「君の知らないtraP HackMDの世界」](https://md.trap.jp/vjjW5mXQStCgv_h8PhYF1A) を見てみましょう
41+
:::

0 commit comments

Comments
 (0)