Фиксация изменений и отправка в удаленный репозиторий GitLab: различия между версиями

Текущая версия от 08:01, 13 мая 2026

Для контроля вносимых в документацию изменений и их публикации на GitLab используется система контроля версий GIT.

Перед началом работы с GIT необходимо его установить на компьютер и склонировать репозиторий.

Алгоритм работы с GIT

Создаётся отдельная ветка, в которой будет работать только один разработчик документации.
Если работа производится в уже существующей ветке, то подгружается актуальная документация из удалённого репозитория в ветку main из которой добавляются изменения, внесённые другими пользователями, в текущую рабочую ветку.
Изменения в документации подготавливаются к фиксации - все, либо выборочно (добавляются в индекс).
Изменения фиксируются (делается коммит) с кратким описанием.
Зафиксированные изменения публикуются на GitLab.

Создание отдельной ветки

В GIT новую ветку можно создать из любой другой, но в данной инструкции рассмотрен случай, когда все ветки создаются из одной главной - main.

В нижнем левом углу выберите ветку (по умолчанию это обычно main или master).

Нажмите на название ветки и выберите Создать новую ветвь.

Введите название новой ветки и подтвердите создание, нажав Enter.

После подтверждения создания ветки произойдёт автоматическое переключение на неё.

В новой ветке будут все изменения (коммиты) ветки, из которой она создавалась

Работа с существующей веткой

Если необходимо внести изменения в уже существующую ветку, созданную из главной (main):

сначала подгружаются все актуальные изменения из main;
текущая ветка сливается с main;
решаются конфликты (если возникают);
только после этого вносятся изменения в текущую рабочую ветвь.

Такой алгоритм позволяет уменьшить количество конфликтов и работать с актуальной версией документации в своей ветке.

Подгрузка актуальных изменений

Необходимо переключиться на ветку main (предварительно зафиксировав внесённые в свою ветку изменения):

нажать на название текущей ветки в левом нижнем углу экрана ;
нажать на название ветки и выбрать main из списка вверху посередине экрана;

нажать на Git Graph и Fetch From Remote как показано на рисунке ниже.

Слияние текущей рабочей ветки с main

Переключиться на рабочую ветку.
В разделе Git Graph найти последний коммит ветки main вверху появившегося списка коммитов;
Через контекстное меню, вызванное правой кнопкой мыши, произвести слияние с веткой main.

Разрешение конфликтов при слиянии

В процессе слияния рабочей ветки с main могут возникнуть конфликты, в случае если в двух разных ветвях (например main и readme-develop) были зафиксированы изменения в одном и том же файле.

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

Файлы, в которых возник конфликт подсвечиваются красным цветом в проводнике.

Далее разрешаются конфликты для каждого файла после нажатия на кнопку Разрешить в редакторе слияния.

GIT предложит принять изменения либо из рабочей ветки, либо из той, которая сливается с рабочей, либо принять изменения из обоих веток.

После разрешения всех конфликтов производится фиксация изменений (коммит).

Подготовка изменений к фиксации

После внесения изменений в документы, откройте вкладку Система управления версиями (значок с тремя точками и линиями).

Здесь располагается список изменённых файлов.

Чтобы добавить изменения в индекс, нужно нажать знак + рядом с каждым файлом (или напротив Изменения, чтобы добавить все файлы сразу).

Создание коммита

После добавления изменений в индекс в поле ввода Сообщение вверху вкладки Система управления версиями пишется краткое описание изменений (например, Добавлена глава...).

Нажмите на синюю кнопку Фиксация для фиксации изменений (коммит).

Публикация изменений на GitLab

После создания коммита нажмите на кнопку Опубликовать ветку если рабочая ветка ранее не публиковалась на GitLab или Синхронизировать изменения, чтобы загрузить изменения в существующую ветку.

Эта кнопка отправит изменения на удалённый репозиторий GitLab.

@@ Строка 12: / Строка 12: @@
 ==Создание отдельной ветки==
-В GIT новую ветку можно создать из любой другой, но в данной инструкции рассмотрен случай, когда все ветки создаются из одной главной - main.
-В нижнем левом углу выберите ветку (по умолчанию это обычно main или master).
+В <code>GIT</code> новую ветку можно создать из любой другой, но в данной инструкции рассмотрен случай, когда все ветки создаются из одной главной - <code>main</code>.
-Нажмите на название ветки и выберите Создать новую ветвь.
+В нижнем левом углу выберите ветку (по умолчанию это обычно <code>main</code> или <code>master</code>).
+Нажмите на название ветки и выберите <code>Создать новую ветвь</code>.
 [[Файл:Help_20.png|center]]
-Введите название новой ветки и подтвердите создание, нажав Enter.
+Введите название новой ветки и подтвердите создание, нажав <code>Enter</code>.
-После подтверждения создания ветки произойдёт автоматическое переключение на неё. В новой ветке будут все изменения (коммиты) ветки, из которой она создавалась
+После подтверждения создания ветки произойдёт автоматическое переключение на неё.
+В новой ветке будут все изменения (коммиты) ветки, из которой она создавалась
 [[Файл:Help_21.png|center]]
 ==Работа с существующей веткой==
-Если необходимо внести изменения в уже существующую ветку, созданную из главной - main, сначала подгружаются все актуальные изменения из main, текущая ветка сливается с main решаются конфликты (если возникают), и только после этого вносятся изменения в текущую рабочую ветвь. Такой алгоритм позволяет уменьшить количество конфликтов и работать с актуальной версией документации в своей ветке.
+Если необходимо внести изменения в уже существующую ветку, созданную из главной (<code>main</code>):
+*сначала подгружаются все актуальные изменения из <code>main</code>;
+*текущая ветка сливается с <code>main</code>;
+*решаются конфликты (если возникают);
+*только после этого вносятся изменения в текущую рабочую ветвь.
+Такой алгоритм позволяет уменьшить количество конфликтов и работать с актуальной версией документации в своей ветке.
 ===Подгрузка актуальных изменений===
-Первым делом необходимо переключиться на ветку main (предварительно зафиксировав внесённые в свою ветку изменения - см п.3.2, 3.3): В левом нижнем углу экрана нажимаем на название текущей ветки
-Нажмите на название ветки и выберите main из списка вверху посередине экрана.
+Необходимо переключиться на ветку <code>main</code> (предварительно зафиксировав внесённые в свою ветку изменения):
+*нажать на название текущей ветки в левом нижнем углу экрана ;
+*нажать на название ветки и выбрать <code>main</code> из списка вверху посередине экрана;
 [[Файл:Help_22.png|center]]
-Затем нажимаем на Git Graph и Fetch From Remote как показано на рисунке ниже.
+*нажать на <code>Git Graph</code> и <code>Fetch From Remote</code> как показано на рисунке ниже.
 [[Файл:Help_23.png|center]]
 ===Слияние текущей рабочей ветки с main===
-Переключитесь на рабочую ветку аналогично п.3.1.1.1.
+*Переключиться на рабочую ветку.
-Затем в разделе Git Graph найдите последний коммит ветки main вверху появившегося списка коммитов и через контекстное меню, вызванное ПКМ произведите слияние с веткой main:
+*В разделе <code>Git Graph</code> найти последний коммит ветки <code>main</code> вверху появившегося списка коммитов;
+*Через контекстное меню, вызванное правой кнопкой мыши, произвести слияние с веткой <code>main</code>.
 [[Файл:Help_24.png|center]]
@@ Строка 46: / Строка 60: @@
 ===Разрешение конфликтов при слиянии===
-В процессе слияния рабочей ветки с main могут возникнуть конфликты, в случае если в двух разных ветвях (например main и readme-develop) были зафиксированы изменения в одном и том же файле.
+В процессе слияния рабочей ветки с <code>main</code> могут возникнуть конфликты, в случае если в двух разных ветвях (например <code>main</code> и <code>readme-develop</code>) были зафиксированы изменения в одном и том же файле.
 При этом появится сообщение, в котором указаны файлы с конфликтующими изменениями:
@@ Строка 53: / Строка 67: @@
 Файлы, в которых возник конфликт подсвечиваются красным цветом в проводнике.
-Далее разрешаются конфликты для каждого файла после нажатия на кнопку Разрешить в редакторе слияния. GIT предложит принять изменения либо из рабочей ветки, либо из той, которая сливается с рабочей, либо принять изменения из обоих веток.
+Далее разрешаются конфликты для каждого файла после нажатия на кнопку <code>Разрешить</code> в редакторе слияния.
+<code>GIT</code> предложит принять изменения либо из рабочей ветки, либо из той, которая сливается с рабочей, либо принять изменения из обоих веток.
 [[Файл:Help_27.png|center]]
-После разрешения всех конфликтов производится фиксация изменений (коммит), см. п.3.2, 3.3
+После разрешения всех конфликтов производится фиксация изменений (коммит).
 ==Подготовка изменений к фиксации==
-После внесения изменений в документы, откройте вкладку "Система управления версиями" (значок с тремя точками и линиями). Здесь располагается список изменённых файлов. Чтобы добавить изменения в индекс, нужно нажать знак «+» рядом с каждым файлом (или напротив "Изменения", чтобы добавить все файлы сразу).
+После внесения изменений в документы, откройте вкладку <code>Система управления версиями</code> (значок с тремя точками и линиями).
+Здесь располагается список изменённых файлов.
+Чтобы добавить изменения в индекс, нужно нажать знак <code>+</code> рядом с каждым файлом (или напротив <code>Изменения</code>, чтобы добавить все файлы сразу).
 [[Файл:Help_28.png|center]]
 ==Создание коммита==
-После добавления изменений в индекс в поле ввода "Сообщение" вверху вкладки "Система управления версиями" пишется краткое описание изменений (например, "Добавлена глава..."). Нажмите на синюю кнопку "Фиксация" для фиксации изменений (коммит).
+После добавления изменений в индекс в поле ввода <code>Сообщение</code> вверху вкладки <code>Система управления версиями</code> пишется краткое описание изменений (например, <code>Добавлена глава...</code>).
+Нажмите на синюю кнопку <code>Фиксация</code> для фиксации изменений (коммит).
 [[Файл:Help_29.png|center]]
 ==Публикация изменений на GitLab==
-После создания коммита нажмите на кнопку "Опубликовать ветку" если рабочая ветка ранее не публиковалась на gitlab или "Синхронизировать изменения", чтобы загрузить изменения в существующую ветку
-Эта кнопка отправит изменения на удалённый репозиторий GitLab.
+После создания коммита нажмите на кнопку <code>Опубликовать ветку</code> если рабочая ветка ранее не публиковалась на <code>GitLab</code> или <code>Синхронизировать изменения</code>, чтобы загрузить изменения в существующую ветку.
+Эта кнопка отправит изменения на удалённый репозиторий <code>GitLab</code>.
 [[Файл:Help_30.png|center]]
 <br>
 [[Файл:Help_31.png|center]]