Hexo 主题 HuWeiHuang 使用教程

Hexo 主题 HuWeiHuang 使用教程

hexo-theme-huweihuang Ported theme of Hux Blog by YuHsuan, Modified by Hu Weihuang项目地址:https://gitcode.com/gh_mirrors/he/hexo-theme-huweihuang

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

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

hexo-theme-huweihuang/
├── scaffolds/
├── source/
├── themes/
│   └── huweihuang/
│       ├── layout/
│       │   └── post.ejs
│       ├── gitignore
│       ├── gitmodules
│       ├── LICENSE
│       ├── README.md
│       ├── _config.yml
│       └── package.json
├── .gitignore
├── .gitmodules
├── LICENSE
├── README.md
├── _config.yml
└── package.json

目录结构介绍

• scaffolds/: 存放模板文件。
• source/: 存放博客的源文件，包括 Markdown 文件等。
• themes/huweihuang/: 主题的核心目录，包含布局文件、配置文件等。
  • layout/: 存放布局文件，如 post.ejs 用于文章页面布局。
  • gitignore: Git 忽略文件。
  • gitmodules: Git 子模块配置文件。
  • LICENSE: 许可证文件。
  • README.md: 项目说明文件。
  • _config.yml: 主题配置文件。
  • package.json: 主题的依赖包管理文件。

2. 项目的启动文件介绍

Hexo 主题 HuWeiHuang 的启动文件主要是 _config.yml 和 layout/post.ejs。

_config.yml

这是主题的主要配置文件，包含了主题的各种设置，如导航菜单、侧边栏、评论系统等。

layout/post.ejs

这是文章页面的布局文件，定义了文章页面的结构和样式。

3. 项目的配置文件介绍

_config.yml

以下是 _config.yml 的一些关键配置项：

# 基本配置
title: 博客标题
subtitle: 博客副标题
description: 博客描述
author: 作者名
language: 语言
timezone: 时区

# 导航菜单
menu:
  Home: /
  Archives: /archives
  About: /about

# 侧边栏
sidebar:
  position: right
  display: always

# 评论系统
comments:
  enable: true
  provider: disqus
  disqus:
    shortname: your_disqus_shortname

package.json

这是主题的依赖包管理文件，包含了主题所需的各种 npm 包。

{
  "name": "hexo-theme-huweihuang",
  "version": "1.0.0",
  "description": "Ported theme of Hux Blog by YuHsuan, modified by Hu Weihuang",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "Hu Weihuang",
  "license": "Apache-2.0",
  "dependencies": {
    "hexo": "^5.0.0"
  }
}

通过以上配置，你可以根据自己的需求调整主题的外观和功能。希望这篇教程能帮助你更好地使用 Hexo 主题 HuWeiHuang。

hexo-theme-huweihuang Ported theme of Hux Blog by YuHsuan, Modified by Hu Weihuang项目地址:https://gitcode.com/gh_mirrors/he/hexo-theme-huweihuang