hexo-theme-arknights

预览

Dr.Yue_plus: http://ark.theme.yueplus.ink/
Dr.Ye: https://laurenfrost.github.io/
Dr.LingYun: https://dr-lingyun.gitee.io/

如果使用了这个主题，欢迎在这儿贴预览链接~

安装

一键下载

手动安装

根据需要执行以下代码

hexo init Hexo
cd Hexo
npm install -g cnpm --registry=https://registry.npm.taobao.org
cnpm install
git clone https://github.com/Yue-plus/hexo-theme-arknights.git themes/arknights

安装依赖

npm 用户：

cnpm install hexo-server hexo-browsersync hexo-renderer-pug hexo-renderer-sass hexo-renderer-ts --save

yarn 用户：

yarn add hexo-server hexo-browsersync hexo-renderer-pug hexo-renderer-sass hexo-renderer-ts

hexo-renderer-sass 很可能会安装失败，请多试几次。

修改配置文件

参照 Hexo 官网修改 Hexo/ 目录下的 _config.yml。
- 把 theme: 的值改为 arknights
- 开启代码高亮：
```
highlight:
  hljs: true
```
查看 Hexo/themes/arknights/目录下的 _config.yml。主题的配置文件可参照中文注释修改。

修改资源文件

可按需修改 Hexo/themes/arknights/source/ 目录下的

favicon.ico：浏览器标签页上的图标
CNAME: GitHub Pages 部署时的自定义域名
README.md: 部署仓库的 README
img/目录下的 Alipay.png 与 WeChat.png 可替换为自己的二维码； 1:1 比例的 png 图片；

写作

可参考 Hexo | 写作。
在主题仓库的 Hexo 分支有一些示例文本可以取用

添加文章标签与分类，更多特性可参考 Hexo | Front-matter ，示例：

---
title: 'Hello World !'
date: 2020-04-15 21:54:02
tags: code
category: Example
---

在  之前的内容称之为摘要，会显示在首页上，并且可以设置是否也在正文显示。

顶部导航栏新建自定义页面

例如：新建一个 about 页面在 Hexo 目录下执行
```
hexo new page 'about'
```
然后 Hexo\source\ 目录下会多一个 about 文件夹
编辑 Hexo\source\about\index.md 文件
编辑主题目录下的 _config.yml，添加一个链接：
```
menu:
  About: /about
```

评论系统

本主题支持Valine 。请修改主题目录下 _config.yml 文件中 valine: 的 app_id: 与 app_key: 。

参考 Valine 快速开始

开启邮件提醒：zhaojun1998 / Valine-Admin

参与开发

欢迎提交 Issues 与 PR

分支说明

分支	说明
master	主题开发目录
gh-pages	gh-page 托管
hexo	Hexo 目录，这里有可以用于测试主题的 `.md` 文件

搭建开发环境

先装好 nodejs 和 yarn ，然后执行以下命令：

yarn global add hexo-cli yo generator-hexo-theme
git clone -b hexo https://github.com/Yue-plus/hexo-theme-arknights.git
cd hexo-theme-arknights
git clone https://github.com/Yue-plus/hexo-theme-arknights.git themes/arknights
yarn install
hexo serve --debug

开发中可能遇见的 BUG 及解决方法

修改 `.pug` 模板文件无法自动刷新页面。

解决方法：将 Hexo 目录下的 ./node_modules/hexo-renderer-pug/lib/pug.js 中的 pugRenderer.compile = pugCompile; 注释掉。

运行 ‘hexo serve --debug’ 时，长文章渲染不全

这是由热重载插件 hexo-browsersync 导致的，不会影响发布解决方法：禁用该插件。（反正不影响发布，不管也行）

参与开发可能需要的文档

Hexo 官方文档
SASS 中文网

注意，这个中文网标的是 SASS 但写的是 SCSS 的语法。其最大区别是 SASS 不要写分号和花括号、文件拓展名不同。
Pug 模板引擎中文文档
另外引用几个大佬的blog

支援主题开发

喜欢这个主题的话可以：

给颗小星星吧 (/▽＼)
开发者的B服ID：YuePlus#6221
加入 QQ 群：618221514

群内开发为主，吹水晒卡，分享线索7也都欢迎哦~ d=====(￣▽￣*)b
打赏、赞助:

redhat123456 / hexo-theme-arknights Goto Github PK

hexo-theme-arknights's Introduction