Hexo 主题 Archer 使用教程

1. 项目介绍

Hexo 主题 Archer 是一个智能且现代的 Hexo 主题，旨在为用户提供美观且功能丰富的博客体验。该主题结合了 yilia 主题的侧边栏设计和 huxpro 主题的 UI 设计，提供了快速导航、现代浏览器兼容性以及丰富的个性化配置选项。

2. 项目快速启动

2.1 安装 Hexo

首先，确保你已经安装了 Hexo。如果还没有安装，可以通过以下命令进行安装：

npm install -g hexo-cli

2.2 初始化 Hexo 项目

创建一个新的 Hexo 项目：

hexo init my-blog
cd my-blog
npm install

2.3 安装 Archer 主题

在 Hexo 项目根目录下，通过以下命令安装 Archer 主题：

git clone https://github.com/fi3ework/hexo-theme-archer.git themes/archer --depth=1

2.4 配置 Hexo 使用 Archer 主题

编辑 Hexo 项目根目录下的 _config.yml 文件，将 theme 字段设置为 archer：

theme: archer

2.5 安装必要依赖

Archer 主题依赖于 hexo-generator-json-content 插件生成侧边栏索引，需要在 Hexo 根目录安装此插件：

npm install hexo-generator-json-content --save

同时，在 _config.yml 中添加如下字段：

jsonContent:
  meta: true
  pages: false
  posts:
    title: true
    date: true
    path: true
    text: false
    raw: false
    content: false
    slug: false
    updated: false
    comments: false
    link: false
    permalink: true
    excerpt: false
    categories: true
    tags: true

2.6 启动 Hexo 服务器

完成上述配置后，启动 Hexo 服务器以预览主题效果：

hexo server

3. 应用案例和最佳实践

3.1 配置 About 页面

在 Hexo 根目录下执行如下命令创建 About 页面：

hexo new page "about"

在 source/about/index.md 中添加以下内容：

---
title: 关于我
layout: about
---

这里是关于我的介绍内容。

3.2 配置 404 页面

在 Hexo 根目录下 source 中创建 404.md，添加字段如下：

---
layout: 404
title: "[404]"
description: "May the Force be with you :)"
---

3.3 启用 RSS 订阅

在 Hexo 根目录下安装依赖插件：

npm install hexo-generator-feed --save

配置 _config.archer.yml：

social:
  rss: /atom.xml

4. 典型生态项目

4.1 Hexo

Hexo 是一个快速、简洁且高效的博客框架，使用 Markdown 解析文章，并生成静态网页。Archer 主题是 Hexo 生态中的一个优秀主题，提供了丰富的功能和美观的设计。

4.2 hexo-generator-json-content

hexo-generator-json-content 是一个 Hexo 插件，用于生成 JSON 格式的内容索引，Archer 主题依赖此插件生成侧边栏索引。

4.3 hexo-generator-feed

hexo-generator-feed 是一个 Hexo 插件，用于生成 RSS 订阅源，方便用户订阅博客更新。

通过以上步骤，你可以快速启动并配置 Hexo 主题 Archer，享受现代化的博客体验。