BlueLake theme的README
BlueLake
一个简洁轻量化的响应式Hexo博客主题。
安装
安装主题和渲染:
1 | git clone https://github.com/chaooo/hexo-theme-BlueLake.git themes/BlueLake |
启用
在Hexo配置文件(hexo/_config.yml
)中把主题设置修改为BlueLake
。1
theme: BlueLake
如果你想生成压缩后的css,在(hexo/_config.yml
)中添加:1
2stylus:
compress: true
更新
1 | cd themes/BlueLake |
配置
打开themes/BlueLake/_config.yml
进行配置。
1 | ########################## |
- version - 用于自动刷新CDN上的静态文件。
- menu - 导航菜单。
- widgets - 侧边栏中的窗口小部件。
- Toc - 文章目录
- Static files - 静态文件目录,以方便CDN使用。
- Local search
- self_search - 默认本地JS搜索.
- Cmments
- duoshuo - 若使用多说评论,注册多说后在这填写short_name(用于评论与分享)。
- disqus - 若使用Disqus评论,注册Disqus后在这填写short_name。
- livere- 若使用来必力评论,注册来必力,获得data-uid。
- uyan - 若使用友言评论,注册友言,获得uid。
- cloudTie - 若使用网易云跟帖评论,注册网易云跟帖,获得productKey。
- changyan - 若使用畅言评论,注册畅言,获得appid,appkey。
- About page - 关于我页面(hexo new page ‘about’)。
- links - 友情链接。
- Miscellaneous
- show_category_count - 是否在侧边栏分类中显示类别的数量(true/false).
- widgets_on_small_screens - 小屏幕下侧边栏在底部显示.
- busuanzi - 用Busuanzi来统计网站访问量.
- google_analytics - Google Analytics tracking ID。
- baIDu_analytics - Baidu Analytics tracking ID。
特征
站点图标
您可以准备一张ico格式并命名为 favicon.ico ,请将其放入hexo目录的source
文件夹,建议大小:32px * 32px。
您可以为苹果设备添加网站徽标,请将名为 apple-touch-icon.png 的图像放入hexo目录的“source”文件夹中,建议大小为:114px * 114px。
添加站点关键字
请在hexo目录的“hexo/_config.yml”中添加keywords
字段,如:1
2
3
4
5
6
7# Site
title: Hexo
subtitle: 副标题
description: 网站简要描述,如:Charles·Zheng's blog.
keywords: 网站关键字, key, key1, key2, key3
author: Charles
language: zh-CN
设置阅读全文
您可以在文章的 front-matter 中添加 description,并提供文章摘录,或在文章中使用‘‘<!--more-->
’’手动进行截断(Hexo推荐的方式)。
自定义page页面
在source
文件夹中创建文件夹index.md
来添加页面,并在index.md
的front-matter'中添加
layout:page。
Create folders inlcuding
index.mdin
sourcefolder to add pages, and add a
layout: pagein
front-matterof
index.md`.
About页面
此主题默认page页面是关于我页面的布局,生成一个关于我页面:1
hexo new page 'about'
配置照片地址、邮箱、微博链接、微博名、GitHub链接、Github名:1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24# About page
about:
photo_url: ## Your photo e.g. http://obzf7z93c.bkt.clouddn.com/themeauthor.jpg
items:
- label: email
icon: fa-email
url: ## Your email with mailto: e.g. mailto:zhenggchaoo@gmail.com
title: ## Your email e.g. zhenggchaoo@gmail.com
- label: github
icon: fa-github
url: ## Your github'url e.g. https://github.com/chaooo
title: ## Your github'name e.g. chaooo
- label: weibo
icon: fa-weibo
url: ## Your weibo's url e.g. http://weibo.com/zhengchaooo
title: ## Your weibo's name e.g. 秋过冬漫长
- label: twitter
icon: fa-twitter
url:
title:
- label: facebook
icon: fa-facebook
url:
title:
代码语法高亮
请在hexo目录的“hexo/_config.yml”中设置“highlight”选项,如下所示:1
2
3
4
5highlight:
enable: true
auto_detect: true
line_number: true
tab_replace:
本地搜索
如果要使用本地站点搜索,您必须安装插件hexo-generator-json-content来创建JSON搜索文件 ,然后将配置添加到hexo/_config.yml
:1
npm install hexo-generator-json-content@2.2.0 --save
然后在hexo/_config.yml
添加配置:1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18jsonContent:
meta: false
pages: false
posts:
title: true
date: true
path: true
text: true
raw: false
content: false
slug: false
updated: false
comments: false
link: false
permalink: false
excerpt: false
categories: false
tags: true
语言
该主题目前有七种语言:简体中文(zh-CN),繁体中文(zh-TW),英语(en),法语(fr-FR),德语(de-DE),韩语 (ko),西班牙语(es-ES),欢迎修改主题并翻译成其他语言。
Solutions
- 检查您当前的hexo的根目录,是否包含
source /
,themes /
等。 - 如果你在使用这个主题有任何问题,请随时打开一个issue,或者给我发邮件zhenggchaoo@gmail.com。
浏览器支持
License
贡献
欢迎各种形式的贡献(增强功能,添加新功能,撰写文档,改进代码,提交问题和检查BUG…)。
期待您的pull request。