kılavuz: dil dizinleri (en/tr/de/fr/ru) + dil değiştirici ve bölüm gezinmesi
- iki dilli tek dosyalar en/ ve tr/ altına ayrıldı - Almanca, Fransızca, Rusça çeviriler eklendi (10 bölüm) - kök README dil seçici oldu; her dilde kendi içindekiler sayfası - her bölüme dil değiştirici satırı + önceki/sonraki gezinme eklendi
This commit is contained in:
@@ -0,0 +1,43 @@
|
||||
# 01 — Начало работы
|
||||
|
||||
🌍 [English](../../en/01-getting-started/readme.md) · [Türkçe](../../tr/01-getting-started/readme.md) · [Deutsch](../../de/01-getting-started/readme.md) · [Français](../../fr/01-getting-started/readme.md) · **Русский**
|
||||
|
||||
KabaForge — это место, где живут ваш код, документы и история проектов. Эта глава помогает войти и осмотреться.
|
||||
|
||||
## Вход
|
||||
|
||||
1. Откройте [forge.kabaforce.com](https://forge.kabaforce.com).
|
||||
2. Нажмите **Войти через KabaForce ID**.
|
||||
3. Введите данные учётной записи KabaForce на `id.kabaforce.com`.
|
||||
4. Вы возвращаетесь в KabaForge уже авторизованным.
|
||||
|
||||
Отдельного пароля у KabaForge нет — KabaForce ID это единственная нужная учётная запись. Если её ещё нет, воспользуйтесь ссылкой **Регистрация** на той же странице.
|
||||
|
||||
## Что вы видите после входа
|
||||
|
||||
| Раздел | Для чего он |
|
||||
|--------|-------------|
|
||||
| **Панель** (главная) | Последняя активность в ваших репозиториях |
|
||||
| **Обзор** | Публичные репозитории на этом сервере |
|
||||
| **+** (справа вверху) | Создать репозиторий или организацию |
|
||||
| **Аватар** (справа вверху) | Профиль, настройки и выход |
|
||||
|
||||
## Слова, которые вам встретятся
|
||||
|
||||
- **Репозиторий (repo)** — один проект: его файлы и вся их история.
|
||||
- **Коммит** — одно сохранённое изменение с описывающим его сообщением.
|
||||
- **Ветка** — параллельная линия работы; ветка по умолчанию обычно называется `main`.
|
||||
- **Пул-реквест** — предложение влить одну ветку в другую.
|
||||
|
||||
## Ваши первые пять минут
|
||||
|
||||
1. Нажмите **+ → Новый репозиторий**.
|
||||
2. Назовите его `proba` (или как угодно), отметьте *Инициализировать репозиторий*, нажмите **Создать**.
|
||||
3. Откройте его и нажмите **Добавить файл → Новый файл**.
|
||||
4. Введите имя `readme.md`, напишите пару строк, нажмите **Применить изменения**.
|
||||
|
||||
Теперь у вас есть репозиторий с главной страницей. Следующие главы подробно разбирают каждый из этих шагов.
|
||||
|
||||
---
|
||||
|
||||
📚 [Содержание](../README.md) · [Далее: 02 — Создание репозитория](../02-create-repository/readme.md) ➡
|
||||
@@ -0,0 +1,41 @@
|
||||
# 02 — Создание репозитория
|
||||
|
||||
🌍 [English](../../en/02-create-repository/readme.md) · [Türkçe](../../tr/02-create-repository/readme.md) · [Deutsch](../../de/02-create-repository/readme.md) · [Français](../../fr/02-create-repository/readme.md) · **Русский**
|
||||
|
||||
Репозиторий — это один проект. Создавайте по одному на проект, а не на каждый файл.
|
||||
|
||||
## Шаги
|
||||
|
||||
1. Нажмите **+** справа вверху → **Новый репозиторий**.
|
||||
2. **Владелец** — вы сами или организация, в которой вы состоите.
|
||||
3. **Имя репозитория** — строчными буквами, без пробелов: `network-lab`, `web-site`, `guide`.
|
||||
4. **Описание** — одна строка о том, что это. Она видна в результатах поиска.
|
||||
5. **Видимость**
|
||||
- *Публичный* — читать может любой, кто дотянется до сервера.
|
||||
- *Приватный* — только вы и те, кого вы пригласите.
|
||||
6. **Инициализировать репозиторий** — поставьте галочку. Это создаёт первый коммит с `README.md`, и репозиторий сразу готов к работе.
|
||||
7. Нажмите **Создать репозиторий**.
|
||||
|
||||
## Хорошие имена
|
||||
|
||||
| Вместо | Лучше |
|
||||
|--------|-------|
|
||||
| `Новый Проект (финал)` | `novyy-proekt` |
|
||||
| `Сетевая работа 1` | `network-lab-01` |
|
||||
| `тест тест 2` | `packet-tracer-tests` |
|
||||
|
||||
Пробелы и скобки в именах усложняют обмен ссылками и могут сбивать относительные пути внутри документов. Строчные латинские буквы, цифры и дефисы безопасны всегда.
|
||||
|
||||
## После создания
|
||||
|
||||
- **Настройки → Соавторы** — выдать другим доступ на чтение или запись.
|
||||
- **Настройки → Ветки** — защитить `main`, чтобы никто не коммитил в неё напрямую.
|
||||
- **Добавить файл** — начать наполнять репозиторий (глава 03).
|
||||
|
||||
## Удаление репозитория
|
||||
|
||||
**Настройки → Опасная зона → Удалить этот репозиторий.** Для подтверждения придётся ввести имя репозитория. Отменить это нельзя — история уходит вместе с ним.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Назад: 01 — Начало работы](../01-getting-started/readme.md) · 📚 [Содержание](../README.md) · [Далее: 03 — Добавление и редактирование файлов](../03-add-and-edit-files/readme.md) ➡
|
||||
@@ -0,0 +1,52 @@
|
||||
# 03 — Добавление и редактирование файлов
|
||||
|
||||
🌍 [English](../../en/03-add-and-edit-files/readme.md) · [Türkçe](../../tr/03-add-and-edit-files/readme.md) · [Deutsch](../../de/03-add-and-edit-files/readme.md) · [Français](../../fr/03-add-and-edit-files/readme.md) · **Русский**
|
||||
|
||||
Всё в этой главе делается в браузере. Ничего устанавливать не нужно.
|
||||
|
||||
## Меню «Добавить файл»
|
||||
|
||||
Откройте репозиторий (или любой каталог внутри него) и нажмите **Добавить файл**:
|
||||
|
||||
| Пункт | Для чего |
|
||||
|-------|----------|
|
||||
| **Новый файл** | Написать файл вручную — заметки, код, `readme.md` |
|
||||
| **Новый каталог** | Создать пустую папку (глава 04) |
|
||||
| **Загрузить файл** | Принести файлы со своего компьютера — картинки, PDF, архивы |
|
||||
| **Патч** | Применить готовый diff |
|
||||
|
||||
## Написание нового файла
|
||||
|
||||
1. **Добавить файл → Новый файл**.
|
||||
2. Введите имя файла сверху, например `notes.md`.
|
||||
Если ввести `docs/notes.md`, каталог `docs` создастся одновременно.
|
||||
3. Напишите содержимое в редакторе.
|
||||
4. Заполните блок коммита внизу:
|
||||
- **Краткое описание** — коротко, в повелительном наклонении: *добавить заметки по установке*.
|
||||
- **Описание** — необязательные подробности.
|
||||
5. Выберите **Закоммитить прямо в `main`** или *создать новую ветку*, если сначала нужна проверка (глава 09).
|
||||
6. Нажмите **Применить изменения**.
|
||||
|
||||
## Загрузка файлов
|
||||
|
||||
1. **Добавить файл → Загрузить файл**.
|
||||
2. Перетащите файлы в поле или нажмите на него и выберите их.
|
||||
3. Чтобы положить их в подкаталог, впишите его имя в поле пути сверху.
|
||||
4. Нажмите **Применить изменения**.
|
||||
|
||||
Очень большие файлы (видео, образы дисков) место в файловом хранилище, а не в репозитории — история хранит каждую версию навсегда.
|
||||
|
||||
## Редактирование существующего файла
|
||||
|
||||
1. Откройте файл.
|
||||
2. Нажмите значок карандаша ✏️ справа вверху.
|
||||
3. Измените текст; вкладка **Предпросмотр изменений** показывает, что именно вы поменяли.
|
||||
4. Закоммитьте, как описано выше.
|
||||
|
||||
## Переименование и перемещение
|
||||
|
||||
При редактировании можно изменить путь: поставьте курсор в поле имени и введите новый путь, например `docs/notes.md`. После коммита файл будет перемещён — история сохранится.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Назад: 02 — Создание репозитория](../02-create-repository/readme.md) · 📚 [Содержание](../README.md) · [Далее: 04 — Создание каталогов](../04-create-directory/readme.md) ➡
|
||||
@@ -0,0 +1,50 @@
|
||||
# 04 — Создание каталогов
|
||||
|
||||
🌍 [English](../../en/04-create-directory/readme.md) · [Türkçe](../../tr/04-create-directory/readme.md) · [Deutsch](../../de/04-create-directory/readme.md) · [Français](../../fr/04-create-directory/readme.md) · **Русский**
|
||||
|
||||
## Быстрый способ
|
||||
|
||||
1. Откройте репозиторий или каталог, внутри которого нужна новая папка.
|
||||
2. **Добавить файл → Новый каталог**.
|
||||
3. Введите имя папки, например `docs`.
|
||||
4. Нажмите **Применить изменения**.
|
||||
|
||||
Над полем имени страница показывает, где будет создана папка (`текущий/путь/`), так что вы всегда знаете, где находитесь.
|
||||
|
||||
## Вложенные папки за один раз
|
||||
|
||||
Введите путь вместо одного имени:
|
||||
|
||||
```
|
||||
docs/images
|
||||
```
|
||||
|
||||
Это создаст `docs` и внутри него `images` одним коммитом.
|
||||
|
||||
## Почему появляется файл `.gitkeep`
|
||||
|
||||
Система контроля версий отслеживает *файлы*, а не пустые папки. Чтобы сохранить пока пустую папку, KabaForge кладёт внутрь пустой файл `.gitkeep`. На проект он никак не влияет — удалите его, когда в папке появится настоящее содержимое, или просто оставьте.
|
||||
|
||||
## Другой способ: создать папку вместе с файлом
|
||||
|
||||
**Добавить файл → Новый файл** и введите путь в поле имени:
|
||||
|
||||
```
|
||||
reports/2026/january.md
|
||||
```
|
||||
|
||||
Обе папки и файл создаются вместе. Используйте это, когда уже знаете, каким будет первый файл.
|
||||
|
||||
## Правила именования, которые избавят от боли
|
||||
|
||||
| Избегайте | Используйте |
|
||||
|-----------|-------------|
|
||||
| `Сетевая работа (1)` | `network-lab-01` |
|
||||
| `Мои Заметки` | `my-notes` или `notes` |
|
||||
| `картинки и вложения` | `assets` |
|
||||
|
||||
Имена папок с **пробелами** или скобками усложняют обмен ссылками, а относительные пути к изображениям в Markdown становятся хрупкими. Строчные латинские буквы, цифры и дефисы безопасны всегда.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Назад: 03 — Добавление и редактирование файлов](../03-add-and-edit-files/readme.md) · 📚 [Содержание](../README.md) · [Далее: 05 — Удаление файлов и каталогов](../05-delete-files/readme.md) ➡
|
||||
@@ -0,0 +1,49 @@
|
||||
# 05 — Удаление файлов и каталогов
|
||||
|
||||
🌍 [English](../../en/05-delete-files/readme.md) · [Türkçe](../../tr/05-delete-files/readme.md) · [Deutsch](../../de/05-delete-files/readme.md) · [Français](../../fr/05-delete-files/readme.md) · **Русский**
|
||||
|
||||
По-настоящему ничего не пропадает: удаление — это просто ещё один коммит, а старое содержимое остаётся в истории.
|
||||
|
||||
## Удаление одного файла
|
||||
|
||||
1. Откройте файл.
|
||||
2. Нажмите меню **…** справа вверху в просмотре файла.
|
||||
3. Выберите **Удалить этот файл** (или значок 🗑️ рядом с карандашом редактирования).
|
||||
4. Напишите сообщение коммита и нажмите **Применить изменения**.
|
||||
|
||||
## Удаление каталога
|
||||
|
||||
1. Откройте каталог.
|
||||
2. Нажмите меню **…** рядом с *Добавить файл*.
|
||||
3. Выберите **Удалить этот каталог**.
|
||||
4. Закоммитьте.
|
||||
|
||||
Всё содержимое каталога удаляется этим одним коммитом.
|
||||
|
||||
## Удаление нескольких файлов сразу
|
||||
|
||||
Браузер удаляет по одному пути за раз. Для большой уборки работайте со своего компьютера (глава 10):
|
||||
|
||||
```bash
|
||||
git rm -r old-folder
|
||||
git commit -m "удалить старый каталог"
|
||||
git push
|
||||
```
|
||||
|
||||
## Как вернуть удалённый файл
|
||||
|
||||
1. Откройте **Историю** каталога, где он лежал, или историю репозитория.
|
||||
2. Найдите коммит *перед* удалением.
|
||||
3. Откройте файл в этом коммите и скопируйте содержимое либо нажмите **Просмотреть исходники на этот момент** и создайте его заново.
|
||||
|
||||
Всё, что хоть раз было закоммичено, можно восстановить. То, что вы набрали в редакторе, но так и не закоммитили, — нет.
|
||||
|
||||
## Будьте внимательны
|
||||
|
||||
- **Удаление каталога вместо файла** — если вы имеете в виду один файл, проверьте, что в меню написано *файл*.
|
||||
- **Защищённые ветки** — если `main` защищена, удаление проходит через пул-реквест (глава 09).
|
||||
- **Секреты** — удаление пароля из файла *не* убирает его из истории. Меняйте сам пароль.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Назад: 04 — Создание каталогов](../04-create-directory/readme.md) · 📚 [Содержание](../README.md) · [Далее: 06 — Основы Markdown](../06-markdown-basics/readme.md) ➡
|
||||
@@ -0,0 +1,83 @@
|
||||
# 06 — Основы Markdown
|
||||
|
||||
🌍 [English](../../en/06-markdown-basics/readme.md) · [Türkçe](../../tr/06-markdown-basics/readme.md) · [Deutsch](../../de/06-markdown-basics/readme.md) · [Français](../../fr/06-markdown-basics/readme.md) · **Русский**
|
||||
|
||||
Markdown — это обычный текст с несколькими правилами пунктуации. Файлы с расширением `.md` отображаются автоматически, а файл с именем `readme.md` показывается на странице своего каталога.
|
||||
|
||||
## Заголовки
|
||||
|
||||
```markdown
|
||||
# Заголовок
|
||||
## Раздел
|
||||
### Подраздел
|
||||
```
|
||||
|
||||
Оставляйте пустую строку до и после заголовка.
|
||||
|
||||
## Текст
|
||||
|
||||
```markdown
|
||||
**жирный** *курсив* ~~зачёркнутый~~ `код`
|
||||
```
|
||||
|
||||
Одиночный перенос строки игнорируется. Чтобы начать новый абзац, оставьте пустую строку.
|
||||
|
||||
## Списки
|
||||
|
||||
```markdown
|
||||
- первый
|
||||
- второй
|
||||
- вложенный (два пробела)
|
||||
|
||||
1. шаг один
|
||||
2. шаг два
|
||||
```
|
||||
|
||||
## Ссылки
|
||||
|
||||
```markdown
|
||||
[KabaForge](https://forge.kabaforce.com)
|
||||
[глава 04](../04-create-directory/readme.md)
|
||||
```
|
||||
|
||||
Ссылки на файлы того же репозитория лучше писать относительными путями — они продолжают работать в любой ветке.
|
||||
|
||||
## Код
|
||||
|
||||
Блоки в «заборчиках» сохраняют отступы и добавляют подсветку. Язык пишется сразу после открывающего заборчика:
|
||||
|
||||
~~~markdown
|
||||
```bash
|
||||
git status
|
||||
```
|
||||
~~~
|
||||
|
||||
## Таблицы
|
||||
|
||||
```markdown
|
||||
| Столбец | Значение |
|
||||
|---------|----------|
|
||||
| `main` | ветка по умолчанию |
|
||||
| `.md` | файл Markdown |
|
||||
```
|
||||
|
||||
## Цитаты, линии, задачи
|
||||
|
||||
```markdown
|
||||
> Цитируемая заметка.
|
||||
|
||||
---
|
||||
|
||||
- [x] сделано
|
||||
- [ ] ещё не сделано
|
||||
```
|
||||
|
||||
## Практические советы
|
||||
|
||||
- Смотрите предпросмотр до коммита: вкладка **Предпросмотр** в редакторе показывает ровно то, что увидят другие.
|
||||
- В длинных документах пишите по одному предложению на строку — различия между версиями остаются читаемыми.
|
||||
- Эмодзи работают напрямую: 📌 ✅ ⚠️
|
||||
|
||||
---
|
||||
|
||||
⬅ [Назад: 05 — Удаление файлов и каталогов](../05-delete-files/readme.md) · 📚 [Содержание](../README.md) · [Далее: 07 — Изображения и вложения](../07-images-and-media/readme.md) ➡
|
||||
@@ -0,0 +1,71 @@
|
||||
# 07 — Изображения и вложения
|
||||
|
||||
🌍 [English](../../en/07-images-and-media/readme.md) · [Türkçe](../../tr/07-images-and-media/readme.md) · [Deutsch](../../de/07-images-and-media/readme.md) · [Français](../../fr/07-images-and-media/readme.md) · **Русский**
|
||||
|
||||
## Как вставить изображение в документ
|
||||
|
||||
1. Загрузите изображение рядом с документом: откройте каталог, **Добавить файл → Загрузить файл**.
|
||||
2. Сошлитесь на него из файла Markdown:
|
||||
|
||||
```markdown
|
||||

|
||||
```
|
||||
|
||||
Текст в квадратных скобках — это описание, которое показывается, если изображение не загрузилось, и которое читают программы для незрячих. Пишите настоящее описание, а не «картинка».
|
||||
|
||||
## Где хранить изображения
|
||||
|
||||
Предсказуемая структура, которая работает всегда:
|
||||
|
||||
```
|
||||
project/
|
||||
readme.md
|
||||
assets/
|
||||
topology.png
|
||||
rack.jpg
|
||||
```
|
||||
|
||||
и в `readme.md`:
|
||||
|
||||
```markdown
|
||||

|
||||
```
|
||||
|
||||
## Именование — единственное правило, которое стоит запомнить
|
||||
|
||||
Для **каталогов** и файлов изображений используйте строчные имена без пробелов:
|
||||
|
||||
| Хрупко | Безопасно |
|
||||
|--------|-----------|
|
||||
| `Снимок экрана.PNG` | `screenshot.png` |
|
||||
| `1-) Заметки Inter-VLAN/` | `01-inter-vlan/` |
|
||||
|
||||
Если пробелы в имени всё же есть, в ссылке пишите их как `%20`:
|
||||
|
||||
```markdown
|
||||

|
||||
```
|
||||
|
||||
## Управление размером
|
||||
|
||||
В Markdown нет параметра размера, поэтому при необходимости используйте обычный HTML-тег:
|
||||
|
||||
```markdown
|
||||
<img src="assets/topology.png" alt="Топология сети" width="600">
|
||||
```
|
||||
|
||||
## Ссылка на файл вместо его показа
|
||||
|
||||
Уберите восклицательный знак — получится ссылка на скачивание:
|
||||
|
||||
```markdown
|
||||
[Файл Packet Tracer](main.pkt)
|
||||
```
|
||||
|
||||
## Вложения в задачах
|
||||
|
||||
Во время написания задачи или комментария перетащите файл в текстовое поле. Он загрузится, и ссылка вставится сама. Используйте это для скриншотов и логов, которым не место в самом репозитории.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Назад: 06 — Основы Markdown](../06-markdown-basics/readme.md) · 📚 [Содержание](../README.md) · [Далее: 08 — Коммиты и история](../08-commits-and-history/readme.md) ➡
|
||||
@@ -0,0 +1,46 @@
|
||||
# 08 — Коммиты и история
|
||||
|
||||
🌍 [English](../../en/08-commits-and-history/readme.md) · [Türkçe](../../tr/08-commits-and-history/readme.md) · [Deutsch](../../de/08-commits-and-history/readme.md) · [Français](../../fr/08-commits-and-history/readme.md) · **Русский**
|
||||
|
||||
Коммит — это один сохранённый шаг: что изменилось, кто изменил, когда и зачем.
|
||||
|
||||
## Как написать хорошее сообщение
|
||||
|
||||
```
|
||||
добавить заметки по настройке VLAN
|
||||
исправить неверный адрес шлюза в readme
|
||||
удалить неиспользуемый дамп трафика
|
||||
```
|
||||
|
||||
- Одна строка, настоящее время, без точки в конце.
|
||||
- Говорите, *что делает* изменение, а не «обновление» или «исправления».
|
||||
- Нужно объяснить подробнее? Пишите в поле описания под кратким.
|
||||
|
||||
## Хорошие привычки
|
||||
|
||||
- **Одна мысль на коммит.** Два несвязанных изменения — это два коммита.
|
||||
- **Коммитьте часто.** Маленькие шаги легко просматривать и легко откатывать.
|
||||
- **Никогда не коммитьте пароли, ключи и токены.** Удаление позже не убирает их из истории — нужно менять сам секрет.
|
||||
|
||||
## Как читать историю
|
||||
|
||||
| Где | Что даёт |
|
||||
|-----|----------|
|
||||
| Кнопка **История** на каталоге или файле | Все коммиты, которые его затронули |
|
||||
| Страница коммита | Полный diff: красное — удалено, зелёное — добавлено |
|
||||
| **Blame** на файле | Какой коммит последним изменил каждую строку |
|
||||
| Вкладка **Активность** | График вклада во времени |
|
||||
|
||||
## Откат
|
||||
|
||||
- **Коммит был неверным** → откройте коммит, нажмите **Revert**. Создастся новый коммит, отменяющий его; ничего не стирается.
|
||||
- **Файл был неверным** → откройте его историю, посмотрите правильную версию, скопируйте содержимое обратно и закоммитьте.
|
||||
- **Коммит ещё не отправлен** (работа со своего компьютера) → `git commit --amend`, чтобы поправить последний до публикации.
|
||||
|
||||
## Сравнение
|
||||
|
||||
Добавьте `/compare/main...moya-vetka` к адресу репозитория или воспользуйтесь кнопкой **Сравнить**, чтобы увидеть все различия между двумя ветками или тегами.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Назад: 07 — Изображения и вложения](../07-images-and-media/readme.md) · 📚 [Содержание](../README.md) · [Далее: 09 — Ветки и пул-реквесты](../09-branches-and-pull-requests/readme.md) ➡
|
||||
@@ -0,0 +1,58 @@
|
||||
# 09 — Ветки и пул-реквесты
|
||||
|
||||
🌍 [English](../../en/09-branches-and-pull-requests/readme.md) · [Türkçe](../../tr/09-branches-and-pull-requests/readme.md) · [Deutsch](../../de/09-branches-and-pull-requests/readme.md) · [Français](../../fr/09-branches-and-pull-requests/readme.md) · **Русский**
|
||||
|
||||
Ветка — это безопасная копия проекта, где можно работать, не трогая `main`. Пул-реквест — это просьба вернуть проделанную работу обратно.
|
||||
|
||||
## Когда нужна ветка
|
||||
|
||||
- Изменение достаточно большое, чтобы недоделанная работа что-то сломала.
|
||||
- Кто-то должен посмотреть на него до выхода «в прод».
|
||||
- Вы хотите попробовать идею и иметь возможность её выбросить.
|
||||
|
||||
Ради опечатки в документе можно спокойно коммитить прямо в `main`.
|
||||
|
||||
## Создание ветки в браузере
|
||||
|
||||
При коммите (глава 03) выберите **Создать новую ветку для этого коммита и открыть пул-реквест**, задайте имя ветки и закоммитьте. Хорошие имена описывают работу:
|
||||
|
||||
```
|
||||
docs/vlan-notes
|
||||
fix/wrong-gateway
|
||||
feature/report-export
|
||||
```
|
||||
|
||||
## Открытие пул-реквеста
|
||||
|
||||
1. Перейдите в **Пул-реквесты → Новый пул-реквест**.
|
||||
2. Выберите исходную ветку (вашу) и целевую (`main`).
|
||||
3. Заголовок = что делает изменение. Описание = зачем, плюс всё, что стоит проверить рецензентам.
|
||||
4. Нажмите **Создать пул-реквест**.
|
||||
|
||||
## Ревью
|
||||
|
||||
- Рецензенты комментируют отдельные строки на вкладке **Изменённые файлы**.
|
||||
- Отправляйте новые коммиты в ту же ветку — пул-реквест обновится сам.
|
||||
- После одобрения нажмите **Слить пул-реквест**, затем удалите ветку.
|
||||
|
||||
## Конфликты слияния
|
||||
|
||||
Если в `main` изменили те же строки, что и вы, KabaForge попросит разрешить конфликт. Со своего компьютера:
|
||||
|
||||
```bash
|
||||
git switch my-branch
|
||||
git fetch origin
|
||||
git merge origin/main
|
||||
# откройте помеченные файлы, оставьте правильные строки
|
||||
git add .
|
||||
git commit
|
||||
git push
|
||||
```
|
||||
|
||||
## Защита `main`
|
||||
|
||||
**Настройки → Ветки → Добавить правило**: требовать пул-реквест и одобрения до того, как что-либо попадёт в `main`. Рекомендуется, как только в репозитории работает больше одного человека.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Назад: 08 — Коммиты и история](../08-commits-and-history/readme.md) · 📚 [Содержание](../README.md) · [Далее: 10 — Работа со своего компьютера](../10-clone-and-tokens/readme.md) ➡
|
||||
@@ -0,0 +1,75 @@
|
||||
# 10 — Работа со своего компьютера
|
||||
|
||||
🌍 [English](../../en/10-clone-and-tokens/readme.md) · [Türkçe](../../tr/10-clone-and-tokens/readme.md) · [Deutsch](../../de/10-clone-and-tokens/readme.md) · [Français](../../fr/10-clone-and-tokens/readme.md) · **Русский**
|
||||
|
||||
Для документов хватает браузера. Для настоящей работы — много файлов сразу или запуск кода — скопируйте репозиторий на свою машину.
|
||||
|
||||
## Получить копию
|
||||
|
||||
Нажмите кнопку **Клонировать** на странице репозитория и скопируйте адрес.
|
||||
|
||||
```bash
|
||||
git clone https://forge.kabaforce.com/owner/project.git
|
||||
cd project
|
||||
```
|
||||
|
||||
## Ежедневный цикл
|
||||
|
||||
```bash
|
||||
git pull # забрать то, что изменили другие
|
||||
# ... редактируем файлы ...
|
||||
git status # что я изменил?
|
||||
git add . # подготовить изменения
|
||||
git commit -m "добавить заметки по установке"
|
||||
git push # отправить их в KabaForge
|
||||
```
|
||||
|
||||
Если `git push` отклонён, значит кто-то отправил свои изменения раньше: выполните `git pull`, разрешите то, о чём он сообщит, и отправьте снова.
|
||||
|
||||
## Аутентификация из командной строки
|
||||
|
||||
Пароль от KabaForce ID не работает по HTTPS. Вместо него создайте токен:
|
||||
|
||||
1. **Аватар → Настройки → Приложения → Создать новый токен**.
|
||||
2. Дайте ему имя и только нужные права (обычно достаточно `repo`).
|
||||
3. Скопируйте его один раз — больше он не показывается.
|
||||
4. Когда git спросит пароль, вставьте токен.
|
||||
|
||||
Чтобы вводить его лишь однажды:
|
||||
|
||||
```bash
|
||||
git config --global credential.helper store
|
||||
```
|
||||
|
||||
## SSH вместо токенов
|
||||
|
||||
1. Создайте ключ, если его нет: `ssh-keygen -t ed25519`
|
||||
2. Скопируйте `~/.ssh/id_ed25519.pub`.
|
||||
3. **Аватар → Настройки → SSH-ключи → Добавить ключ**, вставьте.
|
||||
4. Клонируйте по SSH-адресу, который показан в **Клонировать**.
|
||||
|
||||
После этого пароль спрашивать не будут.
|
||||
|
||||
## Полезные мелочи
|
||||
|
||||
| Нужно | Команда |
|
||||
|-------|---------|
|
||||
| Посмотреть историю | `git log --oneline --graph` |
|
||||
| Отменить локальные правки файла | `git restore file.md` |
|
||||
| Переключить ветку | `git switch branch-name` |
|
||||
| Создать ветку | `git switch -c new-branch` |
|
||||
|
||||
## Автоматизация
|
||||
|
||||
Репозитории можно читать и изменять через API KabaForge с тем же токеном:
|
||||
|
||||
```bash
|
||||
curl -H "Authorization: token ВАШ_ТОКЕН" \
|
||||
https://forge.kabaforce.com/api/v1/repos/owner/project/contents
|
||||
```
|
||||
|
||||
Относитесь к токенам как к паролям: никогда не кладите их в файл, который коммитите.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Назад: 09 — Ветки и пул-реквесты](../09-branches-and-pull-requests/readme.md) · 📚 [Содержание](../README.md)
|
||||
@@ -0,0 +1,38 @@
|
||||
# 📘 Руководство KabaForge — Русский
|
||||
|
||||
Короткие практические рецепты по работе с KabaForge — предварительный опыт не нужен.
|
||||
|
||||
🌍 [English](../en/README.md) · [Türkçe](../tr/README.md) · [Deutsch](../de/README.md) · [Français](../fr/README.md) · **Русский**
|
||||
|
||||
---
|
||||
|
||||
## 📚 Главы
|
||||
|
||||
| # | Глава |
|
||||
|---|-------|
|
||||
| 01 | [Начало работы](01-getting-started/readme.md) |
|
||||
| 02 | [Создание репозитория](02-create-repository/readme.md) |
|
||||
| 03 | [Добавление и редактирование файлов](03-add-and-edit-files/readme.md) |
|
||||
| 04 | [Создание каталогов](04-create-directory/readme.md) |
|
||||
| 05 | [Удаление файлов и каталогов](05-delete-files/readme.md) |
|
||||
| 06 | [Основы Markdown](06-markdown-basics/readme.md) |
|
||||
| 07 | [Изображения и вложения](07-images-and-media/readme.md) |
|
||||
| 08 | [Коммиты и история](08-commits-and-history/readme.md) |
|
||||
| 09 | [Ветки и пул-реквесты](09-branches-and-pull-requests/readme.md) |
|
||||
| 10 | [Работа со своего компьютера](10-clone-and-tokens/readme.md) |
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Версия на 60 секунд
|
||||
|
||||
1. Войдите на [forge.kabaforce.com](https://forge.kabaforce.com) с помощью KabaForce ID.
|
||||
2. Нажмите **+ → Новый репозиторий**, дайте ему имя, отметьте *Инициализировать репозиторий*.
|
||||
3. Откройте репозиторий, нажмите **Добавить файл → Новый файл**, напишите что-нибудь, нажмите **Применить изменения**.
|
||||
4. Назовите файл `readme.md` — он автоматически показывается на странице каталога.
|
||||
|
||||
---
|
||||
|
||||
## 💡 Как читать это руководство
|
||||
|
||||
Главы независимы друг от друга. Переходите сразу к нужной; каждая — одна
|
||||
страница, которую можно прочитать за несколько минут.
|
||||
Reference in New Issue
Block a user