Hexo Official Website Documentation

Hexo v6.0.0 introduced several functional improvements:

• Theme Plugin Loading: Hexo can now load plugins defined in a theme's package.json.
• Open Graph Support: The open_graph feature now supports different URLs for og:image and twitter:image.

The eslint-config-hexo package version 4.0.0 includes the following updates:

• Support for up to ES2020 syntax via eslint-plugin-node v10.
• Preference for ES6+ syntax.
• Removal of deprecated and duplicated rules.

Hexo 8.0.0 includes several key improvements:

New Features

• Hexo Context Binding: The hexo context is now bound to helper function callbacks.
• URL Config Validation: Added validation for url configuration.
• Permalink Variable: Added timestamp variable for permalinks.
• Backtick Code Blocks: Support for additional configuration options.
• Stricter Config Loading: load_config now enforces stricter extension checks.

Key Fixes

• Fixed hexo.locals.get('posts') to ensure all posts are displayed.
• Fixed parsing errors for code blocks located within list items.
• Fixed HTML escaping in the titles of code and include_code tags.
• Improved Swig tag handling to backtrack when tags are incomplete.

Hexo 3.0 introduces a modular architecture and several new features:

• Modularization: The CLI is now a standalone module (hexo-cli). The core module is slimmer, with generators, deployers, and the server moved to separate modules.
• New Generator API: The API for writing generators has changed significantly.
• Async Tag Plugins: Tag plugins now support asynchronous operations.
• Asset Management: New tag plugins allow including assets in posts: post_path, post_link, asset_path, asset_link, and asset_img.
• Timezone Support: You can now define a specific timezone for your site.

A Box is a container used for processing files within a specific folder. Hexo utilizes two primary boxes:

• hexo.source: Used to process the source folder.
• hexo.theme: Used to process the theme folder.

Boxes manage file loading, path matching, and the execution of processors to transform or handle file content.

Front-matter is a block of YAML or JSON placed at the very beginning of a file to configure settings for that specific piece of content (post or page).

• YAML: Terminated by three dashes (---).
• JSON: Terminated by three semicolons (;;;).

---
title: Hello World
date: 2013/7/13 20:46:25
---

Themes can now support alternate configuration files. Instead of only using the main _config.yml, a theme can look for a file named _config.[name].yml in the root folder (e.g., _config.landscape.yml for the landscape theme).

This allows for easier management of multiple theme settings without cluttering the primary configuration.

Hexo uses a Cache of Rendered HTML mechanism to improve performance. To optimize memory usage, the behavior of this cache differs based on the command used:

• hexo g (Generation): The cache is disabled during generation to reduce memory consumption, as each route is typically only used once during this process.
• hexo s (Server): The cache is enabled during the server process to speed up local previewing and development.

When you run hexo new, Hexo uses a template file from the scaffolds folder to build the new file. If you run hexo new photo "My Gallery", Hexo looks for photo.md in the scaffolds folder.

Available Scaffold Placeholders:

• layout: The layout assigned to the post
• title: The title of the post
• date: The file creation date

$ hexo new photo "My Gallery"

Hexo performance is measured using two types of generation processes:

1. Cold generation: Occurs when you run hexo clean before hexo g. This forces Hexo to re-render everything from scratch.
2. Hot generation: Occurs when you run hexo g without cleaning first. Hexo utilizes the warehouse (db.json) to cache rendered contents and only re-renders what has changed.

Understanding these modes helps you gauge the actual impact of changes to your site's content versus changes to the Hexo engine itself.

Starting with hexo-util 1.9.0, groundwork has been laid for Prism highlight support (in addition to the existing highlight.js support).

Key features for Prism include:

• Support for the data-language attribute.
• Support for mark and firstLine options.
• Support for strip_indent to handle indentation in code blocks.

Hexo uses specific templates to define the presentation of different page types. Every theme must contain at least an index template. If a specific template is missing, Hexo uses a fallback mechanism as defined below: