صفحهٔ اصلی گشت‌و‌گذار راهنما
ثبت نام ورود
tkachenko
/
Building
0
0
انشعاب 0
پرونده‌ها مشکلات 0 درخواست واکشی 0 ویکی
درخت: be9b8e2eb9
شاخه‌ها تگ‌ها
Building
/
docs
/
git.md

git.md 4.8 KB
تاريخچه خام

Git для авторов документов

Зачем он нужен

Git хранит последовательность контрольных точек проекта. Он помогает:

  • увидеть, кто и зачем изменил текст;
  • вернуться к предыдущей версии;
  • работать над разделами параллельно;
  • объединять согласованные изменения;
  • не пересылать папки Финал, Финал 2, Финал точно.

Коммит

Коммит похож на сохранённую контрольную точку с подписью. В него входят выбранные изменения и короткое объяснение.

Хорошие сообщения:

  • Добавлена глава о геологическом строении;
  • Уточнены выводы по замечаниям заказчика;
  • Обновлены рисунки раздела 3.

Один коммит должен описывать одну законченную мысль. Перед коммитом желательно собрать PDF.

Ветка

Ветка — параллельная версия проекта. Основной документ остаётся стабильным, пока вы работаете над отдельной главой.

Подходящие имена:

  • chapter-geology;
  • review-comments;
  • update-figures.

Создание в VS Code: нажмите имя текущей ветки в строке состояния и выберите Create new branch.

Push и Pull

  • Push отправляет ваши коммиты на сервер.
  • Pull получает коммиты коллег.
  • Sync Changes обычно выполняет получение и отправку последовательно.

Всегда выполняйте Pull перед началом работы и перед merge. Push нужен не только в конце дня: серверная копия защищает работу при поломке компьютера.

Merge

Merge переносит результат одной ветки в другую.

  1. Завершите работу в своей ветке: проверка → commit → push.
  2. Переключитесь на целевую ветку, обычно main.
  3. Выполните Pull.
  4. Запустите Git: Merge Branch через Ctrl+Shift+P.
  5. Выберите рабочую ветку.
  6. Проверьте PDF, затем Push.

Конфликт

Конфликт означает, что две ветки изменили одно и то же место по-разному. Это не поломка и не потеря данных.

VS Code предлагает трёхсторонний редактор:

  • Current — текст целевой ветки;
  • Incoming — текст присоединяемой ветки;
  • Result — итог, который попадёт в документ.

Выберите подходящие части или вручную составьте правильный итог. Удалите служебные маркеры конфликта, сохраните файл, соберите PDF, добавьте исправленный файл в staged changes и завершите merge коммитом.

Если не уверены в результате, не нажимайте случайные варианты и не удаляйте .git/. Обратитесь к коллеге, который сможет увидеть обе исходные версии.

Git Graph

Выполните Git Graph: View Git Graph. Кружки показывают коммиты, линии — ветки, соединения — merge. Щёлкните коммит, чтобы посмотреть список и содержание изменений.

Что нельзя добавлять в Git

  • .private/;
  • реальные подписи и печати;
  • сгенерированные document.pdf и example.pdf;
  • временные файлы редакторов.

Официальные инструкции