hexo-stats-echarts

Hexo-Stats-ECharts

NPM Version NPM Downloads License

hexo-stats-echarts is a lightweight and visually stunning Hexo plugin designed to help you effortlessly visualize and analyze your blog’s statistical data. With just one line of code, you can seamlessly integrate beautiful, customizable and interactive charts into any Hexo page or article.

Overview

Built on the Hexo Tag Plugins framework and powered by the versatile Apache ECharts library, this plugin transforms raw blog statistics—such as post frequency, tags, and categories—into elegant, interactive charts.

The charts dynamically adapt to your site’s theme, switching between dark mode and light mode based on your browser settings. Whether you’re tracking your writing habits or showcasing your blog’s activity, this plugin delivers a seamless and engaging experience.

Inspired by hexo-graph, if you’re looking for alternative solutions, feel free to explore it as well!

Installation

To install the plugin, run the following command in your Hexo project directory:

npm install hexo-stats-echarts

Supported Charts

Heatmap Chart

Visualize your daily posting activity with an interactive heatmap.

Quick Start: Insert the following code snippet into any Hexo post or page:

{% heatmapchart %}Blog Heatmap{% endheatmapchart %}

Output:

Blog Heatmap
Powered by hexo-stats-echarts

For detailed usage instructions and examples, visit: Heatmap Chart Documentation

Pie Chart

Visualize your blog’s data by tags or publication years.

Quick Start: Insert the following code snippets into any Hexo post or page:

  • Stats by Tags:
{% piechart tags %}Tags Pie Chart{% endpiechart %}

Output:

Tags Pie Chart
Powered by hexo-stats-echarts
  • Stats by Years:
{% piechart years %}Years Pie Chart{% endpiechart %}

Output:

Years Pie Chart
Powered by hexo-stats-echarts

For detailed usage instructions and examples, visit: Pie Chart Documentation

Radar Chart

Visualize your blog’s data by tags or publication years.

Quick Start: Insert the following code snippets into any Hexo post or page:

  • Stats by Tags:
{% radarchart tags %}Tags Radar Chart{% endradarchart %}

Output:

Tags Radar Chart
Powered by hexo-stats-echarts
  • Stats by Years:
{% radarchart years %}Years Radar Chart{% endradarchart %}

Output:

Years Radar Chart
Powered by hexo-stats-echarts

For detailed usage instructions and examples, visit: Radar Chart Documentation

Planned Features (TODO)

  • Radar Chart: Display the most frequently used post tags in a radar chart format.
  • Documentation Updates: Add detailed guides on color themes, tag arguments, post tag blacklist, and chart background color customization.
  • Line Chart: Visualize monthly posting activity with a line chart.
  • Sunburst Chart: Visualize nested post categories with a sunburst chart.

Feedback & Support

If you find this plugin useful, consider giving it a ⭐ on GitHub to show your support and help others discover it!

We welcome contributions and feature suggestions! Your feedback and support are greatly appreciated. Feel free to open an issue or submit a pull request on GitHub.

0%