В этом руководстве вы узнаете, как настроить учетную запись GitHub и приступить к работе с функциями GitHubдля совместной работы и сообщества.
Часть 1. Настройка учетной записи GitHub
Для начала с GitHub необходимо создать учетную запись, выбрать продукт, соответствующий вашим потребностям, проверить электронную почту, настроить двухфакторную проверку подлинности и просмотреть профиль.
Существует несколько типов учетных записей на GitHub. Каждый пользователь, использующий GitHub, имеет собственный личная учетная запись, который может быть частью нескольких организаций и команд. Ваш личная учетная запись — это ваше удостоверение на GitHub.com и представляет вас в качестве отдельного человека.
1. Создание учетной записи
Чтобы зарегистрироваться для учетной записи, перейдите к https://github.com/ запросу и следуйте инструкциям.
Чтобы обеспечить безопасность учетной записи GitHub необходимо использовать надежный и уникальный пароль. Дополнительные сведения см. в разделе Создание надежного пароля.
2. Выбор продукта GitHub
Вы можете выбрать GitHub Free или GitHub Pro, чтобы получить доступ к различным функциям своей личной учетной записи. Вы можете выполнить обновление в любое время, если вы не уверены, какой продукт хотите использовать.
Дополнительные сведения обо всех планах GitHubсм. в разделе Планы GitHub.
3. Подтверждение вашего адреса электронной почты
Чтобы обеспечить использование всех функций в плане GitHub проверьте адрес электронной почты после регистрации новой учетной записи. Дополнительные сведения см. в разделе Подтверждение адреса электронной почты.
4. Настройка двухфакторной проверки подлинности
Двухфакторная проверка подлинности — это дополнительный слой обеспечения безопасности, используемый при входе на веб-сайты или в приложения. Мы настоятельно рекомендуем настроить 2FA для безопасности вашей учетной записи. Дополнительные сведения см. в разделе Двухфакторная проверка подлинности.
При необходимости после настройки 2FA добавьте ключ доступа в учетную запись, чтобы включить безопасное, без пароля имя входа. См . раздел AUTOTITLE.
5. Просмотр профиля GitHub и диаграмма вкладов
Ваш профиль GitHub сообщает людям о своей работе через репозитории и gists, которые вы закрепили, членства в организации, которые вы выбрали для публикации, внесенных вами вкладов и созданных проектов. Дополнительные сведения см. в разделе [AUTOTITLE и Сведения о профиле](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/viewing-contributions-on-your-profile).
Часть 2. Использование средств и процессов GitHub
Чтобы лучше всего использовать GitHub, необходимо настроить Git. Git отвечает за все GitHub, которые выполняются локально на компьютере. Чтобы эффективно взаимодействовать с переменными данных.product.github %}, вы напишете проблемы и запросы на вытягивание с помощью GitHub в формате Markdown.
1. Изучение Git
Совместный подход к разработке GitHubзависит от фиксаций публикации из локального репозитория до GitHub для просмотра, получения и обновления с помощью Git. Дополнительные сведения о Git см. в руководстве по Git. Дополнительные сведения об использовании Git в GitHubсм. в разделе GitHub flow.
2. Настройка Git
Если вы планируете использовать Git локально на своем компьютере, будь то через командную строку, IDE или текстовый редактор, вам необходимо будет установить и настроить Git. Дополнительные сведения см. в разделе Настройка Git.
Если вы предпочитаете использовать визуальный интерфейс, вы можете скачать и использовать GitHub Desktop. GitHub Desktop поставляется в комплекте с Git, поэтому нет необходимости устанавливать Git отдельно. Дополнительные сведения см. в разделе Начало работы с GitHub Desktop.
После установки Git можно подключиться к репозиториям GitHub на локальном компьютере, независимо от того, является ли ваш собственный репозиторий или вилку другого пользователя. При подключении к репозиторию на GitHub.com из Git необходимо выполнить проверку подлинности с помощью GitHub с помощью ПРОТОКОЛА HTTPS или SSH. Дополнительные сведения см. в разделе Сведения об удаленных репозиториях.
3. Выбор взаимодействия с GitHub
Каждый имеет собственный уникальный рабочий процесс для взаимодействия с GitHub; интерфейсы и методы, которые вы используете, зависят от ваших предпочтений и того, что лучше всего подходит для ваших потребностей.
Дополнительные сведения о различных подходах к взаимодействию с переменными данных.product.github %}, а также сравнение используемых средств см. в разделе Подключение к GitHub.
4. Запись на GitHub
Чтобы сделать взаимодействие понятным и упорядоченным в проблемах и запросах на вытягивание, можно использовать GitHub Flavored Markdown для форматирования, который объединяет простой и простой для записи синтаксис с некоторыми настраиваемыми функциональными возможностями. Дополнительные сведения см. в разделе О написании и форматировании на GitHub.
Вы можете узнать GitHub С помощью курса "Обмен данными" с помощью курса Markdown на GitHub Skills.
5. Поиск по GitHub
Наш интегрированный поиск позволяет найти то, что вы ищете среди многих репозиториев, пользователей и строк кода на GitHub. Вы можете выполнять глобальный поиск по всем GitHub или ограничить поиск определенным репозиторием или организацией. Дополнительные сведения о типах поисковых запросов, которые можно выполнить на GitHub, см. в разделе О поиске на GitHub.
Наш синтаксис поиска позволяет вам составлять запросы, используя квалификаторы, чтобы указать, что необходимо найти. Дополнительные сведения о синтаксисе поиска, используемом в поиске, см. в разделе Поиск на GitHub.
6. Управление файлами на GitHub
С помощью GitHubвы можете создавать, изменять, перемещать и удалять файлы в репозитории или в любом репозитории, в который у вас есть доступ на запись. Вы также можете отслеживать историю изменений в файле построчно. Дополнительные сведения см. в разделе Управление файлами.
Часть 3. Совместная работа с переменными данных.product.github %}
Любое количество людей может работать вместе в репозиториях в GitHub. Вы можете настроить параметры, создать проекты и управлять уведомлениями, чтобы стимулировать эффективную совместную работу.
1. Работа с репозиториями
Создание репозитория
Репозиторий подобен папке для вашего проекта. У вас может быть сколько угодно публичных и приватных репозиториев в вашей личной учетной записи. Репозитории могут содержать папки и файлы, изображения, видео, электронные таблицы и наборы данных, а также журнал изменений для всех файлов в репозитории. Дополнительные сведения см. в разделе Сведения о репозиториях.
При создании нового репозитория необходимо инициализировать репозиторий с файлом README, чтобы сообщить людям о вашем проекте. Дополнительные сведения см. в разделе Создание репозитория.
Клонирование репозитория
Вы можете клонировать существующий репозиторий из GitHub на локальный компьютер, что упрощает добавление или удаление файлов, исправление конфликт слияния или сложные фиксации. При клонировании репозитория извлекается полная копия всех данных репозитория, которые GitHub содержит на данный момент времени, включая все версии каждого файла и папки для проекта. Дополнительные сведения см. в разделе Клонирование репозитория.
Создание вилки репозитория
Вилка — это копия репозитория, которым вы управляете, где любые изменения, которые вы вносите, не повлияют на исходный репозиторий, если только вы не отправите запрос на вытягивание владельцу проекта. Чаще всего вилки используются либо для того, чтобы предложить изменения в чужом проекте, либо для того, чтобы использовать чужой проект в качестве отправной точки для вашей собственной идеи. Дополнительные сведения см. в разделе Работа с вилками.
2. Импорт ваших проектов
Если у вас есть существующие проекты, которые вы хотите перейти на GitHub можно импортировать проекты с помощью GitHub Importer, командной строки или внешних средств миграции. Дополнительные сведения см. в разделе Импорт исходного кода.
3. Управление участниками совместной работы и разрешениями
Вы можете совместно работать с проектом с другими пользователями с помощью проблем с репозиторием, запросов на вытягивание и проекты. Вы можете пригласить других людей в свой репозиторий в качестве участников совместной работы на вкладке Участники совместной работы в настройках репозитория. Дополнительные сведения см. в разделе Приглашение участников совместной работы в личный репозиторий.
Вы являетесь владельцем любого репозитория, созданного вами в учетной записи, и имеете полный контроль над ним. Участники совместной работы имеют доступ на запись в ваш репозиторий, что ограничивает их имеющиеся разрешения. Дополнительные сведения см. в разделе Уровни разрешений для репозитория личной учетной записи.
4. Управление параметрами репозитория
Как владелец репозитория, вы можете настроить несколько параметров, включая видимость репозитория, темы и предварительный просмотр в социальных сетях. Дополнительные сведения см. в разделе Управление настройками и функциями вашего репозитория.
5. Настройка вашего проекта для действенных вкладов
Чтобы поощрять участников совместной работы вашего репозитория, вам необходимо сообщество, которое поощряет людей использовать ваш проект, вносить в него свой вклад и распространять его. Дополнительные сведения см. в разделе "Создание приветственных сообществ " в руководствах с открытым исходным кодом.
Добавляя в репозиторий такие файлы, как рекомендации по внесению вклада, правила поведения и лицензию, вы можете создать окружение, в котором участникам совместной работы будет легче вносить значимый и полезный вклад. Дополнительные сведения см. в разделе Настройка проекта для внесения действенных вкладов.
6. Использование GitHub Issues и Projects
С помощью GitHub Issues можно упорядочить работу с проблемами и запросами на вытягивание и управлять рабочим процессом с помощью Projects. Дополнительные сведения см. в разделе [AUTOTITLE и О проблемах](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects).
7. Управление уведомлениями
Уведомления предоставляют обновления о действиях на GitHub, на который вы подписаны или в котором участвовали. Если вам больше не интересна беседа, вы можете отменить подписку, отменить отслеживание или настроить типы уведомлений, которые вы будете получать в будущем. Дополнительные сведения см. в разделе Об уведомлениях.
8. Работа с GitHub Pages
Можно использовать GitHub Pages для создания и размещения веб-сайта непосредственно из репозитория на GitHub.com. Дополнительные сведения см. в разделе Что такое GitHub Pages?.
9. Использование GitHub Discussions
Вы можете включить GitHub Discussions для своего репозитория, чтобы создать сообщество вокруг вашего проекта. Сопровождающие, участники и посетители могут использовать обсуждения, чтобы делиться объявлениями, задавать вопросы и отвечать на них, а также участвовать в обсуждениях целей. Дополнительные сведения см. в разделе Сведения об обсуждениях.
Часть 4. Настройка и автоматизация работы с GitHub
Средства можно использовать из API GitHub Marketplace, API GitHub и существующих функций GitHub для настройки и автоматизации работы.
1. Использование GitHub Marketplace
GitHub Marketplace содержит интеграции, которые добавляют функциональные возможности и улучшают рабочий процесс. Вы можете искать, просматривать и устанавливать бесплатные и платные средства, включая GitHub Apps, OAuth apps и GitHub Actions, в GitHub Marketplace.
2. Использование API GitHub
Существует две версии API GitHub : REST API и API GraphQL. Api GitHub можно использовать для автоматизации распространенных задач, резервного копирования данных или [create integrations, которые расширяют GitHub. Дополнительные сведения см. в разделе Сравнение REST API GitHub и GraphQL API.
3. Building GitHub Actions
С помощью GitHub Actionsможно автоматизировать и настроить рабочий процесс разработки предприятия на GitHub. Вы можете создавать собственные действия, а также использовать и настраивать действия, общие сообществом GitHub . Дополнительные сведения см. в разделе Написание рабочих процессов.
4. Публикация и управление GitHub Packages
GitHub Packages — это служба размещения программных пакетов, которая позволяет размещать программные пакеты частным или открытым способом и использовать их в качестве зависимостей в проектах. Дополнительные сведения см. в разделе Введение в GitHub Packages.
Часть 5. Безопасное создание на GitHub
GitHub имеет различные функции безопасности, которые помогают защитить код и секреты в репозиториях. Некоторые функции доступны для всех репозиториев, в то время как другие доступны только для общедоступных репозиториев и репозиториев с лицензией GitHub Code Security или GitHub Secret Protection лицензии. Общие сведения о функциях безопасности см. в разделе Функции безопасности GitHub.
1. Защита вашего репозитория
Как администратор репозитория, вы можете защитить свои репозитории, настроив параметры безопасности репозитория. К ним относятся управление доступом к вашему репозиторию, настройка политики безопасности и управление зависимостями. Для общедоступных репозиториев и частных репозиториев, принадлежащих организациям с лицензиями для функций, можно также настроить код и секретный сканирование для автоматического определения уязвимостей и обеспечения того, чтобы маркеры и ключи не предоставлялись.
Дополнительные сведения о действиях, которые можно предпринять для защиты репозиториев, см. в разделе Краткое руководство по защите репозитория.
2. Управление вашими зависимостями
Большая часть безопасного построения — это поддержка зависимостей вашего проекта, чтобы гарантировать, что все пакеты и приложения, от которых вы зависите, обновлены и безопасны. Зависимости репозитория можно управлять зависимостями GitHub путем изучения граф зависимостей репозитория с помощью Dependabot для автоматического создания запросов на вытягивание, чтобы обеспечить актуальность зависимостей, а также получать оповещения Dependabot и обновления системы безопасности для уязвимых зависимостей.
Дополнительные сведения см. в разделе Безопасность вашей цепочки поставок.
Часть 6. Участие в сообществе GitHub
1. Вклад в проекты open source
Участие в проектах с открытым кодом на GitHub может оказаться полезным при обучении и накоплении опыта для приобретения любых нужных вам навыков. Дополнительные сведения см. в статье "Участие в открытом исходном коде" в руководствах с открытым исходным кодом.
Вы можете найти персонализированные рекомендации для проектов и хорошие первые проблемы на основе ваших прошлых вкладов, звезд и других действий в обзоре GitHub. Дополнительные сведения см. в разделе Поиск способов внести вклад в open source на GitHub.
2. Взаимодействие с GitHub Community Support
Вы можете подключиться к разработчикам по всему миру, чтобы задавать и отвечать на вопросы, учиться и взаимодействовать напрямую с сотрудниками GitHub. Сведения о начале беседы см. в статье GitHub Community Support.
3. Чтение о GitHub на GitHub Docs
Вы можете прочитать документацию, которая отражает текущий продукт GitHub . Дополнительные сведения см. в разделе О версиях GitHub Docs.
4. Обучение с GitHub Skills
Вы можете научиться новым навыкам, реализуя интересные и реалистичные проекты в собственном репозитории GitHub с помощью GitHub Skills. Каждый курс представляет собой практическое задание, созданное сообществом GitHub и выполняемое под руководством дружелюбного бота.
Дополнительные сведения см. в разделе Учебные ресурсы на Git и GitHub.
5. Поддержка сообщества open source
GitHub Sponsors позволяет осуществлять ежемесячный повторяющийся платеж разработчику или организации, которые разрабатывают, создают или обслуживают проекты с открытым кодом, на которые вы полагаетесь. Дополнительные сведения см. в разделе О спонсорах GitHub.
6. Обращение в Служба поддержки GitHub
Служба поддержки GitHub помогает устранять неполадки, с которыми вы можете столкнуться при использовании GitHub. Дополнительные сведения см. в разделе О поддержке GitHub.