v6.4.1

Optimizations

• New Crowdin translations (#386)

Bug Fixes

• Fix bugs where images other than avatars will also rotate (#396)
• Fixed firestore use wrong variables problem (#388)
• Refactor lean-analytics.swig to use REST API to avoid conflicts with valine (#381)
• Fixed the refer website of Livere comment (#395)

---

For full changes, see the comparison between 6.4.0 and 6.4.1

v6.4.0

Breaking Changes

Removed HyperComments because for now only paid. =( (#342)

Custom sidebar width & content width for all schemes. (#339)

Old configuration:

-# Manual define the max content width 
-# !!Only available for Gemini Scheme currently 
-# Leave it empty for the default 75% (suggest not less than 1000px) 
-#max_content_width: 1000px 
 
-# Manual define the sidebar width 
-# !!Only available for Gemini Scheme currently 
-# Leave it empty for the default 240 
-sidebar_width: 

New configuration:

sidebar:
  # Manual define the sidebar width. 
  # If commented, will be default for: 
  # Muse | Mist: 320 
  # Pisces | Gemini: 240 
  width: 300 

Features

• Update valine comment system version. (#345)

Optimizations

• Add Labels Rules guideline (#355)
• Simplify post-reward.styl (#359)
• New Crowdin translations (#362)
• Delete youyan comment (#360)
• Update UPDATE-FROM-5.1.X.md (#324)
• Add CDN examples for theme-next-three (#335)

Bug Fixes

• Refactor add baidu_site_verification in _config.yml (#322)
• Replaced — with – for better visibility. (#368, #341)
• Fixes indentation for note and tabs tags. (#358)
• Refactor the share tools within post-widgets (#357)
• Fix the post date display bug (#302)
• Fixed NexT package.json path on Windows. (#343)

---

For full changes, see the comparison between 6.3.0 and 6.4.0

v6.3.0

Breaking Changes

Added avatar rounded & opacity & rotated feature (#267)

Old configuration:

 # Sidebar Avatar
-# in theme directory(source/images): /images/avatar.gif
-# in site  directory(source/uploads): /uploads/avatar.gif
-#avatar: /images/avatar.gif

New configuration:

 # Sidebar Avatar
+avatar:
+  # in theme directory(source/images): /images/avatar.gif
+  # in site  directory(source/uploads): /uploads/avatar.gif
+  # You can also use other linking images.
+  url: #/images/avatar.gif
+  # If true, the avatar would be dispalyed in circle. 
+  rounded: false
+  # The value of opacity should be choose from 0 to 1 to set the opacity of the avatar.
+  opacity: 1
+  # If true, the avatar would be rotated with the cursor.
+  rotated: false

Features

• Added Hexo and NexT environment variables. (#240)
• Added the support for copy result in code block. (#282)
• Added the support for automatic equation numbering with Mathjax. (#275)
• Added custom language support feature. (#253)
• Allow customized copyright contents (#254) Feature already exists in #253

Optimizations

• Updated translations for core languages. (#239 , #243 , #252 , #285)
• Updated the Telegram links in README.md. (a99777e)
• Aligned badges in README.md. (0fec1e6)
• Updated the badges in README.md. (#250 , d599c4e)
• Changed the copy-button position to absolute. (#242 )
• Removed author translated key introduced by Duoshuo. (20ece25)
• Fixed errors in document for LeanCloud Counter Security Plugin. (#255 )
• Removed Houndy and JSHint linter files. (e383523)
• Updated the rss annotation using site's feed link. (d2c74b3)
• Temporarily changed the node_js to LTS node version. (2eacca2)

Bug Fixes

• Fixed text font of the Mist scheme on mobile. (#262)
• Fixed logic bug in Han. (#260)
• Fixed the incorrect URL decoding of more with scroll_to_more. (#293, 4cacb10)

---

For full changes, see the comparison between 6.2.0 and 6.3.0

v6.2.0

Breaking Changes

Minimal correct support for NexT is Hexo v3.5.0 for now.

It's not actually breaking changes, just after this version highly recommend to use NexT with at least Hexo v3.5.0 or higher for avoid all possible bugs.

Hexo v3.5.0 also provides:

• Replaced swig by swig-templates to mitigate uglifyjs 2.4 security vulnerability: hexojs/hexo#2949
• Additional templates support which will be used in next NexT releases.

P.S. You can still use old Hexo versions, but NexT will not guarantee in future releases for correct rendering.

Added footer.powered.version option to display Hexo version in footer. (#214, 8c139be)

Old configuration:

footer:
-  powered: true

New configuration:

footer:
  powered:
    # Hexo link (Powered by Hexo).
    enable: true
    # Version info of Hexo after Hexo link (vX.X.X).
    version: true

Refactored post_meta.updated_at option & replaced updated_diff by another_day option (#223, #228)

Old configuration:

post_meta:
  item_text: true
  created_at: true
- updated_at: false
- # Only show 'updated' if different from 'created'.
- updated_diff: false
- # If true, post's time format will be hexo config's date_format + ' ' + time_format.
- date_time_merge: false

New configuration:

post_meta:
  item_text: true
  created_at: true
  updated_at:
    enabled: true
    # If true, show updated date label only if `updated date` different from 'created date' (post edited in another day than was created).
    # And if post will 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.
    another_day: true
  categories: true

Features

• Added post edit button (#208, 30bccfc)
• Added support for hexo-symbols-count-time v0.4.0 (#233)
• Added copy codeblock button (#234, #238)

Optimizations

• Update guide for creating releases in CONTRIBUTING.MD (#213)
• Remove unused language files. (1d89f8f)
• Updated translations for core languages. (#211, #235)

Bug Fixes

• Increase page loading performance by refactor menu-item-active class. (6f787af)
  Refactored files hierarchy for header components. (#221)
• Fix for default language if no language in Hexo config defined. (#210)
  Renamed back _en.yml on en.yml and setted default.yml to link it. (adc76b7)
• Refactored menu items & badges.
  Fixed bug with appear dot in submenu with disabled badges in Pisces/Gemini schemes. (#229)

---

For full changes, see the comparison between 6.1.0 and 6.2.0

v6.1.0

Breaking Changes

Refactor footer icon with animation (#195)

Old configuration:

footer:
  # Specify the date when the site was setup.
  # If not defined, current year will be used.
  # since: 2015
  # Icon between year and copyright info.
-  icon: user

New configuration:

footer:
  # Specify the date when the site was setup.
  # If not defined, current year will be used.
  # since: 2015
  # Icon between year and copyright info.
+  icon: 
+    # Icon name in fontawesome, see: https://fontawesome.com/v4.7.0/icons
+    # `heart` is recommended with animation in red (#ff0000).
+    name: user
+    # If you want to animate the icon, set it to true.
+    animated: false
+    # Change the color of icon, using Hex Code.
+    color: "#808080"

Features

• Added comment count on mobile. (#185)
• Added caption for comment. (#186)
• Added border-radius settings of code block and updated its style with a caption. (#194)

  +# Manual define the border radius in codeblock, using a space indent.
  +# Leave it empty for the default 1
  +codeblock:
  +  border_radius: 
  +

• Added backlog label to exclude labels. (2a841a9)
• Added English document for LeanCloud Counter Security Plugin. (#174)
• Added English and Chinese document for contributing.md. (#192)
• Added English and Chinese document for code-of-couduct.md. (#198)

Optimizations

• Reverted the beta version of LeanCloud Counter Security Plugin. The option leancloud_visitors.security: true by default at present. (d297cf5)
• Updated English document for LeanCloud Counter Security Plugin. (#175, #177, #204)
• Updated Chinese document for LeanCloud Counter Security Plugin. (#177, #204)
• Optimized symbol colon in item text of post meta. (#188)
• Updated translations for core languages. (c6aaa42, #189)
• Updated links in README.md. (bd6c789)
• Updated CDN instructions in Chinese README.md. (ca2554b)

Bug Fixes

• Fixed a bug in utils.js to prevent the error of i is not defined. (#205)

---

For full changes, see the comparison between 6.0.6 and 6.1.0

v6.0.6

Breaking Changes

Removed duplicated meta tag keywords (#115, #168)

Since Hexo v3.3.5 has already keywords meta tags, NexT decided not to generate keywords meta tags to avoid duplication. This change means if you are still using Hexo < 3.3.5, your site will not generate keywords meta tags for you.

So, from this release minimal requirements for NexT is Hexo v3.3.5 or highter.

Old configuration:

hexo_dir/themes/next/_config.yml

-# Set default keywords (Use a comma to separate)
-keywords: "Hexo, NexT"

New configuration:

hexo_dir/_config.yml

# Set default keywords (Use a comma to separate)
keywords: "Hexo, NexT"

And this keywords will be for homepage only.

For other posts there are no breaking changes and tags/keywords can be setted in old style:

...
tags: [Sidebar, TOC, test]
...

OR

...
tags:
  - Sidebar
  - TOC
  - test
...

Features

• Added sub-menu feature (#156)

  menu:
    News: / || info-circle
    Docs:
      default: /docs/ || book
      Getting Started: /getting-started/ || flag
      Theme Settings: /theme-settings/ || star
      Third Party Services:
        default: /third-party-services/ || plug
        Algolia Search: /algolia-search/ || adn
      Tag Plugins: /tag-plugins/ || rocket
      Advanced Settings: /advanced-settings/ || rocket
      FAQ's: /faqs/ || life-ring
      Platforms: /platforms/ || retweet

Optimizations

• Updated translations (#167)
• Updated README (#166)
• Updated issue temple (#160)
• Imporved accessibility (#130)

Bug Fixes

• Fixed svg confict in Algolia (#173)
• Fixed margin between img and text (#161)
• Removed style table-layout: fixed; (#155)
• Fixed GitHub banner performance (#153)
• Fixed missing margin for H1 (#149)
• Fixed Mist margin settings consistence and a small typo (#148)
• Fixed a security bug in Leancloud Counter (#137, #171)
  Related plugin: hexo-leancloud-counter-security

---

For full changes, see the comparison between 6.0.5 and 6.0.6

v6.0.5

Features

• Added BreadCrumbs feature. (#136)
• Added include_raw tag. (#140)

  {% include_raw '_data/templates/custom.html' %}

Optimizations

• Update translations for core languages.
• Refactor some tags. (52b754f)

Bug Fixes

• Fix a syntax issue about IE compatible of valine & Allow to set custom CDN for valine. (#139)

---

For full changes, see the comparison between 6.0.4 and 6.0.5

v6.0.4

Breaking Changes

Busuanzi Count (#129)

Old configuration:

-# Show PV/UV of the website/page with busuanzi.
 # Get more information on http://ibruce.info/2015/04/04/busuanzi/	
 busuanzi_count:	
-  # count values only if the other configs are false	
   enable: false	
-  # custom uv span for the whole site
-  site_uv: true	
-  site_uv_header: <i class="fa fa-user"></i>
-  site_uv_footer:
-  # custom pv span for the whole site	
-  site_pv: true
-  site_pv_header: <i class="fa fa-eye"></i>	
-  site_pv_footer:	
-  # custom pv span for one page only	
-  page_pv: true	
-  page_pv_header: <i class="fa fa-file-o"></i>	
-  page_pv_footer:

New configuration:

+# Show Views/Visitors of the website/page with busuanzi.
 # Get more information on http://ibruce.info/2015/04/04/busuanzi/
 busuanzi_count:
   enable: false
+  total_visitors: true
+  total_visitors_icon: user
+  total_views: true
+  total_views_icon: eye
+  post_views: true
+  post_views_icon: eye

Remove signature option and stay only description for exclude users confused when seo: true (#125)

Features

• Added extlinks on sidebar author links. (#99)

  social_icons:
    ...
    exturl: false

• Added Turkish translation by https://crowdin.com/profile/intelligencer (#95)
• Added vendor config for bookmark (#106) and reading_progress (#107)

  vendors:
    ...
    bookmark: 
    reading_progress:

• Added max_content_width config for Gemini Scheme (#103)

  # Manual define the max content width
  # !Only available for Gemini Scheme currently
  # Leave it empty for the default 75% (suggest not less than 1000px)
  max_content_width: 1000px # or 90% for more wide, etc.

• Added sidebar_width config for Gemini Scheme (#111)

  # Manual define the sidebar width
  # !!Only available for Gemini Scheme currently
  # Leave it empty for the default 240
  sidebar_width:

• Added Related Posts (#109)

  # Related popular posts
  # Dependencies: https://github.com/tea3/hexo-related-popular-posts
  related_posts:
    enable: false
    title: # custom header, leave empty to use the default one
    display_in_home: false
    params:
      maxCount: 5
      #PPMixingRate: 0.0
      #isDate: false
      #isImage: false
      #isExcerpt: false

Optimizations

• Update translations for core languages.
• Update Math and related docs:
  1. Add bootcdn as optional CDN of math engine (#98)
  2. Use jsDelivr as the default math engine CDN (#101)
  3. Add docs about CDNJS blocked by some parts of China.
• Update: exturl tag — If no arguments exists as title, set title as url (#122)
• Update: Change default font size to 14px for Code Block (#123)
• Update algolia search docs with vendors (#119)
• Update creative commons license (#116)
• Update description for fonts and highlight_theme (470f026 82ac7af)

Bug Fixes

• Fixed needmoreshare2 vendors (#104)
• Fixed: Add missing data-fancybox attribute for fancybox (#126)
• Fixed justify TOC items in sidebar (#131)
• Fixed unworked transition in sidebar author links on Mist & Muse (#99)
• Fixed: Use .length instead of .size() to make it work with jquery 3.1 (#120)

---

For full changes, see the comparison between 6.0.3 and 6.0.4

v6.0.3

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

v6.0.2

Breaking changes

MathJax (#32) [See EN or CN 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 srcipt 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