hexo-theme-next README

The project's README from github.com/iissnan/hexo-theme-next. As one markdown file: README.md.

This repository is no longer maintained! :warning:

The community-maintained version is here: NexT v6 and v7 :triangular_flag_on_post:

NexT

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

gitter-image mnt-image travis-image rel-image hexo-image lic-image

Live Preview

More NexT examples here.

Installation

1. Change dir to hexo root directory. There must be node_modules, source, themes and other directories:

$ cd hexo
$ ls
_config.yml  node_modules  package.json  public  scaffolds  source  themes

2. Get theme from GitHub. There are several variants to do it:

Download latest release version.

At most cases stable. Recommended for most users.

curl-tar-wget-image

$ mkdir themes/next
$ curl -s https://api.github.com/repos/iissnan/hexo-theme-next/releases/latest | grep tarball_url | cut -d '"' -f 4 | wget -i - -O- | tar -zx -C themes/next --strip-components=1

Download tagged release version.

You must define version. Replace v5.1.2 with any version from tags list.

curl-tar-image

$ mkdir themes/next
$ curl -L https://api.github.com/repos/iissnan/hexo-theme-next/tarball/v5.1.2 | tar -zxv -C themes/next --strip-components=1

git-image

$ git clone --branch v5.1.2 https://github.com/iissnan/hexo-theme-next themes/next

Download latest master branch.

May be unstable, but includes latest features. Recommended for developers.

curl-tar-image

$ mkdir themes/next
$ curl -L https://api.github.com/repos/iissnan/hexo-theme-next/tarball | tar -zxv -C themes/next --strip-components=1

git-image

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

Clone command will give you the whole repository. And in any time you can switch to any tagged release.
Get tags list:

$ cd themes/next
$ git tag -l
…
v5.0.0
v5.0.1
v5.1.0
v5.1.1
v5.1.2

For example, you want to switch on v5.1.0 tagged release version. Input the following command:

$ git checkout tags/v5.1.0
Note: checking out 'tags/v5.1.0'.
…
HEAD now on 1f72f68... CSS: Remove global list-style setting of ul

And if you want to switch back on master branch, input this command:

$ git checkout master

3. Set theme in main hexo root config _config.yml file:

theme: next

Bugs

For those who also encounter Error: Cannot find module 'hexo-util' issue, please check your NPM version.

Update

$ cd themes/next
$ git pull

Bugs

Commit your changes or stash them before you can merge

You must Commit, Stash or Discard local changes. See here how to do it.

Theme configurations using Hexo data files (#328)

Currently, it is not smooth to update NexT theme from pulling or downloading new releases. It is quite often running into conflict status when updating NexT theme via git pull, or need to merge configurations manually when upgrading to new releases.

At present, NexT encourages users to store some options in site's _config.yml and other options in theme's _config.yml. This approach is applicable, but has some drawbacks:

  1. Configurations are splited into two pieces
  2. Users maybe confuse which place should be for options

In order to resolve this issue, NexT will take advantage of Hexo Data files. Because Data files is introduced in Hexo 3, so you need upgrade Hexo to 3.0 (or above) to use this feature.

If you prefer Hexo 2.x, you can still use the old approach for configurations. NexT is still compatible with Hexo 2.x.

Benefits

With this feature, now you can put all your configurations into one place (source/_data/next.yml), you don't need to touch next/_config.yml. If there are any new options in new releases, you just need to copy those options from next/_config.yml, paste into _data/next.yml and set their values to whatever you want.

How to use this feature

  1. Please ensure you are using Hexo 3 (or above)
  2. Create an file named next.yml in site's source/_data directory (create _data directory if it did not exist)
  3. Copy NexT theme options both in site's _config.yml and theme's _config.yml into next.yml.
  4. Use --config source/_data/next.yml parameter to start server, generate or deploy.
    For example: hexo clean --config source/_data/next.yml && hexo g --config source/_data/next.yml.

Features

Multiple languages support, including:

:cn: Simplified Chinese & Traditional Chinese.
:us: English
:ru: Russian
:fr: French
:de: German
:jp: Japanese
:indonesia: Indonesian
:portugal: Portuguese (Brazil)
:kr: Korean
:it: Italian
:netherlands: Dutch
:vietnam: Vietnamese

Default language is English.

language: en
# language: zh-Hans
# language: zh-hk
# language: zh-tw
# language: ru
# language: fr-FR
# language: de
# language: ja
# language: id
# language: pt
# language: pt-BR
# language: ko
# language: it
# language: nl-NL
# language: vi

Set language field as following in site _config.yml to change to Chinese.

language: zh-Hans

Comment support.

NexT has native support for DuoShuo and Disqus comment systems.

Add the following snippets to your _config.yml:

duoshuo:
  enable: true
  shortname: your-duoshuo-shortname

OR

disqus_shortname: your-disqus-shortname

Tags page.

Add a tags page contains all tags in your site.

Categories page.

Add a categories page contains all categories in your site.

Social Media

NexT can automatically add links to your Social Media accounts:

social:
  GitHub: your-github-url
  Twitter: your-twitter-url
  Weibo: your-weibo-url
  DouBan: your-douban-url
  ZhiHu: your-zhihu-url

Show a feed link.

Set rss field in theme's _config.yml, as the following value:

  1. rss: false will totally disable feed link.

  2. rss: use sites' feed link. This is the default option.

    Follow the installation instruction in the plugin's README. After the configuration is done for this plugin, the feed link is ready too.

  3. rss: http://your-feed-url set specific feed link.

Up to 5 code highlight themes built-in.

NexT uses Tomorrow Theme with 5 themes for you to choose from. Next use normal by default. Have a preview about normal and night:

Tomorrow Normal Preview Tomorrow Night Preview

Head over to Tomorrow Theme for more details.

Configuration

NexT comes with few configurations.


# Menu configuration.
menu:
  home: /
  archives: /archives

# Favicon
favicon: /favicon.ico

# Avatar (put the image into next/source/images/)
# can be any image format supported by web browsers (JPEG,PNG,GIF,SVG,..)
avatar: /default_avatar.png

# Code highlight theme
# available: normal | night | night eighties | night blue | night bright
highlight_theme: normal

# Fancybox for image gallery
fancybox: true

# Specify the date when the site was setup
since: 2013

Browser support

browser-image

Browser Stack

BrowserStack is a cloud-based cross-browser testing tool that enables developers to test their websites across various browsers on different operating systems and mobile devices, without requiring users to install virtual machines, devices or emulators.

Contributing

Contribution is welcome, feel free to open an issue and fork. Waiting for your pull request.

hexo-theme-next (iissnan/hexo-theme-next)

Searching Database…

15.8K ·GitHub
Hexo-theme-next
What is this?NexT is a high quality, elegant theme for Hexo, a static site generator — one of the most popular Hexo themes, with over 15,000 GitHub stars.
Is NexT a full blog engine, or just the design layer on top of Hexo?Just the design layer: you drop it into the themes folder of an existing Hexo site and switch it on with one line — theme: next — in the site's _config.yml. Hexo itself generates the site.
How do I install it on my Hexo site?From your Hexo site root, get the theme into themes/next from GitHub — the latest release (stable, recommended for most users), a specific tagged version, or the master branch for the newest features — then set theme: next in _config.yml.
Which Hexo version do I need, and does anything else have to be in place?Hexo 2.x still works, but the recommended data-file configuration needs Hexo 3.0 or above. One known pitfall: some NPM versions throw a 'Cannot find module hexo-util' error — check your NPM version and reinstall node_modules.
Is this version of the theme still maintained?No — this repository is no longer maintained. The project lives on as the community-maintained NexT version, and new users should head there instead.
What does it actually look like — are there different design variants?Four built-in schemes — Muse, Mist, Pisces and Gemini — each with live preview sites linked in the README, so you can pick a look before installing anything.
Can readers leave comments on my posts?Yes — NexT has native support for the DuoShuo and Disqus comment systems; you add a config snippet to _config.yml to turn one on.
Theme updates keep clashing with my edits — how does NexT handle configuration?Store your overrides in a data file: create next.yml in the site's source/_data directory (needs Hexo 3+), copy the options you want there, and run Hexo with --config source/_data/next.yml. The theme's own config stays untouched, so pulling updates no longer forces manual merges.
Which interface languages does it ship with?Thirteen built-in languages: English (default), Simplified and Traditional Chinese, Russian, French, German, Japanese, Korean, Italian, Dutch, Vietnamese, Indonesian and Brazilian Portuguese — switched via the language field in the site config.
What are similar projects?hugo-PaperMod, minimal-mistakes, giscus, hexo, material-components-web, bootstrap-table, floorplan-3d, linuxdo-idea-ui
Which topics is it in?blog, templates, theme, i18n, multilingual, customization, css, ui, web-development, frontend, chinese, javascript
Creator
iissnan
Size
13.1 MB
Stars
15.8K
Updated
CommitNov 10Releasev5.1.4Jan 01
Age
11y
Commits · 90 Days