diff --git a/.github/workflows/devcontainer.yml b/.github/workflows/devcontainer.yml index 6932a962..ff3b6bef 100644 --- a/.github/workflows/devcontainer.yml +++ b/.github/workflows/devcontainer.yml @@ -14,7 +14,7 @@ on: - '.devcontainer/**' - '.github/workflows/devcontainer.yml' schedule: - - cron: "0 0 5 * *" + - cron: "0 0 1 * *" workflow_dispatch: jobs: diff --git a/.github/workflows/install.yml b/.github/workflows/install.yml new file mode 100644 index 00000000..a4b90c0f --- /dev/null +++ b/.github/workflows/install.yml @@ -0,0 +1,118 @@ +name: validate installation procedure + +on: + pull_request: + branches: + - main + paths: + - '.github/workflows/install.yml' + push: + branches: + - main + paths: + - '.github/workflows/install.yml' + schedule: + - cron: "0 0 1 * *" + workflow_dispatch: + +jobs: + install_lean_for_windows: + runs-on: windows-latest + defaults: + run: + shell: pwsh + steps: + - name: check dependencies + run: | + git --version + curl --version + + - name: install elan + run: | + curl -O --location https://elan.lean-lang.org/elan-init.ps1 + pwsh ` + -ExecutionPolicy Bypass ` + -f elan-init.ps1 ` + -NoPrompt:$True ` + -DefaultToolchain:stable + Remove-Item elan-init.ps1 + + - name: modify PATH + run: | + Add-Content -Path $env:GITHUB_PATH -Value "$env:USERPROFILE\.elan\bin" + + - name: check installation of elan + run: elan --version + + - name: install latest stable version of Lean + run: | + elan toolchain install stable + + - name: check installation of Lean and lake + run: | + lean --version + lake --version + + install_lean_for_linux: + runs-on: ubuntu-latest + defaults: + run: + shell: bash + steps: + - name: check dependencies + run: | + git --version + curl --version + + - name: install elan + run: | + curl -O --location https://elan.lean-lang.org/elan-init.sh + sh elan-init.sh -y --default-toolchain stable + rm elan-init.sh + + - name: modify PATH + run: echo "$HOME/.elan/bin" >> $GITHUB_PATH + + - name: check installation of elan + run: elan --version + + - name: install latest stable version of Lean + run: | + elan toolchain install stable + + - name: check installation of Lean and lake + run: | + lean --version + lake --version + + install_lean_for_mac: + runs-on: macos-latest + defaults: + run: + shell: /bin/zsh {0} + steps: + - name: check dependencies + run: | + git --version + curl --version + + - name: install elan + run: | + curl -O --location https://elan.lean-lang.org/elan-init.sh + sh elan-init.sh -y --default-toolchain stable + rm elan-init.sh + + - name: modify PATH + run: echo "$HOME/.elan/bin" >> $GITHUB_PATH + + - name: check installation of elan + run: elan --version + + - name: install latest stable version of Lean + run: | + elan toolchain install stable + + - name: check installation of Lean and lake + run: | + lean --version + lake --version diff --git a/.github/workflows/update.yml b/.github/workflows/update.yml index e765ed52..b644809f 100644 --- a/.github/workflows/update.yml +++ b/.github/workflows/update.yml @@ -2,7 +2,7 @@ name: Update Lean on: schedule: # 毎日実行 - - cron: "0 3 * * *" + - cron: "0 0 * * *" workflow_dispatch: permissions: diff --git a/LeanByExample/HowToInstall.lean b/LeanByExample/HowToInstall.lean new file mode 100644 index 00000000..21605522 --- /dev/null +++ b/LeanByExample/HowToInstall.lean @@ -0,0 +1,179 @@ +/- # Lean のインストール方法 + +Lean および関連ツールのインストール方法を説明します。VSCode の Lean 4 拡張機能が自動的にインストールしてくれるのですが、ここではコマンドラインから手動で入れる場合の手順を説明します。 + +## Windows の場合 + +### PowerShell 7 のインストール + +まずは使用しているシェルを確認します。[PowerShell 7](https://github.com/PowerShell/PowerShell) を使うことを推奨します。他のシェルでも Lean のインストール自体は可能ですが、Windows では PowerShell 7 を使うことが一般的であるためこのような手順を案内しています。 + +Windows PowerShell と PowerShell 7 以降は混同されがちですが、下記を実行して Major が 7 以上であれば PowerShell 7 です。 + +```powershell +$PSVersionTable.PSVersion +``` + +PowerShell 7 をインストールするには、次を実行します。 + +```powershell +winget install --id Microsoft.PowerShell --source winget +``` + +### git と curl のインストール + +以下、全てのコマンドは PowerShell 7 で実行することを前提とすることにします。 + +Lean のインストールのためには `git` コマンドと `curl` コマンドが必要です。`git` はテキストのバージョン管理をするためのツールで、`curl` はデータを外部から取得したり、外部に送信したりするためのツールです。 + +それぞれインストール済みであるか、次のコマンドで確認します。 + +```powershell +git --version +curl --version +``` + +おそらく初期状態の Windows では `git` はインストールされていないと思います。以下のコマンドでインストールします。 + +```powershell +winget install --id Git.Git -e --source winget +``` + +`curl` コマンドはおそらく初めから入っていると思いますが、もし入っていない場合は次のコマンドでインストールします。 + +```powershell +winget install --id cURL.cURL --source winget +``` + +### elan のインストール + +次に、Lean のバージョン管理ツールである `elan` をインストールします。次のコマンドでインストールできます。 + +```powershell +curl -O --location https://elan.lean-lang.org/elan-init.ps1 +pwsh ` + -ExecutionPolicy Bypass ` + -f elan-init.ps1 ` + -NoPrompt:$True ` + -DefaultToolchain:stable +Remove-Item elan-init.ps1 +``` + +実行後、`elan` コマンドが使えるようになったか確認します。 + +```powershell +elan --version +``` + +### Lean と lake のインストール + +次に、Lean（と同梱されている `lake`）をインストールします。`stable` を指定することで、最新の安定版をインストールできます。 + +```powershell +elan toolchain install stable +``` + +終わったら、Lean と `lake` のバージョンを確認します。 + +```powershell +lean --version +lake --version +``` + +## Linux の場合 + +シェルは `bash` を使用することを想定して手順を書きます。 + +### git と curl のインストール + +まず、`git` と `curl` がインストール済みであるか確認します。 + +```bash +git --version +curl --version +``` + +インストールされていなければインストールします。 + +```bash +sudo apt update +sudo apt install -y git curl +``` + +### elan のインストール + +次に `elan` をインストールします。 + +```bash +curl -O --location https://elan.lean-lang.org/elan-init.sh +sh elan-init.sh -y --default-toolchain stable +rm elan-init.sh +``` + +終わったら `elan` コマンドが使えるようになったか確認します。 + +```bash +elan --version +``` + +### Lean と lake のインストール + +次に、Lean（と同梱されている `lake`）をインストールします。`stable` を指定することで、最新の安定版をインストールできます。 + +```bash +elan toolchain install stable +``` + +終わったら、Lean と `lake` のバージョンを確認します。 + +```bash +lean --version +lake --version +``` + +## MacOS の場合 + +シェルとして `zsh` を利用することを想定して手順を書きます。 + +### git と curl のインストール + +まず `git` と `curl` が使えるか確認します。 + +```zsh +git --version +curl --version +``` + +MacOS の場合、`curl` は最初から入っていると思います。`git` が入っていない場合でも、`git --version` の実行時にインストールするか聞かれるはずです。 + +### elan のインストール + +次に `elan` をインストールします。 + +```zsh +curl -O --location https://elan.lean-lang.org/elan-init.sh +sh elan-init.sh -y --default-toolchain stable +rm elan-init.sh +``` + +終わったら `elan` コマンドが使えるようになったか確認します。 + +```zsh +elan --version +``` + +### Lean と lake のインストール + +次に、Lean（と同梱されている `lake`）をインストールします。`stable` を指定することで、最新の安定版をインストールできます。 + +```zsh +elan toolchain install stable +``` + +終わったら、Lean と `lake` のバージョンを確認します。 + +```zsh +lean --version +lake --version +``` +-/ diff --git a/booksrc/SUMMARY.md b/booksrc/SUMMARY.md index 4dee0966..a5118f4f 100644 --- a/booksrc/SUMMARY.md +++ b/booksrc/SUMMARY.md @@ -3,6 +3,7 @@ [はじめに](./README.md) [リンク集](./Links.md) +[Leanのインストール方法](./HowToInstall.md) [Mathlib4 Help](./Mathlib4Help.md) [ランダムページ](./Random.md)