Работа с репозиторием на GitHub

Предварительные требования

1. Есть базовое понимание что такое Git и GitHub
2. Вы зарегистрированы на GitHub и авторизованы на сайте
3. Ранее вы создали репозиторий и знаете как его найти на GitHub

Особенности веб-интерфейса

Важно понимать, что веб-интерфейс GitHub не предназначен для активной работы с репозиторием. Его основная цель – отображать данные, поэтому часть функций работает “странным” и порой неочевидным образом, а отдельные операции вообще не получится сделать через браузер. Предполагается, что все манипуляции с файлами производятся на локальной машине, после чего правки синхронизируются с помощью специальных приложений.

Однако это достаточно большая тема, которая требует детального погружения и знакомства с принципами работы git, что выходит за рамки этого туториала. Поэтому здесь мы рассмотрим лишь простейший способ работы с GitHub, достаточный для первых этапов погружения в тему разработки ПО (программного обеспечения), а именно – возможность разместить код в облаке и получить на него ссылку для публичного доступа.

Загрузить новый файл в репозиторий

Чтобы загрузить файлы в репозиторий:

1. Откройте в браузере главную страницу репозитория (подробнее в разделе Предварительные требования)
2. Нажмите кнопку Add file или +, рядом с зелёной кнопкой <> Code
3. В открывшемся меню нажмите Upload files
4. Откройте папку на ПК, в которой хранится нужный файл
5. Перетащите файл прямо в окно браузера в зону вокруг надписи Drag files here to add them to your repository
6. Убедитесь, что название файла появилось в небольшом прямоугольнике сразу под зоной выгрузки файлов
7. Нажмите кнопку Commit changes в самом низу страницы
8. Снова откроется главная страница репозитория – убедитесь, что новый файл появился в списке

Эта способ подходит для любого типа файлов, как текстовых, так и медийных (изображения, музыка или видео). Проблемы могут возникнуть только при попытке выгрузить на сайт какой-то большой файл, который занимает более 25 мегабайт – тогда высветится небольшое и еле заметное оповещение: Yowza, that’s a big file. Try again with a file smaller than 25MB (Ого, какой большой файл. Попробуйте еще раз с файлом меньше 25 МБ).

Файлы большого размера

GitHub не позволяет выгружать в репозиторий файлы больше 25 мегабайт через веб-интерфейс. Способы “тяжёлых” файлов на GitHub существуют, но выходят за рамки этого туториала, т.к. подавляющее большинство документов ваших будущих проектов занимают значительно меньше места, поэтому беспокоиться об этих лимитах нет необходимости.

Добавить несколько файлов

Добавление в репозиторий нескольких файлов происходит так же, как и в случае с отдельными документами: выберите необходимые файлы в папке на вашем ПК перетащите их в интерфейс добавления файлов дождитесь загрузку файлов и подтвердите изменения нажав на кнопку Commit changes Перетаскивать файлы можно как поочерёдно, так и выделив все необходимые файлы сразу.

Просмотреть содержимое папок в репозитории

Чтобы просмотреть содержимое папки, просто нажмите на её название. Для того, чтобы вернуться в предыдущий каталог – нажмите на изображение папки с двумя точками ..

Добавление файлов и директорий в существующую папку репозитория

1. Откройте нужную папку в репозитории
2. Нажмите кнопку Add file или … справа над списком файлов
3. Далее процесс выглядит так же, как и с добавлением содержимого в корневой каталог репозитория

Если выгружаете сразу несколько файлов или папку целиком – процесс может занять некоторое время. Дождитесь загрузки всех файлов перед нажатием кнопки Commit changes.

Добавить пустую папку в репозиторий

GitHub не умеет хранить пустые папки, поэтому при попытке добавить каталог без файлов в репозиторий – вы получите ошибку Add some files to include in this commit. (Добавьте файлы для их включения в коммит).

Удалить папку

1. Откройте папку на просмотр, кликнув по её названию в списке содержимого репозитория
2. Справа вверху нажмите кнопку с многоточием “…”
3. Во всплывающем меню нажмите красную надпись Delete directory (Удалить папку)
4. На странице со списком содержимого удаляемой папки нажмите зелёную кнопку Commit changes… (Применить изменения)
5. Во всплывающем окне при необходимости укажите причину удаления
6. Нажмите зелёную кнопку Commit changes для подтверждения действий

При успешном завершении, автоматически откроется главная страница репозитория, а вверху вы увидите надпись “Directory successfully deleted” (Папка успешно удалена)

Удалить файл

Удаление файлов происходит тем же способом, что и удаление папок (подробнее – в предыдущем разделе). GitHub не позволяет через веб-интерфейс удалять несколько файлов одновременно, требуется проводить эту процедуру с каждым из них по отдельности. А именно:

1. Откройте нужный файл на просмотр (так же, как это происходит с папкой)
2. Нажмите кнопку ...
3. Нажмите кнопку Delete file
4. Подтвердите действие нажатием кнопки Commit changes

Если всё прошло успешно, вы увидите надпись “File successfully deleted” (Файл успешно удалён)

Переместить файл или папку в другую директорию репозитория

Веб-интерфейс GitHub не позволяет сделать это напрямую, поэтому предлагаем решение через скачивание нужных файлов на ПК.

Заменить существующего файла в репозитории

Так же, как добавление новых файлов в репозиторий, происходит и замена уже существующих документов. Достаточно выгрузить обновлёный файл в ту же папку, где лежит старый вариант и подтвердить действие.

Особенность обновления изображений

В отличие от текстовых документов, изображения и прочие медийные файлы обновляются в репозитории не сразу. Если открыть картинку на просмотр сразу после замены – она будет отображаться как старая. Для проверки того, что файл в репозитории действительно обновлён, необходимо подождать 15-20 минут и снова просмотреть его. Это связано с особенностью работы самой площадки, при работе с “тяжёлыми” файлами.

Как понять, что файл в репозитории обновлён

Признаком того, что обновление файла прошло успешно является метка времени последнего изменения:

Подпись “now” (сейчас) означает, что файл был обновлён только что. Со временем эта подпись будет меняться на “1 minutes ago”, “2 minutes ago”, “1 day ago” и так далее, обозначая как давно произошло обновление файла – это помогает лучше ориентироваться в том, на сколько актуален репозиторий.