Загрузка проекта на GitHub

Введение

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

Отправка файлов в репозиторий GitHub позволяет:

Примените управление версиями при внесении изменений в файлы, поэтому журнал проекта защищен и управляется им.

          ** Создайте резервную копию вашей работы, так как файлы теперь хранятся в облаке.

Закрепите репозиторий в личном профиле, чтобы другие могли видеть вашу работу.
Поделитесь и обсудите свою работу с другими пользователями либо публично, либо в частном порядке.

Если вы уже знакомы с Git, и вы ищете информацию о том, как отправить локальный репозиторий Git в GitHub, см . раздел AUTOTITLE.

Необходимые компоненты

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

Шаг 1. Создание нового репозитория для проекта

Рекомендуется создать новый репозиторий для каждого отдельного проекта, над которым вы работаете. Если вы пишете проект программного обеспечения, группирование всех связанных файлов в новом репозитории упрощает обслуживание и управление базой кода с течением времени.

В правом верхнем углу любой страницы выберите , а затем нажмите кнопку "Создать репозиторий".
В поле "Имя репозитория" введите имя проекта. Например, введите "my-first-project".
В поле "Описание" введите короткое описание. Например, введите «Это мой первый проект на GitHub.»
Выберите, будет ли репозиторий общедоступным или частным. Выберите "Public", если вы хотите, чтобы другие пользователи могли видеть свой проект.
Выберите параметр Добавить файл сведений. Этот файл изменится на следующем шаге.
Щелкните Создать репозиторий.

Шаг 2. Отправка файлов в репозиторий проекта

До сих пор в репозитории должен отображаться только один файл, README.md созданный при инициализации репозитория. Теперь мы отправим некоторые из собственных файлов.

Справа от страницы выберите раскрывающееся меню "Добавить файл ".
В раскрывающемся меню нажмите кнопку "Отправить файлы".
На компьютере откройте папку, содержащую рабочую работу, а затем перетащите все файлы и папки в браузер.
В нижней части страницы в разделе "Фиксация изменений" выберите "Зафиксировать непосредственно в main ветвь", а затем нажмите кнопку "Зафиксировать изменения".

Шаг 3. Изменение ФАЙЛА README для репозитория проекта

Файл README репозитория обычно является первым элементом, который будет видеть при посещении репозитория. Обычно он содержит сведения о том, о чем работает ваш проект, и почему ваш проект полезен.

Как мы узнали в руководстве ПО AUTOTITLE , файл README (README.md) написан в синтаксисе Markdown. Markdown — это простой и удобный для чтения язык для форматирования обычного текста.

На этом шаге мы изменим проект README.md с помощью Markdown, чтобы он содержит некоторые основные сведения о проекте.

В списке файлов щелкните README.md , чтобы просмотреть файл.
В правом верхнем углу представления файла щелкните (Изменить файл), чтобы открыть редактор файлов.
- Вы увидите, что некоторые сведения о проекте предварительно заполнены. Например, вы увидите имя репозитория и описание репозитория, которое вы выполнили на шаге 1, отображаемом в строке 1 и строке 2.
Удалите существующий текст, а #затем введите правильный заголовок проекта.
- Пример: # About my first project on GitHub.
Затем добавьте некоторые сведения о проекте, например описание назначения проекта или его основных функций.

Примечание.

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

Чтобы применить более сложное форматирование, например добавление изображений, ссылок и сносок, см. раздел Базовый синтаксис написания и форматирования.
Над новым содержимым нажмите кнопку "Предварительный просмотр".
Посмотрите, как файл будет отображаться после сохранения изменений, а затем снова переключитесь на "Изменить".
Продолжайте редактировать и просматривать текст, пока не будете довольны содержимым README.
В правом верхнем углу нажмите кнопку "Зафиксировать изменения".
В открывшемся диалоговом окне предварительно заполнено сообщение фиксации ("Обновить README.md") и по умолчанию выбран параметр "Фиксация непосредственно в main ветви". Оставьте эти параметры так, как они есть, и нажмите кнопку "Зафиксировать изменения".

Заключение

Теперь вы создали новый репозиторий, отправили в него некоторые файлы и добавили проект README.

Если вы установите для репозитория видимость "Общедоступный", репозиторий будет отображаться в личном профиле, и вы можете поделиться URL-адресом репозитория с другими пользователями.

При добавлении, редактирование или удаление файлов непосредственно в браузере на GitHub, GitHub будет отслеживать эти изменения ("фиксации"), чтобы начать управлять историей и эволюцией проекта.

При внесении изменений помните, что вы можете создать новую ветвь из main ветви репозитория, чтобы можно было экспериментировать, не влияя на основную копию файлов. Затем, когда вы удовлетворены набором изменений, откройте запрос на вытягивание, чтобы объединить изменения в ветвь main . Напоминание о том, как это сделать, см. в разделе Hello World.

Следующие шаги

Большинство людей хотят локально работать над своими файлами (т. е. на собственном компьютере), а затем постоянно синхронизировать эти локальные изменения с этим "удаленным" (в облаке) репозитория на GitHub. Существует множество инструментов, которые позволяют это сделать, например, GitHub Desktop. Чтобы приступить к работе, вам потребуется:
- Установка GitHub Рабочий стол. Дополнительные сведения см. в разделе Начало работы с GitHub Desktop.
- Клонируйте удаленный репозиторий, поэтому у вас есть копия на своем компьютере. Дополнительные сведения см. в разделе Клонирование и создание ветки для репозиториев из GitHub Desktop.
- Непрерывно синхронизируйте **** локальные изменения с этим удаленный репозиторий. Дополнительные сведения см. в разделе Синхронизация ветви в GitHub Desktop.
Дополнительные сведения о других средствах, доступных для работы с репозиториями, размещенными на GitHub, см. в разделе Подключение к GitHub.