Создание репозитория
В репозиториях GitHub можно хранить различные проекты, в том числе с открытым кодом. Проекты с открытым кодом позволяют предоставлять общий доступ к коду, чтобы создавать более качественное и надежное программное обеспечение. С помощью репозиториев можно вести совместную работу с другими пользователями и отслеживать ее. Дополнительные сведения см. в разделе Сведения о репозиториях. Дополнительные сведения о проектах с открытым кодом см. на сайте OpenSource.org.
Примечания.
- Для проекта с открытым кодом можно создать общедоступные репозитории. При создании общедоступного репозитория обязательно включите файл лицензии, определяющий способ совместного использования проекта с другими пользователями. Дополнительные сведения о продуктах с открытым кодом, особенно о создании и развитии проекта с открытым кодом, мы создали руководства по продуктам с открытым кодом, которые помогут создать работоспособный открытый код сообщества, формируя практические рекомендации по созданию и обслуживанию репозиториев для проекта с открытым кодом.
- Вы также можете пройти бесплатный курс GitHub Skills по поддержанию сообществ разработчиков продуктов с открытым кодом.
- Вы также можете добавить файлы работоспособности сообщества в репозитории, настроить рекомендации по участию, сохранить репозитории в безопасносном месте и многое другое. Дополнительные сведения см. в разделе Создание файла работоспособности сообщества по умолчанию..
- В правом верхнем углу любой страницы откройте раскрывающееся меню и выберите Новый репозиторий.
- Введите короткое запоминающееся имя репозитория, Например, "hello-world".
- При необходимости добавьте описание репозитория. Например, "Мой первый репозиторий на GitHub Enterprise Cloud".
1. Настройте видимость репозитория. Дополнительные сведения см. в разделе Сведения о репозиториях. 1. Выберите Initialize this repository with a README (Инициализировать репозиторий с помощью файла сведений). 1. Щелкните Создать репозиторий.
Поздравляем! Вы успешно создали первый репозиторий и инициализировали его с помощью файла сведений.
Дополнительные сведения о GitHub CLI см. в разделе Сведения о GitHub CLI.
- В командной строке перейдите в каталог, в котором нужно создать локальный клон нового проекта.
- Чтобы создать репозиторий для проекта, используйте подкоманду
gh repo create
. При появлении запроса выберите Создать репозиторий на GitHub с нуля и введите имя нового проекта. Если вы хотите, чтобы проект принадлежал организации, а не вашей личной учетной записи, укажите имя организации и имя проекта с помощьюorganization-name/project-name
. - Следуйте интерактивным инструкциям. Чтобы клонировать репозиторий локально, при получении запроса подтвердите клонирование удаленного каталога проекта.
- Можно также пропустить запросы, указав имя репозитория и флаг видимости (
--public
,--private
или--internal
). Например,gh repo create project-name --public
. Чтобы клонировать репозиторий локально, передайте флаг--clone
. Дополнительные сведения о возможных аргументах см. в руководстве по GitHub CLI.
Фиксация первого изменения
Фиксация похожа на моментальный снимок всех файлов проекта на определенный момент времени.
При создании репозитория вы инициализировали его с помощью файла сведений. Файлы сведений — это отличное средство для более подробного описания проекта или добавления документации, например по установке или использованию проекта. Содержимое файла сведений автоматически отображается на главной странице репозитория.
Давайте зафиксируем изменение в файле сведений.
- В списке файлов репозитория щелкните файл README.md.
- Над содержимым файла щелкните .
- На вкладке Изменение файла введите сведения о себе.
1. Над новым содержимым щелкните элемент Просмотреть изменения. - Проверьте внесенные в файл изменения. Новое содержимое будет выделено зеленым цветом.
1. В нижней части страницы введите короткое понятное сообщение о фиксации, описывающее внесенное в файл изменение. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими авторами. 1. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание запроса на включение изменений. 1. Щелкните Предложить изменение файла.
Теперь, когда проект создан, можно начать фиксацию изменений.
Файлы сведений — это отличное средство для более подробного описания проекта или добавления документации, например по установке или использованию проекта. Содержимое файла сведений автоматически отображается на главной странице репозитория. Чтобы добавить файл сведений, выполните указанные ниже действия.
-
В командной строке перейдите в корневой каталог нового проекта. (Этот каталог был создан при выполнении команды
gh repo create
.) -
Создайте файл сведений со сведениями о проекте.
echo "info about this project" >> README.md
-
Введите
git status
. Вы увидите, что есть неотслеживаемый файлREADME.md
.$ git status Untracked files: (use "git add
..." to include in what will be committed) README.md nothing added to commit but untracked files present (use "git add" to track) -
Подготовьте и зафиксируйте файл.
git add README.md && git commit -m "Add README"
-
Отправьте изменения в свою ветвь.
git push --set-upstream origin HEAD
Дальнейшие действия
Вы создали репозиторий, включая файл СВЕДЕНИЙ , и создали первую фиксацию для GitHub.com.
- Теперь можно клонировать репозиторий GitHub, чтобы создать локальную копию на своем компьютере. В локальном репозитории можно выполнять фиксации и создавать запросы на вытягивание, чтобы передавать изменения в вышестоящий репозиторий. Дополнительные сведения см. в разделах Клонирование репозитория и Настройка Git.
-
На GitHub можно найти интересные проекты и репозитории, в которые можно внести изменения, создав вилку репозитория. Создание вилки репозитория позволит вносить изменения в другой репозиторий, не затрагивая исходный. Дополнительные сведения см. в разделе Ветвление репозитория.
-
Каждый репозиторий на GitHub принадлежит пользователю или организации. Вы можете взаимодействовать с людьми, репозиториями и организациями, подписавшись на них на GitHub Enterprise Cloud. Дополнительные сведения см. в разделе Налаживание социальных связей.
-
У GitHub большое сообщество поддержки, где можно обратиться за помощью и поговорить с людьми со всего мира. Присоединиться к беседе можно в GitHub Community.