# 快速上手
# 依赖环境
- Hexo 5.4+在新窗口打开
- Yarn在新窗口打开 or NPM在新窗口打开 installed
# 安装指南
本节将帮助您在现有的 Hexo 博客项目上安装 Aurora 主题。
从版本 1.1.0 开始，主题可以使用 NPM 或 Yarn 安装，让主题用户更容易使用!
# 步骤 1 - 安装主题包
在控制台中，进入 Hexo 项目的根目录，然后运行以下命令安装主题
yarn add hexo-theme-aurora
npm install hexo-theme-aurora --save
# 步骤 2 - 生成主题配置
因为主题是使用 NPM 或者 Yarn 安装的，而不是 clone 到 themes 文件夹的。所以我们需要自己创建一个配置文件。你只需要在 Hexo 博客的根目录下创建一个
_config.aurora.yml配置文件来配置主题。
提示
- 想获取一个默认的主题配置模版，你可以执行以下命令
- 但是这个命令只能在 Linux 或者 MacOS 下执行，如果你用的是 Windows 系统，可以自行在 node_modules 中找到对应目录复制过来
cp -rf ./node_modules/hexo-theme-aurora/_config.yml ./_config.aurora.yml
# 步骤 3 - 设置 permalink
因为使用了 Vue-router，Hexo 默认生成的页面和文章的 permalink 与我们 Vue router 中的 path 是不相符的，那么就会出现无法访问的问题。所以我们需要修改 Hexo 默认配置文件里面的
permalink参数。
# 步骤 3.1
打开在 Hexo 根目录下的 _config.yml
# 步骤 3.2
修改 permalink 参数为 /post/:title.html
# URL
## Set your site url here. For example, if you use GitHub Page, set url as 'https://username.github.io/project'
url: https://tridiamond.tech
permalink: /post/:title.html
permalink_defaults:
pretty_urls:
trailing_index: true # Set to false to remove trailing 'index.html' from permalinks
trailing_html: true # Set to false to remove trailing '.html' from permalinks
# 步骤 4 - 设置代码高亮
最后主题是使用
Prismjs来实现代码高亮显示，但 Hexo 默认是使用highlightjs，因此你需要更改 Hexo 配置来使用Prismjs:
- 把
highlight的启用改为false - 把
prismjs的启用改为true - 把
prismjs下的preprocess改为false
highlight:
enable: false
line_number: true
auto_detect: false
tab_replace: ''
wrap: true
hljs: false
prismjs:
enable: true
preprocess: true
line_number: true
tab_replace: ''
# 步骤 5 - 创建 “关于 (about)” 页面
主题默认开启了 about 页面，所以我们需要创建这个 about 页，要不主题就无法正常显示 about 页。
要创建这个默认的 about 页，只需要执行这个 Hexo 的命令：
hexo create page about
执行完毕后，你会发现在 source/ 文件中多处了一个新的文件夹：
.
└── source
└── about
└── index.md
你可以随意修改这个 index.md markdown 文件中的内容，此文件的内容将会现在在我们的 about 页面中。
# 步骤 6 - 重新生成与本地服务器
使用以下命令来运行本地环境。
hexo clean & hexo g & hexo server
提示
改变了任何配置都需要重新生成 Hexo 的静态文件！
当文件都生成完毕之后，就可以通过 https://localhost:4000在新窗口打开 访问你的博客了。
# 接下来该干啥？
你的主题基本上是可以使用了，但是还有两个地方你需要去看看并且进行详细的配置: