Deploy website

Deploy website version based on 63e2720dff
This commit is contained in:
Website Deployment Script 2020-06-01 20:00:17 +00:00
parent 27bc09745a
commit 86b2a4d94e
42 changed files with 212 additions and 212 deletions

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.10.x/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.10.x/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.10.x/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.10.x/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -89,8 +89,8 @@
<h2><a class="anchor" aria-hidden="true" id="хостинг-статических-html-страниц"></a><a href="#хостинг-статических-html-страниц" 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>Хостинг статических HTML страниц</h2>
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>For example, both Apache and Nginx serve content from <code>/var/www/html</code> by default. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. In the case of Nginx, this would mean setting <code>include /etc/nginx/mime.types;</code> in your <code>nginx.conf</code> file. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>Например, Apache и Nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае Nginx это значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -98,20 +98,20 @@
<li><a href="#using-github-pages">GitHub Pages</a></li>
<li><a href="#hosting-on-netlify">Netlify</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
<p><strong>That's all.</strong> Your docs will automatically be deployed.</p>
<p><strong>Это все.</strong> Ваша документация будет автоматически развернута.</p>
<h3><a class="anchor" aria-hidden="true" id="использование-github-pages"></a><a href="#использование-github-pages" 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>Использование GitHub Pages</h3>
<p>Docusaurus был спроектирован так, чтобы действительно хорошо работать с одним из самых популярных хостинговых решений для проектов с открытым исходным кодом: <a href="https://pages.github.com/">GitHub Pages</a>.</p>
<h4><a class="anchor" aria-hidden="true" id="развертывание-на-github-pages"></a><a href="#развертывание-на-github-pages" 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>Развертывание на GitHub Pages</h4>
@ -243,7 +243,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -251,7 +251,7 @@
yarn run publish-gh-pages <span class="hljs-comment"># или `npm run publish-gh-pages`</span>
</code></pre>
<ul>
<li>Alternatively, you can work around this by creating a basic CircleCI config with the following contents:</li>
<li>Кроме того, вы можете обойти эту проблему, создав базовый файл настроек CircleCI со следующим содержимым:</li>
</ul>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># CircleCI 2.0 Config File</span>
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
@ -289,7 +289,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -318,7 +318,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.10.x/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.10.x/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.10.x/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.10.x/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -89,8 +89,8 @@
<h2><a class="anchor" aria-hidden="true" id="хостинг-статических-html-страниц"></a><a href="#хостинг-статических-html-страниц" 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>Хостинг статических HTML страниц</h2>
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>For example, both Apache and Nginx serve content from <code>/var/www/html</code> by default. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. In the case of Nginx, this would mean setting <code>include /etc/nginx/mime.types;</code> in your <code>nginx.conf</code> file. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>Например, Apache и Nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае Nginx это значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -98,20 +98,20 @@
<li><a href="#using-github-pages">GitHub Pages</a></li>
<li><a href="#hosting-on-netlify">Netlify</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
<p><strong>That's all.</strong> Your docs will automatically be deployed.</p>
<p><strong>Это все.</strong> Ваша документация будет автоматически развернута.</p>
<h3><a class="anchor" aria-hidden="true" id="использование-github-pages"></a><a href="#использование-github-pages" 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>Использование GitHub Pages</h3>
<p>Docusaurus был спроектирован так, чтобы действительно хорошо работать с одним из самых популярных хостинговых решений для проектов с открытым исходным кодом: <a href="https://pages.github.com/">GitHub Pages</a>.</p>
<h4><a class="anchor" aria-hidden="true" id="развертывание-на-github-pages"></a><a href="#развертывание-на-github-pages" 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>Развертывание на GitHub Pages</h4>
@ -243,7 +243,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -251,7 +251,7 @@
yarn run publish-gh-pages <span class="hljs-comment"># или `npm run publish-gh-pages`</span>
</code></pre>
<ul>
<li>Alternatively, you can work around this by creating a basic CircleCI config with the following contents:</li>
<li>Кроме того, вы можете обойти эту проблему, создав базовый файл настроек CircleCI со следующим содержимым:</li>
</ul>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># CircleCI 2.0 Config File</span>
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
@ -289,7 +289,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -318,7 +318,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.10.x/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.10.x/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.10.x/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.10.x/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.11.x/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.11.x/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.11.x/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.11.x/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -89,8 +89,8 @@
<h2><a class="anchor" aria-hidden="true" id="хостинг-статических-html-страниц"></a><a href="#хостинг-статических-html-страниц" 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>Хостинг статических HTML страниц</h2>
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>For example, both Apache and Nginx serve content from <code>/var/www/html</code> by default. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. In the case of Nginx, this would mean setting <code>include /etc/nginx/mime.types;</code> in your <code>nginx.conf</code> file. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>Например, Apache и Nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае Nginx это значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -98,20 +98,20 @@
<li><a href="#using-github-pages">GitHub Pages</a></li>
<li><a href="#hosting-on-netlify">Netlify</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
<p><strong>That's all.</strong> Your docs will automatically be deployed.</p>
<p><strong>Это все.</strong> Ваша документация будет автоматически развернута.</p>
<h3><a class="anchor" aria-hidden="true" id="использование-github-pages"></a><a href="#использование-github-pages" 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>Использование GitHub Pages</h3>
<p>Docusaurus был спроектирован так, чтобы действительно хорошо работать с одним из самых популярных хостинговых решений для проектов с открытым исходным кодом: <a href="https://pages.github.com/">GitHub Pages</a>.</p>
<h4><a class="anchor" aria-hidden="true" id="развертывание-на-github-pages"></a><a href="#развертывание-на-github-pages" 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>Развертывание на GitHub Pages</h4>
@ -243,7 +243,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -251,7 +251,7 @@
yarn run publish-gh-pages <span class="hljs-comment"># или `npm run publish-gh-pages`</span>
</code></pre>
<ul>
<li>Alternatively, you can work around this by creating a basic CircleCI config with the following contents:</li>
<li>Кроме того, вы можете обойти эту проблему, создав базовый файл настроек CircleCI со следующим содержимым:</li>
</ul>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># CircleCI 2.0 Config File</span>
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
@ -289,7 +289,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -318,7 +318,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.11.x/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.11.x/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.11.x/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.11.x/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -89,8 +89,8 @@
<h2><a class="anchor" aria-hidden="true" id="хостинг-статических-html-страниц"></a><a href="#хостинг-статических-html-страниц" 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>Хостинг статических HTML страниц</h2>
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>For example, both Apache and Nginx serve content from <code>/var/www/html</code> by default. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. In the case of Nginx, this would mean setting <code>include /etc/nginx/mime.types;</code> in your <code>nginx.conf</code> file. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>Например, Apache и Nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае Nginx это значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -98,20 +98,20 @@
<li><a href="#using-github-pages">GitHub Pages</a></li>
<li><a href="#hosting-on-netlify">Netlify</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
<p><strong>That's all.</strong> Your docs will automatically be deployed.</p>
<p><strong>Это все.</strong> Ваша документация будет автоматически развернута.</p>
<h3><a class="anchor" aria-hidden="true" id="использование-github-pages"></a><a href="#использование-github-pages" 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>Использование GitHub Pages</h3>
<p>Docusaurus был спроектирован так, чтобы действительно хорошо работать с одним из самых популярных хостинговых решений для проектов с открытым исходным кодом: <a href="https://pages.github.com/">GitHub Pages</a>.</p>
<h4><a class="anchor" aria-hidden="true" id="развертывание-на-github-pages"></a><a href="#развертывание-на-github-pages" 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>Развертывание на GitHub Pages</h4>
@ -243,7 +243,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -251,7 +251,7 @@
yarn run publish-gh-pages <span class="hljs-comment"># или `npm run publish-gh-pages`</span>
</code></pre>
<ul>
<li>Alternatively, you can work around this by creating a basic CircleCI config with the following contents:</li>
<li>Кроме того, вы можете обойти эту проблему, создав базовый файл настроек CircleCI со следующим содержимым:</li>
</ul>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># CircleCI 2.0 Config File</span>
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
@ -289,7 +289,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -318,7 +318,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.11.x/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.11.x/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.11.x/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.11.x/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.12.0/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.12.0/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.12.0/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.12.0/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -89,8 +89,8 @@
<h2><a class="anchor" aria-hidden="true" id="хостинг-статических-html-страниц"></a><a href="#хостинг-статических-html-страниц" 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>Хостинг статических HTML страниц</h2>
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>For example, both Apache and Nginx serve content from <code>/var/www/html</code> by default. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. In the case of Nginx, this would mean setting <code>include /etc/nginx/mime.types;</code> in your <code>nginx.conf</code> file. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>Например, Apache и Nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае Nginx это значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -99,20 +99,20 @@
<li><a href="#hosting-on-netlify">Netlify</a></li>
<li><a href="#hosting-on-render">Render</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
<p><strong>That's all.</strong> Your docs will automatically be deployed.</p>
<p><strong>Это все.</strong> Ваша документация будет автоматически развернута.</p>
<h3><a class="anchor" aria-hidden="true" id="использование-github-pages"></a><a href="#использование-github-pages" 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>Использование GitHub Pages</h3>
<p>Docusaurus был спроектирован так, чтобы действительно хорошо работать с одним из самых популярных хостинговых решений для проектов с открытым исходным кодом: <a href="https://pages.github.com/">GitHub Pages</a>.</p>
<h4><a class="anchor" aria-hidden="true" id="развертывание-на-github-pages"></a><a href="#развертывание-на-github-pages" 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>Развертывание на GitHub Pages</h4>
@ -244,7 +244,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -252,7 +252,7 @@
yarn run publish-gh-pages <span class="hljs-comment"># или `npm run publish-gh-pages`</span>
</code></pre>
<ul>
<li>Alternatively, you can work around this by creating a basic CircleCI config with the following contents:</li>
<li>Кроме того, вы можете обойти эту проблему, создав базовый файл настроек CircleCI со следующим содержимым:</li>
</ul>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># CircleCI 2.0 Config File</span>
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
@ -290,7 +290,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -308,7 +308,7 @@
<li>Нажмите на <strong>Deploy site</strong></li>
</ol>
<p>Вы также можете настроить Netlify для построения сайта после каждого коммита в вашем репозитории, или только для коммитов в ветке <code>master</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="hosting-on-render"></a><a href="#hosting-on-render" 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 Render</h3>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-render"></a><a href="#хостинг-на-render" 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>Хостинг на Render</h3>
<p>Render offers free <a href="https://render.com/docs/static-sites">static site</a> hosting with fully managed SSL, custom domains, a global CDN and continuous auto deploys from your Git repo. Deploy your app in just a few minutes by following these steps.</p>
<ol>
<li><p>Create a new <strong>Web Service</strong> on Render, and give Render's GitHub app permission to access your Docusaurus repo.</p></li>
@ -344,7 +344,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.12.0/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.12.0/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#hosting-on-render">Hosting on Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.12.0/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.12.0/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#хостинг-на-render">Хостинг на Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -89,8 +89,8 @@
<h2><a class="anchor" aria-hidden="true" id="хостинг-статических-html-страниц"></a><a href="#хостинг-статических-html-страниц" 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>Хостинг статических HTML страниц</h2>
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>For example, both Apache and Nginx serve content from <code>/var/www/html</code> by default. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. In the case of Nginx, this would mean setting <code>include /etc/nginx/mime.types;</code> in your <code>nginx.conf</code> file. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>Например, Apache и Nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае Nginx это значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -99,20 +99,20 @@
<li><a href="#hosting-on-netlify">Netlify</a></li>
<li><a href="#hosting-on-render">Render</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
<p><strong>That's all.</strong> Your docs will automatically be deployed.</p>
<p><strong>Это все.</strong> Ваша документация будет автоматически развернута.</p>
<h3><a class="anchor" aria-hidden="true" id="использование-github-pages"></a><a href="#использование-github-pages" 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>Использование GitHub Pages</h3>
<p>Docusaurus был спроектирован так, чтобы действительно хорошо работать с одним из самых популярных хостинговых решений для проектов с открытым исходным кодом: <a href="https://pages.github.com/">GitHub Pages</a>.</p>
<h4><a class="anchor" aria-hidden="true" id="развертывание-на-github-pages"></a><a href="#развертывание-на-github-pages" 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>Развертывание на GitHub Pages</h4>
@ -244,7 +244,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -252,7 +252,7 @@
yarn run publish-gh-pages <span class="hljs-comment"># или `npm run publish-gh-pages`</span>
</code></pre>
<ul>
<li>Alternatively, you can work around this by creating a basic CircleCI config with the following contents:</li>
<li>Кроме того, вы можете обойти эту проблему, создав базовый файл настроек CircleCI со следующим содержимым:</li>
</ul>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># CircleCI 2.0 Config File</span>
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
@ -290,7 +290,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -308,7 +308,7 @@
<li>Нажмите на <strong>Deploy site</strong></li>
</ol>
<p>Вы также можете настроить Netlify для построения сайта после каждого коммита в вашем репозитории, или только для коммитов в ветке <code>master</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="hosting-on-render"></a><a href="#hosting-on-render" 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 Render</h3>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-render"></a><a href="#хостинг-на-render" 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>Хостинг на Render</h3>
<p>Render offers free <a href="https://render.com/docs/static-sites">static site</a> hosting with fully managed SSL, custom domains, a global CDN and continuous auto deploys from your Git repo. Deploy your app in just a few minutes by following these steps.</p>
<ol>
<li><p>Create a new <strong>Web Service</strong> on Render, and give Render's GitHub app permission to access your Docusaurus repo.</p></li>
@ -344,7 +344,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.12.0/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.12.0/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#hosting-on-render">Hosting on Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.12.0/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.12.0/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#хостинг-на-render">Хостинг на Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.13.0/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.13.0/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.13.0/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.13.0/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -89,8 +89,8 @@
<h2><a class="anchor" aria-hidden="true" id="хостинг-статических-html-страниц"></a><a href="#хостинг-статических-html-страниц" 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>Хостинг статических HTML страниц</h2>
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>For example, both Apache and Nginx serve content from <code>/var/www/html</code> by default. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. In the case of Nginx, this would mean setting <code>include /etc/nginx/mime.types;</code> in your <code>nginx.conf</code> file. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>Например, Apache и Nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае Nginx это значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -99,20 +99,20 @@
<li><a href="#hosting-on-netlify">Netlify</a></li>
<li><a href="#hosting-on-render">Render</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
<p><strong>That's all.</strong> Your docs will automatically be deployed.</p>
<p><strong>Это все.</strong> Ваша документация будет автоматически развернута.</p>
<h3><a class="anchor" aria-hidden="true" id="использование-github-pages"></a><a href="#использование-github-pages" 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>Использование GitHub Pages</h3>
<p>Docusaurus был спроектирован так, чтобы действительно хорошо работать с одним из самых популярных хостинговых решений для проектов с открытым исходным кодом: <a href="https://pages.github.com/">GitHub Pages</a>.</p>
<h4><a class="anchor" aria-hidden="true" id="развертывание-на-github-pages"></a><a href="#развертывание-на-github-pages" 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>Развертывание на GitHub Pages</h4>
@ -244,7 +244,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -252,7 +252,7 @@
yarn run publish-gh-pages <span class="hljs-comment"># или `npm run publish-gh-pages`</span>
</code></pre>
<ul>
<li>Alternatively, you can work around this by creating a basic CircleCI config with the following contents:</li>
<li>Кроме того, вы можете обойти эту проблему, создав базовый файл настроек CircleCI со следующим содержимым:</li>
</ul>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># CircleCI 2.0 Config File</span>
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
@ -290,7 +290,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -308,7 +308,7 @@
<li>Нажмите на <strong>Deploy site</strong></li>
</ol>
<p>Вы также можете настроить Netlify для построения сайта после каждого коммита в вашем репозитории, или только для коммитов в ветке <code>master</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="hosting-on-render"></a><a href="#hosting-on-render" 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 Render</h3>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-render"></a><a href="#хостинг-на-render" 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>Хостинг на Render</h3>
<p>Render offers free <a href="https://render.com/docs/static-sites">static site</a> hosting with fully managed SSL, custom domains, a global CDN and continuous auto deploys from your Git repo. Deploy your app in just a few minutes by following these steps.</p>
<ol>
<li><p>Create a new <strong>Web Service</strong> on Render, and give Render's GitHub app permission to access your Docusaurus repo.</p></li>
@ -344,7 +344,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.13.0/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.13.0/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#hosting-on-render">Hosting on Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.13.0/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.13.0/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#хостинг-на-render">Хостинг на Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -89,8 +89,8 @@
<h2><a class="anchor" aria-hidden="true" id="хостинг-статических-html-страниц"></a><a href="#хостинг-статических-html-страниц" 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>Хостинг статических HTML страниц</h2>
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>For example, both Apache and Nginx serve content from <code>/var/www/html</code> by default. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. In the case of Nginx, this would mean setting <code>include /etc/nginx/mime.types;</code> in your <code>nginx.conf</code> file. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>Например, Apache и Nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае Nginx это значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -99,20 +99,20 @@
<li><a href="#hosting-on-netlify">Netlify</a></li>
<li><a href="#hosting-on-render">Render</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
<p><strong>That's all.</strong> Your docs will automatically be deployed.</p>
<p><strong>Это все.</strong> Ваша документация будет автоматически развернута.</p>
<h3><a class="anchor" aria-hidden="true" id="использование-github-pages"></a><a href="#использование-github-pages" 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>Использование GitHub Pages</h3>
<p>Docusaurus был спроектирован так, чтобы действительно хорошо работать с одним из самых популярных хостинговых решений для проектов с открытым исходным кодом: <a href="https://pages.github.com/">GitHub Pages</a>.</p>
<h4><a class="anchor" aria-hidden="true" id="развертывание-на-github-pages"></a><a href="#развертывание-на-github-pages" 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>Развертывание на GitHub Pages</h4>
@ -244,7 +244,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -252,7 +252,7 @@
yarn run publish-gh-pages <span class="hljs-comment"># или `npm run publish-gh-pages`</span>
</code></pre>
<ul>
<li>Alternatively, you can work around this by creating a basic CircleCI config with the following contents:</li>
<li>Кроме того, вы можете обойти эту проблему, создав базовый файл настроек CircleCI со следующим содержимым:</li>
</ul>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># CircleCI 2.0 Config File</span>
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
@ -290,7 +290,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -308,7 +308,7 @@
<li>Нажмите на <strong>Deploy site</strong></li>
</ol>
<p>Вы также можете настроить Netlify для построения сайта после каждого коммита в вашем репозитории, или только для коммитов в ветке <code>master</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="hosting-on-render"></a><a href="#hosting-on-render" 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 Render</h3>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-render"></a><a href="#хостинг-на-render" 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>Хостинг на Render</h3>
<p>Render offers free <a href="https://render.com/docs/static-sites">static site</a> hosting with fully managed SSL, custom domains, a global CDN and continuous auto deploys from your Git repo. Deploy your app in just a few minutes by following these steps.</p>
<ol>
<li><p>Create a new <strong>Web Service</strong> on Render, and give Render's GitHub app permission to access your Docusaurus repo.</p></li>
@ -344,7 +344,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.13.0/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.13.0/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#hosting-on-render">Hosting on Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.13.0/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.13.0/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#хостинг-на-render">Хостинг на Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.9.x/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.9.x/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.9.x/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.9.x/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -90,7 +90,7 @@
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>Например, Apache и nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае nginx эо значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае nginx эо значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -98,20 +98,20 @@
<li><a href="#using-github-pages">GitHub Pages</a></li>
<li><a href="#hosting-on-netlify">Netlify</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
<p><strong>That's all.</strong> Your docs will automatically be deployed.</p>
<p><strong>Это все.</strong> Ваша документация будет автоматически развернута.</p>
<h3><a class="anchor" aria-hidden="true" id="использование-github-pages"></a><a href="#использование-github-pages" 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>Использование GitHub Pages</h3>
<p>Docusaurus был спроектирован так, чтобы действительно хорошо работать с одним из самых популярных хостинговых решений для проектов с открытым исходным кодом: <a href="https://pages.github.com/">GitHub Pages</a>.</p>
<h4><a class="anchor" aria-hidden="true" id="развертывание-на-github-pages"></a><a href="#развертывание-на-github-pages" 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>Развертывание на GitHub Pages</h4>
@ -243,7 +243,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -289,7 +289,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -318,7 +318,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.9.x/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.9.x/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.9.x/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.9.x/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -90,7 +90,7 @@
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>Например, Apache и nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае nginx эо значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае nginx эо значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -98,20 +98,20 @@
<li><a href="#using-github-pages">GitHub Pages</a></li>
<li><a href="#hosting-on-netlify">Netlify</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
<p><strong>That's all.</strong> Your docs will automatically be deployed.</p>
<p><strong>Это все.</strong> Ваша документация будет автоматически развернута.</p>
<h3><a class="anchor" aria-hidden="true" id="использование-github-pages"></a><a href="#использование-github-pages" 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>Использование GitHub Pages</h3>
<p>Docusaurus был спроектирован так, чтобы действительно хорошо работать с одним из самых популярных хостинговых решений для проектов с открытым исходным кодом: <a href="https://pages.github.com/">GitHub Pages</a>.</p>
<h4><a class="anchor" aria-hidden="true" id="развертывание-на-github-pages"></a><a href="#развертывание-на-github-pages" 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>Развертывание на GitHub Pages</h4>
@ -243,7 +243,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -289,7 +289,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -318,7 +318,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.9.x/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.9.x/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/1.9.x/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/1.9.x/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -88,7 +88,7 @@
<li><code>id</code>: Уникальный идентификатор документа. Если это поле не указано, то в качестве значения поля <code>id</code> будет по-умолчанию использовано наименование файла (без расширения).</li>
<li><code>title</code>: Заголовок вашего документа. Если это поле не указано, в качестве значения поля <code>title</code> по-умолчанию будет использовано поле <code>id</code>.</li>
<li><code>hide_title</code>: Следует ли скрыть заголовок в верхней части документа.</li>
<li><code>description</code>: The description of your document which will become the <code>&lt;meta name=&quot;description&quot; content=&quot;...&quot;/&gt;</code> and <code>&lt;meta property=&quot;og:description&quot; content=&quot;...&quot;/&gt;</code> in <code>&lt;head&gt;</code>, used by search engines. If this field is not present, it will default to the first line of the contents.</li>
<li><code>description</code>: Описание документа, которое будет преобразовано в теги <code>&lt;meta name=&quot;description&quot; content=&quot;...&quot;/&gt;</code> и <code>&lt;meta property=&quot;og:description&quot; content=&quot;...&quot;/&gt;</code> в <code>&lt;head&gt;</code>, используемые поисковыми системами. Если это поле отсутствует, то по-умолчанию в качестве описания будет взята первая строка текста документа.</li>
<li><code>sidebar_label</code>: Текст, отображаемый в боковой панелт документа и кнопках &quot;вперед&quot;/&quot;назад&quot; для этого документа. Если это поле не указано, в качестве значения поля <code>sidebar_label</code> по-умолчанию будет использовано поле <code>title</code>.</li>
</ul>
<p>Например:</p>

View file

@ -88,7 +88,7 @@
<li><code>id</code>: Уникальный идентификатор документа. Если это поле не указано, то в качестве значения поля <code>id</code> будет по-умолчанию использовано наименование файла (без расширения).</li>
<li><code>title</code>: Заголовок вашего документа. Если это поле не указано, в качестве значения поля <code>title</code> по-умолчанию будет использовано поле <code>id</code>.</li>
<li><code>hide_title</code>: Следует ли скрыть заголовок в верхней части документа.</li>
<li><code>description</code>: The description of your document which will become the <code>&lt;meta name=&quot;description&quot; content=&quot;...&quot;/&gt;</code> and <code>&lt;meta property=&quot;og:description&quot; content=&quot;...&quot;/&gt;</code> in <code>&lt;head&gt;</code>, used by search engines. If this field is not present, it will default to the first line of the contents.</li>
<li><code>description</code>: Описание документа, которое будет преобразовано в теги <code>&lt;meta name=&quot;description&quot; content=&quot;...&quot;/&gt;</code> и <code>&lt;meta property=&quot;og:description&quot; content=&quot;...&quot;/&gt;</code> в <code>&lt;head&gt;</code>, используемые поисковыми системами. Если это поле отсутствует, то по-умолчанию в качестве описания будет взята первая строка текста документа.</li>
<li><code>sidebar_label</code>: Текст, отображаемый в боковой панелт документа и кнопках &quot;вперед&quot;/&quot;назад&quot; для этого документа. Если это поле не указано, в качестве значения поля <code>sidebar_label</code> по-умолчанию будет использовано поле <code>title</code>.</li>
</ul>
<p>Например:</p>

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -88,7 +88,7 @@
<li><code>id</code>: Уникальный идентификатор документа. Если это поле не указано, то в качестве значения поля <code>id</code> будет по-умолчанию использовано наименование файла (без расширения).</li>
<li><code>title</code>: Заголовок вашего документа. Если это поле не указано, в качестве значения поля <code>title</code> по-умолчанию будет использовано поле <code>id</code>.</li>
<li><code>hide_title</code>: Следует ли скрыть заголовок в верхней части документа.</li>
<li><code>description</code>: The description of your document which will become the <code>&lt;meta name=&quot;description&quot; content=&quot;...&quot;/&gt;</code> and <code>&lt;meta property=&quot;og:description&quot; content=&quot;...&quot;/&gt;</code> in <code>&lt;head&gt;</code>, used by search engines. If this field is not present, it will default to the first line of the contents.</li>
<li><code>description</code>: Описание документа, которое будет преобразовано в теги <code>&lt;meta name=&quot;description&quot; content=&quot;...&quot;/&gt;</code> и <code>&lt;meta property=&quot;og:description&quot; content=&quot;...&quot;/&gt;</code> в <code>&lt;head&gt;</code>, используемые поисковыми системами. Если это поле отсутствует, то по-умолчанию в качестве описания будет взята первая строка текста документа.</li>
<li><code>sidebar_label</code>: Текст, отображаемый в боковой панелт документа и кнопках &quot;вперед&quot;/&quot;назад&quot; для этого документа. Если это поле не указано, в качестве значения поля <code>sidebar_label</code> по-умолчанию будет использовано поле <code>title</code>.</li>
</ul>
<p>Например:</p>

View file

@ -88,7 +88,7 @@
<li><code>id</code>: Уникальный идентификатор документа. Если это поле не указано, то в качестве значения поля <code>id</code> будет по-умолчанию использовано наименование файла (без расширения).</li>
<li><code>title</code>: Заголовок вашего документа. Если это поле не указано, в качестве значения поля <code>title</code> по-умолчанию будет использовано поле <code>id</code>.</li>
<li><code>hide_title</code>: Следует ли скрыть заголовок в верхней части документа.</li>
<li><code>description</code>: The description of your document which will become the <code>&lt;meta name=&quot;description&quot; content=&quot;...&quot;/&gt;</code> and <code>&lt;meta property=&quot;og:description&quot; content=&quot;...&quot;/&gt;</code> in <code>&lt;head&gt;</code>, used by search engines. If this field is not present, it will default to the first line of the contents.</li>
<li><code>description</code>: Описание документа, которое будет преобразовано в теги <code>&lt;meta name=&quot;description&quot; content=&quot;...&quot;/&gt;</code> и <code>&lt;meta property=&quot;og:description&quot; content=&quot;...&quot;/&gt;</code> в <code>&lt;head&gt;</code>, используемые поисковыми системами. Если это поле отсутствует, то по-умолчанию в качестве описания будет взята первая строка текста документа.</li>
<li><code>sidebar_label</code>: Текст, отображаемый в боковой панелт документа и кнопках &quot;вперед&quot;/&quot;назад&quot; для этого документа. Если это поле не указано, в качестве значения поля <code>sidebar_label</code> по-умолчанию будет использовано поле <code>title</code>.</li>
</ul>
<p>Например:</p>

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/next/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/next/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -83,7 +83,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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Docker</h1></header><article><div><span><p><a href="https://www.docker.com/">Docker</a> это инструмент, позволяющий вам создавать, развертывать и управлять легковесными, самостоятельными пакетами, которые содержат все необходимое для запуска приложения. Он помогает избегать конфликта зависимостей и нежелательного поведения при запуске Docusaurus.</p>
<h2><a class="anchor" aria-hidden="true" id="запуск-локального-веб-сервера-в-docker"></a><a href="#запуск-локального-веб-сервера-в-docker" 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>Запуск локального веб-сервера в Docker</h2>
<p>Убедитесь, что <a href="https://www.docker.com/get-started">docker</a> уже установлен.</p>
<p>Для запуска лакального веб-сервера:</p>
<p>Для запуска локального веб-сервера:</p>
<ol>
<li><p><strong>Постройте снимок docker</strong> -- Перейдите в каталог, в котором установлен Docusaurus. Выполните в терминале <code>docker build -t docusaurus-doc .</code></p>
<p>Когда снимок будет создан, вы может проверить, что он существует, выполнив <code>docker images</code>.</p>
@ -94,7 +94,7 @@
<p>В результате docker создаст и запустит контейнер на основе снимка <code>docusaurus-doc</code>. Чтобы увидеть подробную информацию о контейнере, выполните в терминале <code>docker ps</code>.</p></li>
</ol>
<h2><a class="anchor" aria-hidden="true" id="использование-docker-compose"></a><a href="#использование-docker-compose" 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>Использование docker-compose</h2>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. This feature of docker allows you to run the web server and any additional services with a single command.</p>
<p>Также для настройки приложения можно использовать <code>docker-compose</code>. Данная особенность docker позволяет запускать веб-сервер и дополнительные сервисы с помощью единственной команды.</p>
<blockquote>
<p>Compose это инструмент для определения и запуска приложения Docker, состоящего из множества контейнеров. Вместе с Compose вы используете YAML файл для настройки сервисов вашего приложения. Затем, с помощью единственной команды, вы создаете и запускаете все сервисы из вашей конфигурации.</p>
</blockquote>
@ -125,7 +125,7 @@
<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>
<p>Чтобы запустить локальный веб-сервер с помощью <code>docker-compose</code> выполните в терминале <code>docker-compose up</code>.</p>
<p>Чтобы создать статические HTML страницы для публикации, выполните <code>docker-compose run docusaurus bash -c 'yarn publish-gh-pages'</code></p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/next/publishing"><span class="arrow-prev"></span><span>Публикация вашего сайта</span></a><a class="docs-next button" href="/docs/ru/next/adding-blog"><span>Добавление блога</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#запуск-локального-веб-сервера-в-docker">Запуск локального веб-сервера в Docker</a></li><li><a href="#использование-docker-compose">Использование docker-compose</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="
/docs/ru/installation">Getting Started</a><a href="

View file

@ -89,8 +89,8 @@
<h2><a class="anchor" aria-hidden="true" id="хостинг-статических-html-страниц"></a><a href="#хостинг-статических-html-страниц" 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>Хостинг статических HTML страниц</h2>
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>For example, both Apache and Nginx serve content from <code>/var/www/html</code> by default. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. In the case of Nginx, this would mean setting <code>include /etc/nginx/mime.types;</code> in your <code>nginx.conf</code> file. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>Например, Apache и Nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае Nginx это значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -99,20 +99,20 @@
<li><a href="#hosting-on-netlify">Netlify</a></li>
<li><a href="#hosting-on-render">Render</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple of seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
<p><strong>That's all.</strong> Your docs will automatically be deployed.</p>
<p><strong>Это все.</strong> Ваша документация будет автоматически развернута.</p>
<blockquote>
<p>Note that the directory structure Now supports is slightly different from the default directory structure of a Docusaurus project - The <code>docs</code> directory has to be within the <code>website</code> directory, ideally following the directory structure in this example. You will also have to specify a <code>customDocsPath</code> value in <code>siteConfig.js</code>. Take a look at the <a href="https://github.com/zeit/now-examples/tree/master/docusaurus">now-examples repository for a Docusaurus project</a>.</p>
</blockquote>
@ -135,7 +135,7 @@
</thead>
<tbody>
<tr><td><code>organizationName</code></td><td>GitHub пользователь или организация, являющаяся владельцем репозитория. Если вы владелец проекта, то эта настройка - наименование вашей учетной записи на GitHub. В случае Docusaurus, это организация GitHub &quot;<em>facebook</em>&quot;.</td></tr>
<tr><td><code>projectName</code></td><td>Наименование репозитория GitHub для вашего проекта. For example, the source code for Docusaurus is hosted at <a href="https://github.com/facebook/docusaurus">https://github.com/facebook/docusaurus</a>, so our project name, in this case, would be &quot;docusaurus&quot;.</td></tr>
<tr><td><code>projectName</code></td><td>Наименование репозитория GitHub для вашего проекта. Например, исходный код Docusaurus размещен по адресу <a href="https://github.com/facebook/docusaurus">https://github.com/facebook/docusaurus</a>, поэтому наш проект в этом случае будет называться «docusaurus».</td></tr>
<tr><td><code>url</code></td><td>URL-aдрес вашего сайта. Для проектов, размещенных на GitHub pages, это значение должно быть равным &quot;https://<em>username</em>.github.io&quot;</td></tr>
<tr><td><code>baseUrl</code></td><td>Базовый URL-адрес для вашего проекта. Для проектов, размещенных на GitHub pages, это значение должно иметь вид &quot;/<em>projectName</em>/&quot;. Для <a href="https://github.com/facebook/docusaurus">https://github.com/facebook/docusaurus</a>, <code>baseUrl</code> равен <code>/docusaurus/</code>.</td></tr>
</tbody>
@ -162,7 +162,7 @@
<tr><th>Наименование</th><th>Описание</th></tr>
</thead>
<tbody>
<tr><td><code>GIT_USER</code></td><td>The username for a GitHub account that has to commit access to this repo. For your repositories, this will usually be your own GitHub username. Указанный <code>GIT_USER</code> должен иметь доступ к хранилищу, указанному в комбинации <code>organizationName</code> и <code>projectName</code>.</td></tr>
<tr><td><code>GIT_USER</code></td><td>Имя пользователя для учётной записи GitHub, которая имеет доступ к данному репозиторию. Для ваших собственных репозиториев это будет обычное имя пользователя GitHub. Указанный <code>GIT_USER</code> должен иметь доступ к хранилищу, указанному в комбинации <code>organizationName</code> и <code>projectName</code>.</td></tr>
</tbody>
</table>
<p>Чтобы запустить скрипт непосредственно из командной строки, вы можете использовать следующую команду, заполняя значения параметров соответствующим образом.</p>
@ -191,7 +191,7 @@
<p>Вы можете запустить приведенную выше команду в любое время, когда вы обновляете документы и хотите развернуть изменения на своем сайте. Запуск сценария вручную может быть полезен для сайтов, на которых документация редко изменяется, и не следует забывать о том, что нужно вручную вносить изменения.</p>
<p>Однако вы можете автоматизировать процесс публикации с помощью непрерывной интеграции (CI).</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>Службы непрерывной интеграции (CI) обычно используются для выполнения рутинных задач всякий раз, когда новые коммиты регистрируются в системе контроля версий. Этими задачами могут быть любое сочетание запуска модульных и интеграционных тестов, автоматизации сборок, публикации пакетов в NPM и, конечно же, развертывания изменений на вашем веб-сайте. All you need to do to automate the deployment of your website is to invoke the <code>publish-gh-pages</code> script whenever your docs get updated. В следующем разделе мы расскажем, как это сделать, используя <a href="https://circleci.com/">Circle CI</a>, популярного поставщика услуг непрерывной интеграции.</p>
<p>Службы непрерывной интеграции (CI) обычно используются для выполнения рутинных задач всякий раз, когда новые коммиты регистрируются в системе контроля версий. Этими задачами могут быть любое сочетание запуска модульных и интеграционных тестов, автоматизации сборок, публикации пакетов в NPM и, конечно же, развертывания изменений на вашем веб-сайте. Все, что вам нужно сделать для автоматизации развертывания вашего сайта, - это запускать сценарий <code>publish-gh-pages</code> всякий раз, когда ваши документы обновляются. В следующем разделе мы расскажем, как это сделать, используя <a href="https://circleci.com/">Circle CI</a>, популярного поставщика услуг непрерывной интеграции.</p>
<h3><a class="anchor" aria-hidden="true" id="using-circleci-20"></a><a href="#using-circleci-20" 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>Using CircleCI 2.0</h3>
<p>Если вы еще этого не сделали, вы можете <a href="https://circleci.com/signup/">установить CircleCI</a> для своего проекта с открытым исходным кодом. После этого, чтобы включить автоматическое развертывание вашего сайта и документации через CircleCI, просто настройте Circle для запуска сценария <code>publish-gh-pages</code> на этапе развертывания. Для настройки вы можете выполнить следующие шаги.</p>
<ol>
@ -203,8 +203,8 @@
<li>Создайте каталог <code>.circleci</code> и <code>config.yml</code> в этом каталоге.</li>
<li>Скопируйте приведенный ниже текст в <code>.circleci/config.yml</code>.</li>
</ol>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># If you only want the circle to run on direct commits to master, you can uncomment this out</span>
<span class="hljs-comment"># and uncomment the filters: *filter-only-master down below too</span>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># Если вы желаете запускать circle только на прямых коммитах в master, вы можете раскомментировать эту секцию</span>
<span class="hljs-comment"># также раскомментируйте строку filters: *filter-only-master ниже</span>
<span class="hljs-comment">#</span>
<span class="hljs-comment"># aliases:</span>
<span class="hljs-comment"># - &amp;filter-only-master</span>
@ -216,7 +216,7 @@
<span class="hljs-attr">jobs:</span>
<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-comment"># укажите здесь версию, которую желаете использовать</span>
<span class="hljs-bullet">-</span> <span class="hljs-attr">image:</span> <span class="hljs-string">circleci/node:8.11.1</span>
@ -251,7 +251,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -259,7 +259,7 @@
yarn run publish-gh-pages <span class="hljs-comment"># или `npm run publish-gh-pages`</span>
</code></pre>
<ul>
<li>Alternatively, you can work around this by creating a basic CircleCI config with the following contents:</li>
<li>Кроме того, вы можете обойти эту проблему, создав базовый файл настроек CircleCI со следующим содержимым:</li>
</ul>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># CircleCI 2.0 Config File</span>
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
@ -297,7 +297,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -313,7 +313,7 @@
<li><p>Нажмите на <strong>Deploy site</strong></p></li>
</ol>
<p>Вы также можете настроить Netlify для построения сайта после каждого коммита в вашем репозитории, или только для коммитов в ветке <code>master</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="hosting-on-render"></a><a href="#hosting-on-render" 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 Render</h3>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-render"></a><a href="#хостинг-на-render" 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>Хостинг на Render</h3>
<p>Render offers free <a href="https://render.com/docs/static-sites">static site</a> hosting with fully managed SSL, custom domains, a global CDN and continuous auto deploy from your Git repo. Deploy your app in just a few minutes by following these steps.</p>
<ol>
<li><p>Create a new <strong>Web Service</strong> on Render, and give Render's GitHub app permission to access your Docusaurus repo.</p></li>
@ -349,7 +349,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/next/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/next/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#hosting-on-render">Hosting on Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/next/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/next/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#хостинг-на-render">Хостинг на Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -89,8 +89,8 @@
<h2><a class="anchor" aria-hidden="true" id="хостинг-статических-html-страниц"></a><a href="#хостинг-статических-html-страниц" 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>Хостинг статических HTML страниц</h2>
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>For example, both Apache and Nginx serve content from <code>/var/www/html</code> by default. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. In the case of Nginx, this would mean setting <code>include /etc/nginx/mime.types;</code> in your <code>nginx.conf</code> file. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>Например, Apache и Nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае Nginx это значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -99,20 +99,20 @@
<li><a href="#hosting-on-netlify">Netlify</a></li>
<li><a href="#hosting-on-render">Render</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple of seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
<p><strong>That's all.</strong> Your docs will automatically be deployed.</p>
<p><strong>Это все.</strong> Ваша документация будет автоматически развернута.</p>
<blockquote>
<p>Note that the directory structure Now supports is slightly different from the default directory structure of a Docusaurus project - The <code>docs</code> directory has to be within the <code>website</code> directory, ideally following the directory structure in this example. You will also have to specify a <code>customDocsPath</code> value in <code>siteConfig.js</code>. Take a look at the <a href="https://github.com/zeit/now-examples/tree/master/docusaurus">now-examples repository for a Docusaurus project</a>.</p>
</blockquote>
@ -135,7 +135,7 @@
</thead>
<tbody>
<tr><td><code>organizationName</code></td><td>GitHub пользователь или организация, являющаяся владельцем репозитория. Если вы владелец проекта, то эта настройка - наименование вашей учетной записи на GitHub. В случае Docusaurus, это организация GitHub &quot;<em>facebook</em>&quot;.</td></tr>
<tr><td><code>projectName</code></td><td>Наименование репозитория GitHub для вашего проекта. For example, the source code for Docusaurus is hosted at <a href="https://github.com/facebook/docusaurus">https://github.com/facebook/docusaurus</a>, so our project name, in this case, would be &quot;docusaurus&quot;.</td></tr>
<tr><td><code>projectName</code></td><td>Наименование репозитория GitHub для вашего проекта. Например, исходный код Docusaurus размещен по адресу <a href="https://github.com/facebook/docusaurus">https://github.com/facebook/docusaurus</a>, поэтому наш проект в этом случае будет называться «docusaurus».</td></tr>
<tr><td><code>url</code></td><td>URL-aдрес вашего сайта. Для проектов, размещенных на GitHub pages, это значение должно быть равным &quot;https://<em>username</em>.github.io&quot;</td></tr>
<tr><td><code>baseUrl</code></td><td>Базовый URL-адрес для вашего проекта. Для проектов, размещенных на GitHub pages, это значение должно иметь вид &quot;/<em>projectName</em>/&quot;. Для <a href="https://github.com/facebook/docusaurus">https://github.com/facebook/docusaurus</a>, <code>baseUrl</code> равен <code>/docusaurus/</code>.</td></tr>
</tbody>
@ -162,7 +162,7 @@
<tr><th>Наименование</th><th>Описание</th></tr>
</thead>
<tbody>
<tr><td><code>GIT_USER</code></td><td>The username for a GitHub account that has to commit access to this repo. For your repositories, this will usually be your own GitHub username. Указанный <code>GIT_USER</code> должен иметь доступ к хранилищу, указанному в комбинации <code>organizationName</code> и <code>projectName</code>.</td></tr>
<tr><td><code>GIT_USER</code></td><td>Имя пользователя для учётной записи GitHub, которая имеет доступ к данному репозиторию. Для ваших собственных репозиториев это будет обычное имя пользователя GitHub. Указанный <code>GIT_USER</code> должен иметь доступ к хранилищу, указанному в комбинации <code>organizationName</code> и <code>projectName</code>.</td></tr>
</tbody>
</table>
<p>Чтобы запустить скрипт непосредственно из командной строки, вы можете использовать следующую команду, заполняя значения параметров соответствующим образом.</p>
@ -191,7 +191,7 @@
<p>Вы можете запустить приведенную выше команду в любое время, когда вы обновляете документы и хотите развернуть изменения на своем сайте. Запуск сценария вручную может быть полезен для сайтов, на которых документация редко изменяется, и не следует забывать о том, что нужно вручную вносить изменения.</p>
<p>Однако вы можете автоматизировать процесс публикации с помощью непрерывной интеграции (CI).</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>Службы непрерывной интеграции (CI) обычно используются для выполнения рутинных задач всякий раз, когда новые коммиты регистрируются в системе контроля версий. Этими задачами могут быть любое сочетание запуска модульных и интеграционных тестов, автоматизации сборок, публикации пакетов в NPM и, конечно же, развертывания изменений на вашем веб-сайте. All you need to do to automate the deployment of your website is to invoke the <code>publish-gh-pages</code> script whenever your docs get updated. В следующем разделе мы расскажем, как это сделать, используя <a href="https://circleci.com/">Circle CI</a>, популярного поставщика услуг непрерывной интеграции.</p>
<p>Службы непрерывной интеграции (CI) обычно используются для выполнения рутинных задач всякий раз, когда новые коммиты регистрируются в системе контроля версий. Этими задачами могут быть любое сочетание запуска модульных и интеграционных тестов, автоматизации сборок, публикации пакетов в NPM и, конечно же, развертывания изменений на вашем веб-сайте. Все, что вам нужно сделать для автоматизации развертывания вашего сайта, - это запускать сценарий <code>publish-gh-pages</code> всякий раз, когда ваши документы обновляются. В следующем разделе мы расскажем, как это сделать, используя <a href="https://circleci.com/">Circle CI</a>, популярного поставщика услуг непрерывной интеграции.</p>
<h3><a class="anchor" aria-hidden="true" id="using-circleci-20"></a><a href="#using-circleci-20" 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>Using CircleCI 2.0</h3>
<p>Если вы еще этого не сделали, вы можете <a href="https://circleci.com/signup/">установить CircleCI</a> для своего проекта с открытым исходным кодом. После этого, чтобы включить автоматическое развертывание вашего сайта и документации через CircleCI, просто настройте Circle для запуска сценария <code>publish-gh-pages</code> на этапе развертывания. Для настройки вы можете выполнить следующие шаги.</p>
<ol>
@ -203,8 +203,8 @@
<li>Создайте каталог <code>.circleci</code> и <code>config.yml</code> в этом каталоге.</li>
<li>Скопируйте приведенный ниже текст в <code>.circleci/config.yml</code>.</li>
</ol>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># If you only want the circle to run on direct commits to master, you can uncomment this out</span>
<span class="hljs-comment"># and uncomment the filters: *filter-only-master down below too</span>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># Если вы желаете запускать circle только на прямых коммитах в master, вы можете раскомментировать эту секцию</span>
<span class="hljs-comment"># также раскомментируйте строку filters: *filter-only-master ниже</span>
<span class="hljs-comment">#</span>
<span class="hljs-comment"># aliases:</span>
<span class="hljs-comment"># - &amp;filter-only-master</span>
@ -216,7 +216,7 @@
<span class="hljs-attr">jobs:</span>
<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-comment"># укажите здесь версию, которую желаете использовать</span>
<span class="hljs-bullet">-</span> <span class="hljs-attr">image:</span> <span class="hljs-string">circleci/node:8.11.1</span>
@ -251,7 +251,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -259,7 +259,7 @@
yarn run publish-gh-pages <span class="hljs-comment"># или `npm run publish-gh-pages`</span>
</code></pre>
<ul>
<li>Alternatively, you can work around this by creating a basic CircleCI config with the following contents:</li>
<li>Кроме того, вы можете обойти эту проблему, создав базовый файл настроек CircleCI со следующим содержимым:</li>
</ul>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># CircleCI 2.0 Config File</span>
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
@ -297,7 +297,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -313,7 +313,7 @@
<li><p>Нажмите на <strong>Deploy site</strong></p></li>
</ol>
<p>Вы также можете настроить Netlify для построения сайта после каждого коммита в вашем репозитории, или только для коммитов в ветке <code>master</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="hosting-on-render"></a><a href="#hosting-on-render" 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 Render</h3>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-render"></a><a href="#хостинг-на-render" 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>Хостинг на Render</h3>
<p>Render offers free <a href="https://render.com/docs/static-sites">static site</a> hosting with fully managed SSL, custom domains, a global CDN and continuous auto deploy from your Git repo. Deploy your app in just a few minutes by following these steps.</p>
<ol>
<li><p>Create a new <strong>Web Service</strong> on Render, and give Render's GitHub app permission to access your Docusaurus repo.</p></li>
@ -349,7 +349,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/next/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/next/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#hosting-on-render">Hosting on Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/next/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/next/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#хостинг-на-render">Хостинг на Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -1,4 +1,4 @@
<!DOCTYPE html><html lang="ru"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Перевод и локализация · 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 для перевода пользователями из сообщества. Страницы верхнего уровня, написанные на английском, могут быть переведены на другие языки, если вы обернете каждую строку, которую вы желаете перевести, в тег `&lt;translate&gt;`. Другие заголовки и метки также будут обнаружены и переведены должным образом."/><meta name="docsearch:version" content="next"/><meta name="docsearch:language" content="ru"/><meta property="og:title" content="Перевод и локализация · 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 для перевода пользователями из сообщества. Страницы верхнего уровня, написанные на английском, могут быть переведены на другие языки, если вы обернете каждую строку, которую вы желаете перевести, в тег `&lt;translate&gt;`. Другие заголовки и метки также будут обнаружены и переведены должным образом."/><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="ru"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Перевод и локализация · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus предоставляет функционал для удобного перевода текста с помощью [Crowdin](https://crowdin.com/). Файлы документации, написанные на английском языке, загружаются на Crowdin для перевода пользователями из сообщества. Страницы верхнего уровня, написанные на английском, могут быть переведены на другие языки, если вы обернете каждую строку, которую вы желаете перевести, в тег `&lt;translate&gt;`. Другие заголовки и метки также будут обнаружены и переведены должным образом."/><meta name="docsearch:version" content="next"/><meta name="docsearch:language" content="ru"/><meta property="og:title" content="Перевод и локализация · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus предоставляет функционал для удобного перевода текста с помощью [Crowdin](https://crowdin.com/). Файлы документации, написанные на английском языке, загружаются на Crowdin для перевода пользователями из сообщества. Страницы верхнего уровня, написанные на английском, могут быть переведены на другие языки, если вы обернете каждую строку, которую вы желаете перевести, в тег `&lt;translate&gt;`. Другие заголовки и метки также будут обнаружены и переведены должным образом."/><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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Перевод и локализация</h1></header><article><div><span><p>Docusaurus allows for useful translation functionality using <a href="https://crowdin.com/">Crowdin</a>. Файлы документации, написанные на английском языке, загружаются на Crowdin для перевода пользователями из сообщества. Страницы верхнего уровня, написанные на английском, могут быть переведены на другие языки, если вы обернете каждую строку, которую вы желаете перевести, в тег <code>&lt;translate&gt;</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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Перевод и локализация</h1></header><article><div><span><p>Docusaurus предоставляет функционал для удобного перевода текста с помощью <a href="https://crowdin.com/">Crowdin</a>. Файлы документации, написанные на английском языке, загружаются на Crowdin для перевода пользователями из сообщества. Страницы верхнего уровня, написанные на английском, могут быть переведены на другие языки, если вы обернете каждую строку, которую вы желаете перевести, в тег <code>&lt;translate&gt;</code>. Другие заголовки и метки также будут обнаружены и переведены должным образом.</p>
<h2><a class="anchor" aria-hidden="true" id="настройки-перевода-в-docusaurus"></a><a href="#настройки-перевода-в-docusaurus" 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>Настройки перевода в Docusaurus</h2>
<p>Чтобы создать примеры файлов для перевода с помощью Docusaurus, запустите сценарий <code>examples</code> с параметром командной строки <code>translations</code>:</p>
<pre><code class="hljs css language-bash">npm run examples translations

View file

@ -1,4 +1,4 @@
<!DOCTYPE html><html lang="ru"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Перевод и локализация · 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 для перевода пользователями из сообщества. Страницы верхнего уровня, написанные на английском, могут быть переведены на другие языки, если вы обернете каждую строку, которую вы желаете перевести, в тег `&lt;translate&gt;`. Другие заголовки и метки также будут обнаружены и переведены должным образом."/><meta name="docsearch:version" content="next"/><meta name="docsearch:language" content="ru"/><meta property="og:title" content="Перевод и локализация · 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 для перевода пользователями из сообщества. Страницы верхнего уровня, написанные на английском, могут быть переведены на другие языки, если вы обернете каждую строку, которую вы желаете перевести, в тег `&lt;translate&gt;`. Другие заголовки и метки также будут обнаружены и переведены должным образом."/><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="ru"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Перевод и локализация · Docusaurus</title><meta name="viewport" content="width=device-width"/><meta name="generator" content="Docusaurus"/><meta name="description" content="Docusaurus предоставляет функционал для удобного перевода текста с помощью [Crowdin](https://crowdin.com/). Файлы документации, написанные на английском языке, загружаются на Crowdin для перевода пользователями из сообщества. Страницы верхнего уровня, написанные на английском, могут быть переведены на другие языки, если вы обернете каждую строку, которую вы желаете перевести, в тег `&lt;translate&gt;`. Другие заголовки и метки также будут обнаружены и переведены должным образом."/><meta name="docsearch:version" content="next"/><meta name="docsearch:language" content="ru"/><meta property="og:title" content="Перевод и локализация · Docusaurus"/><meta property="og:type" content="website"/><meta property="og:url" content="https://docusaurus.io/"/><meta property="og:description" content="Docusaurus предоставляет функционал для удобного перевода текста с помощью [Crowdin](https://crowdin.com/). Файлы документации, написанные на английском языке, загружаются на Crowdin для перевода пользователями из сообщества. Страницы верхнего уровня, написанные на английском, могут быть переведены на другие языки, если вы обернете каждую строку, которую вы желаете перевести, в тег `&lt;translate&gt;`. Другие заголовки и метки также будут обнаружены и переведены должным образом."/><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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Перевод и локализация</h1></header><article><div><span><p>Docusaurus allows for useful translation functionality using <a href="https://crowdin.com/">Crowdin</a>. Файлы документации, написанные на английском языке, загружаются на Crowdin для перевода пользователями из сообщества. Страницы верхнего уровня, написанные на английском, могут быть переведены на другие языки, если вы обернете каждую строку, которую вы желаете перевести, в тег <code>&lt;translate&gt;</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/ru" target="_blank" rel="noreferrer noopener">Translate</a><h1 id="__docusaurus" class="postHeaderTitle">Перевод и локализация</h1></header><article><div><span><p>Docusaurus предоставляет функционал для удобного перевода текста с помощью <a href="https://crowdin.com/">Crowdin</a>. Файлы документации, написанные на английском языке, загружаются на Crowdin для перевода пользователями из сообщества. Страницы верхнего уровня, написанные на английском, могут быть переведены на другие языки, если вы обернете каждую строку, которую вы желаете перевести, в тег <code>&lt;translate&gt;</code>. Другие заголовки и метки также будут обнаружены и переведены должным образом.</p>
<h2><a class="anchor" aria-hidden="true" id="настройки-перевода-в-docusaurus"></a><a href="#настройки-перевода-в-docusaurus" 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>Настройки перевода в Docusaurus</h2>
<p>Чтобы создать примеры файлов для перевода с помощью Docusaurus, запустите сценарий <code>examples</code> с параметром командной строки <code>translations</code>:</p>
<pre><code class="hljs css language-bash">npm run examples translations

View file

@ -89,10 +89,10 @@
<h2><a class="anchor" aria-hidden="true" id="хостинг-статических-html-страниц"></a><a href="#хостинг-статических-html-страниц" 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>Хостинг статических HTML страниц</h2>
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>For example, both Apache and Nginx serve content from <code>/var/www/html</code> by default. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>Например, Apache и Nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
</blockquote>
<blockquote>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. In the case of Nginx, this would mean setting <code>include /etc/nginx/mime.types;</code> in your <code>nginx.conf</code> file. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае Nginx это значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -101,16 +101,16 @@
<li><a href="#hosting-on-netlify">Netlify</a></li>
<li><a href="#hosting-on-render">Render</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
@ -252,7 +252,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -260,7 +260,7 @@
yarn run publish-gh-pages <span class="hljs-comment"># или `npm run publish-gh-pages`</span>
</code></pre>
<ul>
<li>Alternatively, you can work around this by creating a basic CircleCI config with the following contents:</li>
<li>Кроме того, вы можете обойти эту проблему, создав базовый файл настроек CircleCI со следующим содержимым:</li>
</ul>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># CircleCI 2.0 Config File</span>
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
@ -298,7 +298,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -314,7 +314,7 @@
<li><p>Click <strong>Deploy site</strong></p></li>
</ol>
<p>Вы также можете настроить Netlify для построения сайта после каждого коммита в вашем репозитории, или только для коммитов в ветке <code>master</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="hosting-on-render"></a><a href="#hosting-on-render" 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 Render</h3>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-render"></a><a href="#хостинг-на-render" 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>Хостинг на Render</h3>
<p>Render offers free <a href="https://render.com/docs/static-sites">static site</a> hosting with fully managed SSL, custom domains, a global CDN and continuous auto deploys from your Git repo. Deploy your app in just a few minutes by following these steps.</p>
<ol>
<li><p>Create a new <strong>Web Service</strong> on Render, and give Render's GitHub app permission to access your Docusaurus repo.</p></li>
@ -349,7 +349,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#hosting-on-render">Hosting on Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#хостинг-на-render">Хостинг на Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -89,10 +89,10 @@
<h2><a class="anchor" aria-hidden="true" id="хостинг-статических-html-страниц"></a><a href="#хостинг-статических-html-страниц" 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>Хостинг статических HTML страниц</h2>
<p>На этом этапе вы можете взять все файлы из каталога <code>website/build</code> и скопировать их в каталог <code>html</code> на вашем любимом веб-сервере.</p>
<blockquote>
<p>For example, both Apache and Nginx serve content from <code>/var/www/html</code> by default. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
<p>Например, Apache и Nginx обслуживают содержимое каталога <code>/var/www/html</code> по-умолчанию. Впрочем, выбор веб-сервера или провайдера выходит за рамки Docusaurus.</p>
</blockquote>
<blockquote>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. In the case of Nginx, this would mean setting <code>include /etc/nginx/mime.types;</code> in your <code>nginx.conf</code> file. See <a href="https://github.com/facebook/docusaurus/issues/602">this issue</a> for more info.</p>
<p>При предоставлении доступа к своему сайту через ваш собственный веб-сервер, убедитесь, что сервер передает статические ресурсы с корректными HTTP заголовками. Файлы css должны быть переданы с заголовком <code>content-type</code>, имеющий значение <code>text/css</code>. В случае Nginx это значит, что вам следует добавить строку <code>include /etc/nginx/mime.types;</code> в файл <code>nginx.conf</code>. Просмотрите <a href="https://github.com/facebook/docusaurus/issues/602">это обращение</a> для получения дополнительной информации.</p>
</blockquote>
<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>
<ul>
@ -101,16 +101,16 @@
<li><a href="#hosting-on-netlify">Netlify</a></li>
<li><a href="#hosting-on-render">Render</a></li>
</ul>
<h3><a class="anchor" aria-hidden="true" id="using-zeit-now"></a><a href="#using-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>Using ZEIT Now</h3>
<h3><a class="anchor" aria-hidden="true" id="использование-zeit-now"></a><a href="#использование-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>Использование ZEIT Now</h3>
<p>Deploying your Docusaurus project to <a href="https://zeit.co/now">ZEIT Now</a> will provide you with <a href="https://zeit.co/now">various benefits</a> in the areas of performance and ease of use.</p>
<p>Most importantly, however, deploying a Docusaurus project only takes a couple seconds:</p>
<ol>
<li>First, install their <a href="https://zeit.co/download">command-line interface</a>:</li>
<li>Сначала установите <a href="https://zeit.co/download">интерфейс командной строки</a>:</li>
</ol>
<pre><code class="hljs css language-bash">npm i -g now
</code></pre>
<ol start="2">
<li>Run a single command inside the root directory of your project:</li>
<li>Запустите команду внутри корневого каталога вашего проекта:</li>
</ol>
<pre><code class="hljs css language-bash">now
</code></pre>
@ -252,7 +252,7 @@
</blockquote>
<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>
<p>When initially deploying to a <code>gh-pages</code> branch using CircleCI, you may notice that some jobs triggered by commits to the <code>gh-pages</code> branch fail to run successfully due to a lack of tests (This can also result in chat/slack build failure notifications).</p>
<p>You can work around this by:</p>
<p>Вы легко можете обойти это следующим образом:</p>
<ul>
<li>Установите значение переменной окружения <code>CUSTOM_COMMIT_MESSAGE</code> для сценария <code>publish-gh-pages</code> равной <code>[skip ci]</code>. Например:</li>
</ul>
@ -260,7 +260,7 @@
yarn run publish-gh-pages <span class="hljs-comment"># или `npm run publish-gh-pages`</span>
</code></pre>
<ul>
<li>Alternatively, you can work around this by creating a basic CircleCI config with the following contents:</li>
<li>Кроме того, вы можете обойти эту проблему, создав базовый файл настроек CircleCI со следующим содержимым:</li>
</ul>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># CircleCI 2.0 Config File</span>
<span class="hljs-comment"># This config file will prevent tests from being run on the gh-pages branch.</span>
@ -298,7 +298,7 @@
<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>
<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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-zeit-now"></a><a href="#хостинг-на-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>Хостинг на ZEIT Now</h3>
<p>With <a href="#using-zeit-now">ZEIT Now</a>, you can deploy your site 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>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-netlify"></a><a href="#хостинг-на-netlify" 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>Хостинг на Netlify</h3>
<p>Шаги по настройке вашего Docusaurus-сайта на Netlify.</p>
@ -314,7 +314,7 @@
<li><p>Click <strong>Deploy site</strong></p></li>
</ol>
<p>Вы также можете настроить Netlify для построения сайта после каждого коммита в вашем репозитории, или только для коммитов в ветке <code>master</code>.</p>
<h3><a class="anchor" aria-hidden="true" id="hosting-on-render"></a><a href="#hosting-on-render" 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 Render</h3>
<h3><a class="anchor" aria-hidden="true" id="хостинг-на-render"></a><a href="#хостинг-на-render" 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>Хостинг на Render</h3>
<p>Render offers free <a href="https://render.com/docs/static-sites">static site</a> hosting with fully managed SSL, custom domains, a global CDN and continuous auto deploys from your Git repo. Deploy your app in just a few minutes by following these steps.</p>
<ol>
<li><p>Create a new <strong>Web Service</strong> on Render, and give Render's GitHub app permission to access your Docusaurus repo.</p></li>
@ -349,7 +349,7 @@
</tbody>
</table>
<p>Добавьте в <code>siteConfig.js</code> поле <code>'githubHost'</code>, которое будет содержать наименование хоста на GitHub Enterprise. Также вместо этого вы можете указать переменную окружения <code>GITHUB_HOST</code> при вызове команды публикации.</p>
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#using-zeit-now">Using ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#hosting-on-zeit-now">Hosting on ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#hosting-on-render">Hosting on Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
</span></div></article></div><div class="docs-prevnext"><a class="docs-prev button" href="/docs/ru/site-creation"><span class="arrow-prev"></span><span>Создание вашего сайта</span></a><a class="docs-next button" href="/docs/ru/docker"><span>Docker</span><span class="arrow-next"></span></a></div></div></div><nav class="onPageNav"><ul class="toc-headings"><li><a href="#создание-статических-html-страниц">Создание статических HTML страниц</a></li><li><a href="#хостинг-статических-html-страниц">Хостинг статических HTML страниц</a><ul class="toc-headings"><li><a href="#хостинг-на-сервисах">Хостинг на сервисах:</a></li><li><a href="#использование-zeit-now">Использование ZEIT Now</a></li><li><a href="#использование-github-pages">Использование GitHub Pages</a></li></ul></li><li><a href="#автоматизация-развертываний-с-использованием-непрерывной-интеграции">Автоматизация развертываний с использованием непрерывной интеграции</a><ul class="toc-headings"><li><a href="#using-circleci-20">Using CircleCI 2.0</a></li><li><a href="#советы-и-трюки">Советы и трюки</a></li><li><a href="#использование-travis-ci">Использование Travis CI</a></li><li><a href="#хостинг-на-zeit-now">Хостинг на ZEIT Now</a></li><li><a href="#хостинг-на-netlify">Хостинг на Netlify</a></li><li><a href="#хостинг-на-render">Хостинг на Render</a></li><li><a href="#публикация-на-github-enterprise">Публикация на GitHub Enterprise</a></li></ul></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="
/docs/ru/installation">Getting Started</a><a href="
/docs/ru/versioning">Versioning</a><a href="
/docs/ru/translation">Localization</a><a href="

View file

@ -24,7 +24,7 @@
languagesDropDown.className = "hide";
}
});
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/en/installation">Get Started</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>Powered by Markdown</p>
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="announcement"><div class="announcement-inner">Black Lives Matter.<a href="https://support.eji.org/give/153413/#!/donation/checkout"> Support the Equal Justice Initiative</a>.</div></div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/en/installation">Get Started</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>Powered by Markdown</p>
</span></div></h2><div><span><p>Save time and focus on your project's documentation. Simply
write docs and blog posts with <a href="/docs/en/doc-markdown">Markdown</a>
and Docusaurus will publish a set of static html files ready

View file

@ -24,7 +24,7 @@
languagesDropDown.className = "hide";
}
});
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/fr/installation">Premiers Pas</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>Propulsé par Markdown</p>
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="announcement"><div class="announcement-inner">Black Lives Matter.<a href="https://support.eji.org/give/153413/#!/donation/checkout"> Support the Equal Justice Initiative</a>.</div></div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/fr/installation">Premiers Pas</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>Propulsé par Markdown</p>
</span></div></h2><div><span><p>Save time and focus on your project's documentation. Simply
write docs and blog posts with <a href="/docs/fr/doc-markdown">Markdown</a>
and Docusaurus will publish a set of static html files ready

View file

@ -24,7 +24,7 @@
languagesDropDown.className = "hide";
}
});
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/en/installation">Get Started</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>Powered by Markdown</p>
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="announcement"><div class="announcement-inner">Black Lives Matter.<a href="https://support.eji.org/give/153413/#!/donation/checkout"> Support the Equal Justice Initiative</a>.</div></div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/en/installation">Get Started</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>Powered by Markdown</p>
</span></div></h2><div><span><p>Save time and focus on your project's documentation. Simply
write docs and blog posts with <a href="/docs/en/doc-markdown">Markdown</a>
and Docusaurus will publish a set of static html files ready

View file

@ -24,7 +24,7 @@
languagesDropDown.className = "hide";
}
});
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/ko/installation">시작하기</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>마크다운에 의한 작동</p>
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="announcement"><div class="announcement-inner">Black Lives Matter.<a href="https://support.eji.org/give/153413/#!/donation/checkout"> Support the Equal Justice Initiative</a>.</div></div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/ko/installation">시작하기</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>마크다운에 의한 작동</p>
</span></div></h2><div><span><p>Save time and focus on your project's documentation. Simply
write docs and blog posts with <a href="/docs/ko/doc-markdown">Markdown</a>
and Docusaurus will publish a set of static html files ready

View file

@ -24,7 +24,7 @@
languagesDropDown.className = "hide";
}
});
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/pt-BR/installation">Guia de introdução</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>Baseado em Markdown</p>
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="announcement"><div class="announcement-inner">Black Lives Matter.<a href="https://support.eji.org/give/153413/#!/donation/checkout"> Support the Equal Justice Initiative</a>.</div></div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/pt-BR/installation">Guia de introdução</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>Baseado em Markdown</p>
</span></div></h2><div><span><p>Save time and focus on your project's documentation. Simply
write docs and blog posts with <a href="/docs/pt-BR/doc-markdown">Markdown</a>
and Docusaurus will publish a set of static html files ready

View file

@ -24,7 +24,7 @@
languagesDropDown.className = "hide";
}
});
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/ro/installation">Get Started</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>Powered by Markdown</p>
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="announcement"><div class="announcement-inner">Black Lives Matter.<a href="https://support.eji.org/give/153413/#!/donation/checkout"> Support the Equal Justice Initiative</a>.</div></div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/ro/installation">Get Started</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>Powered by Markdown</p>
</span></div></h2><div><span><p>Save time and focus on your project's documentation. Simply
write docs and blog posts with <a href="/docs/ro/doc-markdown">Markdown</a>
and Docusaurus will publish a set of static html files ready

View file

@ -24,7 +24,7 @@
languagesDropDown.className = "hide";
}
});
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/ru/installation">Начало работы</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>Работает на Markdown</p>
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="announcement"><div class="announcement-inner">Black Lives Matter.<a href="https://support.eji.org/give/153413/#!/donation/checkout"> Support the Equal Justice Initiative</a>.</div></div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/ru/installation">Начало работы</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>Работает на Markdown</p>
</span></div></h2><div><span><p>Save time and focus on your project's documentation. Simply
write docs and blog posts with <a href="/docs/ru/doc-markdown">Markdown</a>
and Docusaurus will publish a set of static html files ready

View file

@ -24,7 +24,7 @@
languagesDropDown.className = "hide";
}
});
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/zh-CN/installation">开始</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>由 Markdown 驱动</p>
</script></span><li class="navSearchWrapper reactNavSearchWrapper"><input type="text" id="search_input_react" placeholder="Search" title="Search"/></li></ul></nav></div></header></div></div><div class="navPusher"><div><div class="announcement"><div class="announcement-inner">Black Lives Matter.<a href="https://support.eji.org/give/153413/#!/donation/checkout"> Support the Equal Justice Initiative</a>.</div></div><div class="index-hero"><div class="index-hero-inner"><h1 class="index-hero-project-tagline"><img alt="Docusaurus with Keytar" class="index-hero-logo" src="/img/docusaurus_keytar.svg"/>Docusaurus makes it easy to maintain <span class="index-hero-project-keywords">Open Source</span> documentation websites.</h1><div class="index-ctas"><a class="button index-ctas-get-started-button" href="/docs/zh-CN/installation">开始</a><span class="index-ctas-github-button"><iframe src="https://ghbtns.com/github-btn.html?user=facebook&amp;repo=docusaurus&amp;type=star&amp;count=true&amp;size=large" frameBorder="0" scrolling="0" width="160" height="30" title="GitHub Stars"></iframe></span></div></div></div><div class="announcement"><div class="announcement-inner">If you don&#x27;t need advanced features such as versioning or translations, try out <a href="https://v2.docusaurus.io">Docusaurus 2</a> instead! Contribute to its roadmap by suggesting features or <a href="https://v2.docusaurus.io/feedback/">giving feedback here</a>!</div></div><div class="mainContainer"><div class="container lightBackground paddingBottom paddingTop"><div class="wrapper"><div class="gridBlock"><div class="blockElement alignCenter imageAlignTop threeByGridBlock"><div class="blockImage"><img src="/img/undraw_typewriter.svg" alt="Markdown"/></div><div class="blockContent"><h2><div><span><p>由 Markdown 驱动</p>
</span></div></h2><div><span><p>Save time and focus on your project's documentation. Simply
write docs and blog posts with <a href="/docs/zh-CN/doc-markdown">Markdown</a>
and Docusaurus will publish a set of static html files ready