環境構築の説明を改善 (#62)

rurun418 · web-flow · commit 61be38159040 · 2026-04-30T15:37:09.000+09:00
diff --git a/docs/cpp/chapter-1/1-A.md b/docs/cpp/chapter-1/1-A.md
@@ -1,3 +1,12 @@
+---
+prev:
+  text: '1. 環境構築'
+  link: '/cpp/chapter-1/'
+next:
+  text: '2. はじめてのプログラミング'
+  link: '/cpp/chapter-2/'
+---
+
 # 1.1-A Macの環境構築
 
 ## Step 1: Clangのインストール
@@ -20,9 +29,11 @@
 ## Step 2: VSCodeのインストール
 
 1. <https://code.visualstudio.com/download>から自分のOS用のインストーラをダウンロードする。
-2. 画面の表示に従って、VSCodeをインストールする。
-3. `⌘`+`Shift`+`P`を同時押しして、出てきた画面に`shell command`と入力する。
-4. `Install 'code' command in PATH` を選択する。
+2. ダウンロードされた`.dmg`ファイルを開く。
+3. `Visual Studio Code.app`を`Applications`フォルダーにドラッグする。
+4. Finderで`Applications`（`アプリケーション`）フォルダーを開き、アイコンをダブルクリックしてVSCodeを起動する。
+5. `⌘`+`Shift`+`P`を同時押しして、出てきた画面に`shell command`と入力する。
+6. `Install 'code' command in PATH` を選択する。
 
 ![](https://md.trap.jp/uploads/upload_2abb6541a6553eba592d6ebb50d48f42.png)
 
@@ -55,7 +66,7 @@
 
 ```
 "code-runner.executorMap": {
-    "cpp": "cd $dir && clang++ -std=c++23 $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
+    "cpp": "cd $dir && clang++ -std=c++2b $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
 },
 ```
 
@@ -67,7 +78,7 @@
 
 ```diff
 - "cpp": "cd $dir && g++ $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
-+ "cpp": "cd $dir && clang++ -std=c++23 $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
++ "cpp": "cd $dir && clang++ -std=c++2b $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
 ```
 
 :::
@@ -98,5 +109,14 @@ int main() {
 ![](https://md.trap.jp/uploads/upload_2b042cfaa37207457e419a5380ccd466.png)
 :::
 
+::: tip
+三角のボタンが表示されない場合、ウィンドウの左下に「制限モード」と表示されていないか確認してみてください。
+
+表示されている場合にはそこをクリックして、その先の画面で「信頼する」をクリックしてください。
+(画像の赤枠部分)
+
+![](https://md.trap.jp/uploads/upload_90b63cfdbe22831b9c2f838152fab403.png)
+:::
+
 11. [traQのtasksチャンネル](https://q.trap.jp/channels/event/workshop/pg-basic/tasks)でスタンプをつける。
 12. 環境構築はこれで完了です。お疲れ様でした！
diff --git a/docs/cpp/chapter-1/1-B.md b/docs/cpp/chapter-1/1-B.md
@@ -1,135 +1,132 @@
-# 環境構築Windows
+---
+prev:
+  text: '1. 環境構築'
+  link: '/cpp/chapter-1/'
+next:
+  text: '2. はじめてのプログラミング'
+  link: '/cpp/chapter-2/'
+---
 
-## Step 1: Install WSL
+# 1.1-B Windowsの環境構築
 
-1. https://apps.microsoft.com/detail/9N0DX20HK701?hl=ja-jp&gl=JP&ocid=pdpshare でWindows Terminalをインストール（既にインストールされていれば飛ばしてOKです）
+## Step 1: WSLのインストール
 
-2. アプリ検索の画面で、 `Terminal` と入力し 「管理者として実行」
+1. <https://apps.microsoft.com/detail/9N0DX20HK701?hl=ja-jp&gl=JP&ocid=pdpshare>でWindows Terminalをインストールする。（既にインストールされていれば飛ばしてOK）
+2. アプリ検索の画面で、`Terminal`と入力し **「管理者として実行」** を押す。
 ![](https://md.trap.jp/uploads/upload_367dc95b2cd3e74c808320a907977237.png)
-
-
 3. `wsl --install -d Ubuntu` と入力して、エンターキーを押す。
 ![](https://md.trap.jp/uploads/upload_7266a7465d2df1dbc341237b2e4983b3.png)
 
 :::warning TA向け
 WSLインストールトラブルシューティング
-https://learn.microsoft.com/ja-jp/windows/wsl/troubleshooting
+<https://learn.microsoft.com/ja-jp/windows/wsl/troubleshooting>
 
 `wsl --install` に失敗した際の手動インストールマニュアル
 （Windowsバージョンの要件なども書いてあります）
-https://learn.microsoft.com/ja-jp/windows/wsl/install-manual
+<https://learn.microsoft.com/ja-jp/windows/wsl/install-manual>
 :::
 
 :::warning TA向け
-極稀に、BIOSでvirtualization設定が切られている為にWSLがインストールできない事があります（`Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS.` と表示されます）
+極稀に、BIOSでvirtualization設定が切られている為にWSLがインストールできない事があります。（`Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS.` と表示されます。）
 この場合はBIOSに入って、 Advanced -> Virtualizationの順で有効化してください。
 :::
 
-4. Ubuntuのアカウント設定
-    1. ターミナルの下部に `Enter new UNIX username:` と表示されていなければ `wsl -d Ubuntu` と入力してエンターキーを押す。
-        1. それでも `Enter new UNIX username` が表示されない場合（例えば「ディストリビューションが見つからない」という内容のエラーが表示される場合）は、インストールが失敗している可能性があるのでStep 1の1. からやり直してみる（これでも上手くいかない場合はTAを呼んでください）
-    1. `Enter new UNIX username:` が表示されるので、**半角英数小文字** でユーザーネームを入れる。（ `take` とか `takemura` とか `ryugo` とか短い方が良い。フォルダの名前になります）
-    2. `New Password:` WSL内で使いたいパスワードを入力。何も表示されませんが入力されています。入力できたら エンターキーを押す。
-    3. `Retype New password:` もう一度入力。
+4. Ubuntuのアカウント設定をする。
+    1. ターミナルの下部に`Enter new UNIX username:`と表示されていなければ`wsl -d Ubuntu`と入力してエンターキーを押す。
+        - それでも`Enter new UNIX username:`が表示されない場合（例えば「ディストリビューションが見つからない」という内容のエラーが表示される場合）は、インストールが失敗している可能性があるのでStep 1の1. からやり直してみる。（これでも上手くいかない場合はTAを呼んでください。）
+    2. `Enter new UNIX username:`と表示されるので、**半角英数小文字**で好きなユーザーネームを設定する。（`take` とか `takemura` とか`ryugo`とか短い方が良い。フォルダの名前になります。）
+    3. `New Password:`と表示されるので、WSL内で使いたいパスワードを入力。何も表示されませんが入力されています。入力できたら エンターキーを押す。
+    4. `Retype New password:`と表示されるので、もう一度パスワードを入力する。
 
 ![](https://md.trap.jp/uploads/upload_0fb105e906b7670d57ba0d0810418a95.png)
 
-5. ウィンドウを閉じる
-
-6. スタートからWindows Terminalを起動
+::: tip
+パスワードは忘れないよう、どこかに記録しておきましょう。
+:::
 
-7. `Ctrl` + `,` で設定画面を開く
+5. ターミナルのウィンドウを閉じる。
+6. スタートからWindows Terminalを起動。
+7. `Ctrl`+`,`で設定画面を開く。
 
-8. 「既定のプロファイル」を「Ubuntu」に変更（複数あるならどれでも良い）
+8. 「既定のプロファイル」を「Ubuntu」に変更する。（複数あるならどれでも良い）
 ![](https://md.trap.jp/uploads/upload_0ce2e7b6aa4468178d034ffc65934316.png)
 
-9. 「保存」ボタンを押す
-
-10. Windows Terminalを閉じて、もう一度開く
-
-11. traQのtasksチャンネルで :wsl: スタンプを押す
-
-## Step 2: Install Clang
+9. 「保存」ボタンを押す。
+10. Windows Terminalを閉じて、もう一度開く。
+11. [traQのtasksチャンネル](https://q.trap.jp/channels/event/workshop/pg-basic/tasks)でスタンプをつける。
 
-1. WSL上で `sudo apt update`
+## Step 2: Clangのインストール
 
-2. パスワードを求められるので、WSLで設定したパスワードを入力
-3. WSL上で `sudo apt install clang zip curl -y` を実行する
-4. `clang --version` でclangのバージョンが表示されれば成功
-5. traQのtasksチャンネルで :cpp: を押す
+1. WSL上で`sudo apt update`と入力する。
+2. パスワードを求められるので、WSLで設定したパスワードを入力する。
+3. WSL上で`sudo apt install clang zip curl -y`と打つ。
+4. `clang --version`でclangのバージョンが表示されれば成功！
+7. [traQのtasksチャンネル](https://q.trap.jp/channels/event/workshop/pg-basic/tasks)でスタンプをつける。
 
-## Step 3: Install VSCode & Init
+## Step 3: VSCodeのインストール
 
-1. https://code.visualstudio.com/download からVSCodeをインストール
+1. <https://code.visualstudio.com/download>から自分のOS用のインストーラをダウンロードする。
+2. ダウンロードされたインストーラを開き、画面の案内に従って、VSCodeをインストールする。
+3. 起動後、`Ctrl`+`Shift`+`X`を押す。
+4. `Ctrl`+`,`を押して、出てきた画面に「Auto Save」と入力する。
+5. 「Files: Auto Save」の項目を探して、「afterDelay」に変更する。
 
-2. 起動後、 `Ctrl` + `Shift` + `X` を押す
-
-3. `Japanese` と入力し、 `Japanese Language Pack for Visual Studio Code` をインストール。
-![](https://md.trap.jp/uploads/upload_b54bb733b3bf68010e033d30f2bf57c2.png)
+![](https://md.trap.jp/uploads/upload_8a51ad57ec7b6d396cb610c9bbb17040.png)
 
-4. VSCodeの右下「Change Language and Restart」を押してインストール。
+6. `Ctrl`+`Shift`+`X`を押して、出てきた画面に`Japanese`と入力する。
+7. `Japanese Language Pack for Visual Studio Code` をインストールする。
+8. インストールが終わったら、右下の`Change Language and Restart`を押してVSCodeを再起動する。
 
-5. もう一度、 `Ctrl` + `Shift` + `X` を押す
+![](https://md.trap.jp/uploads/upload_6c5cfaf6aadcc679382c966d4bccb753.png)
 
-6. `WSL` を入力し、 `WSL` をインストール
+9. もう一度、`Ctrl`+`Shift`+`X`を押して、出てきた画面に`WSL`と入力する。
+10. `WSL` をインストールする。
 ![](https://md.trap.jp/uploads/upload_80d3b7bc083b103d30d372ba8dabbe5b.png)
-
-7. `Ctrl` + `,` を押して、出てきた画面に「Auto Save」と入力
-
-8. 「Files: Auto Save」の項目を探して、「afterDelay」に変更する
-![](https://md.trap.jp/uploads/upload_8a51ad57ec7b6d396cb610c9bbb17040.png)
-
-9. ターミナルで `code hello.txt` を入力し、VSCodeが起動できたら成功！
+11. ターミナルで `code hello.txt` を入力する。VSCodeが起動できたら成功！
 ![](https://md.trap.jp/uploads/upload_b00fe65803252e719a394f50527731d9.png)
 
 ::: tip
 VSCodeが起動しない場合は、一度ターミナルを閉じて開きなおしてからコマンドを再度実行してみてください。
 :::
 
-10. traQのtasksチャンネルで :vscode: スタンプを押す
+12. [traQのtasksチャンネル](https://q.trap.jp/channels/event/workshop/pg-basic/tasks)でスタンプをつける。
 
 ## Step 4: 拡張機能の設定
 
-1. VSCodeの 画面で `Ctrl` + `Shift` + `X`
-
-2. 「C++」と入力し、「C/C++ Extension Pack」の拡張機能を追加
-
-3. `Code Runner` と入力して、「Code Runner」拡張機能を追加
-
-4. `Ctrl` + `,` で設定を開く。下記画像の赤丸で囲んだ部分を押して `settings.json` を開く。
+1. VSCodeの画面で`Ctrl`+`Shift`+`X`を押す。
+2. `C++`と入力し、「C/C++ Extension Pack」の拡張機能を追加する。
+3. `Code Runner`と入力して、「Code Runner」の拡張機能を追加する。
+4. `⌘`+`,`で設定を開く。下記画像の赤丸で囲んだ部分を押して`settings.json`を開く。
 ![](https://md.trap.jp/uploads/upload_bbdd65cb92c5c57bb38f797676aaea8f.png)
 
-5. もし`"cpp": `で始まる行がなければ、一番最後の行の1つ前の行（ `}` の前！）に次のコードを追加する。その前の行に `,` がなかったら追加する。
+5. もし`"cpp": `で始まる行がなければ、一番最後の行の1つ前の行（`}`の前！）に次のコードを追加する。その前の行に`,`がなかったら追加する。
 
 ```
 "code-runner.executorMap": {
-    "cpp": "cd $dir && clang++ -std=c++17 $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
+    "cpp": "cd $dir && clang++ -std=c++2b $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
 },
 ```
 
 ![](https://md.trap.jp/uploads/upload_6123c7ce669910790a06b98cc664b827.png)
 
 ::: tip
 
-もしすでに`"cpp": ` で始まる行があった場合、以下のように`g++` を `clang++` に置き換える。
+もしすでに`"cpp": `で始まる行があった場合、以下のように`g++`を`clang++`に置き換える。
 
 ```diff
 - "cpp": "cd $dir && g++ $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
-+ "cpp": "cd $dir && clang++ -std=c++17 $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
++ "cpp": "cd $dir && clang++ -std=c++2b $fileName -o $fileNameWithoutExt && $dir$fileNameWithoutExt",
 ```
 
 :::
 
-6. `"code-runner.executorMap": {` の行の前に `"code-runner.runInTerminal": true,` を書く（コピペ推奨！！）
+6. `"code-runner.executorMap": {`の行の前に`"code-runner.runInTerminal": true,`を書く。（コピペ推奨！！）
+7. こんな感じになっていればOK！
 
-7. 編集画面に赤い波線が出ていないことを確認する。出ている場合は入力にミスがある可能性が高いので、もう一度確認してみる。 (それでも解決しない場合はTAを呼んでください)
-
-8. こんな感じになっていればOK
 ![](https://md.trap.jp/uploads/upload_1444ef8d082128cc2723db31555f3960.png)
 
-9. WSLを開き、 `code main.cpp` と入力する
-
-10. 次のように書く（コピペでもOK）
+8. WSLのターミナルを開き、`code main.cpp`と入力する。
+9. 次のように書く。（コピペでもOK）
 
 ```cpp
 #include <iostream>
@@ -140,9 +137,15 @@ int main() {
 }
 ```
 
-11. 画像の赤丸で実行してみる。下側の画面に `Hello, World!` が出れば成功！
+10. 画像の赤丸で実行してみる。下側の画面に`Hello, World!`が出れば成功！
 ![](https://md.trap.jp/uploads/upload_750a50362d2ae00ffcf2f4b041446ed9.png)
 
+::: tip
+なにか出てきた場合は、代わりに三角の隣の`v`を押して、「Run Code」を押す！
+
+![](https://md.trap.jp/uploads/upload_2b042cfaa37207457e419a5380ccd466.png)
+:::
+
 ::: tip
 三角のボタンが表示されない場合、ウィンドウの左下に「制限モード」と表示されていないか確認してみてください。
 
@@ -152,12 +155,5 @@ int main() {
 ![](https://md.trap.jp/uploads/upload_90b63cfdbe22831b9c2f838152fab403.png)
 :::
 
-::: tip
-ボタンを押してもうまくいかない場合は、代わりに三角の隣の `v` を押して、「Run Code」を押してみてください！
-
-![](https://md.trap.jp/uploads/upload_2b042cfaa37207457e419a5380ccd466.png)
-:::
-
-12. traQのtasksチャンネルで :done: スタンプを押す
-
-13. 環境構築はこれで完了です！お疲れ様でした。 :blob_pyon:
+11. [traQのtasksチャンネル](https://q.trap.jp/channels/event/workshop/pg-basic/tasks)でスタンプをつける。
+12. 環境構築はこれで完了です。お疲れ様でした！
diff --git a/docs/cpp/chapter-1/index.md b/docs/cpp/chapter-1/index.md
@@ -1,3 +1,7 @@
+---
+next: false
+---
+
 # 1. 環境構築
 
 プログラミングとは、という話をする前にまず**環境構築**を行っていきます。これにかなり時間がかかると考えられるので、環境構築を済ませてから講習を進めていきます。
@@ -13,6 +17,6 @@
 
 使用しているパソコンの種類によって、環境構築の手順が異なります。自分のパソコンに対応するページに進み、環境構築をしていきましょう。
 
-[**Mac**の環境構築手順](/cpp/chapter-1/1-A)
+[1.1-A **Mac**の環境構築](/cpp/chapter-1/1-A)
 
-[**Windows**の環境構築手順](/cpp/chapter-1/1-B)
+[1.1-B **Windows**の環境構築](/cpp/chapter-1/1-B)
diff --git a/docs/cpp/chapter-2/index.md b/docs/cpp/chapter-2/index.md
@@ -1,3 +1,9 @@
+---
+prev:
+  text: '1. 環境構築'
+  link: '/cpp/chapter-1/'
+---
+
 # 2. はじめてのプログラミング
 
 :::warning TA向け
diff --git a/docs/cpp/chapter-2/problems/index.md b/docs/cpp/chapter-2/problems/index.md
@@ -1,3 +1,3 @@
 # 練習問題
 
-- [2-Q1. Hello, Shell!](hello-shell)
+- [2-C1. Hello, Shell!](hello-shell)
diff --git a/docs/cpp/index.md b/docs/cpp/index.md
@@ -1 +1,48 @@
-# 
+---
+# https://vitepress.dev/reference/default-theme-home-page
+layout: home
+
+hero:
+    name: "pg-basic"
+    text: "Programming-basic lecture class"
+    tagline: "プログラミング基礎講習会テキスト"
+    actions:
+        - theme: brand
+          text: テキスト（2026年度版）
+          link: /cpp/preface/
+        - theme: alt
+          text: このテキストについて
+          link: /cpp/preface/2
+        - theme: alt
+          text: プライバシーポリシー
+          link: /privacy-policy
+
+---
+
+現在2026年度版のテキストを作成中です。構成の変更や内容の追加などを行っています。執筆が完了した章から順次公開していきます。
+
+- [はじめに](/cpp/preface/)
+  - [この講習会について](/cpp/preface/1)
+  - [このテキストについて](/cpp/preface/2)
+- [1. 環境構築](/cpp/chapter-1/)
+  - [1.1-A. Macの環境構築](/cpp/chapter-1/1-A)
+  - [1.1-B. Windowsの環境構築](/cpp/chapter-1/1-B)
+- [2. はじめてのプログラミング](/cpp/chapter-2/)
+  - [2.1 プログラミングの基礎知識](/cpp/chapter-2/1)
+  - [2.2 作業環境の構築](/cpp/chapter-2/2)
+  - [2.3 はじめてのプログラミング](/cpp/chapter-2/3)
+  - [練習問題](/cpp/chapter-2/problems/)
+
+::: details 2025年度版テキスト
+
+こちらは2025年度以前に使用していたテキストです。
+
+- [0. はじめに](/text/chapter-0/)
+- [I. はじめてのプログラミング](/text/chapter-1/)
+- [II. 変数と入出力](/text/chapter-2/)
+- [III. 演算・計算](/text/chapter-3/)
+- [IV. 繰り返し処理](/text/chapter-4/)
+- [V. Function](/text/chapter-5/)
+- [VI. Struct](/text/chapter-6/)
+
+:::
diff --git a/docs/cpp/preface/index.md b/docs/cpp/preface/index.md
@@ -1,3 +1,7 @@
+---
+prev: false
+---
+
 # はじめに
 
 プログラミング基礎講習会へようこそ！
diff --git a/docs/index.md b/docs/index.md
@@ -25,8 +25,8 @@ hero:
   - [この講習会について](/cpp/preface/1)
   - [このテキストについて](/cpp/preface/2)
 - [1. 環境構築](/cpp/chapter-1/)
-  - [1-A. Macの環境構築](/cpp/chapter-1/1-A)
-  - [1-B. Windowsの環境構築](/cpp/chapter-1/1-B)
+  - [1.1-A. Macの環境構築](/cpp/chapter-1/1-A)
+  - [1.1-B. Windowsの環境構築](/cpp/chapter-1/1-B)
 - [2. はじめてのプログラミング](/cpp/chapter-2/)
   - [2.1 プログラミングの基礎知識](/cpp/chapter-2/1)
   - [2.2 作業環境の構築](/cpp/chapter-2/2)

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`# 練習問題`
`2`	`2`
`3`		`-- [2-Q1. Hello, Shell!](hello-shell)`
	`3`	`+- [2-C1. Hello, Shell!](hello-shell)`