主题介绍
Jacman 是一款扁平化,有着响应式设计的 Hexo 主题。本站正式使用了 Jacman 主题。Jacman 基于 Pacman 主题修改而来,目前已有很多特性与原主题不同。
安装
在博客根目录下执行如下命令。1
$ git clone https://github.com/wuchong/jacman.git themes/jacman
Jacman 需要安装 Hexo 2.7 及以上版本,请先升级您的 Hexo 程序,再启用此主题。
启用
修改你的博客根目录下的_config.yml配置文件中的theme属性,将其设置为jacman。同时建议设置stylus属性中的compress值为true,会自动压缩 CSS 文件,hexo默认配置中不包含这一项,建议开启。如下。1
theme: jacman
stylus:
compress: true
更新
1 | cd themes/jacman git pull origin master |
请先备份您主题目录下的 _config.yml 文件后再升级。
配置指南
Jacman 主题提供了丰富的配置属性,可以实现您对主题的自定义。配置文件_config.yml位于主题根目录下。1
##### 菜单
menu:
主页: /
归档: /archives
关于: /about
#### 控件
widgets:
- category
- tag
- links
- rss
#### RSS
rss: /atom.xml
#### 图片相关
imglogo:
enable: true ## 是否显示网站 logo
src: img/logo.png
favicon: img/favicon.ico ## 网站图标
apple_icon: img/jacman.jpg ## 苹果设备上的图标,背景不要透明
author_img: img/author.jpg ## 网站底部的博主头像
#### 首页相关
index:
expand: false ## 首页文章是否展开。默认为不展开,卡片式。
excerpt_link: Read More
#### 作者信息
author:
intro_line1: "Hello ,I'm Larry Page in Google." ## 网站底部的个人介绍
intro_line2: "This is my blog,believe it or not."
weibo_verifier: ## 微博秀的验证码
tsina: ## 用于微博秀和微博分享
weibo: ## 用于显示网站底部社交按钮,下同
douban:
zhihu:
email:
twitter:
github:
facebook:
linkedin:
google_plus:
stackoverflow:
#### 目录
toc:
article: true ## 是否在文章中显示目录
aside: true ## 是否在侧边栏显示目录
#### 友情链接
links:
Jark's Blog: http://zhangyouzhi.me
Hexo: http://hexo.io
#### 评论
duoshuo_shortname:
disqus_shortname:
#### 分享按钮
jiathis:
enable: false ## 默认使用主题内建分享
id:
tsina:
#### 网站统计
google_analytics:
enable: false
id: ## google analytics ID.
site: ## 网站地址.
baidu_tongji:
enable: false
sitecode: ## 百度统计站点特征码
cnzz_tongji:
enable: false
siteid: ## CNZZ统计站点ID
#### 杂项
ShowCustomFont: true
fancybox: true
totop: true
#### 自定义搜索
google_cse:
enable: false
cx:
baidu_search:
enable: false
id:
site: http://zhannei.baidu.com/cse/search
属性功能
菜单 menu
默认没有启用 /tags 和 /categories页面,如果需要启用请在博客目录下的source文件夹中分别建立tags 和 categories文件夹每个文件夹中分别包含一个index.md文件。内容为:1
layout: tags (或categories)
title: tags (或categories)
---
因为主题中已经内置了这两个页面的模板,所以他们会被正确的解析出来。
控件 widgets
提供了7种小工具。包括标签、标签云、分类、归档、RSS、友情链接、微博秀。
友情链接:友情链接的网址添加可以在links属性下添加。
微博秀:
需要注意的是,如果要启用微博秀,您必须填上author属性下tsina和weibo_verifier的值,前者是您微博ID,后者是您微博秀的验证码,访问 http://app.weibo.com/tool/weiboshow 在如下图位置,可以获得您的 verifier,如:我的是4a0b79d5。
在主题文件夹下 themes/主题名/_widget/ 创建文件(文本文件就行)修改后缀名为 .ejs ,在新浪微博-我的工具下面选择微博秀,然后将代码复制到文件中即可。
图片相关 Image
本主题可以设置网站相关图片,例如网站图标(favicon)、网站logo(imglogo)、作者头像(author_img)。建议启用网站logo,格式建议为.svg或.png格式。同时建议提供配套的 favicon 以及在苹果设备上的图标apple_icon(背景不要透明)。
首页显示模式 Index
目前首页的显示模式支持两种,一种是原先的卡片式(前往 Demo 预览),另一种是类似官方主题的文章展开式(本站即采用的这种)。两者各有优劣,前者首页加载速度更快,后者文章内容更能吸引读者。主题默认采用第一种卡片式,如需开启第二种展开式,请设置index属性下的expand: true。
卡片式的文章摘要是截取文章内容的前140个字,也可以自己总结description并将其放在开头的front-matter中。展开式的文章摘要就是使用截取了。
作者信息 author
作者信息,建议尽量填写完整。其中tsina是你的新浪微博ID,不同于用户名或微博主页地址。启用这个属性后,其他用户在微博上分享你文章的同时会自动@你。同时它和weibo_verifier一起作用生成微博秀。intro_line1和intro_line2是网站底部的个人介绍。weibo、twitter、facebook等是用来显示网站右下角的社交按钮的,如下图所示。
目录 toc
是否启用在文章中或侧边栏中的目录功能。二者可以都为true或都为false。同时,如果你希望在特定的某一篇文章中关闭目录功能你可以在文章文件开头中的front-matter中加上一行toc: false。如果希望在某一篇文章中关闭目录自动编号功能你可以在文章文件开头的front-matter中加上一行list_number: false。另外 hexo 2.5.2 开始支持中文目录,想获得更好的体验请升级你的 Hexo 版本。
评论 comments
填写duoshuo_shortname多说的用户名,启用多说评论系统。在大陆地区更好用的评论系统。
填写disqus_shortnamedisqus 的用户名,启用 disqus 评论系统。国际上更广泛使用的评论系统。设置博客根目录下的_config.yml文件中的disqus_shortname同样也能开启该功能。