Добавляет рецепт «Как создать репозиторий на GitHub» (#4588)

* Добавляет рецепт о создании репозитория на GitHub * Добавляет время на задачу * Добавляет слово в словарь * Тотально принимает все правки Co-authored-by: Svetlana Korobtseva <[email protected]> Co-authored-by: Tatiana Fokina <[email protected]> * Update recipes/github-new-repo/index.md Co-authored-by: Svetlana Korobtseva <[email protected]> * Дополняет описание кнопки * Убирает лишний заголовок * Удаляет ошибочное слово * Принимает правки @skorobaeus Co-authored-by: Svetlana Korobtseva <[email protected]> --------- Co-authored-by: Svetlana Korobtseva <[email protected]> Co-authored-by: Tatiana Fokina <[email protected]>
doka-guide · Sep 11, 2023 · 42804a9 · 42804a9
1 parent 018dbf0
commit 42804a9
Show file tree

Hide file tree

Showing 3 changed files with 67 additions and 0 deletions.
diff --git a/recipes/github-new-repo/images/github-new-repo-settings.png b/recipes/github-new-repo/images/github-new-repo-settings.png
diff --git a/recipes/github-new-repo/images/github-new-repo.png b/recipes/github-new-repo/images/github-new-repo.png
diff --git a/recipes/github-new-repo/index.md b/recipes/github-new-repo/index.md
@@ -0,0 +1,67 @@
+---
+title: "Как создать репозиторий на GitHub"
+description: "Начните работу на GitHub с создания репозитория."
+authors:
+  - igsekor
+related:
+  - tools/version-control
+  - tools/git-cli
+  - tools/github-actions
+tags:
+  - article
+---
+
+## Задача
+
+Работа над проектом или вашим портфолио — для этого вам точно понадобится репозиторий. Есть несколько сервисов, которые позволяют разместить свой код с ограниченным или публичным доступом. Среди таких платформ наибольшую популярность получил GitHub. Создадим свой репозиторий на GitHub за пару минут.
+
+## Решение
+
+В правом углу нужно нажать на кнопку «+» («Create something new») и выбрать пункт «New repository…», как показано на скриншоте:
+
+![Выпадающее меню на GitHub с обведённым красным пунктом «New repository»](images/github-new-repo.png)
+
+Откроется окно с выбором параметров создаваемого репозитория, в котором нужно написать название репозитория в поле «Repository name», которое должно быть уникальным. На скриншоте расположено после имени владельца и выделено красной рамкой. Доступность имени будет проверяться по мере ввода его в поле.
+
+![Настройки нового репозитория с обведёнными красным обязательным полем «Repository name» и чекбоксами «Public» и «Private»](images/github-new-repo-settings.png)
+
+Поле «Owner» заполняется автоматически тем профилем, под которым вы вошли. Если вы участник организаций на GitHub, то в этом поле можно будет выбрать нужную организацию.
+
+Следующее обязательное поле — уровень доступа к репозиторию. Оно тоже выделено красной рамкой и расположено после необязательного поля для описания репозитория. Репозитории бывают частными (private), скрытыми от посторонних глаз, и публичными (public), открытыми для всех желающих. По умолчанию выбран вариант публичного репозитория.
+
+Можно заполнить и другие необязательные поля:
+
+- добавить краткое описание репозитория (поле «Description»);
+- добавить файл-описание _README.md_ («Add a README file»);
+- добавить файл исключений _.gitignore_ для отслеживания файлов папке репозитория («Add .gitignore»);
+- выбрать одну из заготовленных лицензий («Choose a license»).
+
+Помните, что вы можете добавлять эти файлы только в новый репозиторий, который нигде, кроме GitHub, ещё не создан, иначе возникнет конфликт. Однако эти три файла можно добавить и позже вручную, или они могут уже присутствовать в вашем проекте на локальном компьютере.
+
+После нажатия на кнопку «Create repository» откроется страница пустого репозитория, где появятся подсказки о дальнейших действиях.
+
+Если репозиторий ещё не создан у вас на компьютере, то можно в терминале выполнить команды группы «…or create a new repository on the command line»:
+
+```bash
+echo "# python" >> README.md
+git init
+git add README.md
+git commit -m "Комментарий к первому коммиту"
+git branch -M main
+git remote add origin [email protected]:<путь до репозитория>
+git push -u origin main
+```
+
+GitHub предлагает первым файлом в репозитории создавать файл с описанием проекта _README.md_. Основную ветку GitHub предлагает назвать `main`.
+
+Если репозиторий уже существует, можно выполнить только две последние команды:
+
+```bash
+git branch -M main
+git remote add origin [email protected]:<путь до репозитория>
+git push -u origin main
+```
+
+Первая команда переименовывает основную ветку вашего репозитория и является необязательной. В случае, если ваша основная ветка называется иначе, вместо `main` нужно будет указать то название ветки, которое используете вы.
+
+Если используете в репозитории иную систему контроля версий, то GitHub может попробовать преобразовать её в git. Для этого нужно нажать на кнопку «Import code» и следовать инструкции.