В этом туториале мы используем Travis CI для деплоя в Github Pages. Travis CI бесплатен для репозиториев с открытым исходным кодом, то есть ветка master
вашего репозитория должна быть публичной. Пожалуйста, перейдите в описание приватного репозитория, если вы предпочитаете не открывать свой исходный код, либо откажитесь от загрузки своих файлов на GitHub.
- Создайте репозиторий с названием username.github.io, где
username
— ваше имя пользователя GitHub. Если вы уже загрузили файлы в репозиторий с другим названием, просто переименуйте его. - Загрузите
push
файлы вашей папки Hexo в этот репозиторий. Папкаpublic/
не должна загружаться по умолчанию, проверьте, что файл.gitignore
содержит строкуpublic/
. Структура папки должна быть такой же, как в этом репозитории, без файла.gitmodules
. - Добавьте Travis CI в свой аккаунт.
- Зайдите на страницу Настроек приложения, сконфигурируйте Travis CI, чтобы оно имело доступ к репозиторию.
- Вас перенаправят на страницу Travis.
- В новой вкладке сгенерируйте новый токен с областью видимости repo. Запишите значение токена.
- На странице Travis зайдите в настройки репозитория. В поле Environment Variables, вставьте GH_TOKEN в качестве имени и токен в качестве значения. Нажмите
Add
для сохранения. - Добавьте файл
.travis.yml
в свой репозиторий (рядом с _config.yml & package.json) со следующим контентом:
sudo: false |
- Как только Travis CI завершит деплой, сгенерированные страницы появятся в ветке
gh-pages
вашего репо. - В настройках своего репозитория GitHub перейдите в раздел “GitHub Pages” и измените
Source
на ветку gh-pages. - Проверьте страницу на username.github.io.
Страница проекта
Если вы препочитаете страницу проекта на GitHub:
- Перейдите на страницу своего репо на GitHub. Откройте таб Settings. Измените Repository name, чтобы ваш блог был доступен на username.github.io/repository, repository может быть любым словом, как blog или hexo.
- Редактируйте файл _config.yml, изменив значение
root:
на/<repository>/
(должно начинаться и заканчиваться косой чертой). - Закоммитьте и запушьте.
Приватный репозиторий
Следующая инструкция адаптирована со страницы развёртывание одной командой page.
- Установите hexo-deployer-git.
- Добавьте следующую конфигурацию в _config.yml, (удалите существующие строки, если таковые имеются)
deploy: |
- Запустите
hexo clean && hexo deploy
. - Проверьте веб-страницу по адресу username.github.io.