npm 包 hexo-generator-category 使用教程

阅读时长 4 分钟读完

Hexo 是一个快速、简单、强大的博客框架,能够使你用 Markdown 语法写作,生成静态文件并部署到自己的服务器上,而且支持插件扩展。本篇文章主要介绍 hexo-generator-category 插件的使用方法。

插件简介

hexo-generator-category 是一个基于 Hexo 生成器的插件,可以为网站添加分类页。分类页概括了网站上所有文章按照分类分类的内容,为访客提供更好的导航和查阅体验。

安装插件

在安装插件之前,请确保已经成功安装了 Hexo,同时可以使用 npm 命令行。进入博客根目录下,执行以下命令:

其中,--save 参数的作用是将 hexo-generator-category 添加到你的博客配置文件 package.json 的依赖中。

配置插件

在完成插件安装后,需要通过编辑 Hexo 的配置文件 _config.yml 来启用分类功能。在此文件中,添加以下配置项:

其中,per_page 表示每页显示文章的数量,order_by 表示分类页中按照日期倒序排列文章。你也可以根据需要调整这些配置项。

创建分类页模板

分类页模板的创建方式与 Hexo 的其他模板类似。在主题目录下创建一个 page-categories.ejspage-categories.swig 文件。例如,如果你使用的是 hexo-theme-next 主题,可以使用以下命令进行创建:

然后,你可以在该文件中添加分类页的布局代码。

生成分类页

配置文件和分类页模板都准备好后,只需要一行命令就能生成分类页:

当 Hexo 完成此命令后,在 public/categories 目录下将会生成分类页。你可以通过以下命令启动本地 Hexo 服务器并查看分类页:

当你访问 http://localhost:4000/categories 地址时,将看到生成的分类页。

示例代码

以下是一个简单的分类页模板示例代码:

-- -------------------- ---- -------
---
------ ----------
----- ---------- --------
------- ----------
---------- ------------
---
---- -------------------
-- --- -------- -- --------------- --
  ------ -------- ----------- --- -------------- --------- ----------- ------ --------- ----------------- -- ----------- -------
  ----
    -- --- ---- -- ----------- --
      ------ -------- -------- ------ --------- ------------ -- ---------- ------ ---------- --------- - -------------- ----------------
    -- ------ --
  -----
-- ------ --
------
展开代码

总结

在本文中,我们介绍了 hexo-generator-category 插件的使用方法。通过学习本文,你可以轻松地为自己的博客添加分类页,并提供更好的导航和查阅体验。分类页对于高效地管理博客文章是非常重要的,希望本文对你有所帮助。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/68797

纠错
反馈

纠错反馈