85 lines
7.5 KiB
Markdown
85 lines
7.5 KiB
Markdown
# Документація Kubernetes
|
||
|
||
[](https://travis-ci.org/kubernetes/website)
|
||
[](https://github.com/kubernetes/website/releases/latest)
|
||
|
||
Вітаємо! В цьому репозиторії міститься все необхідне для роботи над [сайтом і документацією Kubernetes](https://kubernetes.io/). Ми щасливі, що ви хочете зробити свій внесок!
|
||
|
||
## Внесок у документацію
|
||
|
||
Ви можете створити копію цього репозиторія у своєму акаунті на GitHub, натиснувши на кнопку **Fork**, що розташована справа зверху. Ця копія називатиметься *fork* (відгалуження). Зробіть будь-які необхідні зміни у своєму відгалуженні. Коли ви будете готові надіслати їх нам, перейдіть до свого відгалуження і створіть новий pull request, щоб сповістити нас.
|
||
|
||
Після того, як ви створили pull request, рецензент Kubernetes зобов’язується надати вам по ньому чіткий і конструктивний коментар. **Ваш обов’язок як творця pull request - відкоригувати його відповідно до зауважень рецензента Kubernetes.** Також, зауважте: може статися так, що ви отримаєте коментарі від декількох рецензентів Kubernetes або від іншого рецензента, ніж той, якого вам було призначено від початку. Крім того, за потреби один із ваших рецензентів може запросити технічну перевірку від одного з [технічних рецензентів Kubernetes](https://github.com/kubernetes/website/wiki/Tech-reviewers). Рецензенти намагатимуться відреагувати вчасно, проте час відповіді може відрізнятися в залежності від обставин.
|
||
|
||
Більше інформації про внесок у документацію Kubernetes ви знайдете у наступних джерелах:
|
||
|
||
* [Внесок: з чого почати](https://kubernetes.io/docs/contribute/start/)
|
||
* [Візуалізація запропонованих змін до документації](http://kubernetes.io/docs/contribute/intermediate#view-your-changes-locally)
|
||
* [Використання шаблонів сторінок](http://kubernetes.io/docs/contribute/style/page-templates/)
|
||
* [Керівництво зі стилю оформлення документації](http://kubernetes.io/docs/contribute/style/style-guide/)
|
||
* [Переклад документації Kubernetes іншими мовами](https://kubernetes.io/docs/contribute/localization/)
|
||
|
||
## Файл `README.md` іншими мовами
|
||
|
||
| | |
|
||
|-------------------------------|-------------------------------|
|
||
| [Англійська](README.md) | [Французька](README-fr.md) |
|
||
| [Корейська](README-ko.md) | [Німецька](README-de.md) |
|
||
| [Португальська](README-pt.md) | [Хінді](README-hi.md) |
|
||
| [Іспанська](README-es.md) | [Індонезійська](README-id.md) |
|
||
| [Китайська](README-zh.md) | [Японська](README-ja.md) |
|
||
| [В'єтнамська](README-vi.md) | [Російська](README-ru.md) |
|
||
| [Італійська](README-it.md) | [Польська](README-pl.md) |
|
||
| | |
|
||
|
||
## Запуск сайту локально за допомогою Docker
|
||
|
||
Для локального запуску сайту Kubernetes рекомендовано запустити спеціальний [Docker](https://docker.com)-образ, що містить генератор статичних сайтів [Hugo](https://gohugo.io).
|
||
|
||
> Якщо ви працюєте під Windows, вам знадобиться ще декілька інструментів, які можна встановити за допомогою [Chocolatey](https://chocolatey.org). `choco install make`
|
||
|
||
> Якщо ви вважаєте кращим запустити сайт локально без використання Docker, дивіться пункт нижче [Запуск сайту локально за допомогою Hugo](#запуск-сайту-локально-зa-допомогою-hugo).
|
||
|
||
Якщо у вас вже [запущений](https://www.docker.com/get-started) Docker, зберіть локальний Docker-образ `kubernetes-hugo`:
|
||
|
||
```bash
|
||
make docker-image
|
||
```
|
||
|
||
Після того, як образ зібрано, ви можете запустити сайт локально:
|
||
|
||
```bash
|
||
make docker-serve
|
||
```
|
||
|
||
Відкрийте у своєму браузері http://localhost:1313, щоб побачити сайт. По мірі того, як ви змінюєте вихідний код, Hugo актуалізує сайт відповідно до внесених змін і оновлює сторінку у браузері.
|
||
|
||
## Запуск сайту локально зa допомогою Hugo
|
||
|
||
Для інструкцій по установці Hugo дивіться [офіційну документацію](https://gohugo.io/getting-started/installing/). Обов’язково встановіть розширену версію Hugo, яка позначена змінною оточення `HUGO_VERSION` у файлі [`netlify.toml`](netlify.toml#L9).
|
||
|
||
Після установки Hugo, запустіть сайт локально командою:
|
||
|
||
```bash
|
||
make serve
|
||
```
|
||
|
||
Команда запустить локальний Hugo-сервер на порту 1313. Відкрийте у своєму браузері http://localhost:1313, щоб побачити сайт. По мірі того, як ви змінюєте вихідний код, Hugo актуалізує сайт відповідно до внесених змін і оновлює сторінку у браузері.
|
||
|
||
## Спільнота, обговорення, внесок і підтримка
|
||
|
||
Дізнайтеся, як долучитися до спільноти Kubernetes на [сторінці спільноти](http://kubernetes.io/community/).
|
||
|
||
Для зв’язку із супроводжуючими проекту скористайтеся:
|
||
|
||
- [Slack](https://kubernetes.slack.com/messages/sig-docs)
|
||
- [Поштова розсилка](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
|
||
|
||
### Кодекс поведінки
|
||
|
||
Участь у спільноті Kubernetes визначається правилами [Кодексу поведінки спільноти Kubernetes](code-of-conduct.md).
|
||
|
||
## Дякуємо!
|
||
|
||
Долучення до спільноти - запорука успішного розвитку Kubernetes. Ми цінуємо ваш внесок у наш сайт і документацію!
|