Skip to content

raytaylorlin/hexo-theme-raytaylorism

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
_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数据文件中进行配置。如果不需要以下两项,直接把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(多说即将关闭服务)评论插件默认使用[网易云跟帖],需要自行配置yourblog/themes/raytaylorism/_config.yml中的yungentie_product_key为你自己站点的productKey(从通用代码中获取)
  • 搜索:安装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中添加相应的统计代码
  • 网页计数器:使用不蒜子来统计PV和UV,若不需要可将yourblog/themes/raytaylorism/_config.yml中的page_stat设为false

使用的插件

更新日志

  • 2.3.3(2017-4-29) 新增网易云跟帖评论插件支持
  • 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版本

历史记录

About

一款Material Design风格的hexo主题

Resources

License

Stars

Watchers

Forks

Packages

No packages published