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