Краткое руководство по репозиториям

Узнайте, как создать новый репозиторий и зафиксировать первое изменение за 5 минут.

Tool navigation

В этой статье

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

Репозитории GitHub хранят различные проекты. В этом руководстве вы создадите репозиторий и зафиксируйте первое изменение.

  1. В правом верхнем углу любой страницы выберите , а затем нажмите кнопку "Создать репозиторий".

    Снимок экрана: раскрывающееся меню GitHub с параметрами создания новых элементов. Пункт меню "Новый репозиторий" описан в темно-оранжевый.

  2. Введите короткое запоминающееся имя репозитория, Например, "hello-world".

    Снимок экрана: первый шаг при создании репозитория. Поле "Имя репозитория" содержит текст hello-world и описывается в темно-оранжевый цвет.

  3. При необходимости добавьте описание репозитория. Например, "Мой первый репозиторий на GitHub".

  4. Настройте видимость репозитория. Дополнительные сведения см. в разделе Сведения о репозиториях.

  5. Включите параметр «Добавить файл сведений».****

  6. Щелкните Создать репозиторий.

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

Примечание.

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

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

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

          [Фиксация](/get-started/learning-about-github/github-glossary#commit) похожа на моментальный снимок всех файлов проекта на определенный момент времени.

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

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

  1. В списке файлов репозитория выберите README.md.

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

  2. В правом верхнем углу представления файла щелкните (Изменить файл), чтобы открыть редактор файлов.

    Снимок экрана: файл. В заголовке кнопка, помеченная значком карандаша, описывается темно-оранжевым цветом.

  3. В текстовом поле введите некоторые сведения о себе.

  4. Над новым содержимым нажмите кнопку "Предварительный просмотр".

    Снимок экрана: файл в режиме редактирования. Над содержимым файла вкладка с меткой "Предварительная версия" выделена темно-оранжевым цветом.

  5. Проверьте внесенные в файл изменения. Если выбрать "Показать дифф", вы увидите новое содержимое зеленым цветом.

           ![Снимок экрана: предварительный просмотр файла. Флажок "Показать дифф" включен, а дополнения к файлу отображаются зеленой строкой. Оба очертания оранжевого цвета.](/assets/images/help/repository/create-commit-review.png)

  6. Нажмите кнопку " Зафиксировать изменения" ...

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

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

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

  9. Нажмите кнопку Зафиксировать изменения или Предложить изменения.

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

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

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

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

    echo "info about this project" >> README.md

  3. Введите git status. Вы увидите, что есть неотслеживаемый файл README.md.

    $ git status

Untracked files:
  (use "git add <file>..." 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

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

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

  • Теперь можно клонировать репозиторий GitHub, чтобы создать локальную копию на своем компьютере. В локальном репозитории можно выполнять фиксации и создавать запросы на вытягивание, чтобы передавать изменения в вышестоящий репозиторий. Дополнительные сведения см. в разделе [AUTOTITLE и Клонирование репозитория](/get-started/git-basics/set-up-git).

  • Защитите репозиторий с помощью доступных функций безопасности GitHub. Дополнительные сведения см. в разделе Краткое руководство по защите репозитория.

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

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

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