Skip to content

index.md

Latest commit

 

History

History
111 lines (77 loc) · 7.23 KB

index.md

File metadata and controls

111 lines (77 loc) · 7.23 KB
title Документация

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

Что есть Hexo?

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

Установка

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

Требования

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

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

Если всё это уже есть, поздравляю! You can skip to the Установка Hexo step.

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

Установка Git

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

Установка 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, чтобы избежать возможных проблем с разрешениями.

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

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

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

Установка Hexo

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

$ npm install -g hexo-cli

The Hexo installed using the commands above is globally effective. If the installation is successful, executing the following command will display the version information.

$ hexo --version

{% note info %} For advanced users familiar with npm, you can opt for a local installation of the hexo package instead of a global one. This approach can help avoid potential permission issues associated with global installations. For example, you can clone an existing Hexo blog repository, and after installing dependencies, execute Hexo commands using npx hexo.

$ git clone https://github.com/hexojs/hexo-starter
$ cd hexo-starter
$ npm install
$ npx hexo --version

If you choose a local installation of hexo, Linux users can add the node_modules directory in the Hexo directory to their PATH environment variable to directly use hexo <command>:

echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

{% endnote %}

необходимая версия 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