В жизни каждого начинающего программиста рано или поздно встаёт вопрос о работе с таким репозиторием, как гитхаб. С первого взгляда на этого монстра не понятно ничего, кроме того, что это сайт, который хранит кучу нужных файлов непонятно как напиханных и обязательно на английском языке. И если разобраться с тем, как эти файлы скачать и прочитать документацию на них, используя свой школьный английский ещё возможно, то оформление своего портфолио в этом пространстве вводит в ступор. С чего начать оформлять портфолио?
1. Добавляем репозиторий
В правом верхнем углу нажмем на "+" и добавим наш первый новый репозиторий.
Называем репозиторий, как нам нужно, добавляем описание (прикрепляем README файл обязательно (далее про README будет более подробный разговор) и собственно создаём наш первый новый репозиторий на гитхабе :)
Добавление папки проекта
Важный момент, который обычно сбивает с толку всех новичков типа меня: создание папки проекта. Если слишком глубоко залезть в "волшебное гугление", то можно, конечно, освоить работу с гитхабом локально, но займёт это кучу времени. Предположим, что нам нужно всё сделать быстро. На самом деле всё гораздо проще, чем кажется на первый взгляд.
Как мы видим в нашем репозитории уже есть описание в виде README.md файла. В идеале файл с таким названием должен быть у каждого нового добавленного проекта, он будет нести в себе описание уже не репозитория, а проекта, рядом с которым мы его создаём.
Добавим файл, нажав на "Add file", выберем "Create new file". Тут важно сначала именно создать новый файл, т.к., чтобы наши проекты смотрелись презентабельно, им нужна папка, в которой будет сам проект и описание к нему. Т.е. получается, что сейчас мы будем добавлять непосредственно папку для нашего проекта!
Создать папку очень легко, для этого после введённого названия в создающийся проект нужно добавить "/" и папка создастся. Далее, как мы говорили выше, создаём README файл с описанием проекта (прям так и пишем README.md после "название-папки/". Важно понимать, что в файлах md можно и нужно использовать Маркдаун, т.к. с ним описание приятно читать, можно выделить основную мысль и т.д. и т.п. Ниже нажимаем на кнопочку "Commit new file".
Добавление проекта в папку
Описание смотрится красиво, так как мы использовали язык разметки маркдаун.
Теперь нам остаётся непосредственно добавить в папку наш проект через загрузку файлов (кнопка "Add file" -> "Upload files")
Проект загружен и теперь наша папка выглядит примерно так:
Репозиторий создан, папка для проекта создана, проект и описание к проекту добавлены в папку.
P.S.: проектов может быть несколько (в случае с моим приложением, так сказать, файлов должно быть несколько python-файл и kivy-md файлы с описанием процессов игры, но я их пока не делала). Добавить более одного файла не составит труда, т.к. весь этот процесс аналогичен нашей инструкции "Добавление проекта в папку".
Спасибо за просмотр :)