/hexo-theme-raytaylorism

一款Material Design风格的hexo主题

Primary LanguageCSSMIT LicenseMIT

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色板规范。注意：link、article_title_link和tab配置的是文字的颜色，因此不可以给这几项配置lighten和darken的颜色加亮加暗的后缀。
  • 页面标题：在yourblog/_config.yml中，title项决定了页面header中显示的标题，subtitle决定了浏览器的<title>标签内容。
  • favicon：请将yourblog/themes/raytaylorism/source/favicon.png替换为你自己的图标文件，保持favicon.png命名不变。

数据

  • 外部链接：在yourblog/source/_data/link.json数据文件中进行配置
    • 社交平台：对应social项，预设有weibo和github两种，如果需要其他社交平台可自行追加，但要注意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项中的readed、reading和wanted字段，每个字段对应一个书籍列表，按照例子进行修改即可。
  • 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
  • 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.0.0-alpha(2016-3-14) 发布raytaylorism v2 alpha版本
  • 1.3.0(2014-10-22) 新增文章中目录导航
  • 1.2.9(2014-10-22) 修复主题在hexo 2.0+版本上运行报错的问题
  • 1.2.8(2014-6-20) 添加MathJax插件
  • 1.2.7(2014-5-4) 将读书栏目的书本封面固定宽高并按比例压缩，将详细展开标签置于封面右侧
  • 1.2.6(2014-1-10) 添加分类目录菜单
  • 1.2.5(2014-1-8) 修复升级hexo版本到2.3.0后，归档的标题没有显示的问题
  • 1.2.4(2014-1-7) 修复Furatto升级版本后侧滑栏样式的问题
  • 1.2.3(2014-1-4) 修复“加载更多”无法滚动的问题
  • 1.2.2(2014-1-3) 重新调整全局的字体大小
  • 1.2.1(2013-12-16) 修复升级hexo版本到2.3.0后，正文中代码排版的问题
  • 1.2.0(2013-12-12) 修复当在hexo配置中new_feature_guide字段不存在时，生成会报错的问题
  • 1.1.9(2013-11-1) 新增读书栏目
  • 1.1.8(2013-10-24) 修复Furatto升级版本后各种样式的问题
  • 1.1.7(2013-10-21) 修复Furatto升级版本后网格布局的显示错误
  • 1.1.6(2013-10-18) 将Furatto升级到V2.0版本
  • 1.1.5(2013-10-8) 修复在其他页面点击header的博客名没有回到首页的bug
  • 1.1.4(2013-10-7) 新增about.ejs模板
  • 1.1.3(2013-10-6) 修改新功能导航的DOM识别方式为查询字符串，给navbar的各项添加id
  • 1.1.2(2013-10-3) 修复google_analytics.ejs中没有引用博客配置的错误
  • 1.1.1(2013-9-20) 修复Google Analytics无效的bug
  • 1.1.0(2013-9-20) 把新功能导航的特征值分离到博客的配置中
  • 1.0.9(2013-9-19) 修复IE新功能导航阴影的显示问题
  • 1.0.8(2013-9-19) 修复“你当前所在的位置”为空的bug
  • 1.0.7(2013-9-18) 修复“加载更多”动画效果滚动不到位的问题
  • 1.0.6(2013-9-15) 新增新功能导航效果
  • 1.0.5(2013-9-5) 调整基础布局，新增首页加载更多按钮
  • 1.0.4(2013-9-2) 针对手机进行响应式设计，重新定义所有版面的字体大小
  • 1.0.3(2013-9-1) 新增响应式设计的侧滑菜单
  • 1.0.2(2013-8-31) 添加了About页面并使用自定义模板
  • 1.0.1(2013-8-26) 使页面主内容在高度不够的时候可以自适应屏幕，让页脚沉底