Документация

Добро пожаловать в документацию Hexo. Если возникнут проблемы при использовании Hexo, попробуйте поискать в руководстве по решению проблем, поднять вопрос на GitHub или завести тему в группе Google Group.

Что есть Hexo?

Hexo — это быстрый, простой и мощный фреймворк для блога. Вы пишите посты в Markdown (или других языках), и Hexo генерирует статические файлы с красивой темой в считанные секунды.

Установка

Настройка Hexo занимает всего несколько минут. Если вы столкнулись с проблемой и не можете найти решение здесь, пожалуйста, отправьте вопрос на GitHub, и я постараюсь разрешить её.

Требования

Установка Hexo довольно проста. Однако сперва нужно установить пару вещей:

  • Node.js (Версия должна быть как минимум Node.js 8.10, рекомендовано использовать 10.0 или выше)
  • Git

Если всё это уже есть, поздравляю! Просто установите Hexo с помощью npm:

Если нет, выполните следующие действия, чтобы установить всё, что требуется.

Установка Git

Для пользователей Mac

Вы можете столкнуться с проблемами при компиляции. Пожалуйста, сначала установите Xcode из магазина App Store. После установки откройте xcode и перейдите в Настройки -> Загрузки -> Командная строка -> Установить (Preferences -> Download -> Command Line Tools -> Install), чтобы установить утилиту командной строки.

Установка Node.js

Node.js предоставляет [официальный установщик](http://nodejs.org/en/download /) для большинства платформ.

Альтернативные методы установки:

  • Windows: Установите его с помощью nvs (рекомендуется) или nvm.
  • Mac: Установите его с помощью Homebrew или MacPorts.
  • Linux (DEB/RPM-based): Установите его с помощью NodeSource.
  • Others: Установите его через соответствующий менеджер пакетов. Обратитесь к руководству предоставленное Node.js.

nvs также рекомендуется для Mac и Linux, чтобы избежать возможных проблем с разрешениями.

Windows

Если вы используете официальный установщик, убедитесь, что установлен флажок Добавить в ПУТЬ(Add to PATH) (он установлен по умолчанию).

Mac / Linux

Если вы столкнулись с ошибкой разрешения EACCESобходному при попытке установить Hexo, пожалуйста, следуйте обходному пути предоставляенным npmjs; переопределение с помощью root/sudo крайне не рекомендуется.

Linux

Если вы установили Node.js используя Snap, вам может потребоваться вручную запустить npm install в целевой папке при инициализации блога.

Установка Hexo

После установки всех требуемых программ, можно устанавливать Hexo с помощью npm.

$ npm install -g hexo-cli

Advanced installation and usage

Advanced users may prefer to install and use hexo package instead.

$ npm install hexo

Once installed, you can run Hexo in two ways:

  1. npx hexo <command>
  2. Linux users can set relative path of node_modules/ folder:
echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

then run Hexo using hexo <command>

необходимая версия Node.js

Если вы застряли с устаревшими версиями Node.js , вы можете рассмотреть возможность установки предыдущей версии Hexo.

Пожалуйста, обратите внимание, что мы не предоставляем исправления ошибок в предыдущих версиях Hexo.

Мы настоятельно рекомендуем всегда устанавливать последнюю версию Hexo и рекомендуемую версию Node.js , когда это возможно.

Hexo version Minimum (Node.js version) Less than (Node.js version)
7.0+ 14.0.0 latest
6.2+ 12.13.0 latest
6.0+ 12.13.0 18.5.0
5.0+ 10.13.0 12.0.0
4.1 - 4.2 8.10 10.0.0
4.0 8.6 8.10.0
3.3 - 3.9 6.9 8.0.0
3.2 - 3.3 0.12 unknown
3.0 - 3.1 0.10 or iojs unknown
0.0.1 - 2.8 0.10 unknown
След