<!DOCTYPE html><htmllang="ko"><head><metacharSet="utf-8"/><metahttp-equiv="X-UA-Compatible"content="IE=edge"/><title>Versioning · Docusaurus</title><metaname="viewport"content="width=device-width"/><metaname="generator"content="Docusaurus"/><metaname="description"content="`docs` 디렉토리에서 마지막으로 작성한 콘텐츠를 기준으로 변경된 콘텐츠를 처리하기 위해 `version` 스크립트를 사용할 수 있습니다. `docs` 디렉토리 내 문서가 바뀌더라도 지정된 문서 세트는 그대로 유지되고 접근할 수 있습니다."/><metaname="docsearch:version"content="1.13.0"/><metaname="docsearch:language"content="ko"/><metaproperty="og:title"content="Versioning · Docusaurus"/><metaproperty="og:type"content="website"/><metaproperty="og:url"content="https://docusaurus.io/"/><metaproperty="og:description"content="`docs` 디렉토리에서 마지막으로 작성한 콘텐츠를 기준으로 변경된 콘텐츠를 처리하기 위해 `version` 스크립트를 사용할 수 있습니다. `docs` 디렉토리 내 문서가 바뀌더라도 지정된 문서 세트는 그대로 유지되고 접근할 수 있습니다."/><metaproperty="og:image"content="https://docusaurus.io/img/docusaurus.png"/><metaname="twitter:card"content="summary"/><metaname="twitter:image"content="https://docusaurus.io/img/docusaurus.png"/><linkrel="shortcut icon"href="/img/docusaurus.ico"/><linkrel="stylesheet"href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/><linkrel="stylesheet"href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css"/><linkrel="alternate"type="application/atom+xml"href="https://docusaurus.io/blog/atom.xml"title="Docusaurus Blog ATOM Feed"/><linkrel="alternate"type="application/rss+xml"href="https://docusaurus.io/blog/feed.xml"title="Docusaurus Blog RSS Feed"/><script>
function createToggler(togglerSelector, targetSelector, className) {
var toggler = document.querySelector(togglerSelector);
var target = document.querySelector(targetSelector);
if (!toggler) {
return;
}
toggler.onclick = function(event) {
event.preventDefault();
target.classList.toggle(className);
};
}
});
</script></nav></div><divclass="container mainContainer"><divclass="wrapper"><divclass="post"><headerclass="postHeader"><aclass="edit-page-link button"href="https://crowdin.com/project/docusaurus/ko"target="_blank"rel="noreferrer noopener">Translate</a><h1class="postHeaderTitle">Versioning</h1></header><article><div><span><p><code>docs</code> 디렉토리에서 마지막으로 작성한 콘텐츠를 기준으로 변경된 콘텐츠를 처리하기 위해 <code>version</code> 스크립트를 사용할 수 있습니다. <code>docs</code> 디렉토리 내 문서가 바뀌더라도 지정된 문서 세트는 그대로 유지되고 접근할 수 있습니다.</p>
<p>만들고자 하는 버전을 지정하고 아래와 같이 스크립트를 실행합니다. 아래와 같이 적용할 수 있습니다.</p>
<pre><codeclass="hljs css language-bash">yarn run version 1.0.0
</code></pre>
<p>이렇게 하면 <code>docs</code> 디렉토리에 있는 모든 문서는 그대로 유지되며 문서의 버전을 <code>1.0.0</code>으로 적용할 수 있습니다.</p>
<p>스크립트를 실행하면서 버전 번호를 <code>1.0.0</code>으로 지정했다면 <code>1.0.0</code> 버전은 프로젝트의 최신 릴리스로 처리됩니다. 사이트에서는 버전 번호를 헤더의 타이틀 옆에 표시합니다. 생성된 버전 번호는 앞에서 만든 버전 페이지에 대한 링크로 생성됩니다.</p>
<p><code>docs</code> 디렉토리에 있는 문서는 사용할 수 있는 <code>next</code> 버전으로 처리됩니다. 예를 들어 <code>docs/next/doc1.html</code>와 같은 식입니다. 문서의 최신 버전 URL은 <code>docs/doc1.html</code>이 됩니다.</p>
<p><code>yarn run version 2.0.0</code> 스크립트를 실행하게 되면 <code>2.0.0</code> 버전이 생성되고 <code>2.0.0</code> 버전이 가장 최신의 문서 세트가 됩니다. <code>1.0.0</code> 버전의 문서는 <code>docs/1.0.0/doc1.html</code> URL로 접근할 수 있습니다. <code>2.0.0</code> 버전의 문서는 <code>docs/doc1.html</code>으로 접근합니다.</p>
<p>버전으로 생성된 문서는 <code>website/versioned_docs/version-${version}</code> 디렉토리로 생성됩니다. 여기서 <code>${version}</code>는 <code>version</code>스크립트에서 설정한 버전 번호입니다.</p>
<p>버전 정보가 기록된 문서의 마크다운 헤더에서 기존 id 값은 <code>original_id</code> 항목으로 설정되고 <code>id</code> 항목값은 <code>"version-${version}-${original_id}"</code>으로 설정됩니다.</p>
<p>버전정보가 기록된 사이드바도 <code>website/versioned_sidebars</code> 디렉토리에 복사되고 파일명은 <code>version-${version}-sidebars.json</code> 형식으로 바뀝니다.</p>
<p><code>website/versions.json</code> 파일은 버전을 설정하는 시점에 생성되며 도큐사우르스에서 어떤 버전이 있는지 확인하기 위한 용도로 사용됩니다. 새로운 버전이 추가될때마다 <code>versions.json</code> 파일에 정보가 추가되어집니다.</p>
<p>과거 버전으로 문서를 변경하기 원한다면 각 버전의 파일에 접근할 수 있습니다.</p>
<p><code>docs</code> 디렉토리에 있는 파일과 사이드바 파일은 새로운 버전으로 생성된 파일들과는 다를 수 있습니다. 버전 간 차이가 없다면 도큐사우르스에서는 최신 버전의 파일을 사용하게 됩니다.</p>
<p>예를 들어 original id가 <code>doc1</code>인 문서의 버전이 <code>1.0.0</code>이라고 할때 id가 <code>doc1</code>인 같은 콘텐츠인 문서가 <code>docs</code> 디렉토리에 있습니다. <code>2.0.0</code> 버전이 생성되면 <code>doc1</code> 문서는 <code>versioned_docs/version-2.0.0/</code>으로 복사되지 않습니다. <code>docs/2.0.0/doc1.html</code>라는 페이지가 만들어지긴 하지만 사용하는 파일은 <code>1.0.0</code> 버전의 파일을 사용하게 됩니다.</p>
<p>If you wish to use versioning and translations features, the <code>crowdin.yaml</code> file should be set up to upload and download versioned documents to and from Crowdin for translation. Translated, versioned files will go into the directory <code>translated_docs/${language}/version-${version}/</code>. For more information, check out the <ahref="/docs/ko/translation">translations guide</a>.</p>
</span></div></article></div><divclass="docs-prevnext"><aclass="docs-prev button"href="/docs/ko/translation"><spanclass="arrow-prev">← </span><span>번역 & 현지화</span></a><aclass="docs-next button"href="/docs/ko/commands"><span>CLI 명령어</span><spanclass="arrow-next"> →</span></a></div></div></div><navclass="onPageNav"><ulclass="toc-headings"><li><ahref="#새로운-버전은-어떻게-만드나요">새로운 버전은 어떻게 만드나요</a></li><li><ahref="#버전-규칙">버전 규칙</a></li><li><ahref="#각-버전의-파일-저장하기">각 버전의 파일 저장하기</a></li><li><ahref="#이전-버전으로-되돌리기">이전 버전으로 되돌리기</a></li><li><ahref="#기존에-생성한-버전-번호-변경하기">기존에 생성한 버전 번호 변경하기</a></li><li><ahref="#versioning-and-translations">Versioning and Translations</a></li></ul></nav></div><footerclass="nav-footer"id="footer"><sectionclass="sitemap"><ahref="/"class="nav-home"><imgsrc="/img/docusaurus_monochrome.svg"alt="Docusaurus"width="66"height="58"/></a><divclass="footerSection"><h5>Docs</h5><ahref="
