add ru pages

2020-06-01 09:17:30 -04:00
parent ae7b6ab1fa
commit 1224efaa6f
43 changed files with 345 additions and 301 deletions
@@ -1,7 +1,7 @@
 ---
 title: Руководство по содержанию документации
 linktitle: Руководство по содержанию
-content_template: templates/concept
+content_type: concept
 weight: 10
 card:
  name: contribute
@@ -9,15 +9,15 @@ card:
  title: Руководство по содержанию документации
 ---

-{{% capture overview %}}
+<!-- overview -->

 Эта страница содержит рекомендации по добавлению контента в документацию Kubernetes.
 Если у вас есть вопросы по поводу допустимого контента, обратитесь к каналу #sig-docs в [Slack Kubernetes](http://slack.k8s.io/) и задайте свои вопросы! Поступайте на своё усмотрение и не стесняйтесь вносить изменения в этот документ через пулреквест.

 Для получения дополнительной информации о создании нового контента для документации Kubernetes следуйте инструкциям в [руководстве по оформлению](/ru/docs/contribute/style/style-guide).
-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 ## Участие в контенте

@@ -94,8 +94,9 @@ card:

 Если у вас есть вопросы по поводу допустимого контента, присоединяйтесь к каналу #sig-docs в [Slack Kubernetes](http://slack.k8s.io/)!

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 * Прочитайте [руководство по оформлению](/ru/docs/contribute/style/style-guide).
-{{% /capture %}}
+
@@ -1,17 +1,17 @@
 ---
 title: Организация контента
-content_template: templates/concept
+content_type: concept
 weight: 40
 ---


-{{% capture overview %}}
+<!-- overview -->

 Этот сайт использует Hugo. В Hugo [организация контента](https://gohugo.io/content-management/organization/) — основная концепция.

-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 {{% note %}}
 **Подсказка:** при редактировании контента используйте команду `hugo server --navigateToChanged`, чтобы запустить Hugo.
@@ -120,12 +120,13 @@ en/includes

 Исходные файлы стилей в формате [SASS](https://sass-lang.com/) находятся в директории `assets/sass` и автоматически собираются Hugo.

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+

 * Подробнее про [пользовательские макрокоды Hugo](/ru/docs/contribute/style/hugo-shortcodes/)
 * Подробнее про [оформление документации](/ru/docs/contribute/style/style-guide)
 * Подробнее про [содержание документации](/ru/docs/contribute/style/content-guide)

-{{% /capture %}}
+
@@ -2,16 +2,16 @@
 approvers:
 - chenopis
 title: Пользовательские макрокоды Hugo
-content_template: templates/concept
+content_type: concept
 ---

-{{% capture overview %}}
+<!-- overview -->
 На этой странице объясняются пользовательские макрокоды Hugo, которые можно использовать в Markdown-файлах документации Kubernetes.

 Узнать подробнее про макрокоды можно в [документации Hugo](https://gohugo.io/content-management/shortcodes).
-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 ## Состояние функциональности

@@ -235,11 +235,11 @@ println "Это вкладка 2."
 {{< tab name="JSON File" include="podtemplate" />}}
 {{< /tabs >}}

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 * Подробнее про [Hugo](https://gohugo.io/).
 * Подробнее про [написание новой темы](/ru/docs/contribute/style/write-new-topic/).
 * Подробнее про [использование шаблонов страниц](/ru/docs/contribute/style/page-templates/).
 * Подробнее про [создание пулреквеста](/ru/docs/contribute/start/#отправка-пулреквеста).
-{{% /capture %}}
@@ -1,13 +1,13 @@
 ---
 title: Использование шаблонов страниц
-content_template: templates/concept
+content_type: concept
 weight: 30
 card:
  name: contribute
  weight: 30
 ---

-{{% capture overview %}}
+<!-- overview -->
 При добавлении новых тем воспользуйтесь одним из перечисленных ниже шаблонов.
 Это регламентирует пользовательское восприятие определённой страницы.

@@ -17,10 +17,10 @@ card:
 Каждая новая тема должна использовать шаблон. Если вы не уверены, какой шаблон использовать для новой темы, начните с [шаблона концепции](#шаблон-концепции).
 {{< /note >}}

-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->

 ## Шаблон концепции

@@ -28,7 +28,7 @@ card:

 Для написания новой страницы концепции в директории `/content/en/docs/concepts` создайте поддиректорию с Markdown-файлом со следующим требованиями:

- Во фронтальной части YAML этой страницы определите поле `content_template: templates/concept`.
+- Во фронтальной части YAML этой страницы определите поле `content_type: concept`.
 - В теле страницы укажите переменные  `capture` и любые другие, которые вы хотите включить:

    | Переменная | Обязательна? |
@@ -68,7 +68,7 @@ card:

 Для написания новой страницы задачи в директории `/content/en/docs/tasks` создайте поддиректорию с Markdown-файлом со следующим требованиями:

- Во фронтальной части YAML этой страницы определите поле `content_template: templates/task`.
+- Во фронтальной части YAML этой страницы определите поле `content_type: task`.
 - В теле страницы укажите переменные  `capture` и любые другие, которые вы хотите включить:

    | Переменная | Обязательна? |
@@ -122,7 +122,7 @@ card:

 Для написания новой страницы задачи в директории `/content/en/docs/tutorials` создайте поддиректорию с Markdown-файлом со следующим требованиями:

- Во фронтальной части YAML этой страницы определите поле `content_template: templates/tutorial`.
+- Во фронтальной части YAML этой страницы определите поле `content_type: tutorial`.
 - В теле страницы укажите переменные `capture` и любые другие, которые вы хотите включить:

    | Переменная | Обязательна? |
@@ -175,12 +175,13 @@ card:

 Пример завершенной темы, в которой используется шаблон руководства — [Running a Stateless Application Using a Deployment](/docs/tutorials/stateless-application/run-stateless-application-deployment/).

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+

 - Подробнее про [оформление документации](/ru/docs/contribute/style/style-guide/)
 - Подробнее про [содержание документации](/ru/docs/contribute/style/content-guide/)
 - Подробнее про [организацию контента](/ru/docs/contribute/style/content-organization/)

-{{% /capture %}}
+
@@ -1,7 +1,7 @@
 ---
 title: Руководство по оформлению документации
 linktitle: Руководство по оформлению
-content_template: templates/concept
+content_type: concept
 weight: 10
 card:
  name: contribute
@@ -9,14 +9,14 @@ card:
  title: Руководство по оформлению документации
 ---

-{{% capture overview %}}
+<!-- overview -->
 На этой странице вы найдёте рекомендации по оформлению написания документации Kubernetes. Это рекомендации, а не правила. Используйте здравый смысл и не стесняйтесь предлагать изменения в этот документ в виде пулреквеста.

 Для получения подробной информации о создании нового контента в документацию Kubernetes посмотрите [руководство по контенту документации](/ru/docs/contribute/style/content-guide/), а также следуйте инструкциям по [использованию шаблонов страниц](/ru/docs/contribute/style/page-templates/) и [открытию пулревеста в документацию](/ru/docs/contribute/start/#улучшение-существующего-текста).

-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 {{< note >}}
 В документации Kubernetes используется [Blackfriday Markdown Renderer](https://github.com/russross/blackfriday) вместе с несколькими [макрокодами Hugo](/docs/home/contribute/includes/) для добавления поддержки записей глоссария, вкладок и отображения состояний функциональностей.
@@ -559,12 +559,13 @@ Create a new cluster. | Turn up a new cluster.
 {{< /table >}}


-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+

 * Подробнее про [написание новой темы](/ru/docs/contribute/style/write-new-topic/).
 * Подробнее про [использование шаблонов страниц](/ru/docs/contribute/style/page-templates/).
 * Подробнее про [создание пулреквеста](/ru/docs/contribute/start/#отправка-пулреквеста)).

-{{% /capture %}}
+
@@ -1,17 +1,18 @@
 ---
 title: Написание новой темы
-content_template: templates/task
+content_type: task
 weight: 20
 ---

-{{% capture overview %}}
+<!-- overview -->
 На этой странице показано, как создать новую тему для документации Kubernetes.
-{{% /capture %}}


-{{% capture prerequisites %}}
+
+## {{% heading "prerequisites" %}}
+
 Создайте копию репозитория документации Kubernetes, как описано в разделе [Участие для начинающих](/ru/docs/contribute/start/).
-{{% capture steps %}}
+<!-- steps -->

 ## Выбор типы страницы

@@ -111,9 +112,10 @@ kubectl create -f https://k8s.io/examples/pods/storage/gce-volume.yaml

 Поместите файлы изображений в директорию `/images`. Предпочтительный формат изображения — SVG.

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 * Подробнее про [использование шаблонов страниц](/ru/docs/contribute/style/page-templates/).
 * Подробнее про [создание пулреквеста](/ru/docs/contribute/start/#отправка-пулреквеста)).
-{{% /capture %}}
+