Deploy to GitHub pages

CNAME

@@ -0,0 +1 @@
+asdf-vm.com

assets/app.BjlyxdH5.js

@@ -0,0 +1 @@
+import{t as i}from"./chunks/theme.Cb3KoOiM.js";import{R as o,a3 as u,a4 as c,a5 as l,a6 as f,a7 as d,a8 as m,a9 as h,aa as g,ab as A,ac as v,d as P,u as y,v as C,s as b,ad as w,ae as R,af as E,ag as S}from"./chunks/framework.BQmytedh.js";function p(e){if(e.extends){const a=p(e.extends);return{...a,...e,async enhanceApp(t){a.enhanceApp&&await a.enhanceApp(t),e.enhanceApp&&await e.enhanceApp(t)}}}return e}const s=p(i),T=P({name:"VitePressApp",setup(){const{site:e,lang:a,dir:t}=y();return C(()=>{b(()=>{document.documentElement.lang=a.value,document.documentElement.dir=t.value})}),e.value.router.prefetchLinks&&w(),R(),E(),s.setup&&s.setup(),()=>S(s.Layout)}});async function D(){globalThis.__VITEPRESS__=!0;const e=j(),a=_();a.provide(c,e);const t=l(e.route);return a.provide(f,t),a.component("Content",d),a.component("ClientOnly",m),Object.defineProperties(a.config.globalProperties,{$frontmatter:{get(){return t.frontmatter.value}},$params:{get(){return t.page.value.params}}}),s.enhanceApp&&await s.enhanceApp({app:a,router:e,siteData:h}),{app:a,router:e,data:t}}function _(){return g(T)}function j(){let e=o,a;return A(t=>{let n=v(t),r=null;return n&&(e&&(a=n),(e||a===n)&&(n=n.replace(/\.js$/,".lean.js")),r=import(n)),o&&(e=!1),r},s.NotFound)}o&&D().then(({app:e,router:a,data:t})=>{a.go().then(()=>{u(a.route,t.site),e.mount("#app")})});export{D as createApp};

assets/contribute_core.md.Dwn6SPRK.js

@@ -0,0 +1,39 @@
+import{_ as e,c as a,a2 as i,o as t}from"./chunks/framework.BQmytedh.js";const g=JSON.parse('{"title":"asdf","description":"","frontmatter":{},"headers":[],"relativePath":"contribute/core.md","filePath":"contribute/core.md","lastUpdated":1728309110000}'),n={name:"contribute/core.md"};function l(o,s,p,r,h,d){return t(),a("div",null,s[0]||(s[0]=[i(`<h1 id="asdf" tabindex="-1">asdf <a class="header-anchor" href="#asdf" aria-label="Permalink to &quot;asdf&quot;">​</a></h1><p><code>asdf</code> core contribution guide.</p><h2 id="initial-setup" tabindex="-1">Initial Setup <a class="header-anchor" href="#initial-setup" aria-label="Permalink to &quot;Initial Setup&quot;">​</a></h2><p>Fork <code>asdf</code> on GitHub and/or Git clone the default branch:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># clone your fork</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">GITHUB_USE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">R</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/asdf.git</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># or clone asdf</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/asdf-vm/asdf.git</span></span></code></pre></div><p>The tools for core development are in this repo&#39;s <code>.tool-versions</code>. If you wish to manage with <code>asdf</code> itself, add the plugins:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bats</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/timgluz/asdf-bats.git</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shellcheck</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/luizm/asdf-shellcheck.git</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shfmt</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/luizm/asdf-shfmt.git</span></span></code></pre></div><p>Install the versions to develop <code>asdf</code> with:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span></span></code></pre></div><p>It <em>may</em> be useful to not use <code>asdf</code> to manage the tools during development on your local machine as you may need to break functionality which would then break your dev tooling. Here&#39;s the raw list of tools:</p><ul><li><a href="https://github.com/bats-core/bats-core" target="_blank" rel="noreferrer">bats-core</a>: Bash Automated Testing System, for unit testing Bash or POSIX compliant scripts.</li><li><a href="https://github.com/koalaman/shellcheck" target="_blank" rel="noreferrer">shellcheck</a>: Static analysis tool for shell scripts.</li><li><a href="https://github.com/mvdan/sh" target="_blank" rel="noreferrer">shfmt</a>: A shell parser, formatter, and interpreter with bash support; includes shfmt</li></ul><h2 id="development" tabindex="-1">Development <a class="header-anchor" href="#development" aria-label="Permalink to &quot;Development&quot;">​</a></h2><p>If you want to try out your changes without making change to your installed <code>asdf</code>, you can set the <code>$ASDF_DIR</code> variable to the path where you cloned the repository, and temporarily prepend the <code>bin</code> and <code>shims</code> directory of the directory to your path.</p><p>It is best to format, lint and test your code locally before you commit or push to the remote. Use the following scripts/commands:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Lint</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/lint.bash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --check</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Fix &amp; Format</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/lint.bash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --fix</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Test: all tests</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/test.bash</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Test: for specific command</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bats</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test/list_commands.bash</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">TIP</p><p><strong>Add tests!</strong> - Tests are <strong>required</strong> for new features and speed up review of bug fixes. Please cover new code paths before you create a Pull Request. See <a href="https://bats-core.readthedocs.io/en/stable/index.html" target="_blank" rel="noreferrer">bats-core documentation</a></p></div><h3 id="gitignore" tabindex="-1">Gitignore <a class="header-anchor" href="#gitignore" aria-label="Permalink to &quot;Gitignore&quot;">​</a></h3><p>The following is the <code>.gitignore</code> file in the <code>asdf-vm/asdf</code> repository. We ignore project-specific files. Files specific to your OS, tools or workflows should be ignored in your global <code>.gitignore</code> configuration, <a href="http://stratus3d.com/blog/2018/06/03/stop-excluding-editor-temp-files-in-gitignore/" target="_blank" rel="noreferrer">see here</a> for more details.</p><div class="language-gitignore vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">gitignore</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>/installs</span></span>
+<span class="line"><span>/downloads</span></span>
+<span class="line"><span>/shims</span></span>
+<span class="line"><span>repository</span></span>
+<span class="line"><span>.vagrant</span></span>
+<span class="line"><span>keyrings</span></span>
+<span class="line"><span>/tmp</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>dist/</span></span></code></pre></div><h3 id="git-blame-ignore-revs" tabindex="-1"><code>.git-blame-ignore-revs</code> <a class="header-anchor" href="#git-blame-ignore-revs" aria-label="Permalink to &quot;\`.git-blame-ignore-revs\`&quot;">​</a></h3><p><code>asdf</code> uses a <code>.git-blame-ignore-revs</code> to reduce noise when running a blame. See the <a href="https://git-scm.com/docs/git-blame" target="_blank" rel="noreferrer">git blame documentation</a> for more information.</p><p>Use the file with <code>git blame</code> like so:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blame</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --ignore-revs-file</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .git-blame-ignore-revs</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ./test/install_command.bats</span></span></code></pre></div><p>Optionally, configure to use the file on every invocation of <code>blame</code> without manually supplying it:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> config</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blame.ignoreRevsFile</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .git-blame-ignore-revs</span></span></code></pre></div><p>It is possible to configure IDEs to use this file. For example, when using VSCode (with <a href="https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens" target="_blank" rel="noreferrer">GitLens</a>), write the following to <code>.vscode/settings.json</code>:</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  &quot;gitlens.advanced.blame.customArguments&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span></span>
+<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    &quot;--ignore-revs-file&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    &quot;.git-blame-ignore-revs&quot;</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  ]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h2 id="bats-testing" tabindex="-1">Bats Testing <a class="header-anchor" href="#bats-testing" aria-label="Permalink to &quot;Bats Testing&quot;">​</a></h2><p>Execute tests locally with:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/test.bash</span></span></code></pre></div><p>Before writing tests <strong>please read</strong>:</p><ul><li>existing tests in <code>test/</code></li><li><a href="https://bats-core.readthedocs.io/en/stable/index.html" target="_blank" rel="noreferrer">bats-core documentation</a></li><li>existing Bats settings used in <code>scripts/test.bash</code></li></ul><h3 id="bats-tips" tabindex="-1">Bats Tips <a class="header-anchor" href="#bats-tips" aria-label="Permalink to &quot;Bats Tips&quot;">​</a></h3><p>Bats debugging can be difficult at times. Using the TAP output with <code>-t</code> flag will enable you to print outputs with the special file descriptor <code>&gt;&amp;3</code> during test execution, simplifying debugging. As an example:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># test/some_tests.bats</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">printf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;%s\\n&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Will not be printed during bats test/some_tests.bats&quot;</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">printf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;%s\\n&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Will be printed during bats -t test/some_tests.bats&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &gt;&amp;3</span></span></code></pre></div><p>This is further documented in bats-core <a href="https://bats-core.readthedocs.io/en/stable/writing-tests.html#printing-to-the-terminal" target="_blank" rel="noreferrer">Printing to the Terminal</a>.</p><h2 id="pull-requests-releases-conventional-commits" tabindex="-1">Pull Requests, Releases &amp; Conventional Commits <a class="header-anchor" href="#pull-requests-releases-conventional-commits" aria-label="Permalink to &quot;Pull Requests, Releases &amp; Conventional Commits&quot;">​</a></h2><p><code>asdf</code> is using an automated release tool called <a href="https://github.com/googleapis/release-please" target="_blank" rel="noreferrer">Release Please</a> to automatically bump the <a href="https://semver.org/" target="_blank" rel="noreferrer">SemVer</a> version and generate the <a href="https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md" target="_blank" rel="noreferrer">Changelog</a>. This information is determined by reading the commit history since the last release.</p><p><a href="https://www.conventionalcommits.org/" target="_blank" rel="noreferrer">Conventional Commit messages</a> define the format of the Pull Request Title which becomes the commit message format on the default branch. This is enforced with GitHub Action <a href="https://github.com/amannn/action-semantic-pull-request" target="_blank" rel="noreferrer"><code>amannn/action-semantic-pull-request</code></a>.</p><p>Conventional Commit follows this format:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>&lt;type&gt;[optional scope][optional !]: &lt;description&gt;</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>&lt;!-- examples --&gt;</span></span>
+<span class="line"><span>fix: some fix</span></span>
+<span class="line"><span>feat: a new feature</span></span>
+<span class="line"><span>docs: some documentation update</span></span>
+<span class="line"><span>docs(website): some change for the website</span></span>
+<span class="line"><span>feat!: feature with breaking change</span></span></code></pre></div><p>The full list of <code>&lt;types&gt;</code> are: <code>feat</code>, <code>fix</code>, <code>docs</code>, <code>style</code>, <code>refactor</code>, <code>perf</code>, <code>test</code>, <code>build</code>, <code>ci</code>, <code>chore</code>, <code>revert</code>.</p><ul><li><code>!</code>: indicates a breaking change</li><li><code>fix</code>: will create a new SemVer <code>patch</code></li><li><code>feat</code>: will create a new SemVer <code>minor</code></li><li><code>&lt;type&gt;!</code>: will create a new SemVer <code>major</code></li></ul><p>The Pull Request Title must follow this format.</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>Use Conventional Commit message format for your Pull Request Title.</p></div><h2 id="docker-images" tabindex="-1">Docker Images <a class="header-anchor" href="#docker-images" aria-label="Permalink to &quot;Docker Images&quot;">​</a></h2><p>The <a href="https://github.com/vic/asdf-alpine" target="_blank" rel="noreferrer">asdf-alpine</a> and <a href="https://github.com/vic/asdf-ubuntu" target="_blank" rel="noreferrer">asdf-ubuntu</a> projects are an ongoing effort to provide Dockerized images of some asdf tools. You can use these docker images as base for your development servers, or for running your production apps.</p>`,47)]))}const k=e(n,[["render",l]]);export{g as __pageData,k as default};

assets/contribute_core.md.Dwn6SPRK.lean.js

@@ -0,0 +1,39 @@
+import{_ as e,c as a,a2 as i,o as t}from"./chunks/framework.BQmytedh.js";const g=JSON.parse('{"title":"asdf","description":"","frontmatter":{},"headers":[],"relativePath":"contribute/core.md","filePath":"contribute/core.md","lastUpdated":1728309110000}'),n={name:"contribute/core.md"};function l(o,s,p,r,h,d){return t(),a("div",null,s[0]||(s[0]=[i(`<h1 id="asdf" tabindex="-1">asdf <a class="header-anchor" href="#asdf" aria-label="Permalink to &quot;asdf&quot;">​</a></h1><p><code>asdf</code> core contribution guide.</p><h2 id="initial-setup" tabindex="-1">Initial Setup <a class="header-anchor" href="#initial-setup" aria-label="Permalink to &quot;Initial Setup&quot;">​</a></h2><p>Fork <code>asdf</code> on GitHub and/or Git clone the default branch:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># clone your fork</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">GITHUB_USE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">R</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/asdf.git</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># or clone asdf</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/asdf-vm/asdf.git</span></span></code></pre></div><p>The tools for core development are in this repo&#39;s <code>.tool-versions</code>. If you wish to manage with <code>asdf</code> itself, add the plugins:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bats</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/timgluz/asdf-bats.git</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shellcheck</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/luizm/asdf-shellcheck.git</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shfmt</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/luizm/asdf-shfmt.git</span></span></code></pre></div><p>Install the versions to develop <code>asdf</code> with:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span></span></code></pre></div><p>It <em>may</em> be useful to not use <code>asdf</code> to manage the tools during development on your local machine as you may need to break functionality which would then break your dev tooling. Here&#39;s the raw list of tools:</p><ul><li><a href="https://github.com/bats-core/bats-core" target="_blank" rel="noreferrer">bats-core</a>: Bash Automated Testing System, for unit testing Bash or POSIX compliant scripts.</li><li><a href="https://github.com/koalaman/shellcheck" target="_blank" rel="noreferrer">shellcheck</a>: Static analysis tool for shell scripts.</li><li><a href="https://github.com/mvdan/sh" target="_blank" rel="noreferrer">shfmt</a>: A shell parser, formatter, and interpreter with bash support; includes shfmt</li></ul><h2 id="development" tabindex="-1">Development <a class="header-anchor" href="#development" aria-label="Permalink to &quot;Development&quot;">​</a></h2><p>If you want to try out your changes without making change to your installed <code>asdf</code>, you can set the <code>$ASDF_DIR</code> variable to the path where you cloned the repository, and temporarily prepend the <code>bin</code> and <code>shims</code> directory of the directory to your path.</p><p>It is best to format, lint and test your code locally before you commit or push to the remote. Use the following scripts/commands:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Lint</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/lint.bash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --check</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Fix &amp; Format</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/lint.bash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --fix</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Test: all tests</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/test.bash</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Test: for specific command</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bats</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test/list_commands.bash</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">TIP</p><p><strong>Add tests!</strong> - Tests are <strong>required</strong> for new features and speed up review of bug fixes. Please cover new code paths before you create a Pull Request. See <a href="https://bats-core.readthedocs.io/en/stable/index.html" target="_blank" rel="noreferrer">bats-core documentation</a></p></div><h3 id="gitignore" tabindex="-1">Gitignore <a class="header-anchor" href="#gitignore" aria-label="Permalink to &quot;Gitignore&quot;">​</a></h3><p>The following is the <code>.gitignore</code> file in the <code>asdf-vm/asdf</code> repository. We ignore project-specific files. Files specific to your OS, tools or workflows should be ignored in your global <code>.gitignore</code> configuration, <a href="http://stratus3d.com/blog/2018/06/03/stop-excluding-editor-temp-files-in-gitignore/" target="_blank" rel="noreferrer">see here</a> for more details.</p><div class="language-gitignore vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">gitignore</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>/installs</span></span>
+<span class="line"><span>/downloads</span></span>
+<span class="line"><span>/shims</span></span>
+<span class="line"><span>repository</span></span>
+<span class="line"><span>.vagrant</span></span>
+<span class="line"><span>keyrings</span></span>
+<span class="line"><span>/tmp</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>dist/</span></span></code></pre></div><h3 id="git-blame-ignore-revs" tabindex="-1"><code>.git-blame-ignore-revs</code> <a class="header-anchor" href="#git-blame-ignore-revs" aria-label="Permalink to &quot;\`.git-blame-ignore-revs\`&quot;">​</a></h3><p><code>asdf</code> uses a <code>.git-blame-ignore-revs</code> to reduce noise when running a blame. See the <a href="https://git-scm.com/docs/git-blame" target="_blank" rel="noreferrer">git blame documentation</a> for more information.</p><p>Use the file with <code>git blame</code> like so:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blame</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --ignore-revs-file</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .git-blame-ignore-revs</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ./test/install_command.bats</span></span></code></pre></div><p>Optionally, configure to use the file on every invocation of <code>blame</code> without manually supplying it:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> config</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blame.ignoreRevsFile</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .git-blame-ignore-revs</span></span></code></pre></div><p>It is possible to configure IDEs to use this file. For example, when using VSCode (with <a href="https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens" target="_blank" rel="noreferrer">GitLens</a>), write the following to <code>.vscode/settings.json</code>:</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  &quot;gitlens.advanced.blame.customArguments&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span></span>
+<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    &quot;--ignore-revs-file&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    &quot;.git-blame-ignore-revs&quot;</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  ]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h2 id="bats-testing" tabindex="-1">Bats Testing <a class="header-anchor" href="#bats-testing" aria-label="Permalink to &quot;Bats Testing&quot;">​</a></h2><p>Execute tests locally with:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/test.bash</span></span></code></pre></div><p>Before writing tests <strong>please read</strong>:</p><ul><li>existing tests in <code>test/</code></li><li><a href="https://bats-core.readthedocs.io/en/stable/index.html" target="_blank" rel="noreferrer">bats-core documentation</a></li><li>existing Bats settings used in <code>scripts/test.bash</code></li></ul><h3 id="bats-tips" tabindex="-1">Bats Tips <a class="header-anchor" href="#bats-tips" aria-label="Permalink to &quot;Bats Tips&quot;">​</a></h3><p>Bats debugging can be difficult at times. Using the TAP output with <code>-t</code> flag will enable you to print outputs with the special file descriptor <code>&gt;&amp;3</code> during test execution, simplifying debugging. As an example:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># test/some_tests.bats</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">printf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;%s\\n&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Will not be printed during bats test/some_tests.bats&quot;</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">printf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;%s\\n&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Will be printed during bats -t test/some_tests.bats&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &gt;&amp;3</span></span></code></pre></div><p>This is further documented in bats-core <a href="https://bats-core.readthedocs.io/en/stable/writing-tests.html#printing-to-the-terminal" target="_blank" rel="noreferrer">Printing to the Terminal</a>.</p><h2 id="pull-requests-releases-conventional-commits" tabindex="-1">Pull Requests, Releases &amp; Conventional Commits <a class="header-anchor" href="#pull-requests-releases-conventional-commits" aria-label="Permalink to &quot;Pull Requests, Releases &amp; Conventional Commits&quot;">​</a></h2><p><code>asdf</code> is using an automated release tool called <a href="https://github.com/googleapis/release-please" target="_blank" rel="noreferrer">Release Please</a> to automatically bump the <a href="https://semver.org/" target="_blank" rel="noreferrer">SemVer</a> version and generate the <a href="https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md" target="_blank" rel="noreferrer">Changelog</a>. This information is determined by reading the commit history since the last release.</p><p><a href="https://www.conventionalcommits.org/" target="_blank" rel="noreferrer">Conventional Commit messages</a> define the format of the Pull Request Title which becomes the commit message format on the default branch. This is enforced with GitHub Action <a href="https://github.com/amannn/action-semantic-pull-request" target="_blank" rel="noreferrer"><code>amannn/action-semantic-pull-request</code></a>.</p><p>Conventional Commit follows this format:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>&lt;type&gt;[optional scope][optional !]: &lt;description&gt;</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>&lt;!-- examples --&gt;</span></span>
+<span class="line"><span>fix: some fix</span></span>
+<span class="line"><span>feat: a new feature</span></span>
+<span class="line"><span>docs: some documentation update</span></span>
+<span class="line"><span>docs(website): some change for the website</span></span>
+<span class="line"><span>feat!: feature with breaking change</span></span></code></pre></div><p>The full list of <code>&lt;types&gt;</code> are: <code>feat</code>, <code>fix</code>, <code>docs</code>, <code>style</code>, <code>refactor</code>, <code>perf</code>, <code>test</code>, <code>build</code>, <code>ci</code>, <code>chore</code>, <code>revert</code>.</p><ul><li><code>!</code>: indicates a breaking change</li><li><code>fix</code>: will create a new SemVer <code>patch</code></li><li><code>feat</code>: will create a new SemVer <code>minor</code></li><li><code>&lt;type&gt;!</code>: will create a new SemVer <code>major</code></li></ul><p>The Pull Request Title must follow this format.</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>Use Conventional Commit message format for your Pull Request Title.</p></div><h2 id="docker-images" tabindex="-1">Docker Images <a class="header-anchor" href="#docker-images" aria-label="Permalink to &quot;Docker Images&quot;">​</a></h2><p>The <a href="https://github.com/vic/asdf-alpine" target="_blank" rel="noreferrer">asdf-alpine</a> and <a href="https://github.com/vic/asdf-ubuntu" target="_blank" rel="noreferrer">asdf-ubuntu</a> projects are an ongoing effort to provide Dockerized images of some asdf tools. You can use these docker images as base for your development servers, or for running your production apps.</p>`,47)]))}const k=e(n,[["render",l]]);export{g as __pageData,k as default};

assets/contribute_first-party-plugins.md.An0qw423.js

@@ -0,0 +1 @@
+import{_ as r,c as t,a2 as a,o as i}from"./chunks/framework.BQmytedh.js";const u=JSON.parse('{"title":"First-Party Plugins","description":"","frontmatter":{},"headers":[],"relativePath":"contribute/first-party-plugins.md","filePath":"contribute/first-party-plugins.md","lastUpdated":1627017981000}'),o={name:"contribute/first-party-plugins.md"};function s(l,e,n,d,c,f){return i(),t("div",null,e[0]||(e[0]=[a('<h1 id="first-party-plugins" tabindex="-1">First-Party Plugins <a class="header-anchor" href="#first-party-plugins" aria-label="Permalink to &quot;First-Party Plugins&quot;">​</a></h1><p>The asdf core team has authored some plugins relevant to their daily work life. Help is always welcome in maintaining and improving these plugins. See the associated repo for each linked below:</p><ul><li><a href="https://github.com/asdf-vm/asdf-elixir" target="_blank" rel="noreferrer">Elixir</a></li><li><a href="https://github.com/asdf-vm/asdf-erlang" target="_blank" rel="noreferrer">Erlang</a></li><li><a href="https://github.com/asdf-vm/asdf-nodejs" target="_blank" rel="noreferrer">Node.js</a></li><li><a href="https://github.com/asdf-vm/asdf-ruby" target="_blank" rel="noreferrer">Ruby</a></li></ul><p>For community plugins, see:</p><ul><li><a href="https://github.com/asdf-community" target="_blank" rel="noreferrer"><code>asdf-community</code> organisation</a>: A collaborative, community-driven project for long-term maintenance of <code>asdf</code> plugins.</li><li><a href="https://github.com/asdf-vm/asdf-plugins" target="_blank" rel="noreferrer"><code>asdf-plugins</code> shortname repo</a>: Short-name list used by <code>asdf</code> core to lookup popular <code>asdf</code> plugins.</li><li><a href="https://github.com/topics/asdf-plugin" target="_blank" rel="noreferrer">GitHub <code>asdf-plugin</code> topic search</a></li></ul>',5)]))}const g=r(o,[["render",s]]);export{u as __pageData,g as default};

assets/contribute_first-party-plugins.md.An0qw423.lean.js

@@ -0,0 +1 @@
+import{_ as r,c as t,a2 as a,o as i}from"./chunks/framework.BQmytedh.js";const u=JSON.parse('{"title":"First-Party Plugins","description":"","frontmatter":{},"headers":[],"relativePath":"contribute/first-party-plugins.md","filePath":"contribute/first-party-plugins.md","lastUpdated":1627017981000}'),o={name:"contribute/first-party-plugins.md"};function s(l,e,n,d,c,f){return i(),t("div",null,e[0]||(e[0]=[a('<h1 id="first-party-plugins" tabindex="-1">First-Party Plugins <a class="header-anchor" href="#first-party-plugins" aria-label="Permalink to &quot;First-Party Plugins&quot;">​</a></h1><p>The asdf core team has authored some plugins relevant to their daily work life. Help is always welcome in maintaining and improving these plugins. See the associated repo for each linked below:</p><ul><li><a href="https://github.com/asdf-vm/asdf-elixir" target="_blank" rel="noreferrer">Elixir</a></li><li><a href="https://github.com/asdf-vm/asdf-erlang" target="_blank" rel="noreferrer">Erlang</a></li><li><a href="https://github.com/asdf-vm/asdf-nodejs" target="_blank" rel="noreferrer">Node.js</a></li><li><a href="https://github.com/asdf-vm/asdf-ruby" target="_blank" rel="noreferrer">Ruby</a></li></ul><p>For community plugins, see:</p><ul><li><a href="https://github.com/asdf-community" target="_blank" rel="noreferrer"><code>asdf-community</code> organisation</a>: A collaborative, community-driven project for long-term maintenance of <code>asdf</code> plugins.</li><li><a href="https://github.com/asdf-vm/asdf-plugins" target="_blank" rel="noreferrer"><code>asdf-plugins</code> shortname repo</a>: Short-name list used by <code>asdf</code> core to lookup popular <code>asdf</code> plugins.</li><li><a href="https://github.com/topics/asdf-plugin" target="_blank" rel="noreferrer">GitHub <code>asdf-plugin</code> topic search</a></li></ul>',5)]))}const g=r(o,[["render",s]]);export{u as __pageData,g as default};

assets/contribute_github-actions.md.CIAqdwgh.js

@@ -0,0 +1 @@
+import{_ as i,c as s,j as t,a as e,o as n}from"./chunks/framework.BQmytedh.js";const p=JSON.parse('{"title":"GitHub Actions","description":"","frontmatter":{},"headers":[],"relativePath":"contribute/github-actions.md","filePath":"contribute/github-actions.md","lastUpdated":1627017981000}'),o={name:"contribute/github-actions.md"};function r(c,a,u,d,l,h){return n(),s("div",null,a[0]||(a[0]=[t("h1",{id:"github-actions",tabindex:"-1"},[e("GitHub Actions "),t("a",{class:"header-anchor",href:"#github-actions","aria-label":'Permalink to "GitHub Actions"'},"​")],-1),t("p",null,[e("Thanks for your interest, please see the "),t("a",{href:"https://github.com/asdf-vm/actions",target:"_blank",rel:"noreferrer"},"asdf actions repo"),e(" for their existing Issues, conversations and Contributing Guidelines.")],-1)]))}const f=i(o,[["render",r]]);export{p as __pageData,f as default};

assets/contribute_github-actions.md.CIAqdwgh.lean.js

@@ -0,0 +1 @@
+import{_ as i,c as s,j as t,a as e,o as n}from"./chunks/framework.BQmytedh.js";const p=JSON.parse('{"title":"GitHub Actions","description":"","frontmatter":{},"headers":[],"relativePath":"contribute/github-actions.md","filePath":"contribute/github-actions.md","lastUpdated":1627017981000}'),o={name:"contribute/github-actions.md"};function r(c,a,u,d,l,h){return n(),s("div",null,a[0]||(a[0]=[t("h1",{id:"github-actions",tabindex:"-1"},[e("GitHub Actions "),t("a",{class:"header-anchor",href:"#github-actions","aria-label":'Permalink to "GitHub Actions"'},"​")],-1),t("p",null,[e("Thanks for your interest, please see the "),t("a",{href:"https://github.com/asdf-vm/actions",target:"_blank",rel:"noreferrer"},"asdf actions repo"),e(" for their existing Issues, conversations and Contributing Guidelines.")],-1)]))}const f=i(o,[["render",r]]);export{p as __pageData,f as default};

assets/index.md.Bl7STBtd.js

@@ -0,0 +1 @@
+import{_ as e,c as t,o as i}from"./chunks/framework.BQmytedh.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{"layout":"home","hero":{"name":"asdf","text":"The Multiple Runtime Version Manager","tagline":"Manage all your runtime versions with one tool!","actions":[{"theme":"brand","text":"Get Started","link":"/guide/getting-started"},{"theme":"alt","text":"What is asdf?","link":"/guide/introduction"},{"theme":"alt","text":"View on GitHub","link":"https://github.com/asdf-vm/asdf"}]},"features":[{"title":"One Tool","details":"Manage each of your project runtimes with a single CLI tool and command interface.","icon":"🎉"},{"title":"Plugins","details":"Large ecosystem of existing runtimes & tools. Simple API to add support for new tools as you need!","icon":"🔌"},{"title":"Backwards Compatible","details":"Support for existing config files .nvmrc, .node-version, .ruby-version for smooth migration!","icon":"⏮"},{"title":"One Config File","details":".tool-versions to manage all your tools, runtimes and their versions in a single, sharable place.","icon":"📄"},{"title":"Shells","details":"Supports Bash, ZSH, Fish & Elvish with completions available.","icon":"🐚"},{"title":"GitHub Actions","details":"Provides a GitHub Action to install and utilize your .tool-versions in your CI/CD workflows.","icon":"🤖"}]},"headers":[],"relativePath":"index.md","filePath":"index.md","lastUpdated":1700090238000}'),o={name:"index.md"};function n(a,s,l,r,d,c){return i(),t("div")}const p=e(o,[["render",n]]);export{u as __pageData,p as default};

assets/index.md.Bl7STBtd.lean.js

@@ -0,0 +1 @@
+import{_ as e,c as t,o as i}from"./chunks/framework.BQmytedh.js";const u=JSON.parse('{"title":"","description":"","frontmatter":{"layout":"home","hero":{"name":"asdf","text":"The Multiple Runtime Version Manager","tagline":"Manage all your runtime versions with one tool!","actions":[{"theme":"brand","text":"Get Started","link":"/guide/getting-started"},{"theme":"alt","text":"What is asdf?","link":"/guide/introduction"},{"theme":"alt","text":"View on GitHub","link":"https://github.com/asdf-vm/asdf"}]},"features":[{"title":"One Tool","details":"Manage each of your project runtimes with a single CLI tool and command interface.","icon":"🎉"},{"title":"Plugins","details":"Large ecosystem of existing runtimes & tools. Simple API to add support for new tools as you need!","icon":"🔌"},{"title":"Backwards Compatible","details":"Support for existing config files .nvmrc, .node-version, .ruby-version for smooth migration!","icon":"⏮"},{"title":"One Config File","details":".tool-versions to manage all your tools, runtimes and their versions in a single, sharable place.","icon":"📄"},{"title":"Shells","details":"Supports Bash, ZSH, Fish & Elvish with completions available.","icon":"🐚"},{"title":"GitHub Actions","details":"Provides a GitHub Action to install and utilize your .tool-versions in your CI/CD workflows.","icon":"🤖"}]},"headers":[],"relativePath":"index.md","filePath":"index.md","lastUpdated":1700090238000}'),o={name:"index.md"};function n(a,s,l,r,d,c){return i(),t("div")}const p=e(o,[["render",n]]);export{u as __pageData,p as default};

assets/ja-jp_contribute_core.md.CJW3eeff.js

@@ -0,0 +1,31 @@
+import{_ as a,c as e,a2 as i,o as t}from"./chunks/framework.BQmytedh.js";const k=JSON.parse('{"title":"asdf","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/contribute/core.md","filePath":"ja-jp/contribute/core.md","lastUpdated":1704890757000}'),n={name:"ja-jp/contribute/core.md"};function l(p,s,h,o,r,d){return t(),e("div",null,s[0]||(s[0]=[i(`<h1 id="asdf" tabindex="-1">asdf <a class="header-anchor" href="#asdf" aria-label="Permalink to &quot;asdf&quot;">​</a></h1><p>これは、<code>asdf</code>コアのコントリビューションガイドです。</p><h2 id="初期セットアップ" tabindex="-1">初期セットアップ <a class="header-anchor" href="#初期セットアップ" aria-label="Permalink to &quot;初期セットアップ&quot;">​</a></h2><p>GitHubで<code>asdf</code>をフォークするか、デフォルトのブランチをGitクローンしてください:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># clone your fork</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">GITHUB_USE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">R</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/asdf.git</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># or clone asdf</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/asdf-vm/asdf.git</span></span></code></pre></div><p>コア開発用のツールは、このリポジトリの<code>.tool-versions</code>で定義されています。<code>asdf</code>自身でこれらのツールを管理したい場合は、下記のようにプラグインを追加してください:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bats</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/timgluz/asdf-bats.git</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shellcheck</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/luizm/asdf-shellcheck.git</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shfmt</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/luizm/asdf-shfmt.git</span></span></code></pre></div><p><code>asdf</code>の開発に必要なバージョンを、下記のようにインストールします:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span></span></code></pre></div><p>開発ツールに影響を与える特定の機能を壊す可能性もあるため、ローカルマシンで開発する際は、<code>asdf</code>を使用しないほうが <em>良いかもしれません</em> 。下記に、使用しているツールを列挙します:</p><ul><li><a href="https://github.com/bats-core/bats-core" target="_blank" rel="noreferrer">bats-core</a>: BashまたはPOSIX準拠のスクリプトを単体テストするための、Bash自動テストシステムです。</li><li><a href="https://github.com/koalaman/shellcheck" target="_blank" rel="noreferrer">shellcheck</a>: シェルスクリプトの静的解析ツールです。</li><li><a href="https://github.com/mvdan/sh" target="_blank" rel="noreferrer">shfmt</a>: Bashをサポートするシェルパーサ、フォーマッタ、インタプリタです。</li></ul><h2 id="開発" tabindex="-1">開発 <a class="header-anchor" href="#開発" aria-label="Permalink to &quot;開発&quot;">​</a></h2><p>インストール済みの<code>asdf</code>に変更を加えずに、あなたが開発した変更内容を試したいときは、<code>$ASDF_DIR</code>変数に、クローンしたリポジトリのパスを設定し、そのディレクトリの<code>bin</code>と<code>shims</code>ディレクトリを一時的にパスの先頭へ追加します。</p><p>リモートにコミットまたはプッシュする前に、コードをローカルでフォーマット、Lint、およびテストすることを推奨します。その際は、次のスクリプト/コマンドを使用してください:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Lint</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/lint.bash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --check</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Fix &amp; Format</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/lint.bash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --fix</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Test: all tests</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/test.bash</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Test: for specific command</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bats</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test/list_commands.bash</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">ヒント</p><p><strong>テストを作ってください!</strong> - 新機能にとってテストは<strong>必要不可欠</strong>であり、バグ修正のレビューをスピードアップさせることができます。プルリクエストを作成する前に、新しいコードをカバーするようなテストを作成してください。<a href="https://bats-core.readthedocs.io/en/stable/index.html" target="_blank" rel="noreferrer">bats-coreのドキュメント</a>もご覧ください。</p></div><h3 id="gitignore" tabindex="-1">Gitignore <a class="header-anchor" href="#gitignore" aria-label="Permalink to &quot;Gitignore&quot;">​</a></h3><p>下記は、<code>asdf-vm/asdf</code>リポジトリの<code>.gitignore</code>ファイルです。プロジェクト固有のファイルは無視をしています。使用しているOS、ツール、およびワークフロー固有のファイルは、グローバルな<code>.gitignore</code>構成で無視する必要があります。詳しくは<a href="http://stratus3d.com/blog/2018/06/03/stop-excluding-editor-temp-files-in-gitignore/" target="_blank" rel="noreferrer">こちら</a>をご覧ください。</p><p>@<a href="https://github.com/asdf-vm/asdf/blob/master/.gitignore" target="_blank" rel="noreferrer">Gitignoreコード</a></p><h3 id="git-blame-ignore-revs" tabindex="-1"><code>.git-blame-ignore-revs</code> <a class="header-anchor" href="#git-blame-ignore-revs" aria-label="Permalink to &quot;\`.git-blame-ignore-revs\`&quot;">​</a></h3><p><code>asdf</code>では、<code>.git-blame-ignore-revs</code>を使用して、Blameを実行する際のノイズを減らしています。詳しくは、<a href="https://git-scm.com/docs/git-blame" target="_blank" rel="noreferrer">git blameのドキュメント</a>をご覧ください。</p><p><code>git blame</code>を実行するときは、下記のように、このファイルと共に使います:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blame</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --ignore-revs-file</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .git-blame-ignore-revs</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ./test/install_command.bats</span></span></code></pre></div><p>毎回手動でファイルを指定しなくても、gitのオプションで、<code>blame</code>を呼び出すたびにこのファイルを使うように設定することもできます:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> config</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blame.ignoreRevsFile</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .git-blame-ignore-revs</span></span></code></pre></div><p>このファイルを使用するように、IDEを設定することもできます。例えば、VSCode(および<a href="https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens" target="_blank" rel="noreferrer">GitLens</a>)を使う場合は、<code>.vscode/settings.json</code>に下記のように記述します:</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  &quot;gitlens.advanced.blame.customArguments&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span></span>
+<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    &quot;--ignore-revs-file&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    &quot;.git-blame-ignore-revs&quot;</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  ]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h2 id="batsテスト" tabindex="-1">Batsテスト <a class="header-anchor" href="#batsテスト" aria-label="Permalink to &quot;Batsテスト&quot;">​</a></h2><p>ローカルでテストを実行するには、下記のようにテストを呼び出します:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/test.bash</span></span></code></pre></div><p>テストを作成する前に、<strong>下記項目を一通り参照してください</strong>:</p><ul><li><code>test/</code>内にすでに作成されているテスト</li><li><a href="https://bats-core.readthedocs.io/en/stable/index.html" target="_blank" rel="noreferrer">bats-coreのドキュメント</a></li><li><code>scripts/test.bash</code>で使用されている既存のBatsの設定</li></ul><h3 id="batsのヒント" tabindex="-1">Batsのヒント <a class="header-anchor" href="#batsのヒント" aria-label="Permalink to &quot;Batsのヒント&quot;">​</a></h3><p>Batsでのデバッグは、難しいことがあります。<code>-t</code>フラグを指定してTAP出力を有効にすると、テスト実行中に特殊なファイルディスクリプタ<code>&gt;&amp;3</code>を使用して出力を表示できるため、デバッグが簡単になります。例えば次のとおりです:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># test/some_tests.bats</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">printf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;%s\\n&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Will not be printed during bats test/some_tests.bats&quot;</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">printf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;%s\\n&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Will be printed during bats -t test/some_tests.bats&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &gt;&amp;3</span></span></code></pre></div><p>詳しくは、bats-coreドキュメント内の<a href="https://bats-core.readthedocs.io/en/stable/writing-tests.html#printing-to-the-terminal" target="_blank" rel="noreferrer">Printing to the Terminal</a>で説明されています。</p><h2 id="プルリクエスト、リリース、conventional-commits" tabindex="-1">プルリクエスト、リリース、Conventional Commits <a class="header-anchor" href="#プルリクエスト、リリース、conventional-commits" aria-label="Permalink to &quot;プルリクエスト、リリース、Conventional Commits&quot;">​</a></h2><p><code>asdf</code>は、<a href="https://github.com/googleapis/release-please" target="_blank" rel="noreferrer">Release Please</a>という自動リリースツールを使用して、<a href="https://semver.org/" target="_blank" rel="noreferrer">セマンティックバージョン</a>を自動的に引き上げ、<a href="https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md" target="_blank" rel="noreferrer">Changelog</a>を生成しています。この情報は、前回のリリースからのコミット履歴を読み込むことで生成されます。</p><p><a href="https://www.conventionalcommits.org/ja/" target="_blank" rel="noreferrer">Conventional Commit messages</a>では、デフォルトブランチでのコミットメッセージのフォーマットとなる、プルリクエストタイトルのフォーマットを定義しています。これは、GitHub Action<a href="https://github.com/amannn/action-semantic-pull-request" target="_blank" rel="noreferrer"><code>amannn/action-semantic-pull-request</code></a>で強制されます。</p><p>Conventional Commitは、下記のフォーマットに従います:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>&lt;type&gt;[optional scope][optional !]: &lt;description&gt;</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>&lt;!-- examples --&gt;</span></span>
+<span class="line"><span>fix: some fix</span></span>
+<span class="line"><span>feat: a new feature</span></span>
+<span class="line"><span>docs: some documentation update</span></span>
+<span class="line"><span>docs(website): some change for the website</span></span>
+<span class="line"><span>feat!: feature with breaking change</span></span></code></pre></div><p><code>&lt;types&gt;</code>の種類は次のとおりです: <code>feat</code>、<code>fix</code>、<code>docs</code>、<code>style</code>、 <code>refactor</code>、 <code>perf</code>、<code>test</code>、<code>build</code>、<code>ci</code>、<code>chore</code>、 <code>revert</code>。</p><ul><li><code>!</code>: 破壊的変更を示します</li><li><code>fix</code>: セマンティックバージョンの<code>patch</code>を新しく作成します</li><li><code>feat</code>: セマンティックバージョンの<code>minor</code>を新しく作成します</li><li><code>&lt;type&gt;!</code>: セマンティックバージョンの<code>major</code>を新しく作成します</li></ul><p>プルリクエストのタイトルは、このフォーマットに従う必要があります。</p><div class="tip custom-block"><p class="custom-block-title">ヒント</p><p>プルリクエストのタイトルには、Conventional Commit messageのフォーマットを使用してください。</p></div><h2 id="dockerイメージ" tabindex="-1">Dockerイメージ <a class="header-anchor" href="#dockerイメージ" aria-label="Permalink to &quot;Dockerイメージ&quot;">​</a></h2><p><a href="https://github.com/vic/asdf-alpine" target="_blank" rel="noreferrer">asdf-alpine</a>および<a href="https://github.com/vic/asdf-ubuntu" target="_blank" rel="noreferrer">asdf-ubuntu</a>プロジェクトは、一部のasdfツールのDocker化されたイメージを提供する取り組みを継続的に行っています。これらのDockerイメージは、開発用サーバのベースとしたり、本番用アプリケーションの実行用途として使用することができます。</p>`,47)]))}const g=a(n,[["render",l]]);export{k as __pageData,g as default};

assets/ja-jp_contribute_core.md.CJW3eeff.lean.js

@@ -0,0 +1,31 @@
+import{_ as a,c as e,a2 as i,o as t}from"./chunks/framework.BQmytedh.js";const k=JSON.parse('{"title":"asdf","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/contribute/core.md","filePath":"ja-jp/contribute/core.md","lastUpdated":1704890757000}'),n={name:"ja-jp/contribute/core.md"};function l(p,s,h,o,r,d){return t(),e("div",null,s[0]||(s[0]=[i(`<h1 id="asdf" tabindex="-1">asdf <a class="header-anchor" href="#asdf" aria-label="Permalink to &quot;asdf&quot;">​</a></h1><p>これは、<code>asdf</code>コアのコントリビューションガイドです。</p><h2 id="初期セットアップ" tabindex="-1">初期セットアップ <a class="header-anchor" href="#初期セットアップ" aria-label="Permalink to &quot;初期セットアップ&quot;">​</a></h2><p>GitHubで<code>asdf</code>をフォークするか、デフォルトのブランチをGitクローンしてください:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># clone your fork</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">GITHUB_USE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">R</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/asdf.git</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># or clone asdf</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/asdf-vm/asdf.git</span></span></code></pre></div><p>コア開発用のツールは、このリポジトリの<code>.tool-versions</code>で定義されています。<code>asdf</code>自身でこれらのツールを管理したい場合は、下記のようにプラグインを追加してください:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bats</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/timgluz/asdf-bats.git</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shellcheck</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/luizm/asdf-shellcheck.git</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shfmt</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/luizm/asdf-shfmt.git</span></span></code></pre></div><p><code>asdf</code>の開発に必要なバージョンを、下記のようにインストールします:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span></span></code></pre></div><p>開発ツールに影響を与える特定の機能を壊す可能性もあるため、ローカルマシンで開発する際は、<code>asdf</code>を使用しないほうが <em>良いかもしれません</em> 。下記に、使用しているツールを列挙します:</p><ul><li><a href="https://github.com/bats-core/bats-core" target="_blank" rel="noreferrer">bats-core</a>: BashまたはPOSIX準拠のスクリプトを単体テストするための、Bash自動テストシステムです。</li><li><a href="https://github.com/koalaman/shellcheck" target="_blank" rel="noreferrer">shellcheck</a>: シェルスクリプトの静的解析ツールです。</li><li><a href="https://github.com/mvdan/sh" target="_blank" rel="noreferrer">shfmt</a>: Bashをサポートするシェルパーサ、フォーマッタ、インタプリタです。</li></ul><h2 id="開発" tabindex="-1">開発 <a class="header-anchor" href="#開発" aria-label="Permalink to &quot;開発&quot;">​</a></h2><p>インストール済みの<code>asdf</code>に変更を加えずに、あなたが開発した変更内容を試したいときは、<code>$ASDF_DIR</code>変数に、クローンしたリポジトリのパスを設定し、そのディレクトリの<code>bin</code>と<code>shims</code>ディレクトリを一時的にパスの先頭へ追加します。</p><p>リモートにコミットまたはプッシュする前に、コードをローカルでフォーマット、Lint、およびテストすることを推奨します。その際は、次のスクリプト/コマンドを使用してください:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Lint</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/lint.bash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --check</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Fix &amp; Format</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/lint.bash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --fix</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Test: all tests</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/test.bash</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Test: for specific command</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bats</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test/list_commands.bash</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">ヒント</p><p><strong>テストを作ってください!</strong> - 新機能にとってテストは<strong>必要不可欠</strong>であり、バグ修正のレビューをスピードアップさせることができます。プルリクエストを作成する前に、新しいコードをカバーするようなテストを作成してください。<a href="https://bats-core.readthedocs.io/en/stable/index.html" target="_blank" rel="noreferrer">bats-coreのドキュメント</a>もご覧ください。</p></div><h3 id="gitignore" tabindex="-1">Gitignore <a class="header-anchor" href="#gitignore" aria-label="Permalink to &quot;Gitignore&quot;">​</a></h3><p>下記は、<code>asdf-vm/asdf</code>リポジトリの<code>.gitignore</code>ファイルです。プロジェクト固有のファイルは無視をしています。使用しているOS、ツール、およびワークフロー固有のファイルは、グローバルな<code>.gitignore</code>構成で無視する必要があります。詳しくは<a href="http://stratus3d.com/blog/2018/06/03/stop-excluding-editor-temp-files-in-gitignore/" target="_blank" rel="noreferrer">こちら</a>をご覧ください。</p><p>@<a href="https://github.com/asdf-vm/asdf/blob/master/.gitignore" target="_blank" rel="noreferrer">Gitignoreコード</a></p><h3 id="git-blame-ignore-revs" tabindex="-1"><code>.git-blame-ignore-revs</code> <a class="header-anchor" href="#git-blame-ignore-revs" aria-label="Permalink to &quot;\`.git-blame-ignore-revs\`&quot;">​</a></h3><p><code>asdf</code>では、<code>.git-blame-ignore-revs</code>を使用して、Blameを実行する際のノイズを減らしています。詳しくは、<a href="https://git-scm.com/docs/git-blame" target="_blank" rel="noreferrer">git blameのドキュメント</a>をご覧ください。</p><p><code>git blame</code>を実行するときは、下記のように、このファイルと共に使います:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blame</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --ignore-revs-file</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .git-blame-ignore-revs</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ./test/install_command.bats</span></span></code></pre></div><p>毎回手動でファイルを指定しなくても、gitのオプションで、<code>blame</code>を呼び出すたびにこのファイルを使うように設定することもできます:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> config</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blame.ignoreRevsFile</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .git-blame-ignore-revs</span></span></code></pre></div><p>このファイルを使用するように、IDEを設定することもできます。例えば、VSCode(および<a href="https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens" target="_blank" rel="noreferrer">GitLens</a>)を使う場合は、<code>.vscode/settings.json</code>に下記のように記述します:</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  &quot;gitlens.advanced.blame.customArguments&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span></span>
+<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    &quot;--ignore-revs-file&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    &quot;.git-blame-ignore-revs&quot;</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  ]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h2 id="batsテスト" tabindex="-1">Batsテスト <a class="header-anchor" href="#batsテスト" aria-label="Permalink to &quot;Batsテスト&quot;">​</a></h2><p>ローカルでテストを実行するには、下記のようにテストを呼び出します:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/test.bash</span></span></code></pre></div><p>テストを作成する前に、<strong>下記項目を一通り参照してください</strong>:</p><ul><li><code>test/</code>内にすでに作成されているテスト</li><li><a href="https://bats-core.readthedocs.io/en/stable/index.html" target="_blank" rel="noreferrer">bats-coreのドキュメント</a></li><li><code>scripts/test.bash</code>で使用されている既存のBatsの設定</li></ul><h3 id="batsのヒント" tabindex="-1">Batsのヒント <a class="header-anchor" href="#batsのヒント" aria-label="Permalink to &quot;Batsのヒント&quot;">​</a></h3><p>Batsでのデバッグは、難しいことがあります。<code>-t</code>フラグを指定してTAP出力を有効にすると、テスト実行中に特殊なファイルディスクリプタ<code>&gt;&amp;3</code>を使用して出力を表示できるため、デバッグが簡単になります。例えば次のとおりです:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># test/some_tests.bats</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">printf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;%s\\n&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Will not be printed during bats test/some_tests.bats&quot;</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">printf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;%s\\n&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Will be printed during bats -t test/some_tests.bats&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &gt;&amp;3</span></span></code></pre></div><p>詳しくは、bats-coreドキュメント内の<a href="https://bats-core.readthedocs.io/en/stable/writing-tests.html#printing-to-the-terminal" target="_blank" rel="noreferrer">Printing to the Terminal</a>で説明されています。</p><h2 id="プルリクエスト、リリース、conventional-commits" tabindex="-1">プルリクエスト、リリース、Conventional Commits <a class="header-anchor" href="#プルリクエスト、リリース、conventional-commits" aria-label="Permalink to &quot;プルリクエスト、リリース、Conventional Commits&quot;">​</a></h2><p><code>asdf</code>は、<a href="https://github.com/googleapis/release-please" target="_blank" rel="noreferrer">Release Please</a>という自動リリースツールを使用して、<a href="https://semver.org/" target="_blank" rel="noreferrer">セマンティックバージョン</a>を自動的に引き上げ、<a href="https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md" target="_blank" rel="noreferrer">Changelog</a>を生成しています。この情報は、前回のリリースからのコミット履歴を読み込むことで生成されます。</p><p><a href="https://www.conventionalcommits.org/ja/" target="_blank" rel="noreferrer">Conventional Commit messages</a>では、デフォルトブランチでのコミットメッセージのフォーマットとなる、プルリクエストタイトルのフォーマットを定義しています。これは、GitHub Action<a href="https://github.com/amannn/action-semantic-pull-request" target="_blank" rel="noreferrer"><code>amannn/action-semantic-pull-request</code></a>で強制されます。</p><p>Conventional Commitは、下記のフォーマットに従います:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>&lt;type&gt;[optional scope][optional !]: &lt;description&gt;</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>&lt;!-- examples --&gt;</span></span>
+<span class="line"><span>fix: some fix</span></span>
+<span class="line"><span>feat: a new feature</span></span>
+<span class="line"><span>docs: some documentation update</span></span>
+<span class="line"><span>docs(website): some change for the website</span></span>
+<span class="line"><span>feat!: feature with breaking change</span></span></code></pre></div><p><code>&lt;types&gt;</code>の種類は次のとおりです: <code>feat</code>、<code>fix</code>、<code>docs</code>、<code>style</code>、 <code>refactor</code>、 <code>perf</code>、<code>test</code>、<code>build</code>、<code>ci</code>、<code>chore</code>、 <code>revert</code>。</p><ul><li><code>!</code>: 破壊的変更を示します</li><li><code>fix</code>: セマンティックバージョンの<code>patch</code>を新しく作成します</li><li><code>feat</code>: セマンティックバージョンの<code>minor</code>を新しく作成します</li><li><code>&lt;type&gt;!</code>: セマンティックバージョンの<code>major</code>を新しく作成します</li></ul><p>プルリクエストのタイトルは、このフォーマットに従う必要があります。</p><div class="tip custom-block"><p class="custom-block-title">ヒント</p><p>プルリクエストのタイトルには、Conventional Commit messageのフォーマットを使用してください。</p></div><h2 id="dockerイメージ" tabindex="-1">Dockerイメージ <a class="header-anchor" href="#dockerイメージ" aria-label="Permalink to &quot;Dockerイメージ&quot;">​</a></h2><p><a href="https://github.com/vic/asdf-alpine" target="_blank" rel="noreferrer">asdf-alpine</a>および<a href="https://github.com/vic/asdf-ubuntu" target="_blank" rel="noreferrer">asdf-ubuntu</a>プロジェクトは、一部のasdfツールのDocker化されたイメージを提供する取り組みを継続的に行っています。これらのDockerイメージは、開発用サーバのベースとしたり、本番用アプリケーションの実行用途として使用することができます。</p>`,47)]))}const g=a(n,[["render",l]]);export{k as __pageData,g as default};

assets/ja-jp_contribute_first-party-plugins.md.CLMHeW36.js

@@ -0,0 +1 @@
+import{_ as a,c as r,a2 as t,o as i}from"./chunks/framework.BQmytedh.js";const u=JSON.parse('{"title":"公式プラグイン","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/contribute/first-party-plugins.md","filePath":"ja-jp/contribute/first-party-plugins.md","lastUpdated":1704890757000}'),s={name:"ja-jp/contribute/first-party-plugins.md"};function l(o,e,d,n,f,c){return i(),r("div",null,e[0]||(e[0]=[t('<h1 id="公式プラグイン" tabindex="-1">公式プラグイン <a class="header-anchor" href="#公式プラグイン" aria-label="Permalink to &quot;公式プラグイン&quot;">​</a></h1><p>asdfコアチームでは、日々のワークライフに関連するプラグインをいくつか作成しています。これらのプラグインのメンテナンスおよび改善にご協力いただける方を、いつでも歓迎しています。詳しくは、下記リンクから、それぞれのリポジトリを参照してください:</p><ul><li><a href="https://github.com/asdf-vm/asdf-elixir" target="_blank" rel="noreferrer">Elixir</a></li><li><a href="https://github.com/asdf-vm/asdf-erlang" target="_blank" rel="noreferrer">Erlang</a></li><li><a href="https://github.com/asdf-vm/asdf-nodejs" target="_blank" rel="noreferrer">Node.js</a></li><li><a href="https://github.com/asdf-vm/asdf-ruby" target="_blank" rel="noreferrer">Ruby</a></li></ul><p>コミュニティプラグインについては、下記をご覧ください:</p><ul><li><a href="https://github.com/asdf-community" target="_blank" rel="noreferrer"><code>asdf-community</code>オーガナイゼーション</a>: <code>asdf</code>プラグインの長期的なメンテナンスを目的としたコミュニティ主導の共同プロジェクトです。</li><li><a href="https://github.com/asdf-vm/asdf-plugins" target="_blank" rel="noreferrer"><code>asdf-plugins</code>ショートネームリポジトリ</a>: ポピュラーな<code>asdf</code>プラグインを検索するために<code>asdf</code>コアが使用する、ショートネームのリストです。</li><li><a href="https://github.com/topics/asdf-plugin" target="_blank" rel="noreferrer">GitHub <code>asdf-plugin</code>トピック検索</a></li></ul>',5)]))}const h=a(s,[["render",l]]);export{u as __pageData,h as default};

assets/ja-jp_contribute_first-party-plugins.md.CLMHeW36.lean.js

@@ -0,0 +1 @@
+import{_ as a,c as r,a2 as t,o as i}from"./chunks/framework.BQmytedh.js";const u=JSON.parse('{"title":"公式プラグイン","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/contribute/first-party-plugins.md","filePath":"ja-jp/contribute/first-party-plugins.md","lastUpdated":1704890757000}'),s={name:"ja-jp/contribute/first-party-plugins.md"};function l(o,e,d,n,f,c){return i(),r("div",null,e[0]||(e[0]=[t('<h1 id="公式プラグイン" tabindex="-1">公式プラグイン <a class="header-anchor" href="#公式プラグイン" aria-label="Permalink to &quot;公式プラグイン&quot;">​</a></h1><p>asdfコアチームでは、日々のワークライフに関連するプラグインをいくつか作成しています。これらのプラグインのメンテナンスおよび改善にご協力いただける方を、いつでも歓迎しています。詳しくは、下記リンクから、それぞれのリポジトリを参照してください:</p><ul><li><a href="https://github.com/asdf-vm/asdf-elixir" target="_blank" rel="noreferrer">Elixir</a></li><li><a href="https://github.com/asdf-vm/asdf-erlang" target="_blank" rel="noreferrer">Erlang</a></li><li><a href="https://github.com/asdf-vm/asdf-nodejs" target="_blank" rel="noreferrer">Node.js</a></li><li><a href="https://github.com/asdf-vm/asdf-ruby" target="_blank" rel="noreferrer">Ruby</a></li></ul><p>コミュニティプラグインについては、下記をご覧ください:</p><ul><li><a href="https://github.com/asdf-community" target="_blank" rel="noreferrer"><code>asdf-community</code>オーガナイゼーション</a>: <code>asdf</code>プラグインの長期的なメンテナンスを目的としたコミュニティ主導の共同プロジェクトです。</li><li><a href="https://github.com/asdf-vm/asdf-plugins" target="_blank" rel="noreferrer"><code>asdf-plugins</code>ショートネームリポジトリ</a>: ポピュラーな<code>asdf</code>プラグインを検索するために<code>asdf</code>コアが使用する、ショートネームのリストです。</li><li><a href="https://github.com/topics/asdf-plugin" target="_blank" rel="noreferrer">GitHub <code>asdf-plugin</code>トピック検索</a></li></ul>',5)]))}const h=a(s,[["render",l]]);export{u as __pageData,h as default};

assets/ja-jp_contribute_github-actions.md.CXg4FquL.js

@@ -0,0 +1 @@
+import{_ as i,c as o,j as t,a,o as n}from"./chunks/framework.BQmytedh.js";const h=JSON.parse('{"title":"GitHub Actions","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/contribute/github-actions.md","filePath":"ja-jp/contribute/github-actions.md","lastUpdated":1704890757000}'),s={name:"ja-jp/contribute/github-actions.md"};function r(c,e,d,u,l,p){return n(),o("div",null,e[0]||(e[0]=[t("h1",{id:"github-actions",tabindex:"-1"},[a("GitHub Actions "),t("a",{class:"header-anchor",href:"#github-actions","aria-label":'Permalink to "GitHub Actions"'},"​")],-1),t("p",null,[a("ご興味を持っていただきありがとうございます。既存のイシュー、議論、コントリビューションガイドについては、"),t("a",{href:"https://github.com/asdf-vm/actions",target:"_blank",rel:"noreferrer"},"asdf actions リポジトリ"),a("をご覧ください。")],-1)]))}const f=i(s,[["render",r]]);export{h as __pageData,f as default};

assets/ja-jp_contribute_github-actions.md.CXg4FquL.lean.js

@@ -0,0 +1 @@
+import{_ as i,c as o,j as t,a,o as n}from"./chunks/framework.BQmytedh.js";const h=JSON.parse('{"title":"GitHub Actions","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/contribute/github-actions.md","filePath":"ja-jp/contribute/github-actions.md","lastUpdated":1704890757000}'),s={name:"ja-jp/contribute/github-actions.md"};function r(c,e,d,u,l,p){return n(),o("div",null,e[0]||(e[0]=[t("h1",{id:"github-actions",tabindex:"-1"},[a("GitHub Actions "),t("a",{class:"header-anchor",href:"#github-actions","aria-label":'Permalink to "GitHub Actions"'},"​")],-1),t("p",null,[a("ご興味を持っていただきありがとうございます。既存のイシュー、議論、コントリビューションガイドについては、"),t("a",{href:"https://github.com/asdf-vm/actions",target:"_blank",rel:"noreferrer"},"asdf actions リポジトリ"),a("をご覧ください。")],-1)]))}const f=i(s,[["render",r]]);export{h as __pageData,f as default};

assets/ja-jp_index.md.Te-fFvI2.js

@@ -0,0 +1 @@
+import{_ as t,c as e,o as i}from"./chunks/framework.BQmytedh.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{"layout":"home","hero":{"name":"asdf","text":"マルチランタイム<br/>バージョンマネージャ","tagline":"1つのツールですべてのランタイムのバージョンを管理しましょう!","actions":[{"theme":"brand","text":"はじめよう","link":"/ja-jp/guide/getting-started"},{"theme":"alt","text":"asdfってなに?","link":"/ja-jp/guide/introduction"},{"theme":"alt","text":"GitHubをみる","link":"https://github.com/asdf-vm/asdf"}]},"features":[{"title":"単一ツール","details":"単体のCLIツールとコマンドインターフェースで、各プロジェクトのランタイムを管理できます。","icon":"🎉"},{"title":"プラグイン","details":"既存ランタイム・ツールを使用した大規模なエコシステムです。必要に応じて新しいツールをサポートできるシンプルなAPIを用意しています!","icon":"🔌"},{"title":"後方互換性","details":".nvmrc、.node-version、.ruby-versionといった既存構成ファイルから、スムーズに移行できます!","icon":"⏮"},{"title":"単一の構成ファイル","details":".tool-versionsを使用すると、すべてのツール、ランタイム、およびそれらのバージョンを、共有された単一の場所で管理できます。","icon":"📄"},{"title":"シェル","details":"Bash、ZSH、Fish、およびElvishをサポートし、コマンド補完にも対応しています。","icon":"🐚"},{"title":"GitHub Actions","details":"CI/CDワークフローで、.tool-versionsをインストールし利用するためのGitHub Actionを提供しています。","icon":"🤖"}]},"headers":[],"relativePath":"ja-jp/index.md","filePath":"ja-jp/index.md","lastUpdated":1704890757000}'),a={name:"ja-jp/index.md"};function n(o,s,d,l,r,c){return i(),e("div")}const h=t(a,[["render",n]]);export{m as __pageData,h as default};

assets/ja-jp_index.md.Te-fFvI2.lean.js

@@ -0,0 +1 @@
+import{_ as t,c as e,o as i}from"./chunks/framework.BQmytedh.js";const m=JSON.parse('{"title":"","description":"","frontmatter":{"layout":"home","hero":{"name":"asdf","text":"マルチランタイム<br/>バージョンマネージャ","tagline":"1つのツールですべてのランタイムのバージョンを管理しましょう!","actions":[{"theme":"brand","text":"はじめよう","link":"/ja-jp/guide/getting-started"},{"theme":"alt","text":"asdfってなに?","link":"/ja-jp/guide/introduction"},{"theme":"alt","text":"GitHubをみる","link":"https://github.com/asdf-vm/asdf"}]},"features":[{"title":"単一ツール","details":"単体のCLIツールとコマンドインターフェースで、各プロジェクトのランタイムを管理できます。","icon":"🎉"},{"title":"プラグイン","details":"既存ランタイム・ツールを使用した大規模なエコシステムです。必要に応じて新しいツールをサポートできるシンプルなAPIを用意しています!","icon":"🔌"},{"title":"後方互換性","details":".nvmrc、.node-version、.ruby-versionといった既存構成ファイルから、スムーズに移行できます!","icon":"⏮"},{"title":"単一の構成ファイル","details":".tool-versionsを使用すると、すべてのツール、ランタイム、およびそれらのバージョンを、共有された単一の場所で管理できます。","icon":"📄"},{"title":"シェル","details":"Bash、ZSH、Fish、およびElvishをサポートし、コマンド補完にも対応しています。","icon":"🐚"},{"title":"GitHub Actions","details":"CI/CDワークフローで、.tool-versionsをインストールし利用するためのGitHub Actionを提供しています。","icon":"🤖"}]},"headers":[],"relativePath":"ja-jp/index.md","filePath":"ja-jp/index.md","lastUpdated":1704890757000}'),a={name:"ja-jp/index.md"};function n(o,s,d,l,r,c){return i(),e("div")}const h=t(a,[["render",n]]);export{m as __pageData,h as default};

assets/ja-jp_manage_commands.md.CM3wA-L-.js

@@ -0,0 +1,66 @@
+import{_ as a,c as n,a2 as p,o as e}from"./chunks/framework.BQmytedh.js";const f=JSON.parse('{"title":"すべてのコマンド","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/manage/commands.md","filePath":"ja-jp/manage/commands.md","lastUpdated":1704890757000}'),l={name:"ja-jp/manage/commands.md"};function t(i,s,o,c,r,d){return e(),n("div",null,s[0]||(s[0]=[p(`<h1 id="すべてのコマンド" tabindex="-1">すべてのコマンド <a class="header-anchor" href="#すべてのコマンド" aria-label="Permalink to &quot;すべてのコマンド&quot;">​</a></h1><p><code>asdf</code>で利用可能なすべてのコマンドの一覧です。この一覧は、<code>asdf help</code>コマンドで表示されるテキストです。</p><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>MANAGE PLUGINS</span></span>
+<span class="line"><span>asdf plugin add &lt;name&gt; [&lt;git-url&gt;]      Add a plugin from the plugin repo OR,</span></span>
+<span class="line"><span>                                        add a Git repo as a plugin by</span></span>
+<span class="line"><span>                                        specifying the name and repo url</span></span>
+<span class="line"><span>asdf plugin list [--urls] [--refs]      List installed plugins. Optionally show</span></span>
+<span class="line"><span>                                        git urls and git-ref</span></span>
+<span class="line"><span>asdf plugin list all                    List plugins registered on asdf-plugins</span></span>
+<span class="line"><span>                                        repository with URLs</span></span>
+<span class="line"><span>asdf plugin remove &lt;name&gt;               Remove plugin and package versions</span></span>
+<span class="line"><span>asdf plugin update &lt;name&gt; [&lt;git-ref&gt;]   Update a plugin to latest commit on</span></span>
+<span class="line"><span>                                        default branch or a particular git-ref</span></span>
+<span class="line"><span>asdf plugin update --all                Update all plugins to latest commit on</span></span>
+<span class="line"><span>                                        default branch</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>MANAGE PACKAGES</span></span>
+<span class="line"><span>asdf current                            Display current version set or being</span></span>
+<span class="line"><span>                                        used for all packages</span></span>
+<span class="line"><span>asdf current &lt;name&gt;                     Display current version set or being</span></span>
+<span class="line"><span>                                        used for package</span></span>
+<span class="line"><span>asdf global &lt;name&gt; &lt;version&gt;            Set the package global version</span></span>
+<span class="line"><span>asdf global &lt;name&gt; latest[:&lt;version&gt;]   Set the package global version to the</span></span>
+<span class="line"><span>                                        latest provided version</span></span>
+<span class="line"><span>asdf help &lt;name&gt; [&lt;version&gt;]            Output documentation for plugin and tool</span></span>
+<span class="line"><span>asdf install                            Install all the package versions listed</span></span>
+<span class="line"><span>                                        in the .tool-versions file</span></span>
+<span class="line"><span>asdf install &lt;name&gt;                     Install one tool at the version</span></span>
+<span class="line"><span>                                        specified in the .tool-versions file</span></span>
+<span class="line"><span>asdf install &lt;name&gt; &lt;version&gt;           Install a specific version of a package</span></span>
+<span class="line"><span>asdf install &lt;name&gt; latest[:&lt;version&gt;]  Install the latest stable version of a</span></span>
+<span class="line"><span>                                        package, or with optional version,</span></span>
+<span class="line"><span>                                        install the latest stable version that</span></span>
+<span class="line"><span>                                        begins with the given string</span></span>
+<span class="line"><span>asdf latest &lt;name&gt; [&lt;version&gt;]          Show latest stable version of a package</span></span>
+<span class="line"><span>asdf latest --all                       Show latest stable version of all the</span></span>
+<span class="line"><span>                                        packages and if they are installed</span></span>
+<span class="line"><span>asdf list &lt;name&gt; [version]              List installed versions of a package and</span></span>
+<span class="line"><span>                                        optionally filter the versions</span></span>
+<span class="line"><span>asdf list all &lt;name&gt; [&lt;version&gt;]        List all versions of a package and</span></span>
+<span class="line"><span>                                        optionally filter the returned versions</span></span>
+<span class="line"><span>asdf local &lt;name&gt; &lt;version&gt;             Set the package local version</span></span>
+<span class="line"><span>asdf local &lt;name&gt; latest[:&lt;version&gt;]    Set the package local version to the</span></span>
+<span class="line"><span>                                        latest provided version</span></span>
+<span class="line"><span>asdf shell &lt;name&gt; &lt;version&gt;             Set the package version to</span></span>
+<span class="line"><span>                                        \`ASDF_\${LANG}_VERSION\` in the current shell</span></span>
+<span class="line"><span>asdf uninstall &lt;name&gt; &lt;version&gt;         Remove a specific version of a package</span></span>
+<span class="line"><span>asdf where &lt;name&gt; [&lt;version&gt;]           Display install path for an installed</span></span>
+<span class="line"><span>                                        or current version</span></span>
+<span class="line"><span>asdf which &lt;command&gt;                    Display the path to an executable</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>UTILS</span></span>
+<span class="line"><span>asdf exec &lt;command&gt; [args...]           Executes the command shim for current version</span></span>
+<span class="line"><span>asdf env &lt;command&gt; [util]               Runs util (default: \`env\`) inside the</span></span>
+<span class="line"><span>                                        environment used for command shim execution.</span></span>
+<span class="line"><span>asdf info                               Print OS, Shell and ASDF debug information.</span></span>
+<span class="line"><span>asdf version                            Print the currently installed version of ASDF</span></span>
+<span class="line"><span>asdf reshim &lt;name&gt; &lt;version&gt;            Recreate shims for version of a package</span></span>
+<span class="line"><span>asdf shim-versions &lt;command&gt;            List the plugins and versions that</span></span>
+<span class="line"><span>                                        provide a command</span></span>
+<span class="line"><span>asdf update                             Update asdf to the latest stable release</span></span>
+<span class="line"><span>asdf update --head                      Update asdf to the latest on the master branch</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>RESOURCES</span></span>
+<span class="line"><span>GitHub: https://github.com/asdf-vm/asdf</span></span>
+<span class="line"><span>Docs:   https://asdf-vm.com</span></span></code></pre></div>`,3)]))}const m=a(l,[["render",t]]);export{f as __pageData,m as default};

assets/ja-jp_manage_commands.md.CM3wA-L-.lean.js

@@ -0,0 +1,66 @@
+import{_ as a,c as n,a2 as p,o as e}from"./chunks/framework.BQmytedh.js";const f=JSON.parse('{"title":"すべてのコマンド","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/manage/commands.md","filePath":"ja-jp/manage/commands.md","lastUpdated":1704890757000}'),l={name:"ja-jp/manage/commands.md"};function t(i,s,o,c,r,d){return e(),n("div",null,s[0]||(s[0]=[p(`<h1 id="すべてのコマンド" tabindex="-1">すべてのコマンド <a class="header-anchor" href="#すべてのコマンド" aria-label="Permalink to &quot;すべてのコマンド&quot;">​</a></h1><p><code>asdf</code>で利用可能なすべてのコマンドの一覧です。この一覧は、<code>asdf help</code>コマンドで表示されるテキストです。</p><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>MANAGE PLUGINS</span></span>
+<span class="line"><span>asdf plugin add &lt;name&gt; [&lt;git-url&gt;]      Add a plugin from the plugin repo OR,</span></span>
+<span class="line"><span>                                        add a Git repo as a plugin by</span></span>
+<span class="line"><span>                                        specifying the name and repo url</span></span>
+<span class="line"><span>asdf plugin list [--urls] [--refs]      List installed plugins. Optionally show</span></span>
+<span class="line"><span>                                        git urls and git-ref</span></span>
+<span class="line"><span>asdf plugin list all                    List plugins registered on asdf-plugins</span></span>
+<span class="line"><span>                                        repository with URLs</span></span>
+<span class="line"><span>asdf plugin remove &lt;name&gt;               Remove plugin and package versions</span></span>
+<span class="line"><span>asdf plugin update &lt;name&gt; [&lt;git-ref&gt;]   Update a plugin to latest commit on</span></span>
+<span class="line"><span>                                        default branch or a particular git-ref</span></span>
+<span class="line"><span>asdf plugin update --all                Update all plugins to latest commit on</span></span>
+<span class="line"><span>                                        default branch</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>MANAGE PACKAGES</span></span>
+<span class="line"><span>asdf current                            Display current version set or being</span></span>
+<span class="line"><span>                                        used for all packages</span></span>
+<span class="line"><span>asdf current &lt;name&gt;                     Display current version set or being</span></span>
+<span class="line"><span>                                        used for package</span></span>
+<span class="line"><span>asdf global &lt;name&gt; &lt;version&gt;            Set the package global version</span></span>
+<span class="line"><span>asdf global &lt;name&gt; latest[:&lt;version&gt;]   Set the package global version to the</span></span>
+<span class="line"><span>                                        latest provided version</span></span>
+<span class="line"><span>asdf help &lt;name&gt; [&lt;version&gt;]            Output documentation for plugin and tool</span></span>
+<span class="line"><span>asdf install                            Install all the package versions listed</span></span>
+<span class="line"><span>                                        in the .tool-versions file</span></span>
+<span class="line"><span>asdf install &lt;name&gt;                     Install one tool at the version</span></span>
+<span class="line"><span>                                        specified in the .tool-versions file</span></span>
+<span class="line"><span>asdf install &lt;name&gt; &lt;version&gt;           Install a specific version of a package</span></span>
+<span class="line"><span>asdf install &lt;name&gt; latest[:&lt;version&gt;]  Install the latest stable version of a</span></span>
+<span class="line"><span>                                        package, or with optional version,</span></span>
+<span class="line"><span>                                        install the latest stable version that</span></span>
+<span class="line"><span>                                        begins with the given string</span></span>
+<span class="line"><span>asdf latest &lt;name&gt; [&lt;version&gt;]          Show latest stable version of a package</span></span>
+<span class="line"><span>asdf latest --all                       Show latest stable version of all the</span></span>
+<span class="line"><span>                                        packages and if they are installed</span></span>
+<span class="line"><span>asdf list &lt;name&gt; [version]              List installed versions of a package and</span></span>
+<span class="line"><span>                                        optionally filter the versions</span></span>
+<span class="line"><span>asdf list all &lt;name&gt; [&lt;version&gt;]        List all versions of a package and</span></span>
+<span class="line"><span>                                        optionally filter the returned versions</span></span>
+<span class="line"><span>asdf local &lt;name&gt; &lt;version&gt;             Set the package local version</span></span>
+<span class="line"><span>asdf local &lt;name&gt; latest[:&lt;version&gt;]    Set the package local version to the</span></span>
+<span class="line"><span>                                        latest provided version</span></span>
+<span class="line"><span>asdf shell &lt;name&gt; &lt;version&gt;             Set the package version to</span></span>
+<span class="line"><span>                                        \`ASDF_\${LANG}_VERSION\` in the current shell</span></span>
+<span class="line"><span>asdf uninstall &lt;name&gt; &lt;version&gt;         Remove a specific version of a package</span></span>
+<span class="line"><span>asdf where &lt;name&gt; [&lt;version&gt;]           Display install path for an installed</span></span>
+<span class="line"><span>                                        or current version</span></span>
+<span class="line"><span>asdf which &lt;command&gt;                    Display the path to an executable</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>UTILS</span></span>
+<span class="line"><span>asdf exec &lt;command&gt; [args...]           Executes the command shim for current version</span></span>
+<span class="line"><span>asdf env &lt;command&gt; [util]               Runs util (default: \`env\`) inside the</span></span>
+<span class="line"><span>                                        environment used for command shim execution.</span></span>
+<span class="line"><span>asdf info                               Print OS, Shell and ASDF debug information.</span></span>
+<span class="line"><span>asdf version                            Print the currently installed version of ASDF</span></span>
+<span class="line"><span>asdf reshim &lt;name&gt; &lt;version&gt;            Recreate shims for version of a package</span></span>
+<span class="line"><span>asdf shim-versions &lt;command&gt;            List the plugins and versions that</span></span>
+<span class="line"><span>                                        provide a command</span></span>
+<span class="line"><span>asdf update                             Update asdf to the latest stable release</span></span>
+<span class="line"><span>asdf update --head                      Update asdf to the latest on the master branch</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>RESOURCES</span></span>
+<span class="line"><span>GitHub: https://github.com/asdf-vm/asdf</span></span>
+<span class="line"><span>Docs:   https://asdf-vm.com</span></span></code></pre></div>`,3)]))}const m=a(l,[["render",t]]);export{f as __pageData,m as default};

assets/ja-jp_manage_plugins.md.Dveizso5.js

@@ -0,0 +1,11 @@
+import{_ as a,c as i,a2 as l,o as e}from"./chunks/framework.BQmytedh.js";const g=JSON.parse('{"title":"プラグイン","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/manage/plugins.md","filePath":"ja-jp/manage/plugins.md","lastUpdated":1704890757000}'),t={name:"ja-jp/manage/plugins.md"};function n(h,s,p,d,k,r){return e(),i("div",null,s[0]||(s[0]=[l(`<h1 id="プラグイン" tabindex="-1">プラグイン <a class="header-anchor" href="#プラグイン" aria-label="Permalink to &quot;プラグイン&quot;">​</a></h1><p>プラグインは、<code>asdf</code>がNode.jsやRuby、Elixirなどの様々なツールを取り扱えるようにするためのものです。</p><p>様々なツールをサポートするために使用されるプラグインAPIについては、<a href="/ja-jp/plugins/create.html">プラグインの作成</a>をご覧ください。</p><h2 id="追加" tabindex="-1">追加 <a class="header-anchor" href="#追加" aria-label="Permalink to &quot;追加&quot;">​</a></h2><p>下記コマンドでは、GitのURLからプラグインを追加します:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">git-ur</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">l</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin add elm https://github.com/vic/asdf-elm</span></span></code></pre></div><p>または下記のコマンドで、プラグインリポジトリのショートネームを指定して追加します:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin add erlang</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">推奨</p><p>リポジトリのショートネームに依存しないために、<code>git-url</code>を使用することを推奨します。</p></div><h2 id="インストール済みプラグイン一覧" tabindex="-1">インストール済みプラグイン一覧 <a class="header-anchor" href="#インストール済みプラグイン一覧" aria-label="Permalink to &quot;インストール済みプラグイン一覧&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin list</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># java</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs</span></span></code></pre></div><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --urls</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin list</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># java            https://github.com/halcyon/asdf-java.git</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs          https://github.com/asdf-vm/asdf-nodejs.git</span></span></code></pre></div><h2 id="全プラグインのショートネーム一覧" tabindex="-1">全プラグインのショートネーム一覧 <a class="header-anchor" href="#全プラグインのショートネーム一覧" aria-label="Permalink to &quot;全プラグインのショートネーム一覧&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span></span></code></pre></div><p>全プラグインのショートネーム一覧については、<a href="https://github.com/asdf-vm/asdf-plugins" target="_blank" rel="noreferrer">プラグインショートネームの一覧</a>もご覧ください。</p><h2 id="更新" tabindex="-1">更新 <a class="header-anchor" href="#更新" aria-label="Permalink to &quot;更新&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --all</span></span></code></pre></div><p>特定のプラグインパッケージを更新したい場合は、下記のように指定してください。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin update erlang</span></span></code></pre></div><p>この更新コマンドは、プラグインリポジトリの <em>origin</em> の <em>デフォルトブランチ</em> における <em>最新コミット</em> を取得します。バージョニングされたプラグインの更新機能については、現在開発中です(<a href="https://github.com/asdf-vm/asdf/pull/916" target="_blank" rel="noreferrer">#916</a>)。</p><h2 id="削除" tabindex="-1">削除 <a class="header-anchor" href="#削除" aria-label="Permalink to &quot;削除&quot;">​</a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> remove</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin remove erlang</span></span></code></pre></div><p>プラグインを削除すると、当該プラグインでインストールされたすべてのツールが削除されます。これは、各ツールの未使用バージョンを手っ取り早くクリーンアップ/プルーニングするのに有用です。</p><h2 id="ショートネームリポジトリの同期" tabindex="-1">ショートネームリポジトリの同期 <a class="header-anchor" href="#ショートネームリポジトリの同期" aria-label="Permalink to &quot;ショートネームリポジトリの同期&quot;">​</a></h2><p>ショートネームリポジトリはローカルマシンに同期され、定期的に更新されます。同期のタイミングの条件は、次のとおりです:</p><ul><li>同期イベントは、下記コマンドによってトリガーされます: <ul><li><code>asdf plugin add &lt;name&gt;</code></li><li><code>asdf plugin list all</code></li></ul></li><li>構成設定の<code>disable_plugin_short_name_repository</code>オプションが<code>yes</code>の場合、同期は中止されます。詳しくは<a href="/ja-jp/manage/configuration.html">asdfの構成設定</a>のリファレンスをご覧ください。</li><li>もし、過去<code>X</code>分の間に同期が行われていない場合、同期が開始されます。 <ul><li><code>X</code>のデフォルト値は<code>60</code>ですが、<code>.asdfrc</code>ファイルの<code>plugin_repository_last_check_duration</code>オプションで変更することができます。詳しくは<a href="/ja-jp/manage/configuration.html">asdfの構成設定</a>のリファレンスをご覧ください。</li></ul></li></ul>`,26)]))}const c=a(t,[["render",n]]);export{g as __pageData,c as default};

assets/ja-jp_manage_plugins.md.Dveizso5.lean.js

@@ -0,0 +1,11 @@
+import{_ as a,c as i,a2 as l,o as e}from"./chunks/framework.BQmytedh.js";const g=JSON.parse('{"title":"プラグイン","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/manage/plugins.md","filePath":"ja-jp/manage/plugins.md","lastUpdated":1704890757000}'),t={name:"ja-jp/manage/plugins.md"};function n(h,s,p,d,k,r){return e(),i("div",null,s[0]||(s[0]=[l(`<h1 id="プラグイン" tabindex="-1">プラグイン <a class="header-anchor" href="#プラグイン" aria-label="Permalink to &quot;プラグイン&quot;">​</a></h1><p>プラグインは、<code>asdf</code>がNode.jsやRuby、Elixirなどの様々なツールを取り扱えるようにするためのものです。</p><p>様々なツールをサポートするために使用されるプラグインAPIについては、<a href="/ja-jp/plugins/create.html">プラグインの作成</a>をご覧ください。</p><h2 id="追加" tabindex="-1">追加 <a class="header-anchor" href="#追加" aria-label="Permalink to &quot;追加&quot;">​</a></h2><p>下記コマンドでは、GitのURLからプラグインを追加します:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">git-ur</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">l</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin add elm https://github.com/vic/asdf-elm</span></span></code></pre></div><p>または下記のコマンドで、プラグインリポジトリのショートネームを指定して追加します:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin add erlang</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">推奨</p><p>リポジトリのショートネームに依存しないために、<code>git-url</code>を使用することを推奨します。</p></div><h2 id="インストール済みプラグイン一覧" tabindex="-1">インストール済みプラグイン一覧 <a class="header-anchor" href="#インストール済みプラグイン一覧" aria-label="Permalink to &quot;インストール済みプラグイン一覧&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin list</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># java</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs</span></span></code></pre></div><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --urls</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin list</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># java            https://github.com/halcyon/asdf-java.git</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs          https://github.com/asdf-vm/asdf-nodejs.git</span></span></code></pre></div><h2 id="全プラグインのショートネーム一覧" tabindex="-1">全プラグインのショートネーム一覧 <a class="header-anchor" href="#全プラグインのショートネーム一覧" aria-label="Permalink to &quot;全プラグインのショートネーム一覧&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span></span></code></pre></div><p>全プラグインのショートネーム一覧については、<a href="https://github.com/asdf-vm/asdf-plugins" target="_blank" rel="noreferrer">プラグインショートネームの一覧</a>もご覧ください。</p><h2 id="更新" tabindex="-1">更新 <a class="header-anchor" href="#更新" aria-label="Permalink to &quot;更新&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --all</span></span></code></pre></div><p>特定のプラグインパッケージを更新したい場合は、下記のように指定してください。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin update erlang</span></span></code></pre></div><p>この更新コマンドは、プラグインリポジトリの <em>origin</em> の <em>デフォルトブランチ</em> における <em>最新コミット</em> を取得します。バージョニングされたプラグインの更新機能については、現在開発中です(<a href="https://github.com/asdf-vm/asdf/pull/916" target="_blank" rel="noreferrer">#916</a>)。</p><h2 id="削除" tabindex="-1">削除 <a class="header-anchor" href="#削除" aria-label="Permalink to &quot;削除&quot;">​</a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> remove</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin remove erlang</span></span></code></pre></div><p>プラグインを削除すると、当該プラグインでインストールされたすべてのツールが削除されます。これは、各ツールの未使用バージョンを手っ取り早くクリーンアップ/プルーニングするのに有用です。</p><h2 id="ショートネームリポジトリの同期" tabindex="-1">ショートネームリポジトリの同期 <a class="header-anchor" href="#ショートネームリポジトリの同期" aria-label="Permalink to &quot;ショートネームリポジトリの同期&quot;">​</a></h2><p>ショートネームリポジトリはローカルマシンに同期され、定期的に更新されます。同期のタイミングの条件は、次のとおりです:</p><ul><li>同期イベントは、下記コマンドによってトリガーされます: <ul><li><code>asdf plugin add &lt;name&gt;</code></li><li><code>asdf plugin list all</code></li></ul></li><li>構成設定の<code>disable_plugin_short_name_repository</code>オプションが<code>yes</code>の場合、同期は中止されます。詳しくは<a href="/ja-jp/manage/configuration.html">asdfの構成設定</a>のリファレンスをご覧ください。</li><li>もし、過去<code>X</code>分の間に同期が行われていない場合、同期が開始されます。 <ul><li><code>X</code>のデフォルト値は<code>60</code>ですが、<code>.asdfrc</code>ファイルの<code>plugin_repository_last_check_duration</code>オプションで変更することができます。詳しくは<a href="/ja-jp/manage/configuration.html">asdfの構成設定</a>のリファレンスをご覧ください。</li></ul></li></ul>`,26)]))}const c=a(t,[["render",n]]);export{g as __pageData,c as default};

assets/ja-jp_manage_versions.md.B4flZrjK.js

@@ -0,0 +1,30 @@
+import{_ as i,c as a,a2 as l,o as h}from"./chunks/framework.BQmytedh.js";const o=JSON.parse('{"title":"バージョン","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/manage/versions.md","filePath":"ja-jp/manage/versions.md","lastUpdated":1704890757000}'),t={name:"ja-jp/manage/versions.md"};function n(e,s,p,k,d,r){return h(),a("div",null,s[0]||(s[0]=[l(`<h1 id="バージョン" tabindex="-1">バージョン <a class="header-anchor" href="#バージョン" aria-label="Permalink to &quot;バージョン&quot;">​</a></h1><h2 id="バージョンのインストール" tabindex="-1">バージョンのインストール <a class="header-anchor" href="#バージョンのインストール" aria-label="Permalink to &quot;バージョンのインストール&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf install erlang 17.3</span></span></code></pre></div><p>プラグインが、ソースコードからのダウンロード・コンパイルをサポートしている場合、<code>ref:foo</code>の形式(<code>foo</code>は特定のブランチ、タグ、またはコミット)でバージョンを指定できます。アンインストールするときも、同じ名前とバージョンを指定する必要があります。</p><h2 id="最新安定バージョンのインストール" tabindex="-1">最新安定バージョンのインストール <a class="header-anchor" href="#最新安定バージョンのインストール" aria-label="Permalink to &quot;最新安定バージョンのインストール&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf install erlang latest</span></span></code></pre></div><p>下記のように、特定のプレフィックスでの最新安定バージョンをインストールすることもできます。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest:</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf install erlang latest:17</span></span></code></pre></div><h2 id="インストール済みバージョン一覧" tabindex="-1">インストール済みバージョン一覧 <a class="header-anchor" href="#インストール済みバージョン一覧" aria-label="Permalink to &quot;インストール済みバージョン一覧&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list erlang</span></span></code></pre></div><p>下記のように、特定のプレフィックスでのバージョンでフィルタすることもできます。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list erlang 17</span></span></code></pre></div><h2 id="インストール可能な全バージョン一覧" tabindex="-1">インストール可能な全バージョン一覧 <a class="header-anchor" href="#インストール可能な全バージョン一覧" aria-label="Permalink to &quot;インストール可能な全バージョン一覧&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list all erlang</span></span></code></pre></div><p>下記のように、特定のプレフィックスでのバージョンでフィルタすることもできます。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list all erlang 17</span></span></code></pre></div><h2 id="最新安定バージョンの表示" tabindex="-1">最新安定バージョンの表示 <a class="header-anchor" href="#最新安定バージョンの表示" aria-label="Permalink to &quot;最新安定バージョンの表示&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf latest erlang</span></span></code></pre></div><p>下記のように、特定のプレフィックスでの最新安定バージョンで表示することもできます。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf latest erlang 17</span></span></code></pre></div><h2 id="カレントバージョンのセット" tabindex="-1">カレントバージョンのセット <a class="header-anchor" href="#カレントバージョンのセット" aria-label="Permalink to &quot;カレントバージョンのセット&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> global</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [&lt;version&gt;...]</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shell</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [&lt;version&gt;...]</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> local</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [&lt;version&gt;...]</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf global elixir 1.2.4</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> global</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest[:</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">]</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> local</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest[:</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">]</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf global elixir latest</span></span></code></pre></div><p><code>global</code>の場合、バージョンは<code>$HOME/.tool-versions</code>ファイルに書き込まれます。</p><p><code>shell</code>の場合、バージョンは<code>ASDF_\${TOOL}_VERSION</code>という環境変数に設定され、現在のシェルセッションでのみ有効となります。</p><p><code>local</code>の場合、バージョンは<code>$PWD/.tool-versions</code>ファイルに書き込まれます。存在しない場合は作成されます。</p><p><code>.tool-versions</code>ファイルについて詳しくは、<a href="/ja-jp/manage/configuration.html">構成設定のリファレンス</a>をご覧ください。</p><div class="warning custom-block"><p class="custom-block-title">代替手段</p><p>現在のシェルセッションでのみバージョンを設定したい場合、 または、特定のツールバージョンでコマンドを実行するだけのためにバージョンを設定したい場合は、 <code>ASDF_\${TOOL}_VERSION</code>という環境変数で設定することができます。</p></div><p>下記の例では、バージョン<code>1.4.0</code>のElixirプロジェクトに対して、テストを実行させています。 バージョンの表記形式は、<code>.tool-versions</code>ファイルでサポートされているものと同じです。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">ASDF_ELIXIR_VERSION</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">1.4.0</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> mix</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test</span></span></code></pre></div><h2 id="システムバージョンへの委任" tabindex="-1">システムバージョンへの委任 <a class="header-anchor" href="#システムバージョンへの委任" aria-label="Permalink to &quot;システムバージョンへの委任&quot;">​</a></h2><p>asdfで管理されているバージョンではなく、<code>&lt;name&gt;</code>で指定されたツールのシステムバージョンを使用するには、バージョンとして<code>system</code>を指定します。</p><p><a href="#カレントバージョンのセット">カレントバージョンのセット</a>と同様の方法で、<code>global</code>、<code>local</code>、または<code>shell</code>のいずれかに<code>system</code>をセットしてください。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> local</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> system</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf local python system</span></span></code></pre></div><h2 id="カレントバージョンの表示" tabindex="-1">カレントバージョンの表示 <a class="header-anchor" href="#カレントバージョンの表示" aria-label="Permalink to &quot;カレントバージョンの表示&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> current</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf current</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># erlang          17.3          /Users/kim/.tool-versions</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs          6.11.5        /Users/kim/cool-node-project/.tool-versions</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> current</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf current erlang</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># erlang          17.3          /Users/kim/.tool-versions</span></span></code></pre></div><h2 id="バージョンのアンインストール" tabindex="-1">バージョンのアンインストール <a class="header-anchor" href="#バージョンのアンインストール" aria-label="Permalink to &quot;バージョンのアンインストール&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> uninstall</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf uninstall erlang 17.3</span></span></code></pre></div><h2 id="shims" tabindex="-1">Shims <a class="header-anchor" href="#shims" aria-label="Permalink to &quot;Shims&quot;">​</a></h2><p>asdfがパッケージをインストールすると、そのパッケージに含まれるすべての実行プログラムのShimが<code>$ASDF_DATA_DIR/shims</code>ディレクトリ(デフォルトは<code>~/.asdf/shims</code>)に作成されます。このディレクトリが(<code>asdf.sh</code>や<code>asdf.fish</code>などによって)<code>$PATH</code>に設定されることで、インストールされているプログラムが当該環境で利用できるようになります。</p><p>Shim自体は非常に単純なラッパーであり、<code>asdf exec</code>というヘルパープログラムに、プラグイン名と、Shimがラップしているインストール済みパッケージの実行ファイルのパスを渡して、<code>exec</code>します。</p><p><code>asdf exec</code>ヘルパーは、使用するパッケージのバージョン(<code>.tool-versions</code>ファイルで指定されたもの、または<code>asdf local ...</code>か<code>asdf global ...</code>で指定されたもの)、パッケージのインストールディレクトリにある実行ファイルの完全パス(プラグインの<code>exec-path</code>コールバックで操作可能)、および実行環境(プラグインの<code>exec-env</code>スクリプトで提供)を決定し、実行します。</p><div class="warning custom-block"><p class="custom-block-title">備考</p><p>本システムは<code>exec</code>呼び出しを使用するため、シェルによってsourceされるパッケージ内のスクリプトは、Shimラッパーを経由させずに直接アクセスする必要があります。<code>asdf</code>で用意されている<code>which</code>および<code>where</code>コマンドは、下記のように、インストールされたパッケージへのパスを返すため、この状況を解決するのに役立ちます:</p></div><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># returns path to main executable in current version</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">source</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> $(</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> which</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> \${PLUGIN})</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/../script.sh</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># returns path to the package installation directory</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">source</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> $(</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> where</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> \${PLUGIN})</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/bin/script.sh</span></span></code></pre></div><h3 id="asdfのshimのバイパス" tabindex="-1">asdfのShimのバイパス <a class="header-anchor" href="#asdfのshimのバイパス" aria-label="Permalink to &quot;asdfのShimのバイパス&quot;">​</a></h3><p>何らかの理由でasdfのShimをバイパスしたい場合や、プロジェクトのディレクトリに移動した際に自動的に環境変数を設定したい場合は、<a href="https://github.com/asdf-community/asdf-direnv" target="_blank" rel="noreferrer">asdf-direnv</a>プラグインが役に立ちます。詳細はREADMEをご確認ください。</p>`,45)]))}const c=i(t,[["render",n]]);export{o as __pageData,c as default};

assets/ja-jp_manage_versions.md.B4flZrjK.lean.js

@@ -0,0 +1,30 @@
+import{_ as i,c as a,a2 as l,o as h}from"./chunks/framework.BQmytedh.js";const o=JSON.parse('{"title":"バージョン","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/manage/versions.md","filePath":"ja-jp/manage/versions.md","lastUpdated":1704890757000}'),t={name:"ja-jp/manage/versions.md"};function n(e,s,p,k,d,r){return h(),a("div",null,s[0]||(s[0]=[l(`<h1 id="バージョン" tabindex="-1">バージョン <a class="header-anchor" href="#バージョン" aria-label="Permalink to &quot;バージョン&quot;">​</a></h1><h2 id="バージョンのインストール" tabindex="-1">バージョンのインストール <a class="header-anchor" href="#バージョンのインストール" aria-label="Permalink to &quot;バージョンのインストール&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf install erlang 17.3</span></span></code></pre></div><p>プラグインが、ソースコードからのダウンロード・コンパイルをサポートしている場合、<code>ref:foo</code>の形式(<code>foo</code>は特定のブランチ、タグ、またはコミット)でバージョンを指定できます。アンインストールするときも、同じ名前とバージョンを指定する必要があります。</p><h2 id="最新安定バージョンのインストール" tabindex="-1">最新安定バージョンのインストール <a class="header-anchor" href="#最新安定バージョンのインストール" aria-label="Permalink to &quot;最新安定バージョンのインストール&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf install erlang latest</span></span></code></pre></div><p>下記のように、特定のプレフィックスでの最新安定バージョンをインストールすることもできます。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest:</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf install erlang latest:17</span></span></code></pre></div><h2 id="インストール済みバージョン一覧" tabindex="-1">インストール済みバージョン一覧 <a class="header-anchor" href="#インストール済みバージョン一覧" aria-label="Permalink to &quot;インストール済みバージョン一覧&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list erlang</span></span></code></pre></div><p>下記のように、特定のプレフィックスでのバージョンでフィルタすることもできます。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list erlang 17</span></span></code></pre></div><h2 id="インストール可能な全バージョン一覧" tabindex="-1">インストール可能な全バージョン一覧 <a class="header-anchor" href="#インストール可能な全バージョン一覧" aria-label="Permalink to &quot;インストール可能な全バージョン一覧&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list all erlang</span></span></code></pre></div><p>下記のように、特定のプレフィックスでのバージョンでフィルタすることもできます。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list all erlang 17</span></span></code></pre></div><h2 id="最新安定バージョンの表示" tabindex="-1">最新安定バージョンの表示 <a class="header-anchor" href="#最新安定バージョンの表示" aria-label="Permalink to &quot;最新安定バージョンの表示&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf latest erlang</span></span></code></pre></div><p>下記のように、特定のプレフィックスでの最新安定バージョンで表示することもできます。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf latest erlang 17</span></span></code></pre></div><h2 id="カレントバージョンのセット" tabindex="-1">カレントバージョンのセット <a class="header-anchor" href="#カレントバージョンのセット" aria-label="Permalink to &quot;カレントバージョンのセット&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> global</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [&lt;version&gt;...]</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shell</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [&lt;version&gt;...]</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> local</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [&lt;version&gt;...]</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf global elixir 1.2.4</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> global</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest[:</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">]</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> local</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest[:</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">]</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf global elixir latest</span></span></code></pre></div><p><code>global</code>の場合、バージョンは<code>$HOME/.tool-versions</code>ファイルに書き込まれます。</p><p><code>shell</code>の場合、バージョンは<code>ASDF_\${TOOL}_VERSION</code>という環境変数に設定され、現在のシェルセッションでのみ有効となります。</p><p><code>local</code>の場合、バージョンは<code>$PWD/.tool-versions</code>ファイルに書き込まれます。存在しない場合は作成されます。</p><p><code>.tool-versions</code>ファイルについて詳しくは、<a href="/ja-jp/manage/configuration.html">構成設定のリファレンス</a>をご覧ください。</p><div class="warning custom-block"><p class="custom-block-title">代替手段</p><p>現在のシェルセッションでのみバージョンを設定したい場合、 または、特定のツールバージョンでコマンドを実行するだけのためにバージョンを設定したい場合は、 <code>ASDF_\${TOOL}_VERSION</code>という環境変数で設定することができます。</p></div><p>下記の例では、バージョン<code>1.4.0</code>のElixirプロジェクトに対して、テストを実行させています。 バージョンの表記形式は、<code>.tool-versions</code>ファイルでサポートされているものと同じです。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">ASDF_ELIXIR_VERSION</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">1.4.0</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> mix</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test</span></span></code></pre></div><h2 id="システムバージョンへの委任" tabindex="-1">システムバージョンへの委任 <a class="header-anchor" href="#システムバージョンへの委任" aria-label="Permalink to &quot;システムバージョンへの委任&quot;">​</a></h2><p>asdfで管理されているバージョンではなく、<code>&lt;name&gt;</code>で指定されたツールのシステムバージョンを使用するには、バージョンとして<code>system</code>を指定します。</p><p><a href="#カレントバージョンのセット">カレントバージョンのセット</a>と同様の方法で、<code>global</code>、<code>local</code>、または<code>shell</code>のいずれかに<code>system</code>をセットしてください。</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> local</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> system</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf local python system</span></span></code></pre></div><h2 id="カレントバージョンの表示" tabindex="-1">カレントバージョンの表示 <a class="header-anchor" href="#カレントバージョンの表示" aria-label="Permalink to &quot;カレントバージョンの表示&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> current</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf current</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># erlang          17.3          /Users/kim/.tool-versions</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs          6.11.5        /Users/kim/cool-node-project/.tool-versions</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> current</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf current erlang</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># erlang          17.3          /Users/kim/.tool-versions</span></span></code></pre></div><h2 id="バージョンのアンインストール" tabindex="-1">バージョンのアンインストール <a class="header-anchor" href="#バージョンのアンインストール" aria-label="Permalink to &quot;バージョンのアンインストール&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> uninstall</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf uninstall erlang 17.3</span></span></code></pre></div><h2 id="shims" tabindex="-1">Shims <a class="header-anchor" href="#shims" aria-label="Permalink to &quot;Shims&quot;">​</a></h2><p>asdfがパッケージをインストールすると、そのパッケージに含まれるすべての実行プログラムのShimが<code>$ASDF_DATA_DIR/shims</code>ディレクトリ(デフォルトは<code>~/.asdf/shims</code>)に作成されます。このディレクトリが(<code>asdf.sh</code>や<code>asdf.fish</code>などによって)<code>$PATH</code>に設定されることで、インストールされているプログラムが当該環境で利用できるようになります。</p><p>Shim自体は非常に単純なラッパーであり、<code>asdf exec</code>というヘルパープログラムに、プラグイン名と、Shimがラップしているインストール済みパッケージの実行ファイルのパスを渡して、<code>exec</code>します。</p><p><code>asdf exec</code>ヘルパーは、使用するパッケージのバージョン(<code>.tool-versions</code>ファイルで指定されたもの、または<code>asdf local ...</code>か<code>asdf global ...</code>で指定されたもの)、パッケージのインストールディレクトリにある実行ファイルの完全パス(プラグインの<code>exec-path</code>コールバックで操作可能)、および実行環境(プラグインの<code>exec-env</code>スクリプトで提供)を決定し、実行します。</p><div class="warning custom-block"><p class="custom-block-title">備考</p><p>本システムは<code>exec</code>呼び出しを使用するため、シェルによってsourceされるパッケージ内のスクリプトは、Shimラッパーを経由させずに直接アクセスする必要があります。<code>asdf</code>で用意されている<code>which</code>および<code>where</code>コマンドは、下記のように、インストールされたパッケージへのパスを返すため、この状況を解決するのに役立ちます:</p></div><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># returns path to main executable in current version</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">source</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> $(</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> which</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> \${PLUGIN})</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/../script.sh</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># returns path to the package installation directory</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">source</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> $(</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> where</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> \${PLUGIN})</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/bin/script.sh</span></span></code></pre></div><h3 id="asdfのshimのバイパス" tabindex="-1">asdfのShimのバイパス <a class="header-anchor" href="#asdfのshimのバイパス" aria-label="Permalink to &quot;asdfのShimのバイパス&quot;">​</a></h3><p>何らかの理由でasdfのShimをバイパスしたい場合や、プロジェクトのディレクトリに移動した際に自動的に環境変数を設定したい場合は、<a href="https://github.com/asdf-community/asdf-direnv" target="_blank" rel="noreferrer">asdf-direnv</a>プラグインが役に立ちます。詳細はREADMEをご確認ください。</p>`,45)]))}const c=i(t,[["render",n]]);export{o as __pageData,c as default};

assets/ja-jp_more_community-projects.md.Cq5uhq32.js

@@ -0,0 +1 @@
+import{_ as t,c as a,a2 as o,o as r}from"./chunks/framework.BQmytedh.js";const f=JSON.parse('{"title":"コミュニティプロジェクト","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/more/community-projects.md","filePath":"ja-jp/more/community-projects.md","lastUpdated":1704890757000}'),s={name:"ja-jp/more/community-projects.md"};function c(n,e,i,d,l,p){return r(),a("div",null,e[0]||(e[0]=[o('<h1 id="コミュニティプロジェクト" tabindex="-1">コミュニティプロジェクト <a class="header-anchor" href="#コミュニティプロジェクト" aria-label="Permalink to &quot;コミュニティプロジェクト&quot;">​</a></h1><p><code>asdf</code>に関連するコミュニティプロジェクトをいくつか紹介します:</p><ul><li><a href="https://github.com/asdf-community" target="_blank" rel="noreferrer">asdf-community</a>: asdfプラグインの長期的なメンテナンスを目的とした コミュニティ主導の共同プロジェクトです。</li><li><a href="https://github.com/iloveitaly/asdf-devcontainer" target="_blank" rel="noreferrer">asdf dev container</a>: GitHub Codespacesでasdfによるツール管理をサポートする、 <a href="https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers" target="_blank" rel="noreferrer">GitHub Dev Container</a> です。</li></ul><div class="warning custom-block"><p class="custom-block-title">備考</p><p>asdfコアチームは、これらのプロジェクトやコードを所有していません。 asdfコアでは、ここに掲載されているものに関連する品質やセキュリティについては責任を負いません。</p></div>',4)]))}const u=t(s,[["render",c]]);export{f as __pageData,u as default};

assets/ja-jp_more_community-projects.md.Cq5uhq32.lean.js

@@ -0,0 +1 @@
+import{_ as t,c as a,a2 as o,o as r}from"./chunks/framework.BQmytedh.js";const f=JSON.parse('{"title":"コミュニティプロジェクト","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/more/community-projects.md","filePath":"ja-jp/more/community-projects.md","lastUpdated":1704890757000}'),s={name:"ja-jp/more/community-projects.md"};function c(n,e,i,d,l,p){return r(),a("div",null,e[0]||(e[0]=[o('<h1 id="コミュニティプロジェクト" tabindex="-1">コミュニティプロジェクト <a class="header-anchor" href="#コミュニティプロジェクト" aria-label="Permalink to &quot;コミュニティプロジェクト&quot;">​</a></h1><p><code>asdf</code>に関連するコミュニティプロジェクトをいくつか紹介します:</p><ul><li><a href="https://github.com/asdf-community" target="_blank" rel="noreferrer">asdf-community</a>: asdfプラグインの長期的なメンテナンスを目的とした コミュニティ主導の共同プロジェクトです。</li><li><a href="https://github.com/iloveitaly/asdf-devcontainer" target="_blank" rel="noreferrer">asdf dev container</a>: GitHub Codespacesでasdfによるツール管理をサポートする、 <a href="https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers" target="_blank" rel="noreferrer">GitHub Dev Container</a> です。</li></ul><div class="warning custom-block"><p class="custom-block-title">備考</p><p>asdfコアチームは、これらのプロジェクトやコードを所有していません。 asdfコアでは、ここに掲載されているものに関連する品質やセキュリティについては責任を負いません。</p></div>',4)]))}const u=t(s,[["render",c]]);export{f as __pageData,u as default};

assets/ja-jp_more_faq.md.AspkCmpH.js

@@ -0,0 +1 @@
+import{_ as a,c as o,a2 as r,o as t}from"./chunks/framework.BQmytedh.js";const p=JSON.parse('{"title":"FAQ","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/more/faq.md","filePath":"ja-jp/more/faq.md","lastUpdated":1704890757000}'),s={name:"ja-jp/more/faq.md"};function i(d,e,n,c,h,l){return t(),o("div",null,e[0]||(e[0]=[r('<h1 id="faq" tabindex="-1">FAQ <a class="header-anchor" href="#faq" aria-label="Permalink to &quot;FAQ&quot;">​</a></h1><p>ここでは、<code>asdf</code>に関するよくある質問を紹介します。</p><h2 id="wsl1をサポートしていますか" tabindex="-1">WSL1をサポートしていますか? <a class="header-anchor" href="#wsl1をサポートしていますか" aria-label="Permalink to &quot;WSL1をサポートしていますか?&quot;">​</a></h2><p>WSL1 (<a href="https://ja.wikipedia.org/wiki/Windows_Subsystem_for_Linux" target="_blank" rel="noreferrer">Windows Subsystem for Linux</a> 1)は公式にはサポートしていません。<code>asdf</code>は正常に動作しない可能性があります。WSL1を公式にサポートする予定はありません。</p><h2 id="wsl2をサポートしていますか" tabindex="-1">WSL2をサポートしていますか? <a class="header-anchor" href="#wsl2をサポートしていますか" aria-label="Permalink to &quot;WSL2をサポートしていますか?&quot;">​</a></h2><p>WSL2 (<a href="https://ja.wikipedia.org/wiki/Windows_Subsystem_for_Linux#WSL2" target="_blank" rel="noreferrer">Windows Subsystem for Linux</a> 2)では、あなたが選択したWSLディストリビューションに基づいて、セットアップと依存関係の解決を済ませれば、動作するはずです。</p><p>重要なのは、WSL2が正常に動作するのは、カレントワークディレクトリがWindowsドライブではなくUnixドライブである場合に <em>限られる</em> ということです。</p><p>GitHub Actionsでホストランナーのサポートが可能になれば、WSL2でテストスイートを実行する予定ですが、現時点ではそうではないようです。</p><h2 id="新しくインストールした実行ファイルが実行できないのですが" tabindex="-1">新しくインストールした実行ファイルが実行できないのですが? <a class="header-anchor" href="#新しくインストールした実行ファイルが実行できないのですが" aria-label="Permalink to &quot;新しくインストールした実行ファイルが実行できないのですが?&quot;">​</a></h2><blockquote><p><code>npm install -g yarn</code>を実行したにも関わらず、<code>yarn</code>が実行できません。どうなっているの?</p></blockquote><p><code>asdf</code>は<a href="https://en.wikipedia.org/wiki/Shim_(computing)" target="_blank" rel="noreferrer">Shim</a>を使って実行ファイルを管理しています。プラグインによってインストールされるものは、自動的にShimが作成されますが、<code>asdf</code>が管理しているツールによって実行ファイルがインストールされた場合は、Shimを作成しなければならないということを<code>asdf</code>に通知する必要があります。上記の例では、<a href="https://yarnpkg.com/" target="_blank" rel="noreferrer">Yarn</a>のShimを作成しなければいけません。詳しくは、<a href="/ja-jp/manage/core.html#shimの再作成"><code>asdf reshim</code>コマンドのドキュメント</a>をご覧ください。</p><h2 id="シェルが、新しくインストールされたshimを検知してくれないのですが" tabindex="-1">シェルが、新しくインストールされたShimを検知してくれないのですが? <a class="header-anchor" href="#シェルが、新しくインストールされたshimを検知してくれないのですが" aria-label="Permalink to &quot;シェルが、新しくインストールされたShimを検知してくれないのですが?&quot;">​</a></h2><p><code>asdf reshim</code>コマンドを実行しても問題が解決しない場合、<code>asdf.sh</code>や<code>asdf.fish</code>のsourceが、シェルの構成ファイル(<code>.bash_profile</code>、<code>.zshrc</code>、<code>config.fish</code>など)の<strong>一番下</strong>にないことが原因である可能性があります。<code>$PATH</code>を設定した<strong>後</strong>、そしてフレームワーク(oh-my-zshなど)を使用しているのれあればそれをsourceした<strong>後</strong>に、sourceする必要があります。</p>',13)]))}const m=a(s,[["render",i]]);export{p as __pageData,m as default};

assets/ja-jp_more_faq.md.AspkCmpH.lean.js

@@ -0,0 +1 @@
+import{_ as a,c as o,a2 as r,o as t}from"./chunks/framework.BQmytedh.js";const p=JSON.parse('{"title":"FAQ","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/more/faq.md","filePath":"ja-jp/more/faq.md","lastUpdated":1704890757000}'),s={name:"ja-jp/more/faq.md"};function i(d,e,n,c,h,l){return t(),o("div",null,e[0]||(e[0]=[r('<h1 id="faq" tabindex="-1">FAQ <a class="header-anchor" href="#faq" aria-label="Permalink to &quot;FAQ&quot;">​</a></h1><p>ここでは、<code>asdf</code>に関するよくある質問を紹介します。</p><h2 id="wsl1をサポートしていますか" tabindex="-1">WSL1をサポートしていますか? <a class="header-anchor" href="#wsl1をサポートしていますか" aria-label="Permalink to &quot;WSL1をサポートしていますか?&quot;">​</a></h2><p>WSL1 (<a href="https://ja.wikipedia.org/wiki/Windows_Subsystem_for_Linux" target="_blank" rel="noreferrer">Windows Subsystem for Linux</a> 1)は公式にはサポートしていません。<code>asdf</code>は正常に動作しない可能性があります。WSL1を公式にサポートする予定はありません。</p><h2 id="wsl2をサポートしていますか" tabindex="-1">WSL2をサポートしていますか? <a class="header-anchor" href="#wsl2をサポートしていますか" aria-label="Permalink to &quot;WSL2をサポートしていますか?&quot;">​</a></h2><p>WSL2 (<a href="https://ja.wikipedia.org/wiki/Windows_Subsystem_for_Linux#WSL2" target="_blank" rel="noreferrer">Windows Subsystem for Linux</a> 2)では、あなたが選択したWSLディストリビューションに基づいて、セットアップと依存関係の解決を済ませれば、動作するはずです。</p><p>重要なのは、WSL2が正常に動作するのは、カレントワークディレクトリがWindowsドライブではなくUnixドライブである場合に <em>限られる</em> ということです。</p><p>GitHub Actionsでホストランナーのサポートが可能になれば、WSL2でテストスイートを実行する予定ですが、現時点ではそうではないようです。</p><h2 id="新しくインストールした実行ファイルが実行できないのですが" tabindex="-1">新しくインストールした実行ファイルが実行できないのですが? <a class="header-anchor" href="#新しくインストールした実行ファイルが実行できないのですが" aria-label="Permalink to &quot;新しくインストールした実行ファイルが実行できないのですが?&quot;">​</a></h2><blockquote><p><code>npm install -g yarn</code>を実行したにも関わらず、<code>yarn</code>が実行できません。どうなっているの?</p></blockquote><p><code>asdf</code>は<a href="https://en.wikipedia.org/wiki/Shim_(computing)" target="_blank" rel="noreferrer">Shim</a>を使って実行ファイルを管理しています。プラグインによってインストールされるものは、自動的にShimが作成されますが、<code>asdf</code>が管理しているツールによって実行ファイルがインストールされた場合は、Shimを作成しなければならないということを<code>asdf</code>に通知する必要があります。上記の例では、<a href="https://yarnpkg.com/" target="_blank" rel="noreferrer">Yarn</a>のShimを作成しなければいけません。詳しくは、<a href="/ja-jp/manage/core.html#shimの再作成"><code>asdf reshim</code>コマンドのドキュメント</a>をご覧ください。</p><h2 id="シェルが、新しくインストールされたshimを検知してくれないのですが" tabindex="-1">シェルが、新しくインストールされたShimを検知してくれないのですが? <a class="header-anchor" href="#シェルが、新しくインストールされたshimを検知してくれないのですが" aria-label="Permalink to &quot;シェルが、新しくインストールされたShimを検知してくれないのですが?&quot;">​</a></h2><p><code>asdf reshim</code>コマンドを実行しても問題が解決しない場合、<code>asdf.sh</code>や<code>asdf.fish</code>のsourceが、シェルの構成ファイル(<code>.bash_profile</code>、<code>.zshrc</code>、<code>config.fish</code>など)の<strong>一番下</strong>にないことが原因である可能性があります。<code>$PATH</code>を設定した<strong>後</strong>、そしてフレームワーク(oh-my-zshなど)を使用しているのれあればそれをsourceした<strong>後</strong>に、sourceする必要があります。</p>',13)]))}const m=a(s,[["render",i]]);export{p as __pageData,m as default};

assets/ja-jp_more_thanks.md.dd0Jv9gE.js

@@ -0,0 +1 @@
+import{_ as e,c as r,a2 as t,o as h}from"./chunks/framework.BQmytedh.js";const f=JSON.parse('{"title":"謝辞","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/more/thanks.md","filePath":"ja-jp/more/thanks.md","lastUpdated":1704890757000}'),o={name:"ja-jp/more/thanks.md"};function l(s,a,n,i,d,p){return h(),r("div",null,a[0]||(a[0]=[t('<h1 id="謝辞" tabindex="-1">謝辞 <a class="header-anchor" href="#謝辞" aria-label="Permalink to &quot;謝辞&quot;">​</a></h1><p>このページを借りて、asdfのオーサーおよびコントリビューターの皆様に感謝を申し上げます!</p><h2 id="クレジット" tabindex="-1">クレジット <a class="header-anchor" href="#クレジット" aria-label="Permalink to &quot;クレジット&quot;">​</a></h2><p>私 (<a href="https://github.com/HashNuke" target="_blank" rel="noreferrer">@HashNuke</a>)、高熱、風邪、咳。</p><p>コピーライト 2014年から今まで (<a href="https://github.com/asdf-vm/asdf/blob/master/LICENSE" target="_blank" rel="noreferrer">MIT License</a>)</p><h2 id="メンテナー" tabindex="-1">メンテナー <a class="header-anchor" href="#メンテナー" aria-label="Permalink to &quot;メンテナー&quot;">​</a></h2><ul><li><a href="https://github.com/HashNuke" target="_blank" rel="noreferrer">@HashNuke</a></li><li><a href="https://github.com/danhper" target="_blank" rel="noreferrer">@danhper</a></li><li><a href="https://github.com/Stratus3D" target="_blank" rel="noreferrer">@Stratus3D</a></li><li><a href="https://github.com/vic" target="_blank" rel="noreferrer">@vic</a></li><li><a href="https://github.com/jthegedus" target="_blank" rel="noreferrer">@jthegedus</a></li></ul><h2 id="コントリビューター" tabindex="-1">コントリビューター <a class="header-anchor" href="#コントリビューター" aria-label="Permalink to &quot;コントリビューター&quot;">​</a></h2><p>GitHubの<a href="https://github.com/asdf-vm/asdf/graphs/contributors" target="_blank" rel="noreferrer">コントリビューターリスト</a>🙏をご覧ください。</p>',9)]))}const u=e(o,[["render",l]]);export{f as __pageData,u as default};

assets/ja-jp_more_thanks.md.dd0Jv9gE.lean.js

@@ -0,0 +1 @@
+import{_ as e,c as r,a2 as t,o as h}from"./chunks/framework.BQmytedh.js";const f=JSON.parse('{"title":"謝辞","description":"","frontmatter":{},"headers":[],"relativePath":"ja-jp/more/thanks.md","filePath":"ja-jp/more/thanks.md","lastUpdated":1704890757000}'),o={name:"ja-jp/more/thanks.md"};function l(s,a,n,i,d,p){return h(),r("div",null,a[0]||(a[0]=[t('<h1 id="謝辞" tabindex="-1">謝辞 <a class="header-anchor" href="#謝辞" aria-label="Permalink to &quot;謝辞&quot;">​</a></h1><p>このページを借りて、asdfのオーサーおよびコントリビューターの皆様に感謝を申し上げます!</p><h2 id="クレジット" tabindex="-1">クレジット <a class="header-anchor" href="#クレジット" aria-label="Permalink to &quot;クレジット&quot;">​</a></h2><p>私 (<a href="https://github.com/HashNuke" target="_blank" rel="noreferrer">@HashNuke</a>)、高熱、風邪、咳。</p><p>コピーライト 2014年から今まで (<a href="https://github.com/asdf-vm/asdf/blob/master/LICENSE" target="_blank" rel="noreferrer">MIT License</a>)</p><h2 id="メンテナー" tabindex="-1">メンテナー <a class="header-anchor" href="#メンテナー" aria-label="Permalink to &quot;メンテナー&quot;">​</a></h2><ul><li><a href="https://github.com/HashNuke" target="_blank" rel="noreferrer">@HashNuke</a></li><li><a href="https://github.com/danhper" target="_blank" rel="noreferrer">@danhper</a></li><li><a href="https://github.com/Stratus3D" target="_blank" rel="noreferrer">@Stratus3D</a></li><li><a href="https://github.com/vic" target="_blank" rel="noreferrer">@vic</a></li><li><a href="https://github.com/jthegedus" target="_blank" rel="noreferrer">@jthegedus</a></li></ul><h2 id="コントリビューター" tabindex="-1">コントリビューター <a class="header-anchor" href="#コントリビューター" aria-label="Permalink to &quot;コントリビューター&quot;">​</a></h2><p>GitHubの<a href="https://github.com/asdf-vm/asdf/graphs/contributors" target="_blank" rel="noreferrer">コントリビューターリスト</a>🙏をご覧ください。</p>',9)]))}const u=e(o,[["render",l]]);export{f as __pageData,u as default};

assets/ko-kr_contribute_core.md.D-irvj4K.js

@@ -0,0 +1,31 @@
+import{_ as a,c as e,a2 as i,o as t}from"./chunks/framework.BQmytedh.js";const k=JSON.parse('{"title":"asdf","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/contribute/core.md","filePath":"ko-kr/contribute/core.md","lastUpdated":1734394996000}'),n={name:"ko-kr/contribute/core.md"};function l(p,s,h,o,r,d){return t(),e("div",null,s[0]||(s[0]=[i(`<h1 id="asdf" tabindex="-1">asdf <a class="header-anchor" href="#asdf" aria-label="Permalink to &quot;asdf&quot;">​</a></h1><p><code>asdf</code> 코어 기여 가이드.</p><h2 id="초기-설정" tabindex="-1">초기 설정 <a class="header-anchor" href="#초기-설정" aria-label="Permalink to &quot;초기 설정&quot;">​</a></h2><p>Github의 <code>asdf</code>를 fork하거나 clone하세요:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># clone your fork</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">GITHUB_USE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">R</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/asdf.git</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># or clone asdf</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/asdf-vm/asdf.git</span></span></code></pre></div><p>코어 개발을 위한 툴들은 이 리포지토리의 <code>.tool-versions</code>에 있습니다. 만약 <code>asdf</code>가 직접 관리하기를 바라신다면, 다음 플러그인들을 설치하세요:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bats</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/timgluz/asdf-bats.git</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shellcheck</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/luizm/asdf-shellcheck.git</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shfmt</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/luizm/asdf-shfmt.git</span></span></code></pre></div><p><code>asdf</code>를 개발하기 위한 버전들을 설치하세요:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span></span></code></pre></div><p>로컬 머신에서 개발 도구를 손상시킬 수 있는 기능을 개발 중일 경우 <code>asdf</code>를 사용하지 않는 것이 <em>좋을 수</em> 있습니다. 개발 도구들의 원본 목록입니다:</p><ul><li><a href="https://github.com/bats-core/bats-core" target="_blank" rel="noreferrer">bats-core</a>: Bash 또는 POSIX 준수 스크립트를 단위 테스트하기 위한 Bash 자동화 테스트 시스템.</li><li><a href="https://github.com/koalaman/shellcheck" target="_blank" rel="noreferrer">shellcheck</a>: 셸 스크립트 정적 분석 도구.</li><li><a href="https://github.com/mvdan/sh" target="_blank" rel="noreferrer">shfmt</a>: Bash를 지원하는 셸 parser, formatter, interpreter; shfmt 포함</li></ul><h2 id="개발" tabindex="-1">개발 <a class="header-anchor" href="#개발" aria-label="Permalink to &quot;개발&quot;">​</a></h2><p>만약 설치된 <code>asdf</code>에 영향 없이 변화들을 테스트해보시고 싶으시다면, <code>$ASDF_DIR</code> 변수를 리포지토리를 clone한 경로에 지정하시고, 그 다음 임시로 <code>bin</code>와 <code>shims</code> 디렉토리들을 경로 앞에 추가하세요.</p><p>원격 리포지토리에 커밋 혹은 push하기 전에, 당신의 코드를 format, lint, 그리고 locally test하세요. 다음 스크립트/명령어들을 사용하세요:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Lint</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/lint.bash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --check</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Fix &amp; Format</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/lint.bash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --fix</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Test: all tests</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/test.bash</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Test: for specific command</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bats</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test/list_commands.bash</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">TIP</p><p><strong>테스트 추가!</strong> - 새로운 기능들과 버그 수정들의 리뷰 속도 향상을 위해 테스트들은 <strong>필수적</strong>입니다. 풀 리퀘스트 요청을 만드시기 전에 새로운 코드 경로들을 추가해주세요. <a href="https://bats-core.readthedocs.io/en/stable/index.html" target="_blank" rel="noreferrer">bats-core 문서</a> 참조</p></div><h3 id="gitignore" tabindex="-1">Gitignore <a class="header-anchor" href="#gitignore" aria-label="Permalink to &quot;Gitignore&quot;">​</a></h3><p>다음은 <code>asdf-vm/asdf</code> 리포지토리에 <code>.gitignore</code> 파일입니다. 우리는 프로젝트에 관련된 특정한 파일들을 무시합니다. 운영체제, 툴, workflows에 관련된 파일들은 글로벌 <code>.gitignore</code> 설정에서 무시되어야합니다, <a href="http://stratus3d.com/blog/2018/06/03/stop-excluding-editor-temp-files-in-gitignore/" target="_blank" rel="noreferrer">더 보기</a>.</p><p>@/../.gitignore</p><h3 id="git-blame-ignore-revs" tabindex="-1"><code>.git-blame-ignore-revs</code> <a class="header-anchor" href="#git-blame-ignore-revs" aria-label="Permalink to &quot;\`.git-blame-ignore-revs\`&quot;">​</a></h3><p><code>asdf</code>는 <code>.git-blame-ignore-revs</code> 사용해 blame 실행에서 잡음을 줄입니다. 더 많은 정보 <a href="https://git-scm.com/docs/git-blame" target="_blank" rel="noreferrer">git blame 문서</a>.</p><p>다음과 같이 <code>git blame</code>과 <code>.git-blame-ignore-revs</code>을 사용:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blame</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --ignore-revs-file</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .git-blame-ignore-revs</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ./test/install_command.bats</span></span></code></pre></div><p>선택적으로, 수동적으로 파일을 제공하는 대신 모든 <code>blame</code>에서 해당 파일을 사용하도록 설정:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> config</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blame.ignoreRevsFile</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .git-blame-ignore-revs</span></span></code></pre></div><p>IDE들에서 이 파일을 사용하도록 설정할 수 있습니다. 예를 들어, VSCode를 사용하실 경우 (<a href="https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens" target="_blank" rel="noreferrer">GitLens</a>와 함께), 다음을 <code>.vscode/settings.json</code>에 추가하세요:</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  &quot;gitlens.advanced.blame.customArguments&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span></span>
+<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    &quot;--ignore-revs-file&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    &quot;.git-blame-ignore-revs&quot;</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  ]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h2 id="bats-테스팅" tabindex="-1">Bats 테스팅 <a class="header-anchor" href="#bats-테스팅" aria-label="Permalink to &quot;Bats 테스팅&quot;">​</a></h2><p>로컬 테스트 실행:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/test.bash</span></span></code></pre></div><p>테스트 작성 전 <strong>반드시 읽기</strong>:</p><ul><li><code>test/</code>에 존재하는 테스트들</li><li><a href="https://bats-core.readthedocs.io/en/stable/index.html" target="_blank" rel="noreferrer">bats-core 문서</a></li><li><code>scripts/test.bash</code>에 존재하는 Bats 설정들</li></ul><h3 id="bats-팁" tabindex="-1">Bats 팁 <a class="header-anchor" href="#bats-팁" aria-label="Permalink to &quot;Bats 팁&quot;">​</a></h3><p>Bats 디버깅은 때에 따라 어려울 수 있습니다. 디버깅 단순화를 위해, <code>-t</code> flag로 TAP output을 사용하여 테스트 실행 중 결과물 출력을 위한 특별한 파일 디스크립터 <code>&gt;&amp;3</code>를 사용할 수 있습니다. 예시:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># test/some_tests.bats</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">printf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;%s\\n&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Will not be printed during bats test/some_tests.bats&quot;</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">printf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;%s\\n&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Will be printed during bats -t test/some_tests.bats&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &gt;&amp;3</span></span></code></pre></div><p>bats-core의 더 자세한 문서 <a href="https://bats-core.readthedocs.io/en/stable/writing-tests.html#printing-to-the-terminal" target="_blank" rel="noreferrer">Printing to the Terminal</a>.</p><h2 id="풀-리퀘스트-릴리스-관습적-커밋" tabindex="-1">풀 리퀘스트, 릴리스 &amp; 관습적 커밋 <a class="header-anchor" href="#풀-리퀘스트-릴리스-관습적-커밋" aria-label="Permalink to &quot;풀 리퀘스트, 릴리스 &amp; 관습적 커밋&quot;">​</a></h2><p><code>asdf</code>는 자동화 배포 툴 <a href="https://github.com/googleapis/release-please" target="_blank" rel="noreferrer">Release Please</a>를 사용하여 자동으로 <a href="https://semver.org/" target="_blank" rel="noreferrer">SemVer</a> 버전을 올리고 <a href="https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md" target="_blank" rel="noreferrer">변동사항</a>을 작성합니다. 이 정보들은 지난 배포들로부터 커밋 history를 읽음으로써 결정됩니다.</p><p><a href="https://www.conventionalcommits.org/" target="_blank" rel="noreferrer">유의적 커밋 메세지</a>는 기본 브랜치의 커밋 메세지 형식이 되는 풀 리퀘스트 제목의 형식을 정의합니다. 이것은 GitHub Action에서 강제됩니다 <a href="https://github.com/amannn/action-semantic-pull-request" target="_blank" rel="noreferrer"><code>amannn/action-semantic-pull-request</code></a>.</p><p>관습적인 커밋 다음 형식을 따릅니다:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>&lt;type&gt;[optional scope][optional !]: &lt;description&gt;</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>&lt;!-- examples --&gt;</span></span>
+<span class="line"><span>fix: some fix</span></span>
+<span class="line"><span>feat: a new feature</span></span>
+<span class="line"><span>docs: some documentation update</span></span>
+<span class="line"><span>docs(website): some change for the website</span></span>
+<span class="line"><span>feat!: feature with breaking change</span></span></code></pre></div><p><code>&lt;types&gt;</code>의 모든 목록: <code>feat</code>, <code>fix</code>, <code>docs</code>, <code>style</code>, <code>refactor</code>, <code>perf</code>, <code>test</code>, <code>build</code>, <code>ci</code>, <code>chore</code>, <code>revert</code>.</p><ul><li><code>!</code>: 주요한(breaking) 변화들을 나타냅니다</li><li><code>fix</code>: 새로운 SemVer <code>patch</code>을 만듭니다</li><li><code>feat</code>: 새로운 SemVer <code>minor</code>을 만듭니다</li><li><code>&lt;type&gt;!</code>: 새로운 SemVer <code>major</code>을 만듭니다</li></ul><p>풀 리퀘스트 제목은 반드시 이 형식을 따라야 합니다.</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>풀 리퀘스트 제목을 관습적 커밋 메세지 형식을 사용하세요.</p></div><h2 id="docker-이미지" tabindex="-1">Docker 이미지 <a class="header-anchor" href="#docker-이미지" aria-label="Permalink to &quot;Docker 이미지&quot;">​</a></h2><p><a href="https://github.com/vic/asdf-alpine" target="_blank" rel="noreferrer">asdf-alpine</a>와 <a href="https://github.com/vic/asdf-ubuntu" target="_blank" rel="noreferrer">asdf-ubuntu</a> 프로젝트들은 asdf 툴들의 Dockerized 이미지들을 제공하기 위해 진행되고있습니다. 개발 서버의 베이스 혹은 프로덕션 앱들을 위해 docker 이미지들을 사용할 수 있습니다.</p>`,47)]))}const g=a(n,[["render",l]]);export{k as __pageData,g as default};

assets/ko-kr_contribute_core.md.D-irvj4K.lean.js

@@ -0,0 +1,31 @@
+import{_ as a,c as e,a2 as i,o as t}from"./chunks/framework.BQmytedh.js";const k=JSON.parse('{"title":"asdf","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/contribute/core.md","filePath":"ko-kr/contribute/core.md","lastUpdated":1734394996000}'),n={name:"ko-kr/contribute/core.md"};function l(p,s,h,o,r,d){return t(),e("div",null,s[0]||(s[0]=[i(`<h1 id="asdf" tabindex="-1">asdf <a class="header-anchor" href="#asdf" aria-label="Permalink to &quot;asdf&quot;">​</a></h1><p><code>asdf</code> 코어 기여 가이드.</p><h2 id="초기-설정" tabindex="-1">초기 설정 <a class="header-anchor" href="#초기-설정" aria-label="Permalink to &quot;초기 설정&quot;">​</a></h2><p>Github의 <code>asdf</code>를 fork하거나 clone하세요:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># clone your fork</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">GITHUB_USE</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">R</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/asdf.git</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># or clone asdf</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> clone</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/asdf-vm/asdf.git</span></span></code></pre></div><p>코어 개발을 위한 툴들은 이 리포지토리의 <code>.tool-versions</code>에 있습니다. 만약 <code>asdf</code>가 직접 관리하기를 바라신다면, 다음 플러그인들을 설치하세요:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> bats</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/timgluz/asdf-bats.git</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shellcheck</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/luizm/asdf-shellcheck.git</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shfmt</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> https://github.com/luizm/asdf-shfmt.git</span></span></code></pre></div><p><code>asdf</code>를 개발하기 위한 버전들을 설치하세요:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span></span></code></pre></div><p>로컬 머신에서 개발 도구를 손상시킬 수 있는 기능을 개발 중일 경우 <code>asdf</code>를 사용하지 않는 것이 <em>좋을 수</em> 있습니다. 개발 도구들의 원본 목록입니다:</p><ul><li><a href="https://github.com/bats-core/bats-core" target="_blank" rel="noreferrer">bats-core</a>: Bash 또는 POSIX 준수 스크립트를 단위 테스트하기 위한 Bash 자동화 테스트 시스템.</li><li><a href="https://github.com/koalaman/shellcheck" target="_blank" rel="noreferrer">shellcheck</a>: 셸 스크립트 정적 분석 도구.</li><li><a href="https://github.com/mvdan/sh" target="_blank" rel="noreferrer">shfmt</a>: Bash를 지원하는 셸 parser, formatter, interpreter; shfmt 포함</li></ul><h2 id="개발" tabindex="-1">개발 <a class="header-anchor" href="#개발" aria-label="Permalink to &quot;개발&quot;">​</a></h2><p>만약 설치된 <code>asdf</code>에 영향 없이 변화들을 테스트해보시고 싶으시다면, <code>$ASDF_DIR</code> 변수를 리포지토리를 clone한 경로에 지정하시고, 그 다음 임시로 <code>bin</code>와 <code>shims</code> 디렉토리들을 경로 앞에 추가하세요.</p><p>원격 리포지토리에 커밋 혹은 push하기 전에, 당신의 코드를 format, lint, 그리고 locally test하세요. 다음 스크립트/명령어들을 사용하세요:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Lint</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/lint.bash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --check</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Fix &amp; Format</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/lint.bash</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --fix</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Test: all tests</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/test.bash</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># Test: for specific command</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">bats</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test/list_commands.bash</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">TIP</p><p><strong>테스트 추가!</strong> - 새로운 기능들과 버그 수정들의 리뷰 속도 향상을 위해 테스트들은 <strong>필수적</strong>입니다. 풀 리퀘스트 요청을 만드시기 전에 새로운 코드 경로들을 추가해주세요. <a href="https://bats-core.readthedocs.io/en/stable/index.html" target="_blank" rel="noreferrer">bats-core 문서</a> 참조</p></div><h3 id="gitignore" tabindex="-1">Gitignore <a class="header-anchor" href="#gitignore" aria-label="Permalink to &quot;Gitignore&quot;">​</a></h3><p>다음은 <code>asdf-vm/asdf</code> 리포지토리에 <code>.gitignore</code> 파일입니다. 우리는 프로젝트에 관련된 특정한 파일들을 무시합니다. 운영체제, 툴, workflows에 관련된 파일들은 글로벌 <code>.gitignore</code> 설정에서 무시되어야합니다, <a href="http://stratus3d.com/blog/2018/06/03/stop-excluding-editor-temp-files-in-gitignore/" target="_blank" rel="noreferrer">더 보기</a>.</p><p>@/../.gitignore</p><h3 id="git-blame-ignore-revs" tabindex="-1"><code>.git-blame-ignore-revs</code> <a class="header-anchor" href="#git-blame-ignore-revs" aria-label="Permalink to &quot;\`.git-blame-ignore-revs\`&quot;">​</a></h3><p><code>asdf</code>는 <code>.git-blame-ignore-revs</code> 사용해 blame 실행에서 잡음을 줄입니다. 더 많은 정보 <a href="https://git-scm.com/docs/git-blame" target="_blank" rel="noreferrer">git blame 문서</a>.</p><p>다음과 같이 <code>git blame</code>과 <code>.git-blame-ignore-revs</code>을 사용:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blame</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --ignore-revs-file</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .git-blame-ignore-revs</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> ./test/install_command.bats</span></span></code></pre></div><p>선택적으로, 수동적으로 파일을 제공하는 대신 모든 <code>blame</code>에서 해당 파일을 사용하도록 설정:</p><div class="language-sh vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">sh</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">git</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> config</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> blame.ignoreRevsFile</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> .git-blame-ignore-revs</span></span></code></pre></div><p>IDE들에서 이 파일을 사용하도록 설정할 수 있습니다. 예를 들어, VSCode를 사용하실 경우 (<a href="https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens" target="_blank" rel="noreferrer">GitLens</a>와 함께), 다음을 <code>.vscode/settings.json</code>에 추가하세요:</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  &quot;gitlens.advanced.blame.customArguments&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: [</span></span>
+<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    &quot;--ignore-revs-file&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">    &quot;.git-blame-ignore-revs&quot;</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  ]</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h2 id="bats-테스팅" tabindex="-1">Bats 테스팅 <a class="header-anchor" href="#bats-테스팅" aria-label="Permalink to &quot;Bats 테스팅&quot;">​</a></h2><p>로컬 테스트 실행:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">./scripts/test.bash</span></span></code></pre></div><p>테스트 작성 전 <strong>반드시 읽기</strong>:</p><ul><li><code>test/</code>에 존재하는 테스트들</li><li><a href="https://bats-core.readthedocs.io/en/stable/index.html" target="_blank" rel="noreferrer">bats-core 문서</a></li><li><code>scripts/test.bash</code>에 존재하는 Bats 설정들</li></ul><h3 id="bats-팁" tabindex="-1">Bats 팁 <a class="header-anchor" href="#bats-팁" aria-label="Permalink to &quot;Bats 팁&quot;">​</a></h3><p>Bats 디버깅은 때에 따라 어려울 수 있습니다. 디버깅 단순화를 위해, <code>-t</code> flag로 TAP output을 사용하여 테스트 실행 중 결과물 출력을 위한 특별한 파일 디스크립터 <code>&gt;&amp;3</code>를 사용할 수 있습니다. 예시:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># test/some_tests.bats</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">printf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;%s\\n&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Will not be printed during bats test/some_tests.bats&quot;</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">printf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;%s\\n&quot;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;Will be printed during bats -t test/some_tests.bats&quot;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &gt;&amp;3</span></span></code></pre></div><p>bats-core의 더 자세한 문서 <a href="https://bats-core.readthedocs.io/en/stable/writing-tests.html#printing-to-the-terminal" target="_blank" rel="noreferrer">Printing to the Terminal</a>.</p><h2 id="풀-리퀘스트-릴리스-관습적-커밋" tabindex="-1">풀 리퀘스트, 릴리스 &amp; 관습적 커밋 <a class="header-anchor" href="#풀-리퀘스트-릴리스-관습적-커밋" aria-label="Permalink to &quot;풀 리퀘스트, 릴리스 &amp; 관습적 커밋&quot;">​</a></h2><p><code>asdf</code>는 자동화 배포 툴 <a href="https://github.com/googleapis/release-please" target="_blank" rel="noreferrer">Release Please</a>를 사용하여 자동으로 <a href="https://semver.org/" target="_blank" rel="noreferrer">SemVer</a> 버전을 올리고 <a href="https://github.com/asdf-vm/asdf/blob/master/CHANGELOG.md" target="_blank" rel="noreferrer">변동사항</a>을 작성합니다. 이 정보들은 지난 배포들로부터 커밋 history를 읽음으로써 결정됩니다.</p><p><a href="https://www.conventionalcommits.org/" target="_blank" rel="noreferrer">유의적 커밋 메세지</a>는 기본 브랜치의 커밋 메세지 형식이 되는 풀 리퀘스트 제목의 형식을 정의합니다. 이것은 GitHub Action에서 강제됩니다 <a href="https://github.com/amannn/action-semantic-pull-request" target="_blank" rel="noreferrer"><code>amannn/action-semantic-pull-request</code></a>.</p><p>관습적인 커밋 다음 형식을 따릅니다:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>&lt;type&gt;[optional scope][optional !]: &lt;description&gt;</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>&lt;!-- examples --&gt;</span></span>
+<span class="line"><span>fix: some fix</span></span>
+<span class="line"><span>feat: a new feature</span></span>
+<span class="line"><span>docs: some documentation update</span></span>
+<span class="line"><span>docs(website): some change for the website</span></span>
+<span class="line"><span>feat!: feature with breaking change</span></span></code></pre></div><p><code>&lt;types&gt;</code>의 모든 목록: <code>feat</code>, <code>fix</code>, <code>docs</code>, <code>style</code>, <code>refactor</code>, <code>perf</code>, <code>test</code>, <code>build</code>, <code>ci</code>, <code>chore</code>, <code>revert</code>.</p><ul><li><code>!</code>: 주요한(breaking) 변화들을 나타냅니다</li><li><code>fix</code>: 새로운 SemVer <code>patch</code>을 만듭니다</li><li><code>feat</code>: 새로운 SemVer <code>minor</code>을 만듭니다</li><li><code>&lt;type&gt;!</code>: 새로운 SemVer <code>major</code>을 만듭니다</li></ul><p>풀 리퀘스트 제목은 반드시 이 형식을 따라야 합니다.</p><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>풀 리퀘스트 제목을 관습적 커밋 메세지 형식을 사용하세요.</p></div><h2 id="docker-이미지" tabindex="-1">Docker 이미지 <a class="header-anchor" href="#docker-이미지" aria-label="Permalink to &quot;Docker 이미지&quot;">​</a></h2><p><a href="https://github.com/vic/asdf-alpine" target="_blank" rel="noreferrer">asdf-alpine</a>와 <a href="https://github.com/vic/asdf-ubuntu" target="_blank" rel="noreferrer">asdf-ubuntu</a> 프로젝트들은 asdf 툴들의 Dockerized 이미지들을 제공하기 위해 진행되고있습니다. 개발 서버의 베이스 혹은 프로덕션 앱들을 위해 docker 이미지들을 사용할 수 있습니다.</p>`,47)]))}const g=a(n,[["render",l]]);export{k as __pageData,g as default};

assets/ko-kr_contribute_first-party-plugins.md.Fbk-rjdV.js

@@ -0,0 +1 @@
+import{_ as r,c as a,a2 as t,o}from"./chunks/framework.BQmytedh.js";const u=JSON.parse('{"title":"공식 플러그인","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/contribute/first-party-plugins.md","filePath":"ko-kr/contribute/first-party-plugins.md","lastUpdated":1734384735000}'),s={name:"ko-kr/contribute/first-party-plugins.md"};function i(l,e,n,d,f,c){return o(),a("div",null,e[0]||(e[0]=[t('<h1 id="공식-플러그인" tabindex="-1">공식 플러그인 <a class="header-anchor" href="#공식-플러그인" aria-label="Permalink to &quot;공식 플러그인&quot;">​</a></h1><p>asdf 코어 팀은 일상 업무 환경에서 사용되는 플러그인들을 작성해왔습니다. 이 플러그인들을 관리하고 발전시키는 도움은 언제든 환영입니다. 아래 각 링크들에서 관련된 리포지토리들을 확인하세요:</p><ul><li><a href="https://github.com/asdf-vm/asdf-elixir" target="_blank" rel="noreferrer">Elixir</a></li><li><a href="https://github.com/asdf-vm/asdf-erlang" target="_blank" rel="noreferrer">Erlang</a></li><li><a href="https://github.com/asdf-vm/asdf-nodejs" target="_blank" rel="noreferrer">Node.js</a></li><li><a href="https://github.com/asdf-vm/asdf-ruby" target="_blank" rel="noreferrer">Ruby</a></li></ul><p>커뮤니티 플러그인 보기:</p><ul><li><a href="https://github.com/asdf-community" target="_blank" rel="noreferrer"><code>asdf-community</code> 공동체</a>: <code>asdf</code> 플러그인의 장기 유지보수를 위한 공동체 주도의 프로젝트입니다.</li><li><a href="https://github.com/asdf-vm/asdf-plugins" target="_blank" rel="noreferrer"><code>asdf-plugins</code> shortname 리포지토리</a>: 인기 있는 <code>asdf</code> 플러그인 검색을 위해 <code>asdf</code> 코어가 사용하는 Short-name 목록.</li><li><a href="https://github.com/topics/asdf-plugin" target="_blank" rel="noreferrer">Github <code>asdf-plugin</code> 토픽 검색</a></li></ul>',5)]))}const h=r(s,[["render",i]]);export{u as __pageData,h as default};

assets/ko-kr_contribute_first-party-plugins.md.Fbk-rjdV.lean.js

@@ -0,0 +1 @@
+import{_ as r,c as a,a2 as t,o}from"./chunks/framework.BQmytedh.js";const u=JSON.parse('{"title":"공식 플러그인","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/contribute/first-party-plugins.md","filePath":"ko-kr/contribute/first-party-plugins.md","lastUpdated":1734384735000}'),s={name:"ko-kr/contribute/first-party-plugins.md"};function i(l,e,n,d,f,c){return o(),a("div",null,e[0]||(e[0]=[t('<h1 id="공식-플러그인" tabindex="-1">공식 플러그인 <a class="header-anchor" href="#공식-플러그인" aria-label="Permalink to &quot;공식 플러그인&quot;">​</a></h1><p>asdf 코어 팀은 일상 업무 환경에서 사용되는 플러그인들을 작성해왔습니다. 이 플러그인들을 관리하고 발전시키는 도움은 언제든 환영입니다. 아래 각 링크들에서 관련된 리포지토리들을 확인하세요:</p><ul><li><a href="https://github.com/asdf-vm/asdf-elixir" target="_blank" rel="noreferrer">Elixir</a></li><li><a href="https://github.com/asdf-vm/asdf-erlang" target="_blank" rel="noreferrer">Erlang</a></li><li><a href="https://github.com/asdf-vm/asdf-nodejs" target="_blank" rel="noreferrer">Node.js</a></li><li><a href="https://github.com/asdf-vm/asdf-ruby" target="_blank" rel="noreferrer">Ruby</a></li></ul><p>커뮤니티 플러그인 보기:</p><ul><li><a href="https://github.com/asdf-community" target="_blank" rel="noreferrer"><code>asdf-community</code> 공동체</a>: <code>asdf</code> 플러그인의 장기 유지보수를 위한 공동체 주도의 프로젝트입니다.</li><li><a href="https://github.com/asdf-vm/asdf-plugins" target="_blank" rel="noreferrer"><code>asdf-plugins</code> shortname 리포지토리</a>: 인기 있는 <code>asdf</code> 플러그인 검색을 위해 <code>asdf</code> 코어가 사용하는 Short-name 목록.</li><li><a href="https://github.com/topics/asdf-plugin" target="_blank" rel="noreferrer">Github <code>asdf-plugin</code> 토픽 검색</a></li></ul>',5)]))}const h=r(s,[["render",i]]);export{u as __pageData,h as default};

assets/ko-kr_contribute_github-actions.md.IILdesb4.js

@@ -0,0 +1 @@
+import{_ as o,c as i,j as t,a as e,o as r}from"./chunks/framework.BQmytedh.js";const p=JSON.parse('{"title":"GitHub Actions","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/contribute/github-actions.md","filePath":"ko-kr/contribute/github-actions.md","lastUpdated":1734384735000}'),n={name:"ko-kr/contribute/github-actions.md"};function s(c,a,d,u,l,b){return r(),i("div",null,a[0]||(a[0]=[t("h1",{id:"github-actions",tabindex:"-1"},[e("GitHub Actions "),t("a",{class:"header-anchor",href:"#github-actions","aria-label":'Permalink to "GitHub Actions"'},"​")],-1),t("p",null,[e("당신의 관심에 감사드리며, 존재하는 이슈들, 대화들, 그리고 기여 가이드라인을 "),t("a",{href:"https://github.com/asdf-vm/actions",target:"_blank",rel:"noreferrer"},"asdf actions 리포지토리"),e("에서 확인 해주세요.")],-1)]))}const f=o(n,[["render",s]]);export{p as __pageData,f as default};

assets/ko-kr_contribute_github-actions.md.IILdesb4.lean.js

@@ -0,0 +1 @@
+import{_ as o,c as i,j as t,a as e,o as r}from"./chunks/framework.BQmytedh.js";const p=JSON.parse('{"title":"GitHub Actions","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/contribute/github-actions.md","filePath":"ko-kr/contribute/github-actions.md","lastUpdated":1734384735000}'),n={name:"ko-kr/contribute/github-actions.md"};function s(c,a,d,u,l,b){return r(),i("div",null,a[0]||(a[0]=[t("h1",{id:"github-actions",tabindex:"-1"},[e("GitHub Actions "),t("a",{class:"header-anchor",href:"#github-actions","aria-label":'Permalink to "GitHub Actions"'},"​")],-1),t("p",null,[e("당신의 관심에 감사드리며, 존재하는 이슈들, 대화들, 그리고 기여 가이드라인을 "),t("a",{href:"https://github.com/asdf-vm/actions",target:"_blank",rel:"noreferrer"},"asdf actions 리포지토리"),e("에서 확인 해주세요.")],-1)]))}const f=o(n,[["render",s]]);export{p as __pageData,f as default};

assets/ko-kr_index.md.Dmm5J-rX.js

@@ -0,0 +1 @@
+import{_ as t,c as e,o as i}from"./chunks/framework.BQmytedh.js";const k=JSON.parse('{"title":"","description":"","frontmatter":{"layout":"home","hero":{"name":"asdf","text":"다중 런타임 버전 매니저","tagline":"한가지 툴로 모든 런타임 버전들을 관리하세요!","actions":[{"theme":"brand","text":"시작하기","link":"/ko-kr/guide/getting-started"},{"theme":"alt","text":"asdf이란?","link":"/ko-kr/guide/introduction"},{"theme":"alt","text":"GitHub에서 보기","link":"https://github.com/asdf-vm/asdf"}]},"features":[{"title":"단 한가지 도구","details":"각 프로젝트 런타임들을 단 한가지 CLI 툴과 커맨드 인터페이스로 관리.","icon":"🎉"},{"title":"플러그인","details":"런타임과 툴들의 거대한 생태계. 당신이 필요한 새로운 툴들을 더해주는 간단한 API!","icon":"🔌"},{"title":"구버전 호환","details":"원활한 마이그레이션을 위해 이미 존재하던 .nvmrc, .node-version, .ruby-version 등의 설정 파일들 지원!","icon":"⏮"},{"title":"단 하나의 설정 파일","details":"단 하나의 공유된 .tool-versions 파일로 모든 툴, 런타임, 그리고 버전들을 관리.","icon":"📄"},{"title":"셸","details":"Bash, ZSH, Fish & Elvish 자동완성 기능 지원.","icon":"🐚"},{"title":"GitHub Actions","details":"GitHub Action 설치 제공과 .tool-versions 파일을 CI/CD 워크플로우에서 활용.","icon":"🤖"}]},"headers":[],"relativePath":"ko-kr/index.md","filePath":"ko-kr/index.md","lastUpdated":1734384735000}'),o={name:"ko-kr/index.md"};function n(a,s,r,d,l,c){return i(),e("div")}const h=t(o,[["render",n]]);export{k as __pageData,h as default};

assets/ko-kr_index.md.Dmm5J-rX.lean.js

@@ -0,0 +1 @@
+import{_ as t,c as e,o as i}from"./chunks/framework.BQmytedh.js";const k=JSON.parse('{"title":"","description":"","frontmatter":{"layout":"home","hero":{"name":"asdf","text":"다중 런타임 버전 매니저","tagline":"한가지 툴로 모든 런타임 버전들을 관리하세요!","actions":[{"theme":"brand","text":"시작하기","link":"/ko-kr/guide/getting-started"},{"theme":"alt","text":"asdf이란?","link":"/ko-kr/guide/introduction"},{"theme":"alt","text":"GitHub에서 보기","link":"https://github.com/asdf-vm/asdf"}]},"features":[{"title":"단 한가지 도구","details":"각 프로젝트 런타임들을 단 한가지 CLI 툴과 커맨드 인터페이스로 관리.","icon":"🎉"},{"title":"플러그인","details":"런타임과 툴들의 거대한 생태계. 당신이 필요한 새로운 툴들을 더해주는 간단한 API!","icon":"🔌"},{"title":"구버전 호환","details":"원활한 마이그레이션을 위해 이미 존재하던 .nvmrc, .node-version, .ruby-version 등의 설정 파일들 지원!","icon":"⏮"},{"title":"단 하나의 설정 파일","details":"단 하나의 공유된 .tool-versions 파일로 모든 툴, 런타임, 그리고 버전들을 관리.","icon":"📄"},{"title":"셸","details":"Bash, ZSH, Fish & Elvish 자동완성 기능 지원.","icon":"🐚"},{"title":"GitHub Actions","details":"GitHub Action 설치 제공과 .tool-versions 파일을 CI/CD 워크플로우에서 활용.","icon":"🤖"}]},"headers":[],"relativePath":"ko-kr/index.md","filePath":"ko-kr/index.md","lastUpdated":1734384735000}'),o={name:"ko-kr/index.md"};function n(a,s,r,d,l,c){return i(),e("div")}const h=t(o,[["render",n]]);export{k as __pageData,h as default};

assets/ko-kr_manage_commands.md.BnsPzg1t.js

@@ -0,0 +1,66 @@
+import{_ as a,c as n,a2 as e,o as p}from"./chunks/framework.BQmytedh.js";const f=JSON.parse('{"title":"모든 명령어","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/manage/commands.md","filePath":"ko-kr/manage/commands.md","lastUpdated":1734384735000}'),l={name:"ko-kr/manage/commands.md"};function t(i,s,o,c,r,d){return p(),n("div",null,s[0]||(s[0]=[e(`<h1 id="모든-명령어" tabindex="-1">모든 명령어 <a class="header-anchor" href="#모든-명령어" aria-label="Permalink to &quot;모든 명령어&quot;">​</a></h1><p>다음 목록은 <code>asdf</code>에서 이용가능한 모든 명령어들입니다. 해당 목록은 <code>asdf help</code> 명령어를 통해 확인가능합니다.</p><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>MANAGE PLUGINS</span></span>
+<span class="line"><span>asdf plugin add &lt;name&gt; [&lt;git-url&gt;]      Add a plugin from the plugin repo OR,</span></span>
+<span class="line"><span>                                        add a Git repo as a plugin by</span></span>
+<span class="line"><span>                                        specifying the name and repo url</span></span>
+<span class="line"><span>asdf plugin list [--urls] [--refs]      List installed plugins. Optionally show</span></span>
+<span class="line"><span>                                        git urls and git-ref</span></span>
+<span class="line"><span>asdf plugin list all                    List plugins registered on asdf-plugins</span></span>
+<span class="line"><span>                                        repository with URLs</span></span>
+<span class="line"><span>asdf plugin remove &lt;name&gt;               Remove plugin and package versions</span></span>
+<span class="line"><span>asdf plugin update &lt;name&gt; [&lt;git-ref&gt;]   Update a plugin to latest commit on</span></span>
+<span class="line"><span>                                        default branch or a particular git-ref</span></span>
+<span class="line"><span>asdf plugin update --all                Update all plugins to latest commit on</span></span>
+<span class="line"><span>                                        default branch</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>MANAGE PACKAGES</span></span>
+<span class="line"><span>asdf current                            Display current version set or being</span></span>
+<span class="line"><span>                                        used for all packages</span></span>
+<span class="line"><span>asdf current &lt;name&gt;                     Display current version set or being</span></span>
+<span class="line"><span>                                        used for package</span></span>
+<span class="line"><span>asdf global &lt;name&gt; &lt;version&gt;            Set the package global version</span></span>
+<span class="line"><span>asdf global &lt;name&gt; latest[:&lt;version&gt;]   Set the package global version to the</span></span>
+<span class="line"><span>                                        latest provided version</span></span>
+<span class="line"><span>asdf help &lt;name&gt; [&lt;version&gt;]            Output documentation for plugin and tool</span></span>
+<span class="line"><span>asdf install                            Install all the package versions listed</span></span>
+<span class="line"><span>                                        in the .tool-versions file</span></span>
+<span class="line"><span>asdf install &lt;name&gt;                     Install one tool at the version</span></span>
+<span class="line"><span>                                        specified in the .tool-versions file</span></span>
+<span class="line"><span>asdf install &lt;name&gt; &lt;version&gt;           Install a specific version of a package</span></span>
+<span class="line"><span>asdf install &lt;name&gt; latest[:&lt;version&gt;]  Install the latest stable version of a</span></span>
+<span class="line"><span>                                        package, or with optional version,</span></span>
+<span class="line"><span>                                        install the latest stable version that</span></span>
+<span class="line"><span>                                        begins with the given string</span></span>
+<span class="line"><span>asdf latest &lt;name&gt; [&lt;version&gt;]          Show latest stable version of a package</span></span>
+<span class="line"><span>asdf latest --all                       Show latest stable version of all the</span></span>
+<span class="line"><span>                                        packages and if they are installed</span></span>
+<span class="line"><span>asdf list &lt;name&gt; [version]              List installed versions of a package and</span></span>
+<span class="line"><span>                                        optionally filter the versions</span></span>
+<span class="line"><span>asdf list all &lt;name&gt; [&lt;version&gt;]        List all versions of a package and</span></span>
+<span class="line"><span>                                        optionally filter the returned versions</span></span>
+<span class="line"><span>asdf local &lt;name&gt; &lt;version&gt;             Set the package local version</span></span>
+<span class="line"><span>asdf local &lt;name&gt; latest[:&lt;version&gt;]    Set the package local version to the</span></span>
+<span class="line"><span>                                        latest provided version</span></span>
+<span class="line"><span>asdf shell &lt;name&gt; &lt;version&gt;             Set the package version to</span></span>
+<span class="line"><span>                                        \`ASDF_\${LANG}_VERSION\` in the current shell</span></span>
+<span class="line"><span>asdf uninstall &lt;name&gt; &lt;version&gt;         Remove a specific version of a package</span></span>
+<span class="line"><span>asdf where &lt;name&gt; [&lt;version&gt;]           Display install path for an installed</span></span>
+<span class="line"><span>                                        or current version</span></span>
+<span class="line"><span>asdf which &lt;command&gt;                    Display the path to an executable</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>UTILS</span></span>
+<span class="line"><span>asdf exec &lt;command&gt; [args...]           Executes the command shim for current version</span></span>
+<span class="line"><span>asdf env &lt;command&gt; [util]               Runs util (default: \`env\`) inside the</span></span>
+<span class="line"><span>                                        environment used for command shim execution.</span></span>
+<span class="line"><span>asdf info                               Print OS, Shell and ASDF debug information.</span></span>
+<span class="line"><span>asdf version                            Print the currently installed version of ASDF</span></span>
+<span class="line"><span>asdf reshim &lt;name&gt; &lt;version&gt;            Recreate shims for version of a package</span></span>
+<span class="line"><span>asdf shim-versions &lt;command&gt;            List the plugins and versions that</span></span>
+<span class="line"><span>                                        provide a command</span></span>
+<span class="line"><span>asdf update                             Update asdf to the latest stable release</span></span>
+<span class="line"><span>asdf update --head                      Update asdf to the latest on the master branch</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>RESOURCES</span></span>
+<span class="line"><span>GitHub: https://github.com/asdf-vm/asdf</span></span>
+<span class="line"><span>Docs:   https://asdf-vm.com</span></span></code></pre></div>`,3)]))}const m=a(l,[["render",t]]);export{f as __pageData,m as default};

assets/ko-kr_manage_commands.md.BnsPzg1t.lean.js

@@ -0,0 +1,66 @@
+import{_ as a,c as n,a2 as e,o as p}from"./chunks/framework.BQmytedh.js";const f=JSON.parse('{"title":"모든 명령어","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/manage/commands.md","filePath":"ko-kr/manage/commands.md","lastUpdated":1734384735000}'),l={name:"ko-kr/manage/commands.md"};function t(i,s,o,c,r,d){return p(),n("div",null,s[0]||(s[0]=[e(`<h1 id="모든-명령어" tabindex="-1">모든 명령어 <a class="header-anchor" href="#모든-명령어" aria-label="Permalink to &quot;모든 명령어&quot;">​</a></h1><p>다음 목록은 <code>asdf</code>에서 이용가능한 모든 명령어들입니다. 해당 목록은 <code>asdf help</code> 명령어를 통해 확인가능합니다.</p><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>MANAGE PLUGINS</span></span>
+<span class="line"><span>asdf plugin add &lt;name&gt; [&lt;git-url&gt;]      Add a plugin from the plugin repo OR,</span></span>
+<span class="line"><span>                                        add a Git repo as a plugin by</span></span>
+<span class="line"><span>                                        specifying the name and repo url</span></span>
+<span class="line"><span>asdf plugin list [--urls] [--refs]      List installed plugins. Optionally show</span></span>
+<span class="line"><span>                                        git urls and git-ref</span></span>
+<span class="line"><span>asdf plugin list all                    List plugins registered on asdf-plugins</span></span>
+<span class="line"><span>                                        repository with URLs</span></span>
+<span class="line"><span>asdf plugin remove &lt;name&gt;               Remove plugin and package versions</span></span>
+<span class="line"><span>asdf plugin update &lt;name&gt; [&lt;git-ref&gt;]   Update a plugin to latest commit on</span></span>
+<span class="line"><span>                                        default branch or a particular git-ref</span></span>
+<span class="line"><span>asdf plugin update --all                Update all plugins to latest commit on</span></span>
+<span class="line"><span>                                        default branch</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>MANAGE PACKAGES</span></span>
+<span class="line"><span>asdf current                            Display current version set or being</span></span>
+<span class="line"><span>                                        used for all packages</span></span>
+<span class="line"><span>asdf current &lt;name&gt;                     Display current version set or being</span></span>
+<span class="line"><span>                                        used for package</span></span>
+<span class="line"><span>asdf global &lt;name&gt; &lt;version&gt;            Set the package global version</span></span>
+<span class="line"><span>asdf global &lt;name&gt; latest[:&lt;version&gt;]   Set the package global version to the</span></span>
+<span class="line"><span>                                        latest provided version</span></span>
+<span class="line"><span>asdf help &lt;name&gt; [&lt;version&gt;]            Output documentation for plugin and tool</span></span>
+<span class="line"><span>asdf install                            Install all the package versions listed</span></span>
+<span class="line"><span>                                        in the .tool-versions file</span></span>
+<span class="line"><span>asdf install &lt;name&gt;                     Install one tool at the version</span></span>
+<span class="line"><span>                                        specified in the .tool-versions file</span></span>
+<span class="line"><span>asdf install &lt;name&gt; &lt;version&gt;           Install a specific version of a package</span></span>
+<span class="line"><span>asdf install &lt;name&gt; latest[:&lt;version&gt;]  Install the latest stable version of a</span></span>
+<span class="line"><span>                                        package, or with optional version,</span></span>
+<span class="line"><span>                                        install the latest stable version that</span></span>
+<span class="line"><span>                                        begins with the given string</span></span>
+<span class="line"><span>asdf latest &lt;name&gt; [&lt;version&gt;]          Show latest stable version of a package</span></span>
+<span class="line"><span>asdf latest --all                       Show latest stable version of all the</span></span>
+<span class="line"><span>                                        packages and if they are installed</span></span>
+<span class="line"><span>asdf list &lt;name&gt; [version]              List installed versions of a package and</span></span>
+<span class="line"><span>                                        optionally filter the versions</span></span>
+<span class="line"><span>asdf list all &lt;name&gt; [&lt;version&gt;]        List all versions of a package and</span></span>
+<span class="line"><span>                                        optionally filter the returned versions</span></span>
+<span class="line"><span>asdf local &lt;name&gt; &lt;version&gt;             Set the package local version</span></span>
+<span class="line"><span>asdf local &lt;name&gt; latest[:&lt;version&gt;]    Set the package local version to the</span></span>
+<span class="line"><span>                                        latest provided version</span></span>
+<span class="line"><span>asdf shell &lt;name&gt; &lt;version&gt;             Set the package version to</span></span>
+<span class="line"><span>                                        \`ASDF_\${LANG}_VERSION\` in the current shell</span></span>
+<span class="line"><span>asdf uninstall &lt;name&gt; &lt;version&gt;         Remove a specific version of a package</span></span>
+<span class="line"><span>asdf where &lt;name&gt; [&lt;version&gt;]           Display install path for an installed</span></span>
+<span class="line"><span>                                        or current version</span></span>
+<span class="line"><span>asdf which &lt;command&gt;                    Display the path to an executable</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>UTILS</span></span>
+<span class="line"><span>asdf exec &lt;command&gt; [args...]           Executes the command shim for current version</span></span>
+<span class="line"><span>asdf env &lt;command&gt; [util]               Runs util (default: \`env\`) inside the</span></span>
+<span class="line"><span>                                        environment used for command shim execution.</span></span>
+<span class="line"><span>asdf info                               Print OS, Shell and ASDF debug information.</span></span>
+<span class="line"><span>asdf version                            Print the currently installed version of ASDF</span></span>
+<span class="line"><span>asdf reshim &lt;name&gt; &lt;version&gt;            Recreate shims for version of a package</span></span>
+<span class="line"><span>asdf shim-versions &lt;command&gt;            List the plugins and versions that</span></span>
+<span class="line"><span>                                        provide a command</span></span>
+<span class="line"><span>asdf update                             Update asdf to the latest stable release</span></span>
+<span class="line"><span>asdf update --head                      Update asdf to the latest on the master branch</span></span>
+<span class="line"><span></span></span>
+<span class="line"><span>RESOURCES</span></span>
+<span class="line"><span>GitHub: https://github.com/asdf-vm/asdf</span></span>
+<span class="line"><span>Docs:   https://asdf-vm.com</span></span></code></pre></div>`,3)]))}const m=a(l,[["render",t]]);export{f as __pageData,m as default};

assets/ko-kr_manage_plugins.md.BStZ_uo9.js

@@ -0,0 +1,11 @@
+import{_ as a,c as i,a2 as l,o as e}from"./chunks/framework.BQmytedh.js";const g=JSON.parse('{"title":"플러그인","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/manage/plugins.md","filePath":"ko-kr/manage/plugins.md","lastUpdated":1734384735000}'),t={name:"ko-kr/manage/plugins.md"};function n(h,s,p,d,k,r){return e(),i("div",null,s[0]||(s[0]=[l(`<h1 id="플러그인" tabindex="-1">플러그인 <a class="header-anchor" href="#플러그인" aria-label="Permalink to &quot;플러그인&quot;">​</a></h1><p>플로그인들은 <code>asdf</code>가 Node.js, Ruby, Elixir 등 여러가지 툴들을 취급하는 방법입니다.</p><p>더 많은 툴들 지원을 위한 플러그인 API는 <a href="/ko-kr/plugins/create.html">플러그인 생성하기</a> 참고하세요.</p><h2 id="추가하기" tabindex="-1">추가하기 <a class="header-anchor" href="#추가하기" aria-label="Permalink to &quot;추가하기&quot;">​</a></h2><p>Git URL로 플러그인 추가하기:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">git-ur</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">l</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin add elm https://github.com/vic/asdf-elm</span></span></code></pre></div><p>또는 플러그인 리포지토리에 short-name을 통해 추가하기:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin add erlang</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">추천</p><p>short-name 리포지토리에 독립적인 긴 <code>git-url</code> 방식이 선호됩니다.</p></div><h2 id="설치된-목록" tabindex="-1">설치된 목록 <a class="header-anchor" href="#설치된-목록" aria-label="Permalink to &quot;설치된 목록&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin list</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># java</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs</span></span></code></pre></div><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --urls</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin list</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># java            https://github.com/halcyon/asdf-java.git</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs          https://github.com/asdf-vm/asdf-nodejs.git</span></span></code></pre></div><h2 id="모든-short-name-리포지토리-목록" tabindex="-1">모든 Short-name 리포지토리 목록 <a class="header-anchor" href="#모든-short-name-리포지토리-목록" aria-label="Permalink to &quot;모든 Short-name 리포지토리 목록&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span></span></code></pre></div><p>플러그인들의 전체 short-name 목록을 <a href="https://github.com/asdf-vm/asdf-plugins" target="_blank" rel="noreferrer">플러그인 Shortname 인덱스</a>에서 확인하세요.</p><h2 id="업데이트" tabindex="-1">업데이트 <a class="header-anchor" href="#업데이트" aria-label="Permalink to &quot;업데이트&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --all</span></span></code></pre></div><p>특정 패키지를 업데이트하고 싶다면, 다음 명령어를 사용하세요.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin update erlang</span></span></code></pre></div><p>이 명령어는 해당 플러그인 리포지토리의 <em>origin</em> <em>기본 브랜치</em> 의 <em>가장 최근 커밋</em> 을 fetch합니다. 버전화된 플러그인들과 업데이트들은 현재 개발 진행중 입니다 (<a href="https://github.com/asdf-vm/asdf/pull/916" target="_blank" rel="noreferrer">#916</a>).</p><h2 id="제거" tabindex="-1">제거 <a class="header-anchor" href="#제거" aria-label="Permalink to &quot;제거&quot;">​</a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> remove</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin remove erlang</span></span></code></pre></div><p>플러그인 제거는 해당 툴과 관련된 모든 것을 제거합니다. 이것은 한 툴의 미사용중인 많은 버전들의 cleaning/pruning에 유용합니다.</p><h2 id="asdf-short-name-리포지토리-동기화" tabindex="-1">asdf Short-name 리포지토리 동기화 <a class="header-anchor" href="#asdf-short-name-리포지토리-동기화" aria-label="Permalink to &quot;asdf Short-name 리포지토리 동기화&quot;">​</a></h2><p>Short-name 리포지토리는 로컬 머신에 주기적으로 동기화됩니다. 동기화 방식들로 다음 방식들이 있습니다:</p><ul><li>명령어들에 의한 동기화 이벤트: <ul><li><code>asdf plugin add &lt;name&gt;</code></li><li><code>asdf plugin list all</code></li></ul></li><li>만약 <code>disable_plugin_short_name_repository</code> 설정 옵션이 <code>yes</code>로 설정되어 있다면, 동기화는 조기 종료됩니다. <a href="/ko-kr/manage/configuration.html">asdf 설정 문서</a>에서 더보기.</li><li>만약 동기화가 지난 <code>X</code>분 동안 진행되지 않았다면, 동기화가 진행됩니다. <ul><li><code>X</code>의 기본값은 <code>60</code>입니다만, <code>.asdfrc</code>의 <code>plugin_repository_last_check_duration</code> 옵션을 통해 설정될 수 있습니다. <a href="/ko-kr/manage/configuration.html">asdf 설정 문서</a>에서 더보기.</li></ul></li></ul>`,26)]))}const c=a(t,[["render",n]]);export{g as __pageData,c as default};

assets/ko-kr_manage_plugins.md.BStZ_uo9.lean.js

@@ -0,0 +1,11 @@
+import{_ as a,c as i,a2 as l,o as e}from"./chunks/framework.BQmytedh.js";const g=JSON.parse('{"title":"플러그인","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/manage/plugins.md","filePath":"ko-kr/manage/plugins.md","lastUpdated":1734384735000}'),t={name:"ko-kr/manage/plugins.md"};function n(h,s,p,d,k,r){return e(),i("div",null,s[0]||(s[0]=[l(`<h1 id="플러그인" tabindex="-1">플러그인 <a class="header-anchor" href="#플러그인" aria-label="Permalink to &quot;플러그인&quot;">​</a></h1><p>플로그인들은 <code>asdf</code>가 Node.js, Ruby, Elixir 등 여러가지 툴들을 취급하는 방법입니다.</p><p>더 많은 툴들 지원을 위한 플러그인 API는 <a href="/ko-kr/plugins/create.html">플러그인 생성하기</a> 참고하세요.</p><h2 id="추가하기" tabindex="-1">추가하기 <a class="header-anchor" href="#추가하기" aria-label="Permalink to &quot;추가하기&quot;">​</a></h2><p>Git URL로 플러그인 추가하기:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">git-ur</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">l</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin add elm https://github.com/vic/asdf-elm</span></span></code></pre></div><p>또는 플러그인 리포지토리에 short-name을 통해 추가하기:</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> add</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin add erlang</span></span></code></pre></div><div class="tip custom-block"><p class="custom-block-title">추천</p><p>short-name 리포지토리에 독립적인 긴 <code>git-url</code> 방식이 선호됩니다.</p></div><h2 id="설치된-목록" tabindex="-1">설치된 목록 <a class="header-anchor" href="#설치된-목록" aria-label="Permalink to &quot;설치된 목록&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin list</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># java</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs</span></span></code></pre></div><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --urls</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin list</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># java            https://github.com/halcyon/asdf-java.git</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs          https://github.com/asdf-vm/asdf-nodejs.git</span></span></code></pre></div><h2 id="모든-short-name-리포지토리-목록" tabindex="-1">모든 Short-name 리포지토리 목록 <a class="header-anchor" href="#모든-short-name-리포지토리-목록" aria-label="Permalink to &quot;모든 Short-name 리포지토리 목록&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span></span></code></pre></div><p>플러그인들의 전체 short-name 목록을 <a href="https://github.com/asdf-vm/asdf-plugins" target="_blank" rel="noreferrer">플러그인 Shortname 인덱스</a>에서 확인하세요.</p><h2 id="업데이트" tabindex="-1">업데이트 <a class="header-anchor" href="#업데이트" aria-label="Permalink to &quot;업데이트&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --all</span></span></code></pre></div><p>특정 패키지를 업데이트하고 싶다면, 다음 명령어를 사용하세요.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> update</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin update erlang</span></span></code></pre></div><p>이 명령어는 해당 플러그인 리포지토리의 <em>origin</em> <em>기본 브랜치</em> 의 <em>가장 최근 커밋</em> 을 fetch합니다. 버전화된 플러그인들과 업데이트들은 현재 개발 진행중 입니다 (<a href="https://github.com/asdf-vm/asdf/pull/916" target="_blank" rel="noreferrer">#916</a>).</p><h2 id="제거" tabindex="-1">제거 <a class="header-anchor" href="#제거" aria-label="Permalink to &quot;제거&quot;">​</a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plugin</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> remove</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf plugin remove erlang</span></span></code></pre></div><p>플러그인 제거는 해당 툴과 관련된 모든 것을 제거합니다. 이것은 한 툴의 미사용중인 많은 버전들의 cleaning/pruning에 유용합니다.</p><h2 id="asdf-short-name-리포지토리-동기화" tabindex="-1">asdf Short-name 리포지토리 동기화 <a class="header-anchor" href="#asdf-short-name-리포지토리-동기화" aria-label="Permalink to &quot;asdf Short-name 리포지토리 동기화&quot;">​</a></h2><p>Short-name 리포지토리는 로컬 머신에 주기적으로 동기화됩니다. 동기화 방식들로 다음 방식들이 있습니다:</p><ul><li>명령어들에 의한 동기화 이벤트: <ul><li><code>asdf plugin add &lt;name&gt;</code></li><li><code>asdf plugin list all</code></li></ul></li><li>만약 <code>disable_plugin_short_name_repository</code> 설정 옵션이 <code>yes</code>로 설정되어 있다면, 동기화는 조기 종료됩니다. <a href="/ko-kr/manage/configuration.html">asdf 설정 문서</a>에서 더보기.</li><li>만약 동기화가 지난 <code>X</code>분 동안 진행되지 않았다면, 동기화가 진행됩니다. <ul><li><code>X</code>의 기본값은 <code>60</code>입니다만, <code>.asdfrc</code>의 <code>plugin_repository_last_check_duration</code> 옵션을 통해 설정될 수 있습니다. <a href="/ko-kr/manage/configuration.html">asdf 설정 문서</a>에서 더보기.</li></ul></li></ul>`,26)]))}const c=a(t,[["render",n]]);export{g as __pageData,c as default};

assets/ko-kr_manage_versions.md.CMPcUJSc.js

@@ -0,0 +1,30 @@
+import{_ as i,c as a,a2 as l,o as h}from"./chunks/framework.BQmytedh.js";const o=JSON.parse('{"title":"버전","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/manage/versions.md","filePath":"ko-kr/manage/versions.md","lastUpdated":1734384735000}'),t={name:"ko-kr/manage/versions.md"};function n(e,s,p,k,d,r){return h(),a("div",null,s[0]||(s[0]=[l(`<h1 id="버전" tabindex="-1">버전 <a class="header-anchor" href="#버전" aria-label="Permalink to &quot;버전&quot;">​</a></h1><h2 id="버전-설치" tabindex="-1">버전 설치 <a class="header-anchor" href="#버전-설치" aria-label="Permalink to &quot;버전 설치&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf install erlang 17.3</span></span></code></pre></div><p>플러그인이 소스에서 다운로드 &amp; 컴파일을 지원하는 경우, <code>ref:foo</code>를 지정할 수 있으며 여기서 <code>foo</code>는 특정 브랜치, 태그 또는 커밋입니다. 제거할 때도 동일한 이름과 참조를 사용해야 합니다.</p><h2 id="최신-안정-버전-설치" tabindex="-1">최신 안정 버전 설치 <a class="header-anchor" href="#최신-안정-버전-설치" aria-label="Permalink to &quot;최신 안정 버전 설치&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf install erlang latest</span></span></code></pre></div><p>주어진 문자열로 시작하는 최신 안정 버전을 설치합니다.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest:</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf install erlang latest:17</span></span></code></pre></div><h2 id="설치된-버전-목록" tabindex="-1">설치된 버전 목록 <a class="header-anchor" href="#설치된-버전-목록" aria-label="Permalink to &quot;설치된 버전 목록&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list erlang</span></span></code></pre></div><p>주어진 문자열로 시작하는 버전으로 필터링합니다.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list erlang 17</span></span></code></pre></div><h2 id="사용-가능한-모든-버전-목록" tabindex="-1">사용 가능한 모든 버전 목록 <a class="header-anchor" href="#사용-가능한-모든-버전-목록" aria-label="Permalink to &quot;사용 가능한 모든 버전 목록&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list all erlang</span></span></code></pre></div><p>주어진 문자열로 시작하는 버전으로 필터링합니다.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list all erlang 17</span></span></code></pre></div><h2 id="최신-안정-버전-보기" tabindex="-1">최신 안정 버전 보기 <a class="header-anchor" href="#최신-안정-버전-보기" aria-label="Permalink to &quot;최신 안정 버전 보기&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf latest erlang</span></span></code></pre></div><p>주어진 문자열로 시작하는 최신 안정 버전을 보여줍니다.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf latest erlang 17</span></span></code></pre></div><h2 id="현재-버전-설정" tabindex="-1">현재 버전 설정 <a id="현재-버전-설정"></a> <a class="header-anchor" href="#현재-버전-설정" aria-label="Permalink to &quot;현재 버전 설정 &lt;a id=&#39;현재-버전-설정&#39;&gt;&lt;/a&gt;&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> global</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [&lt;version&gt;...]</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shell</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [&lt;version&gt;...]</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> local</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [&lt;version&gt;...]</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf global elixir 1.2.4</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> global</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest[:</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">]</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> local</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest[:</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">]</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf global elixir latest</span></span></code></pre></div><p><code>global</code>은 해당 버전을 <code>$HOME/.tool-versions</code>에 작성합니다.</p><p>현재 셸 세션에 대해서만, <code>shell</code>은 <code>ASDF_\${TOOL}_VERSION</code>이라는 이름의 환경 변수로 버전을 설정합니다.</p><p><code>local</code>은 해당 버전을 <code>$PWD/.tool-versions</code>에 작성합니다, 존재하지 않을 시에 새로 만듦.</p><p>세부 내용은 <code>.tool-versions</code> <a href="/ko-kr/manage/configuration.html">설정 섹션에 파일</a>을 참고하세요.</p><div class="warning custom-block"><p class="custom-block-title">대체수단</p><p>현재 셸 세션에 대해서만 버전을 설정하려는 경우 또는 특정 툴 버전 하에 단순히 한개의 명령어만 실행하기 위해, 당신은 <code>ASDF_\${TOOL}_VERSION</code>과 같은 환경 변수를 설정할 수 있습니다.</p></div><p>다음 예시에서는 버전 <code>1.4.0</code>의 Elixir 프로젝트에서 테스트를 수행합니다. 버전 형식은 <code>.tool-versions</code> 파일에서 지원되는 것과 동일하게 지원됩니다.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">ASDF_ELIXIR_VERSION</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">1.4.0</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> mix</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test</span></span></code></pre></div><h2 id="시스템-버전으로의-폴백" tabindex="-1">시스템 버전으로의 폴백 <a class="header-anchor" href="#시스템-버전으로의-폴백" aria-label="Permalink to &quot;시스템 버전으로의 폴백&quot;">​</a></h2><p>asdf 관리 버전이 아닌 <code>&lt;name&gt;</code> 도구의 시스템 버전을 사용하려면 도구의 버전을 <code>system</code>으로 설정할 수 있습니다.</p><p>위에 <a href="#현재-버전-설정">현재 버전 설정</a> 섹션에 나와있는대로, <code>system</code>을 <code>global</code>, <code>local</code> or <code>shell</code> 중에 하나로 설정하세요.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> local</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> system</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf local python system</span></span></code></pre></div><h2 id="현재-버전-보기" tabindex="-1">현재 버전 보기 <a class="header-anchor" href="#현재-버전-보기" aria-label="Permalink to &quot;현재 버전 보기&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> current</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf current</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># erlang          17.3          /Users/kim/.tool-versions</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs          6.11.5        /Users/kim/cool-node-project/.tool-versions</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> current</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf current erlang</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># erlang          17.3          /Users/kim/.tool-versions</span></span></code></pre></div><h2 id="버전-제거" tabindex="-1">버전 제거 <a class="header-anchor" href="#버전-제거" aria-label="Permalink to &quot;버전 제거&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> uninstall</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf uninstall erlang 17.3</span></span></code></pre></div><h2 id="shims" tabindex="-1">Shims <a class="header-anchor" href="#shims" aria-label="Permalink to &quot;Shims&quot;">​</a></h2><p>asdf는 패키지를 설치할 때 해당 패키지의 모든 실행 프로그램에 대한 shim들을 <code>$ASDF_DATA_DIR/shims</code> 디렉토리 (기본값은 <code>~/.asdf/shims</code>)에 생성합니다. 이 디렉토리는 설치된 프로그램들이 이용가능하도록 <code>$PATH</code> (<code>asdf.sh</code>, <code>asdf.fish</code> 등)에 존재합니다.</p><p>Shim 자체는 플러그인 이름과 shim이 감싸고 있는 설치된 패키지의 실행파일의 경로를 넘겨주는 <code>asdf exec</code>라는 헬퍼 프로그램을 <code>exec</code>시키는 매우 단순한 wrapper입니다.</p><p><code>asdf exec</code> 헬퍼는 (<code>.tool-version</code> 파일에 지정된 대로, <code>asdf local...</code> 또는 <code>asdf global...</code>에서 선택된 대로) 사용할 패키지의 버전을 결정합니다, (플러그인의 <code>exec-path</code> 콜백에 의해 조정될 수 있음) 패키지 설치 디렉토리의 실행 파일에 대한 최종 경로 및 (플러그인에 의해 제공된 - <code>exec-env</code> 스크립트) 실행할 환경을 결정하고, 최종적으로 이를 실행합니다.</p><div class="warning custom-block"><p class="custom-block-title">노트</p><p>이 시스템은 <code>exec</code> 호출을 사용하기 때문에, 실행 대신 셸에 의해 source 되야하는 패키지의 스크립트는 shim wrapper를 통하지 않고 직접 액세스되야 합니다. 두 가지 <code>asdf</code> 명령어: <code>which</code>와 <code>where</code>는 설치된 패키지로의 경로를 반환할 수 있습니다:</p></div><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># returns path to main executable in current version</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">source</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> $(</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> which</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> \${PLUGIN})</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/../script.sh</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># returns path to the package installation directory</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">source</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> $(</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> where</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> \${PLUGIN})</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/bin/script.sh</span></span></code></pre></div><h3 id="asdf-shims-우회" tabindex="-1">asdf shims 우회 <a class="header-anchor" href="#asdf-shims-우회" aria-label="Permalink to &quot;asdf shims 우회&quot;">​</a></h3><p>어떠한 이유로 asdf의 shim들을 우회하고 싶거나 프로젝트의 디렉토리로 이동했을 때 자동으로 환경 변수를 설정되게 하고 싶으시면 <a href="https://github.com/asdf-community/asdf-direnv" target="_blank" rel="noreferrer">asdf-direnv</a> 플러그인이 도움이 될 것입니다. 상세한 내용은 README를 확인해 주세요.</p>`,45)]))}const c=i(t,[["render",n]]);export{o as __pageData,c as default};

assets/ko-kr_manage_versions.md.CMPcUJSc.lean.js

@@ -0,0 +1,30 @@
+import{_ as i,c as a,a2 as l,o as h}from"./chunks/framework.BQmytedh.js";const o=JSON.parse('{"title":"버전","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/manage/versions.md","filePath":"ko-kr/manage/versions.md","lastUpdated":1734384735000}'),t={name:"ko-kr/manage/versions.md"};function n(e,s,p,k,d,r){return h(),a("div",null,s[0]||(s[0]=[l(`<h1 id="버전" tabindex="-1">버전 <a class="header-anchor" href="#버전" aria-label="Permalink to &quot;버전&quot;">​</a></h1><h2 id="버전-설치" tabindex="-1">버전 설치 <a class="header-anchor" href="#버전-설치" aria-label="Permalink to &quot;버전 설치&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf install erlang 17.3</span></span></code></pre></div><p>플러그인이 소스에서 다운로드 &amp; 컴파일을 지원하는 경우, <code>ref:foo</code>를 지정할 수 있으며 여기서 <code>foo</code>는 특정 브랜치, 태그 또는 커밋입니다. 제거할 때도 동일한 이름과 참조를 사용해야 합니다.</p><h2 id="최신-안정-버전-설치" tabindex="-1">최신 안정 버전 설치 <a class="header-anchor" href="#최신-안정-버전-설치" aria-label="Permalink to &quot;최신 안정 버전 설치&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf install erlang latest</span></span></code></pre></div><p>주어진 문자열로 시작하는 최신 안정 버전을 설치합니다.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> install</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest:</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf install erlang latest:17</span></span></code></pre></div><h2 id="설치된-버전-목록" tabindex="-1">설치된 버전 목록 <a class="header-anchor" href="#설치된-버전-목록" aria-label="Permalink to &quot;설치된 버전 목록&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list erlang</span></span></code></pre></div><p>주어진 문자열로 시작하는 버전으로 필터링합니다.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list erlang 17</span></span></code></pre></div><h2 id="사용-가능한-모든-버전-목록" tabindex="-1">사용 가능한 모든 버전 목록 <a class="header-anchor" href="#사용-가능한-모든-버전-목록" aria-label="Permalink to &quot;사용 가능한 모든 버전 목록&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list all erlang</span></span></code></pre></div><p>주어진 문자열로 시작하는 버전으로 필터링합니다.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> list</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> all</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf list all erlang 17</span></span></code></pre></div><h2 id="최신-안정-버전-보기" tabindex="-1">최신 안정 버전 보기 <a class="header-anchor" href="#최신-안정-버전-보기" aria-label="Permalink to &quot;최신 안정 버전 보기&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf latest erlang</span></span></code></pre></div><p>주어진 문자열로 시작하는 최신 안정 버전을 보여줍니다.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf latest erlang 17</span></span></code></pre></div><h2 id="현재-버전-설정" tabindex="-1">현재 버전 설정 <a id="현재-버전-설정"></a> <a class="header-anchor" href="#현재-버전-설정" aria-label="Permalink to &quot;현재 버전 설정 &lt;a id=&#39;현재-버전-설정&#39;&gt;&lt;/a&gt;&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> global</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [&lt;version&gt;...]</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> shell</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [&lt;version&gt;...]</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> local</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> [&lt;version&gt;...]</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf global elixir 1.2.4</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> global</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest[:</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">]</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> local</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> latest[:</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">]</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf global elixir latest</span></span></code></pre></div><p><code>global</code>은 해당 버전을 <code>$HOME/.tool-versions</code>에 작성합니다.</p><p>현재 셸 세션에 대해서만, <code>shell</code>은 <code>ASDF_\${TOOL}_VERSION</code>이라는 이름의 환경 변수로 버전을 설정합니다.</p><p><code>local</code>은 해당 버전을 <code>$PWD/.tool-versions</code>에 작성합니다, 존재하지 않을 시에 새로 만듦.</p><p>세부 내용은 <code>.tool-versions</code> <a href="/ko-kr/manage/configuration.html">설정 섹션에 파일</a>을 참고하세요.</p><div class="warning custom-block"><p class="custom-block-title">대체수단</p><p>현재 셸 세션에 대해서만 버전을 설정하려는 경우 또는 특정 툴 버전 하에 단순히 한개의 명령어만 실행하기 위해, 당신은 <code>ASDF_\${TOOL}_VERSION</code>과 같은 환경 변수를 설정할 수 있습니다.</p></div><p>다음 예시에서는 버전 <code>1.4.0</code>의 Elixir 프로젝트에서 테스트를 수행합니다. 버전 형식은 <code>.tool-versions</code> 파일에서 지원되는 것과 동일하게 지원됩니다.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">ASDF_ELIXIR_VERSION</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">=</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">1.4.0</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> mix</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> test</span></span></code></pre></div><h2 id="시스템-버전으로의-폴백" tabindex="-1">시스템 버전으로의 폴백 <a class="header-anchor" href="#시스템-버전으로의-폴백" aria-label="Permalink to &quot;시스템 버전으로의 폴백&quot;">​</a></h2><p>asdf 관리 버전이 아닌 <code>&lt;name&gt;</code> 도구의 시스템 버전을 사용하려면 도구의 버전을 <code>system</code>으로 설정할 수 있습니다.</p><p>위에 <a href="#현재-버전-설정">현재 버전 설정</a> 섹션에 나와있는대로, <code>system</code>을 <code>global</code>, <code>local</code> or <code>shell</code> 중에 하나로 설정하세요.</p><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> local</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> system</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf local python system</span></span></code></pre></div><h2 id="현재-버전-보기" tabindex="-1">현재 버전 보기 <a class="header-anchor" href="#현재-버전-보기" aria-label="Permalink to &quot;현재 버전 보기&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> current</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf current</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># erlang          17.3          /Users/kim/.tool-versions</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># nodejs          6.11.5        /Users/kim/cool-node-project/.tool-versions</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> current</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf current erlang</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># erlang          17.3          /Users/kim/.tool-versions</span></span></code></pre></div><h2 id="버전-제거" tabindex="-1">버전 제거 <a class="header-anchor" href="#버전-제거" aria-label="Permalink to &quot;버전 제거&quot;">​</a></h2><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> uninstall</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">nam</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">versio</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">n</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># asdf uninstall erlang 17.3</span></span></code></pre></div><h2 id="shims" tabindex="-1">Shims <a class="header-anchor" href="#shims" aria-label="Permalink to &quot;Shims&quot;">​</a></h2><p>asdf는 패키지를 설치할 때 해당 패키지의 모든 실행 프로그램에 대한 shim들을 <code>$ASDF_DATA_DIR/shims</code> 디렉토리 (기본값은 <code>~/.asdf/shims</code>)에 생성합니다. 이 디렉토리는 설치된 프로그램들이 이용가능하도록 <code>$PATH</code> (<code>asdf.sh</code>, <code>asdf.fish</code> 등)에 존재합니다.</p><p>Shim 자체는 플러그인 이름과 shim이 감싸고 있는 설치된 패키지의 실행파일의 경로를 넘겨주는 <code>asdf exec</code>라는 헬퍼 프로그램을 <code>exec</code>시키는 매우 단순한 wrapper입니다.</p><p><code>asdf exec</code> 헬퍼는 (<code>.tool-version</code> 파일에 지정된 대로, <code>asdf local...</code> 또는 <code>asdf global...</code>에서 선택된 대로) 사용할 패키지의 버전을 결정합니다, (플러그인의 <code>exec-path</code> 콜백에 의해 조정될 수 있음) 패키지 설치 디렉토리의 실행 파일에 대한 최종 경로 및 (플러그인에 의해 제공된 - <code>exec-env</code> 스크립트) 실행할 환경을 결정하고, 최종적으로 이를 실행합니다.</p><div class="warning custom-block"><p class="custom-block-title">노트</p><p>이 시스템은 <code>exec</code> 호출을 사용하기 때문에, 실행 대신 셸에 의해 source 되야하는 패키지의 스크립트는 shim wrapper를 통하지 않고 직접 액세스되야 합니다. 두 가지 <code>asdf</code> 명령어: <code>which</code>와 <code>where</code>는 설치된 패키지로의 경로를 반환할 수 있습니다:</p></div><div class="language-shell vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">shell</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># returns path to main executable in current version</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">source</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> $(</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> which</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> \${PLUGIN})</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/../script.sh</span></span>
+<span class="line"></span>
+<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># returns path to the package installation directory</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">source</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> $(</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">asdf</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> where</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> \${PLUGIN})</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">/bin/script.sh</span></span></code></pre></div><h3 id="asdf-shims-우회" tabindex="-1">asdf shims 우회 <a class="header-anchor" href="#asdf-shims-우회" aria-label="Permalink to &quot;asdf shims 우회&quot;">​</a></h3><p>어떠한 이유로 asdf의 shim들을 우회하고 싶거나 프로젝트의 디렉토리로 이동했을 때 자동으로 환경 변수를 설정되게 하고 싶으시면 <a href="https://github.com/asdf-community/asdf-direnv" target="_blank" rel="noreferrer">asdf-direnv</a> 플러그인이 도움이 될 것입니다. 상세한 내용은 README를 확인해 주세요.</p>`,45)]))}const c=i(t,[["render",n]]);export{o as __pageData,c as default};

assets/ko-kr_more_community-projects.md.BGgZzLbH.js

@@ -0,0 +1 @@
+import{_ as t,c as a,a2 as o,o as r}from"./chunks/framework.BQmytedh.js";const f=JSON.parse('{"title":"커뮤니티 프로젝트","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/more/community-projects.md","filePath":"ko-kr/more/community-projects.md","lastUpdated":1734384735000}'),s={name:"ko-kr/more/community-projects.md"};function c(n,e,i,d,l,m){return r(),a("div",null,e[0]||(e[0]=[o('<h1 id="커뮤니티-프로젝트" tabindex="-1">커뮤니티 프로젝트 <a class="header-anchor" href="#커뮤니티-프로젝트" aria-label="Permalink to &quot;커뮤니티 프로젝트&quot;">​</a></h1><p><code>asdf</code>와 관련된 커뮤니티 프로젝트들입니다:</p><ul><li><a href="https://github.com/asdf-community" target="_blank" rel="noreferrer">asdf-community</a>: asdf 플로그인들의 장기 관리를 위한 커뮤니티 주도의 프로젝트입니다.</li><li><a href="https://github.com/iloveitaly/asdf-devcontainer" target="_blank" rel="noreferrer">asdf dev container</a>: GitHub 코드스페이스에서 asdf가 관리하는 툴들을 지원하는 <a href="https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers" target="_blank" rel="noreferrer">GitHub 개발 컨테이너</a></li></ul><div class="warning custom-block"><p class="custom-block-title">노트</p><p>asdf 코어 팀은 이 프로젝트들 혹은 코드를 소유하지 않습니다. asdf 코어는 위의 목록들에 품질과 보안을 책임지지 않습니다.</p></div>',4)]))}const u=t(s,[["render",c]]);export{f as __pageData,u as default};

assets/ko-kr_more_community-projects.md.BGgZzLbH.lean.js

@@ -0,0 +1 @@
+import{_ as t,c as a,a2 as o,o as r}from"./chunks/framework.BQmytedh.js";const f=JSON.parse('{"title":"커뮤니티 프로젝트","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/more/community-projects.md","filePath":"ko-kr/more/community-projects.md","lastUpdated":1734384735000}'),s={name:"ko-kr/more/community-projects.md"};function c(n,e,i,d,l,m){return r(),a("div",null,e[0]||(e[0]=[o('<h1 id="커뮤니티-프로젝트" tabindex="-1">커뮤니티 프로젝트 <a class="header-anchor" href="#커뮤니티-프로젝트" aria-label="Permalink to &quot;커뮤니티 프로젝트&quot;">​</a></h1><p><code>asdf</code>와 관련된 커뮤니티 프로젝트들입니다:</p><ul><li><a href="https://github.com/asdf-community" target="_blank" rel="noreferrer">asdf-community</a>: asdf 플로그인들의 장기 관리를 위한 커뮤니티 주도의 프로젝트입니다.</li><li><a href="https://github.com/iloveitaly/asdf-devcontainer" target="_blank" rel="noreferrer">asdf dev container</a>: GitHub 코드스페이스에서 asdf가 관리하는 툴들을 지원하는 <a href="https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/introduction-to-dev-containers" target="_blank" rel="noreferrer">GitHub 개발 컨테이너</a></li></ul><div class="warning custom-block"><p class="custom-block-title">노트</p><p>asdf 코어 팀은 이 프로젝트들 혹은 코드를 소유하지 않습니다. asdf 코어는 위의 목록들에 품질과 보안을 책임지지 않습니다.</p></div>',4)]))}const u=t(s,[["render",c]]);export{f as __pageData,u as default};

assets/ko-kr_more_faq.md.De3gzoXB.js

@@ -0,0 +1 @@
+import{_ as a,c as o,a2 as r,o as s}from"./chunks/framework.BQmytedh.js";const f=JSON.parse('{"title":"자주 묻는 질문","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/more/faq.md","filePath":"ko-kr/more/faq.md","lastUpdated":1734384735000}'),t={name:"ko-kr/more/faq.md"};function i(d,e,n,c,h,l){return s(),o("div",null,e[0]||(e[0]=[r('<h1 id="자주-묻는-질문" tabindex="-1">자주 묻는 질문 <a class="header-anchor" href="#자주-묻는-질문" aria-label="Permalink to &quot;자주 묻는 질문&quot;">​</a></h1><p><code>asdf</code>에 관련된 공통된 질문들입니다.</p><h2 id="wsl1을-지원하나요" tabindex="-1">WSL1을 지원하나요? <a class="header-anchor" href="#wsl1을-지원하나요" aria-label="Permalink to &quot;WSL1을 지원하나요?&quot;">​</a></h2><p>WSL1 (<a href="https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux" target="_blank" rel="noreferrer">Windows Subsystem for Linux</a> 1)는 공식적으로 지원되지 않습니다. 어떤 부분의 <code>asdf</code>의 제대로 동작하지 않을 수 있습니다. 우리는 WSL1의 공식 지원을 추가할 계획이 없습니다.</p><h2 id="wsl2을-지원하나요" tabindex="-1">WSL2을 지원하나요? <a class="header-anchor" href="#wsl2을-지원하나요" aria-label="Permalink to &quot;WSL2을 지원하나요?&quot;">​</a></h2><p>WSL2 (<a href="https://en.wikipedia.org/wiki/Windows_Subsystem_for_Linux#WSL_2" target="_blank" rel="noreferrer">Windows Subsystem for Linux</a> 2)는 당신이 선택한 WSL distro를 위한 설치 &amp; dependency 설명서를 따르면 작동합니다.</p><p>중요한 것은, WSL2는 <em>오직</em> 현재 작업 디렉토리가 Unix 드라이브 그리고 Windows 드라이브에 종속되어 있지 않을때 정상적으로 동작합니다.</p><p>우리는 호스트 runner support가 GitHub Actions에서 사용가능할 때 WSL2에서 테스트 suite를 진행할 계획입니다만, 현재는 아직 이용가능하지 않은 것 같습니다.</p><h2 id="새롭게-설치된-실행파일이-동작하지-않나요" tabindex="-1">새롭게 설치된 실행파일이 동작하지 않나요? <a class="header-anchor" href="#새롭게-설치된-실행파일이-동작하지-않나요" aria-label="Permalink to &quot;새롭게 설치된 실행파일이 동작하지 않나요?&quot;">​</a></h2><blockquote><p>방금 <code>npm install -g yarn</code>, 그러나 <code>yarn</code>을 실행시킬 수 없습니다. 어떻게 해야하나요?</p></blockquote><p><code>asdf</code>는 <a href="https://en.wikipedia.org/wiki/Shim_(computing)" target="_blank" rel="noreferrer">shims</a>를 사용하여 실행파일들을 관리합니다. 플러그인에 의해서 설치되는 실행파일들은 자동적으로 shim이 생성되지만, <code>asdf</code>가 관리하고 있는 툴에 의해서 실행파일이 설치 된 경우는 shim을 생성해야 한다고 하는 것을 <code>asdf</code>에 알려줄 필요가 있습니다. 이러한 경우, <a href="https://yarnpkg.com/" target="_blank" rel="noreferrer">Yarn</a>의 shim을 생성하기 위해 <a href="/ko-kr/manage/core.html#Shim-재생성"><code>asdf reshim</code> 명령어 문서</a>를 참고하세요.</p><h2 id="셸이-새롭게-설치된-shims들을-감지하지-못하나요" tabindex="-1">셸이 새롭게 설치된 shims들을 감지하지 못하나요? <a class="header-anchor" href="#셸이-새롭게-설치된-shims들을-감지하지-못하나요" aria-label="Permalink to &quot;셸이 새롭게 설치된 shims들을 감지하지 못하나요?&quot;">​</a></h2><p>만약 <code>asdf reshim</code>가 문제를 해결하지 못한다면, 대부분의 경우 <code>asdf.sh</code> 혹은 <code>asdf.fish</code> sourcing이 당신의 셸 설정 파일 (<code>.bash_profile</code>, <code>.zshrc</code>, <code>config.fish</code> etc) <strong>아래쪽에</strong> 있지 <em>않을</em> 가능성이 높습니다. 당신의 <code>$PATH</code>가 설정 된 <strong>후에</strong> 그리고 사용중인 프레임워크 (oh-my-zsh etc)가 source 된 <strong>후에</strong> source 되어야 합니다.</p>',13)]))}const p=a(t,[["render",i]]);export{f as __pageData,p as default};