Как поделиться ссылкой на репозиторий github

Русские Блоги

Как загрузить код и поделиться проектами на Github

Во-первых, конечно, создать учетную запись github и войти в систему.https://github.comЕсть почтовый ящик, слегка

Затем вам необходимо установить программу Git локально по адресу:http://git-scm.com/downloads(Git можно понимать как svn и другие типы программного обеспечения для управления кодом), немного

Создать новый репозиторий

Введите имя и описание репозитория, выберите «Инициализировать этот репозиторий с помощью README».Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Получить проект

Сначала скопируйте адрес складаКак поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Нажмите «Вилка»Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

После переключения в рабочую область это D: \ workspaceGit

Загрузить обновление

Добавьте в проект код или файл проектаКак поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Добавить комментарий или описание

Используйте команду git для подключения к удаленному проекту

git remote add upstream https://github.com/waylau/go_for_java_programmers.git

Получить измененный код в файле, который не был изменен локально

Отправьте код. Аутентификация, вводим логин и пароль github

Источник

Работа с удалёнными репозиториями

Для того, чтобы внести вклад в какой-либо Git-проект, вам необходимо уметь работать с удалёнными репозиториями. Удалённые репозитории представляют собой версии вашего проекта, сохранённые в интернете или ещё где-то в сети. У вас может быть несколько удалённых репозиториев, каждый из которых может быть доступен для чтения или для чтения-записи. Взаимодействие с другими пользователями предполагает управление удалёнными репозиториями, а также отправку и получение данных из них. Управление репозиториями включает в себя как умение добавлять новые, так и умение удалять устаревшие репозитории, а также умение управлять различными удалёнными ветками, объявлять их отслеживаемыми или нет и так далее. В данном разделе мы рассмотрим некоторые из этих навыков.

Вполне возможно, что удалённый репозиторий будет находиться на том же компьютере, на котором работаете вы. Слово «удалённый» не означает, что репозиторий обязательно должен быть где-то в сети или Интернет, а значит только — где-то ещё. Работа с таким удалённым репозиторием подразумевает выполнение стандартных операций отправки и получения, как и с любым другим удалённым репозиторием.

Просмотр удалённых репозиториев

Если у вас больше одного удалённого репозитория, команда выведет их все. Например, для репозитория с несколькими настроенными удалёнными репозиториями в случае совместной работы нескольких пользователей, вывод команды может выглядеть примерно так:

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

Обратите внимание на разнообразие протоколов, используемых при указании адреса удалённого репозитория; подробнее мы рассмотрим протоколы в разделе Установка Git на сервер главы 4.

Добавление удалённых репозиториев

В предыдущих разделах мы уже упоминали и приводили примеры добавления удалённых репозиториев, сейчас рассмотрим эту операцию подробнее. Для того, чтобы добавить удалённый репозиторий и присвоить ему имя (shortname), просто выполните команду git remote add :

Получение изменений из удалённого репозитория — Fetch и Pull

Как вы только что узнали, для получения данных из удалённых проектов, следует выполнить:

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

Когда вы клонируете репозиторий, команда clone автоматически добавляет этот удалённый репозиторий под именем «origin». Таким образом, git fetch origin извлекает все наработки, отправленные на этот сервер после того, как вы его клонировали (или получили изменения с помощью fetch). Важно отметить, что команда git fetch забирает данные в ваш локальный репозиторий, но не сливает их с какими-либо вашими наработками и не модифицирует то, над чем вы работаете в данный момент. Вам необходимо вручную слить эти данные с вашими, когда вы будете готовы.

Начиная с версии 2.27, команда git pull выдаёт предупреждение, если настройка pull.rebase не установлена. Git будет выводить это предупреждение каждый раз пока настройка не будет установлена.

Отправка изменений в удаленный репозиторий (Push)

Когда вы хотите поделиться своими наработками, вам необходимо отправить их в удалённый репозиторий. Команда для этого действия простая: git push
. Чтобы отправить вашу ветку master на сервер origin (повторимся, что клонирование обычно настраивает оба этих имени автоматически), вы можете выполнить следующую команду для отправки ваших коммитов:

Просмотр удаленного репозитория

Это был пример для простой ситуации и вы наверняка встречались с чем-то подобным. Однако, если вы используете Git более интенсивно, вы можете увидеть гораздо большее количество информации от git remote show :

Удаление и переименование удалённых репозиториев

Если по какой-то причине вы хотите удалить удаленный репозиторий — вы сменили сервер или больше не используете определённое зеркало, или кто-то перестал вносить изменения — вы можете использовать git remote rm :

При удалении ссылки на удалённый репозиторий все отслеживаемые ветки и настройки, связанные с этим репозиторием, так же будут удалены.

Источник

Отправка первого локального проекта на GitHub

Рассмотрим отправку (push) своего первого проекта с локального компьютера в GitHub репозиторий.

Убедитесь, что git отслеживает ваш проект

Я использую Cmder и очень доволен данным терминалом. Также, если вы используете для разработки на PHP Open Server, то в нем есть встроенная консоль.

Вы не можете сделать это, просто открыв папку как обычно, вы должны сделать это с помощью командной строки / терминала.

Вы можете получить такое сообщение об ошибке:

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

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

Напоминаю, что проверить настройки Git и пользователя в Cmder можно командой:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий githubПроверяем пользователя git локального компьютера

Создайте удаленный репозиторий на Github

Подключите локальную папку проекта к вашему пустому хранилищу на Github

Сейчас на сайте github вы видите страницу у которой в заголовке написано: «Quick setup — if you’ve done this kind of thing before«.

Скопируйте ссылку в поле формы (input) прямо под заголовком, она должна выглядеть примерно так:

Это веб-адрес (ссылка), который будет использовать ваша локальная папка для отправки содержимого в удаленную папку на Github.

1. Вернитесь к своему проекту в терминале / командной строке.

2. В вашем терминале / командной строке введите:

3. Отправьте (сделайте пуш, push) вашей ветки в Github:

4. Вернитесь к экрану репозитория на Github, который вы только что оставили, и обновите его. Название «Quick setup — if you’ve done this kind of thing before«. Название должно исчезнуть, и вы должны увидеть свои файлы в репозитории.

Что лучше сделать перед отправкой локальных файлов

Перед отправкой локальных файлов в удаленный репозиторий лучше всего проиндексировать все файлы нашего нового проекта.

После команды git init мы можем командой git status увидеть, что не все файлы находятся в индексе.

Чтобы проиндексировать все файлы текущей папки мы вводим команду:

Точка означает текущую папку.

После того как все файлы проиндексированы мы должны закоммитить наши действия, т.е. зафиксировать:

Я бы посоветовал делать комментарий не на русском как в примере выше, а на английском. Это будет хорошей привычкой. Т.е. вместо «начало проекта» хорошо бы написать «start project».

Далее командой git status мы проверяем, что всё сделали правильно и видим такой экран:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Перечислю еще несколько полезных команд для работы с Гитом ниже.

Показывает историю коммитов.

Команда выше показывает через хеш коммита какие изменения были произведены.

Источник

Как выложить свой проект на GitHub.com

Если вы, как и я, решили освоить git, то скорее всего у вас возникнет желание разместить свой проект на GitHub.com для публичного доступа.

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

Два способа

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

Первый способ подходит для уже инициализированных удаленных репозиториев. Для связи GitHub с локальной копией, вначале следует клонировать гитхабовский репозиторий как локальный. Только после этого можно изменить локальный и отправить его на удалённый.

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

Регистрация на GitHub.com

Вначале нужно зарегистрироваться на GitHub.com. Процедура простая, не будем на ней останавливаться. После этого нужно создать репозиторий. В поле «Repository name» следует указать имя, которое в будущем будет совпадать с каталогом проекта. Это удобно, хотя, локальный каталог может быть любым. Пусть проект называется «demo».

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

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

Установка Git

Я всё ставил с официального сайта Git. Там же на сайте есть руководство Book, где описаны все начальне шаги. Поэтому будем считать, что git установлен и настроен.

Рассмотрим два способа отдельно.

Первый способ

Запускаем git-bash и клонируем удаленный репозиторий на локальную машину:

— где USER — ваше имя на гитхабе. Ссылку также можно скопировать со страницы репозитория в поле «HTTPS clone URL».

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Появится каталог /demo/ который создал git. Он должен быть пустой, кроме подкаталога «.git» — это служебный каталог, и его трогать не нужно.

Это добавит все файлы для отслеживания git’ом. Проверить состояние (до и после add) можно командой

Теперь делаем коммит (сообщение любое):

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

Для удобства можно сразу выставить метку версии (опять же любой вариант):

Теперь можно отправить изменения на гитхаб.

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

Git потребует ввести логин и пароль для GitHub.com. Учитывайте, что пароль полностью скрывается, поэтому не будет видно даже «звездочек». После ввода нажимаем Enter и git выполнит обновление удаленного репозитория.

Теперь нужно обновить метки на удаленном репозитории (если вы их задали).

Здесь также нужно будет ввести логин и пароль.

Всё, синхронизация выполнена! Временный каталог /demo-temp/ можно удалить или сохранить как старый резервный вариант.

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

Для настройки push, если требуется, пишем:

Второй способ

Наш проект может размещатся в любом каталоге. Для него нужно инициализировать git. Это стандартная процедура:

Теперь для проекта git работает и его можно использовать по своему усмотрению: добавлять версии, смотреть логи, делать ветки и т.п.

Для связи с GitHub’ом следует указать удаленный репозиторий:

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

Источник

Эффективное использование Github

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github
Github — важная часть жизни современного разработчика: он стал стандартом для размещения opensource-проектов. В «2ГИС» мы используем гитхаб для разработки проектов web-отдела и хостинга проектов с открытым кодом.

Хотя большинство из нас пользуются сервисом практически каждый день, не все знают, что у него есть много фишек, помогающих облегчить работу или рутинные операции. Например, получение публичного ключа из URL; отслеживание того, с каких сайтов пользователи приходят в репозиторий; правильный шаринг ссылок на файлы, которые живут в репозиториях гитхаба; горячие клавиши и тому подобное. Цель этой статьи — рассказать о неочевидных вещах и вообще о том, что сделает вашу работу с гитхабом продуктивнее и веселее (я не буду рассматривать здесь работу с API гитхаба, так как эта тема заслуживает отдельной статьи).

Содержание

Трюки с URL

Философия Github — быть простым, но в то же время очень гибким инструментом. Именно по этой причине многие функции недоступны из пользовательского интерфейса, но доступны через URL-параметры.

Доступ к публичным ключам

Доступ к diff’ам и patch’ам

Шаринг URL-ссылок на файлы в репозиториях

Тут на первый взгляд всё просто: скопировал ссылку на файл из адресной строки браузера, вставил куда надо. Но, ввиду динамичной природы проектов, коммиты в мастер добавляются постоянно, содержимое файла в будущем может измениться или файл может быть вовсе удалён, поэтому обычное копирование адресной строки браузера здесь не подходит. Чтобы получить постоянную ссылку на текущую версию файла (permanent link — так называет их Github), надо вместо названия ветки в URL использовать хеш коммита. Да, это довольно неудобно, поэтому ребята из гитхаба сделали горячую клавишу. Нажмите «y» при просмотре файла — URL в браузере будет изменён на permanent link.

Исключение пробельных симоволов при просмотре diff

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Подсветка определённого блока кода

При просмотре файла можно щёлкнуть по любой его строке и отправить кому-нибудь ссылку на указаное место. Можно выделить набор строк, добавив в URL после номера строки последний номер строки диапазона через знак «минус», вот так (обратите внимание на L30-L32 в конце URL): https://github.com/torvalds/linux/blob/9256d5a308c95a50c6e85d682492ae1f86a70f9b/include/uapi/linux/netfilter_bridge/ebt_among.h#L30-L32

Сравнение ревизий веток в репозитории

При создании пулл-реквеста сразу видно, какие изменения попадут в целевую ветку в результате слияния. Но есть неочевидная возможность страницы сравнения веток: мы можем посмотреть все изменения в ветке за определённое время, например, за две недели — https://github.com/github/linguist/compare/master@%7B2week%7D. master. Иногда полезно сделать закладку в браузере на страницу со сравнением и, если что-то идёт не так, оперативно проверять, что было изменено в коде, например, за последние сутки (“master@<1day>. master). Под капотом этой фичи используется стандартный git diff, поэтому можно использовать любой формат времени, который воспринимает git. Больше информации о сравнении веток, коммитов и тому подобного смотрите в документации.

Горячие клавиши

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

Активация нечёткого поиска файлов

Если нажать «t» при просмотре репозитория, появится строка поиска файлов, в которую можно ввести часть пути и выбрать необходимый файл, сэкономив минуты блуждания по репозиторию в поисках.

Быстрый переход к определённой строке в файле

Нажмите « l » при просмотре файла — появится маленькое окно для ввода номера строки.

Быстрые переходы к разделам Github

Эти комбинации легко запомнить: они начинаются с префикса «g» (go), и следующая за ним буква указывает на место назначения. gp — переход к списку пулл-реквестов, gi — список issues, gn — страница нотификаций и так далее.

Этот список горячих клавиш далеко не полон. Чтобы посмотреть все доступные хоткеи, нажмите «?».

Тикеты и пулл-реквесты

Тикеты (issues) и пулл-реквесты — неизменные помощники при ведении проекта. Гитхаб предоставляет множество средств для работы с ними. Можно использовать систему меток и каждому тикету или пулл-реквесту проставлять соответствующие им признаки, например, feature, bug, documentation. Также можно создать milestones и указывать, над каким тикетом в какой версии будет производиться работа. А ещё есть несколько забавных и полезных трюков.

Автоматическое закрытие issues с помощью коммитов

Если текст коммита, попадающего в основную ветку репозитория, содержит слова fix/resolve/close в разных вариациях и номер тикета после символа «#», тогда тикет с соответствующим номером будет закрыт.

То есть коммит с таким сообщением:

приведёт к такому результату:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Поиск самых любимых пулл-реквестов и тикетов

Эта функция появилась относительно недавно, когда гитхаб добавил реакции к комментариям. Теперь сортировка может учитывать количество emoji в реакциях. Соответственно, тип emoji для сортировки можно выбрать в меню «Sort»:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Github markdown

В гитхабе используется надмножество markdown-разметки, которое используется в комментариях и markdown-файлах. С его помощью можно делать кросс-ссылки между репозиториями или issues, создавать to-do списки, делать подсветку кода.

Кросс-ссылки

Если при создании тикета (issue) надо упомянуть другой тикет, можно ввести знак «#» — появится меню, из которого можно выбрать необходимый тикет; также можно написать номер тикета самостоятельно. При сохранении комментария со ссылкой соответствующее сообщение появится на странице упомянутого тикета. Если вы упомянули другой тикет из приватного репозитория, упоминание будет видно только тем, у кого есть доступ к этому репозиторию. При этом можно сделать ссылку не только на issue, но и на конкретный коммит, просто указав его хеш — Github автоматически превратит его в правильную ссылку.

Подсветка синтаксиса

Для того чтобы подсветить кусок кода в вашей markdown-разметке, введите название языка после тройной обратной кавычки перед блоком кода и тройную обратную кавычку в конце блока:

To-do списки

Синтаксис у списка to-do такой:

При сохранении комментария со списком он превращается в полноценный список задач с чекбоксами, которые можно отмечать (при этом соответствующий [x] появляется в markdown-разметке автоматически). Вот хороший пример работы со списками: https://github.com/neovim/neovim/pull/243

В общем, обязательно загляните в справку гитхаба — Github flavored markdown — там есть ещё пара интересных трюков.

Аккаунт

Двухфакторная аутентификация и безопасность

Привязка нескольких почтовых адресов к одному аккаунту

Если вы подтвердите эти email’ы, то с их помощью можно будет получить доступ к вашему аккаунту (восстановление пароля). Если же вы хотите сделать просто ассоциацию email’а с вашим аккаунтом без фичи восстановления пароля — просто не подтверждайте этот ящик. Саппорт гитхаба посоветовал сделать именно так.

Сохранённые ответы (Saved replies)

Эта функция особенно полезна для тех, кто часто пишет однотипные комментарии к пулл-реквестам или тикетам. Например, о том, что пулл-реквест должен соответствовать правилам, определённым в contributing.md. Можно сохранить набор ответов и быстро вставлять их через меню редактора Github:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Упоминания (mentions)

Эта популярная функция по механике похожа на упоминания на хабрхабре или в твиттере. При создании комментария введите символ «@» и сразу же после него никнейм пользователя. У упомянутого пользователя на странице оповещений появится соответствующая ссылка на тикет или пулл-реквест, в котором его упомянули.

Упоминания доступны не только для конкретного пользователя, но и для группы пользователей в организации. В этом случае после «@» надо ввести название организации и через слеш название команды — например, @2gis/mamonts. Добавление новой команды доступно через вкладку Teams на главной странице организации.

Ответы на email-оповещения Github

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

Подписка на публичную активность пользователей

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

Служебные директории и файлы Github

Если в корне вашего проекта есть readme-файл, его содержимое будет отображаться под списком файлов. Это знают многие. Но не все знают, что если создать файл contributing.md с рекомендациями по улучшению проекта, ссылка на него будет доступна на странице создания пулл-реквеста или открытия тикета:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

После закрытия code.google.com множество проектов переехало на Github. В связи с этим на гитхаб посыпалось множество запросов по улучшению сервиса (да, это всего лишь мои догадки, но не исключено, что это событие в какой-то степени послужило катализатором). Одним из запросов было создание шаблонов при открытии тикетов. Недавно гитхаб реализовал эту возможность.

Создайте внутри корня проекта файл с названием ISSUE_TEMPLATE, и его содержимое будет автоматически вставляться в поле для ввода при открытии нового тикета. То же самое работает и для пул-реквестов, в этом случае файл должен называться PULL_REQUEST_TEMPLATE. Файлы могут быть в формате markdown.

Вот пример шаблона из репозитория React — https://github.com/facebook/react/blob/20bcabb1ea4cf492ade240bd6915b4bd44f04895/.github/ISSUE_TEMPLATE.md. Если попробовать открыть тикет в их репозитории, поле для ввода текста уже будет заполнено полезной информацией:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Статистика языков программирования

На главной странице репозитория в виде цветной полосы отображается статистика используемых в данном репозитории языков. Если щёлкнуть по ней, отобразятся доли в процентах:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Если вы используете в своём проекте какой-нибудь большой js-фреймворк и не хотите, чтобы он отъел 70% у вашего любимого Go/Python/Java/Ruby в статистических данных репозитория, создайте директорию vendors и положите туда все зависимости, которые не должны учитываться системой статистики гитхаба. Или проверьте наличие того файла или директории, от которого вы хотите избавиться в статистистических данных здесь — вполне возможно, что вам уже ничего не надо делать

Да, если языки в проекте определяются не так, как надо, то в этом случае стоит посмотреть в linguist. Linguist — это ruby-библиотека, с помощью которой гитхаб собирает статистику по используемым языкам. В readme проекта описаны разные способы переопределения определяемого файла.

Метрики репозитория

Гитхаб предоставляет множество метрик для отслеживания работы, происходящей в репозитории. Соответствующие инструменты мониторинга находятся на вкладках Pulse и Graph. Pulse показывает, что происходило в репозитории в определённый период времени. В разделе Graph разные показатели отражены в виде графиков. У владельцев репозиториев во вкладке Graph также появляется подпункт Traffic. По большому счёту это мини google analytics для репозитория: в нём можно отслеживать, сколько пользователей было в вашем репозитории и откуда они пришли.

Создание нового репозитория

При создании репозитория можно сразу выбрать, какой gitignore-файл необходим, какая лицензия будет у проекта и нужна ли заготовка для readme-файла. Так вы сэкономите немного времени на начальной стадии подготовки проекта:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Если вашего типа проекта нет в списке gitignore, тогда следует эту ситуацию улучшить и предложить пулл-реквест в репозиторий gitignore гитхаба.

Поиск кода

Ещё одна неочевидная возможность гитхаба — продвинутый поиск кода по всем репозиториям: https://github.com/search:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

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

При поиске действуют ограничения, которые стоит учитывать, если вы ведёте проект на гитхабе и хотите, чтобы сервис мог проиндексировать ваш код (или, наоборот, если не хотите): индексируется только главная ветка репозитория (обычно это master); индексируются только те файлы, которые меньше 384 KB; индексируются только те репозитории, в которых менее 500 000 файлов.

Командная строка и Github

Hub — это консольная утилита от создателей гитхаба (git + hub = github), цель которой облегчить использование сервиса из шелла. По сути, hub оборачивает стандартный git и предоставляет дополнительные команды для работы с репозиториями, пулл-реквестами и тикетами.

Вот так можно склонировать репозиторий:

Авторы утилиты советуют после установки сделать алиас на hub при вызове git (alias git=hub), так как команды hub не конфликтуют со стандартными командами git.

Больше информации по работе с утилитой можно найти в man или на сайте проекта.

Пулл-реквесты уже в вашем репозитории

Интересный момент, о котором знают немногие. При создании пулл-реквеста все содержащиеся в нём изменения автоматически попадают в ваш репозиторий, так как пулл-реквест по большому счёту — особая ветка. Благодаря этой возможности гитхаб может показывать изменения в пулл-реквесте, даже если исходный форк был удалён. Таким образом, у вас всегда есть к ним доступ. Чтобы изменения из пулл-реквеста попали в новую ветку (new_branch), надо выполнить команду:

— номер пулл-реквеста из URL.

User scripts

User script — это пользовательский JavaScript-код, который изменяет определённый сайт/веб-приложение, изменяя его внешний вид и/или добавляя новые функции. Есть довольно много скриптов, предназначенных для работы с гитхабом. В каталоге много устаревших скриптов, но среди них попадаются довольно современные и полезные.

Github Commit Whitespace

Github Commit Whitespace просто добавляет на страницу сравнений ссылку, с помощью которой можно быстро исключить из diff изменённые пробельные символы:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Github News Feed Filter

Github News Feed Filter будет особенно полезен тем, кто мониторит (watch) много активных репозиториев/пользователей. Этот скрипт добавляет на главную страницу с лентой событий фильтр, позволяющий отображать только интересущую активность:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Github-вандализм

Gitfiti

Да, это вовсе не про эффективную работу, а про штуки, которые находчивые разработчики используют для забавы. А именно, вот эти квадратики, показывающие ваш вклад на протяжении года — contribution graph:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Манипулируя git-репозиторием, добавляя коммиты в определённые даты в определённом количестве, можно немного разнообразить диаграмму. Например, вот так:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

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

Замена автора коммита

В git есть возможность исправления автора коммита через

В результате коммит в гитхабе будет отображён с новым автором и его аватаркой:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Ничего страшного в этом нет, тем более что в апреле Github добавил проверку подлинности автора коммита по GPG-подписи. Если вы видите слово «verified» рядом с коммитом, значит автор коммита именно этот человек, а не кто-то другой:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Дополнительные Github-ресурсы

Рейтинги репозиториев

Источник новых инструментов и библиотек — страница https://github.com/explore. Здесь размещены разные подборки репозиториев, репозитории, которые были добавлены в избранное теми людьми, на которых вы подписаны, и, конечно же, самые популярные репозитории за последнее время.

Статус сервиса

Довольно редко, но бывает, что гитхаб работает нестабильно. Основной ресурс, где можно узнать, что пошло не так — https://status.github.com/. Там можно найти разные метрики, отражающие состояние здоровья гитхаба и все оповещения о перебоях в работе сервиса.

Github pages

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

Gist можно использовать на сторонних ресурсах. Многие используют его для подсветки синтаксиса кусков кода в статических блогах или на Medium. Для получения кода скрипта gist, который можно встроить на страницу, надо выбрать Embed из меню выбора вида URL на репозиторий:

Как поделиться ссылкой на репозиторий github. Смотреть фото Как поделиться ссылкой на репозиторий github. Смотреть картинку Как поделиться ссылкой на репозиторий github. Картинка про Как поделиться ссылкой на репозиторий github. Фото Как поделиться ссылкой на репозиторий github

Dotfiles

На http://dotfiles.github.io/ вы можете найти качественные подборки настроек Unix-систем на любой вкус.

Octodex

А вот на https://octodex.github.com/ просто живёт много октокотов. Ничего больше. КДПВ мы взяли оттуда.

Полезные ссылки

Github предоставляет очень много возможностей, и описать их все в рамках одной статьи — серьёзная задача. Тем не менее надеюсь, что этот материал послужит хорошим источником новых знаний и воодушевит вас исследовать Github дальше.

Напоследок вот несколько наиболее интересных ресурсов, которые помогут вам в этом путешествии:

Изображение для обложки статьи — the Steroidtocat by James Kang

Источник

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *