Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pcrab/hexo-theme-quark
a simple hexo theme https://pcrab.xyz
https://github.com/pcrab/hexo-theme-quark
hexo hexo-theme
Last synced: about 2 months ago
JSON representation
a simple hexo theme https://pcrab.xyz
- Host: GitHub
- URL: https://github.com/pcrab/hexo-theme-quark
- Owner: Pcrab
- License: gpl-3.0
- Created: 2020-01-24T04:28:42.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2023-05-09T05:31:34.000Z (over 1 year ago)
- Last Synced: 2024-05-31T15:29:48.471Z (7 months ago)
- Topics: hexo, hexo-theme
- Language: EJS
- Homepage: https://pcrab.xyz
- Size: 1.39 MB
- Stars: 46
- Watchers: 2
- Forks: 5
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# README
> 之前在使用 Hexo 的时候尝试了不少主题，但都不是特别满意，因此就自己写了这款主题，希望能够喜欢。
## 介绍
这款主题是一款非常简洁的主题，前还在开发中。可配置项在 config 文件中都有，每项也有注释说明，使用起来非常简单友好。主题整合了 Valine 与 Disqus 评论系统，方便使用。
## 安装
```bash
git clone https://github.com/Pcrab/hexo-theme-quark quark
```
同时记得将**主目录**下的 `_config.yml` 文件中的 theme 修改为 quark
```yaml
theme: quark
```
要注意修改主题的 `_config.yml` 中的 `author` 部分的内容，同时记得如果有备案号也要填写。如果要使用 Valine ，需要注册 leancloud 的账号，这里推荐使用 [国际版](https://leancloud.app/) ，域名无需备案。如果使用的是 Disqus，可以考虑配置反代，不过需要自己的服务器并且有一定的动手能力。
主题定制了标签，关于，搜索，友链这四个页面，如果需要使用的话，需要首先创建这四个页面
```bash
hexo new page tags
```
并修改成对应的 layout
```yaml
layout: tags
```
其他几个页面也需要通过相同的步骤创建。
如果创建了搜索页面，则同时需要安装 [hexo-generator-search](https://github.com/wzpan/hexo-generator-search) 这款插件。
```bash
yarn add hexo-generator-search
```
然后修改博客根目录下的 `_config.yml`
```yaml
search:
path: search.xml
```
如果打开了 rss 功能，那么还需要安装 [hexo-generator-feed](https://github.com/hexojs/hexo-generator-feed) 插件来生成。
```bash
yarn add hexo-generator-feed
```
同样也需要修改根目录下的 `_config.yml`
```yaml
feed:
type: atom
path: atom.xml
limit: 20
hub:
content: true
content_limit: 140
content_limit_delim: ' '
order_by: -date
```
要使用代码高亮，请首先访问 [该网站](https://highlightjs.org/download/) 并选择自己需要高亮的语言以获取最佳的体验。下载下来的压缩包中找到 `highlight.pack.js` 文件，将其重命名为 `highlight.min.js` 后替换放入 `/source/js/` 文件夹下，然后关闭自带的 `highlight`。
```yaml
highlight:
enable: false
```
如果需要其他主题高亮，可以访问 [这里](https://highlightjs.org/static/demo/) 参考配置主题，并修改 `_config.yml` 中的配置。
```yaml
syntax:
enable: true
global: true
theme: xcode
```
其他请按情况修改配置。
## 亮点
`_config.yml` 文件中有着丰富的可配置项，方便个性化配置，包括
1. `icon` 与 `favicon`: 切换主页图标
2. `dark`: 夜间模式开关
3. `author`: 作者介绍 (即 about 页面)
4. `friendlinks`: 友链，支持图片说明
5. `comment`: 评论系统支持，目前有 Valine 与 Disqus
6. `copyright`: 版权支持，只有 cc
7. `startYear` 以及 `showTheme`: 部分页脚内容自定义
8. `beian`: 页脚添加备案号
9. `syntax`: 使用 highlight.js 支持代码高亮