Работа с ответвлениями (forks) в SourceCraft

Ответвления (forks) — это механизм, с помощью которого вы можете создавать собственную изолированную копию другого репозитория. Ответвление включает весь код, историю коммитов и основную ветку или все ветки и теги оригинального репозитория.

Основное предназначение ответвлений — упрощение процесса внесения изменений в чужие проекты, в том числе опенсорс. Вы можете свободно экспериментировать, добавлять новые функции или исправлять ошибки, а затем предлагать свои правки в основной проект с помощью предложений изменений.

Подробнее см. в подразделе Ответвления (forks) .

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

1. Откройте главную страницу SourceCraft.

2. На вкладке Исследовать перейдите в раздел Репозитории.

3. Выберите репозиторий, ответвление от которого вы хотите создать.

4. В правом верхнем углу нажмите Ответвить.

5. На открывшейся странице в блоке Детали вашего нового репозитория задайте параметры репозитория-ответвления:

   • В поле Владелец выберите организацию, в которой будет создан репозиторий.

   • В поле Название укажите название репозитория.

     Название должно быть уникальным в пределах организации и может содержать следующие ASCII-символы: строчные и заглавные буквы латинского алфавита, цифры, запятые, дефисы и подчеркивания.

     Под названием отображается адрес, по которому репозиторий будет доступен.

   • (опционально) В поле Описание укажите описание репозитория.

6. Выберите, переносить ли в ответвление только основную ветку оригинального репозитория или все ветки и теги.

7. Нажмите Создать ответвление.

Внести изменения в оригинальный репозиторий

1. Склонируйте репозиторий-ответвление:

   1. Установите Git.

   2. Откройте главную страницу SourceCraft.

   3. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории и выберите репозиторий.

   4. В правом верхнем углу нажмите кнопку Клонировать.

   5. В зависимости от способа подключения скопируйте ссылку для клонирования репозитория.

   6. В терминале выполните команду:

      git clone <ссылка_для_клонирования_репозитория>
      

   7. Перейдите в склонированный репозиторий:

      cd <имя_репозитория>
      

2. Создайте новую ветку для изменений и отправьте ее в удаленный репозиторий-ответвление:

   git checkout -b new-feature
   git push -u origin new-feature
   

3. Внесите изменения в файлы репозитория-ответвления, добавьте их в индекс git, сделайте коммит и отправьте изменения в удаленный репозиторий-ответвление:

   git add .
   git commit -m "added new feature"
   git push origin new-feature
   

4. Создайте предложение изменений из ветки репозитория-ответвления в ветку репозитория-оригинала:

   1. На странице репозитория-ответвления в разделе Код перейдите в секцию Предложения изменений.

   2. В правом верхнем углу нажмите Предложить изменения.

   3. В блоке источник в списке источник выберите ветку репозитория-ответвления, изменения из которой вы хотите добавить.

   4. В блоке цель:

      • В списке репозиторий выберите репозиторий-оригинал.
      • В списке цель выберите ветку, в которую вы хотите добавить изменения.

   5. Введите название предложения изменений.

   6. (опционально) Подробно опишите, какие правки вносятся в предложении изменений.

   7. (опционально) Посмотрите вносимые правки:

      • На вкладке Изменённые файлы отображается список измененных файлов, а также вносимые изменения в формате .diff.

        Чтобы посмотреть изменения в формате «было — стало», нажмите .

        Чтобы посмотреть все файлы в ветке, изменения из которой вы хотите добавить, нажмите Полное дерево.

      • На вкладке Изменения отображается история коммитов в ветке, изменения из которой вы хотите добавить.

   8. (опционально) В блоке Рецензенты выберите пользователей, которые будут проверять предложение изменений.

   9. Нажмите Опубликовать предложение изменений.

      Также вы можете не создавать предложение изменений, а сохранить его черновик, чтобы доработать позже. Для этого нажмите Сохранить как черновик.

Посмотреть ответвления репозитория

1. Откройте главную страницу SourceCraft.
2. На вкладке Исследовать перейдите в раздел Репозитории.
3. Выберите репозиторий, ответвление от которого вы хотите посмотреть.
4. В блоке под описанием репозитория будет отображаться строка с количеством ответвлений, например 3 ответвления. Чтобы перейти к списку ответвлений, нажмите на эту строку.

См. также

• Взаимосвязь ресурсов SourceCraft
• Создать репозиторий в SourceCraft
• Импортировать или зеркалировать репозиторий в SourceCraft
• Предложить изменения в репозитории SourceCraft