3pp-mirror/docusaurus
1
0
Fork 0
mirror of https://github.com/facebook/docusaurus.git synced 2025-08-03 16:59:06 +02:00
Code Issues Projects Releases Packages Wiki Activity

Deploy website

Browse source 
Deploy website version based on a78f703366
This commit is contained in:
Website Deployment Script 2020-07-24 11:07:34 +00:00
parent e2ecb6de98
commit 18f1f10c1d
238 changed files with 1820 additions and 1646 deletions
Download patch file Download diff file Expand all files Collapse all files

32
docs/ru/translation/index.html
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>Translations &amp; Localization · 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="1.14.4"/><meta name="docsearch:language" content="ru"/><meta property="og:title" content="Translations &amp; Localization · 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>
<!DOCTYPE html><html lang="ru"><head><meta charSet="utf-8"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><title>Translations &amp; Localization · 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="1.14.4"/><meta name="docsearch:language" content="ru"/><meta property="og:title" content="Translations &amp; Localization · 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">Translations &amp; Localization</h1></header><article><div><span><p>Docusaurus предоставляет функционал для легкого перевода текста с помощью <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">Translations &amp; Localization</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
@ -189,10 +189,10 @@ languages.js
<h3><a class="anchor" aria-hidden="true" id="файлы-markdown"></a><a href="#файлы-markdown" 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>Файлы Markdown</h3>
<p>Переведенные версии файлов документации загружаются и собираются с помощью соответствующего шаблона макета.</p>
<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>Для других страниц, Docusaurus автоматически преобразует все теги <code>&amp;lt;translate&amp;gt;</code>, которые найдет в вызовах функций и вернет переведенные строки из соответствующего файла <em><code>locale.json</code></em>.</p>
<p>For other pages, Docusaurus will automatically transform all <code>&lt;translate&gt;</code> tags it finds into function calls that return the translated strings from the corresponding localized file <em><code>locale.json</code></em>.</p>
<h2><a class="anchor" aria-hidden="true" id="crowdin"></a><a href="#crowdin" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Crowdin</h2>
<p>Crowdin это компания, предоставляющая услуги перевода. Для проектов с открытым исходным кодом, Crowdin предоставляет свободные переводы строк.</p>
<p>Создайте свой проект по переводу текста на <a href="https://crowdin.com/">Crowdin</a>. Вы можете обратиться к <a href="https://support.crowdin.com/translation-process-overview/">инструкциям Crowdin</a>, чтобы узнать больше о процессе перевода. <em>Мы предполагаем, что вы не выбрали и не включили &quot;English&quot; как язык для перевода для предотвращения создания файлов локализации <code>en-US</code>, так как это может привести к коллизии.</em></p>
<p>Создайте свой проект по переводу текста на <a href="https://crowdin.com/">Crowdin</a>. Вы можете обратиться к <a href="https://support.crowdin.com/translation-process-overview/">инструкциям Crowdin</a>, чтобы узнать больше о процессе перевода. <em>We suggest that you deselect and do not include &quot;English&quot; as a translatable language to prevent the creation of <code>en-US</code> localization files as this can lead to confusion.</em></p>
<blockquote>
<p>Убедитесь, что в настройках Crowdin в разделе «Переводы» для «Duplicate Strings» установлено значение <a href="https://support.crowdin.com/api/create-project/">«Hide - все дубликаты будут иметь одинаковый перевод» </a>. Этот параметр гарантирует, что идентичные строки в разных версиях имеют один и тот же перевод.</p>
</blockquote>
@ -208,7 +208,6 @@ languages.js
<span class="hljs-attr">preserve_hierarchy:</span> <span class="hljs-literal">true</span>
<span class="hljs-attr">files:</span>
<span class="hljs-bullet">-</span> <span class="hljs-attr">source:</span> <span class="hljs-string">'/docs/**/*.md'</span>
<span class="hljs-attr">translation:</span> <span class="hljs-string">'/website/translated_docs/%locale%/**/%original_file_name%'</span>
<span class="hljs-attr">languages_mapping:</span> <span class="hljs-meta">&amp;anchor</span>
@ -239,15 +238,21 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
</code></pre>
<blockquote>
<p><code>YOUR_CROWDIN_PROJECT_ID</code> это наименование вашего проекта на Crowdin. Например, для <a href="https://crowdin.com/project/docusaurus/">https://crowdin.com/project/docusaurus/</a>, эта переменная должна быть равна <code>docusaurus</code>. <code>YOUR_CROWDIN_API_KEY</code> это уникальный ключ, выполняет схожие с паролем функции. Вы можете обнаружить вкладку <code>API</code> на странице настроек <code>Settings</code> вашего проекта на Crowdin.</p>
</blockquote>
<blockquote>
<p>Для этих команд требуется установить переменные окружения со значениями id и api key вашего проекта на Crowdin (<code>CROWDIN_PROJECT_ID</code>, <code>CROWDIN_API_KEY</code>). Вы можете указывать их непосредственно при вызове команд, как было сделано выше, или добавить их на постоянной основе в <code>.bashrc</code> или <code>.bash_profile</code>.</p>
</blockquote>
<blockquote>
<p>Если вы запускаете больше одного локализованного проекта Docusaurus на своем компьютере, вам следует изменить наименование переменных окружения на что-нибудь уникальное (<code>CROWDIN_PROJECTNAME_PROJECT_ID</code>, <code>CROWDIN_PROJECTNAME_API_KEY</code>).</p>
</blockquote>
<blockquote>
<p>Поскольку файлы создаются автоматически, вам не нужно сохранять что-либо в каталоге <code>website/i18n</code> или <code>website/translated_docs</code> как часть своего репозитория. Так что вы можете добавить <code>website/i18n/*</code> и <code>website/translated_docs</code> в <code>.gitignore</code>.</p>
</blockquote>
<h3><a class="anchor" aria-hidden="true" id="автоматическая-синхронизация-с-помощью-circleci"></a><a href="#автоматическая-синхронизация-с-помощью-circleci" aria-hidden="true" class="hash-link"><svg class="hash-link-icon" aria-hidden="true" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>Автоматическая синхронизация с помощью CircleCI</h3>
<p>Вы можете автоматизировать загрузку и скачивание переводов для своих файлов, используя сервис непрерывной интеграции <a href="https://circleci.com">CircleCI</a>.</p>
<p>В первую очередь, измените файл <code>.circleci/config.yml</code> в каталоге своего проекта, чтобы включить шаги загрузки файлов на английском языке и скачивания переведенных файлов с помощью Crowdin CLI. Вот пример файла <code>.circleci/config.yml</code>:</p>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># Если вам нужно запустить circle непосредственно на коммитах в master, вы можете раскомментировать этот фрагмент</span>
<span class="hljs-comment"># а также раскомментировать filters: *filter-only-master в самом низу</span>
<pre><code class="hljs css language-yaml"><span class="hljs-comment"># If you only want 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>
<span class="hljs-comment">#</span>
<span class="hljs-comment"># aliases:</span>
<span class="hljs-comment"># - &amp;filter-only-master</span>
@ -259,12 +264,10 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
<span class="hljs-attr">jobs:</span>
<span class="hljs-attr">deploy-website:</span>
<span class="hljs-attr">docker:</span>
<span class="hljs-comment"># укажите версию для установки здесь</span>
<span class="hljs-comment"># specify the version you desire here</span>
<span class="hljs-bullet">-</span> <span class="hljs-attr">image:</span> <span class="hljs-string">circleci/node:8.11.1</span>
<span class="hljs-attr">steps:</span>
<span class="hljs-bullet">-</span> <span class="hljs-string">checkout</span>
<span class="hljs-bullet">-</span> <span class="hljs-attr">run:</span>
<span class="hljs-attr">name:</span> <span class="hljs-string">Deploying</span> <span class="hljs-string">to</span> <span class="hljs-string">GitHub</span> <span class="hljs-string">Pages</span>
@ -272,23 +275,22 @@ CROWDIN_DOCUSAURUS_PROJECT_ID=YOUR_CROWDIN_PROJECT_ID CROWDIN_DOCUSAURUS_API_KEY
git config --global user.email "&lt;GITHUB_USERNAME&gt;@users.noreply.github.com"
git config --global user.name "&lt;YOUR_NAME&gt;"
echo "machine github.com login &lt;GITHUB_USERNAME&gt; password $GITHUB_TOKEN" &gt; ~/.netrc
# установка Docusaurus и создание файла со строками на английском
# install Docusaurus and generate file of English strings
- cd website &amp;&amp; yarn install &amp;&amp; yarn run write-translations &amp;&amp; cd ..
# установка crowdin
# crowdin install
- sudo apt-get install default-jre
- wget https://artifacts.crowdin.com/repo/deb/crowdin.deb -O crowdin.deb
- sudo dpkg -i crowdin.deb
# загрузка/скачивание переводов
# translations upload/download
- crowdin --config crowdin.yaml upload sources --auto-update -b master
- crowdin --config crowdin.yaml download -b master
# сборка и публикация сайта
# build and publish website
cd website &amp;&amp; GIT_USER=&lt;GIT_USER&gt; yarn run publish-gh-pages
</span>
<span class="hljs-attr">workflows:</span>
<span class="hljs-attr">version:</span> <span class="hljs-number">2</span>
<span class="hljs-attr">build_and_deploy:</span>
<span class="hljs-attr">jobs:</span>
<span class="hljs-bullet">-</span> <span class="hljs-attr">deploy-website:</span>
<span class="hljs-comment"># filters: *filter-only-master</span>
</code></pre>