Newsletter
Join the Community
Subscribe to our newsletter for the latest news and updates
A Hexo plugin that generates Atom 1.0 and RSS 2.0 feeds with configurable limits, content, and autodiscovery.
A quick and easy way to generate markup for mailto links without having to worry about the annoying formatting.
hexo-generator-feed is a Hexo plugin that generates Atom 1.0 or RSS 2.0 feeds from your blog posts, with configurable post limits, content inclusion, and autodiscovery support. It is maintained by the Hexo organization and distributed on npm as hexo-generator-feed.
hexo-generator-feed is a plugin for the Hexo static site generator that produces feed files in Atom 1.0 or RSS 2.0 XML formats. It takes your Hexo posts as input and outputs feed files to your site's root, such as atom.xml or rss2.xml. The plugin belongs to the Hexo project and is versioned to match Hexo releases: versions 2.x work with Hexo 4+, 1.x with Hexo 3, and 0.x with Hexo 2.
type option to a list like ['atom', 'rss2'].path option, which must follow the order of the type list when generating both formats.limit setting; use 0 or false to include all posts.content option with true to embed the entire post content in the feed; otherwise only a summary is included.content_limit (default 140 characters) and cut at the last occurrence of content_limit_delim before reaching the limit.autodiscovery option (default true), compatible with many themes.order_by (default -date) and an optional custom icon path, defaulting to a gravatar from the main config's email.Hexo blog owners — add a feed to their site so readers can subscribe via RSS or Atom readers. Web developers using Hexo — integrate a custom feed path or both formats into client projects. Content publishers — syndicate posts to external platforms that consume feeds, using the optional full-content mode.
type: rss2 and path: rss2.xml to expose your posts as RSS 2.0 for RSS readers and podcast apps.type and path as lists to generate both Atom and RSS 2.0 feeds, letting readers choose their preferred format.limit option to show only the latest 20 posts by default, or set it to false to include everything.content: true to syndicate complete articles, making your feed a full-content source for news aggregators.Install the plugin with npm install hexo-generator-feed --save, then add a feed block to your site's _config.yml. The plugin reads the front-matter of each post for an optional description, intro, or excerpt to use as the feed summary; otherwise it falls back to the post excerpt or the first 140 characters. On generation, it writes the configured feed files to your public directory.
Run npm install hexo-generator-feed --save in your Hexo project. Version compatibility: use 2.x for Hexo 4+, 1.x for Hexo 3, and 0.x for Hexo 2.
Yes. Set type to a list like ['atom', 'rss2'] and provide a matching path list such as ['atom.xml', 'rss2.xml'] to output both formats.
The default path is atom.xml for Atom and rss2.xml for RSS 2.0, but you can change them with the path option.
Only if you set content: true. By default, the feed uses a summary: the custom description from front-matter if present, otherwise the excerpt or the first 140 characters, configurable with content_limit and content_limit_delim.
Set autodiscovery: false in the feed config. Be aware that many themes already include autodiscovery, so you may need to adjust the theme's configuration as well.
