Это руководство проведёт вас через 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.2 Настройка двухфакторной проверки подлинности
Двухфакторная проверка подлинности — это дополнительный слой обеспечения безопасности, используемый при входе на веб-сайты или в приложения. Мы настоятельно рекомендуем настроить 2FA для безопасности вашей учетной записи. Дополнительные сведения см. в разделе Двухфакторная проверка подлинности.
При необходимости после настройки 2FA добавьте ключ доступа в учетную запись, чтобы включить безопасное, без пароля имя входа. См . раздел AUTOTITLE.
5.3 Просмотр вашего GitHub профиля и графика вклада
Ваш GitHub профиль рассказывает людям историю вашей работы через репозитории и основные материалы, которые вы закрепили, о членствах в организациях, которые вы выбрали для рекламы, о вашем вкладе и созданных проектах. Дополнительные сведения см. в разделе [AUTOTITLE и Сведения о профиле](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/viewing-contributions-on-your-profile).
Часть 2: Использование GitHubинструментов и процессов 's
Чтобы использовать его максимально GitHubэффективно, нужно настроить Git. Git отвечает за всё GitHub, что происходит локально на вашем компьютере. Для эффективной совместной GitHubработы вы будете вводить задачи и pull requests с помощью GitHub Flavored 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; интерфейсы и методы зависят от ваших предпочтений и того, что лучше всего подходит для ваших нужд.
Для получения дополнительной информации о различных подходах взаимодействия с GitHub, а также о сравнении инструментов, которые вы можете использовать, см. АВТОТИТРЫ.
4. Написание GitHub
Чтобы сделать общение ясным и организованным по проблемам и pull requests, вы можете использовать GitHub Flavored Markdown для форматирования, который сочетает в себе простой для чтения и написание синтаксис с некоторыми пользовательскими функциями. Дополнительные сведения см. в разделе О написании и форматировании на GitHub.
Вы можете изучить GitHub Flavored Markdown с помощью курса Commun, используя курс Markdown на GitHub Skills.
5. Поиск GitHub
Наш интегрированный поиск позволяет найти то, что вы ищете среди множества репозиториев, пользователей и строк кода на GitHub. Вы можете искать по всему GitHub миру или ограничивать поиск конкретным репозиторием или организацией. Для получения дополнительной информации о типах поиска, которые вы можете выполнять на GitHub, см. О поиске на GitHub.
Наш синтаксис поиска позволяет вам составлять запросы, используя квалификаторы, чтобы указать, что необходимо найти. Дополнительные сведения о синтаксисе поиска, используемом в поиске, см. в разделе Поиск на GitHub.
6. Управление файлами на GitHub
С помощью , вы можете создавать, редактировать, перемещать и удалять файлы в своём репозитории или любом репозитории, к которому GitHubу вас есть доступ к записи. Вы также можете отслеживать историю изменений в файле построчно. Дополнительные сведения см. в разделе Управление файлами.
Часть 3: Сотрудничество в GitHub
Множество людей могут работать вместе в репозиториях по всему GitHubрегиону. Вы можете настроить параметры, создать проекты и управлять уведомлениями, чтобы стимулировать эффективную совместную работу.
1. Работа с репозиториями
Создание репозитория
Репозиторий подобен папке для вашего проекта. У вас может быть сколько угодно публичных и приватных репозиториев в вашей личной учетной записи. Репозитории могут содержать папки и файлы, изображения, видео, электронные таблицы и наборы данных, а также журнал изменений для всех файлов в репозитории. Дополнительные сведения см. в разделе Сведения о репозиториях.
При создании нового репозитория необходимо инициализировать репозиторий с файлом README, чтобы сообщить людям о вашем проекте. Дополнительные сведения см. в разделе Создание репозитория.
Клонирование репозитория
Вы можете клонировать существующий репозиторий на GitHub ваш локальный компьютер, что облегчает добавление и удаление файлов, исправление конфликтов слияний или создание сложных коммитов. Клонирование репозитория позволяет получить полную копию всех данных репозитория, которые GitHub имели на тот момент времени, включая все версии каждого файла и папки проекта. Дополнительные сведения см. в разделе Клонирование репозитория.
Создание вилки репозитория
Вилка — это копия репозитория, которым вы управляете, где любые изменения, которые вы вносите, не повлияют на исходный репозиторий, если только вы не отправите запрос на вытягивание владельцу проекта. Чаще всего вилки используются либо для того, чтобы предложить изменения в чужом проекте, либо для того, чтобы использовать чужой проект в качестве отправной точки для вашей собственной идеи. Дополнительные сведения см. в разделе Работа с вилками.
2. Импорт ваших проектов
Если у вас уже есть проекты, к которым вы хотите перейти GitHub , вы можете импортировать проекты через GitHub Importerкомандную строку или внешние инструменты миграции. Дополнительные сведения см. в разделе Импорт исходного кода.
3. Управление участниками совместной работы и разрешениями
Вы можете сотрудничать над проектом с другими, используя проблемы репозитория, pull-запросы и проекты. Вы можете пригласить других людей в свой репозиторий в качестве участников совместной работы на вкладке Участники совместной работы в настройках репозитория. Дополнительные сведения см. в разделе Приглашение участников совместной работы в личный репозиторий.
Вы являетесь владельцем любого репозитория, созданного вами в учетной записи, и имеете полный контроль над ним. Участники совместной работы имеют доступ на запись в ваш репозиторий, что ограничивает их имеющиеся разрешения. Дополнительные сведения см. в разделе Уровни разрешений для репозитория личной учетной записи.
4. Управление параметрами репозитория
Как владелец репозитория, вы можете настроить несколько параметров, включая видимость репозитория, темы и предварительный просмотр в социальных сетях. Дополнительные сведения см. в разделе Управление настройками и функциями вашего репозитория.
5. Настройка вашего проекта для действенных вкладов
Чтобы поощрять сотрудников в вашем репозитории, вам нужно сообщество, которое поощряет людей использовать, вносить вклад и продвигать ваш проект. Дополнительные сведения см. в разделе "Создание приветственных сообществ " в руководствах с открытым исходным кодом.
Добавляя в репозиторий такие файлы, как рекомендации по внесению вклада, правила поведения и лицензию, вы можете создать окружение, в котором участникам совместной работы будет легче вносить значимый и полезный вклад. Дополнительные сведения см. в разделе Настройка проекта для внесения действенных вкладов.
6. Использование GitHub Issues и Projects
Вы можете использовать GitHub Issues его для организации работы с задачами и pull-запросами, а также для управления рабочим процессом с 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.1 Использование GitHub API
Существует две версии API GitHub : REST API и API GraphQL. Api GitHub можно использовать для автоматизации распространенных задач, резервного копирования данных или [create integrations, которые расширяют GitHub. Дополнительные сведения см. в разделе Сравнение REST API GitHub и GraphQL API.
3.2 Здание GitHub Actions
С помощью GitHub Actionsможно автоматизировать и настроить рабочий процесс разработки предприятия на GitHub. Вы можете создавать собственные действия, а также использовать и настраивать действия, общие сообществом GitHub . Дополнительные сведения см. в разделе Написание рабочих процессов.
4.3 Издательство и управление GitHub Packages
GitHub Packages — это служба размещения программных пакетов, которая позволяет размещать программные пакеты частным или открытым способом и использовать их в качестве зависимостей в проектах. Дополнительные сведения см. в разделе Введение в GitHub Packages.
Часть 5: Надёжное строительство GitHub
GitHub Обладает разнообразными функциями безопасности, которые помогают сохранять код и секреты в репозиториях. Некоторые функции доступны для всех репозиториев, другие — только для публичных репозиториев и репозиториев с лицензией OR GitHub Code SecurityGitHub Secret Protection . Общие сведения о функциях безопасности см. в разделе Функции безопасности GitHub.
1. Защита вашего репозитория
Как администратор репозитория, вы можете защитить свои репозитории, настроив параметры безопасности репозитория. К ним относятся управление доступом к вашему репозиторию, настройка политики безопасности и управление зависимостями. Для публичных репозиториев, а также для частных репозиториев, принадлежащих организациям с лицензиями на эти функции, вы также можете настроить код и сканирование секретов, чтобы автоматически выявлять уязвимости и гарантировать, что токены и ключи не раскрываются.
Дополнительные сведения о действиях, которые можно предпринять для защиты репозиториев, см. в разделе Краткое руководство по защите репозитория.
2. Управление вашими зависимостями
Большая часть безопасного построения — это поддержка зависимостей вашего проекта, чтобы гарантировать, что все пакеты и приложения, от которых вы зависите, обновлены и безопасны. Вы можете управлять зависимостями вашего репозитория, GitHub изучая граф зависимостей, используя Dependabot для автоматического запуска pull request, чтобы сохранить зависимости up-to-date, а также получая оповещения и обновления безопасности Dependabot для уязвимых зависимостей.
Дополнительные сведения см. в разделе Безопасность вашей цепочки поставок.
Часть 6: Участие в GitHubсообществе
Существует множество способов для участия в жизни сообщества GitHub. Вы можете участвовать в проектах с открытым кодом, взаимодействовать с людьми в GitHub Community Support или учиться с помощью GitHub Skills.
1. Вклад в проекты открытый код
Участие в проектах с открытым кодом на GitHub может оказаться полезным при обучении и накоплении опыта для приобретения любых нужных вам навыков. Дополнительные сведения см. в статье "Участие в открытом исходном коде" в руководствах с открытым исходным кодом.
Вы можете найти персонализированные рекомендации для проектов и хорошие первые проблемы на основе ваших прошлых вкладов, звезд и других действий в обзоре GitHub. Дополнительные сведения см. в разделе Поиск способов внести вклад в open source на GitHub.
2. Взаимодействие с GitHub Community Support
Вы можете подключиться к разработчикам по всему миру, чтобы задавать и отвечать на вопросы, учиться и взаимодействовать напрямую с сотрудниками GitHub. Сведения о начале беседы см. в статье GitHub Community Support.
3. Читать о GitHubGitHub Docs
Вы можете прочитать документацию, которая отражает текущий продукт GitHub . Дополнительные сведения см. в разделе О версиях GitHub Docs.
4. Обучение с помощью GitHub Skills
Вы можете научиться новым навыкам, реализуя интересные и реалистичные проекты в собственном репозитории GitHub с помощью GitHub Skills. Каждый курс представляет собой практическое задание, созданное сообществом GitHub и выполняемое под руководством дружелюбного бота.
Дополнительные сведения см. в разделе Учебные ресурсы на Git и GitHub.
5. Поддержка сообщества открытый код
GitHub Sponsors позволяет осуществлять ежемесячный повторяющийся платеж разработчику или организации, которые разрабатывают, создают или обслуживают проекты с открытым кодом, на которые вы полагаетесь. Дополнительные сведения см. в разделе О спонсорах GitHub.
6. Контакт Служба поддержки GitHub
Служба поддержки GitHub помогает устранять неполадки, с которыми вы можете столкнуться при использовании GitHub. Дополнительные сведения см. в разделе О поддержке GitHub.