NexT

Theme for Hexo

Post Settings

NexT User Docs – Theme Settings – Posts

Preamble Text

It's a common need to show some part of article in home page and then give a link to full article. NexT gives two ways to control how article is shown in home page. In other words, you can use following ways to show summary of articles and a Read More button.

Use <!-- more --> in your article to break your article manually, which is recommended by Hexo.

If you have added description and set its value to your article summary in front-matter, NexT excerpts description as preamble text in homepage by default. Without description, the full contents would be the preamble text in homepage.

You can disable it by setting value excerpt_description to false in NexT config file.

NexT config file
excerpt_description: true

It is recommended to use <!-- more --> (the first way) which can not only control what you want to show better, but also let Hexo's plugins use it easily.

Post Meta Display

NexT supports post created date, post updated date and post categories display.

By default NexT shows the description text of post meta. You can disable it by setting value post_meta.item_text to false in NexT config file.

NexT config file
post_meta:
  item_text: true

By default NexT shows the post created date in post meta section and created time in popup. You can disable it by setting value post_meta.created_at to false in NexT config file.

NexT config file
post_meta:
  created_at: true

Make sure you set use_date_for_updated and updated_option in Hexo config file correctly, otherwise this option will not take effect. See also Date / Time format.

By default NexT shows the post updated date in post meta section and updated time in popup. You can disable it by setting value post_meta.updated_at.enable to false in NexT config file.

NexT config file
post_meta:
  updated_at:
    enable: true

By default, if updated/edited date is the same as created date, edited time would be displayed in popup message. You can disable it by setting value post_meta.updated_at.another_day to false in NexT config file.
In other words:

  • If true, show updated date label only if updated date is different from created date (post edited in another day than was created).
  • And if post was edited in same day as created, edited time will show in popup title under created time label.
  • If false show anyway, but if post edited in same day, show only edited time.
NexT config file
post_meta:
  updated_at:
    another_day: true

By default NexT shows the post categories in post meta section. You can disable it by setting value post_meta.categories to false in NexT config file.

NexT config file
post_meta:
  categories: true

Post Wordcount

Install hexo-word-counter by executing the following command in site root dir:

npm install hexo-word-counter
hexo clean

Activate this plugin in Hexo config file by enabled any option:

By default NexT shows the number of post words in post meta section. You can disable it by setting value symbols_count_time.symbols to false in Hexo config file.

Hexo config file
symbols_count_time:
  symbols: true

By default NexT shows the estimated reading time of post in post meta section. You can disable it by setting value symbols_count_time.time to false in Hexo config file.

Hexo config file
symbols_count_time:
  time: true

By default NexT shows the number of all posts words in footer section. You can disable it by setting value symbols_count_time.total_symbols to false in Hexo config file.

Hexo config file
symbols_count_time:
  total_symbols: true

By default NexT shows the estimated reading time of all posts in footer section. You can disable it by setting value symbols_count_time.total_time to false in Hexo config file.

Hexo config file
symbols_count_time:
  total_time: true

awl means the average Word Length (chars count in word). You can check this here.

NexT config file
symbols_count_time:
  awl: 4

wpm means the average words per minute. You can check this here.

NexT config file
symbols_count_time:
  wpm: 275

After the plugin enabled, you may adjust options in symbols_count_time section in NexT config file:

By default NexT shows the words counts and estimated reading time in a separated line. You can add them into one line by setting value symbols_count_time.separated_meta to false in NexT config file.

NexT config file
symbols_count_time:
  separated_meta: true

By default NexT doesn't shows the text description of the words counts and estimated reading time in footer section. You can enable it by setting value symbols_count_time.item_text_total to false in NexT config file.

NexT config file
symbols_count_time:
  item_text_total: true

Tag Icon

By default, tags at the bottom of posts have a symbol # at there left side.

If you prefer icon instead of symbol, edit NexT config file like following:

NexT config file
tag_icon: true

More and more online blogging platforms (e.g. WeChat public accounts, Jianshu, Zhihu) support donate (sponsor). To catch paid reading trends, we added donate feature, supports WeChat, Alipay and Bitcoin. What you need is:

  1. Get your WeChat / Alipay / Bitcoin receive money QRcode image(s) and put into source/images under theme directory or upload it(them) to an image cloud to get the absolute HTTP address(es).

  2. Set needed values in NexT config file:

    NexT config file
    # Donate (Sponsor) settings
    # Front-matter variable (nonsupport animation).
    reward_settings:
      # If true, a donate button will be displayed in every article by default.
      enable: true
      animation: false

    reward:
      wechatpay: /images/wechatpay.png
      alipay: /images/alipay.png
      bitcoin: /images/bitcoin.png

You can also add QRcode of other platforms, e.g.

NexT config file
paypal: /images/paypal.png
monero: /images/monero.png

Follow Me

NexT config file
# Subscribe through Telegram Channel, Twitter, etc.
# Usage: `Key: permalink || icon` (Font Awesome)
follow_me:
  #Twitter: https://twitter.com/username || fab fa-twitter
  #Telegram: https://t.me/channel_name || fab fa-telegram
  #WeChat: /images/wechat_channel.jpg || fab fa-weixin
  #RSS: /atom.xml || fa fa-rss

You can add links of other platforms not listed here, for example:

NexT config file
follow_me:
  Zhihu: https://www.zhihu.com/people/username || fab fa-zhihu

NexT supports the related posts functionality according to hexo-related-posts.

Post Edit

NexT supports the edit functionality of your posts. By enabling this feature, users can quickly browse and modify the blog's source code on GitHub.

You can enable it by setting value post_edit.enable to true in NexT config file.

NexT config file
post_edit:
  enable: true

You should create a source repository of your post files. The url setting depends on the source project in github.

  • For site repository
    • Link for view source: url: https://github.com/.../tree/master/source/_posts/
    • Link for fork & edit: url: https://github.com/.../edit/master/source/_posts/
  • For post repository
    • Link for view source: url: https://github.com/.../_posts/tree/master/
    • Link for fork & edit: url: https://github.com/.../_posts/edit/master/
NexT config file
post_edit:
  url:

Post Navigation

Show previous post and next post in post footer if exists.

NexT config file
post_navigation: left
0%