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

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

## Введение

GitHub Desktop— это бесплатное приложение открытый код, которое помогает работать с кодом, размещенным в GitHub или других службах размещения Git. С GitHub Desktopпомощью команд Git можно выполнять такие команды, как фиксация и отправка изменений, в графическом пользовательском интерфейсе, а не с помощью командной строки. Дополнительные сведения см. в разделе [Сведения о GitHub Desktop](/ru/desktop/overview/about-github-desktop).

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

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

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

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

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

Дополнительные сведения об установке и проверке подлинности см. в разделе [Настройка GitHub Desktop](/ru/desktop/installing-and-authenticating-to-github-desktop/setting-up-github-desktop).

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

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

![Снимок экрана: "Давайте начнем!" просмотр в GitHub Desktop.](/assets/images/help/desktop/lets-get-started.png)

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

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

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

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

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

1. Нажмите кнопку **"Создать репозиторий" на жестком диске...**.
2. В окне "Создать репозиторий" заполните поля и выберите предпочитаемые параметры.
   * Имя определяет имя репозитория как локально, так и локально GitHub.
   * "Описание" — это необязательное поле, в котором можно указать дополнительные сведения о назначении репозитория.
   * "Локальный путь" — расположение репозитория на компьютере. По умолчанию GitHub Desktop создается папка *GitHub* внутри папки *"Документы*" для хранения репозиториев, но вы можете выбрать любое расположение на компьютере. Новый репозиторий будет папкой в выбранном расположении. Например, если вы присвоили репозиторию имя `Tutorial`, в папке, выбранной для локального пути, будет создана папка *Tutorial*.
     GitHub Desktop запоминает выбранное расположение при следующем создании или клонировании нового репозитория.
   * **При инициализации этого репозитория с помощью файла README** создается начальная фиксация с помощью файла *README.md*. Файлы README помогают понять назначение проекта, поэтому мы рекомендуем выбрать этот вариант и указать в файле полезные сведения. Когда кто-то посещает репозиторий GitHub, README — это первое, что они увидят, как они знают о проекте. Дополнительные сведения см. в разделе [Сведения о файле README репозитория](/ru/enterprise-server@3.22/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-readmes).
   * В раскрывающемся меню **Пропустить Git** можно добавить настраиваемый файл, чтобы пропустить определенные файлы в локальном репозитории, которые не должны храниться в системе управления версиями. Если вы будете использовать определенный язык или платформу, можно выбрать вариант из списка доступных. Если вы только начинаете работу, вы можете пропустить этот выбор. Дополнительные сведения см. в разделе [Пропуск файлов](/ru/enterprise-server@3.22/get-started/git-basics/ignoring-files).
   * Раскрывающееся **меню "Лицензия"** позволяет добавить лицензию с открытым исходным кодом в файл LICENSE в репозитории. Добавлять лицензию на этом этапе не обязательно. Дополнительные сведения о доступных лицензиях с открытым кодом и их добавлении в репозиторий см. в разделе [Лицензирование репозитория](/ru/enterprise-server@3.22/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository).
3. Щелкните **Создать репозиторий**.

## Часть 3. Изучение GitHub Desktop

В меню файла в верхней части экрана можно получить доступ к параметрам и действиям, которые можно выполнить GitHub Desktop. Для большинства действий также предусмотрены сочетания клавиш, которые помогут вам работать эффективнее. Полный список сочетаний клавиш см. в разделе [Сочетания клавиш GitHub Desktop](/ru/desktop/overview/github-desktop-keyboard-shortcuts).

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

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

![Снимок экрана: классическое приложение GitHub. Панель с подробными сведениями о репозитории hello-world охватывает верхнюю часть окна и описывается оранжевым цветом.](/assets/images/help/desktop/explore-github-desktop.png)

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

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

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

![Снимок экрана: классическое приложение GitHub. Боковая панель слева с вкладками с метками "Изменения" и "Журнал" выделена оранжевым цветом.](/assets/images/help/desktop/changes-and-history.png)

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

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

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

1. На панели репозитория нажмите кнопку **"Опубликовать репозиторий**".

![Снимок экрана: панель репозитория. Кнопка с меткой "Опубликовать репозиторий" выделена оранжевым контуром.](/assets/images/help/desktop/publish-repository.png)

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

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

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

1. Чтобы запустить внешний редактор, GitHub Desktopв строке меню "GitHub Desktop" выберите **"Репозиторий**", а затем нажмите кнопку **"Открыть в редакторе**". Дополнительные сведения см. в разделе [Настройка редактора по умолчанию в GitHub Desktop](/ru/desktop/configuring-and-customizing-github-desktop/configuring-a-default-editor-in-github-desktop).

![Снимок экрана: строка меню на Компьютере Mac. В раскрывающемся меню "Репозиторий" курсор наведите указатель мыши на "Открыть в Visual Studio Code", выделенный синим цветом.](/assets/images/help/desktop/open-in-editor.png)

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

![Снимок экрана: вкладка "Изменения" на боковой панели. Слева от файла "README.md", выбранный флажок выделен оранжевым контуром.](/assets/images/help/desktop/viewing-changes.png)

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

![Снимок экрана: вкладка "Изменения" на боковой панели. Справа от рисунка профиля текстовое поле, содержащее сообщение фиксации, описывается оранжевым цветом.](/assets/images/help/desktop/commit-message.png)

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

![Снимок экрана: строка меню "Репозиторий". Кнопка, помеченная как "Источник push-уведомлений", выделена оранжевым контуром.](/assets/images/help/desktop/push-to-origin.png)

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

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

![Снимок экрана: экран "Нет локальных изменений". В списке предложений кнопка с надписью "Вид на GitHub" выделена оранжевым контуром.](/assets/images/help/desktop/available-actions.png)

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

![Снимок экрана: страница репозитория на сайте GitHub. Над списком файлов и рядом с значком часов ссылка, помеченная как "2 фиксации", описывается оранжевым цветом.](/assets/images/help/desktop/click-two-commits.png)

## Заключение

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

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

* [Базовые возможности Git](/ru/enterprise-server@3.22/get-started/git-basics)
* [Изучение GitHub](/ru/enterprise-server@3.22/get-started/learning-about-github)
* [Начните работу с документацией GitHub](/ru/enterprise-server@3.22/get-started)