在 Hexo 中，Archive 是一种非常有用的页面类型，它可以按照时间顺序列出所有的文章，方便用户快速查找以往的内容。而 hexo-generator-archive 这个 npm 包，正是为了方便生成这个页面而生。
在本文中，我们将会详细讲解 hexo-generator-archive 的使用方法，包括安装、配置和如何使用其 API 实现自定义功能。希望通过本文能够让读者更好地了解 hexo-generator-archive 并掌握其使用方法，以提高 Hexo 博客的使用体验。
安装 hexo-generator-archive
首先，我们需要先安装 hexo-generator-archive 这个 npm 包。
打开终端，进入 Hexo 根目录，执行以下命令：
npm install --save hexo-generator-archive
配置 hexo-generator-archive
安装完成后，我们需要将 hexo-generator-archive 添加到 Hexo 的 _config.yml 文件中。
打开 _config.yml 文件，找到 plugins 字段，在这里添加 hexo-generator-archive：
plugins: - hexo-generator-archive
然后，去掉 archive_generator 字段的注释，并将 per_page 设置为你想要的每页文章数目：
archive_generator: per_page: 10
这里的每页文章数目为 10，在实际使用中可以根据自己的需求进行调整。
配置完成后，重新生成静态文件：
hexo generate使用 hexo-generator-archive
在配置完成后，我们就可以使用 hexo-generator-archive 生成 Archive 页面了。
在 Hexo 根目录下，执行以下命令：
hexo generate --archive
该命令会生成一个 archives 目录，里面包含了所有的 Archive 页面。接着，我们可以将它们部署到服务器上：
hexo deploy然后在博客的导航栏中添加一个链接指向 Archive 页面，让用户可以方便地查看以往的文章。
使用 hexo-generator-archive 的 API
除了使用 hexo-generator-archive 的默认设置以外，我们还可以使用其提供的 API 进行自定义。
首先，在 Hexo 根目录下的 scripts 目录中创建一个新的 js 文件，比如 archive.js，然后写入以下代码：
hexo.extend.generator.register('archive', function(locals){ return { path: 'custom-archive/index.html', layout: 'archive', data: locals.posts, }; });
这个函数的作用是生成一个名为 custom-archive 的自定义 Archive 页面，并使用 archive 布局，将所有文章的数据传递给页面。
然后，在 source 目录下创建一个名为 custom-archive.md 的 Markdown 文件，并添加以下内容：
--- title: Custom Archive layout: archive ---
这个 Markdown 文件的作用是为自定义 Archive 页面提供标题和布局。
最后，重新生成静态文件即可：
hexo generate在生成的 public 目录下，你就可以找到你刚刚生成的自定义 Archive 页面了，访问它并查看效果吧！
结语
本篇文章详细讲解了如何使用 npm 包 hexo-generator-archive，以及如何使用其 API 进行自定义。希望通过本文的介绍，读者们对 Hexo 的 Archive 页面有更深入的了解，并能在实际使用中灵活运用 hexo-generator-archive，以构建更完美的博客。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/68796
