deploy: 2eded16

Author: harrki

_sources/install/environment/linux/install.md

@@ -10,6 +10,8 @@
 2. もし、`command not found`などのエラーが出た場合、OS標準のパッケージマネージャーを使用してインストールします。
     - DebianベースのOSの場合(Ubuntuなど)
         ```bash
+        sudo apt update
+        sudo apt upgrade -y
         sudo apt install git
         ```
     - Red HatベースのOSの場合(Fedoraなど)
@@ -31,29 +33,82 @@
 1. Terminalを起動し、以下のコマンドを実行します。また、バージョンが3.12以上になっていることを確認します。
     ```bash
     python --version
-    # OR
-    python3 --version
     ```
 
-2. もし、`command not found`などのエラーが出た場合やバージョンが低い場合、OS標準のパッケージマネージャーを使用してインストールします
-    - DebianベースのOSの場合(Ubuntuなど)
+2. もし、`command not found`などのエラーが出た場合やバージョンが低い場合、Pythonのバージョン管理ツールであるpyenvを使用してインストールします
+    
+    ```{warning}
+    インストール方法の内容が最新ではない場合があるため、[https://github.com/pyenv/pyenv](https://github.com/pyenv/pyenv)を参照してください。
+    ```
+
+    1. 以下のコマンドを実行します。
         ```bash
-        sudo apt install python3.12 python3.12-pip
+        curl https://pyenv.run | bash
         ```
-    - Red HatベースのOSの場合(Fedoraなど)
+
+    2. 次に以下のコマンドを実行して、使用しているShellを確認します。
         ```bash
-        sudo yum install python3.12 python3.12-pip
+        echo $SHELL
+        ```
+
+    3. 表示されたShellに従ってコマンドを実行してください。
+
+        `bash`が表示された方は以下のコマンドを実行してください
+        ```bash
+        echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
+        echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
+        echo 'eval "$(pyenv init -)"' >> ~/.bashrc
+
+        echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.profile
+        echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.profile
+
+        echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bash_profile
+        echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bash_profile
+        echo 'eval "$(pyenv init -)"' >> ~/.bash_profile
         ```
 
+        `zsh`が表示された方は以下のコマンドを実行してください
         ```bash
-        sudo dnf install python3.12 python3.12-pip
+        echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
+        echo '[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
+        echo 'eval "$(pyenv init -)"' >> ~/.zshrc
         ```
 
+        `fish`が表示された方は以下のコマンドを実行してください
+        ```bash
+        set -Ux PYENV_ROOT $HOME/.pyenv
+        fish_add_path $PYENV_ROOT/bin
+        pyenv init - | source
+        ```
+
+    4. 必要パッケージのインストール
+        - DebianベースのOSの場合(Ubuntuなど)
+            ```bash
+            sudo apt update
+            sudo apt upgrade -y
+            sudo apt install make libssl-dev build-essential zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget llvm libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
+            ```
+        - Red HatベースのOSの場合(Fedoraなど)
+            ```bash
+            sudo yum install gcc bzip2 bzip2-devel openssl openssl-devel readline readline-devel sqlite-devel tk-devel
+            ```
+
+            ```bash
+            sudo dnf install gcc bzip2 bzip2-devel openssl openssl-devel readline readline-devel sqlite-devel tk-devel
+            ```
+
+    5. python3.12のインストール
+        ```bash
+        exec "$SHELL"
+        pyenv install 3.12
+        pyenv global 3.12
+        ```
+
+
+
 3. 以下のコマンドを入力し、バージョンが表示されたら成功です。(表示されない方はTerminalを再起動してください)
     ```bash
     python --version
-    # OR
-    python3 --version
     ```
 
 ## 3. OpenJDKのインストール
@@ -66,6 +121,8 @@
 2. もし、`command not found`などのエラーが出た場合やバージョンが異なる場合、OS標準のパッケージマネージャーを使用してインストールします
     - DebianベースのOSの場合(Ubuntuなど)
         ```bash
+        sudo apt update
+        sudo apt upgrade -y
         sudo apt install openjdk-17-jdk
         ```
     - Red HatベースのOSの場合(Fedoraなど)

_sources/install/environment/windows/install.md

@@ -3,18 +3,44 @@
 ## 1. Gitのインストール
 
 1. [Git for Windows](https://gitforwindows.org/)の公式サイトにアクセスします。
-2. ダウンロードページから最新のバージョンをダウンロードします。
-3. ダウンロードしたファイルを開き、インストールを開始します。
+2. トップページの"Download"をクリックします
+3. ダウンロードが完了した後、インストーラーを実行します。
+4. 全て"Next"をクリックします。
+5. インストールが完了するまで待ちます。
+6. インストールが完了したら"Finish"をクリックします。
+7. 検索バーに"Git Bash"と入力し、Git Bashを実行します。
+8. 画面が表示されていたらインストール成功です。
 
 ## 2. Pythonのインストール
 
-1. [Python](https://www.python.org/downloads/)の公式サイトにアクセスします。
-2. ダウンロードページから最新のバージョンをダウンロードします。
-3. ダウンロードしたファイルを開き、インストールを開始します。
-4. インストール時に「Add python.exe to PATH」にチェックを入れてください。
+1. [Python](https://www.python.org/)の公式サイトにアクセスします。
+2. トップページの"Download Python ~"をクリックします
+3. ダウンロードが完了した後、インストーラーを実行します。
+4. "Add python.exe to PATH"にチェックが入っていることを確認した後、"Install Now"をクリックします。
+5. インストールが完了するまで待ちます。
+6. インストールが完了したら"Close"をクリックします。
+7. Git Bashを開き、`python --version`と入力し、`Python [バージョン]`が表示されたら成功です。(もし表示されない場合はGit Bashを開き直してください)
 
 ## 3. OpenJDKのインストール
 
-1. [OpenJDK](https://jdk.java.net/archive/)の公式サイトにアクセスします。
-2. ダウンロードページから17.0.2のバージョンをダウンロードします。
-3. ダウンロードしたファイルを開き、インストールを開始します。
+1. [OpenJDK](https://jdk.java.net/archive/)のダウンロードページにアクセスします。
+2. 17.0.2のWindowsの横にある"zip"をクリックします。
+3. ダウンロードしたzipを展開(解凍)します。
+4. 展開(解凍)すると"jdk-17.0.2"のようなフォルダができるのを確認します。
+5. このフォルダ"jdk-17.0.2"を`C:¥`の直下に移動させます。
+6. Windowsでコマンドプロンプトを管理者として実行します。
+7. 開いたら以下のコマンドを実行します。
+    ```
+    powershell -command "[System.Environment]::SetEnvironmentVariable(\"JAVA_HOME\", \"c:\jdk-17.0.2\", \"Machine\")"
+    ```
+8. 次に以下のコマンドを実行します。
+    ```
+    powershell -command "$oldpath = [System.Environment]::GetEnvironmentVariable(\"Path\", \"Machine\"); $oldpath += \";c:\jdk-17.0.2\bin\"; [System.Environment]::SetEnvironmentVariable(\"Path\", $oldpath, \"Machine\")"
+    ```
+9. Git Bashを開き、`java -version`と入力します。
+    以下のような文字が表示されたらインストール成功です。
+    ```
+    openjdk version "17.0.2" 2022-01-18
+    OpenJDK Runtime Environment (build 17.0.2+8-86)
+    OpenJDK 64-Bit Server VM (build 17.0.2+8-86, mixed mode, sharing)
+    ```

install/environment/linux/install.html

@@ -342,7 +342,9 @@ <h2>1. Gitのインストール<a class="headerlink" href="#git" title="Link to
 <li><p>もし、<code class="docutils literal notranslate"><span class="pre">command</span> <span class="pre">not</span> <span class="pre">found</span></code>などのエラーが出た場合、OS標準のパッケージマネージャーを使用してインストールします。</p>
 <ul>
 <li><p>DebianベースのOSの場合(Ubuntuなど)</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span>git
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>apt<span class="w"> </span>update
+sudo<span class="w"> </span>apt<span class="w"> </span>upgrade<span class="w"> </span>-y
+sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span>git
 </pre></div>
 </div>
 </li>
@@ -368,32 +370,82 @@ <h2>2. Pythonのインストール<a class="headerlink" href="#python" title="Li
 <ol class="arabic">
 <li><p>Terminalを起動し、以下のコマンドを実行します。また、バージョンが3.12以上になっていることを確認します。</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>python<span class="w"> </span>--version
-<span class="c1"># OR</span>
-python3<span class="w"> </span>--version
 </pre></div>
 </div>
 </li>
-<li><p>もし、<code class="docutils literal notranslate"><span class="pre">command</span> <span class="pre">not</span> <span class="pre">found</span></code>などのエラーが出た場合やバージョンが低い場合、OS標準のパッケージマネージャーを使用してインストールします</p>
+<li><p>もし、<code class="docutils literal notranslate"><span class="pre">command</span> <span class="pre">not</span> <span class="pre">found</span></code>などのエラーが出た場合やバージョンが低い場合、Pythonのバージョン管理ツールであるpyenvを使用してインストールします</p>
+<div class="admonition warning">
+<p class="admonition-title">警告</p>
+<p>インストール方法の内容が最新ではない場合があるため、<a class="github reference external" href="https://github.com/pyenv/pyenv">pyenv/pyenv</a>を参照してください。</p>
+</div>
+<ol class="arabic">
+<li><p>以下のコマンドを実行します。</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>curl<span class="w"> </span>https://pyenv.run<span class="w"> </span><span class="p">|</span><span class="w"> </span>bash
+</pre></div>
+</div>
+</li>
+<li><p>次に以下のコマンドを実行して、使用しているShellを確認します。</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">echo</span><span class="w"> </span><span class="nv">$SHELL</span>
+</pre></div>
+</div>
+</li>
+<li><p>表示されたShellに従ってコマンドを実行してください。</p>
+<p><code class="docutils literal notranslate"><span class="pre">bash</span></code>が表示された方は以下のコマンドを実行してください</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;export PYENV_ROOT=&quot;$HOME/.pyenv&quot;&#39;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>~/.bashrc
+<span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;command -v pyenv &gt;/dev/null || export PATH=&quot;$PYENV_ROOT/bin:$PATH&quot;&#39;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>~/.bashrc
+<span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;eval &quot;$(pyenv init -)&quot;&#39;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>~/.bashrc
+
+<span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;export PYENV_ROOT=&quot;$HOME/.pyenv&quot;&#39;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>~/.profile
+<span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;command -v pyenv &gt;/dev/null || export PATH=&quot;$PYENV_ROOT/bin:$PATH&quot;&#39;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>~/.profile
+
+<span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;export PYENV_ROOT=&quot;$HOME/.pyenv&quot;&#39;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>~/.bash_profile
+<span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;[[ -d $PYENV_ROOT/bin ]] &amp;&amp; export PATH=&quot;$PYENV_ROOT/bin:$PATH&quot;&#39;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>~/.bash_profile
+<span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;eval &quot;$(pyenv init -)&quot;&#39;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>~/.bash_profile
+</pre></div>
+</div>
+<p><code class="docutils literal notranslate"><span class="pre">zsh</span></code>が表示された方は以下のコマンドを実行してください</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;export PYENV_ROOT=&quot;$HOME/.pyenv&quot;&#39;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>~/.zshrc
+<span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;[[ -d $PYENV_ROOT/bin ]] &amp;&amp; export PATH=&quot;$PYENV_ROOT/bin:$PATH&quot;&#39;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>~/.zshrc
+<span class="nb">echo</span><span class="w"> </span><span class="s1">&#39;eval &quot;$(pyenv init -)&quot;&#39;</span><span class="w"> </span>&gt;&gt;<span class="w"> </span>~/.zshrc
+</pre></div>
+</div>
+<p><code class="docutils literal notranslate"><span class="pre">fish</span></code>が表示された方は以下のコマンドを実行してください</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">set</span><span class="w"> </span>-Ux<span class="w"> </span>PYENV_ROOT<span class="w"> </span><span class="nv">$HOME</span>/.pyenv
+fish_add_path<span class="w"> </span><span class="nv">$PYENV_ROOT</span>/bin
+pyenv<span class="w"> </span>init<span class="w"> </span>-<span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="nb">source</span>
+</pre></div>
+</div>
+</li>
+<li><p>必要パッケージのインストール</p>
 <ul>
 <li><p>DebianベースのOSの場合(Ubuntuなど)</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span>python3.12<span class="w"> </span>python3.12-pip
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>apt<span class="w"> </span>update
+sudo<span class="w"> </span>apt<span class="w"> </span>upgrade<span class="w"> </span>-y
+sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span>make<span class="w"> </span>libssl-dev<span class="w"> </span>build-essential<span class="w"> </span>zlib1g-dev<span class="w"> </span>libbz2-dev<span class="w"> </span>libreadline-dev<span class="w"> </span>libsqlite3-dev<span class="w"> </span>wget<span class="w"> </span>llvm<span class="w"> </span>libncursesw5-dev<span class="w"> </span>xz-utils<span class="w"> </span>tk-dev<span class="w"> </span>libxml2-dev<span class="w"> </span>libxmlsec1-dev<span class="w"> </span>libffi-dev<span class="w"> </span>liblzma-dev
 </pre></div>
 </div>
 </li>
 <li><p>Red HatベースのOSの場合(Fedoraなど)</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>yum<span class="w"> </span>install<span class="w"> </span>python3.12<span class="w"> </span>python3.12-pip
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>yum<span class="w"> </span>install<span class="w"> </span>gcc<span class="w"> </span>bzip2<span class="w"> </span>bzip2-devel<span class="w"> </span>openssl<span class="w"> </span>openssl-devel<span class="w"> </span>readline<span class="w"> </span>readline-devel<span class="w"> </span>sqlite-devel<span class="w"> </span>tk-devel
 </pre></div>
 </div>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>dnf<span class="w"> </span>install<span class="w"> </span>python3.12<span class="w"> </span>python3.12-pip
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>dnf<span class="w"> </span>install<span class="w"> </span>gcc<span class="w"> </span>bzip2<span class="w"> </span>bzip2-devel<span class="w"> </span>openssl<span class="w"> </span>openssl-devel<span class="w"> </span>readline<span class="w"> </span>readline-devel<span class="w"> </span>sqlite-devel<span class="w"> </span>tk-devel
 </pre></div>
 </div>
 </li>
 </ul>
 </li>
+<li><p>python3.12のインストール</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span><span class="nb">exec</span><span class="w"> </span><span class="s2">&quot;</span><span class="nv">$SHELL</span><span class="s2">&quot;</span>
+pyenv<span class="w"> </span>install<span class="w"> </span><span class="m">3</span>.12
+pyenv<span class="w"> </span>global<span class="w"> </span><span class="m">3</span>.12
+</pre></div>
+</div>
+</li>
+</ol>
+</li>
 <li><p>以下のコマンドを入力し、バージョンが表示されたら成功です。(表示されない方はTerminalを再起動してください)</p>
 <div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>python<span class="w"> </span>--version
-<span class="c1"># OR</span>
-python3<span class="w"> </span>--version
 </pre></div>
 </div>
 </li>
@@ -410,7 +462,9 @@ <h2>3. OpenJDKのインストール<a class="headerlink" href="#openjdk" title="
 <li><p>もし、<code class="docutils literal notranslate"><span class="pre">command</span> <span class="pre">not</span> <span class="pre">found</span></code>などのエラーが出た場合やバージョンが異なる場合、OS標準のパッケージマネージャーを使用してインストールします</p>
 <ul>
 <li><p>DebianベースのOSの場合(Ubuntuなど)</p>
-<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span>openjdk-17-jdk
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>sudo<span class="w"> </span>apt<span class="w"> </span>update
+sudo<span class="w"> </span>apt<span class="w"> </span>upgrade<span class="w"> </span>-y
+sudo<span class="w"> </span>apt<span class="w"> </span>install<span class="w"> </span>openjdk-17-jdk
 </pre></div>
 </div>
 </li>