Hexo 主题 ParticleX 安装与使用指南

1. 项目目录结构及介绍

hexo-theme-particlex/
├── _config.yml            # 主题配置文件
├── assets/                # 静态资源文件夹，包括 CSS、JS 和图像等
│   ├── css/
│   ├── js/
│   └── img/
├── source/                # 模板源文件
│   ├── _layout.ejs        # 布局模板
│   ├── archive.ejs        # 归档页面模板
│   ├── category.ejs       # 分类页面模板
│   ├── index.ejs          # 主页模板
│   ├── page.ejs           # 单个页面模板
│   ├── post.ejs           # 文章详情页面模板
│   └── tags.ejs           # 标签页面模板
├── languages/             # 多语言支持文件夹
│   └── zh-CN.yml          # 中文语言包
└── ...

项目结构清晰地划分了不同的功能区域。_config.yml 是主题的核心配置文件；assets 文件夹存储前端资源；source 目录包含了所有的模板文件，用于构建网站的各种页面；languages 提供了本地化支持，这里以中文为例。

2. 项目的启动文件介绍

在 Hexo 的上下文中，虽然直接说“项目的启动文件”可能是指 Hexo 自身的 server 命令而非该主题特有的启动文件，但关键在于如何应用此主题并查看效果。主要步骤涉及修改博客根目录下的 _config.yml 文件来启用本主题，而非该主题内部有特定的启动机制。

启动流程简介：

1. 集成到Hexo博客:
   • 在您的Hexo博客根目录下，编辑 _config.yml 文件。
   • 找到 theme: 行，并将其值更改为 particlex，形如：theme: particlex。
2. 安装主题：

   cd themes
   git clone https://github.com/theme-particlex/hexo-theme-particlex.git
   

3. 启动博客预览： 回到博客根目录，执行：

   hexo clean && hexo g && hexo s
   

   这将清理缓存，生成静态文件并启动本地服务器，您可以通过浏览器访问 http://localhost:4000 来预览效果。

3. 项目的配置文件介绍

_config.yml (位于主题目录内)

这是ParticleX主题的核心配置文件，示例如下关键部分：

# Site settings
title: Your Blog Title
subtitle: A short subtitle if needed
description: Describe your blog in a few words.

# Author settings
author: Author Name
avatar: /path/to/avatar.jpg
profile_image: /path/to/profile-image.jpg
...

# Navbar settings
menu:
  - title: Home
    url: /
  ...

# Pagination
per_page: 10

# Other configurations...

配置项涵盖站点设置、作者信息、导航栏设置、分页以及更多可自定义的部分。用户可以根据自己的需求调整这些配置，从而个性化他们的博客外观和功能。

通过上述指导，您可以成功配置并运行基于 Hexo 的 ParticleX 主题博客。务必根据个人偏好调整配置文件，以达到最佳展示效果。