mirror of
https://github.com/facebook/docusaurus.git
synced 2025-08-03 08:49:51 +02:00
Website Deployment Script
parent
e2ecb6de98
commit
18f1f10c1d
238 changed files with 1820 additions and 1646 deletions
|
|
@ -1,4 +1,4 @@
|
|||
<!DOCTYPE html><html lang="ko"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Translations & Localization · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="도큐사우르스에서는 [Crowdin](https://crowdin.com/)를 사용해 번역 기능을 쉽게 추가할 수 있습니다. 영어로 작성된 문서가 작성되면 커뮤니티 기반으로 사용자가 직접 번역할 수 있는 Crowdin으로 업데이트됩니다. 영어 문자열로 작성된 최상위 페이지에서 번역할 대상 문자열은 `<translate>` 태그로 감싸지고 태그 안의 문자열은 번역될 수 있습니다. 다른 제목이나 라벨도 발견되면 적절하게 번역될 수 있습니다."/><meta name="docsearch:version" content="1.14.4"/><meta name="docsearch:language" content="ko"/><meta property="og:title" content="Translations & Localization · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="도큐사우르스에서는 [Crowdin](https://crowdin.com/)를 사용해 번역 기능을 쉽게 추가할 수 있습니다. 영어로 작성된 문서가 작성되면 커뮤니티 기반으로 사용자가 직접 번역할 수 있는 Crowdin으로 업데이트됩니다. 영어 문자열로 작성된 최상위 페이지에서 번역할 대상 문자열은 `<translate>` 태그로 감싸지고 태그 안의 문자열은 번역될 수 있습니다. 다른 제목이나 라벨도 발견되면 적절하게 번역될 수 있습니다."/><meta property="og:image" content="https://docusaurus.io/img/docusaurus.png"/><meta name="twitter:card" content="summary"/><meta name="twitter:image" content="https://docusaurus.io/img/docusaurus.png"/><link rel="shortcut icon" href="/img/docusaurus.ico"/><link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css"/><link rel="alternate" type="application/atom+xml" href="https://docusaurus.io/blog/atom.xml" title="Docusaurus Blog ATOM Feed"/><link rel="alternate" type="application/rss+xml" href="https://docusaurus.io/blog/feed.xml" title="Docusaurus Blog RSS Feed"/><script>
|
||||
<!DOCTYPE html><html lang="ko"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Translations & Localization · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus allows for useful translation functionality using [Crowdin](https://crowdin.com/). 영어로 작성된 문서가 작성되면 커뮤니티 기반으로 사용자가 직접 번역할 수 있는 Crowdin으로 업데이트됩니다. 영어 문자열로 작성된 최상위 페이지에서 번역할 대상 문자열은 `<translate>` 태그로 감싸지고 태그 안의 문자열은 번역될 수 있습니다. 다른 제목이나 라벨도 발견되면 적절하게 번역될 수 있습니다."/><meta name="docsearch:version" content="1.14.4"/><meta name="docsearch:language" content="ko"/><meta property="og:title" content="Translations & Localization · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus allows for useful translation functionality using [Crowdin](https://crowdin.com/). 영어로 작성된 문서가 작성되면 커뮤니티 기반으로 사용자가 직접 번역할 수 있는 Crowdin으로 업데이트됩니다. 영어 문자열로 작성된 최상위 페이지에서 번역할 대상 문자열은 `<translate>` 태그로 감싸지고 태그 안의 문자열은 번역될 수 있습니다. 다른 제목이나 라벨도 발견되면 적절하게 번역될 수 있습니다."/><meta property="og:image" content="https://docusaurus.io/img/docusaurus.png"/><meta name="twitter:card" content="summary"/><meta name="twitter:image" content="https://docusaurus.io/img/docusaurus.png"/><link rel="shortcut icon" href="/img/docusaurus.ico"/><link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css"/><link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/atom-one-dark.min.css"/><link rel="alternate" type="application/atom+xml" href="https://docusaurus.io/blog/atom.xml" title="Docusaurus Blog ATOM Feed"/><link rel="alternate" type="application/rss+xml" href="https://docusaurus.io/blog/feed.xml" title="Docusaurus Blog RSS Feed"/><script>
|
||||
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
|
||||
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
|
||||
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
|
||||
|
|
@ -80,7 +80,7 @@
|
|||
};
|
||||
}
|
||||
});
|
||||
</script></nav></div><div class="container mainContainer docsContainer"><div class="wrapper"><div class="post"><header class="postHeader"><a class="edit-page-link button" href="https://crowdin.com/project/docusaurus/ko" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Translations & Localization</h1></header><article><div><span><p>도큐사우르스에서는 <a href="https://crowdin.com/">Crowdin</a>를 사용해 번역 기능을 쉽게 추가할 수 있습니다. 영어로 작성된 문서가 작성되면 커뮤니티 기반으로 사용자가 직접 번역할 수 있는 Crowdin으로 업데이트됩니다. 영어 문자열로 작성된 최상위 페이지에서 번역할 대상 문자열은 <code><translate></code> 태그로 감싸지고 태그 안의 문자열은 번역될 수 있습니다. 다른 제목이나 라벨도 발견되면 적절하게 번역될 수 있습니다.</p>
|
||||
</script></nav></div><div class="container mainContainer docsContainer"><div class="wrapper"><div class="post"><header class="postHeader"><a class="edit-page-link button" href="https://crowdin.com/project/docusaurus/ko" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Translations & Localization</h1></header><article><div><span><p>Docusaurus allows for useful translation functionality using <a href="https://crowdin.com/">Crowdin</a>. 영어로 작성된 문서가 작성되면 커뮤니티 기반으로 사용자가 직접 번역할 수 있는 Crowdin으로 업데이트됩니다. 영어 문자열로 작성된 최상위 페이지에서 번역할 대상 문자열은 <code><translate></code> 태그로 감싸지고 태그 안의 문자열은 번역될 수 있습니다. 다른 제목이나 라벨도 발견되면 적절하게 번역될 수 있습니다.</p>
|
||||
<h2><a class="anchor" aria-hidden="true" id="도큐사우르스에서-번역-관련-설정하기"></a><a href="#도큐사우르스에서-번역-관련-설정하기" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>도큐사우르스에서 번역 관련 설정하기</h2>
|
||||
<p>도큐사우르스에서 번역을 위한 예제 파일을 만들기 위해서는 <code>examples</code> 스크립트를 <code>translations</code> 인자와 함께 실행합니다.</p>
|
||||
<pre><code class="hljs css language-bash">npm run examples translations
|
||||
|
|
@ -208,7 +208,6 @@ languages.js
|
|||
<span class="hljs-attr">preserve_hierarchy:</span> <span class="hljs-literal">true</span>
|
||||
|
||||
<span class="hljs-attr">files:</span>
|
||||
|
||||
<span class="hljs-bullet">-</span> <span class="hljs-attr">source:</span> <span class="hljs-string">'/docs/**/*.md'</span>
|
||||
<span class="hljs-attr">translation:</span> <span class="hljs-string">'/website/translated_docs/%locale%/**/%original_file_name%'</span>
|
||||
<span class="hljs-attr">languages_mapping:</span> <span class="hljs-meta">&anchor</span>
|
||||
|
|
@ -239,8 +238,14 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
|
|||
</code></pre>
|
||||
<blockquote>
|
||||
<p><code>YOUR_CROWDIN_PROJECT_ID</code> 항목은 Crowdin 프로젝트 이름을 설정합니다. 예를 들어 <a href="https://crowdin.com/project/docusaurus/">https://crowdin.com/project/docusaurus/</a> Url에서 <code>docusaurus</code> 문자열을 설정합니다. <code>YOUR_CROWDIN_API_KEY</code> 항목은 비밀번호와 같은 유일한 키값을 지정합니다. Crowdin 프로젝트 <code>Settings</code> 항목 중 <code>API</code> 탭에서 찾을 수 있습니다.</p>
|
||||
</blockquote>
|
||||
<blockquote>
|
||||
<p>명령행을 실행하기 위해서는 환경변수에서 Crowdin 프로젝트 id와 api 키값(<code>CROWDIN_PROJECT_ID</code>, <code>CROWDIN_API_KEY</code>) 을 설정해주어야 합니다. 위에서처럼 인라인 명령행에 설정값을 추가할 수도 있고 <code>.bashrc</code> 또는 <code>.bash_profile</code> 파일에 추가할 수도 있습니다.</p>
|
||||
</blockquote>
|
||||
<blockquote>
|
||||
<p>여러분의 컴퓨터에서 하나 이상의 도큐사우르스 프로젝트 지역화를 처리하고자 한다면 환경변수의 이름을 구분할 수 있는 고유한 값으로 변경해주어야 합니다(<code>CROWDIN_PROJECTNAME_PROJECT_ID</code>, <code>CROWDIN_PROJECTNAME_API_KEY</code>).</p>
|
||||
</blockquote>
|
||||
<blockquote>
|
||||
<p>파일들이 생성되고 나면 <code>website/i18n</code> 또는 <code>website/translated_docs</code> 디렉토리에 파일을 가지고 있을 필요가 없습니다. <code>website/i18n/*</code>와 <code>website/translated_docs</code>에 <code>.gitignore</code> 파일을 추가해줍니다.</p>
|
||||
</blockquote>
|
||||
<h3><a class="anchor" aria-hidden="true" id="automated-file-sync-using-circleci"></a><a href="#automated-file-sync-using-circleci" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Automated File Sync Using CircleCI</h3>
|
||||
|
|
@ -260,11 +265,9 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
|
|||
<span class="hljs-attr">deploy-website:</span>
|
||||
<span class="hljs-attr">docker:</span>
|
||||
<span class="hljs-comment"># specify the version you desire here</span>
|
||||
|
||||
<span class="hljs-bullet">-</span> <span class="hljs-attr">image:</span> <span class="hljs-string">circleci/node:8.11.1</span>
|
||||
|
||||
<span class="hljs-attr">steps:</span>
|
||||
|
||||
<span class="hljs-bullet">-</span> <span class="hljs-string">checkout</span>
|
||||
<span class="hljs-bullet">-</span> <span class="hljs-attr">run:</span>
|
||||
<span class="hljs-attr">name:</span> <span class="hljs-string">Deploying</span> <span class="hljs-string">to</span> <span class="hljs-string">GitHub</span> <span class="hljs-string">Pages</span>
|
||||
|
|
@ -288,7 +291,6 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
|
|||
<span class="hljs-attr">version:</span> <span class="hljs-number">2</span>
|
||||
<span class="hljs-attr">build_and_deploy:</span>
|
||||
<span class="hljs-attr">jobs:</span>
|
||||
|
||||
<span class="hljs-bullet">-</span> <span class="hljs-attr">deploy-website:</span>
|
||||
<span class="hljs-comment"># filters: *filter-only-master</span>
|
||||
</code></pre>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue