github-pages

Инструкция по размещению сайта на GitHub Pages

Для размещения статического веб-сайта можно воспользоваться сервисом GitHub Pages. Статический сайт состоит из HTML-страниц с неизменным содержимым. Такие сайты могут использоваться как визитки, портфолио, презентационные страницы.

Особенности и ограничения

Сервис Github Pages предоставляет следующие возможности для статических сайтов:

• Использование HTML, CSS, языка разметки Markdown;
• Встраивание изображений и другого медиа;
• Использование JavaScript.

Ограничения:

• Нельзя использовать на сайте PHP либо другие серверные языки;
• Серверный код и серверные скрипты выполняться не будут;
• Cookies не используются.

Как опубликовать сайт на GitHub Pages

1. Создайте аккаунт на GitHub. Предположим, your-account-name — название вашего аккаунта.
2. Cоздайте новый репозиторий для вашего проекта. При создании введите название репозитория (например, repo-name), выберите тип репозитория Public и нажмите на кнопку Create repository:

3. Загрузите все файлы вашего проекта в ветку master созданного репозитория repo-name. Загрузки нажмите add file => upload files и перетащите папку с файлами в окно загрузки. Нажмите на Commit changes внизу страницы, чтобы загрузить файлы. Обратите внимание, что после загрузки проекта файл index.html должен находиться в корневой директории проекта:

4. Перейдите в настройки (Settings) созданного репозитория:

5. В настройках репозитория найдите вкладку Pages:

6. Установите в качестве источника файлов вашей(branch) страницы ветку master созданного репозитория, а в качестве source - deploy form branch:

7. Теперь ваш сайт опубликован по адресу вида your-account-name.github.io/repo-name: Примечание: иногда ссылка появляется не сразу, так как сервису нужно немного времени для деплоя, поэтому попробуйте обновить страницу через 2-5 минут.

7. Для проверки работы сайта просто перейдите по адресу https://your-account-name.github.io/repo-name – и вы увидите свою страницу, загруженную на Github Pages: