From 234005eccd8e1e5f6b2b7d929421b10383a581b6 Mon Sep 17 00:00:00 2001 From: Ryo TAGAMI <9672589+RyoTagami@users.noreply.github.com> Date: Thu, 25 Jan 2024 18:34:00 +0900 Subject: [PATCH] docs: Update Japanese(ja-jp) Translations --- docs/ja-jp/guide/getting-started.md | 13 +++++++------ docs/ja-jp/manage/configuration.md | 25 +++++++++++++++++++++++++ docs/ja-jp/plugins/create.md | 2 +- 3 files changed, 33 insertions(+), 7 deletions(-) diff --git a/docs/ja-jp/guide/getting-started.md b/docs/ja-jp/guide/getting-started.md index 7d87ff3b..4819f4dc 100644 --- a/docs/ja-jp/guide/getting-started.md +++ b/docs/ja-jp/guide/getting-started.md @@ -11,7 +11,7 @@ ## 1. 依存関係のインストール -asdfの動作には`git`および`curl`が必要です。以下の表は、 _あなたが使用している_ パッケージマネージャで実行するコマンドの _一部例_ です(some might automatically install these tools in later steps)。 +asdfの動作には`git`および`curl`が必要です。以下の表は、 _あなたが使用している_ パッケージマネージャで実行するコマンドの _一部例_ です(いくつかのツールは、後の手順で自動的にインストールされます)。 | OS | パッケージマネージャ | コマンド | | ----- | -------------------- | ---------------------------------- | @@ -34,8 +34,9 @@ asdfの動作には`git`および`curl`が必要です。以下の表は、 _あ + ```shell -git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.13.1 +git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.14.0 ``` @@ -299,7 +300,7 @@ echo -e "\n. \"$(brew --prefix asdf)/libexec/asdf.ps1\"" >> ~/.config/powershell 下記コマンドで、`~/.config/nushell/config.nu`に`asdf.nu`を追加します: ```shell -"\n$env.ASDF_NU_DIR = ($env.HOME | path join '.asdf')\n source " + ($env.HOME | path join '.asdf/asdf.nu') | save --append $nu.config-path +"\n$env.ASDF_DIR = ($env.HOME | path join '.asdf')\n source " + ($env.HOME | path join '.asdf/asdf.nu') | save --append $nu.config-path ``` コマンド補完は自動的に設定されます。 @@ -310,7 +311,7 @@ echo -e "\n. \"$(brew --prefix asdf)/libexec/asdf.ps1\"" >> ~/.config/powershell 下記コマンドで、`~/.config/nushell/config.nu`に`asdf.nu`を追加します: ```shell -"\n$env.ASDF_NU_DIR = (brew --prefix asdf | str trim | into string | path join 'libexec')\n source " + (brew --prefix asdf | into string | path join 'libexec/asdf.nu') | save --append $nu.config-path +"\n$env.ASDF_DIR = (brew --prefix asdf | str trim | into string | path join 'libexec')\n source " + (brew --prefix asdf | str trim | into string | path join 'libexec/asdf.nu') | save --append $nu.config-path ``` コマンド補完は自動的に設定されます。 @@ -321,7 +322,7 @@ echo -e "\n. \"$(brew --prefix asdf)/libexec/asdf.ps1\"" >> ~/.config/powershell 下記コマンドで、`~/.config/nushell/config.nu`に`asdf.nu`を追加します: ```shell -"\n$env.ASDF_NU_DIR = '/opt/asdf-vm/'\n source /opt/asdf-vm/asdf.nu" | save --append $nu.config-path +"\n$env.ASDF_DIR = '/opt/asdf-vm/'\n source /opt/asdf-vm/asdf.nu" | save --append $nu.config-path ``` コマンド補完は自動的に設定されます。 @@ -363,7 +364,7 @@ export ASDF_DIR="/opt/asdf-vm" `asdf`のスクリプトは、`$PATH`を設定した**あと**、かつ、使用中のフレームワーク(oh-my-zsh など)を呼び出した**あと**に記述する必要があります。 ::: warning 警告 -macOSでは、BasgまたはZSHシェルを起動すると、自動的に`path_helper`というユーティリティが呼び出されます。`path_helper`は`PATH`(および`MANPATH`)内の項目の順番を並び替えることができるため、特定の順序を必要とするツールの動作に、一貫性が無くなってしまいます。これを回避するため、macOSで`asdf`を利用するときは、強制的に`PATH`エントリの先頭に追加する(優先度を一番高くする)ようにしてください。これは、`ASDF_FORCE_PREPEND`環境変数で制御できます。 +macOSでは、BashまたはZSHシェルを起動すると、自動的に`path_helper`というユーティリティが呼び出されます。`path_helper`は`PATH`(および`MANPATH`)内の項目の順番を並び替えることができるため、特定の順序を必要とするツールの動作に、一貫性が無くなってしまいます。これを回避するため、macOSで`asdf`を利用するときは、強制的に`PATH`エントリの先頭に追加する(優先度を一番高くする)ようにしてください。これは、`ASDF_FORCE_PREPEND`環境変数で制御できます。 ::: `PATH`の変更を反映するために、シェルを再起動してください。たいていの場合、ターミナルのタブを新たに開けばOKです。 diff --git a/docs/ja-jp/manage/configuration.md b/docs/ja-jp/manage/configuration.md index 89c02976..e3af4f3b 100644 --- a/docs/ja-jp/manage/configuration.md +++ b/docs/ja-jp/manage/configuration.md @@ -152,6 +152,31 @@ asdfプラグインのショートネームリポジトリの同期を無効化 備考: `ASDF_CONCURRENCY`環境変数が設定されている場合はそちらが優先されます。 +### プラグインフック + +下記のタイミングで、カスタムコードを実行することができます: + +- プラグインのインストール、Shim再生成、更新および削除をする際の前後 +- プラグインコマンドの実行前後 + +例えば、`foo`というプラグインがインストールされていて、`bar`という実行可能ファイルが提供されている場合、以下のようなフックを使うことで、一番最初にカスタムコードを実行することができます: + +```text +pre_foo_bar = echo Executing with args: $@ +``` + +以下のパターンがサポートされています: + +- `pre__` +- `pre_asdf_download_` +- `{pre,post}_asdf_{install,reshim,uninstall}_` + - `$1`: フルバージョン +- `{pre,post}_asdf_plugin_{add,update,remove,reshim}` + - `$1`: プラグイン名 +- `{pre,post}_asdf_plugin_{add,update,remove}_` + +どのようなコマンドの前後にどのようなコマンドフックを実行すべきかについての詳細は、[プラグインの作成](../plugins/create.md)をご覧ください。 + ## 環境変数 環境変数の設定値は、お使いのシステムやシェルによって異なります。デフォルトロケーションは、インストールした場所や方法(Gitクローン、Homebrew、AUR)によって異なります。 diff --git a/docs/ja-jp/plugins/create.md b/docs/ja-jp/plugins/create.md index e0d4705c..f2c0ac95 100644 --- a/docs/ja-jp/plugins/create.md +++ b/docs/ja-jp/plugins/create.md @@ -814,7 +814,7 @@ asdf plugin test [--asdf-tool-version ] [--a デフォルトは、`asdf latest `です。 - オプションで`[--asdf-plugin-gitref ]`を指定すると、 そのコミット/ブランチ/タグでプラグイン自体をチェックアウトします。 - これは、プラグインのCIにおいて、プルリクエストをテストする際に便利です。 + これは、プラグインのCIにおいて、プルリクエストをテストする際に便利です。デフォルトは、プラグインリポジトリのデフォルトブランチとなります。 - オプションの`[test_command...]`パラメータは、インストールしたツールが正しく動作するかを確認するために実行するコマンドです。 通常は、` --version`または` --help`となります。 例えば、NodeJSプラグインをテストするときは、次のように実行します: