3 мин на чтение

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

Что такое GitHub Pages

GitHub Pages — это функция GitHub, которая позволяет размещать статические веб-сайты из репозиториев GitHub и делать их общедоступными или даже частными для вашей команды и организации. GitHub Pages поможет вам запустить веб-сайты за считанные минуты — от вашего личного веб-сайта и портфолио до документации вашего проекта. Вы даже получите URL-адрес в форме https://.github.io, которой сможете поделиться со всем миром, чтобы сделать ваш веб-сайт(ы) доступными для других.

Но как это сделать? Что ж, обещаю, это займёт не больше пары минут. В следующих разделах я собираюсь описать пошаговый процесс, которому вы можете следовать, чтобы начать работу с GitHub Pages и воплотить в жизнь свой первый веб-сайт, размещенный на GitHub.

Как разместить веб-сайт с помощью страниц GitHub

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

image-center

Клонируйте репозиторий на свой локальный компьютер

Теперь, когда вы создали общедоступный репозиторий на GitHub, вам нужно будет клонировать его на свой локальный компьютер. Для этого просто откройте терминал на своем компьютере и выполните следующую команду (в любом каталоге/папке, который вы предпочитаете):

git clone https://github.com/username/username.github.io

Опять же, обязательно замените usernameссылки на свое имя пользователя GitHub. Обратите внимание, что при клонировании репозитория вы получите следующее предупреждающее сообщение.

Cloning into 'gmyrianthous.github.io'...
warning: You appear to have cloned an empty repository.

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

Создайте файл index.html в каталоге фашего проекта

Теперь перейдите в недавно клонированный репозиторий и создайте index.htmlфайл.

$ cd <username>.github.io
$ touch index.html
$ echo "Hello, world! This is my personal page hosted on GitHub pages." > index.html

И давайте еще раз проверим, что контент, который мы только что добавили в index.htmlфайл, действительно существует:

$ cat index.html
Hello, world! This is my personal page hosted on GitHub pages.

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

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

$ git add index.html
$ git commit -m "Add index.html file"
$ git push -u origin main

Откройте браузер и посмотрите свой сайт.

Откройте предпочитаемый вами браузер, введите URL-адрес вашего веб-сайта ( .github.io) в адресную строку браузера и вуаля! Теперь ваша страница должна быть размещена на GitHub Pages и общедоступна для внешнего мира.

Обратите внимание: если вы попытаетесь получить доступ к странице немедленно, вы можете получить ошибку 404. Просто наберитесь терпения и подождите минуту или около того, и тогда вы сможете получить доступ к своей странице.

Настройка веб-сайта страниц GitHub

Теперь, когда ваш веб-сайт GitHub Pages запущен, вы можете внести в него некоторые изменения и настроить по своему вкусу. Ниже описано, как настроить метод развертывания вашего веб-сайта, а также как создать собственный URL-адрес сайта.

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

  1. Нажмите на вкладку настроек репозитория.
  2. В меню слева нажмите «Страницы» в разделе «Код и автоматизация».
  3. В разделе «Сборка и развертывание» выберите ветку (и, при необходимости, подкаталог), из которой вы хотите, чтобы GitHub Pages развернул ваш веб-сайт.

image-center

Собственный домен

Обратите внимание, что GitHub Pages поддерживает использование пользовательских доменов, а также изменение корневого URL-адреса на любой принадлежащий вам поддомен. Он поддерживает следующие три типа доменов:

  • субдомен www (например, www.mysite.com)
  • Пользовательские поддомены (например,portfolio.mysite.com)
  • Домены Apex (например, mysite.com)

Чтобы изменить домен по умолчанию:

  1. Нажмите на вкладку настроек репозитория.
  2. В меню слева нажмите «Страницы» в разделе «Код и автоматизация».
  3. В разделе «Личный домен» выберите свой личный домен.

image-center

Если вы хотите легко и бесплатно размещать статические веб-сайты, не ищите больше — страницы GitHub должны быть одними из лучших вариантов в вашем списке. Независимо от того, идет ли речь о вашем личном веб-сайте или странице проекта, вы можете использовать это руководство, чтобы запустить его всего за несколько минут.

Метки: ,

Дата изменения:

Оставить комментарий