NexT

Breaking Changes

Rename some language code

Please change your hexo/_config.yml:

language: <new language-code>

• zh-Hans to zh-CN for better compatability. (e1e6cf8)
• fr-FR and nl-NL to fr and nl. (ee91573, ec5e9db)

Refactored license_content & Fixed excess spaces. (4003a0e)

Features

• Added: Bookmark feature (#63)

  bookmark: enable: true save: auto # or manual

• Added a switch to choice whether it will unescape the HTML strings for local searching (#90)

  local_search: ... # unescape html strings to the readable one unescape: true

• Added: Support to set whether the sidebar will be shown in each single post. (#93)

  ... date: 2018-01-28 21:16:00 sidebar: false --- ...

• Added docs of Algolia search (#91)

Optimizations

• Updated: Rename en.yml on _en.yml to set undefined language as default.
  If language file will not find by Hexo, Hexo will use first finded language (_en.yml). (03e357b)
• Updated: Rename «Words count in article» on «Symbols count in article». (9d46733)
• Updated translation for the core languages.
• Updated math.per_page to default true to make math lazyloaded. (#66)
• Updated: Add more seo things. (#85)

Bug Fixes

• Fixed a little mistakes in MATH.md docs file. (a3a2321, 6582d75, 79582ed)
• Fixed: Math script loaded in tags and archives pages (#78, #81)
• Fixed the exists categories/tags count issue in the sidebar. (#87, addition fix to #42)
• Fixed an issue about the algolia search overlay. (#89)

For full changes, see the comparison between 6.0.2 and 6.0.3

Detailed changes for NexT v6.0.3

Breaking changes

MathJax (#32) [See docs for details]

Old configuration:

-# MathJax Support
-mathjax:
-  enable: false
-  per_page: false
- cdn: //cdn.bootcss.com/mathjax/2.7.1/latest.js?config=TeX-AMS-MML_HTMLorMML

New configuration:

# Math Equations Render Support
math:
  enable: false

  # Default(false) will load mathjax/katex script EVERY PAGE
  # If you set to true, you need to add 'mathjax: true' in Front Matter of post
  # in order to render math equations in post
  per_page: false

  engine: mathjax
  #engine: katex

  # hexo-rendering-pandoc (or hexo-renderer-kramed) needed to full MathJax support.
  mathjax:
    # For newMathJax CDN (cdnjs.cloudflare.com) with fallback to oldMathJax (cdn.mathjax.org).
    cdn: //cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML
    # For direct link to MathJax.js with CloudFlare CDN (cdnjs.cloudflare.com).
    #cdn: //cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML
    # For automatic detect latest version link to MathJax.js and get from CloudFlare.
    #cdn: //cdn.bootcss.com/mathjax/2.7.1/latest.js?config=TeX-AMS-MML_HTMLorMML

  # hexo-renderer-markdown-it-plus (or hexo-renderer-markdown-it with markdown-it-katex plugin)
  # needed to full Katex support.
  katex:
    # Use Katex 0.7.1 as default
    cdn: //cdnjs.cloudflare.com/ajax/libs/KaTeX/0.7.1/katex.min.css
    # If you want to try the latest version of Katex, use one below instead
    #cdn: //cdn.jsdelivr.net/katex/latest/katex.min.css

Features

• Added katex support (#32) (See breaking changes above)
• Added: Support to lazy load the disqus comments (#34)

  disqus: lazyload: true

• Added cheers_enabled config option (#43)

  # Enable "cheers" for archive page. cheers_enabled: true

• Added pangu.js instead of auto_spacing in hexo (#51, #56)

  # Pangu Support # Dependencies: https://github.com/theme-next/theme-next-pangu # For more information: https://github.com/vinta/pangu.js pangu: true

• Added updated_diff option to post_meta (#50)

  post_meta: created_at: true updated_at: true updated_diff: true

• Added: Load custom files from outside the theme (#31, f968ffc, 12fe131, 1cb4d08, 8744238)

  # Redefine custom file paths. Introduced in NexT v6.0.2. # If commented, will be used default custom file paths. # 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 styles: source/_data/styles.styl #mixins: source/_data/mixins.styl variables: source/_data/variables.styl

Optimizations

• Updated google-analytics.swig (#45)
• Updated translation for the DATA-FILES.md changes. (#47)
• Updated <img src="/image-url" class="full-image" /> BUG (#52, 5a70fd3)

Bug Fixes

• Fixed misleading description of gitment (#22)
• Fixed: move needmoreshare_css to head (#26)
• Fixed: Turn OFF javascript with motion enable result in a blank page [fix added] (#27, d2be4fa)
• Fixed a position bug of the github_banner on the mobile layout. (#29, 3337b50)
• Fixed underlined category under title ends in an extra blank [fix added] (#36, 08d35be)
• Fixed: Add comment.enable to switch comment conveniently (#39)
• Fixed: <link rel="canonical" href="URL"/> is wrong! [fix added] (#40, bad4334)
• Fixed an issue about the categories/tags count. (#42)
• Fixed: Override theme's scheme from main config [fix added] (#44, 1b0b53a)
• Fixed reading_progress appear in index (#55)

For full changes, see the comparison between 6.0.1 and 6.0.2

Detailed changes for NexT v6.0.2

Breaking changes

Remove Duoshuo (#14)

Old configuration:

-# Duoshuo ShortName
-#duoshuo_shortname:

-# Share
-#duoshuo_share: true

-# Make duoshuo show UA
-# user_id must NOT be null when admin_enable is true!
-# you can visit http://dev.duoshuo.com get duoshuo user id.
-duoshuo_info:
-  ua_enable: true
-  admin_enable: false
-  user_id: 0
-  #admin_nickname: Author

Menu Icons (2412fbc)

Old configuration:

-# Enable/Disable menu icons. 
-menu_icons: 
-  enable: true

New configuration:

# Enable/Disable menu icons / item badges. 
menu_settings: 
  icons: true 

Features

• Added reading_progress (#5)
• Several improvements in main menu on all schemes. (#8, 2412fbc)
• Added «Follow me on GitHub» banner option. (caf0738)

Optimizations

• Clean duoshuo plugin due support discontinued from June 1, 2017 (#14, 0e5ab06)
• Update path on Local Search dependencies. (feb1968)
• Update config for FancyBox 2 & 3. (fd89b29)
• Updated MathJax CDN links & added short docs to them. (be3528f)

Bug Fixes

• Fixed a bug of the reward and the wechat-subscriber template (#6)
• Fixed: In mobile, menu content will cover side bar (Muse scheme).
• Fixed menu items excess spaces. (06f9d8b)

For full changes, see the comparison between 6.0.0 and 6.0.1

Detailed changes for NexT v6.0.1

Because NexT is growing up with each year, there are more and more external libs, so:

• General maintenance became a harder for all who not only use it, but help with development too.
• Generation speed became slower and slower with each new library. Half of unused libs copied to public dirs for all users and search engines see all this libs too. It's mostly waste files for half NexT users.
• Full weight of NexT distributive at least decrease about 2x, which provides faster download / update speed.

In other words: this changes increase development speed, generation speed and download speed.

Changes

There are no hard breaking changes between 5.1.x and 6.0.x versions. It's change major version to 6 because:

• CHANGED Main repo was rebased from [iissnan's][] profile to [theme-next][] organization.
• IMPROVED Most libraries under the `next/source/lib` directory was moved out to [external repos under NexT organization][theme-next].
• IMPROVED 3rd-party plugin [hexo-wordcount][] was replaced by [hexo-symbols-count-time][] because `hexo-symbols-count-time` no have any external nodejs dependencies, no have [language filter][] which causes better performance on speed at site generation.
• ADDED Cache option to increase content generation speed.

Full Changes

You can also see full changes for NexT v6.0.0

Update from Version 5

See how to update from v5 to v6 guide.

3rd-party Libraries

See adding plugins section.