Maupassant是Cho为typecho平台设计的一套响应式模板,其简洁的风格让很多人喜爱,在没有被扩展其他功能的情况下整个模板本身小巧到只有几十KB,因此访问速度也可观

Hexo Maupassant博客主题

之前一直用的是php博客系统,但奈何我发现近些时间不是很喜欢折腾博客了,只想有事写两篇,没事放着生蛋,就想着换到github上来在保留绝对控制权的情况下让github托管着,在jekyll和hexo比较中看到了hexo主题中被人移植到hexo的Maupassant模板,感觉很适合我,于是借鉴cho大神最新版的Maupassant主题,结合其他博主(例:屠城博客)的一些扩展上进行了移植与修改

由于自己特爱简洁,所以移植了最基本的功能,加入了少量的博客可能用得着的其他小扩展,有用得着的朋友可以进入github下载

https://github.com/7ye/maupassant-hexo

主题配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
fancybox: true ## 是否启用Fancybox图片灯箱效果 true/false.
disqus: ## disqus用户名,为空则不使用
google_search: true ## 使用google搜索引擎, true/false.
baidu_search: ## 使用百度搜索引擎, true/false.
google_analytics: ## Google统计ID
baidu_analytics: ## 百度统计ID
show_category_count: true ## 如果你想显示侧边栏分类下的文章数量,请设置值为true
busuanzi: true ## 使用不蒜子统计文章访问量 true/false

## 头部菜单
menu:
- page: home
directory: .
- page: archive
directory: archives/
- page: about
directory: about/
- page: rss
directory: atom.xml

## 侧边栏小工具设置: search, category, tag, recent_posts, links
widgets:
- search
- category
- tag
- recent_posts
- links

## 侧边栏链接
links:
- title: 标题
url: http://www.example.com

## 静态文件目录
js: js
css: css

## 主题版本
version: 0.0.1
  • fancybox:是否启用Fancybox图片灯箱效果
  • disqus:Disqus评论 shortname
  • google_search:默认使用Google搜索引擎
  • baidu_search:若想使用百度搜索,将其设定为true
  • google_analytics:Google Analytics 跟踪ID
  • baidu_analytics:百度统计 跟踪ID
  • show_category_count:是否显示侧边栏分类数目
  • busuanzi:是否使用不蒜子页面访问计数
  • menu:自定义页面及菜单,依照已有格式填写。填写后请在source目录下建立相应名称的文件夹
  • widgets:选择和排列希望使用的侧边栏小工具
  • links: 友情链接,请依照格式填写。
  • 静态文件目录:静态文件存储路径,方便设置CDN缓存
  • version:主题版本,便于静态文件更新后刷新CDN缓存

主题特性

文章摘要

首页默认显示文章摘要而非全文,可以在文章的front-matter中填写一项description:来设置你想显示的摘要,或者直接在文章内容中插入<!--more-->以隐藏后面的内容。
若两者都未设置,则自动截取文章第一段作为摘要。

description描述

对于首页的description,可在Hexo下的配置文件_config.yml下配置description参数,对于文章,可在front-matter中填写一项description:来手动写描述,如果文章没有任何配置,则自动截取文章前150个字符为当前文章的description(不包括html标签)

添加页面

source目录下建立相应名称的文件夹,然后在文件夹中建立index.md文件,并在index.mdfront-matter中设置layout为layout: page。若需要单栏页面,就将layout设置为 layout: single-column

文章评论

文章和页面的评论功能可以通过在front-matter中设置comments: truecomments: false来进行开启或关闭(默认开启)。

语法高亮

要启用代码高亮,请在Hexo目录的_config.yml中将highlight选项按照如下设置:

1
2
3
4
5
highlight:
enable: true
auto_detect: true
line_number: true
tab_replace:

数学公式

要启用数学公式支持,请在Hexo目录的_config.yml中添加:

1
mathjax: true

并在相应文章的front-matter中添加mathjax: true,例如:

1
2
3
4
5
6
---
title: Test Math
date: 1997-01-01 00:00:00
categories: math
mathjax: true
---

数学公式的默认定界符是$$...$$\\[...\\](对于块级公式),以及$...$\\(...\\)(对于行内公式)。

但是,如果你的文章内容中经常出现美元符号“$”, 或者说你想将“$”用作美元符号而非行内公式的定界符,请在Hexo目录的_config.yml中添加:

1
mathjax2: true

而不是mathjax: true。 相应地,在需要使用数学公式的文章的front-matter中也添加mathjax2: true

浏览器兼容

浏览器兼容详情

支持语言

目前支持简体中文(zh-CN),需其他语言支持在主题目录下languages,按照已有配置文件对照着规则添加yml配置文件即可