Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы, возможно, еще выполняется. Актуальные сведения см. в документации на английском языке.

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

Чтобы разместить проект на GitHub, необходимо создать репозиторий, чтобы он функционировал.

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

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

Примечания.

  • Для проекта с открытым кодом можно создать общедоступные репозитории. При создании общедоступного репозитория обязательно включите файл лицензии, определяющий способ совместного использования проекта с другими пользователями. Дополнительные сведения о продуктах с открытым кодом, особенно о создании и развитии проекта с открытым кодом, мы создали руководства по продуктам с открытым кодом, которые помогут создать работоспособный открытый код сообщества, формируя практические рекомендации по созданию и обслуживанию репозиториев для проекта с открытым кодом.
  • Вы также можете пройти бесплатный курс GitHub Skills по поддержанию сообществ разработчиков продуктов с открытым кодом.
  • Вы также можете добавить файлы работоспособности сообщества в репозитории, настроить рекомендации по участию, сохранить репозитории в безопасносном месте и многое другое. Дополнительные сведения см. в статье "Создание файла работоспособности сообщества по умолчанию".
  1. В правом верхнем углу любой страницы откройте раскрывающееся меню и выберите Новый репозиторий. Раскрывающийся список с параметром создания нового репозитория
  2. Введите короткое запоминающееся имя репозитория, Например, "hello-world". Поле для ввода имени репозитория
  3. При необходимости добавьте описание репозитория. Например, "Мой первый репозиторий на GitHub". Поле для ввода описания репозитория 1. Настройте видимость репозитория. Дополнительные сведения см. в разделе Сведения о репозиториях. Переключатели для настройки видимости репозитория 1. Выберите Initialize this repository with a README (Инициализировать репозиторий с помощью файла сведений). Инициализировать репозиторий с помощью флажка README 1. Щелкните Создать репозиторий. Кнопка для создания репозитория

Поздравляем! Вы успешно создали первый репозиторий и инициализировали его с помощью файла сведений.

Дополнительные сведения о GitHub CLI см. в статье Сведения о GitHub CLI.

  1. В командной строке перейдите в каталог, в котором нужно создать локальный клон нового проекта.
  2. Чтобы создать репозиторий для проекта, используйте подкоманду gh repo create. При появлении запроса выберите Создать репозиторий на GitHub с нуля и введите имя нового проекта. Если вы хотите, чтобы проект принадлежал организации, а не вашей личной учетной записи, укажите имя организации и имя проекта с помощью organization-name/project-name.
  3. Следуйте интерактивным инструкциям. Чтобы клонировать репозиторий локально, при получении запроса подтвердите клонирование удаленного каталога проекта.
  4. Можно также пропустить запросы, указав имя репозитория и флаг видимости (--public, --private или --internal). Например, gh repo create project-name --public. Чтобы клонировать репозиторий локально, передайте флаг --clone. Дополнительные сведения о возможных аргументах см. в руководстве по GitHub CLI.

Фиксация первого изменения

Фиксация похожа на моментальный снимок всех файлов проекта на определенный момент времени.

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

Давайте зафиксируем изменение в файле сведений.

  1. В списке файлов репозитория щелкните файл README.md. Файл сведений в списке файлов
  2. Над содержимым файла щелкните .
  3. На вкладке Изменение файла введите сведения о себе. Новое содержимое в файле 1. Над новым содержимым щелкните элемент Просмотреть изменения. Кнопка "Предварительный просмотр файла"
  4. Проверьте внесенные в файл изменения. Новое содержимое будет выделено зеленым цветом. Представление предварительного просмотра файла 1. В нижней части страницы введите короткое понятное сообщение о фиксации, описывающее внесенное в файл изменение. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими соавторами. Сообщение о фиксации для изменения 1. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание нового запроса на вытягивание. Параметры фиксации ветви 1. Щелкните Предложить изменение файла. Кнопка "Предложить изменение файла"

Теперь, когда проект создан, можно начать фиксацию изменений.

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

  1. В командной строке перейдите в корневой каталог нового проекта. (Этот каталог был создан при выполнении команды gh repo create.)

  2. Создайте файл сведений со сведениями о проекте.

    echo "info about this project" >> README.md
  3. Введите 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)
  4. Подготовьте и зафиксируйте файл.

    git add README.md && git commit -m "Add README"
  5. Отправьте изменения в свою ветвь.

    git push --set-upstream origin HEAD

Дальнейшие действия

Теперь вы создали репозиторий, включая файл сведений , и создали первую фиксацию в GitHub.com.

  • Теперь можно клонировать репозиторий GitHub, чтобы создать локальную копию на своем компьютере. В локальном репозитории можно выполнять фиксации и создавать запросы на вытягивание, чтобы передавать изменения в вышестоящий репозиторий. Дополнительные сведения см. в разделах Клонирование репозитория и Настройка GIT.
  • На GitHub можно найти интересные проекты и репозитории, в которые можно внести изменения, создав вилку репозитория. Создание вилки репозитория позволит вносить изменения в другой репозиторий, не затрагивая исходный. Дополнительные сведения см. в разделе Создание вилки репозитория.

  • Каждый репозиторий на GitHub принадлежит пользователю или организации. Вы можете взаимодействовать с людьми, репозиториями и организациями, подписавшись на них на GitHub. Дополнительные сведения см. в разделе Социальное взаимодействие.

  • У GitHub большое сообщество поддержки, где можно обратиться за помощью и поговорить с людьми со всего мира. Присоединиться к беседе можно в GitHub Community.