A lightweight hexo theme
Clone or download
BoizZ Merge pull request #34 from JinhaiZ/patch-1
fix typo in README.me
Latest commit f866aab Sep 18, 2017

README.md

Laughing theme for hexo

Build Status Hexo GitHub license

简单轻量的hexo主题。

Demo: lalala.lol

外观

响应式布局,宽松设计,还原最佳阅读体验。

电脑界面

手机界面

功能

  • 10分钟快速配置
  • 支持多说评论,自由开启评论,主题定制样式
  • 简易二次开发

安装

  1. 安装hexo-render-pug

Laughing主题使用pug模板引擎开发,所以首先需要在主程序中安装依赖组件。

npm install hexo-renderer-pug --save
  1. 拷贝主题到themes目录
cd themes
git clone git@github.com:BoizZ/hexo-theme-laughing.git
  1. 修改主程序的_config.yml文件
theme: hexo-theme-laughing

主题配置文档

主题的配置都放在了 _config.yml 文件里面。

网站图标

favicon: /favicon.ico

SEO

站点标题、副标题、描述沿用站点的配置。

## 关键字
keywords: Hexo, Gruntjs, Nodejs, Reactjs, Vuejs

页头

菜单按钮风格目前支持两种:darklight

## 页面背景
page_background: /default_images/page_background.jpg

## 页面菜单按钮风格
page_menu_button: dark

## 文章背景
post_background: /default_images/post_background.jpg

## 文章菜单按钮风格
post_menu_button: light

## 标题占位字:无标题类型文章的标题占位字
title_plancehold: '随笔'

## 自定义菜单
navication:
  - name: Lalala.lol
    link: http://lalala.lol

作者信息

作者的名字沿用站点的配置。

## head:作者头像
## signature:作者签名
author:
  head: /default_images/author_head.gif
  signature: Only when you plant the flowers can you really smell their fragrance.

内容宽度

可自定义内容的最大显示宽度。

content_width: 600

社交信息

主题内置的社交图标目前有:facebook, twitter, weibo, wechat, github, stackoverflow, linkin, email, segmentfault, flickr, zhihu, disqus, douban, bilibili

如需新增请在Issues里面提出

## name:名称
## icon:图标(请使用配置文件里面给出的图标)
## link:指向当前社交账号的链接
social:
  - name: GitHub
    icon: github
    link: http://github.com/BoizZ

多说

多说是自由开启的,默认开启,如果不需要则在配置文件里面关闭即可。

需要注意的是,多说的url配置默认使用站点的配置。请更改站点配置中url为自己的域名。

## enable:是否开启多说(true:开启,false:关闭)
## siteName:多说账号种填写的网站名称
duoshuo:
  enable: true
  siteName: ueibo

版权

## record: 备案名称(若无则填写 false)
## hexo: 是否显示“POWER BY HEXO”
## laughing:是否显示“THEME BY LAUGHING”
copyright:
  record: false
  hexo: true
  laughing: true

二次开发 Build Status

Laughing主题遵循简易开发模式,以文件层级及命名细分模块,二次开发比较简单。

模板引擎

Laughing主题使用pug作为模板引擎,在开发前请确保已经安装了hexo-render-pug插件,如未安装,请在Hexo程序根目录运行以下命令进行安装:

npm install hexo-renderer-pug --save

安装Grunt

Laughing主题使用sass作为预编译样式语言,使用grunt监听文件变化并编译成css。当然,sass是基于ruby的,需要在电脑上安装ruby

进入主题目录,运行以下命令安装grunt以及其他依赖:

npm install

参考