Начало работы с Git для разработки

В этом и следующем разделах подробно описывается, как настроить git для работы с исходным кодом NumPy. Если у вас уже настроена система git, перейдите к Процессу разработки.

Настройка Git

• Установить git.

• Знакомство с Git:

  git config --global user.email you@yourdomain.example.com
  git config --global user.name "Your Name Comes Here"
  

Создание собственной копии (форка) NumPy

Это необходимо сделать только один раз. Инструкции здесь очень похожи на инструкции на странице http://help.github.com/forking/ — для получения более подробной информации, пожалуйста, обратитесь к этой странице. Мы повторяем часть из неё, чтобы указать особенности для проекта NumPy, и предложить некоторые стандартные имена.

Настройка и конфигурация учетной записи github

Если у вас нет учетной записи github, перейдите на страницу github и создайте её.

Затем вам нужно настроить свою учетную запись, чтобы разрешить доступ для записи — см. Generating SSH keys помощь на странице github help.

Создание собственной копии форка NumPy

1. Войдите в свою учетную запись github.
2. Перейдите на главную страницу NumPy на github по адресу NumPy github.

3. Нажмите кнопку fork:

   

   После небольшой задержки вы окажетесь на главной странице своей собственной копии форка NumPy.

Настройка форка

Сначала выполните инструкции для Создание собственной копии (форка) NumPy.

Обзор

git clone https://github.com/your-user-name/numpy.git
cd numpy
git remote add upstream https://github.com/numpy/numpy.git

Подробности

Клонирование форка

1. Клонируйте свой форк на локальный компьютер с помощью git clone https://github.com/your-user-name/numpy.git

2. Исследование. Перейдите в каталог своего нового репозитория: cd numpy. Затем git branch -a чтобы увидеть все ветви. Вы получите что-то вроде:

   * master
   remotes/origin/master
   

   Это означает, что вы сейчас находитесь на master ветви, и у вас также есть remote подключение к origin/master. Какой репозиторий является remote/origin? Попробуйте git remote -v чтобы увидеть URL для удаленных репозиториев. Они будут указывать на ваш форк github.

   Теперь вы хотите подключиться к исходному репозиторию NumPy github, чтобы вы могли слить изменения из основного ствола.

Связывание репозитория с исходным репозиторием

cd numpy
git remote add upstream https://github.com/numpy/numpy.git

upstream здесь просто условное имя, которое мы используем для обозначения основного репозитория NumPy по адресу NumPy github.

Просто для вашего удобства, покажите себя, что у вас теперь есть новый «удаленный» репозиторий, с git remote -v show, что даст вам что-то вроде:

upstream     https://github.com/numpy/numpy.git (fetch)
upstream     https://github.com/numpy/numpy.git (push)
origin       https://github.com/your-user-name/numpy.git (fetch)
origin       https://github.com/your-user-name/numpy.git (push)

Для синхронизации с изменениями в NumPy, вы хотите настроить свой репозиторий так, чтобы он по умолчанию подтягивал данные из upstream. Это можно сделать с помощью:

git config branch.master.remote upstream
git config branch.master.merge refs/heads/master

Вам также может потребоваться лёгкий доступ ко всем запросам на вытягивание, отправленным в репозиторий NumPy:

git config --add remote.upstream.fetch '+refs/pull/*/head:refs/remotes/upstream/pr/*'

Ваш файл конфигурации должен теперь выглядеть примерно так (из $ cat .git/config):

[core]
        repositoryformatversion = 0
        filemode = true
        bare = false
        logallrefupdates = true
        ignorecase = true
        precomposeunicode = false
[remote "origin"]
        url = https://github.com/your-user-name/numpy.git
        fetch = +refs/heads/*:refs/remotes/origin/*
[remote "upstream"]
        url = https://github.com/numpy/numpy.git
        fetch = +refs/heads/*:refs/remotes/upstream/*
        fetch = +refs/pull/*/head:refs/remotes/upstream/pr/*
[branch "master"]
        remote = upstream
        merge = refs/heads/master