Theme Settings

NexT insists to hide complex details and gives you a simple but flexible config, so you can use it easily.

Console Reminder

Next supports automatic check for updates and alerts in the console. Set the value reminder to true in minify section in theme config file as following:

next/_config.yml
# Console reminder if new version released.
reminder: false

Cache Support

NexT v6+ allows to cache content generation. Set the value enable to true in cache section in theme config file as following:

next/_config.yml
# Allow to cache content generation. Introduced in NexT v6.0.0.
cache:
enable: true

Minify Support

This feature is currently a bit simplistic, and we will further improve it in the future.

NexT allows to minify hexo generation. Set the value minify to true in theme config file as following:

next/_config.yml
# Remove unnecessary files after hexo generate.
minify: true

Custom Style Support

Like Next Data files, you can put all your custom styles into one place (hexo/source/_data). Add your custom files in hexo/source/_data and uncomment needed files under the custom_file_path section in theme config file as following:

next/_config.yml
# For example, you want to put your custom styles file
# outside theme directory in root `source/_data`, set
# `styles: source/_data/styles.styl`
custom_file_path:
#head: source/_data/head.swig
#header: source/_data/header.swig
#sidebar: source/_data/sidebar.swig
#postMeta: source/_data/post-meta.swig
#postBodyEnd: source/_data/post-body-end.swig
#footer: source/_data/footer.swig
#bodyEnd: source/_data/body-end.swig
#variable: source/_data/variables.styl
#mixin: source/_data/mixins.styl
#style: source/_data/styles.styl

RSS Support

There are three RSS options in NexT to fit different cases.
Edit theme config file and set the value of rss:

  • false: Disable RSS, which won't show links on page.
  • Leave Blank: Use Hexo to generate feed and insert links automatically. You may need to install hexo-generator-feed plugin with npm firstly.
  • Concrete URL: This means you have generate Feed in advance.

Creative Commons

NexT supports the display of Creative Commons 4.0 International License in sidebar and post including by, by-nc, by-nc-nd, by-nc-sa, by-nd, by-sa, zero. These licenses allow creators to communicate which rights they reserve, and which rights they waive for the benefit of recipients or other creators.

You can configure it by editing values in creative_commons section in theme config file, for example:

next/_config.yml
creative_commons:
license: by-nc-sa
sidebar: true
post: true
language: deed.zh

Text Align

NexT allows to customize the text alignment in posts / pages. The text-align CSS property sets the horizontal alignment of a block element or table-cell box.

Values Effect
start The same as left if direction is left-to-right and right if direction is right-to-left.
end The same as right if direction is left-to-right and left if direction is right-to-left.
left The inline contents are aligned to the left edge of the line box.
right The inline contents are aligned to the right edge of the line box.
center The inline contents are centered within the line box.
justify The inline contents are justified. Text should be spaced to line up its left and right edges to the left and right edges of the line box, except for the last line.
justify-all Same as justify, but also forces the last line to be justified.
match-parent Similar to inherit, but the values start and end are calculated according to the parent's direction and are replaced by the appropriate left or right value.
next/_config.yml
# Set the text alignment in the posts.
text_align:
# Available values: start | end | left | right | center | justify | justify-all | match-parent
desktop: justify
mobile: justify

Mobile Devices Adaptation

If you want to reduce padding/margin indents on devices with narrow width, you can enable it by setting value mobile_layout_economy to true in theme config file.

next/_config.yml
mobile_layout_economy: true

By default NexT uses black-deep (#222) as the color of android Chrome header panel. You can configure it by editing values with Hex color in android_chrome_color section in theme config file.

next/_config.yml
android_chrome_color: "#222"

Rainbow Safari

If you want to hide sticky headers and color the menu bar on Safari (iOS / macOS), you can set safari_rainbow to true. More information here: rainbowsafari.

next/_config.yml
safari_rainbow: true

Custom Logo Support

NexT supports the site logo personalization.

You can enable it by adding images's url to custom_logo in theme config file.

next/_config.yml
custom_logo: /uploads/custom-logo.jpg

Scheme Mist does not support custom logo setting.

Codeblock Style

Code Highlight Theme

NexT uses Tomorrow Theme to support code highlight.
Default style is white (normal) and there are 8 styles to choose:

  • normal
  • night
  • night blue
  • night bright
  • night eighties
  • solarized
  • solarized dark
  • galactic

Change the value of highlight_theme to choose the highlight style you like, for example:

next/_config.yml
codeblock:
# Code Highlight theme
# Available values: normal | night | night eighties | night blue | night bright | solarized | solarized dark | galactic
# https://github.com/chriskempson/tomorrow-theme
highlight_theme: night

NexT supports the copy-and-paste functionality of codeblock.

You can enable it by setting value copy_button.enable to true in theme config file.

next/_config.yml
codeblock:
copy_button:
enable: true

By default NexT doesn't show copy results of the copy-and-paste functionality. You can also enable it by setting value copy_button.show_result to true in theme config file.

next/_config.yml
codeblock:
copy_button:
show_result: true

With style option, you can change your copy button style.
There are three style available currently: default(Just leave it empty), flat and mac.

next/_config.yml
codeblock:
copy_button:
style: flat

Reading Progress

NexT supports the page scroll reading progress indicator.

You can enable it by setting value reading_progress.enable to true in theme config file.

next/_config.yml
reading_progress:
enable: true
color: "#37c6c0"
height: 2px

Bookmark

Bookmark is a plugin that allow the users save their reading progress. Users could just click the bookmark icon (like 🔖) in left-top of the page to save the scroll position. And when they visit your blog in the next time, they can resume the last scroll position of each page automatically.

You can enable it by setting value bookmark.enable to true in theme config file.

next/_config.yml
bookmark:
enable: false
# Customize the color of the bookmark.
color: "#222"
# If auto, save the reading progress when closing the page or clicking the bookmark-icon.
# If manual, only save it by clicking the bookmark-icon.
save: auto

GitHub Banner

NexT provides Follow me on GitHub banner in right-top corner.

next/_config.yml
# Follow me on GitHub banner in right-top corner.
github_banner:
enable: true
permalink: https://github.com/yourname
title: Follow me on GitHub

permalink → is the specified link must have full url path.

title → is the title and aria-label name.

You can set enable to true and add your own GitHub link.

Fonts Customization

To solve the unstable of Google Fonts API in some countries, NexT supports setting fonts. By using this feature you can assign URL of fonts library. And NexT gives you 5 specific font settings, they are:

  • Global Font: Font used in the whole site.
  • Title Font: Font used by site title.
  • Headlines Font: Font used by titles in articles (h1, h2, h3, h4, h5, h6).
  • Article Font: Font used by articles.
  • Code Font: Font used by code blocks in articles.

Each font will be used as the first font of this class, NexT will fallback to internal font settings if they are unavalible.

  • Non-code Font: Fallback to "PingFang SC", "Microsoft YaHei", sans-serif
  • Code Font: Fallback to consolas, Menlo, "PingFang SC", "Microsoft YaHei", monospace

Plus each section has a external attribute, this controls whether to use the font library CDN.
Use this can help you to use fonts installed in system and reduce unnecessary requests.

next/_config.yml
font:
# Use custom fonts families or not.
# Depended options: `external` and `family`.
enable: true

# Uri of fonts host, e.g. //fonts.googleapis.com (Default).
host:

# Font options:
# `external: true` will load this font family from `host` above.
# `family: Times New Roman`. Without any quotes.
# `size: x.x`. Use `em` as unit. Default: 1 (16px)

# Global font settings used for all elements inside <body>.
global:
external: true
family: Monda
size: 1.125

# Font settings for site title (.site-title).
title:
external: true
family: Lobster Two
size:

# Font settings for headlines (<h1> to <h6>).
headings:
external: true
family: Amita
size:

# Font settings for posts (.post-body).
posts:
external: true
family: Roboto Slab

# Font settings for <code> and code blocks.
codes:
external: true
family: PT Mono