Home

Awesome

<div align="right"> Language: πŸ‡ΊπŸ‡Έ <a title="Chinese" href="docs/zh-CN/README.md">πŸ‡¨πŸ‡³</a> <a title="Russian" href="docs/ru/README.md">πŸ‡·πŸ‡Ί</a> </div> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/next-theme/theme-next-docs/v8.13.0/source/images/next-schemes-dark.png"> <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/next-theme/theme-next-docs/v8.13.0/source/images/next-schemes.png"> <img alt="NexT preview" src="https://raw.githubusercontent.com/next-theme/theme-next-docs/v8.13.0/source/images/next-schemes.png"> </picture>

<a title="NexT website" href="https://theme-next.js.org"><img align="right" alt="NexT logo" width="100" height="100" src="https://raw.githubusercontent.com/next-theme/hexo-theme-next/master/source/images/logo.svg"></a>

NexT

NexT is a high quality elegant Hexo theme. It is crafted from scratch with love.

NPM version NPM Downloads Required Hexo version License Build Status Build Status Coverage Status

Live Preview

<p align="center"> πŸ’Ÿ <a href="https://theme-next.js.org/muse/">Muse</a> | πŸ”― <a href="https://theme-next.js.org/mist/">Mist</a> | ♓️ <a href="https://theme-next.js.org/pisces/">Pisces</a> | β™ŠοΈ <a href="https://theme-next.js.org">Gemini</a> <br> <br> More NexT examples <a href="https://github.com/next-theme/awesome-next#live-preview">here</a>. </p>

Installation

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

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.

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.

Plugins

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. For example, if you want to enable pjax on your site, just set pjax to true in NexT config file:

# 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 CDNJS CDN by default. We also provide other optional CDNs, including the famous UNPKG and jsDelivr.

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

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

Update

A new version of NexT will be released every month. Please read the release notes before updating the theme. You can update NexT by the following command.

Install the latest version through npm:

cd hexo-site
npm install hexo-theme-next@latest

Or update to the latest master branch:

cd themes/next
git pull

If you want to update from v5.x / v7.x to the latest version, read this.

Community

Connect with us and be part of our growing community!

Feedback

Contributing

We welcome you to join the development of NexT. Please see contributing document. πŸ€—

Also, we welcome Issue or PR to our official-plugins.

Contributors

Contributors

Thanks

NexT send special thanks to these great services that sponsor our core infrastructure:

<a href="https://github.com"><img height="40" src="https://github.githubassets.com/images/modules/logos_page/GitHub-Logo.png"></a>

GitHub allows us to host the Git repository and run the test suite.

<a href="https://www.netlify.com"> <picture> <source media="(prefers-color-scheme: dark)" height="40" srcset="https://www.netlify.com/v3/img/components/full-logo-dark.svg"> <source media="(prefers-color-scheme: light)" height="40" srcset="https://www.netlify.com/v3/img/components/full-logo-light.svg"> <img alt="Netlify Logo" height="40" src="https://www.netlify.com/v3/img/components/full-logo-light.svg"> </picture> </a>

Netlify allows us to distribute the documentation.

<a href="https://crowdin.com"> <picture> <source media="(prefers-color-scheme: dark)" height="40" srcset="https://support.crowdin.com/assets/logos/core-logo/svg/crowdin-core-logo-cWhite.svg"> <source media="(prefers-color-scheme: light)" height="40" srcset="https://support.crowdin.com/assets/logos/core-logo/svg/crowdin-core-logo-cDark.svg"> <img alt="Netlify Logo" height="40" src="https://support.crowdin.com/assets/logos/core-logo/svg/crowdin-core-logo-cDark.svg"> </picture> </a>

Crowdin allows us to translate conveniently the documentation.

<a href="https://cdnjs.com"> <picture> <source media="(prefers-color-scheme: dark)" height="40" srcset="https://raw.githubusercontent.com/cdnjs/brand/master/logo/source/light-brackets.svg"> <source media="(prefers-color-scheme: light)" height="40" srcset="https://raw.githubusercontent.com/cdnjs/brand/master/logo/source/dark-brackets.svg"> <img alt="CDNJS Logo" height="40" src="https://raw.githubusercontent.com/cdnjs/brand/master/logo/source/dark-brackets.svg"> </picture> </a>

Thanks CDNJS for providing public CDN service.

License

FOSSA Status