|
1 | 1 | # Документация по Kubernetes
|
2 | 2 |
|
3 |
| -[](https://travis-ci.org/kubernetes/website) |
4 |
| -[](https://github.com/kubernetes/website/releases/latest) |
| 3 | +[](https://app.netlify.com/sites/kubernetes-io-master-staging/deploys) [](https://github.com/kubernetes/website/releases/latest) |
5 | 4 |
|
6 | 5 | Добро пожаловать! Данный репозиторий содержит все необходимые файлы для сборки [сайта Kubernetes и документации](https://kubernetes.io/). Мы благодарим вас за старания!
|
7 | 6 |
|
| 7 | +## Запуск сайта с помощью Hugo |
| 8 | + |
| 9 | +Обратитесь к [официальной документации Hugo](https://gohugo.io/getting-started/installing/), чтобы установить Hugo. Убедитесь, что вы установили правильную версию Hugo, которая устанавливается в переменной окружения `HUGO_VERSION` в файле [`netlify.toml`](netlify.toml#L10). |
| 10 | + |
| 11 | +После установки Hugo, чтобы запустить сайт, выполните в консоли: |
| 12 | + |
| 13 | +```bash |
| 14 | +git clone https://github.com/kubernetes/website.git |
| 15 | +cd website |
| 16 | +hugo server --buildFuture |
| 17 | +``` |
| 18 | + |
| 19 | +Эта команда запустит сервер Hugo на порту 1313. Откройте браузер и перейдите по ссылке http://localhost:1313, чтобы открыть сайт. Если вы отредактируете исходные файлы сайта, Hugo автоматически применит изменения и обновит страницу в браузере. |
| 20 | + |
| 21 | +## Сообщество, обсуждение, вклад и поддержка |
| 22 | + |
| 23 | +Узнайте, как поучаствовать в жизни сообщества Kubernetes на [странице сообщества](http://kubernetes.io/community/). |
| 24 | + |
| 25 | +Вы можете связаться с сопровождающими этого проекта по следующим ссылкам: |
| 26 | + |
| 27 | +- [Канал в Slack](https://kubernetes.slack.com/messages/sig-docs) |
| 28 | +- [Рассылка](https://groups.google.com/forum/#!forum/kubernetes-sig-docs) |
| 29 | + |
8 | 30 | ## Вклад в документацию
|
9 | 31 |
|
10 | 32 | Нажмите на кнопку **Fork** в правом верхнем углу, чтобы создать копию этого репозитория в ваш GitHub-аккаунт. Эта копия называется *форк-репозиторием*. Делайте любые изменения в вашем форк-репозитории, и когда вы будете готовы опубликовать изменения, откройте форк-репозиторий и создайте новый пулреквест, чтобы уведомить нас.
|
11 | 33 |
|
12 |
| -После того, как вы отправите пулреквест, ревьювер Kubernetes даст по нему обратную связь. Вы, как автор пулреквеста, **должны обновить свой пулреквест после его рассмотрения ревьювером Kubernetes.** Вполне возможно, что более одного ревьювера Kubernetes оставят свои комментарии или даже может быть так, что новый комментарий ревьювера Kubernetes будет отличаться от первоначального назначенного ревьювера. Кроме того, в некоторых случаях один из ревьюверов может запросить технический обзор у [технического ревьювера Kubernetes](https://github.com/kubernetes/website/wiki/Tech-reviewers), если это будет необходимо. Ревьюверы сделают все возможное, чтобы как можно оперативно оставить свои предложения и пожелания, но время ответа может варьироваться в зависимости от обстоятельств. |
| 34 | +После того, как вы отправите пулреквест, ревьювер Kubernetes даст по нему обратную связь. Вы, как автор пулреквеста, **должны обновить свой пулреквест после его рассмотрения ревьювером Kubernetes.** |
| 35 | + |
| 36 | +Вполне возможно, что более одного ревьювера Kubernetes оставят свои комментарии или даже может быть так, что новый комментарий ревьювера Kubernetes будет отличаться от первоначального назначенного ревьювера. Кроме того, в некоторых случаях один из ревьюверов может запросить технический обзор у [технического ревьювера Kubernetes](https://github.com/kubernetes/website/wiki/Tech-reviewers), если это будет необходимо. Ревьюверы сделают все возможное, чтобы как можно оперативно оставить свои предложения и пожелания, но время ответа может варьироваться в зависимости от обстоятельств. |
13 | 37 |
|
14 | 38 | Узнать подробнее о том, как поучаствовать в документации Kubernetes, вы можете по ссылкам ниже:
|
15 | 39 |
|
16 |
| -* [Начните вносить свой вклад](https://kubernetes.io/docs/contribute/start/) |
17 |
| -* [Просмотр локальных изменений](http://kubernetes.io/docs/contribute/intermediate#view-your-changes-locally) |
| 40 | +* [Начните вносить свой вклад](https://kubernetes.io/docs/contribute/) |
18 | 41 | * [Использование шаблонов страниц](http://kubernetes.io/docs/contribute/style/page-templates/)
|
19 | 42 | * [Руководство по оформлению документации](http://kubernetes.io/docs/contribute/style/style-guide/)
|
20 | 43 | * [Руководство по локализации Kubernetes](https://kubernetes.io/docs/contribute/localization/)
|
21 | 44 |
|
22 | 45 | ## Файл `README.md` на других языках
|
23 |
| -| | | |
| 46 | +| другие языки | другие языки | |
24 | 47 | |-------------------------------|-------------------------------|
|
25 | 48 | | [Английский](README.md) | [Французский](README-fr.md) |
|
26 | 49 | | [Корейский](README-ko.md) | [Немецкий](README-de.md) |
|
|
29 | 52 | | [Китайский](README-zh.md) | [Японский](README-ja.md) |
|
30 | 53 | | [Вьетнамский](README-vi.md) | [Итальянский](README-it.md) |
|
31 | 54 | | [Польский]( README-pl.md) | [Украинский](README-uk.md) |
|
32 |
| -| | | |
33 |
| - |
34 |
| -## Запуск сайта локально с помощью Docker |
35 |
| - |
36 |
| -Рекомендованный способ запуска сайта Kubernetes на локальной машине - использовать специальный образ [Docker](https://docker.com), который включает статический генератор сайтов [Hugo](https://gohugo.io). |
37 |
| - |
38 |
| -> Если вы используете Windows, вам необходимо установить дополнительные инструменты через [Chocolatey](https://chocolatey.org). `choco install make` |
39 |
| -
|
40 |
| -> Если вы хотите запустить сайт локально без Docker, обратитесь к разделу [Запуск сайта с помощью Hugo](#запуск-сайта-с-помощью-hugo) ниже на этой странице. |
41 |
| -
|
42 |
| -Когда Docker [установлен и запущен](https://www.docker.com/get-started), соберите локально Docker-образ `kubernetes-hugo`, выполнив команду в консоли: |
43 |
| - |
44 |
| -```bash |
45 |
| -make docker-image |
46 |
| -``` |
47 |
| - |
48 |
| -После того, как вы собрали образ, можно запустить сайт локально: |
49 |
| - |
50 |
| -```bash |
51 |
| -make docker-serve |
52 |
| -``` |
53 |
| - |
54 |
| -Откройте браузер и перейдите по ссылке http://localhost:1313, чтобы открыть сайт. Если вы редактируете исходные файлы сайта, Hugo автоматически применит изменения и обновит страницу в браузере. |
55 |
| - |
56 |
| -## Запуск сайта с помощью Hugo |
57 |
| - |
58 |
| -Обратитесь к [официальной документации Hugo](https://gohugo.io/getting-started/installing/), чтобы установить Hugo. Убедитесь, что вы установили правильную версию Hugo, которая устанавливается в переменной окружения `HUGO_VERSION` в файле [`netlify.toml`](netlify.toml#L10). |
59 |
| - |
60 |
| -После установки Hugo, чтобы запустить сайт, выполните в консоли: |
61 |
| - |
62 |
| -```bash |
63 |
| -make serve |
64 |
| -``` |
65 |
| - |
66 |
| -Эта команда запустит сервер Hugo на порту 1313. Откройте браузер и перейдите по ссылке http://localhost:1313, чтобы открыть сайт. Если вы отредактируете исходные файлы сайта, Hugo автоматически применит изменения и обновит страницу в браузере. |
67 |
| - |
68 |
| -## Сообщество, обсуждение, вклад и поддержка |
69 |
| - |
70 |
| -Узнайте, как поучаствовать в жизни сообщества Kubernetes на [странице сообщества](http://kubernetes.io/community/). |
71 |
| - |
72 |
| -Вы можете связаться с сопровождающими этого проекта по следующим ссылкам: |
73 |
| - |
74 |
| -- [Канал в Slack](https://kubernetes.slack.com/messages/sig-docs) |
75 |
| -- [Рассылка](https://groups.google.com/forum/#!forum/kubernetes-sig-docs) |
76 | 55 |
|
77 | 56 | ### Кодекс поведения
|
78 | 57 |
|
79 |
| -Участие в сообществе Kubernetes регулируется [кодексом поведения Kubernetes](code-of-conduct.md). |
| 58 | +Участие в сообществе Kubernetes регулируется [кодексом поведения CNCF](https://github.com/cncf/foundation/blob/master/code-of-conduct.md). |
80 | 59 |
|
81 | 60 | ## Спасибо!
|
82 | 61 |
|
|
0 commit comments