Создание первого репозитория с помощью GitHub Desktop

Введение

GitHub Desktop — это бесплатное приложение открытый код, которое помогает работать с кодом, размещенным в GitHub или других службах размещения Git. С помощью GitHub Desktopможно выполнять команды Git, такие как фиксация и отправка изменений, в графическом пользовательском интерфейсе, а не с помощью командной строки. Дополнительные сведения см. в разделе Сведения о GitHub Desktop.

После изучения этого руководства вы научитесь использовать GitHub Desktop для создания репозитория, внесения изменений в репозиторий и публикации изменений в GitHub Enterprise Server.

После установки GitHub Desktop и входа в GitHub или GitHub Enterprise можно создать и клонировать репозитории из руководства. В этом руководстве описаны основы работы с Git и GitHub, включая установку текстового редактора, создание ветви, фиксацию, отправку на GitHubи открытие запроса на вытягивание. Если у вас еще нет репозиториев в GitHub Desktop, можете воспользоваться репозиториями из этого руководства.

Мы рекомендуем выполнить руководство, но если вы хотите изучить возможности GitHub Desktop, создав собственный репозиторий, в этом руководстве описано использование GitHub Desktop для работы с репозиторием Git.

Часть 1. Установка GitHub Desktop и проверка подлинности учетной записи

Установить GitHub Desktop можно в любой поддерживаемой операционной системе. После установки приложения необходимо выполнить вход и проверку подлинности учетной записи в GitHub или GitHub Enterprise, прежде чем создать и клонировать репозитории из руководства.

Дополнительные сведения об установке и проверке подлинности см. в разделе "Настройка GitHub Desktop".

Часть 2. Создание нового репозитория

Если у вас нет репозиториев, связанных с GitHub Desktop, появится страница "Приступим!", где можно создать и клонировать репозиторий из руководства, клонировать существующий репозиторий из Интернета, создать новый репозиторий или добавить существующий репозиторий с жесткого диска.

Создание и клонирование репозитория из руководства

В качестве первого проекта для практического использования GitHub Desktop рекомендуется создать и клонировать репозиторий из руководства.

1. Нажмите кнопку "Создать репозиторий учебников...".
2. Следуйте инструкциям в руководстве по установке текстового редактора, созданию ветви, редактированию файла, фиксации, публикации в GitHub и открытию запроса на вытягивание.

Создание репозитория

Если вы не хотите создавать и клонировать репозиторий из руководства, можно создать новый репозиторий.

1. Нажмите кнопку "Создать репозиторий" на жестком диске....
2. В окне "Создать репозиторий" заполните поля и выберите предпочитаемые параметры.
   • "Имя" — укажите имя репозитория как локально, так и в GitHub Enterprise Server.
   • "Описание" — это необязательное поле, в котором можно указать дополнительные сведения о назначении репозитория.
   • "Локальный путь" — расположение репозитория на компьютере. По умолчанию GitHub Desktop создает папку GitHub в папке Документы, где будут храниться репозитории, однако вы можете выбрать любое расположение на компьютере. Новый репозиторий будет папкой в выбранном расположении. Например, если вы присвоили репозиторию имя Tutorial, в папке, выбранной для локального пути, будет создана папка Tutorial. GitHub Desktop запоминает выбранное расположение при следующем создании или клонировании нового репозитория.
   • При инициализации этого репозитория с помощью файла README создается начальная фиксация с помощью файла README.md. Файлы README помогают понять назначение проекта, поэтому мы рекомендуем выбрать этот вариант и указать в файле полезные сведения. Когда пользователь откроет репозиторий в GitHub Enterprise Server, первое, что он увидит, изучая проект, — это файл README. Дополнительные сведения см. в разделе О файлах README.
   • В раскрывающемся меню Пропустить Git можно добавить настраиваемый файл, чтобы пропустить определенные файлы в локальном репозитории, которые не должны храниться в системе управления версиями. Если вы будете использовать определенный язык или платформу, можно выбрать вариант из списка доступных. Если вы только начинаете работу, вы можете пропустить этот выбор. Дополнительные сведения см. в разделе Пропуск файлов.
   • Раскрывающееся меню "Лицензия" позволяет добавить лицензию с открытым исходным кодом в файл LICENSE в репозитории. Добавлять лицензию на этом этапе не обязательно. Дополнительные сведения о доступных лицензиях с открытым кодом и их добавлении в репозиторий см. в разделе "Лицензирование репозитория".
3. Щелкните Создать репозиторий.

Часть 3. Изучение возможностей GitHub Desktop

В меню "Файл" в верхней части экрана представлены настройки и действия, которые можно выполнить в GitHub Desktop. Для большинства действий также предусмотрены сочетания клавиш, которые помогут вам работать эффективнее. Полный список сочетаний клавиш см. в разделе "Сочетания клавиш GitHub Desktop".

Панель репозитория GitHub Desktop

В верхней части приложения GitHub Desktop находится панель со сведениями о текущем состоянии репозитория.

• В области Текущий репозиторий указано имя репозитория, с которым вы работаете. Можно щелкнуть Текущий репозиторий, чтобы переключиться на другой репозиторий в GitHub Desktop.
• В области Текущая ветвь указано имя ветви, с которой вы работаете. Можно щелкнуть Текущая ветвь, чтобы просмотреть все ветви в репозитории, переключиться на другую ветвь или создать новую ветвь. После создания запросов на вытягивание в репозитории вы также можете просмотреть их, щелкнув Текущая ветвь.
• Опубликовать репозиторий — отображается в случае, если вы еще не опубликовали репозиторий в GitHub Enterprise Server, что вы выполните далее на следующем шаге. Этот раздел панели изменяется в зависимости от состояния текущей ветви и репозитория. В зависимости от контекста будут доступны различные действия, позволяя вам обмениваться данными между локальными и удаленными репозиториями.

Изменения и журнал

На боковой панели слева находятся представления Изменения и Журнал.

• В представлении Изменения отображаются изменения, внесенные в файлы в текущей ветви, но не зафиксированные в локальном репозитории. Внизу есть область с текстовыми полями "Сводка" и "Описание" и кнопкой Зафиксировать в НАЗВАНИЕ_ВЕТВИ. Здесь фиксируются новые изменения. Кнопка Зафиксировать в НАЗВАНИЕ_ВЕТВИ является динамической, и на ней отображается ветвь, в которую вы фиксируете изменения.
• В представлении Журнала показаны предыдущие фиксации в текущей ветви репозитория. При создании репозитория должна появиться начальная фиксация, созданная GitHub Desktop. Справа от фиксации в зависимости от выбранных параметров при создании репозитория могут отображаться .gitattributes, gitignore _, _LICENSE или README-файлы. Вы можете щелкнуть каждый файл, чтобы ознакомиться с различиями для этого файла, которые являются изменениями, внесенными в файл в этой фиксации. Дифф отображает только части измененного файла, а не все содержимое файла.

Часть 4. Публикация репозитория в GitHub Enterprise Server

При создании нового репозитория он существует только на компьютере, и вы единственный, кто может получить доступ к нему. Вы можете опубликовать репозиторий в GitHub Enterprise Server, чтобы синхронизировать его на нескольких компьютерах и разрешить другим пользователям доступ к нему. Чтобы опубликовать репозиторий, отправьте локальные изменения в GitHub Enterprise Server.

1. На панели репозитория нажмите кнопку "Опубликовать репозиторий".
   
2. В окне "Опубликовать репозиторий" введите сведения о новом репозитории.
   • GitHub Desktop автоматически заполняет поля "Имя" и "Описание" сведениями, введенными при создании репозитория.
   • Установите флажок Сделать этот код частным, чтобы контролировать, кто может просматривать проект. Если этот флажок не установлен, другие пользователи GitHub Enterprise Server смогут просмотреть ваш код. Если этот флажок установлен, ваш код не будет общедоступным.
   • В раскрывающемся меню Организация (если имеется) можно опубликовать репозиторий в определенной организации, к которой вы принадлежите в GitHub Enterprise Server.
   1. Щелкните " Опубликовать репозиторий".
   2. Вы можете получить доступ к репозиторию на GitHub из GitHub Desktop. В меню "Файл" выберите Репозиторий, а затем нажмите Просмотреть в GitHub. Вы будете перенаправлены непосредственно в репозитории в браузере по умолчанию.

Часть 5. Внесение, фиксация и отправка изменений

Теперь, когда вы создали и опубликовали репозиторий, можно приступать к внесению изменений в проект и созданию первой фиксации в репозитории.

1. Чтобы запустить внешний редактор из GitHub Desktop, в строке меню "GitHub Desktop" выберите репозиторий, а затем нажмите кнопку "Открыть в редакторе". Дополнительные сведения см. в разделе Настройка редактора по умолчанию в GitHub Desktop.

   

2. Внесите изменения в созданный ранее файл README.md. Вы можете добавить сведения с описанием проекта, например, для чего он предназначен и чем полезен. После того как вы будете удовлетворены изменениями, сохраните их в текстовом редакторе.

3. В GitHub Desktop перейдите в представление Изменения. В списке файлов вы увидите README.md. Флажок слева от файла README.md указывает, что внесенные изменения в файл будут частью фиксации. В будущем вы, возможно, захотите внести изменения в несколько файлов, но зафиксировать потребуется только изменения, внесенные в некоторые из них. Если установить флажок рядом с файлом, этот файл не будет включен в фиксацию.

   

4. В нижней части списка Изменения введите сообщение о фиксации. Справа от изображения профиля введите краткое описание фиксации. Поскольку мы вносим изменения в файл README.md, можно ввести сообщение "Добавление сведения о назначении проекта". Под сводкой вы увидите текстовое поле "Описание", где можно ввести более подробное описание изменений в фиксации, что полезно при просмотре истории проекта и понимании причин внесения изменений. Поскольку вы выполняете базовое обновление файла README.md, описание можно пропустить.

   

5. Под сообщением фиксации нажмите кнопку "Зафиксировать в BRANCH NAME". На кнопке фиксации отображается текущую ветвь, чтобы вы могли зафиксировать в нужную ветвь.

6. Чтобы отправить изменения в удаленный репозиторий в GitHub Enterprise Server, нажмите кнопку Отправить в origin.

   
   • Кнопка Отправить в origin — это та же кнопка, которую вы нажали для публикации репозитория в GitHub Enterprise Server. Эта кнопка изменяется в контексте того, где вы находитесь в рабочем процессе Git. Теперь должно быть указано Push origin и 1, где "1" указывает на то, что существует одна фиксация, которая не была отправлена в GitHub Enterprise Server.
   • Источник в push-источнике означает, что вы отправляете изменения в удаленный вызов origin, который в данном случае является репозиторием проекта на GitHub. Пока вы не будете отправлять новые фиксации в GitHub Enterprise Server, будут различия между репозиторием проекта на компьютере и репозиторием проекта на GitHub. Это позволяет локально работать и отправлять изменения только в GitHub после готовности.

7. В окне справа от представления Изменения отображаются рекомендуемые действия, которые можно выполнить далее. Чтобы открыть репозиторий в GitHub Enterprise Server в браузере, нажмите Просмотреть в GitHub Enterprise Server.

   

8. В браузере нажмите кнопку 2 фиксации. Отобразится список фиксаций в этом репозитории в GitHub Enterprise Server. Первая фиксация должна быть фиксацией, которую вы только что выполнили в GitHub Desktop.

   

Заключение

Вы создали репозиторий, опубликовали его в GitHub Enterprise Server, сделали фиксацию и отправили изменения в GitHub Enterprise Server. Вы можете использовать этот же рабочий процесс при участии в других проектах, которые вы создаете или над которыми работаете совместно с другими.

Дополнительные материалы

• "Начало работы с Git"
• "Знакомство с GitHub"
• "Начало работы с документацией по GitHub"