код аккаунта на github
Кастомизация профиля GitHub: Readme
Летом 2020 года на GitHub появилась возможность добавить Readme для своего профиля. Эта новость как-то обошла стороной Habr, поэтому сделаю небольшой обзор данной фичи.
Зачем это нужно?
Данная фича позволяет кастомизировать свой профиль на Github и сделать его более персонифицированным.
Создание Readme для профиля
Для этого необходимо добавить файл README в корень публичного репозитория, название которого совпадает с вашим именем пользователя. В результате README автоматически появится на странице вашего профиля.
При создании вы увидите плашку, сообщающую что вы нашли новую функцию и что это специальный репозиторий.
Далее вы можете использовать разметку Markdown (GitHub Flavored Markdown) для того чтобы соответствующим образом оформить свой профиль.
Проявив немного фантазии и задействовав Github Actions можно сделать ваш профиль довольно интересным. Например динамически обновлять информацию, подгружая её со сторонних сервисов посредством API.
Таким образом GitHub становится еще больше похожим на соцсеть, хоть и для IT специалистов или людей близких к IT.
Не могу обойти стороной репозиторий Awesome GitHub Profile README, там можно поискать идеи для оформления своего профиля.
Или же просто посмотреть как выглядят креативно оформленные профили других пользователей.
Так-же несколькими из пользователей Github создан проект упрощающий создание файла Readme.
На этом пожалуй закончу, удачи в оформлении профиля GitHub!
Upd: Дополнил опрос вариантами
Краткая инструкция, как заливать на Github коды собственных программ
GitHub — это специализированное облачное решение, где разработчики могут сохранять файлы своего программного продукта, чтобы работать над ними совместными усилиями.
Как залить код на GitHub
Для того чтобы залить код на GitHub, нужно будет пройти несколько этапов, на которых мы остановимся чуть ниже.
Как зарегистрироваться на GitHub
Во-первых, не нужно путать Git и GitHub — это разные инструменты, делающие одно дело : они контролируют версии программного продукта. Их различие в том, что:
Чтобы зарегистрироваться на GitHub, нужно перейти по адресу github.com. Там необходимо будет пройти простую регистрацию и верифицировать свою электронную почту. Данный ресурс предложит вам 2 вида аккаунтов:
После регистрации и верификации не лишним будет заполнить свой профиль:
Это нужно сделать тем, кто открыт к новым проектам и не прочь поработать. По GitHub «ходят» IT-рекрутеры, которые могут предложить вам поучаствовать в интересных проектах. Но для того чтобы они вас смогли найти, у вас должен быть заполнен профиль.
Как добавить новый репозиторий, чтобы залить код на GitHub
В данном случае репозиторий — это небольшое хранилище, куда вы сможете выложить свой код. Бесплатный тариф дает вам возможность создавать неограниченное количество репозиториев, однако хранилища будет только 500 Мб. Но даже этого места более чем достаточно для старта или для того, чтобы попробовать возможности GitHub.
На этом этапе вы можете сделать свой проект публичным или прив а тным, а также «прикрепить» дополнительную техническую информацию, например:
Если вы не понимаете, что это за техническая информация, то пока можно эту документацию оставить пустой.
Как перенести облачный репозиторий на компьютер
Для того чтобы залить код на GitHub, на этом этапе нужно будет скачать и установить программу GitHub Desktop. Данная программа способна наладить синхронизацию между вашим компьютером и ГитХабом, чтобы вы смогли выложить туда код, не используя Консоль. Скачать эту программу можно по адресу desktop.github.com.
Чтобы все прошло как по маслу, нужно:
Если все сделали правильно, то программа произведет синхронизацию с вашим аккаунтом на GitHub и попроси т выбрать необходимое действие:
Как залить код на GitHub через локальный репозиторий
Заключение
При помощи программы GitHub Desktop можно эффективно управлять своими проектами на ГитХабе, создавая новые репозит о рии, новые ветки в проекте, внося изменения в проект прямо в компьютере и при этом не посещая сам ресурс.
Теперь вы знаете, как залить код на GitHub при помощи программы, которую нужно установить на компьютер. Если не хотите использовать эту программу, можно залить код на ГитХаб прямо в самом аккаунте. Для этого также нужно будет создать новый репозиторий вашего проекта и перенести туда «руками» код вашей программы.
Мы будем очень благодарны
если под понравившемся материалом Вы нажмёте одну из кнопок социальных сетей и поделитесь с друзьями.
Регистрация на Гитхабе. Работа через консоль
Гитхаб — крупнейший веб-сервис для хостинга IT-проектов и их совместной разработки. Он как раз и основан на системе контроля версий Гит. Кроме размещения кода участники могут общаться, комментировать правки друг друга, а также следить за новостями знакомых. Именно в нём работаем мы в Академии и ученики на интенсивах.
Регистрация и установка
Устанавливаем Гит
Если до этого вы не работали с Гитом, то его нужно установить. Рассмотрим, как это сделать в популярных операционных системах.
Установка в Linux
Установка на Mac
Сперва устанавливаем Homebrew если он у вас ещё не стоит. Также вы можете установить его с помощью команды:
Эта команда установит Гит на ваш компьютер.Чтобы прописать новый путь к установке Гит введите команду: export PATH=/usr/local/bin:$PATH
Установка в Windows
Здесь всё просто. Просто скачайте exe-файл инсталлятора со страницы проекта на Гитхабе и запустите его.
После установки у вас будет как консольная версия (включающая SSH-клиент, который пригодится позднее), так и стандартная графическая.
Регистрация на Гитхабе
Чтобы начать работать с Гитхабом, нужно зарегистрироваться на нём, если вы ещё этого не сделали. Регистрация предельно проста:
Начинаем работу
Устанавливаем SSH-ключи
SSH-ключ нужен чтобы быстро устанавливать соединение с Гитхабом, не вводя пароля. Кроме того, SSH — единственный из сетевых протоколов, предоставляющий доступ и на чтение, и на запись. Два других сетевых протокола (HTTP[S] и Git) в большинстве случаев дают доступ только на чтение, поэтому даже если они вам доступны, вам всё равно понадобится SSH для записи. К тому же SSH — протокол с аутентификацией и шифрованием трафика, что называется «из коробки». Недостаток SSH в том, что, используя его, вы не можете обеспечить анонимный доступ к репозиторию.
Доступ к удалённому репозиторию по SSH — самый распространённый вариант настройки удалённого доступа, быстрый, удобный и безопасный. Настроив авторизацию в SSH по ключам, вы будете избавлены от необходимости вводить пароли для доступа к репозиторию, сохраняя, однако, приемлемый уровень безопасности.
«eval» не является внутренней или внешней командой, исполняемой программой или пакетным файлом.
Если проблема осталась, то рекомендуем воспользоваться программой Git Bash.
Примечание: если вы используете macOS Sierra 10.12.2 или более позднюю версию, то вам нужно будет модифицировать ваш
/.ssh/config файл, чтобы автоматически загрузить ключи в ssh-agent и хранить пароли.
Добавляем ключ на Гитхаб
Результат проверки добавления ключа
Теперь можно клонировать любой доступный репозиторий используя его SSH-ссылку.
Клонируем репозиторий по SSH-ссылке
Более подробное описание работы с Гитхабом мы рассмотрим в статье «Pабота с Гит через консоль»
Как начать работать с GitHub: быстрый старт
Распределенные системы контроля версий (DVCS) постепенно замещают собой централизованные. Если вы еще не используете одну из них — самое время попробовать.
В статье я постараюсь показать, как можно быстро начать экспериментировать с git, используя сайт github.com.
В статье не будут рассмотрены различия между разными DVCS. Также не будет детально рассматриваться работа с git, по этой теме есть множество хороших источников, которые я приведу в конце статьи.
Итак, сайт github.com позиционируется как веб-сервис хостинга проектов с использованием системы контроля версий git, а также как социальная сеть для разработчиков. Пользователи могут создавать неограниченное число репозиториев, для каждого из которых предоставляется wiki, система issue tracking-а, есть возможность проводить code review и многое другое. GitHub на данный момент является самым популярным сервисом такого рода, обогнав Sourceforge и Google Code.
Для open-souce проектов использование сайта бесплатно. При необходимости иметь приватные репозитории, есть возможность перейти на платный тарифный план:
Начнем с регистрации. Идем по ссылке github.com/signup/free и вводим свои данные.
После регистрации мы попадаем на Dashboard нашего аккаунта:
Сейчас у нас нет ни одного репозитория, и мы можем либо создать новый репозиторий, либо ответвиться (fork) от уже существующего чужого репозитория и вести собственную ветку разработки. Затем, при желании, свои изменения можно предложить автору исходного репозитория (Pull request).
Но для начала установим git и настроим его для работы с сайтом.
Если вы работаете в Windows, качаем и устанавливаем msysgit. Это консольная версия git для Windows (далее расказ будет вестись на примере этой ОС).
Инструкция для MacOS X (eng)
Инструкция для Linux (eng)
Проблем возникнуть не должно, просто везде жмем Next. После установки выбираем в контекстном меню Проводника Git Bash:
или через Git Bash.lnk в папке с установленой программой:
Кстати, рекомендую пройти неплохой интерактивный курс по использованию git из консоли. Курс проходится за несколько часов и дает необходимые базовые навыки.
Качаем по ссылке code.google.com/p/tortoisegit/downloads/list. При установке везде жмем Next.
Теперь возвращаемся к github и создадим новый репозиторий. Находясь на Dashboard, жмем New Repository (https://github.com/repositories/new), вводим данные и жмем Create Repository.
GitHub позволяет работать с репозиториями тремя способами: SSH, HTTP и Git Read-Only, соответственно предоставляя ссылки трех видов для нашего репозитория:
1. git@github.com:habrauser/Hello-world.git
2. habrauser@github.com/habrauser/Hello-world.git
3. git://github.com/habrauser/Hello-world.git
Для того, чтобы просто забрать репозиторий на локальную машину, достаточно внутреннего протокола git (третья ссылка). Это наиболее быстрый и эффективный способ, который обеспечивает анонимный доступ только для чтения.
Если же мы захотим внести изменения в репозиторий на github, нужно пользоваться HTTP или SSH.
Работа по http никаких трудностей не вызывает, в нужный момент просто используется пароль учетной записи на github.
Чтобы использовать SSH, нам нужно создать специальную пару ключей: публичный и приватный. Публичный будет размещен в настройках аккаунта на github, а приватный сохранен на локальной машине.
Для генерации ключей, можно воспользоваться инструментом ssh-keygen, который идет в комплекте с git (описание этого способа можно почитать тут). Мы же будем использовать PuTTY (а точнее небольшую программку puttygen, входящую в его состав). PuTTY — это такой клиент для удаленного доступа, в том числе и с использованием SSH.
Качаем последнюю версию с официального сайта (http://www.chiark.greenend.org.uk/
sgtatham/putty/download.html). Кстати, puttygen более старой версии (2007 год) идет в составе TortoiseGit.
После установки PuTTY, запускаем puttygen из папки с установленной программой:
Жмем Generate, двигаем некоторое время курсором мыши, для получения случайных данных, необходимых алгоритму
Вводим пароль, защищающий наш приватный ключ в поле Key passphrase, вводим подтверждение, жмем Save private key, сохраняем.
Далее копируем публичный ключ в формате OpenSSH из текстовой области «Public key for pasting. » и идем в настройки нашего аккаунта на github (Account Settings) в раздел SSH Public Keys:
жмем Add another public Key, вставляем наш публичный ключ:
нажимаем Add key. Все, теперь мы готовы работать с github по ssh. Попробуем забрать наш пустой рерозиторий на локальную машину с использованием TortioшseGit. В контекстном меню проводника выбираем Git Clone…
В поле Url вставляем SSH-адрес нашего репозитория, в поле Load Putty Key указываем путь к нашему приватному ключу, жмем OK.
Pageant запросит у наc пароль для приватного ключа (потом этого делать не потребуется)
Pageant — это агент SSH-аутентификации в составе PuTTY, он позволяет управлять закрытыми ключами.
В трее висит его значек:
Репозиторий успешно склонирован на локальную машину
Теперь попробуем изменить локальный репозиторий и отправить изменения на github. Добавим в локальный репозиторий файл README (файл с именем README обрабатывается github специальным образом — его содержимое будет отображаться в качестве описания репозитория на соответствующей странице)
Закоммитим изменения в локальный репозиторий
и синхронизируем его с репозиторием на github:
нажимаем Push
Теперь зайдя на страницу нашего репозитория мы увидим следующее:
Для каждого репозитория сайт предлагает wiki:
а также простую систему issue tracking-a:
кстати, для тех, кто использует в работе Eclipсe — есть соответствующий mylyn-коннектор для github:
и плагин EGit:
По ссылке Explore GitHub открывается каталог репозиториев, в котором можно искать по множеству других критериев, в том числе по языкам программирования, популярности и т.п.
Инструкция по оформлению профиля на GitHub
Правильно оформленный профиль на GitHub очень важен для поиска работы: для интервьюера это единственная возможность увидеть ваш код и оценить вас в деле. Мы попросили Георгия Бабаяна, основателя и CEO школы программирования Elbrus Bootcamp, рассказать, как оформить профиль, чтобы показать себя с лучшей стороны.
CEO Elbrus Coding Bootcamp
GitHub — это лицо программиста. Портфолио демонстрирует как ваши технические навыки, так и soft skills: умение заботиться о пользователе, писать документацию и другие полезные в командной работе навыки. В инструкции я собрал 10 правил и 7 ловушек GitHub, которые нужно знать каждому программисту, который хочет найти хорошую работу.
10 правил оформления профиля на GitHub
Хорошая фотография
Заметная и хорошо читаемая фотография помогает расположить к вам посетителя профиля. Выбирайте снимок с лицом крупным планом и нейтральным фоном.
Имя и фамилия
Обязательно напишите свои имя и фамилию, а не только никнейм, чтобы профиль легко было сопоставить с резюме.
Адрес электронной почты
Убедитесь, что email для связи с вами доступен всем. Для этого зайдите в настройки профиля: там есть специальная кнопка «сделать публичным». Избегайте адресов в духе sexybaby@mail.ru — используйте ящик в доменной зоне.com с понятным неймингом. Не делайте публичным email, который привязан к вашему аккаунту GitHub: это повышает вероятность взлома аккаунта и демонстрирует слабое владение правилами безопасности в интернете.
Биография
Многие игнорируют этот раздел, а зря. Напишите немного о том, какими технологиями вы занимаетесь и что вам интересно. Тогда тот, кто просматривает ваш код, будет понимать, на что смотреть.
Ссылка на соцсеть
Добавьте ссылку на профессиональную соцсеть, которую вы ведёте наиболее активно и подробно.
Репозитории
Прикрепляйте только те репозитории, которые вы хотите показать будущему работодателю. Удалите «детские» проекты! Никому не интересно смотреть на «Hello, world!».
Если репозитория ещё нет, сделайте проект сами: создайте чат-бот или простое приложение о погоде — что-то, что поможет увидеть вас в деле.
Забота о читателе
Интервьюеру тяжело: каждый день он смотрит десятки профилей, поэтому опишите каждый проект как можно понятнее. Хороший способ — поставить перед названиями проектов эмодзи, которые помогут сразу понять суть проекта: например, джойстик для игры или вилку с ножом для сервиса бронирования столиков.
README
Обязательно сделайте файл Readme внутри проекта. Опишите проект одним предложением, а затем расскажите в одном абзаце о том, какую цель ставили, что делает ваша разработка и так далее. Так вы покажете рекрутеру умение формулировать мысли и писать документацию и продемонстрируете, что работать с вами будет легко.
Команда
Если вы делали проект вместе с командой, проявите уважение: добавьте ссылки на репозитории других авторов проекта.
Визуализация
Идеально, если у вас получится прикрепить к проекту гифку или видео, которое показывает, как всё работает.
7 ловушек GitHub — ошибки в оформлении, которые часто делают программисты
Неочевидная команда запуска
Напишите код, который запускает ваше приложение. Некоторые программисты считают, что npm init и npm start — это очевидные команды, но не стоит забывать о том, что очевидное вам вовсе не обязательно будет понятно тому, кто читает ваш проект.
Мусор в коде
Уберите отовсюду консоль-логи, принты, выводы ошибок и глупые комментарии. Как-то раз я собеседовал на должность преподавателя приятного кандидата и уже собирался предложить ему работу. А затем обнаружил в его коде функцию, которая не делала ничего. Рядом с ней красовался комментарий: «Нужно удалить».
Ошибки в коде
Обязательно прогоните код через линтер: он проверит код на ошибки, укажет на баги и найдёт подозрительные конструкции.
Ключи и пароли в коде
Непонятные коммиты
Начинайте свой коммит с того, что вы что-то добавили, удалили или изменили. Затем напишите, что получилось в результате. Проверьте себя: читая хороший коммит, посторонний человек может понять, что было сделано и зачем. Например: изменили функцию, которая не позволяла отправить письмо.
Низкая активность
Очень важно постоянно держать зелёным ваш график активности («contributions»). Чтобы не создавалось впечатления, что вы не работаете, создайте специальную папку «Мои решённые алгоритмы». Добавляйте в неё всю релевантную активность: «алгоритм решения судоку», «алгоритм сортировки», чтобы было видно, что вы постоянно что-то делаете.
Плохой стиль
Соблюдайте стайлгайд своего языка — PEP8 для Python, Airbnb Style Guide для JavaScript, Airbnb Ruby Styleguide для Ruby и так далее. Так вы продемонстрируете заботу о комфорте коллег и уважение к принятым в сообществе нормам.
Хинт для программистов: если зарегистрируетесь на соревнования Huawei Cup, то бесплатно получите доступ к онлайн-школе для участников. Можно прокачаться по разным навыкам и выиграть призы в самом соревновании.
Перейти к регистрации