Что такое github и как создать свой репозиторий. Часть 1


Материал в статье подготовлен специально для программистов или для пользователей, чья профессия связана с отраслью IT. Здесь вы узнаете, что такое гитхаб и как создать репозиторий на github.

Сталкивались ли вы с ситуацией, когда нужно поделиться своим проектом с другими разработчиками, а подходящую площадку найти сложно. Можно запустить свой личный блог и запостить туда несколько наработок. Однако тут есть свои риски, например, забыть заплатить за домен и хост, получить блокировку ресурса или не суметь продвинуть блог в поисковике, вследствие чего пользователи не смогут найти ваши работы.

Если программист занимается поиском заказчиков, то внезапно закрытый сайт отпугнет потенциальных клиентов.

Поэтому желательно разместить свой проект на проверенной площадке. В интернете существует несколько зарекомендованных сервисов, но мы поговорим о “github”.

1. Что такое гитхаб?

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

GitHub что это – система управления проектом, а также версиями вашего кода. Данная платформа сравнима с социальными сетями, только предназначена для разработчиков. Здесь вы можете поместить свой код, делиться им с остальными, а также совместно вести разработку проекта в команде.

Существует еще git, площадка предназначена для сохранения версий кода. Например, если при работе произошла серьезная ошибка, то предусмотрена возможность откатить до последней стабильной версии.

Иногда происходит ситуация когда несколько разработчиков работают над одним проектом, после одновременной загрузки разных версий кода происходит конфликт. В этом случае Git сам попытается исправить ошибки, если не получится, то тогда подключаются создатели скрипта. Надеюсь, стало понятно GitHub что это. Следует понять главное что github и git не одно и то же. Прежде чем работать с площадкой, следует сначала создать аккаунт.

2. Как зарегистрироваться?

Здесь потребуется компьютер с версией Windows не ниже 7. Недавно встретил одного знакомого, который собирается стать программистом. Есть у него несколько книг по программированию, только вот железо у него слабое с windows xp.

С трудом, но все же удалось подключить профиль к платформе. Сейчас расскажу, как я это сделал. Это информация станет полезной обладателям старых компьютеров с Windows XP.

Предположительно те, у кого XP заходят в интернет через Google Chrome 49 или FireFox 52.9, которые являются последними для данной OS. В данном случае для регистрации эти веб-обозреватели слишком устарели, в них установлено ограничение специально для Windows XP. В этом случае рекомендуется взять browser, который не привязан к версии ОС. Здесь подойдет 360 Extreme Explorer 11 или выше.

Одиннадцатая версия сравнима с 70 Google Chrome, включая все возможности. После скачивания заходим на официальный сайт как показано на картинке и заполняем форму, поля здесь появляются постепенно при заполнении данных. Нужно указать следующую информацию.

  1. Username
  2. Email
  3. Пароль
  4. Капчу – появится графический элемент, где нужно выбрать галактику. Captcha может и не появится следует подождать. Если она так и не появилась, зайдите в код и найдите капчу, там она расположена отдельно в iframe и попробуйте перейти по ссылке и загрузить отдельно, потом вернитесь обратно на страницу с формой и посмотрите, загрузилась ли Captcha. Мне этот способ помог, когда я проходил регистрацию в XP.
  5. Поставить “чекбокс”, который дает согласие получать рассылку о новых улучшениях в системе.

Заключительный этап – это ввести 8-значный код, который придет на почтовый ящик. После выполнения всех шагов вы получите доступ к аккаунту. Чтобы загрузить проект потребуется создать репозиторий.

3. Как создать репозиторий на github и загрузить туда файлы?

На главной странице нажмите кнопку NEW, вас перенаправят в раздел Create a new repository. Здесь следует придумать имя, например 3dmodels. как создать репозиторий на github

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

Как писалось выше, мы выполняем все действия в Windows XP, поэтому и Git нужно скачивать под эту OS. Последняя версия под XP 2.10. Скачать её можно по этой ссылке https://github.com/git-for-windows/git/releases/tag/v2.10.0.windows.1. Выбирайте эту программу. программа git


Важно: программа напоминает командную строку MS-DOS, поэтому чтобы что-то загрузить потребуется знать определенные команды.


3.1. Отправляем файлы в наш профиль через командную строку

После установки программы git, появится три ярлыка. установка программы git

Щелкаем по Git Bash, откроется командная строка. Перед началом следует заранее создать папку, где будут храниться наши файлы для отправки в репозиторий. Вот пример: создание папки git

Теперь откройте программу Git Bash и введите туда несколько команд в первую очередь переключитесь на диск С, используя cd, потом убедитесь, что ваша папка создана, для этого введите ls. В итоге отобразиться перечень ваших каталогов в диске С. Пример ниже. Среди всего списка вы найдите то, что создано вами. Теперь перейдите в ваш раздел и выполните git init, таким образом, дадите команду создать локальный репозиторий. Последовательность действий посмотрите на картинке ниже. создаем локальный репозиторий

Чтобы убедиться в создании repository перейдите в свой каталог и посмотрите. Все ваши проекты и файлы, которые будете загружать на платформу нужно добавлять сюда пример на картинки. Также стрелкой обозначен объект, созданный через командную строку. папка git

Следующий шаг нужно перенести все файлы в созданную директорию и начать их готовить к переправке. Для этого пропишите команду add и укажите, что хотите загрузить. В нашем случае папка с объектами и html-файл. Когда сработает add, то покажется список перенесенных файлов. Для завершения, выполните первый commit. Ниже предоставлен пример последовательности действий. что такое github

Добавляем к локальному репозиторию ссылку на виртуальное пространство. Подсмотреть веб-ссылку можно на интернет-площадке. github что это Дальше выполните следующую команду, разумеется, вместо url из скриншота ниже, добавьте свою веб-ссылку. пример команды

Ну и последнее сделайте git push origin master. После этого предложат ввести username, укажите тот, который вы регистрировали на платформе и пароль. Что касается password, сюда вместо типичного пароля нужно вписать токкен. Сначала создайте его. Для этого перейдите в настройки и нажмите Generate new token. Генерации токена ответственный шаг, поэтому потребуется паролем подтвердить права на аккаунт. Введите тот password, который указывали при регистрации. генерация токена

Заполняем поле Note, впишите что угодно, к примеру “Demo For Access”. Что касается чекбоксов, которые находятся на этой же странице, я предлагаю везде отметить галочки. Внизу находится зеленая кнопка нажмите на неё, и после этого появится сгенерированный токен. Скопируйте его. Дальше переходим в окно, которое появилось ранее, и вставляем в поле токкен.


Важно: контекстное меню здесь не работает, поэтому единственный способ вставить, это нажать CTRL+V.


Когда token добавлен, нажмите OK. копируем и вставляем токен

Если все прошло успешно вы получите сообщение “Counting objects: 19, done.”. Результат можно увидеть, перейдя в свой repository. Зелена кнопка “Code”, открывает меню, где доступна ссылка на скачивание. ссылки на скачивание

3.2.Как сделать загрузку через онлайн сервис

В этом примере мы создадим веб-сайт, где пользователи смогут просматривать работы разработчиков в режиме олайн. Здесь воспользуемся инструментами, которые предоставляет сервис. Это значит, что процесс добавления новых проектов будет происходить на платформе, что значительно облегчает работу в отличие от командной строки.

Потребуется создать еще одно виртуальное пространство, которое будет выступать доменом для веб-сайта. Как создать репозиторий на github мы разбирали в предыдущем пункте. Теперь главное, наш домен будет состоять из двух частей первое – это имя пользователя, второе – название компании с которой работает клиент, доменная зона будет io. Пример показан на картинке. создание сайта на github

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

  1. Сreating a new file
  2. Uploading an existing file

Допустим, вы уже написали код, то следует выбрать пункт 2. Плавно мышкой перетащите проект на рабочую область в браузере или воспользуйтесь chouse your file, это для выбора через проводник. Если загрузка завершена, то это еще не означает, что изменения вступили в силу, для завершения нажмите “Commit Change”. Дальше проект станет доступен по web-ссылке.


Важно: если при первом посещение вы получите 404 ошибку, то это означает, что изменения еще не вступили в силу и нужно подождать какое-то время, пока ресурс не создастся. Обычно это занимает пару минут.


Наш проект доступен для открытия и скачивания через кнопку “Code”. По соседству также можно обнаружить Add File. С помощью него создаются и загружаются дополнительные скрипты, ассеты и многое другое, самое главное вовремя не забывать нажимать “Commit”. создание и загрузка новых файлов

4. Альтернативные варианты для хранения своих файлов

Как создать репозиторий на github важно знать для размещения своих файлов, но это не единственная площадка для загрузки своих проекты, существуют и другие. Перечислим их.
  1. GitLab Pages
  2. BitBucket Pages
  3. Heroku c поддержкой node.js

Для хранения своих исходников не обязательно регистрировать аккаунт на этих площадках, есть специальный сервис https://codepen.io/ и https://jsfiddle.net/.

Эти ресурсы созданы, чтобы сохранять исходные коды проектов, но если требуется показать код аудитории, в котором присутствует библиотека Treejs с загруженными моделями, то здесь без стороннего ресурса не обойтись.

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

В нем находится информация о 3d модели. Чтобы правильно сделать подключение к библиотеке threejs потребуется получить прямую ссылку. Сделать это достаточно просто. Для начала следует перейти в dropbox и нажать “Копировать ссылку” два раза. Первый раз – при наведении мышки на файл, второй раз – во всплывающем окне. копирование ссылки на dropbox

В итоге у нас получится веб-ссылка вот такого вида: https://www.dropbox.com/s/61ryo9bajur0ece/eva-animated.json?dl=0. Она подойдет для публикации в социальных сетях и на форумах. Чтобы получить возможность подгружать дополнительные данные в js, нужно получить прямую ссылку.

Делается это следующим образом, вместо www добавляем dl. Дальше dropbox, в свою очередь, заменяем dropboxusercontent. Все, что следует после json, в конце убираем (?dl=0) и получаем: https://dl.dropboxusercontent.com/s/61ryo9bajur0ece/eva-animated.json.

Если в коде присутствуют изображения, то пути меняются таким же образом. Готовый пример смотрите на “codepen”. https://codepen.io/Smith37/pen/jOGQEGv.

.


Примечание: все файлы сохраненные на dropbox, хранятся долгое время и по прошествии времени к ним можно получить доступ. Они не удаляются и буду доступны спустя 1,2 или 5 лет


Другой сервис песочница который позволяет хранить данные включая ассеты является https://plnkr.co/. Тут обычным перетаскиванием можно добавлять звуки и разные объекты тем самым сохранять весь проект целиком. копирование ссылки на dropbox

При работе вы можете пользоваться услугами github. Все что туда попадает, сохраняется навсегда. Если, допустим, произойдет сбой и папка git на жестком диске исчезнет, то данные в сервисе останутся и можно получить к ним доступ после восстановления работоспособности компьютера.