Hexo 是一个快速、简单、强大的博客框架,能够使你用 Markdown 语法写作,生成静态文件并部署到自己的服务器上,而且支持插件扩展。本篇文章主要介绍 hexo-generator-category 插件的使用方法。
插件简介
hexo-generator-category 是一个基于 Hexo 生成器的插件,可以为网站添加分类页。分类页概括了网站上所有文章按照分类分类的内容,为访客提供更好的导航和查阅体验。
安装插件
在安装插件之前,请确保已经成功安装了 Hexo,同时可以使用 npm 命令行。进入博客根目录下,执行以下命令:
npm install hexo-generator-category --save
其中,--save
参数的作用是将 hexo-generator-category 添加到你的博客配置文件 package.json
的依赖中。
配置插件
在完成插件安装后,需要通过编辑 Hexo 的配置文件 _config.yml
来启用分类功能。在此文件中,添加以下配置项:
# hexo-generator-category category_generator: per_page: 10 order_by: -date
其中,per_page
表示每页显示文章的数量,order_by
表示分类页中按照日期倒序排列文章。你也可以根据需要调整这些配置项。
创建分类页模板
分类页模板的创建方式与 Hexo 的其他模板类似。在主题目录下创建一个 page-categories.ejs
或 page-categories.swig
文件。例如,如果你使用的是 hexo-theme-next 主题,可以使用以下命令进行创建:
cp themes/next/layout/_pages/categories.ejs themes/next/layout/_pages/page-categories.ejs
然后,你可以在该文件中添加分类页的布局代码。
生成分类页
配置文件和分类页模板都准备好后,只需要一行命令就能生成分类页:
hexo generate
当 Hexo 完成此命令后,在 public/categories
目录下将会生成分类页。你可以通过以下命令启动本地 Hexo 服务器并查看分类页:
hexo server
当你访问 http://localhost:4000/categories
地址时,将看到生成的分类页。
示例代码
以下是一个简单的分类页模板示例代码:
-- -------------------- ---- ------- --- ------ ---------- ----- ---------- -------- ------- ---------- ---------- ------------ --- ---- ------------------- -- --- -------- -- --------------- -- ------ -------- ----------- --- -------------- --------- ----------- ------ --------- ----------------- -- ----------- ------- ---- -- --- ---- -- ----------- -- ------ -------- -------- ------ --------- ------------ -- ---------- ------ ---------- --------- - -------------- ---------------- -- ------ -- ----- -- ------ -- ------展开代码
总结
在本文中,我们介绍了 hexo-generator-category 插件的使用方法。通过学习本文,你可以轻松地为自己的博客添加分类页,并提供更好的导航和查阅体验。分类页对于高效地管理博客文章是非常重要的,希望本文对你有所帮助。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/68797