← Cloudflare Pages / pages / framework-guides

Hexo

Hexo ↗ это инструмент для создания статических сайтов, работающий на Node.js. К преимуществам Hexo относятся скорость, простота и гибкость, позволяющие преобразовывать файлы Markdown в статические веб-страницы с помощью Node.js.

В этом руководстве вы создадите новое приложение Hexo и развернете его с помощью Cloudflare Pages. Вы будете использовать hexo CLI для создания нового сайта на Hexo.

Сначала установите Hexo CLI с помощью npm или yarn выполнив одну из следующих команд в терминале:

npm install hexo-cli -g
# or
yarn global add hexo-cli

В macOS и Linux установить можно с помощью brew ↗:

brew install hexo

Все руководства по фреймворкам предполагают, что у вас уже есть базовое понимание Git ↗. Если вы новичок в Git, обратитесь к этому краткое руководство по Git ↗ о том, как настроить Git на локальном компьютере.

Если вы клонируете по SSH, необходимо сгенерировать ключи SSH ↗ на каждом компьютере, с которого вы отправляете или получаете данные из GitHub.

См. документация GitHub ↗ и Документация Git ↗, где это описано подробнее.

После установки Hexo CLI создайте новый проект, выполнив команду hexo init в терминале:

hexo init my-hexo-site
cd my-hexo-site

Сайты на Hexo используют темы для настройки внешнего вида статически собранных HTML-сайтов. В Hexo по умолчанию уже установлена тема, которую можно найти на странице тем Hexo ↗.

Создайте новый пост, чтобы наполнить свой сайт на Hexo начальным содержимым. Выполните hexo new команду в терминале, чтобы создать новый пост:

hexo new "hello hexo"

Внутри hello-hexo.md, используйте Markdown для написания содержимого статьи. Вы можете настроить теги, категории и другие переменные статьи. См. Раздел Front Matter ↗ из документация Hexo ↗, где это описано подробнее.

Создайте новый репозиторий GitHub, перейдя по адресу repo.new ↗. После создания нового репозитория перейдите в каталог только что созданного проекта, чтобы подготовить локальное приложение и отправить его в GitHub, выполнив в терминале следующие команды:

git init
git remote add origin https://github.com/<your-gh-username>/<repository-name>
git add .
git commit -m "Initial commit"
git branch -M main
git push -u origin main

Чтобы развернуть сайт в Pages:

1. На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.

   Перейдите в Workers & Pages ↗

2. Выберите Создать приложение.

3. Выберите Pages на вкладке.

4. Выберите Импорт существующего репозитория Git.

5. Выберите созданный вами новый репозиторий GitHub, а затем нажмите Начало настройки.

6. В Настройка сборок и деплоев раздел и укажите следующую информацию:

После завершения настройки нажмите на Save and Deploy кнопку. Вы увидите, как Cloudflare Pages устанавливает hexo и зависимостей проекта, а также сборки сайта перед его развёртыванием.

После деплоя сайта вы получите уникальный поддомен для своего проекта на *.pages.dev. Каждый раз, когда вы фиксируете новый код в своем сайте Hexo, Cloudflare Pages автоматически пересоберет ваш проект и развернет его. Вы также получите доступ к развёртывания предпросмотра для новых pull request, чтобы вы могли увидеть, как изменения выглядят на сайте, прежде чем разворачивать их в продакшен.

Некоторым темам и плагинам Hexo для работы требуются определённые версии Node.js. Чтобы использовать конкретную версию Node.js для Hexo:

1. Перейдите в свой проект Pages.
2. Перейдите в Настройки > Переменные окружения.
3. Задайте переменную окружения NODE_VERSION и значение требуемой версии Node.js (например, 14.3).

После выполнения этого руководства вы успешно развернули свой сайт на Hexo на Cloudflare Pages. Чтобы начать работу с другими фреймворками, обратитесь к списку руководств по фреймворкам.