diff --git a/docs/project-work/rabota-s-github-cherez-veb-interfeys/rabota-s-github-cherez-veb-interfeys.md b/docs/project-work/rabota-s-github-cherez-veb-interfeys/rabota-s-github-cherez-veb-interfeys.md new file mode 100644 index 0000000..8dd2b49 --- /dev/null +++ b/docs/project-work/rabota-s-github-cherez-veb-interfeys/rabota-s-github-cherez-veb-interfeys.md @@ -0,0 +1,71 @@ +--- +title: "Как работать с GitHub через веб-интерфейс" +--- + +[Перейти на сайт](https://ru.hexlet.io) + +# Как работать с GitHub через веб-интерфейс + +> Во многих проектах решение нужно сдавать через GitHub: загрузить туда файлы, создать или поправить их. В этой статье разберём, как делать это прямо в браузере — без Git и командной строки. Статья пригодится в проектах по аналитике данных, тестированию и на первых программистских проектах. + +## Коротко о GitHub + +GitHub — это хранилище файлов вашего проекта. Каждый проект хранится в отдельном **репозитории** — это как папка с файлами и историей их изменений. + +Для учебных проектов репозиторий уже создан за вас на шаге «Подготовка», и он привязан к вашему профилю на GitHub. Туда вы и будете складывать результаты работы: готовые файлы (например, CSV-таблицу, PDF-презентацию, SQL-запросы, код) — их проверит автоматическая система. + +Чтобы работать с репозиторием, не нужно устанавливать Git и разбираться с командной строкой — всё можно сделать через веб-интерфейс GitHub. Разберём три действия: **загрузить файлы**, **создать файл** и **отредактировать файл**. + +## Открываем репозиторий + +Откройте страницу своего репозитория на GitHub. Вы увидите список файлов, а справа сверху — кнопки **Add file** («добавить файл») и **Code**. + +![Страница репозитория на GitHub](/img/docs/img-198--github-repo.png) + +## Загружаем готовые файлы + +Этот способ подходит, когда файл у вас уже готов на компьютере: таблица, презентация, скриншот, файл с кодом или запросами. + +Нажмите **Add file** и выберите **Upload files**: + +![Меню «Add file»: Create new file и Upload files](/img/docs/img-199--github-addfile-menu.png) + +Перетащите файлы в открывшееся поле или нажмите **choose your files** и выберите их вручную. Можно загрузить сразу несколько файлов. + +![Страница загрузки файлов в репозиторий](/img/docs/img-200--github-upload.png) + +Ниже, в блоке **Commit changes**, можно написать короткое описание изменений (необязательно) и нажать зелёную кнопку **Commit changes** — файлы сохранятся в репозитории. + +:::tip +Чтобы положить файл в подпапку, при загрузке это произойдёт автоматически, если перетащить папку. А при создании файла можно вписать путь со слешем — например, `reports/sales.csv` создаст файл `sales.csv` в папке `reports`. +::: + +## Создаём файл прямо на GitHub + +Если файла ещё нет и его содержимое небольшое (например, текстовая заметка или короткий код), файл удобно создать прямо в браузере. + +Нажмите **Add file** → **Create new file**. Впишите имя файла вверху, а его содержимое — в большое поле редактора: + +![Создание нового файла на GitHub](/img/docs/img-201--github-create-file.png) + +Когда закончите, нажмите **Commit changes…** справа сверху, при необходимости поправьте описание и подтвердите кнопкой **Commit changes**. + +## Редактируем файл + +Чтобы изменить уже существующий файл, откройте его в репозитории и нажмите значок карандаша ✏️ (**Edit this file**) над содержимым файла: + +![Просмотр файла с кнопкой редактирования](/img/docs/img-202--github-edit-file.png) + +Откроется редактор — внесите правки и сохраните их так же, через **Commit changes**. + +## Что такое «коммит» + +При любом изменении (загрузка, создание, редактирование) GitHub просит **подтвердить изменения** — это называется *коммит* (commit). В окне можно оставить описание по умолчанию, а вариант выбрать **Commit directly to the `main` branch** (сохранить сразу в основную ветку) и нажать зелёную кнопку **Commit changes**. + +![Окно подтверждения изменений (commit)](/img/docs/img-203--github-commit.png) + +После этого файлы появятся в репозитории. Если в проекте есть автоматическая проверка, она возьмёт файлы из репозитория и проверит их. + +:::note +Если для проекта нужно писать и запускать код, а не только загружать готовые файлы, посмотрите статьи [Как работать в GitHub Codespaces](https://help.hexlet.io/project-work/kak-rabotat-v-github-codespaces) и [Онлайн-редактор OneCompiler](https://help.hexlet.io/project-work/onlain-redaktor-onecompiler). +::: diff --git a/static/img/docs/img-198--github-repo.png b/static/img/docs/img-198--github-repo.png new file mode 100644 index 0000000..4a0380a Binary files /dev/null and b/static/img/docs/img-198--github-repo.png differ diff --git a/static/img/docs/img-199--github-addfile-menu.png b/static/img/docs/img-199--github-addfile-menu.png new file mode 100644 index 0000000..8b9fd45 Binary files /dev/null and b/static/img/docs/img-199--github-addfile-menu.png differ diff --git a/static/img/docs/img-200--github-upload.png b/static/img/docs/img-200--github-upload.png new file mode 100644 index 0000000..9f91ea3 Binary files /dev/null and b/static/img/docs/img-200--github-upload.png differ diff --git a/static/img/docs/img-201--github-create-file.png b/static/img/docs/img-201--github-create-file.png new file mode 100644 index 0000000..3a4bb1e Binary files /dev/null and b/static/img/docs/img-201--github-create-file.png differ diff --git a/static/img/docs/img-202--github-edit-file.png b/static/img/docs/img-202--github-edit-file.png new file mode 100644 index 0000000..e67523c Binary files /dev/null and b/static/img/docs/img-202--github-edit-file.png differ diff --git a/static/img/docs/img-203--github-commit.png b/static/img/docs/img-203--github-commit.png new file mode 100644 index 0000000..36fadd9 Binary files /dev/null and b/static/img/docs/img-203--github-commit.png differ