From 4bc5737310020643f8afba1aa93699a8214af3b9 Mon Sep 17 00:00:00 2001 From: harrki Date: Sat, 30 Nov 2024 23:51:16 +0900 Subject: [PATCH] fix: Add environment installing sentences --- .../install/environment/linux/install.md | 77 ++++++++++++++++--- .../install/environment/windows/install.md | 44 ++++++++--- 2 files changed, 102 insertions(+), 19 deletions(-) diff --git a/docs/source/install/environment/linux/install.md b/docs/source/install/environment/linux/install.md index 9996b5ac..e431db1e 100644 --- a/docs/source/install/environment/linux/install.md +++ b/docs/source/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など) diff --git a/docs/source/install/environment/windows/install.md b/docs/source/install/environment/windows/install.md index ce36a29c..f2f8bd01 100644 --- a/docs/source/install/environment/windows/install.md +++ b/docs/source/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) + ``` \ No newline at end of file