Hexo 博客模板安装与使用指南

Hexo 博客模板安装与使用指南

hexo-templateTemplate of Hexo, with CI/CD by GitHub Actions项目地址:https://gitcode.com/gh_mirrors/he/hexo-template

---

1. 项目目录结构及介绍

本指南基于 https://github.com/mmdjiji/hexo-template.git 开源项目，旨在帮助您快速了解并启动 Hexo 博客。以下是该项目的基本目录结构及其简介：

.
├── _config.yml            # 主配置文件，管理博客的各种设置
├── package.json           # 项目依赖定义文件
├── package-lock.json      # 依赖版本锁定文件
├── yarn.lock              # 若使用 Yarn，则会出现此文件来锁定依赖版本
├── source                 # 源码目录，存放文章、页面等
│   └── _posts             # 文章存储目录
├── themes                 # 主题目录，存放博客主题相关文件
├── .gitignore             # Git 忽略文件，指定不纳入版本控制的文件或目录
└── README.md               # 项目说明文档

• _config.yml: 博客的核心配置文件，包括部署信息、主题设置、插件启用状态等。
• source/_posts: 存放撰写的文章Markdown文件，每篇文章都有对应的 .md 扩展名。
• themes: 包含了用于自定义博客外观的主题文件夹，每个主题都是一个子目录。
• package.json 和相关锁文件：管理Node.js项目的依赖包和版本。

2. 项目的启动文件介绍

在Hexo框架中，并不存在一个特定的“启动文件”概念，但若要运行博客，主要通过命令行操作进行。关键的命令是：

• npm install hexo-cli -g: 全局安装Hexo CLI。
• 在项目根目录下执行 npm install 或 yarn install 来安装项目依赖。
• 使用 hexo clean 清理缓存和生成的静态文件。
• 启动本地服务器预览博客：hexo server 或简写 hexo s。

3. 项目的配置文件介绍

_config.yml

_config.yml 是Hexo项目的核心配置文件，以下是一些常见配置段落示例及解释：

title: 我的博客                     # 博客标题
subtitle: 分享技术与生活点滴       # 副标题
author: [作者名字]                  # 作者名称
language: zh-CN                    # 语言设置
timezone: Asia/Shanghai             # 时区设置

# Deployment
deploy:
  type: git                        # 部署方式，这里使用Git
  repo: https://your_git_repo_url   # 远程仓库URL
  branch: master                   # 推送到仓库的分支，默认通常是master或main

# Theme configuration
theme: [所选主题名]                 # 设置博客使用的主题

# Other configurations...

请注意，实际使用时应将 [作者名字], [你的_git_repo_url], 和 [所选主题名] 替换为具体值。此外，该文件可根据个人需求添加或调整更多配置项，比如社交链接、SEO优化设置、评论系统集成等。

---

以上就是对hexo-template项目的基本结构解析、启动方法以及核心配置文件的介绍。按照这些步骤操作，您可以轻松地搭建和个性化您的Hexo博客。

hexo-templateTemplate of Hexo, with CI/CD by GitHub Actions项目地址:https://gitcode.com/gh_mirrors/he/hexo-template