hexo-theme-next

github/hexo-theme-next

Fork 0

mirror of https://github.com/next-theme/hexo-theme-next.git synced 2026-01-17 18:22:33 +00:00

History

Mimi 7cd83a4b8c Update docs

2020-08-03 11:35:31 +08:00

README.md

Update docs

2020-08-03 11:35:31 +08:00

README.md

Язык: 🇺🇸 🇨🇳 🇷🇺

«NexT» — элегантная высококачественная тема под Hexo. Сделана с нуля, с любовью.

Демо

💟 Muse | 🔯 Mist | ♓️ Pisces | ♊️ Gemini

Больше примеров «NexT» здесь.

Установка

If you're using Hexo 5.0 or later, the simplest way to install is through npm:

$ cd hexo-site
$ npm install hexo-theme-next

Or you can clone the entire repository:

$ cd hexo-site
$ git clone https://github.com/next-theme/hexo-theme-next themes/next

See detailed installation instructions if you want any other variant.

After the installation, open Hexo config file and set theme variable to next.

theme: next

Configuration

At present, NexT encourages users to use the Alternate Theme Config to configure NexT. And it's easy to customize the layout or style of NexT using Custom Files.

It is not recommended to directly modify any files in the NexT theme. Because this may cause errors (e.g. merge conflicts), and the modified files may be discarded when upgrading the theme.

However, you can bypass merge conflicts (error message like «Commit your changes or stash them before you can merge») by using the Commit, Stash or Reset commands for local changes. See here how to do it.

Плагины

Plugins extend and expand the functionality of NexT. There are two types of plugins: core plugins and third-party plugins. The core plugins are required by the basic functions of NexT. Third-party plugins provide a large number of optional features.

Configuring these plugins is very easy. Например, Вы хотите использовать pjax для своего сайта. Открываем конфиг NexT'а и находим:

# Easily enable fast Ajax navigation on your website.
# For more information: https://github.com/next-theme/pjax
pjax: true

Configure CDN

Third-party plugins are loaded from jsDelivr CDN by default. We also provide other optional CDNs, including the famous UNPKG and CDNJS.

For example, if you want to use unpkg instead of jsdelivr as the default CDN provider, you need to edit the following settings in NexT config file:

vendors:
  # ...
  # Some contents...
  # ...
  plugins: unpkg

Обновление

NexT выпускает новые версии каждый месяц. You can update NexT by the following command.

Install the latest version throuth npm:

$ cd hexo-site
$ npm update hexo-theme-next

Or update to latest master branch:

$ cd themes/next
$ git pull

А если всплывают ошибки во время обновления (что-то наподобии «Commit your changes or stash them before you can merge»), рекомендуется ознакомиться с особенностью хранения Alternate Theme Config.
Как бы то ни было, можно обойти ошибки при обновлении если «Закомитить», «Стэшнуть» или «Откатить» локальные изменения. Смотрим здесь как это сделать.

Если нужно обновиться с версии v5.x / v7.x на последней версиями, читаем здесь.