Hexo 主题 Quiet 使用教程
hexo-theme-quiet 项目地址: https://gitcode.com/gh_mirrors/he/hexo-theme-quiet
1. 项目的目录结构及介绍
Hexo 主题 Quiet 的目录结构如下:
hexo-theme-quiet/
├── layout/ # 存放页面模板文件
├── source/ # 存放静态资源文件(如CSS、JS、图片等)
├── _config.yml # 主题配置文件
├── package.json # 项目依赖配置文件
├── README.md # 项目说明文件
└── LICENSE # 项目许可证文件
目录结构介绍
- layout/: 存放 Hexo 主题的页面模板文件,包括首页、文章页、标签页等。
- source/: 存放主题所需的静态资源文件,如 CSS、JavaScript、图片等。
- _config.yml: 主题的主要配置文件,用于配置网站的标题、Logo、评论系统等。
- package.json: 项目依赖配置文件,列出了主题所需的 Node.js 包。
- README.md: 项目的说明文件,包含主题的基本介绍和使用方法。
- LICENSE: 项目的许可证文件,说明主题的使用权限。
2. 项目的启动文件介绍
Hexo 主题 Quiet 没有直接的“启动文件”,因为 Hexo 是一个静态博客生成器,启动过程是通过 Hexo 命令行工具完成的。以下是启动 Hexo 博客的基本步骤:
-
安装 Hexo CLI:
npm install -g hexo-cli
-
初始化 Hexo 项目:
hexo init my-blog cd my-blog
-
安装主题:
git clone https://github.com/QiaoBug/hexo-theme-quiet.git themes/quiet
-
启用主题: 修改 Hexo 根目录下的
_config.yml
文件,将theme
设置为quiet
:theme: quiet
-
启动本地服务器:
hexo server
启动后,可以在浏览器中访问
http://localhost:4000
查看博客。
3. 项目的配置文件介绍
Hexo 主题 Quiet 的主要配置文件是 _config.yml
,位于主题根目录下。以下是该配置文件的主要内容及说明:
# 网站标题
title: 我的博客
# 网站副标题
subtitle: 一个简约扁平化的 Hexo 主题
# 网站描述
description: 这是一个使用 Quiet 主题的 Hexo 博客
# 网站作者
author: 你的名字
# 网站语言
language: zh-CN
# 网站时区
timezone: Asia/Shanghai
# 首页布局
home_layout: card
# 文章配置
highlight:
enable: false
line_number: false
auto_detect: true
tab_replace: ''
wrap: true
hljs: true
# 评论系统配置 (使用 Gitalk)
gitalk:
enable: true
clientID: '你的 GitHub Application Client ID'
clientSecret: '你的 GitHub Application Client Secret'
repo: '你的 GitHub 仓库名称'
owner: '你的 GitHub 用户名'
admin: ['你的 GitHub 用户名']
# 友情链接
linksList:
- name: 友情链接1
link: 'https://example.com'
- name: 友情链接2
link: 'https://example.com'
# 百度统计
baidu_analytics: '你的百度统计 Key'
配置文件说明
- title: 网站的标题。
- subtitle: 网站的副标题。
- description: 网站的描述。
- author: 网站的作者。
- language: 网站的语言设置。
- timezone: 网站的时区设置。
- home_layout: 首页的布局方式,默认为
card
。 - highlight: 文章代码高亮的配置。
- gitalk: 评论系统的配置,使用 Gitalk 作为评论插件。
- linksList: 友情链接的配置。
- baidu_analytics: 百度统计的配置。
通过以上配置,你可以根据自己的需求定制 Hexo 主题 Quiet,使其更符合你的博客风格。
hexo-theme-quiet 项目地址: https://gitcode.com/gh_mirrors/he/hexo-theme-quiet
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考