一个简洁轻量化的响应式Hexo博客主题。
hexo 安装前,需要确保 git、node、npm 已经安装。因为安装 hexo 需要使用 npm 命令,hexo 初始化需要使用 git。
1.1 安装 hexo
$ sudo npm install -g hexo-cli
/usr/local/node-6.11/bin/hexo -> /usr/local/node-6.11/lib/node_modules/hexo-cli/bin/hexo
/usr/local/node-6.11/lib
└─┬ hexo-cli@1.0.4
├── abbrev@1.1.1
├── bluebird@3.5.1
.....
1.2 初始化博客文件夹
$ hexo init hexo
INFO Cloning hexo-starter to /data/blogs/hexo
Cloning into '/data/blogs/hexo'...
remote: Counting objects: 62, done.
....
# 初始化博客文件夹(hexo),会自动在当前路径下生成 hexo 目录
$ ls ./hexo
_config.yml node_modules package.json scaffolds source themes
$ cd hexo
$ git clone https://gitee.com/stevenshen/hexo-theme-BlueLake.git themes/BlueLake
$ npm install hexo-renderer-jade@0.3.0 --save
$ npm install hexo-renderer-stylus --save
在 Hexo 配置文件(hexo/_config.yml
)中把主题设置修改为BlueLake
;并添加中文支持。
theme: BlueLake
...
language: zh-CN
如果你想生成压缩后的css,在(hexo/_config.yml
)中添加:
stylus:
compress: true
# 生成静态页面
$ hexo generate
INFO Start processing
INFO Files loaded in 1.46 s
INFO Generated: index.html
INFO Generated: apple-touch-icon.png
INFO Generated: favicon.ico
INFO Generated: archives/index.html
INFO Generated: iconfont/iconfont.eot
INFO Generated: iconfont/iconfont.svg
INFO Generated: iconfont/iconfont.ttf
INFO Generated: iconfont/iconfont.woff
INFO Generated: archives/2018/01/index.html
INFO Generated: img/bg.jpg
INFO Generated: archives/2018/index.html
INFO Generated: css/highlight.css
INFO Generated: js/search.json.js
INFO Generated: js/toctotop.js
INFO Generated: js/totop.js
INFO Generated: css/style.css
INFO Generated: 2018/01/24/hello-world/index.html
INFO 17 files generated in 582 ms
# 开启本地服务器
$ hexo s
INFO Start processing
INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.
打开浏览器,地址栏中输入:http://localhost:4000/,应该可以看见刚刚创建的博客了。
cd themes/BlueLake
git pull
打开themes/BlueLake/_config.yml
进行配置。
##########################
## Site Config Settings ##
##########################
# Theme version
version: 2.0.1
# Header
menu:
- page: home
directory: .
icon: fa-home
- page: archive
directory: archives/
icon: fa-archive
- page: about
directory: about/
icon: fa-user
- page: rss
directory: atom.xml
icon: fa-rss
# Sidebar
widgets:
- recent_posts
- category
- tag
- archive
#- weibo
- links
# Toc
toc:
enable: true
number: false
# Static files
js: js
css: css
# Extensions
Plugins:
hexo-generator-feed
hexo-generator-sitemap
hexo-generator-baidu-sitemap
#Feed Atom
feed:
type: atom
path: atom.xml
limit: 20
#sitemap
sitemap:
path: sitemap.xml
baidusitemap:
path: baidusitemap.xml
#Local search
local_search: true ## Use a javascript-based local search engine, true/false.
#Cmments
comment:
duoshuo: #chaooo ## duoshuo_shortname
disqus: ## disqus_shortname
livere: ## 来必力(data-uid)
uyan: ## 友言(uid)
cloudTie: ## 网易云跟帖(productKey)
changyan: ## 畅言需在下方配置两个参数,此处不填。
appid: ## 畅言(appid)
appkey: ##畅言(appkey)
#Share
baidu_share: true ## 百度分享
JiaThis_share: ##true ##JiaThis分享
duoshuo_share: #true ##true 多说分享必须和多说评论一起使用。
# Analytics
google_analytics: ## Your Google Analytics tracking id, e.g. UA-42025684-2
baidu_analytics: ## Your Baidu Analytics tracking id, e.g. 1006843030519956000
# Miscellaneous
show_category_count: true ## If you want to show the count of categories in the sidebar widget please set the value to true.
widgets_on_small_screens: true ## Set to true to enable widgets on small screens.
busuanzi: true ## If you want to use Busuanzi page views please set the value to true.
# About page
about:
photo_url: ## Your photo e.g. http://obzf7z93c.bkt.clouddn.com/themeauthor.jpg
items:
- label: email
url: ## Your email with mailto: e.g. mailto:zhenggchaoo@gmail.com
title: ## Your email e.g. zhenggchaoo@gmail.com
- label: github
url: ## Your github'url e.g. https://github.com/chaooo
title: ## Your github'name e.g. chaooo
- label: weibo
url: ## Your weibo's url e.g. http://weibo.com/zhengchaooo
title: ## Your weibo's name e.g. 秋过冬漫长
- label: twitter
url:
title:
- label: facebook
url:
title:
# Friend link
links:
- title: site-name1
url: http://www.example1.com/
- title: site-name2
url: http://www.example2.com/
- title: site-name3
url: http://www.example3.com/
您可以准备一张ico格式并命名为** favicon.ico **,请将其放入hexo目录的source
文件夹,建议大小:32px * 32px。
您可以为苹果设备添加网站徽标,请将名为** apple-touch-icon.png **的图像放入hexo目录的“source”文件夹中,建议大小为:114px * 114px。
请在hexo目录的“hexo/_config.yml”中添加keywords
字段,如:
# Site
title: Hexo
subtitle: 副标题
description: 网站简要描述,如:Charles·Zheng's blog.
keywords: 网站关键字, key, key1, key2, key3
author: Charles
language: zh-CN
您可以在文章的 front-matter 中添加 description,并提供文章摘录,或在文章中使用‘‘<!--more-->
’’手动进行截断(Hexo推荐的方式)。
在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`.
此主题默认page页面是关于我页面的布局,生成一个关于我页面:
$ hexo new page 'about'
配置照片地址、邮箱、微博链接、微博名、GitHub链接、Github名:
# 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”选项,如下所示:
highlight:
enable: true
auto_detect: true
line_number: true
tab_replace:
如果要使用本地站点搜索,您必须安装插件hexo-generator-json-content来创建JSON搜索文件 ,然后将配置添加到hexo/_config.yml
:
$ npm install hexo-generator-json-content@2.2.0 --save
然后在hexo/_config.yml
添加配置:
jsonContent:
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),欢迎修改主题并翻译成其他语言。
source /
,themes /
等。欢迎各种形式的贡献(增强功能,添加新功能,撰写文档,改进代码,提交问题和检查BUG...)。
期待您的pull request。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。
1. 开源生态
2. 协作、人、软件
3. 评估模型