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

Ошибка обработки YAML

JS-YAML: incomplete explicit mapping pair; a key node is missed at line 18, column 29:
      last_updated: Last updated: %s

Заключите строку в кавычки, если она содержит двоеточия.

JS-YAML: bad indentation of a mapping entry at line 18, column 31:
      last_updated:"Last updated: %s"

Убедитесь, что используются табы вместо пробелов, и добавьте пробелы после двоеточий.

Больше информации см. здесь YAML Spec.

Ошибка EMFILE

Error: EMFILE, too many open files

Хотя Node.js и использует неблокирующий ввод/вывод, максимальное количество одновременных операций I/O по-прежнему ограничено. Можно встретить ошибку EMFILE при попытке создания большого количества файлов. Попробуйте запустить следующую команду, чтобы увеличить количество синхронных операций ввода-вывода:

$ ulimit -n 10000

process out of memory

Когда вы сталкиваетесь с этой ошибкой во время создания

FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - process out of memory

Повысить размер динамической памяти Node.js можно, изменив в первой строке hexo-cli команду (для нахождения местоположения файла используйте which hexo).

#!/usr/bin/env node --max_old_space_size=8192

Заканчивается память при создании большого блога · Issue #1735 · hexojs/hexo (eng)

Проблемы с публикацией в Git

error: RPC failed; result=22, HTTP code = 403

fatal: 'username.github.io' does not appear to be a git repository

Убедитесь, что вы настроили git на своём компьютере. Или можно попробовать использовать вместо репозитория URL-адрес https.

Проблемы с сервером

Error: listen EADDRINUSE

Были запущены два сервера Hexo одновременно, или возможно другое приложение использует тот же порт. Попробуйте изменить настройки порта или запустить сервер Hexo с флагом -p.

$ hexo server -p 5000

Проблема установки плагина

npm ERR! node-waf configure build

Эта ошибка может возникать при попытке установить плагин, написанный на C, C++ или любой другой, написанный не на JavaScript. Убедитесь, что вы установили правильный компилятор на компьютере.

Ошибка с DTrace (Mac OS X)

{ [Error: Cannot find module './build/Release/DTraceProviderBindings'] code: 'MODULE_NOT_FOUND' }
{ [Error: Cannot find module './build/default/DTraceProviderBindings'] code: 'MODULE_NOT_FOUND' }
{ [Error: Cannot find module './build/Debug/DTraceProviderBindings'] code: 'MODULE_NOT_FOUND' }

Проблема в DTrace попробуйте эту команду:

$ npm install hexo --no-optional

См. также #1326

Iterate Data Model on Jade or Swig

Hexo использует склад Warehouse для своей модели данных. Это не массив, так что его можно использовать для преобразования списка объектов в итераторы.

{% for post in site.posts.toArray() %}
{% endfor %}

Данные не обновляются

Некоторые данные не могут быть обновлены или вновь созданные файлы идентичны последней версии. Очистите кэш и попробуйте снова.

$ hexo clean

Содержимое не найдено

Hexo использует Nunjucks для отображения сообщения (Swig использовался в предыдущей версии, он использует похожий синтаксис). Содержимое, обёрнутое, в {{ }} или {% %}, поможет вам разобраться, какая часть вызвала проблемы. Можно переносить конфиденциальные данные с raw плагином.

{% raw %}
Hello {{ sensitive }}
{% endraw %}

ENOSPC Error (Linux)

Иногда команда $ hexo server возвращает ошибку:

Error: watch ENOSPC ...

Это может быть исправлено путем запуска $ npm dedupe, или, если это не поможет, попробуйте выполнить следующие действия в консоли Linux.

$ echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p

Это позволит увеличить лимит количества файлов, которые можно просматривать одновременно.