diff --git a/document/01-git.en.md b/document/01-git.en.md index 0e6583b3e..b42680ba4 100644 --- a/document/01-git.en.md +++ b/document/01-git.en.md @@ -6,12 +6,10 @@ In this step, we will learn how to use Git and GitHub. * (JA)[Gitを使ったバージョン管理](https://backlog.com/ja/git-tutorial/intro/01/) * (JA)[Udemy Business - Git:はじめてのGitとGitHub](https://mercari.udemy.com/course/intro_git/) - * (EN)[Git basics](https://www.atlassian.com/git) * (EN)[Udemy Business - GitHub Ultimate: Master Git and GitHub - Beginner to Expert](https://mercari.udemy.com/course/github-ultimate/) - ## Fork this **mercari-build-training** repository * Fork [mercari-build-training](https://github.com/mercari-build/mercari-build-training) @@ -29,6 +27,8 @@ In this step, we will learn how to use Git and GitHub. 2. Set your name and email address using git config. Check if your email address shows up. ```shell + $ git config --global user.name "" + $ git config --global user.email "" $ git config user.email ``` diff --git a/document/01-git.ja.md b/document/01-git.ja.md index b9d8b1f4b..d2e748e54 100644 --- a/document/01-git.ja.md +++ b/document/01-git.ja.md @@ -6,9 +6,9 @@ * (JA)[Gitを使ったバージョン管理](https://backlog.com/ja/git-tutorial/intro/01/) * (JA)[Udemy Business - Git:はじめてのGitとGitHub](https://mercari.udemy.com/course/intro_git/) - * (EN)[Git basics](https://www.atlassian.com/git) * (EN)[Udemy Business - GitHub Ultimate: Master Git and GitHub - Beginner to Expert](https://mercari.udemy.com/course/github-ultimate/) + ## **mercari-build-training** リポジトリをフォークする * [mercari-build-training](https://github.com/mercari-build/mercari-build-training) @@ -25,8 +25,10 @@ * Macを使っている場合: [brew](https://brew.sh/index_ja) をインストールしてから `brew install git`を実行 * For Windows user: Download [installer](https://gitforwindows.org/) -2. git configに自分の名前とemailアドレスを設定します。以下のコマンドを実行してあなたのemailアドレスが表示されればOKです。 +2. git configに自分の名前とemailアドレスを設定します。以下のコマンドを実行して最後にあなたのemailアドレスが表示されればOKです。 ```shell + $ git config --global user.name "" + $ git config --global user.email "" $ git config user.email ``` diff --git a/document/02-local-env.en.md b/document/02-local-env.en.md index 9346be62d..ff14d711f 100644 --- a/document/02-local-env.en.md +++ b/document/02-local-env.en.md @@ -6,15 +6,16 @@ Choose either Python or Go and build your local environment. ## Building Python environment ### 1. Install Python -* If your local version is below Python3.8, install Python3.10. -* If you have Python3.8 or above, you can skip the installation step. +* If your local version is below Python3.9, install Python3.13. +* If you have Python3.9 or above, you can skip the installation step. ### 2. Check your Python version * Check if the Python is added to your PATH (usable as commands on your terminal) with the following command. ```shell -$ python -V +$ python3 -V +# Or $ python -V ``` If the version does not correspond to the Python version you installed, double check your installation as it is not **added to your PATH**. @@ -32,9 +33,11 @@ You can install the dependencies by running the following command. $ cd python # Create virtual environment for this application -$ python -m venv .venv -$ source .venv/bin/activate -# When you use non-UNIX os, the activation method is different. +$ python3 -m venv .venv  + +# Activate virtual environment +$ source .venv/bin/activate # for Mac or Unix user +$ ./venv/Scripts/activate # for Windows user # Install required library $ pip install -r requirements.txt @@ -42,7 +45,7 @@ $ pip install -r requirements.txt If you added a library, make sure you add it to `requirements.txt`. -`python -m venv .venv` is a command to create a Python virtual environment. +`python3 -m venv .venv` is a command to create a Python virtual environment. A virtual environment is a way to create a project-specific Python environment. Using a virtual environment allows you to manage necessary packages separately for each project so that you can avoid dependency conflicts between different projects. Once the virtual environment is created, it must be activated by the `source .venv/bin/activate` command. diff --git a/document/02-local-env.ja.md b/document/02-local-env.ja.md index b84c3d873..020e9f2c6 100644 --- a/document/02-local-env.ja.md +++ b/document/02-local-env.ja.md @@ -6,35 +6,43 @@ PythonかGoから1つの言語を選び、環境を作りましょう。 ## Pythonの環境を作る ### 1. Pythonをインストールする -* Python3.8以上がインストールされていない場合、Python3.10をインストールします -* すでに3.8以上がインストール済みの方はskipして問題ないです +* Python3.9以上がインストールされていない場合、Python3.13をインストールします +* すでに3.9以上がインストール済みの方はskipして問題ないです ### 2. Pythonのバージョンをチェックする * インストールしたPythonにパスが通っている(=ターミナルから使える状態)か確認します。 ```shell -$ python -V +$ python3 -V +# もしくは $ python -V ``` 表示されるPythonのバージョンがインストールしたものではなければ、**パスが通っていない**状態なので確認してください。 **:book: Reference** -* [PATHを通すとは?- 初心者でも分かる解説](https://hara-chan.com/it/programming/environment-variable-path/) +* [「PATHが通っている」とはどういう状態か?](https://zenn.dev/d0ne1s/articles/1f435463551ac2) +* Windowsの方向け [【環境構築 入門】PATHの通し方 – Windows11, M1 Mac 対応 –](https://www.kikagaku.co.jp/kikagaku-blog/path/) ### 3. 依存ライブラリをインストールする Pythonでは、`requirements.txt`というファイルに依存しているライブラリの一覧を記載します。 以下のコマンドを実行することで、依存ライブラリをまとめてインストールすることができます。 +### Unix or Mac ```shell $ cd python # 仮想環境をつくる -$ python -m venv .venv -$ source .venv/bin/activate -# Unixを利用していない場合コマンドが違うことがあります +$ python3 -m venv .venv + +# 仮想環境をアクティベートする +$ source .venv/bin/activate # Unix / Macの場合 +$ ./venv/Scripts/activate # windowsの場合 + +# 今回使うPythonのパスを確認する。 +$ which python # 必要なライブラリをインストールする $ pip install -r requirements.txt