Revert "Deploy website"

This reverts commit 8db87ffa39.
This commit is contained in:
Yangshun Tay 2019-11-03 23:08:49 +08:00
parent 8db87ffa39
commit 09d11ceb49
742 changed files with 8947 additions and 8877 deletions

View file

@ -95,7 +95,7 @@
<pre><code class="hljs css language-yml"><span class="hljs-meta">---</span>
<span class="hljs-attr">title:</span> <span class="hljs-string">Представляем</span> <span class="hljs-string">Docusaurus</span>
<span class="hljs-attr">author:</span> <span class="hljs-string">Джоэл</span> <span class="hljs-string">Марси</span>
<span class="hljs-attr">authorURL:</span> <span class="hljs-string">http://twitter.com/JoelMarcey</span>
<span class="hljs-attr">authorURL:</span> <span class="hljs-attr">http://twitter.com/JoelMarcey</span>
<span class="hljs-attr">authorFBID:</span> <span class="hljs-number">611217057</span>
<span class="hljs-attr">authorTwitter:</span> <span class="hljs-string">JoelMarcey</span>
<span class="hljs-meta">---</span>

View file

@ -95,7 +95,7 @@
<pre><code class="hljs css language-yml"><span class="hljs-meta">---</span>
<span class="hljs-attr">title:</span> <span class="hljs-string">Представляем</span> <span class="hljs-string">Docusaurus</span>
<span class="hljs-attr">author:</span> <span class="hljs-string">Джоэл</span> <span class="hljs-string">Марси</span>
<span class="hljs-attr">authorURL:</span> <span class="hljs-string">http://twitter.com/JoelMarcey</span>
<span class="hljs-attr">authorURL:</span> <span class="hljs-attr">http://twitter.com/JoelMarcey</span>
<span class="hljs-attr">authorFBID:</span> <span class="hljs-number">611217057</span>
<span class="hljs-attr">authorTwitter:</span> <span class="hljs-string">JoelMarcey</span>
<span class="hljs-meta">---</span>

View file

@ -109,7 +109,7 @@
<pre><code class="hljs css language-yaml"><span class="hljs-meta">---</span>
<span class="hljs-attr">id:</span> <span class="hljs-string">doc-markdown</span>
<span class="hljs-attr">title:</span> <span class="hljs-string">Markdown</span> <span class="hljs-string">Features</span>
<span class="hljs-attr">custom_edit_url:</span> <span class="hljs-string">https://github.com/facebook/docusaurus/edit/master/docs/api-doc-markdown.md</span>
<span class="hljs-attr">custom_edit_url:</span> <span class="hljs-attr">https://github.com/facebook/docusaurus/edit/master/docs/api-doc-markdown.md</span>
<span class="hljs-meta">---</span>
</code></pre>
<h3><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>Сообщения блога</h3>
@ -122,7 +122,7 @@
<pre><code class="hljs css language-yaml"><span class="hljs-meta">---</span>
<span class="hljs-attr">title:</span> <span class="hljs-string">My</span> <span class="hljs-string">First</span> <span class="hljs-string">Blog</span> <span class="hljs-string">Post</span>
<span class="hljs-attr">author:</span> <span class="hljs-string">Frank</span> <span class="hljs-string">Li</span>
<span class="hljs-attr">authorURL:</span> <span class="hljs-string">http://twitter.com/franchementli</span>
<span class="hljs-attr">authorURL:</span> <span class="hljs-attr">http://twitter.com/franchementli</span>
<span class="hljs-attr">authorFBID:</span> <span class="hljs-number">100002976521003</span>
<span class="hljs-meta">---</span>
</code></pre>

View file

@ -109,7 +109,7 @@
<pre><code class="hljs css language-yaml"><span class="hljs-meta">---</span>
<span class="hljs-attr">id:</span> <span class="hljs-string">doc-markdown</span>
<span class="hljs-attr">title:</span> <span class="hljs-string">Markdown</span> <span class="hljs-string">Features</span>
<span class="hljs-attr">custom_edit_url:</span> <span class="hljs-string">https://github.com/facebook/docusaurus/edit/master/docs/api-doc-markdown.md</span>
<span class="hljs-attr">custom_edit_url:</span> <span class="hljs-attr">https://github.com/facebook/docusaurus/edit/master/docs/api-doc-markdown.md</span>
<span class="hljs-meta">---</span>
</code></pre>
<h3><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>Сообщения блога</h3>
@ -122,7 +122,7 @@
<pre><code class="hljs css language-yaml"><span class="hljs-meta">---</span>
<span class="hljs-attr">title:</span> <span class="hljs-string">My</span> <span class="hljs-string">First</span> <span class="hljs-string">Blog</span> <span class="hljs-string">Post</span>
<span class="hljs-attr">author:</span> <span class="hljs-string">Frank</span> <span class="hljs-string">Li</span>
<span class="hljs-attr">authorURL:</span> <span class="hljs-string">http://twitter.com/franchementli</span>
<span class="hljs-attr">authorURL:</span> <span class="hljs-attr">http://twitter.com/franchementli</span>
<span class="hljs-attr">authorFBID:</span> <span class="hljs-number">100002976521003</span>
<span class="hljs-meta">---</span>
</code></pre>

View file

@ -108,22 +108,22 @@
<pre><code class="hljs css language-yml"><span class="hljs-attr">version:</span> <span class="hljs-string">"3"</span>
<span class="hljs-attr">services:</span>
<span class="hljs-attr">docusaurus:</span>
<span class="hljs-attr">build:</span> <span class="hljs-string">.</span>
<span class="hljs-attr">ports:</span>
<span class="hljs-attr"> docusaurus:</span>
<span class="hljs-attr"> build:</span> <span class="hljs-string">.</span>
<span class="hljs-attr"> ports:</span>
<span class="hljs-bullet">-</span> <span class="hljs-number">3000</span><span class="hljs-string">:3000</span>
<span class="hljs-bullet">-</span> <span class="hljs-number">35729</span><span class="hljs-string">:35729</span>
<span class="hljs-attr">volumes:</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./docs:/app/docs</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/blog:/app/website/blog</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/core:/app/website/core</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/i18n:/app/website/i18n</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/pages:/app/website/pages</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/static:/app/website/static</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/sidebars.json:/app/website/sidebars.json</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/siteConfig.js:/app/website/siteConfig.js</span>
<span class="hljs-attr">working_dir:</span> <span class="hljs-string">/app/website</span>
<span class="hljs-bullet"> -</span> <span class="hljs-number">3000</span><span class="hljs-string">:3000</span>
<span class="hljs-bullet"> -</span> <span class="hljs-number">35729</span><span class="hljs-string">:35729</span>
<span class="hljs-attr"> volumes:</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./docs:/app/docs</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/blog:/app/website/blog</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/core:/app/website/core</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/i18n:/app/website/i18n</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/pages:/app/website/pages</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/static:/app/website/static</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/sidebars.json:/app/website/sidebars.json</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/siteConfig.js:/app/website/siteConfig.js</span>
<span class="hljs-attr"> working_dir:</span> <span class="hljs-string">/app/website</span>
</code></pre>
<p>To run a local web server with <code>docker-compose</code> run <code>docker-compose up</code>.</p>

View file

@ -108,22 +108,22 @@
<pre><code class="hljs css language-yml"><span class="hljs-attr">version:</span> <span class="hljs-string">"3"</span>
<span class="hljs-attr">services:</span>
<span class="hljs-attr">docusaurus:</span>
<span class="hljs-attr">build:</span> <span class="hljs-string">.</span>
<span class="hljs-attr">ports:</span>
<span class="hljs-attr"> docusaurus:</span>
<span class="hljs-attr"> build:</span> <span class="hljs-string">.</span>
<span class="hljs-attr"> ports:</span>
<span class="hljs-bullet">-</span> <span class="hljs-number">3000</span><span class="hljs-string">:3000</span>
<span class="hljs-bullet">-</span> <span class="hljs-number">35729</span><span class="hljs-string">:35729</span>
<span class="hljs-attr">volumes:</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./docs:/app/docs</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/blog:/app/website/blog</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/core:/app/website/core</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/i18n:/app/website/i18n</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/pages:/app/website/pages</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/static:/app/website/static</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/sidebars.json:/app/website/sidebars.json</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">./website/siteConfig.js:/app/website/siteConfig.js</span>
<span class="hljs-attr">working_dir:</span> <span class="hljs-string">/app/website</span>
<span class="hljs-bullet"> -</span> <span class="hljs-number">3000</span><span class="hljs-string">:3000</span>
<span class="hljs-bullet"> -</span> <span class="hljs-number">35729</span><span class="hljs-string">:35729</span>
<span class="hljs-attr"> volumes:</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./docs:/app/docs</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/blog:/app/website/blog</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/core:/app/website/core</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/i18n:/app/website/i18n</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/pages:/app/website/pages</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/static:/app/website/static</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/sidebars.json:/app/website/sidebars.json</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">./website/siteConfig.js:/app/website/siteConfig.js</span>
<span class="hljs-attr"> working_dir:</span> <span class="hljs-string">/app/website</span>
</code></pre>
<p>To run a local web server with <code>docker-compose</code> run <code>docker-compose up</code>.</p>

View file

@ -140,7 +140,7 @@
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
...
url: <span class="hljs-string">'https://__userName__.github.io'</span>, <span class="hljs-comment">// Your website URL</span>
<span class="hljs-attr">baseUrl</span>: <span class="hljs-string">'/testProject/'</span>,
baseUrl: <span class="hljs-string">'/testProject/'</span>,
<span class="hljs-attr">projectName</span>: <span class="hljs-string">'testProject'</span>,
<span class="hljs-attr">organizationName</span>: <span class="hljs-string">'userName'</span>
...
@ -207,29 +207,29 @@
<span class="hljs-attr">version:</span> <span class="hljs-number">2</span>
<span class="hljs-attr">jobs:</span>
<span class="hljs-attr">deploy-website:</span>
<span class="hljs-attr">docker:</span>
<span class="hljs-attr"> deploy-website:</span>
<span class="hljs-attr"> docker:</span>
<span class="hljs-comment"># укажите здесь версию, которую желаете использовать</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"> - image:</span> <span class="hljs-string">circleci/node:8.11.1</span>
<span class="hljs-attr">steps:</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>
<span class="hljs-attr">command:</span> <span class="hljs-string">|
<span class="hljs-bullet"> -</span> <span class="hljs-string">checkout</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>
<span class="hljs-attr"> command:</span> <span class="hljs-string">|
git config --global user.email "&amp;lt;GITHUB_USERNAME&amp;gt;@users.noreply.github.com"
git config --global user.name "&amp;lt;YOUR_NAME&amp;gt;"
echo "machine github.com login &amp;lt;GITHUB_USERNAME&amp;gt; password $GITHUB_TOKEN" &gt; ~/.netrc
cd website &amp;&amp; yarn install &amp;&amp; GIT_USER=&amp;lt;GIT_USER&amp;gt; yarn run publish-gh-pages
</span>
<span class="hljs-attr">workflows:</span>
<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><span class="hljs-attr">workflows:</span>
<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-attr"> - deploy-website:</span>
<span class="hljs-comment"># filters: *filter-only-master</span>
</code></pre>
<p>Обязательно замените все <code>&lt;....&gt;</code> в последовательности <code>command:</code> соответствующими значениями. Для <code>&amp;lt;GIT_USER&amp;gt;</code> это должна быть учетная запись GitHub, которая имеет доступ к записи документации в ваш репозиторий GitHub. В большинстве случаев <code>&amp;lt;GIT_USER&amp;gt;</code> и <code>&amp;lt;GITHUB_USERNAME&amp;gt;</code> имеют одинаковые значения.</p>
@ -258,12 +258,12 @@
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
<span class="hljs-attr">version:</span> <span class="hljs-number">2</span>
<span class="hljs-attr">jobs:</span>
<span class="hljs-attr">build:</span>
<span class="hljs-attr">machine:</span> <span class="hljs-literal">true</span>
<span class="hljs-attr">branches:</span>
<span class="hljs-attr">ignore:</span> <span class="hljs-string">gh-pages</span>
<span class="hljs-attr">steps:</span>
<span class="hljs-bullet">-</span> <span class="hljs-attr">run:</span> <span class="hljs-string">echo</span> <span class="hljs-string">"Skipping tests on gh-pages branch"</span>
<span class="hljs-attr"> build:</span>
<span class="hljs-attr"> machine:</span> <span class="hljs-literal">true</span>
<span class="hljs-attr"> branches:</span>
<span class="hljs-attr"> ignore:</span> <span class="hljs-string">gh-pages</span>
<span class="hljs-attr"> steps:</span>
<span class="hljs-attr"> - run:</span> <span class="hljs-string">echo</span> <span class="hljs-string">"Skipping tests on gh-pages branch"</span>
</code></pre>
<p>Сохраните этот файл как <code>config.yml</code> и разместите его в каталоге <code>.circleci</code> внутри вашего каталога <code>website/static</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="использование-travis-ci"></a><a href="#использование-travis-ci" 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>Использование Travis CI</h3>
@ -277,18 +277,18 @@
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># .travis.yml</span>
<span class="hljs-attr">language:</span> <span class="hljs-string">node_js</span>
<span class="hljs-attr">node_js:</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">'8'</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">'8'</span>
<span class="hljs-attr">branches:</span>
<span class="hljs-attr">only:</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">master</span>
<span class="hljs-attr"> only:</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">master</span>
<span class="hljs-attr">cache:</span>
<span class="hljs-attr">yarn:</span> <span class="hljs-literal">true</span>
<span class="hljs-attr"> yarn:</span> <span class="hljs-literal">true</span>
<span class="hljs-attr">script:</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">git</span> <span class="hljs-string">config</span> <span class="hljs-string">--global</span> <span class="hljs-string">user.name</span> <span class="hljs-string">"${GH_NAME}"</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">git</span> <span class="hljs-string">config</span> <span class="hljs-string">--global</span> <span class="hljs-string">user.email</span> <span class="hljs-string">"${GH_EMAIL}"</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">echo</span> <span class="hljs-string">"machine github.com login ${GH_NAME} password ${GH_TOKEN}"</span> <span class="hljs-string">&gt;</span> <span class="hljs-string">~/.netrc</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">cd</span> <span class="hljs-string">website</span> <span class="hljs-string">&amp;&amp;</span> <span class="hljs-string">yarn</span> <span class="hljs-string">install</span> <span class="hljs-string">&amp;&amp;</span> <span class="hljs-string">GIT_USER="${GH_NAME}"</span> <span class="hljs-string">yarn</span> <span class="hljs-string">run</span> <span class="hljs-string">publish-gh-pages</span>
</code></pre>
<span class="hljs-bullet"> -</span> <span class="hljs-string">git</span> <span class="hljs-string">config</span> <span class="hljs-bullet">--global</span> <span class="hljs-string">user.name</span> <span class="hljs-string">"${GH_NAME}"</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">git</span> <span class="hljs-string">config</span> <span class="hljs-bullet">--global</span> <span class="hljs-string">user.email</span> <span class="hljs-string">"${GH_EMAIL}"</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">echo</span> <span class="hljs-string">"machine github.com login ${GH_NAME} password ${GH_TOKEN}"</span> <span class="hljs-string">&gt; ~/.netrc
- cd website &amp;&amp; yarn install &amp;&amp; GIT_USER="${GH_NAME}" yarn run publish-gh-pages
</span></code></pre>
<p>Теперь, когда новый коммит будет отправлен в <code>master</code>, Travis CI запустит набор тестов и, если все они будут пройдены, развернет ваш сайт с помощью сценария <code>publish-gh-pages</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="hosting-on-zeit-now"></a><a href="#hosting-on-zeit-now" 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>Hosting on ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site easily and connect it to <a href="https://zeit.co/github">GitHub</a> or <a href="https://zeit.co/gitlab">GitLab</a> to automatically receive a new deployment every time you push a commit.</p>

View file

@ -140,7 +140,7 @@
<pre><code class="hljs css language-js"><span class="hljs-keyword">const</span> siteConfig = {
...
url: <span class="hljs-string">'https://__userName__.github.io'</span>, <span class="hljs-comment">// Your website URL</span>
<span class="hljs-attr">baseUrl</span>: <span class="hljs-string">'/testProject/'</span>,
baseUrl: <span class="hljs-string">'/testProject/'</span>,
<span class="hljs-attr">projectName</span>: <span class="hljs-string">'testProject'</span>,
<span class="hljs-attr">organizationName</span>: <span class="hljs-string">'userName'</span>
...
@ -207,29 +207,29 @@
<span class="hljs-attr">version:</span> <span class="hljs-number">2</span>
<span class="hljs-attr">jobs:</span>
<span class="hljs-attr">deploy-website:</span>
<span class="hljs-attr">docker:</span>
<span class="hljs-attr"> deploy-website:</span>
<span class="hljs-attr"> docker:</span>
<span class="hljs-comment"># укажите здесь версию, которую желаете использовать</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"> - image:</span> <span class="hljs-string">circleci/node:8.11.1</span>
<span class="hljs-attr">steps:</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>
<span class="hljs-attr">command:</span> <span class="hljs-string">|
<span class="hljs-bullet"> -</span> <span class="hljs-string">checkout</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>
<span class="hljs-attr"> command:</span> <span class="hljs-string">|
git config --global user.email "&amp;lt;GITHUB_USERNAME&amp;gt;@users.noreply.github.com"
git config --global user.name "&amp;lt;YOUR_NAME&amp;gt;"
echo "machine github.com login &amp;lt;GITHUB_USERNAME&amp;gt; password $GITHUB_TOKEN" &gt; ~/.netrc
cd website &amp;&amp; yarn install &amp;&amp; GIT_USER=&amp;lt;GIT_USER&amp;gt; yarn run publish-gh-pages
</span>
<span class="hljs-attr">workflows:</span>
<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><span class="hljs-attr">workflows:</span>
<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-attr"> - deploy-website:</span>
<span class="hljs-comment"># filters: *filter-only-master</span>
</code></pre>
<p>Обязательно замените все <code>&lt;....&gt;</code> в последовательности <code>command:</code> соответствующими значениями. Для <code>&amp;lt;GIT_USER&amp;gt;</code> это должна быть учетная запись GitHub, которая имеет доступ к записи документации в ваш репозиторий GitHub. В большинстве случаев <code>&amp;lt;GIT_USER&amp;gt;</code> и <code>&amp;lt;GITHUB_USERNAME&amp;gt;</code> имеют одинаковые значения.</p>
@ -258,12 +258,12 @@
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
<span class="hljs-attr">version:</span> <span class="hljs-number">2</span>
<span class="hljs-attr">jobs:</span>
<span class="hljs-attr">build:</span>
<span class="hljs-attr">machine:</span> <span class="hljs-literal">true</span>
<span class="hljs-attr">branches:</span>
<span class="hljs-attr">ignore:</span> <span class="hljs-string">gh-pages</span>
<span class="hljs-attr">steps:</span>
<span class="hljs-bullet">-</span> <span class="hljs-attr">run:</span> <span class="hljs-string">echo</span> <span class="hljs-string">"Skipping tests on gh-pages branch"</span>
<span class="hljs-attr"> build:</span>
<span class="hljs-attr"> machine:</span> <span class="hljs-literal">true</span>
<span class="hljs-attr"> branches:</span>
<span class="hljs-attr"> ignore:</span> <span class="hljs-string">gh-pages</span>
<span class="hljs-attr"> steps:</span>
<span class="hljs-attr"> - run:</span> <span class="hljs-string">echo</span> <span class="hljs-string">"Skipping tests on gh-pages branch"</span>
</code></pre>
<p>Сохраните этот файл как <code>config.yml</code> и разместите его в каталоге <code>.circleci</code> внутри вашего каталога <code>website/static</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="использование-travis-ci"></a><a href="#использование-travis-ci" 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>Использование Travis CI</h3>
@ -277,18 +277,18 @@
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># .travis.yml</span>
<span class="hljs-attr">language:</span> <span class="hljs-string">node_js</span>
<span class="hljs-attr">node_js:</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">'8'</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">'8'</span>
<span class="hljs-attr">branches:</span>
<span class="hljs-attr">only:</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">master</span>
<span class="hljs-attr"> only:</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">master</span>
<span class="hljs-attr">cache:</span>
<span class="hljs-attr">yarn:</span> <span class="hljs-literal">true</span>
<span class="hljs-attr"> yarn:</span> <span class="hljs-literal">true</span>
<span class="hljs-attr">script:</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">git</span> <span class="hljs-string">config</span> <span class="hljs-string">--global</span> <span class="hljs-string">user.name</span> <span class="hljs-string">"${GH_NAME}"</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">git</span> <span class="hljs-string">config</span> <span class="hljs-string">--global</span> <span class="hljs-string">user.email</span> <span class="hljs-string">"${GH_EMAIL}"</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">echo</span> <span class="hljs-string">"machine github.com login ${GH_NAME} password ${GH_TOKEN}"</span> <span class="hljs-string">&gt;</span> <span class="hljs-string">~/.netrc</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">cd</span> <span class="hljs-string">website</span> <span class="hljs-string">&amp;&amp;</span> <span class="hljs-string">yarn</span> <span class="hljs-string">install</span> <span class="hljs-string">&amp;&amp;</span> <span class="hljs-string">GIT_USER="${GH_NAME}"</span> <span class="hljs-string">yarn</span> <span class="hljs-string">run</span> <span class="hljs-string">publish-gh-pages</span>
</code></pre>
<span class="hljs-bullet"> -</span> <span class="hljs-string">git</span> <span class="hljs-string">config</span> <span class="hljs-bullet">--global</span> <span class="hljs-string">user.name</span> <span class="hljs-string">"${GH_NAME}"</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">git</span> <span class="hljs-string">config</span> <span class="hljs-bullet">--global</span> <span class="hljs-string">user.email</span> <span class="hljs-string">"${GH_EMAIL}"</span>
<span class="hljs-bullet"> -</span> <span class="hljs-string">echo</span> <span class="hljs-string">"machine github.com login ${GH_NAME} password ${GH_TOKEN}"</span> <span class="hljs-string">&gt; ~/.netrc
- cd website &amp;&amp; yarn install &amp;&amp; GIT_USER="${GH_NAME}" yarn run publish-gh-pages
</span></code></pre>
<p>Теперь, когда новый коммит будет отправлен в <code>master</code>, Travis CI запустит набор тестов и, если все они будут пройдены, развернет ваш сайт с помощью сценария <code>publish-gh-pages</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="hosting-on-zeit-now"></a><a href="#hosting-on-zeit-now" 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>Hosting on ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site easily and connect it to <a href="https://zeit.co/github">GitHub</a> or <a href="https://zeit.co/gitlab">GitLab</a> to automatically receive a new deployment every time you push a commit.</p>

View file

@ -205,17 +205,17 @@
<p>Настройки <a href="/docs/ru/1.13.0/doc-markdown">подсветки синтаксиса</a>:</p>
<pre><code class="hljs css language-js">{
<span class="hljs-comment">// ...</span>
<span class="hljs-attr">highlight</span>: {
highlight: {
<span class="hljs-comment">// Наименование темы, используемой Highlight.js для подсветки кода.</span>
<span class="hljs-comment">// Вы можете просмотреть список поддерживаемых тем здесь: </span>
<span class="hljs-comment">// https://github.com/isagalaev/highlight.js/tree/master/src/styles</span>
<span class="hljs-attr">theme</span>: <span class="hljs-string">'default'</span>,
theme: <span class="hljs-string">'default'</span>,
<span class="hljs-comment">// Конкретная версия Highlight.js, которая будет использована.</span>
<span class="hljs-attr">version</span>: <span class="hljs-string">'9.12.0'</span>,
version: <span class="hljs-string">'9.12.0'</span>,
<span class="hljs-comment">// Промежуточное звено для передачи экземпляра Highlight.js в функцию, указанную здесь, позволяет зарегистрировать дополнительные языки для подсветки.</span>
<span class="hljs-attr">hljs</span>: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">highlightJsInstance</span>) </span>{
hljs: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">highlightJsInstance</span>) </span>{
<span class="hljs-comment">// ваш код</span>
},
@ -223,10 +223,10 @@
<span class="hljs-comment">// Будет использован, если язык не указан в верхней части блока с кодом. Вы можете просмотреть список поддкрживаемых языков здесь:</span>
<span class="hljs-comment">// https://github.com/isagalaev/highlight.js/tree/master/src/languages</span>
<span class="hljs-attr">defaultLang</span>: <span class="hljs-string">'javascript'</span>,
defaultLang: <span class="hljs-string">'javascript'</span>,
<span class="hljs-comment">// пользовательский URL файла CSS с темой, которую вы желаете использовать в Highlight.js. Если указан, поля `theme` и `version` будут проигнорированы.</span>
<span class="hljs-attr">themeUrl</span>: <span class="hljs-string">'http://foo.bar/custom.css'</span>
themeUrl: <span class="hljs-string">'http://foo.bar/custom.css'</span>
},
}
</code></pre>
@ -300,12 +300,12 @@
<span class="hljs-comment">// Для URL github.io, используйте url и baseUrl следующим образом:</span>
<span class="hljs-comment">// url: 'https://reasonml.github.io',</span>
<span class="hljs-comment">// baseUrl: '/reason-react/',</span>
<span class="hljs-attr">defaultVersionShown</span>: <span class="hljs-string">'1.0.0'</span>,
defaultVersionShown: <span class="hljs-string">'1.0.0'</span>,
<span class="hljs-attr">organizationName</span>: <span class="hljs-string">'facebook'</span>,
<span class="hljs-attr">projectName</span>: <span class="hljs-string">'docusaurus'</span>,
<span class="hljs-attr">noIndex</span>: <span class="hljs-literal">false</span>,
<span class="hljs-comment">// Если ссылки в навигационном меню не требуются -&gt; headerLinks: [],</span>
<span class="hljs-attr">headerLinks</span>: [
headerLinks: [
{<span class="hljs-attr">doc</span>: <span class="hljs-string">'doc1'</span>, <span class="hljs-attr">label</span>: <span class="hljs-string">'Docs'</span>},
{<span class="hljs-attr">page</span>: <span class="hljs-string">'help'</span>, <span class="hljs-attr">label</span>: <span class="hljs-string">'Help'</span>},
{<span class="hljs-attr">search</span>: <span class="hljs-literal">true</span>},

View file

@ -205,17 +205,17 @@
<p>Настройки <a href="/docs/ru/1.13.0/doc-markdown">подсветки синтаксиса</a>:</p>
<pre><code class="hljs css language-js">{
<span class="hljs-comment">// ...</span>
<span class="hljs-attr">highlight</span>: {
highlight: {
<span class="hljs-comment">// Наименование темы, используемой Highlight.js для подсветки кода.</span>
<span class="hljs-comment">// Вы можете просмотреть список поддерживаемых тем здесь: </span>
<span class="hljs-comment">// https://github.com/isagalaev/highlight.js/tree/master/src/styles</span>
<span class="hljs-attr">theme</span>: <span class="hljs-string">'default'</span>,
theme: <span class="hljs-string">'default'</span>,
<span class="hljs-comment">// Конкретная версия Highlight.js, которая будет использована.</span>
<span class="hljs-attr">version</span>: <span class="hljs-string">'9.12.0'</span>,
version: <span class="hljs-string">'9.12.0'</span>,
<span class="hljs-comment">// Промежуточное звено для передачи экземпляра Highlight.js в функцию, указанную здесь, позволяет зарегистрировать дополнительные языки для подсветки.</span>
<span class="hljs-attr">hljs</span>: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">highlightJsInstance</span>) </span>{
hljs: <span class="hljs-function"><span class="hljs-keyword">function</span>(<span class="hljs-params">highlightJsInstance</span>) </span>{
<span class="hljs-comment">// ваш код</span>
},
@ -223,10 +223,10 @@
<span class="hljs-comment">// Будет использован, если язык не указан в верхней части блока с кодом. Вы можете просмотреть список поддкрживаемых языков здесь:</span>
<span class="hljs-comment">// https://github.com/isagalaev/highlight.js/tree/master/src/languages</span>
<span class="hljs-attr">defaultLang</span>: <span class="hljs-string">'javascript'</span>,
defaultLang: <span class="hljs-string">'javascript'</span>,
<span class="hljs-comment">// пользовательский URL файла CSS с темой, которую вы желаете использовать в Highlight.js. Если указан, поля `theme` и `version` будут проигнорированы.</span>
<span class="hljs-attr">themeUrl</span>: <span class="hljs-string">'http://foo.bar/custom.css'</span>
themeUrl: <span class="hljs-string">'http://foo.bar/custom.css'</span>
},
}
</code></pre>
@ -300,12 +300,12 @@
<span class="hljs-comment">// Для URL github.io, используйте url и baseUrl следующим образом:</span>
<span class="hljs-comment">// url: 'https://reasonml.github.io',</span>
<span class="hljs-comment">// baseUrl: '/reason-react/',</span>
<span class="hljs-attr">defaultVersionShown</span>: <span class="hljs-string">'1.0.0'</span>,
defaultVersionShown: <span class="hljs-string">'1.0.0'</span>,
<span class="hljs-attr">organizationName</span>: <span class="hljs-string">'facebook'</span>,
<span class="hljs-attr">projectName</span>: <span class="hljs-string">'docusaurus'</span>,
<span class="hljs-attr">noIndex</span>: <span class="hljs-literal">false</span>,
<span class="hljs-comment">// Если ссылки в навигационном меню не требуются -&gt; headerLinks: [],</span>
<span class="hljs-attr">headerLinks</span>: [
headerLinks: [
{<span class="hljs-attr">doc</span>: <span class="hljs-string">'doc1'</span>, <span class="hljs-attr">label</span>: <span class="hljs-string">'Docs'</span>},
{<span class="hljs-attr">page</span>: <span class="hljs-string">'help'</span>, <span class="hljs-attr">label</span>: <span class="hljs-string">'Help'</span>},
{<span class="hljs-attr">search</span>: <span class="hljs-literal">true</span>},

View file

@ -208,20 +208,20 @@ 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">&amp;anchor</span>
<span class="hljs-attr">locale:</span>
<span class="hljs-attr">'de':</span> <span class="hljs-string">'de'</span>
<span class="hljs-attr">'es-ES':</span> <span class="hljs-string">'es-ES'</span>
<span class="hljs-attr">'fr':</span> <span class="hljs-string">'fr'</span>
<span class="hljs-attr">'ja':</span> <span class="hljs-string">'ja'</span>
<span class="hljs-attr">'ko':</span> <span class="hljs-string">'ko'</span>
<span class="hljs-attr">'mr':</span> <span class="hljs-string">'mr-IN'</span>
<span class="hljs-attr">'pt-BR':</span> <span class="hljs-string">'pt-BR'</span>
<span class="hljs-attr">'zh-CN':</span> <span class="hljs-string">'zh-CN'</span>
<span class="hljs-attr">'zh-TW':</span> <span class="hljs-string">'zh-TW'</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">&amp;anchor</span>
<span class="hljs-attr"> locale:</span>
<span class="hljs-attr"> 'de':</span> <span class="hljs-string">'de'</span>
<span class="hljs-attr"> 'es-ES':</span> <span class="hljs-string">'es-ES'</span>
<span class="hljs-attr"> 'fr':</span> <span class="hljs-string">'fr'</span>
<span class="hljs-attr"> 'ja':</span> <span class="hljs-string">'ja'</span>
<span class="hljs-attr"> 'ko':</span> <span class="hljs-string">'ko'</span>
<span class="hljs-attr"> 'mr':</span> <span class="hljs-string">'mr-IN'</span>
<span class="hljs-attr"> 'pt-BR':</span> <span class="hljs-string">'pt-BR'</span>
<span class="hljs-attr"> 'zh-CN':</span> <span class="hljs-string">'zh-CN'</span>
<span class="hljs-attr"> 'zh-TW':</span> <span class="hljs-string">'zh-TW'</span>
</code></pre>
<p>Вы можете посмотреть <a href="https://support.crowdin.com/configuration-file/">здесь</a> как настроить свой файл <code>crowdin.yaml</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="настройка-сценариев-crowdin"></a><a href="#настройка-сценариев-crowdin" 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>Настройка сценариев Crowdin</h3>
@ -257,18 +257,18 @@ 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">jobs:</span>
<span class="hljs-attr">deploy-website:</span>
<span class="hljs-attr">docker:</span>
<span class="hljs-attr"> deploy-website:</span>
<span class="hljs-attr"> docker:</span>
<span class="hljs-comment"># укажите версию для установки здесь</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"> - image:</span> <span class="hljs-string">circleci/node:8.11.1</span>
<span class="hljs-attr">steps:</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>
<span class="hljs-attr">command:</span> <span class="hljs-string">|
<span class="hljs-bullet"> -</span> <span class="hljs-string">checkout</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>
<span class="hljs-attr"> command:</span> <span class="hljs-string">|
git config --global user.email "&lt;GITHUB_USERNAME&gt;@users.noreply.github.com"
git config --global user.name "&lt;YOUR_NAME&gt;"
echo "machine github.com login &lt;GITHUB_USERNAME&gt; password $GITHUB_TOKEN" &gt; ~/.netrc
@ -283,13 +283,13 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
- crowdin --config crowdin.yaml download -b master
# сборка и публикация сайта
cd website &amp;&amp; GIT_USER=&lt;GIT_USER&gt; yarn run publish-gh-pages
</span>
<span class="hljs-attr">workflows:</span>
<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><span class="hljs-attr">workflows:</span>
<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-attr"> - deploy-website:</span>
<span class="hljs-comment"># filters: *filter-only-master</span>
</code></pre>
<p>Команда <code>crowdin</code> использует файл <code>crowdin.yaml</code>, созданный сценарием <code>examples</code>. Он должен быть размещен в каталоге вашего проекта для настройки того как файлы будут загружены/скачены.</p>
@ -298,10 +298,10 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
<p>Если вы желаете использовать Crowdin локально на своей машине, вы можете установить <a href="https://support.crowdin.com/cli-tool/">инструмент Crowdin CLI</a> и запустить те же команды, что указаны в файле <code>circle.yaml</code>. Единственная различие состоит в том, что вы должны установить значения <code>project_identifier</code> и <code>api_key</code> в файле <code>crowdin.yaml</code>, так как у вас не будет настроенных переменных окружения из Circle.</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>crowdin.yaml</code>:</p>
<pre><code class="hljs css language-yaml"> <span class="hljs-bullet">-</span>
<span class="hljs-attr">source:</span> <span class="hljs-string">'/website/versioned_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>
<pre><code class="hljs css language-yaml"><span class="hljs-bullet"> -</span>
<span class="hljs-attr"> source:</span> <span class="hljs-string">'/website/versioned_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>
</code></pre>
<p>Переведенные и версионированные документы будут размещены в каталоге <code>website/translated_docs/${language}/${version}/</code>.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.13.0/navigation"><span class="arrow-prev"></span><span>Навигация и боковые панели</span></a><a class="docs-next button" href="/docs/ru/1.13.0/versioning"><span>Версионирование</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#настройки-перевода-в-docusaurus">Настройки перевода в Docusaurus</a></li><li><a href="#перевод-уже-существующих-документов">Перевод уже существующих документов</a></li><li><a href="#подключение-перевода-на-страницах">Подключение перевода на страницах</a></li><li><a href="#сбор-строк-для-перевода">Сбор строк для перевода</a><ul class="toc-headings"><li><a href="#пользовательские-строки-перевода">Пользовательские строки перевода</a></li></ul></li><li><a href="#как-переводить-строки">Как переводить строки</a></li><li><a href="#как-docusaurus-использует-переводы-строк">Как Docusaurus использует переводы строк</a><ul class="toc-headings"><li><a href="#строки">Строки</a></li><li><a href="#файлы-markdown">Файлы Markdown</a></li><li><a href="#другие-страницы">Другие страницы</a></li></ul></li><li><a href="#crowdin">Crowdin</a><ul class="toc-headings"><li><a href="#настройка-сценариев-crowdin">Настройка сценариев Crowdin</a></li><li><a href="#ручная-синхронизация-файлов">Ручная синхронизация файлов</a></li><li><a href="#автоматическая-синхронизация-с-помощью-circleci">Автоматическая синхронизация с помощью CircleCI</a></li></ul></li><li><a href="#версионирование-и-перевод">Версионирование и перевод</a></li></ul></nav></div><footer class="nav-footer" id="footer"><section class="sitemap"><a href="/" class="nav-home"><img src="/img/docusaurus_monochrome.svg" alt="Docusaurus" width="66" height="58"/></a><div class="footerSection"><h5>Docs</h5><a href="

View file

@ -208,20 +208,20 @@ 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">&amp;anchor</span>
<span class="hljs-attr">locale:</span>
<span class="hljs-attr">'de':</span> <span class="hljs-string">'de'</span>
<span class="hljs-attr">'es-ES':</span> <span class="hljs-string">'es-ES'</span>
<span class="hljs-attr">'fr':</span> <span class="hljs-string">'fr'</span>
<span class="hljs-attr">'ja':</span> <span class="hljs-string">'ja'</span>
<span class="hljs-attr">'ko':</span> <span class="hljs-string">'ko'</span>
<span class="hljs-attr">'mr':</span> <span class="hljs-string">'mr-IN'</span>
<span class="hljs-attr">'pt-BR':</span> <span class="hljs-string">'pt-BR'</span>
<span class="hljs-attr">'zh-CN':</span> <span class="hljs-string">'zh-CN'</span>
<span class="hljs-attr">'zh-TW':</span> <span class="hljs-string">'zh-TW'</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">&amp;anchor</span>
<span class="hljs-attr"> locale:</span>
<span class="hljs-attr"> 'de':</span> <span class="hljs-string">'de'</span>
<span class="hljs-attr"> 'es-ES':</span> <span class="hljs-string">'es-ES'</span>
<span class="hljs-attr"> 'fr':</span> <span class="hljs-string">'fr'</span>
<span class="hljs-attr"> 'ja':</span> <span class="hljs-string">'ja'</span>
<span class="hljs-attr"> 'ko':</span> <span class="hljs-string">'ko'</span>
<span class="hljs-attr"> 'mr':</span> <span class="hljs-string">'mr-IN'</span>
<span class="hljs-attr"> 'pt-BR':</span> <span class="hljs-string">'pt-BR'</span>
<span class="hljs-attr"> 'zh-CN':</span> <span class="hljs-string">'zh-CN'</span>
<span class="hljs-attr"> 'zh-TW':</span> <span class="hljs-string">'zh-TW'</span>
</code></pre>
<p>Вы можете посмотреть <a href="https://support.crowdin.com/configuration-file/">здесь</a> как настроить свой файл <code>crowdin.yaml</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="настройка-сценариев-crowdin"></a><a href="#настройка-сценариев-crowdin" 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>Настройка сценариев Crowdin</h3>
@ -257,18 +257,18 @@ 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">jobs:</span>
<span class="hljs-attr">deploy-website:</span>
<span class="hljs-attr">docker:</span>
<span class="hljs-attr"> deploy-website:</span>
<span class="hljs-attr"> docker:</span>
<span class="hljs-comment"># укажите версию для установки здесь</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"> - image:</span> <span class="hljs-string">circleci/node:8.11.1</span>
<span class="hljs-attr">steps:</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>
<span class="hljs-attr">command:</span> <span class="hljs-string">|
<span class="hljs-bullet"> -</span> <span class="hljs-string">checkout</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>
<span class="hljs-attr"> command:</span> <span class="hljs-string">|
git config --global user.email "&lt;GITHUB_USERNAME&gt;@users.noreply.github.com"
git config --global user.name "&lt;YOUR_NAME&gt;"
echo "machine github.com login &lt;GITHUB_USERNAME&gt; password $GITHUB_TOKEN" &gt; ~/.netrc
@ -283,13 +283,13 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
- crowdin --config crowdin.yaml download -b master
# сборка и публикация сайта
cd website &amp;&amp; GIT_USER=&lt;GIT_USER&gt; yarn run publish-gh-pages
</span>
<span class="hljs-attr">workflows:</span>
<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><span class="hljs-attr">workflows:</span>
<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-attr"> - deploy-website:</span>
<span class="hljs-comment"># filters: *filter-only-master</span>
</code></pre>
<p>Команда <code>crowdin</code> использует файл <code>crowdin.yaml</code>, созданный сценарием <code>examples</code>. Он должен быть размещен в каталоге вашего проекта для настройки того как файлы будут загружены/скачены.</p>
@ -298,10 +298,10 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
<p>Если вы желаете использовать Crowdin локально на своей машине, вы можете установить <a href="https://support.crowdin.com/cli-tool/">инструмент Crowdin CLI</a> и запустить те же команды, что указаны в файле <code>circle.yaml</code>. Единственная различие состоит в том, что вы должны установить значения <code>project_identifier</code> и <code>api_key</code> в файле <code>crowdin.yaml</code>, так как у вас не будет настроенных переменных окружения из Circle.</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>crowdin.yaml</code>:</p>
<pre><code class="hljs css language-yaml"> <span class="hljs-bullet">-</span>
<span class="hljs-attr">source:</span> <span class="hljs-string">'/website/versioned_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>
<pre><code class="hljs css language-yaml"><span class="hljs-bullet"> -</span>
<span class="hljs-attr"> source:</span> <span class="hljs-string">'/website/versioned_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>
</code></pre>
<p>Переведенные и версионированные документы будут размещены в каталоге <code>website/translated_docs/${language}/${version}/</code>.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.13.0/navigation"><span class="arrow-prev"></span><span>Навигация и боковые панели</span></a><a class="docs-next button" href="/docs/ru/1.13.0/versioning"><span>Версионирование</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#настройки-перевода-в-docusaurus">Настройки перевода в Docusaurus</a></li><li><a href="#перевод-уже-существующих-документов">Перевод уже существующих документов</a></li><li><a href="#подключение-перевода-на-страницах">Подключение перевода на страницах</a></li><li><a href="#сбор-строк-для-перевода">Сбор строк для перевода</a><ul class="toc-headings"><li><a href="#пользовательские-строки-перевода">Пользовательские строки перевода</a></li></ul></li><li><a href="#как-переводить-строки">Как переводить строки</a></li><li><a href="#как-docusaurus-использует-переводы-строк">Как Docusaurus использует переводы строк</a><ul class="toc-headings"><li><a href="#строки">Строки</a></li><li><a href="#файлы-markdown">Файлы Markdown</a></li><li><a href="#другие-страницы">Другие страницы</a></li></ul></li><li><a href="#crowdin">Crowdin</a><ul class="toc-headings"><li><a href="#настройка-сценариев-crowdin">Настройка сценариев Crowdin</a></li><li><a href="#ручная-синхронизация-файлов">Ручная синхронизация файлов</a></li><li><a href="#автоматическая-синхронизация-с-помощью-circleci">Автоматическая синхронизация с помощью CircleCI</a></li></ul></li><li><a href="#версионирование-и-перевод">Версионирование и перевод</a></li></ul></nav></div><footer class="nav-footer" id="footer"><section class="sitemap"><a href="/" class="nav-home"><img src="/img/docusaurus_monochrome.svg" alt="Docusaurus" width="66" height="58"/></a><div class="footerSection"><h5>Docs</h5><a href="