一款Material Design风格的hexo主题
HTML CSS JavaScript

README.md

hexo-theme-raytaylorism v2

raytaylorism(Ray Taylor主义)是我自己设计并制作的一款清新的的响应式Material Design风格的Hexo主题。该主题支持最新的Hexo 3.1版本。本主题不再支持Hexo 2.x版本,请使用本主题前备份你的数据并升级到Hexo 3。

(English document is coming soon...)

预览

安装

cd yourblog
git clone https://github.com/raytaylorlin/hexo-theme-raytaylorism.git themes/raytaylorism

请不定期git pull一下主题以便获得最新的功能。请在pull之前先备份好你原来的配置。

启用(重要)

  1. 修改 _config.yml 中的theme一项的值为raytaylorism
  2. 由于本主题使用了Data Files数据文件和额外的layout文件,所以请复制以下文件到你的博客目录中,否则在启动server时可能会报错
    • 复制yourblog/themes/raytaylorism/_data文件夹到yourblog/source目录下
    • 复制yourblog/themes/raytaylorism/_md/下所有文件夹(about和reading)到yourblog/source目录下
  3. 在你的yourblog/_config.yml配置文件的#pagination的位置添加下面配置(禁用归档、标签、目录页面的分页功能)
archive_generator:
  per_page: 0
tag_generator:
  per_page: 0
category_generator:
  per_page: 0

配置指南(重要)

我的博文《新版Hexo主题Raytaylorism v2发布》写了一些本指南没有涉及到的主题使用小技巧,可以作为参考。其余配置细节,还是以本指南的说明为主。

样式

  • 主题颜色配置:如果对主题的配色不满意,可以自行在yourblog/themes/raytaylorism/_config.yml中的color一项进行配置。其中各部件的颜色字符串命名遵循Materializecss色板规范。注意:linkarticle_title_linktab配置的是文字的颜色,因此不可以给这几项配置lightendarken的颜色加亮加暗的后缀
  • 页面标题:在yourblog/_config.yml中,title项决定了页面header中显示的标题,subtitle决定了浏览器的<title>标签内容。
  • favicon:请将yourblog/themes/raytaylorism/source/favicon.png替换为你自己的图标文件,保持favicon.png命名不变
  • 多语言:目前主题支持简体中文、繁体中文和英文三种语言,可以将yourblog/_config.ymllanguage一项设置为zh-CNzh-TWen实现
  • 正文宽度问题:有许多使用者反映正文在大屏幕下显得太窄(默认为700px定宽),这是出于提升文章阅读体验的考虑,在PC端上宽屏一行不至于过长,参考了UI设计师的建议以及一些知名博客类网站如medium.com简书等等才做出的调整。如果依旧对这样的宽度不满意,可以自行调整yourblog/themes/raytaylorism/source/css/_base/lib_customize.styl中的.container类的宽度设置

数据

  • 外部链接:在yourblog/source/_data/link.json数据文件中进行配置
    • 社交平台:对应social项,预设有weibogithub两种,如果需要其他社交平台可自行追加,但要注意key值必须与Font Awesome图标相对应,否则可能无法正常显示
    • 友情链接:对应extern项,其中key值为链接文字,value值为外链URL
  • 首页幻灯片:在yourblog/source/_data/slider.json数据文件中进行配置。可以配置背景图、标题、副标题、对齐方式。如果不需要幻灯片,直接把slider.json删除即可。
  • 关于页面yourblog/themes/raytaylorism/_md/about/index.md文件为自我介绍的正文,只需要像平时写博文一样正常地书写markdown即可。在yourblog/source/_data/about.json数据文件中配置关于页面的其他项。
    • avatar:String类型,头像图片链接
    • name:String类型,自己的姓名
    • tag: String类型,描述自己的标签,主要显示在侧滑栏的头部
    • desc:String类型,对自己的简短描述
    • skills:Object类型,对象技能展示。对象key值为技能名,value值为评分(取值为0-10的整数),取值为-1为分隔线。若不需要则将该字段设为null
    • projects:Array类型,作品与项目展示,内含多个Object,每个Object都有name作品名、image封面、description作品描述、link_text链接文字、link链接地址。若不需要则将该字段设为null
    • reward:Array类型,打赏二维码图片列表。例子中两个图片分别为微信和支付宝的二维码图片链接。若不需要则将该字段设为null
  • 读书页面:在yourblog/source/_data/reading.json数据文件中进行配置。读书页面有“已读”“在读”和“想读”三栏,分别对应contents项中的readedreadingwanted字段,每个字段对应一个书籍列表,按照例子进行修改即可。
  • new标签:在yourblog/source/_data/hint.json数据文件中进行配置。selector项是一个数组,里面可以包含若干个CSS选择器用于选择要添加new标签的DOM元素。

插件

  • 代码语法高亮:语法高亮的主题默认由CSS文件yourblog/themes/raytaylorism/source/css/lib/prettify-tomorrow-night-eighties.css。如果需要替换,可以到Prettify Theme选择你喜欢的主题,下载主题的CSS文件并存放到相同的目录下,并将yourblog/themes/raytaylorism/_config.yml中的google_code_prettify_theme一项改为对应的文件名。
  • 评论:评论插件默认使用多说,需要自行配置yourblog/themes/raytaylorism/_config.yml中的duoshuo_shortname为你自己站点的shortname
  • 搜索:安装hexo-generator-search,在yourblog/_config.yml中添加如下配置代码。如果不需要搜索功能,将yourblog/themes/raytaylorism/_config.ymlmenu-id: search那一整项删除即可
search:
  path: search.xml
  field: all
  • RSS:安装hexo-generator-feed,并按照说明配置(atom.xml的链接写在yourblog/source/_data/link.json的social项中,一般无需更改)
  • 站点分析
    • Google分析:yourblog/themes/raytaylorism/_config.yml中的google_analytics一项改为你的Google分析track id,留空则不启用
    • 腾讯分析:(国内用户有Google分析被墙的可能)yourblog/themes/raytaylorism/_config.yml中的tencent_analytics一项改为你的sId(在腾讯分析添加站点后,复制代码中sId=xxxxxxxx那串数字就是sId),留空则不启用
    • 如果你需要其他第三方的站点统计,可以仿照上面的例子添加配置,并在yourblog/themes/raytaylorism/layout/_partial/plugin/analytics.ejs中添加相应的统计代码

使用的插件

更新日志

  • 2.3.2(2016-12-21) 优化文章目录,使其随正文内容滚动(https://github.com/raytaylorlin/hexo-theme-raytaylorism/pull/49)
  • 2.3.1(2016-12-14) 开放文章上一篇和下一篇功能
  • 2.3.0(2016-12-10) 新增站点PV、UV和文章阅读量统计
  • 2.2.3(2016-10-1) 修复首页非第1页点击READMORE路径错误的问题,修复多行代码由于空行不占位导致显示错位的问题
  • 2.2.2(2016-6-7) 更新jQuery和Materialize库至最新版,修复正文右侧目录在某些浏览器无法正常导航的问题
  • 2.2.1(2016-5-14) 添加打开搜索框时自动聚焦的功能
  • 2.2.0(2016-4-22) 新增搜索功能
  • 2.1.3(2016-4-13) 修复多行代码被挤到下方的显示问题
  • 2.1.2(2016-4-5) 优化二级无序列表的样式,修复标签页和分类页的pagenav链接重复显示了两次导致404的问题
  • 2.1.1(2016-3-29) 优化正文表格和引用的显示
  • 2.1.0(2016-3-28) 增加对繁体中文和英文的支持
  • 2.0.0-alpha(2016-3-14) 发布raytaylorism v2 alpha版本

历史记录