warehouse 3.0.0

Breaking change

• Replace constructor function to class declaration #30, refer to the docs for more info on updating to the new syntax.
• chore: drop node 6 #49

Refactor

• Remove old compatibility code #57
• Convert method definitions #52
• Split Schema class #58
• refactor: use instanceof Date instead of util.isDate #37

hexo-util 1.3.1

Fix

• fix(encode_url): skip encode non-urls #102

hexo-util 1.3.0

Breaking change

• fix(html_tag): escape html and encode url by default #93
  • insert false to the 4th argument to disable escape
  • e.g. htmlTag('a', {href: 'http://foo.com/'}, '<b>bold</b>', false)

Feature

• feat: decodeURL() #97

Fix

• fix(encodeURL): encode path once only #92
• fix(html_tag): encode url value of url-related attributes and skip escape/encode <style> #96
• fix(html_tag): encode url() in style tag #101

hexo-util 1.2.0

Feature

• add gravatar() #81
• add url_for() & relative_url() #82
• add full_url_for() #84

Fix

• fix(encodeURL): support hash/anchor, auth and port number #85

hexo-filter-nofollow will add rel="external nofollow noreferrer" to all external links automatically for security, privacy and SEO. Read more.

You can install this plugin using the command below:

$ npm i hexo-filter-nofollow --save

More configurations please checkout the README of hexo-filter-nofollow

hexo-i18n 1.0.0

Breaking change

• chore: require at least node 8 #15

Refactor

• es6-fy #5, #6, #17

Housekeeping

• chore(package): use eslint intead of jscs #4

hexo-clean-css 1.0.0

Breaking change

• chore: require at least node 8 #13

Feature

• replace minimatch with micromatch #16

Refactor

• test: drop gulp and jshint #14

hexo-util 1.1.0

Feature

• feat: add encodeURL() #77

hexo-server 1.0.0

Breaking change

• Drop node 6 #87

Refactor

• Refactor: es2016nify #68
• refactor: Test refactor es2016 #67

Housekeeping

• Move jscs to eslint #65

hexo-front-matter 1.0.0

Breaking change

• chore: drop node 6 #18

Refactor

• Migrate to ES6 #9

Housekeeping

• Use eslint instead of jscs #10

hexo-fs 2.0.0

Breaking change

• Drop node 6 #34

Refactor

• Object.hasOwnProperty syntax for compatibility with eslint v6 #37
• Refactor(test): useful chai-as-promised #43
• Destructure path module #44
• Refactor(test): Tuple to Object map #45

hexo-generator-tag 1.0.0

Breaking change

• chore: require at least node 8 #25

Feature

• Add the “order_by” option #22

Refactor

• refactor(package): use Object.assign instead of object-assign package #14
• refactor(ES2015): use let/const & arrow-return #16
• refactor: es6-fy #26

hexo-renderer-ejs 1.0.0

Breaking change

• chore: drop node 6 #20

Feature

• Upgrade ejs to v2 (w/ comments support) #5. Support <%# ... %>.

Refactor

• refactor: use Object.assign and var to let/const #8
• chore(eslint): use eslint instead of jscs #10

hexo-renderer-stylus 1.0.0

Breaking change

• chore: require at least node 8 #33

Fix

• upgrade dependencies and make it be compatible with node v6 #13

Refactor

• refactor: es6-fy #34

Housekeeping

• chore(package): delete jscs #26
• remove useless file from npm module #27

hexo-renderer-stylus 1.1.0

Feature

• feat: configurable plugins #38

hexo-util 1.0.0

Breaking changes

• Drop Node 6 compatibility #61
• Deprecate hashStream #45, use createSha1Hash()

Features

• Add Color class from tagcloud hexo helper #58
• Allows empty attributes in html tag helper #36

Fixes

• fs.write instead of stdout #69
• prevent firstLine being parsed as a string #67
• Fix the part where the public API createSha1Hash() was not exported. #47

Refactor

• camel_case_keys.js #48
• ES6 #44 #46 #70

hexo-renderer-marked 2.0.0

Breaking changes

• Drop Node 6 compatibility #98
• sanitize option has been deprecated, replaced by sanitizeUrl with limited functions #102
• tables option has been deprecated. Enabling gfm option also enables tables #102
• Refer to upstream’s changelog for details on possible breaking changes.

Features

• Add option to disable headerIds #106

Refactor

• ES6 #97 #104

• Updated hexo-renderer-marked to 1.0.1 #3571
• Updated hexo-fs to 1.0.0 #3301
• TOC: Seek anchor id from parent nodes when target is not available #3404
• tag/include_code now can include ranged code lines [#3393]

Bug Fixes

• DisableNunjucks: true should render markdown code block #3573
• Changing source config should generate assets #3399

Refactor

• Spread function: Hexo built-in plugin blockquote #3291
• ES6 block scoping refactor #3294
• Use spread syntax #3333

Housekeeping

#3326, #3324, #3315, #3300, #3329, #3359, #3369, #3368, #3367, #3569

More info: changelog

Breaking changes

• #28 Require Node.js +6.9

Fixes

• #45 Fixed the invalid type error while running init with a numeric folder name

Improvements

• #29 Reveal GIT_REPO_URL in log
• #46 Remove useless file from npm module

Refactor

• #62, #65 Migrate to ES2015

Dependencies

• #30 Drop JSCS & use ESLint instead it
• #31 Drop object-assign
• #34, #40 Update Sinon from 1.17.4 to 7.1.1
• #35, #47, #58, #61 Update mocha requirement from ^2.5.3 to ^6.1.4
• #36, #67 Update hexo-renderer-marked requirement from ^0.2.10 to ^1.0.1
• #37 Update rewire requirement from ^2.5.1 to ^4.0.1
• #38, #50 Update chai-as-promised requirement from ^5.3.0 to ^7.2.7
• #39, #50, #51, #52, #55 Update eslint requirement from ^4.19.1 to ^5.16.0
• #41 Update chai requirement from ^3.5.0 to ^4.2.0
• #42 Update proxyquire requirement from ^1.7.9 to ^2.1.0
• #43 Update hexo-fs requirement from ^0.2.0 to ^1.0.0
• #44 Update chalk requirement from ^1.1.3 to ^2.4.1
• #50 Update all packages to latest and include package-lock.json
• #56, #70 Bump bluebird from 3.5.3 to 3.5.5
• #50, #63, #68 Bump resolve from 1.5.0 to 1.11.0

Breaking changes

• #92 Require Node.js +6.9
• #39, #46, #62 Markdown todo list render into disable checkbox
• #87 Update marked 0.3.9 to 0.6.1
  • It has some breaking changes. Please see marked’s breaking changes.
    • v0.4.0
    • v0.5.0
    • v0.6.0

New feature

• #55 Add support for basic description/definition lists

Fixes

• #70 Text less than 3 chars is not italicized

Dependencies

• #73, #84 Update mocha requirement from ^4.0.1 to ^6.0.0
• #74 Update babel-eslint requirement from ^8.0.3 to ^10.0.1
• #76 Update eslint-config-hexo requirement from ^2.0.0 to ^3.0.0
• #77 Update eslint requirement from ^4.13.1 to ^5.9.0
• #81 Delete jscs dependency
• #91 Delete object-assign

Miscellaneous

• #96 Shrinked packed size & fix npm installation due to existence of .git folder in v1.0.0

Docs

• #79 Update docs to explain modifyAnchors option

BREAKING Changes

• Replace swig with swig-templates #100

Improvements

• specify files to shrink package size ca449bb

Fixes

• Fix the install command in npm@5 #86
• Inherit stdio for spawned git process #82

Update dependencies

• Update vulnerabilities dependencies #110
• Update babel-eslint requirement from ^7.2.1 to ^10.0.1 #116
• Update hexo-fs requirement from ^0.2.0 to ^1.0.0 #115
• Update chai requirement from ^3.5.0 to ^4.2.0 #113
• Update chalk requirement from ^1.1.3 to ^2.4.1 #114

Docs

• Add Notice on pushing github errors 4a2e283
• Update installation section 288b415

CI

• Update ci services target nodejs version #111

Update dependencies

• Update autoprefixer to v9 #8
• Update postcss to v7 #9
• Remove object-assign dependency #15
• Update eslint & delete jscs #17

Docs

• Add quotes in exclude section #7

hexo-filter-responsive-images 1.4.0 & 1.4.1

1.4.0

Update dependencies

• update sharp to 0.21 #20
• update bluebird to 3.5.3 #21

1.4.1

Update dependency

• update sharp to 0.21.1 #29

Improve

• configuration file follows the new sharp API backward compatibility is preserved though a compilation warning suggests steps to upgrade config file. #25, #26, #27, #28

hexo-asset-pipeline 1.7.0

Update dependency

• update imagemin-optipng requirement from ^5.2.1 to ^6.0.0 #37

hexo-fs 1.0.1

Refactor

Minor performance tuning #23

Housekeeping

Updated devDependencies #25
Shrink package size 33fceb5425be6c48659147cb7a778617d3262af1

Others

There is no breaking change from 0.2 to 1.0.

hexo-renderer-less 1.0.0

Breaking changes

Updated less 2.5.1 to 3.9.0, see the changelog of less.

• Supported absolute config path #3118
• Added command line option --output to write db.json and _multiconfig to different paths #3122
• Added meta generator injection filter #3129

Housekeeping

#3124, #3117, #3102, #3276, #3284, #3285, #3290, #3293

More info: changelog

It’s all about speed

Caching rendered contents

Rendered contents are cached in the warehouse. This saves a lot of time and made hot processing (2nd-time processing) 1.7x faster.

Lazy load language files of highlight.js

highlight.js is slow. Especially when it try to detect the language. Lazy load language files make processing faster and don’t have to load bunch of unused language files. However there’re some limitations:

• Auto detect must be disabled.
• You have to specify language in code block.

You can set auto detect disabled in _config.yml.

highlight:
  auto_detect: false

Templates precompilation

Theme templates are precompiled if possible. It makes generation speed 2x faster.

The following renderers have already supported this feature.

• hexo-renderer-ejs
• hexo-renderer-jade
• hexo-renderer-swig

And it’s easy to implement precompilation for renderers. Just add a compile function to the renderer. Take EJS renderer for example:

var ejs = require('ejs');
var assign = require('object-assign');

function ejsRenderer(data, locals) {
  return ejs.render(data.text, assign({filename: data.path}, locals));
}

ejsRenderer.compile = function(data) {
  return ejs.compile(data.text, {
    filename: data.path
  });
};

module.exports = ejsRenderer;

Include/exclude source files

You can include/exclude specified source files in _config.yml.

include:
  - .htaccess

exclude:
  - tmp/**/*

More info: changelog, benchmark results.

What’s Changed?

There’re many improvements in Hexo 3. Better performance, API is easier to use, higher coverage, etc. Here’re some notable changes:

• New CLI: Command line interface is separated into a stand-alone module: hexo-cli
• Slimmer Core Module: Generators, deployers and server are also separated from the main module.
• New Generator API: Generator API changed a lot in Hexo 3.
• Include Assets in a Post: Serveral useful tag plugins are added in Hexo 3: post_path, post_link, asset_path, asset_link, asset_img.
• Async Tag Plugins: Tag plugins can do async jobs now!
• Timezone Support: You can define the timezone of your site now.

More info: Breaking Changes in Hexo 3.0, changelog

How to Update?

1. Modify package.json.

   { "hexo": { "version": "" } }

2. Install hexo-cli. If any error occurred, try to remove hexo first.

   $ npm install hexo-cli -g

3. Install Hexo.

   $ npm install hexo --save

4. Install plugins. You don’t have to install all the following plugins. It depends on your need.

   $ npm install hexo-server --save $ npm install hexo-generator-index --save $ npm install hexo-generator-archive --save $ npm install hexo-generator-category --save $ npm install hexo-generator-tag --save $ npm install hexo-deployer-git --save $ npm install hexo-deployer-heroku --save $ npm install hexo-deployer-rsync --save $ npm install hexo-deployer-openshift --save

5. Update plugins. Especially generators and filters. Since the API has breaking changes in Hexo 3.

More info: Migration from 2.x to 3.0

Official Registry

Besides the new theme, a official registry for plugins and themes finally comes. The registry makes you easier to browse and search plugins. And you can preview themes with screenshots.

How to add my plugin/theme to the registry?

See the following articles for more info. Your plugin/theme will be published to the registry once the pull request is merged.

• Publish a theme
• Publish a plugin

Localization

We have add two new languages of documentation: Tranditional Chinese (正體中文) and Simplified Chinese (简体中文). Thanks to pinggod for the Simplified Chinese translation. We very welcome you to help us translating and make more people easier to get started with Hexo! For more info, see translating documentation.

Where’s API Documentation?

The API documentation is hidden so far. Please be patient. I’m updating it now. The new API doc will be released in a few days.

Faster Processing Speed

Before Hexo 2.8, all source files have to be processed each time you use Hexo. In Hexo 2.8, the entire database will be saved to db.json so Hexo don’t have to process all files again. Also, a new data type “skip“ was added for processors to detect whether a file was changed or not.

Generating was also changed in Hexo 2.8. You can check the elapsed time of each file in console now. However, I found multi-process generating didn’t affect generating speed a lot. Thus, multi_thread and max_open_file setting are deprecated in Hexo 2.8.

Draft Publish

You don’t have to enter full file name to publish a post anymore. Draft publish system is rewritten in Hexo 2.8. new_post_name setting will be applied until drafts are published. Besides, you can choose which layout to apply when publishing.

$ hexo publish [layout] <filename>

A new API post.publish was added to help you publish drafts more easily.

hexo.post.publish({slug: 'hello-world', layout: 'post'}, function(err, target){
  // ...
});

Permalink

File name and permalink now share a more universal variable system. Every variables in file name can also be read in permalink. Here’s a config for example:

permalink: :type/:title/
new_post_name: :type/:title.md

When you create a post, the post will be saved to source/_posts/test/Hello-World.md and the URL will be http://localhost:4000/test/Hello-World/.

$ hexo new "Hello World" --type test

Multi-language Support

With the new permalink introduced in the previous section, it’s much easier to create a multi-language site. For example:

permalink: :lang/:title/
new_post_name: :lang/:title.md

Then you can create a post with --lang option:

$ hexo new "Hello World" --lang en
# => This post will be saved to source/_posts/en/Hello-World.md
# => URL: http://localhost:4000/en/Hello-World/

$ hexo new "你好世界" --lang tw
# => This post will be saved to source/_posts/tw/你好世界.md
# => URL: http://localhost:4000/tw/你好世界/

You can define the default value of permalink variables in permalink_defaults setting. For example, we define the default language as English.

permalink_defaults:
  lang: en

Fragment Caching

Although Hexo is fast, it may become slow if you have thousands of source files or complicated categories or tags. Before the data model upgraded, I borrowed a feature from Ruby on Rails: Fragment Caching.

Fragment Caching saves contents within a fragment and serves the cache when the next request come in. A fragment will only be processed once. It can reduce database queries and decrease generation time significantly. For instance, a Hexo site with 300+ source files needs 6 minutes to generate. In Hexo 2.7, it only need 10 seconds!

It can be used in header, footer, sidebar or static contents that won’t be changed during generating. For example:

<%- fragment_cache('header', function(){
  return '<header></header>';
}); %>

By using fragment_cache helper, contents in the function will be cached.

Partial helper also supports Fragment Caching, you only need to add a {cache: true} option when using partial.

<%- partial('header', {}, {cache: true}) %>

Landscape is updated and supports Fragment Caching now. You can check this commit to see what’s changed.

Relative Link

Relative Link is supported since Hexo 2.7. But your theme needs some modifications to support it. However, it’s not as hard as you think. You just need to replace the following contents in templates

<%- config.root %><%- path %>

with url_for helper.

<%- url_for(path) %>

url_for helper will add config.root automatically for you. If you enable relative_link setting, it’ll add a relative path.

Landscape is updated for Relative Link. You can check this commit to see what’s changed.

Server Middleware

Server Middleware would be familiar if you have ever used Connect or Express before. Connect passes a request through functions called middleware. You can make response to the coming in request in middleware.

In Hexo, middleware is served as a type of filter. You can add middleware by registering a new filter. For example:

hexo.extend.filter.register('server_middleware', function(app){
  app.use(function(req, res, next){
    res.setHeader('X-Powered-By', 'Hexo');
    next();
  });
});

This middleware add a header X-Powered-By and passes the request to the next middleware.