pythonの全セクションにslug作成、python-replのidを削除

Author: na-trium-144

README.md

@@ -69,20 +69,32 @@ Cloudflare Worker のビルドログとステータス表示が見れますが
     title: セクションタイトルと同じものをmd記法を使わずに書いた文字列
     level: セクションの見出しレベル(2〜6が使用可)
     ```
-* コード例はそれが配置されているセクションの内容と関連するようにする。コード例だけを独立したセクションに載せるのは避ける
-    * 良くない例
+* コード例はそれが配置されているセクションの内容と関連するようにする。
     ````md
     ## 制御構文
     ### if
     if文の説明…
     ### switch
     switch文の説明…
-    ### コード例
+
     ifとswitch共通の注意事項... → ## 制御構文 に移す
     ```
     ifとswitchを使ったコード例… → 2つのコード例に分割する
     ```
     ````
+* コード例や注意事項などを不必要に独立したセクションにするのは避ける
+    ````md
+    ## hoge
+    hogeの説明…
+    ### hogeの使用場面 →この見出しいらない
+    **hogeの使用場面** はok
+      - 説明
+      - 説明
+    ### hogeの使用例 →この見出しいらない
+    ```
+    hogeを使ったコード例…
+    ```
+    ````
 * REPLのコード例は1セクションに最大1つまで。
 * ページ0以外の各ページの最後はレベル2見出し「この章のまとめ」と、レベル3見出し「練習問題n」を置く
 

public/docs/cpp/0-intro/2-0-env-about.md

@@ -8,4 +8,4 @@ level: 2
 
 C++プログラムを実行するには、**コンパイラ**が必要です。コンパイラは、人間が書いたC++のソースコードを、コンピュータが理解できる機械語に翻訳するツールです。
 
-このウェブサイト上ではブラウザ上でコードを編集し実行できる環境を提供しており、特別なセットアップは不要です。しかし、ローカル環境でC++を学びたい場合は、以下のようなコンパイラとIDE（統合開発環境）をインストールすることをお勧めします。
+このウェブサイト上ではブラウザ上でコードを実行できる環境を埋め込んでおり、特別なセットアップは不要です。しかし、ローカル環境でC++を学びたい場合は、以下のようなコンパイラとIDE（統合開発環境）をインストールすることをお勧めします。

public/docs/javascript/0-intro/4-1-repl.md

@@ -8,7 +8,7 @@ level: 3
 
 ちょっとした動作確認にはREPLが便利です。Node.jsのREPLを起動するには、ターミナルで `node` と入力して起動します。
 
-このウェブサイトではドキュメント内にJavaScriptの実行環境を埋め込んでおり、以下のように緑枠で囲われたコード例には自由にJavaScriptコードを書いて試すことができます。ただしNode.jsとは環境が異なり、Node.js特有の機能は使用できません。
+このウェブサイト上ではブラウザ上でコードを実行できる環境を埋め込んでおり、以下のように緑枠で囲われたコード例には自由にJavaScriptコードを書いて試すことができます。ただしNode.jsとは環境が異なり、Node.js特有の機能は使用できません。
 
 ```js-repl
 > console.log("Hello, World from REPL!");

public/docs/javascript/0-intro/4-2-run-source.md

@@ -20,6 +20,7 @@ console.log(`${greeting} I am running on ${target}.`);
 ```
 
 ターミナルでファイルのあるディレクトリに移動し、`node` コマンドで実行します。
+このウェブサイト上の実行環境で動かす場合は、以下の実行ボタンをクリックしてください。
 
 ```js-exec:hello.js
 Hello, World! I am running on Node.js.

public/docs/python/0-intro/0-python.md …c/docs/python/0-intro/1-0-readability.mdpublic/docs/python/0-intro/0-python.md renamed to public/docs/python/0-intro/1-0-readability.md public/docs/python/0-intro/0-python.md renamed to public/docs/python/0-intro/1-0-readability.md

@@ -1,5 +1,5 @@
 ---
-id: python-intro-0-python
+id: python-intro-readability
 title: 'Pythonの思想と特徴: 「読みやすさ」は最優先'
 level: 2
 ---

public/docs/python/0-intro/1-python.md

@@ -0,0 +1,22 @@
+---
+id: python-intro-install
+title: Pythonのインストール方法
+level: 2
+---
+
+## Pythonのインストール方法
+
+手元の環境で本格的に開発を進めるために、Pythonのインストール方法を紹介します。
+
+WindowsでPythonをインストールするには、主に2つの方法があります。
+
+1.  **[Python公式インストーラ](https://www.python.org/downloads/)**: Pythonの公式サイトからインストーラをダウンロードする方法が最も一般的です。インストール時に「Add Python to PATH」のチェックを入れると、コマンドプロンプトやPowerShellから `python` コマンドを直接実行できるようになり便利です。
+2.  **Microsoft Store**: Microsoft Storeからも手軽にPythonをインストールできます。
+
+macOSでは、**Homebrew** というパッケージマネージャを使ってインストールするのが簡単です。
+```bash
+brew install python
+```
+もちろん、Windowsと同様に公式サイトからインストーラをダウンロードすることも可能です。
+
+Linuxでは、多くのディストリビューションには初めからPythonがインストールされていますが、最新版を使いたい場合はディストリビューションのパッケージマネージャ（`apt`, `yum`など）を利用するのが一般的です。

public/docs/python/0-intro/2-0-install.md

@@ -1,5 +1,5 @@
 ---
-id: python-intro-4
+id: python-intro-version-management
 title: バージョン管理と環境管理ツール
 level: 3
 ---

public/docs/python/0-intro/4.md …python/0-intro/2-3-version-management.mdpublic/docs/python/0-intro/4.md renamed to public/docs/python/0-intro/2-3-version-management.md public/docs/python/0-intro/4.md renamed to public/docs/python/0-intro/2-3-version-management.md

@@ -0,0 +1,21 @@
+---
+id: python-intro-repl
+title: 対話モード（REPL）でPythonを体験しよう
+level: 2
+---
+
+## 対話モード（REPL）でPythonを体験しよう
+
+**REPL**（Read-Eval-Print Loop）は、入力したコードをその場で実行し、結果をすぐに見ることができる強力な学習・デバッグツールです。
+
+このウェブサイト上ではブラウザ上でコードを実行できる環境を埋め込んでおり、以下のように緑枠で囲われたコード例には自由にPythonコードを書いて試すことができます。
+
+手元のPCにインストールした環境で実行するには、ターミナル（コマンドプロンプトやPowerShellなど）で `python` と入力すれば、同じ対話モードを起動できます。
+
+```python-repl
+>>> message = "Hello, Python!"
+>>> print(message)
+Hello, Python!
+>>> 1 + 2 * 3
+7
+```