add ru pages

2020-06-01 09:17:30 -04:00 · 2020-06-01 09:17:30 -04:00 · 1224efaa6f
parent ae7b6ab1fa
commit 1224efaa6f
43 changed files with 345 additions and 301 deletions
--- a/content/ru/docs/concepts/_index.md
+++ b/content/ru/docs/concepts/_index.md
@ -1,17 +1,17 @@
 ---
 title: Концепции
 main_menu: true
-content_template: templates/concept
+content_type: concept
 weight: 40
 ---

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

 Раздел "Концепции" поможет вам узнать о частях системы Kubernetes и об абстракциях, которые Kubernetes использует для представления вашего {{< glossary_tooltip text="кластера" term_id="cluster" length="all" >}}, и помогает вам глубже понять, как работает Kubernetes.

-{{% /capture %}}

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

 ## Краткий обзор

@ -60,12 +60,13 @@ Kubernetes также содержит абстракции более высо
 Узлы в кластере - это машины (виртуальные машины, физические серверы и т.д.), на которых работают ваши приложения и облачные рабочие процессы. Мастер Kubernetes контролирует каждый узел; вы редко будете взаимодействовать с узлами напрямую.


-{{% /capture %}}

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

 Если вы хотите описать концепт, обратитесь к странице
 [Использование шаблонов страниц](/docs/home/contribute/page-templates/)
 для получения информации о типе страницы и шаблоне концепции.

-{{% /capture %}}
+
--- a/content/ru/docs/concepts/overview/components.md
+++ b/content/ru/docs/concepts/overview/components.md
@ -2,14 +2,14 @@
 reviewers:
 - lavalamp
 title: Компоненты Kubernetes
-content_template: templates/concept
+content_type: concept
 weight: 20
 card:
  name: concepts
  weight: 20
 ---

-{{% capture overview %}}
+<!-- overview -->
 При развёртывании Kubernetes вы имеете дело с кластером.
 {{< glossary_definition term_id="cluster" length="all" prepend="Кластер Kubernetes cluster состоит из">}}

@ -19,9 +19,9 @@ card:

 ![Компоненты Kubernetes](/images/docs/components-of-kubernetes.png)

-{{% /capture %}}

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

 ## Плоскость управления компонентами

@ -109,10 +109,11 @@ cloud-controller-manager запускает только циклы контро

 Механизм [логирования кластера](/docs/concepts/cluster-administration/logging/) отвечает за сохранение логов контейнера в централизованном хранилище логов с возможностью их поиска/просмотра.

-{{% /capture %}}
-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 * Подробнее про [узлы](/docs/concepts/architecture/nodes/)
 * Подробнее про [контроллеры](/docs/concepts/architecture/controller/)
 * Подробнее про [kube-scheduler](/docs/concepts/scheduling/kube-scheduler/)
 * Официальная [документация](https://etcd.io/docs/) etcd
-{{% /capture %}}
+
--- a/content/ru/docs/concepts/overview/kubernetes-api.md
+++ b/content/ru/docs/concepts/overview/kubernetes-api.md
@ -1,13 +1,13 @@
 ---
 title: API Kubernetes
-content_template: templates/concept
+content_type: concept
 weight: 30
 card:
  name: concepts
  weight: 30
 ---

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

 Общие соглашения API описаны на [странице соглашений API](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md).

@ -21,9 +21,9 @@ Kubernetes также сохраняет сериализованное сост

 Kubernetes как таковой состоит из множества компонентов, которые взаимодействуют друг с другом через собственные API.

-{{% /capture %}}

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

 ## Изменения в API

@ -114,4 +114,4 @@ DaemonSets, Deployments, StatefulSet, NetworkPolicies, PodSecurityPolicies и Re

 {{< note >}}Включение/отключение отдельных ресурсов поддерживается только в API-группе `extensions/v1beta1` по историческим причинам.{{< /note >}}

-{{% /capture %}}
+
--- a/content/ru/docs/concepts/overview/what-is-kubernetes.md
+++ b/content/ru/docs/concepts/overview/what-is-kubernetes.md
@ -3,18 +3,18 @@ reviewers:
 - bgrant0607
 - mikedanese
 title: Что такое Kubernetes
-content_template: templates/concept
+content_type: concept
 weight: 10
 card:
  name: concepts
  weight: 10
 ---

-{{% capture overview %}}
+<!-- overview -->
 Эта страница посвящена краткому обзору Kubernetes.
-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->
 Kubernetes — это портативная расширяемая платформа с открытым исходным кодом для управления контейнеризованными рабочими нагрузками и сервисами, которая облегчает как декларативную настройку, так и автоматизацию. У платформы есть большая, быстро растущая экосистема. Сервисы, поддержка и инструменты Kubernetes широко доступны.

 Название Kubernetes происходит от греческого, что означает рулевой или штурман. Google открыл исходный код Kubernetes в 2014 году. Kubernetes основывается на [десятилетнем опыте работе Google с масштабными рабочими нагрузками](https://ai.google/research/pubs/pub43438), в сочетании с лучшими в своем классе идеями и практиками сообщества.
@ -83,9 +83,10 @@ Kubernetes:
 * Не предоставляет и не принимает никаких комплексных систем конфигурации, технического обслуживания, управления или самовосстановления.
 * Кроме того, Kubernetes — это не просто система оркестрации. Фактически, Kubernetes устраняет необходимость в этом. Техническое определение оркестрации — это выполнение определенного рабочего процесса: сначала сделай A, затем B, затем C. Напротив, Kubernetes содержит набор независимых, компонуемых процессов управления, которые непрерывно переводит текущее состояние к предполагаемому состоянию. Неважно, как добраться от А до С. Не требуется также централизованный контроль. Это делает систему более простой в использовании, более мощной, надежной, устойчивой и расширяемой.

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 *   Изучите [Компоненты Kubernetes](/docs/concepts/overview/components/)
 *   Готовы [начать](/docs/setup/)?
-{{% /capture %}}
+
--- a/content/ru/docs/concepts/overview/working-with-objects/annotations.md
+++ b/content/ru/docs/concepts/overview/working-with-objects/annotations.md
@ -1,14 +1,14 @@
 ---
 title: Аннотации
-content_template: templates/concept
+content_type: concept
 weight: 50
 ---

-{{% capture overview %}}
+<!-- overview -->
 Аннотации Kubernetes можно использовать для добавления собственных метаданных к объектам. Такие клиенты, как инструменты и библиотеки, могут получить эти метаданные.
-{{% /capture %}}

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

 ## Добавление метаданных к объектам

@ -72,8 +72,9 @@ spec:

 ```

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 Узнать подробнее про [метки и селекторы](/ru/docs/concepts/overview/working-with-objects/labels/).
-{{% /capture %}}
+
--- a/content/ru/docs/concepts/overview/working-with-objects/common-labels.md
+++ b/content/ru/docs/concepts/overview/working-with-objects/common-labels.md
@ -1,17 +1,17 @@
 ---
 title: Рекомендуемые метки
-content_template: templates/concept
+content_type: concept
 ---

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

 Вы можете визуализировать и управлять объектами Kubernetes не только с помощью kubectl и панели управления. С помощью единого набора меток можно единообразно описывать объекты, что позволяет инструментам согласованно работать между собой.

 В дополнение к существующим инструментам, рекомендуемый набор меток описывают приложения в том виде, в котором они могут быть получены.

-{{% /capture %}}

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


 Метаданные сосредоточены на понятии _приложение_. Kubernetes — это не платформа как услуга (PaaS), поэтому не закрепляет формальное понятие приложения.
@ -162,4 +162,4 @@ metadata:

 Вы заметите, что `StatefulSet` и `Service` MySQL содержат больше информации о MySQL и WordPress.

-{{% /capture %}}
+
--- a/content/ru/docs/concepts/overview/working-with-objects/kubernetes-objects.md
+++ b/content/ru/docs/concepts/overview/working-with-objects/kubernetes-objects.md
@ -1,19 +1,19 @@
 ---
 title: Изучение объектов Kubernetes
-content_template: templates/concept
+content_type: concept
 weight: 10
 card:
  name: concepts
  weight: 40
 ---

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

 На этой странице объясняется, как объекты Kubernetes представлены в API Kubernetes, и как их можно определить в формате `.yaml`.

-{{% /capture %}}

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

 ## Изучение объектов Kubernetes {#kubernetes-objects}

@ -70,11 +70,12 @@ deployment.apps/nginx-deployment created
 Конкретный формат поля-объекта `spec` зависит от типа объекта Kubernetes и содержит вложенные поля, предназначенные только для используемого объекта. В [справочнике API Kubernetes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/) можно найти формат спецификации любого объекта Kubernetes.
 Например, формат  `spec` для объекта Pod находится в [ядре PodSpec v1](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core), а формат `spec` для Deployment — в [DeploymentSpec v1 apps](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#deploymentspec-v1-apps).

-{{% /capture %}}

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

 * [Обзор API Kubernetes](/docs/reference/using-api/api-overview/) более подробно объясняет некоторые из API-концепций
 * Познакомиться с наиболее важными и основными объектами в Kubernetes, например, с [подами](/docs/concepts/workloads/pods/pod-overview/).
 * Узнать подробнее про [контролеры](/docs/concepts/architecture/controller/) в Kubernetes
-{{% /capture %}}
+
--- a/content/ru/docs/concepts/overview/working-with-objects/labels.md
+++ b/content/ru/docs/concepts/overview/working-with-objects/labels.md
@ -1,10 +1,10 @@
 ---
 title: Метки и селекторы
-content_template: templates/concept
+content_type: concept
 weight: 40
 ---

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

 _Метки_ — это пары ключ-значение, которые добавляются к объектам, как поды.
 Метки предназначены для идентификации атрибутов объектов, которые имеют значимость и важны для пользователей, но при этом не относятся напрямую к основной системе.
@ -22,9 +22,9 @@ _Метки_ — это пары ключ-значение, которые до

 Метки используются при получении и отслеживании объектов и в веб-панелях и CLI-инструментах. Любая неидентифицирующая информация должна быть записана в [аннотации](/ru/docs/concepts/overview/working-with-objects/annotations/).

-{{% /capture %}}

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

 ## Причины использования

@ -218,4 +218,4 @@ selector:
 Один из вариантов использования меток — возможность выбора набора узлов, в которых может быть развернут под.
 Смотрите документацию про [выбор узлов](/docs/concepts/configuration/assign-pod-node/), чтобы получить дополнительную информацию.

-{{% /capture %}}
+
--- a/content/ru/docs/concepts/overview/working-with-objects/names.md
+++ b/content/ru/docs/concepts/overview/working-with-objects/names.md
@ -1,10 +1,10 @@
 ---
 title: Имена и идентификаторы объектов
-content_template: templates/concept
+content_type: concept
 weight: 20
 ---

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

 Каждый объект в кластере имеет уникальное [_имя_](#имена) для конкретного типа ресурса.
 Кроме этого, у каждого объекта Kubernetes есть собственный [_уникальный идентификатор (UID)_](#идентификаторы) в пределах кластера.
@ -13,9 +13,9 @@ weight: 20

 Для создания пользовательских неуникальных атрибутов у Kubernetes есть [метки](/ru/docs/concepts/overview/working-with-objects/labels/) и [аннотации](/ru/docs/concepts/overview/working-with-objects/annotations/).

-{{% /capture %}}

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

 ## Имена

@ -71,8 +71,9 @@ spec:
 Уникальные идентификатор (UID) в Kubernetes — это универсальные уникальные идентификаторы (известные также как Universally Unique IDentifier, сокращенно UUID).
 Эти идентификаторы стандартизированы под названием ISO/IEC 9834-8, а также как ITU-T X.667.

-{{% /capture %}}
-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 * Узнать подробнее про [метки](/ru/docs/concepts/overview/working-with-objects/labels/) в Kubernetes.
 * Посмотреть архитектуру [идентификаторов и имён Kubernetes](https://git.k8s.io/community/contributors/design-proposals/architecture/identifiers.md).
-{{% /capture %}}
+
--- a/content/ru/docs/concepts/overview/working-with-objects/namespaces.md
+++ b/content/ru/docs/concepts/overview/working-with-objects/namespaces.md
@ -1,16 +1,16 @@
 ---
 title: Пространства имён
-content_template: templates/concept
+content_type: concept
 weight: 30
 ---

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

 Kubernetes поддерживает несколько виртуальных кластеров в одном физическом кластере. Такие виртуальные кластеры называются пространствами имён.

-{{% /capture %}}

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

 ## Причины использования нескольких пространств имён

@ -88,10 +88,11 @@ kubectl api-resources --namespaced=true
 kubectl api-resources --namespaced=false
 ```

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 * Узнать подробнее про [создание нового пространства имён](/docs/tasks/administer-cluster/namespaces/#creating-a-new-namespace).
 * Узнать подробнее про [удаление пространства имён](/docs/tasks/administer-cluster/namespaces/#deleting-a-namespace).

-{{% /capture %}}
+
--- a/content/ru/docs/concepts/overview/working-with-objects/object-management.md
+++ b/content/ru/docs/concepts/overview/working-with-objects/object-management.md
@ -1,16 +1,16 @@
 ---
 title: Управление объектами Kubernetes
-content_template: templates/concept
+content_type: concept
 weight: 15
 ---

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

 В инструменте командной строки `kubectl` есть несколько разных способов создания и управления объектами Kubernetes. На этой странице рассматриваются различные подходы. Изучите [документацию по Kubectl](https://kubectl.docs.kubernetes.io) для получения подробной информации по управлению объектами с помощью Kubectl.

-{{% /capture %}}

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

 ## Способы управления

@ -153,9 +153,10 @@ kubectl apply -R -f configs/
 - Декларативную конфигурацию объекта сложнее отладить и понять, когда можно получить неожиданные результаты.
 - Частичные обновления с использованием различий приводит к сложным операциям слияния и исправления.

-{{% /capture %}}

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

 - [Управление объектами Kubernetes с помощью императивных команд](/docs/tasks/manage-kubernetes-objects/imperative-command/)
 - [Управление объектами Kubernetes с помощью императивной конфигурации объекта](/docs/tasks/manage-kubernetes-objects/imperative-config/)
@ -165,4 +166,4 @@ kubectl apply -R -f configs/
 - [Документация Kubectl](https://kubectl.docs.kubernetes.io)
 - [Справочник API Kubernetes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)

-{{% /capture %}}
+
--- a/content/ru/docs/contribute/_index.md
+++ b/content/ru/docs/contribute/_index.md
@ -1,18 +1,18 @@
 ---
-content_template: templates/concept
+content_type: concept
 title: Участие в документации Kubernetes
 linktitle: Contribute
 main_menu: true
 weight: 80
 ---

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

 Если вы хотите внести свой вклад в документацию или сайт Kubernetes, мы будем рады вашей помощи! Любой может принять участие в проекте, независимо от того, знакомы ли вы с проектом или нет, кроме этого не имеет значения кто вы — разработчик, обычный пользователь или всего лишь тот, кто терпеть не может опечаток.

 С деталями о содержании и стиле документации Kubernetes вы можете ознакомиться в [Documentation style overview](/docs/contribute/style/).

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

 ## Типы участников документации

@ -58,4 +58,4 @@ weight: 80
 - Чтобы помочь сообществу Kubernetes с помощью онлайн-форумов, таких как Twitter или Stack Overflow, либо узнать о местных встречах и мероприятиях по Kubernetes, [посетите страницу сообщества Kubernetes](/community/).
 - Чтобы поучаствовать в разработке функциональности, ознакомьтесь со [шпаргалкой для участника](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet), чтобы начать.

-{{% /capture %}}
+
--- a/content/ru/docs/contribute/advanced.md
+++ b/content/ru/docs/contribute/advanced.md
@ -1,17 +1,17 @@
 ---
 title: Участие для опытных
 slug: advanced
-content_template: templates/concept
+content_type: concept
 weight: 30
 ---

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

 На этой странице предполагается, что вы изучили темы [Участие для начинающих](/ru/docs/contribute/start/) и [Участие для опытных](/ru/docs/contribute/intermediate/) и теперь хотите узнать ещё больше про то, как можно помочь проекту. Для решения некоторых задач вам потребуется использовать Git из командной строки и прочие другие инструменты.

-{{% /capture %}}

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

 ## Дежурный по PR на неделю

@ -193,4 +193,4 @@ weight: 30

 Запись автоматически загрузится на YouTube.

-{{% /capture %}}
+
--- a/content/ru/docs/contribute/generate-ref-docs/contribute-upstream.md
+++ b/content/ru/docs/contribute/generate-ref-docs/contribute-upstream.md
@ -1,10 +1,10 @@
 ---
 title: Участие в основном коде Kubernetes
-content_template: templates/task
+content_type: task
 weight: 20
 ---

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

 На этой странице показано, как поучаствовать в основном содержимом проекта `kubernetes/kubernetes`.
 Вы можете исправить баги, найденные в документации по API Kubernetes или содержимом таких компонентов Kubernetes, как `kubeadm`, `kube-apiserver` и `kube-controller-manager`.
@ -14,9 +14,10 @@ weight: 20
 - [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/)
 - [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/)

-{{% /capture %}}

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

 - Установленные инструменты:

@ -31,9 +32,9 @@ weight: 20
  Это обычно предполагает создание копии репозитория.
  Для получения дополнительной информации смотрите страницы [Создание пулреквеста](https://help.github.com/articles/creating-a-pull-request/) и [Стандартный рабочий процесс в GitHub по работе с копией и пулреквестом](https://gist.github.com/Chaser324/ce0505fbed06b947d962).

-{{% /capture %}}

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

 ## Рассмотрение процесса в целом

@ -174,12 +175,13 @@ hack/update-api-reference-docs.sh

 Теперь вы можете приступить к изучению руководству [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/), чтобы создать [справочную документацию API Kubernetes](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/).

-{{% /capture %}}

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

 * [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/)
 * [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/)
 * [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/)

-{{% /capture %}}
+
--- a/content/ru/docs/contribute/generate-ref-docs/kubectl.md
+++ b/content/ru/docs/contribute/generate-ref-docs/kubectl.md
@ -1,10 +1,10 @@
 ---
 title: Генерация справочной документации для команд kubectl
-content_template: templates/task
+content_type: task
 weight: 90
 ---

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

 На этой странице показано, как сгенерировать справочник для команды `kubectl`.

@ -13,15 +13,16 @@ weight: 90
 Этот раздел не рассматривает генерацию справочной страницы для опций [kubectl](/ru/docs/reference/generated/kubectl/kubectl/). Инструкции по генерации справочной страницы опций kubectl смотрите в разделе [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/).
 {{< /note >}}

-{{% /capture %}}

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

 {{< include "prerequisites-ref-docs.md" >}}

-{{% /capture %}}

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

 ## Настройка локальных репозиториев

@ -213,12 +214,13 @@ make docker-serve

 Спустя несколько минут после принятия вашего пулреквеста, обновленные темы справочника будут отображены в [документации](/ru/docs/home/).

-{{% /capture %}}

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

 * [Руководство по быстрому старту генерации справочной документации](/ru/docs/contribute/generate-ref-docs/quickstart/)
 * [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/)
 * [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/)

-{{% /capture %}}
+
--- a/content/ru/docs/contribute/generate-ref-docs/kubernetes-api.md
+++ b/content/ru/docs/contribute/generate-ref-docs/kubernetes-api.md
@ -1,10 +1,10 @@
 ---
 title: Генерация справочной документации для API Kubernetes
-content_template: templates/task
+content_type: task
 weight: 50
 ---

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

 На этой странице рассказывается про обновление справочной документации по API Kubernetes.

@ -14,15 +14,16 @@ weight: 50

 Продолжайте чтение данной странице, если вы хотите перегенерировать справочную документацию из спецификации [OpenAPI](https://github.com/OAI/OpenAPI-Specification).

-{{% /capture %}}

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

 {{< include "prerequisites-ref-docs.md" >}}

-{{% /capture %}}

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

 ## Настройка локальных репозиториев

@ -177,12 +178,13 @@ make docker-serve
 Отправьте свои изменения в виде [пулреквеста](/ru/docs/contribute/start/) в репозиторий [kubernetes/kubernetes](https://github.com/kubernetes/kubernetes).
 Отслеживайте изменения в пулреквесте и по мере необходимости отвечайте на комментарии рецензента. Не забывайте проверять пулреквест до тех пор, пока он не будет принят.

-{{% /capture %}}

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

 * [Руководство по быстрому старту генерации справочной документации](/ru/docs/contribute/generate-ref-docs/quickstart/)
 * [Генерация справочной документации для компонентов и инструментов Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-components/)
 * [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/)

-{{% /capture %}}
+
--- a/content/ru/docs/contribute/generate-ref-docs/kubernetes-components.md
+++ b/content/ru/docs/contribute/generate-ref-docs/kubernetes-components.md
@ -1,32 +1,34 @@
 ---
 title: Генерация справочных страниц для компонентов и инструментов Kubernetes
-content_template: templates/task
+content_type: task
 weight: 120
 ---

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

 На этой странице показывается, как собирать справочные страницы компонентов и инструментов Kubernetes.

-{{% /capture %}}

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

 Начните с [раздела с требованиями](/ru/docs/contribute/generate-ref-docs/quickstart/#подготовка-к-работе) в руководстве по быстрому старту.

-{{% /capture %}}

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

 Для генерации справочных страниц компонентов и инструментов Kubernetes изучите страницу [руководство по быстрому старту в справочной документации](/docs/contribute/generate-ref-docs/quickstart/).

-{{% /capture %}}

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

 * [Краткое руководство по генерации справочной документации](/ru/docs/contribute/generate-ref-docs/quickstart/)
 * [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/)
 * [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/)
 * [Участие в документации основного кода проекта Kubernetes](/ru/docs/contribute/generate-ref-docs/contribute-upstream/)

-{{% /capture %}}
+
--- a/content/ru/docs/contribute/generate-ref-docs/quickstart.md
+++ b/content/ru/docs/contribute/generate-ref-docs/quickstart.md
@ -1,22 +1,23 @@
 ---
 title: Руководство по быстрому старту
-content_template: templates/task
+content_type: task
 weight: 40
 ---

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

 На этой странице показано, как использовать скрипт `update-imported-docs` для генерации справочной документации Kubernetes. Скрипт автоматизирует настройку сборки и генерирует справочную документацию для выпуска.

-{{% /capture %}}

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

 {{< include "prerequisites-ref-docs.md" >}}

-{{% /capture %}}

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

 ## Получение репозитория документации

@ -207,9 +208,10 @@ static/docs/reference/generated/kubernetes-api/v1.17/fonts/fontawesome-webfont.w

 Спустя несколько минут после принятия вашего пулреквеста, обновленные темы справочника будут отображены в [документации](/ru/docs/home/).

-{{% /capture %}}

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

 Для генерации отдельной взятой справочной документации путём ручной настройки необходимых репозиториев сборки и выполнении скриптов сборки обратитесь к следующим руководствам:

@ -217,4 +219,4 @@ static/docs/reference/generated/kubernetes-api/v1.17/fonts/fontawesome-webfont.w
 * [Генерация справочной документации для команд kubectl](/ru/docs/contribute/generate-ref-docs/kubectl/)
 * [Генерация справочной документации для API Kubernetes](/ru/docs/contribute/generate-ref-docs/kubernetes-api/)

-{{% /capture %}}
+
--- a/content/ru/docs/contribute/intermediate.md
+++ b/content/ru/docs/contribute/intermediate.md
@ -1,14 +1,14 @@
 ---
 title: Участие для продвинутых
 slug: intermediate
-content_template: templates/concept
+content_type: concept
 weight: 20
 card:
  name: contribute
  weight: 50
 ---1

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

 На этой странице предполагается, что вы изучили и понимаете задачи на странице [Участие для начинающих](/ru/docs/contribute/start/) и теперь готовы узнать о других способах внести свой вклад.

@ -16,9 +16,9 @@ card:
 Некоторые задачи требуют использование Git-клиента из командной строки и других инструментов.
 {{< /note >}}

-{{% /capture %}}

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

 Теперь, когда вы уже знаете кое-что и приняли участие в документации Kubernetes, как описано в теме [Участие для начинающих](/ru/docs/contribute/start/), вы можете пойти ещё дальше. Далее пойдут задачи, предусматривающие наличие и желание получить глубокие знания по следующим темам:

@ -597,10 +597,11 @@ If this is a documentation issue, please re-open this issue.

   Если PR изменяет файлы на нескольких языках, попросите автора открыть отдельные PR для каждого языка.

-{{% /capture %}}

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

 Если вы хорошо осознали все задачи, затронутые в этом разделе, и хотите более тесно работать с командой документации Kubernetes, переходите к изучению [руководства для опытного участника](/ru/docs/contribute/advanced/).

-{{% /capture %}}
+
--- a/content/ru/docs/contribute/localization.md
+++ b/content/ru/docs/contribute/localization.md
@ -1,19 +1,19 @@
 ---
 title: Локализация документации Kubernetes
-content_template: templates/concept
+content_type: concept
 card:
  name: contribute
  weight: 30
  title: Перевод документации
 ---

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

 На этой странице рассказывается, как [локализовать](https://blog.mozilla.org/l10n/2011/12/14/i18n-vs-l10n-whats-the-diff/) документацию на разные языки.

-{{% /capture %}}

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

 ## Начало работы

@ -274,13 +274,14 @@ SIG Docs приветствует [участие и дополнения](/ru/d

 Вы также можете добавлять или улучшать контент в уже существующей локализации. Обратитесь к соответствующему [Slack-каналу](https://kubernetes.slack.com/messages/C1J0BPD2M/) для этого и начинайте помогать через PR.

-{{% /capture %}}

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

 Как только локализация будет соответствовать требованиям установленного рабочего процесса и содержать требуемый минимум контента, группа SIG Docs:

 - Добавит язык на сайт
 - Сообщит о новой локализации на каналах [Cloud Native Computing Foundation](https://www.cncf.io/about/) (CNCF), включая [блог Kubernetes](https://kubernetes.io/blog/).

-{{% /capture %}}
+
--- a/content/ru/docs/contribute/participating.md
+++ b/content/ru/docs/contribute/participating.md
@ -1,12 +1,12 @@
 ---
 title: Участие в SIG Docs
-content_template: templates/concept
+content_type: concept
 card:
  name: contribute
  weight: 40
 ---

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

 SIG Docs — это одна из [специальных групп](https://github.com/kubernetes/community/blob/master/sig-list.md) в проекте Kubernetes, которая занимается написанием, обновлением и поддержкой документации Kubernetes в целом. Перейдите на страницу про [SIG Docs в GitHub-репозитории](https://github.com/kubernetes/community/tree/master/sig-docs), чтобы узнать подробную информацию об этой группе.

@ -14,9 +14,9 @@ SIG Docs активно принимает правки и дополнения

 Вы также можете стать [членом](#члены), [рецензентом](#рецензенты) или [утверждающим](#утверждающие). Эти роли расширяют ваши возможности, но и предлагают выполнение определенных обязанностей по рассмотрению и принятию изменений. Изучите содержимого файла [community-membership](https://github.com/kubernetes/community/blob/master/community-membership.md) в директории сообщества репозитория, чтобы узнать про членство в сообществе Kubernetes. В остальной части этой страницы кратко рассматривается функционирование ролей в группе SIG Docs, которая в совокупности отвечает за поддержание одного из самой публичной части Kubernetes — сайта и документации Kubernetes.

-{{% /capture %}}

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

 ## Роли и обязанности

@ -196,13 +196,14 @@ SIG Docs активно принимает правки и дополнения
 - Любой участник Kubernetes может добавить метку `lgtm`, добавив комментарий, включающий в себя `/lgtm`.
 - Только утверждающие SIG Docs могут слить пулреквест путём добавления комментария с `/approve`. Некоторые утверждающие также играют дополнительные роли, например, [дежурного по PR](#pr-wrangler) или [председателя SIG Docs](#председатель-sig-docs).

-{{% /capture %}}

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

 Для получения дополнительной информации про участие в документации Kubernetes, посмотрите следующие страницы:

 - [Участие для начинающих](/ru/docs/contribute/start/)
 - [Правила оформления документации](/ru/docs/contribute/style/)

-{{% /capture %}}
+
--- a/content/ru/docs/contribute/start.md
+++ b/content/ru/docs/contribute/start.md
@ -1,23 +1,23 @@
 ---
 title: Участие для начинающих
 slug: start
-content_template: templates/concept
+content_type: concept
 weight: 10
 card:
  name: contribute
  weight: 10
 ---

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

 Если вы хотите поучаствовать в работе над документацией Kubernetes, эта страница и связанные с ней темы могут помочь вам начать работу. Вам не нужно быть разработчиком или техническим писателем, чтобы внести вклад в документацию или улучшить сайт Kubernetes! Все, что вам нужно для тем на этой странице, это учетная запись на GitHub и браузер.

 Если вы ищете информацию про участие в репозиториях, связанным с кодом Kubernetes, обратитесь к [руководству сообщества Kubernetes](https://github.com/kubernetes/community/blob/master/governance.md).

-{{% /capture %}}


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

 ## Основные сведения про документацию

@ -224,10 +224,11 @@ SIG Docs совместными усилиями вносит изменения

 Ознакомьтесь с [существующими примерами использования](https://github.com/kubernetes/website/tree/master/content/en/case-studies). Воспользуйтесь [формой добавления нового примера использования Kubernetes](https://www.cncf.io/people/end-user-community/), чтобы поделиться своим опытом.

-{{% /capture %}}

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

 Если вы хорошо поняли темы, затронутые в этом разделе, но хотите глубже взаимодействовать с командой документации Kubernetes, прочитайте [расширенное руководство по участию в документации](/docs/contribute/intermediate/).

-{{% /capture %}}
+
--- a/content/ru/docs/contribute/style/content-guide.md
+++ b/content/ru/docs/contribute/style/content-guide.md
@ -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 %}}
+
--- a/content/ru/docs/contribute/style/content-organization.md
+++ b/content/ru/docs/contribute/style/content-organization.md
@ -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 %}}
+
--- a/content/ru/docs/contribute/style/hugo-shortcodes/index.md
+++ b/content/ru/docs/contribute/style/hugo-shortcodes/index.md
@ -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 %}}
--- a/content/ru/docs/contribute/style/page-templates.md
+++ b/content/ru/docs/contribute/style/page-templates.md
@ -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 %}}
+
--- a/content/ru/docs/contribute/style/style-guide.md
+++ b/content/ru/docs/contribute/style/style-guide.md
@ -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 %}}
+
--- a/content/ru/docs/contribute/style/write-new-topic.md
+++ b/content/ru/docs/contribute/style/write-new-topic.md
@ -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 %}}
+
--- a/content/ru/docs/home/supported-doc-versions.md
+++ b/content/ru/docs/home/supported-doc-versions.md
@ -1,19 +1,19 @@
 ---
 title: Версии Kubernetes с поддержкой документации 
-content_template: templates/concept
+content_type: concept
 card:
  name: about
  weight: 10
  title: Версии с поддержкой документации
 ---

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

 На сайте можно найти документацию для текущей и четырёх прошлых версий Kubernetes.

-{{% /capture %}}

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

 ## Текущая версия

@ -24,6 +24,6 @@ card:

 {{< versions-other >}}

-{{% /capture %}}
+


--- a/content/ru/docs/reference/_index.md
+++ b/content/ru/docs/reference/_index.md
@ -5,16 +5,16 @@ approvers:
 linkTitle: "Ссылки"
 main_menu: true
 weight: 70
-content_template: templates/concept
+content_type: concept
 ---

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

 Этот раздел документации Kubernetes содержит ссылки.

-{{% /capture %}}

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

 ## Ссылки API

@ -58,4 +58,4 @@ content_template: templates/concept

 Архив документации по дизайну для функциональности Kubernetes. Начните с [Архитектура Kubernetes](https://git.k8s.io/community/contributors/design-proposals/architecture/architecture.md) и [Обзор дизайна Kubernetes](https://git.k8s.io/community/contributors/design-proposals).

-{{% /capture %}}
+
--- a/content/ru/docs/reference/kubectl/cheatsheet.md
+++ b/content/ru/docs/reference/kubectl/cheatsheet.md
@ -4,21 +4,21 @@ reviewers:
 - erictune
 - krousey
 - clove
-content_template: templates/concept
+content_type: concept
 card:
  name: reference
  weight: 30
 ---

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

 Смотрите также: [обзор Kubectl](/ru/docs/reference/kubectl/overview/) и [руководство по JsonPath](/ru/docs/reference/kubectl/jsonpath).

 Эта команда представляет собой обзор команды `kubectl`.

-{{% /capture %}}

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

 # kubectl - Шпаргалка

@ -374,9 +374,10 @@ kubectl api-resources --api-group=extensions # Все ресурсы в API-гр
 `--v=8` | Показать содержимое HTTP-запросов.
 `--v=9` | Показать содержимого HTTP-запроса в полном виде.

-{{% /capture %}}

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

 * Подробнее о kubectl на странице [обзора](/ru/docs/reference/kubectl/overview/).

@ -386,4 +387,4 @@ kubectl api-resources --api-group=extensions # Все ресурсы в API-гр

 * Посмотреть [шпаргалки по kubectl](https://github.com/dennyzhang/cheatsheet-kubernetes-A4) сообщества.

-{{% /capture %}}
+
--- a/content/ru/docs/reference/kubectl/docker-cli-to-kubectl.md
+++ b/content/ru/docs/reference/kubectl/docker-cli-to-kubectl.md
@ -1,13 +1,13 @@
 ---
 title: kubectl для пользователей Docker
-content_template: templates/concept
+content_type: concept
 ---

-{{% capture overview %}}
+<!-- overview -->
 Вы можете использовать инструмент командной строки kubectl в Kubernetes для работы с API-сервером. Если вы знакомы с инструментом командной строки Docker, то использование kubectl не составит проблем. Однако команды docker и kubectl отличаются. В следующих разделах показана подкоманда docker и приведена эквивалентная команда в kubectl.
-{{% /capture %}}

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

 ## docker run

@ -359,4 +359,4 @@ Grafana is running at https://203.0.113.141/api/v1/namespaces/kube-system/servic
 Heapster is running at https://203.0.113.141/api/v1/namespaces/kube-system/services/monitoring-heapster/proxy
 InfluxDB is running at https://203.0.113.141/api/v1/namespaces/kube-system/services/monitoring-influxdb/proxy
 ```
-{{% /capture %}}
+
--- a/content/ru/docs/reference/kubectl/jsonpath.md
+++ b/content/ru/docs/reference/kubectl/jsonpath.md
@ -1,14 +1,14 @@
 ---
 title: Поддержка JSONPath
-content_template: templates/concept
+content_type: concept
 weight: 25
 ---

-{{% capture overview %}}
+<!-- overview -->
 Kubectl поддерживает шаблон JSONPath.
-{{% /capture %}}

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

 Шаблон JSONPath состоит из выражений JSONPath, заключенных в фигурные скобки {}.
 Kubectl использует JSONPath-выражения для фильтрации по определенным полям в JSON-объекте и форматирования вывода.
@ -98,4 +98,4 @@ kubectl get pods -o=jsonpath="{range .items[*]}{.metadata.name}{\"\t\"}{.status.
 ```
 {{< /note >}}

-{{% /capture %}}
+
--- a/content/ru/docs/reference/kubectl/kubectl.md
+++ b/content/ru/docs/reference/kubectl/kubectl.md
@ -4,7 +4,8 @@ content_template: templates/tool-reference
 weight: 28
 ---

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


 kubectl управляет кластерами Kubernetes.
@ -15,9 +16,10 @@ kubectl управляет кластерами Kubernetes.
 kubectl [flags]
 ```

-{{% /capture %}}

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

 <table style="width: 100%; table-layout: fixed;">
  <colgroup>
@ -515,9 +517,10 @@ kubectl [flags]



-{{% /capture %}}

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

 * [kubectl annotate](/docs/reference/generated/kubectl/kubectl-commands#annotate)	 - Обновить аннотации ресурса
 * [kubectl api-resources](/docs/reference/generated/kubectl/kubectl-commands#api-resources)	 - Вывести доступные API-ресурсы на сервере
@ -562,5 +565,5 @@ kubectl [flags]
 * [kubectl version](/docs/reference/generated/kubectl/kubectl-commands#version)	 - Вывести информацию о версии клиента и сервера
 * [kubectl wait](/docs/reference/generated/kubectl/kubectl-commands#wait)	 - Экспериментально: ожидать выполнения определенного условия в одном или нескольких ресурсах.

-{{% /capture %}}
+

--- a/content/ru/docs/reference/kubectl/overview.md
+++ b/content/ru/docs/reference/kubectl/overview.md
@ -2,21 +2,21 @@
 reviewers:
 - hw-qiaolei
 title: Обзор kubectl
-content_template: templates/concept
+content_type: concept
 weight: 20
 card:
  name: reference
  weight: 20
 ---

-{{% capture overview %}}
+<!-- overview -->
 Kubectl — это инструмент командной строки для управления кластерами Kubernetes. `kubectl` ищет файл config в директории $HOME/.kube. Вы можете указать другие файлы [kubeconfig](/docs/concepts/configuration/organize-cluster-access-kubeconfig/), установив переменную окружения KUBECONFIG или флаг [`--kubeconfig`](/docs/concepts/configuration/organize-cluster-access-kubeconfig/).

 На этой странице рассматривается синтаксис kubectl, описаны командные операции и приведены распространённые примеры. Подробную информацию о каждой команде, включая все поддерживаемые в ней флаги и подкоманды, смотрите в справочной документации [kubectl](/docs/reference/generated/kubectl/kubectl-commands/). Инструкции по установке находятся на странице [Установка и настройка kubectl](/ru/docs/tasks/kubectl/install/).

-{{% /capture %}}

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

 ## Синтаксис

@ -454,10 +454,11 @@ Current user: plugins-user

 Чтобы узнать больше о плагинах, изучите [пример CLI-плагина](https://github.com/kubernetes/sample-cli-plugin).

-{{% /capture %}}

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

 Начните использовать команды [kubectl](/ru/docs/reference/generated/kubectl/kubectl-commands/).

-{{% /capture %}}
+
--- a/content/ru/docs/setup/_index.md
+++ b/content/ru/docs/setup/_index.md
@ -7,18 +7,18 @@ no_issue: true
 title: Настройка
 main_menu: true
 weight: 30
-content_template: templates/concept
+content_type: concept
 ---

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

 Используйте информацию на этой странице, чтобы найти наиболее подходящее для вас решение по установке и настройке.

 Решение о том, как запускать Kubernetes, зависит от доступных ресурсов и необходимого уровня гибкости использования. Запуск Kubernetes возможен практически на чём угодно, от вашего ноутбука или виртуальных машины у облачного провайдера и до физических серверов. Решения позволяют как настроить полностью управляемый кластер запуском единственной команды так и создать пользовательский кластер на физических серверах. 

-{{% /capture %}}

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

 ## Решения для запуска на локальной машине

@ -74,8 +74,9 @@ content_template: templates/concept

 Выбрать [пользовательское решение](/docs/setup/pick-right-solution/#custom-solutions).

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 Перейти к [выбору подходящего решения](/docs/setup/pick-right-solution/), чтобы ознакомить с полным списком доступных решений.
-{{% /capture %}}
+
--- a/content/ru/docs/setup/learning-environment/kind.md
+++ b/content/ru/docs/setup/learning-environment/kind.md
@ -1,19 +1,19 @@
 ---
 title: Установка Kubernetes с помощью Kind
 weight: 40
-content_template: templates/concept
+content_type: concept
 ---

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

 Kind — это инструмент для запуска локальных кластеров Kubernetes с помощью "узлов" контейнера Docker.

-{{% /capture %}}

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

 ## Установка

 Смотрите страницу [по установке Kind](https://kind.sigs.k8s.io/docs/user/quick-start/).

-{{% /capture %}}
+
--- a/content/ru/docs/setup/learning-environment/minikube.md
+++ b/content/ru/docs/setup/learning-environment/minikube.md
@ -5,16 +5,16 @@ reviewers:
 - aaron-prindle
 title: Установка Kubernetes с помощью Minikube
 weight: 30
-content_template: templates/concept
+content_type: concept
 ---

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

 Minikube — это инструмент, позволяющий легко запускать Kubernetes на локальной машине. Для тех, кто хочет попробовать Kubernetes или рассмотреть возможность его использования в повседневной разработке, Minikube станет отличным вариантом, потому что он запускает одноузловой кластер Kubernetes внутри виртуальной машины (VM) на компьютере пользователя.

-{{% /capture %}}

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

 ## Возможности Minikube

@ -527,4 +527,4 @@ Minikube использует [libmachine](https://github.com/docker/machine/tre

 Помощь, вопросы и комментарии приветствуются и поощряются! Разработчики Minikube проводят время на [Slack](https://kubernetes.slack.com) в канале #minikube (получить приглашение можно [здесь](http://slack.kubernetes.io/)). У нас также есть [список рассылки kubernetes-dev на Google Groups](https://groups.google.com/forum/#!forum/kubernetes-dev). Если вы отправляете сообщение в список, пожалуйста, начните вашу тему с "minikube: ".

-{{% /capture %}}
+
--- a/content/ru/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes.md
+++ b/content/ru/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes.md
@ -1,10 +1,10 @@
 ---
 title: Настройка Liveness, Readiness и Startup проб
-content_template: templates/task
+content_type: task
 weight: 110
 ---

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

 На этой странице рассказывается, как настроить liveness, readiness и startup пробы для контейнеров.

@ -28,15 +28,16 @@ Kubelet использует startup пробы, чтобы понять, ког
 Это может быть использовано для проверки работоспособности медленно стартующих контейнеров,
 чтобы избежать убийства kubelet'ом прежде, чем они будут запущены.

-{{% /capture %}}

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

 {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}

-{{% /capture %}}

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

 ## Определение liveness команды

@ -323,9 +324,10 @@ liveness и readiness проверок:

 Для TCP проб kubelet устанавливает соединение с ноды, не внутри pod, что означает, что вы не можете использовать service name в параметре `host`, пока kubelet не может выполнить его резолв.

-{{% /capture %}}

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

 * Узнать больше о
 [Контейнерных пробах](/docs/concepts/workloads/pods/pod-lifecycle/#container-probes).
@ -336,6 +338,6 @@ liveness и readiness проверок:
 * [Container](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core)
 * [Проба](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#probe-v1-core)

-{{% /capture %}}
+


--- a/content/ru/docs/tasks/tools/install-kubectl.md
+++ b/content/ru/docs/tasks/tools/install-kubectl.md
@ -2,7 +2,7 @@
 reviewers:
 - mikedanese
 title: Установка и настройка kubectl
-content_template: templates/task
+content_type: task
 weight: 10
 card:
  name: tasks
@ -10,15 +10,16 @@ card:
  title: Установка kubectl
 ---

-{{% capture overview %}}
+<!-- overview -->
 Инструмент командной строки Kubernetes [kubectl](/docs/user-guide/kubectl/) позволяет запускать команды для кластеров Kubernetes. Вы можете использовать kubectl для развертывания приложений, проверки и управления ресурсов кластера, а также для просмотра логов. Полный список операций kubectl смотрите в [Overview of kubectl](/docs/reference/kubectl/overview/).
-{{% /capture %}}

-{{% capture prerequisites %}}
+
+## {{% heading "prerequisites" %}}
+
 Используемая вами мажорная версия kubectl не должна отличаться от той, которая используется в кластере. Например, версия v1.2 может работать с версиями v1.1, v1.2 и v1.3. Использование последней версии kubectl поможет избежать непредвиденных проблем.
-{{% /capture %}}

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

 ## Установка kubectl в Linux

@ -474,12 +475,13 @@ compinit
 {{% /tab %}}
 {{< /tabs >}}

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 * [Установка Minikube](/ru/docs/tasks/tools/install-minikube/)
 * Смотрите [руководства по установке](/docs/setup/), чтобы узнать больше про создание кластеров.
 * [Learn how to launch and expose your application.](/docs/tasks/access-application-cluster/service-access-application-cluster/)
 * Если у вас нет доступа к кластеру, который не создавали, посмотрите страницу [Совместный доступ к кластеру](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/).
 * Read the [kubectl reference docs](/docs/reference/kubectl/kubectl/)
-{{% /capture %}}
+
--- a/content/ru/docs/tasks/tools/install-minikube.md
+++ b/content/ru/docs/tasks/tools/install-minikube.md
@ -1,19 +1,20 @@
 ---
 title: Установка Minikube
-content_template: templates/task
+content_type: task
 weight: 20
 card:
  name: tasks
  weight: 10
 ---

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

 На этой странице рассказано, как установить [Minikube](/ru/docs/tutorials/hello-minikube), инструмент для запуска одноузлового кластера Kubernetes на виртуальной машине в персональном компьютере.

-{{% /capture %}}

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

 {{< tabs name="minikube_before_you_begin" >}}
 {{% tab name="Linux" %}}
@ -51,9 +52,9 @@ Hyper-V Requirements:     A hypervisor has been detected. Features required for
 {{% /tab %}}
 {{< /tabs >}}

-{{% /capture %}}

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

 # Установка minikube

@ -194,13 +195,14 @@ choco install minikube
 {{< /tabs >}}


-{{% /capture %}}

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

 * [Локальный запуск Kubernetes при помощи Minikube](/ru/docs/setup/learning-environment/minikube/)

-{{% /capture %}}
+

 ## Проверка установки

--- a/content/ru/docs/tutorials/_index.md
+++ b/content/ru/docs/tutorials/_index.md
@ -2,16 +2,16 @@
 title: Руководства
 main_menu: true
 weight: 60
-content_template: templates/concept
+content_type: concept
 ---

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

 В данном разделе документации Kubernetes можно найти руководства. В них рассказывается, как достичь определённой цели, а не просто выполнить одну [задачу](/docs/tasks/). Большинство уроков состоит из нескольких разделов, каждый из которых включает в себя шаги для последовательного выполнения. Перед тем как приступить к выполнению уроков, может быть полезно ознакомиться со [словарем терминов](/ru/docs/reference/glossary/) для последующих обращений.

-{{% /capture %}}

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

 ## Основы

@ -61,10 +61,11 @@ content_template: templates/concept

 * [Использование IP](/docs/tutorials/services/source-ip/)

-{{% /capture %}}

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

 Если вы хотите создать руководство самостоятельно, обратитесь к странице [Использование шаблонов страниц](/ru/docs/home/contribute/page-templates/), чтобы узнать информацию и посмотреть шаблоны для составления руководств.

-{{% /capture %}}
+
--- a/content/ru/docs/tutorials/hello-minikube.md
+++ b/content/ru/docs/tutorials/hello-minikube.md
@ -1,6 +1,6 @@
 ---
 title: Привет, Minikube
-content_template: templates/tutorial
+content_type: tutorial
 weight: 5
 menu:
  main:
@ -13,7 +13,7 @@ card:
  weight: 10
 ---

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

 Это руководство покажет вам, как запустить простое Hello World Node.js приложение
 на Kubernetes используя [Minikube](/docs/getting-started-guides/minikube) и Katacoda.
@ -23,17 +23,19 @@ Katacoda предоставляет бесплатную, встроенную
 Вы также можете следовать этому руководству, если вы установили [Minikube locally](/docs/tasks/tools/install-minikube/).
 {{< /note >}}

-{{% /capture %}}

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

 * Разверните hello world приложение в Minikube.
 * Запустите приложение.
 * Посмотрите логи приложения.

-{{% /capture %}}

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

 Для этого примера создан образ контейнера, собранный на основе следующих файлов:

@ -43,9 +45,9 @@ Katacoda предоставляет бесплатную, встроенную

 Чтобы получить больше информации по запуску команды `docker build`, ознакомьтесь с [документацией по Docker](https://docs.docker.com/engine/reference/commandline/build/).

-{{% /capture %}}

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

 ## Создание кластера Minikube

@ -261,12 +263,13 @@ minikube stop
 minikube delete
 ```

-{{% /capture %}}

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

 * Больше об [объектах деплоймента](/docs/concepts/workloads/controllers/deployment/).
 * Больше о [развёртывании приложения](/docs/user-guide/deploying-applications/).
 * Больше об [объектах сервиса](/docs/concepts/services-networking/service/).

-{{% /capture %}}
+