Hexo 主题 Aath 安装与使用教程

Hexo 主题 Aath 安装与使用教程

hexo-theme-AathHexo 主题项目地址:https://gitcode.com/gh_mirrors/he/hexo-theme-Aath

1. 项目的目录结构及介绍

Hexo 主题 Aath 的目录结构如下：

hexo-theme-Aath/
├── _config.yml
├── layout/
│   ├── _partial/
│   ├── _widget/
│   ├── about.ejs
│   ├── archive.ejs
│   ├── index.ejs
│   ├── page.ejs
│   ├── post.ejs
│   └── tag.ejs
├── source/
│   ├── css/
│   ├── fonts/
│   ├── images/
│   └── js/
├── package.json
└── README.md

目录结构介绍：

• _config.yml: 主题的配置文件。
• layout/: 存放主题的模板文件，包括页面布局和部分组件。
  • _partial/: 存放页面的部分组件模板。
  • _widget/: 存放小部件模板。
  • about.ejs: 关于页面的模板。
  • archive.ejs: 归档页面的模板。
  • index.ejs: 首页的模板。
  • page.ejs: 普通页面的模板。
  • post.ejs: 文章页面的模板。
  • tag.ejs: 标签页面的模板。
• source/: 存放主题的静态资源文件，如 CSS、字体、图片和 JavaScript 文件。
  • css/: 存放样式表文件。
  • fonts/: 存放字体文件。
  • images/: 存放图片文件。
  • js/: 存放 JavaScript 文件。
• package.json: 项目的依赖和脚本配置文件。
• README.md: 项目的说明文档。

2. 项目的启动文件介绍

Hexo 主题 Aath 的启动文件主要是 layout/index.ejs，它是主题的首页模板文件。Hexo 在生成静态页面时会使用这个模板来渲染首页内容。

启动文件介绍：

• index.ejs: 这是主题的首页模板文件，包含了页面的基本结构和内容布局。Hexo 会根据这个模板生成静态的首页文件。

3. 项目的配置文件介绍

Hexo 主题 Aath 的配置文件是 _config.yml，它位于主题的根目录下。这个文件包含了主题的各种配置选项，如菜单、评论系统、侧边栏等。

配置文件介绍：

# 项目配置
theme: aath

# 代码高亮
highlight:
  line_number: false

# 评论系统
disqus_shortname: your_disqus_shortname
livere_uid: your_livere_uid

# 网站图标
favicon: /favicon.ico

# 侧边栏
search: true
avatar: http://olnzpdi2u.bkt.clouddn.com/avatar.jpg
aside-description: aside-description
links:
  百度: https://www.baidu.com/
  谷歌: https://www.google.com/
  知乎: https://www.zhihu.com/

# 主菜单
menu:
  首页: /
  关于: /about
  归档: /archives
  标签: /tags

# 其他
favicon: /favicon.ico

配置项说明：

• theme: 指定使用的主题名称。
• highlight: 代码高亮的配置，line_number 控制是否显示行号。
• disqus_shortname: Disqus 评论系统的短名称。
• livere_uid: LiveRe 评论系统的 UID。
• favicon: 网站图标的路径。
• search: 是否启用搜索功能。
• avatar: 侧边栏头像的图片路径。
• aside-description: 侧边栏的描述信息。
• links: 侧边栏的链接列表。
• menu: 网站的主菜单配置。

通过修改 _config.yml 文件，可以自定义主题的各种功能和外观。

hexo-theme-AathHexo 主题项目地址:https://gitcode.com/gh_mirrors/he/hexo-theme-Aath