# Hexo

## 安装 Hexo

使用 `node.js` 中的包管理工具 `npm` 安装 `hexo`

```bash
npm install hexo-cli -g
hexo init <blog-floder-name>  # e.g. Blog
cd <blog-floder-name>
npm install
```

## 常用插件

```bash
npm install hexo-server --save
npm install hexo-deployer-git --save

npm install hexo-generator-tag --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-feed --save
npm install hexo-generator-sitemap --save
npm install hexo-generator-index --save
npm install hexo-generator-search --save

npm install hexo-renderer-jade --save
npm install hexo-renderer-ejs --save
npm install hexo-renderer-less --save
npm install hexo-renderer-sass --save
npm install hexo-renderer-stylus --save
npm insatll hexo-renderer-marked --save
```

## 分页功能

在保证`hexo-generator-index`,`hexo-generator-tag`,`hexo-generator-archive`已安装的情况下，可以通过修改博客根目录下的`_config.yml`文件令主页、归档页与标签页使用不同的`per_page`，保证不同页面的每页内容列表数不相同。

```
index_generator:
  per_page: 8

archive_generator:
  per_page: 0
  yearly: true
  monthly: false

tag_generator:
  per_page: 0
```

当`per_page`为0时，代表不分页。

## 常见问题解决方法

### 执行 `hexo d` 失败

#### 问题描述

```bash
$ hexo d
INFO  Deploying: git
INFO  Clearing .deploy_git folder...
FATAL Something's wrong. Maybe you can find the solution here: http://hexo.io/docs/troubleshooting.html
Error: EACCES: permission denied, unlink '/home/litreily/Workspace/Blog/.deploy_git/about/index.html'
    at Error (native)
```

#### 问题分析

从错误消息可以看错，`hexo`的网站部署指令无法链接到指定文件，有可能是修改博客后部分链接失效导致的，此时可以删除`.deploy_git`文件夹，然后重新执行`hexo d`。

#### 解决方法

```bash
sudo rm -rf .deploy_git
hexo d
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://litreily.gitbook.io/notes/gitbook/software/hexo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.