Skip to content

Commit

Permalink
docs: Update Japanese(ja-jp) Translations
Browse files Browse the repository at this point in the history
  • Loading branch information
RyoTagami committed Jan 25, 2024
1 parent ccdd47d commit 234005e
Show file tree
Hide file tree
Showing 3 changed files with 33 additions and 7 deletions.
13 changes: 7 additions & 6 deletions docs/ja-jp/guide/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@

## 1. 依存関係のインストール

asdfの動作には`git`および`curl`が必要です。以下の表は、 _あなたが使用している_ パッケージマネージャで実行するコマンドの _一部例_ です(some might automatically install these tools in later steps)。
asdfの動作には`git`および`curl`が必要です。以下の表は、 _あなたが使用している_ パッケージマネージャで実行するコマンドの _一部例_ です(いくつかのツールは、後の手順で自動的にインストールされます)。

| OS | パッケージマネージャ | コマンド |
| ----- | -------------------- | ---------------------------------- |
Expand All @@ -34,8 +34,9 @@ asdfの動作には`git`および`curl`が必要です。以下の表は、 _あ

<!-- x-release-please-start-version -->


```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

```

Expand Down Expand Up @@ -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
```

コマンド補完は自動的に設定されます。
Expand All @@ -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
```

コマンド補完は自動的に設定されます。
Expand All @@ -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
```

コマンド補完は自動的に設定されます。
Expand Down Expand Up @@ -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です。
Expand Down
25 changes: 25 additions & 0 deletions docs/ja-jp/manage/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -152,6 +152,31 @@ asdfプラグインのショートネームリポジトリの同期を無効化

備考: `ASDF_CONCURRENCY`環境変数が設定されている場合はそちらが優先されます。

### プラグインフック

下記のタイミングで、カスタムコードを実行することができます:

- プラグインのインストール、Shim再生成、更新および削除をする際の前後
- プラグインコマンドの実行前後

例えば、`foo`というプラグインがインストールされていて、`bar`という実行可能ファイルが提供されている場合、以下のようなフックを使うことで、一番最初にカスタムコードを実行することができます:

```text
pre_foo_bar = echo Executing with args: $@
```

以下のパターンがサポートされています:

- `pre_<plugin_name>_<command>`
- `pre_asdf_download_<plugin_name>`
- `{pre,post}_asdf_{install,reshim,uninstall}_<plugin_name>`
- `$1`: フルバージョン
- `{pre,post}_asdf_plugin_{add,update,remove,reshim}`
- `$1`: プラグイン名
- `{pre,post}_asdf_plugin_{add,update,remove}_<plugin_name>`

どのようなコマンドの前後にどのようなコマンドフックを実行すべきかについての詳細は、[プラグインの作成](../plugins/create.md)をご覧ください。

## 環境変数

環境変数の設定値は、お使いのシステムやシェルによって異なります。デフォルトロケーションは、インストールした場所や方法(Gitクローン、Homebrew、AUR)によって異なります。
Expand Down
2 changes: 1 addition & 1 deletion docs/ja-jp/plugins/create.md
Original file line number Diff line number Diff line change
Expand Up @@ -814,7 +814,7 @@ asdf plugin test <plugin_name> <plugin_url> [--asdf-tool-version <version>] [--a
デフォルトは、`asdf latest <plugin-name>`です。
- オプションで`[--asdf-plugin-gitref <git_ref>]`を指定すると、
そのコミット/ブランチ/タグでプラグイン自体をチェックアウトします。
これは、プラグインのCIにおいて、プルリクエストをテストする際に便利です。
これは、プラグインのCIにおいて、プルリクエストをテストする際に便利です。デフォルトは、プラグインリポジトリのデフォルトブランチとなります。
- オプションの`[test_command...]`パラメータは、インストールしたツールが正しく動作するかを確認するために実行するコマンドです。
通常は、`<tool> --version`または`<tool> --help`となります。
例えば、NodeJSプラグインをテストするときは、次のように実行します:
Expand Down

0 comments on commit 234005e

Please sign in to comment.