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之前先备份好你原来的配置。
_config.yml
中的theme
一项的值为raytaylorism
yourblog/themes/raytaylorism/_data
文件夹到yourblog/source
目录下yourblog/themes/raytaylorism/_md/
下所有文件夹(about和reading)到yourblog/source
目录下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>
标签内容。yourblog/themes/raytaylorism/source/favicon.png
替换为你自己的图标文件,保持favicon.png
命名不变。yourblog/_config.yml
中language
一项设置为zh-CN
、zh-TW
、en
实现yourblog/themes/raytaylorism/source/css/_base/lib_customize.styl
中的.container
类的宽度设置yourblog/source/_data/link.json
数据文件中进行配置。如果不需要以下两项,直接把link.json
删除即可。
social
项,预设有weibo
和github
两种,如果需要其他社交平台可自行追加,但要注意key值必须与Font Awesome图标相对应,否则可能无法正常显示。extern
项,其中key值为链接文字,value值为外链URLyourblog/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为分隔线。若不需要则将该字段设为nullprojects
:Array类型,作品与项目展示,内含多个Object,每个Object都有name
作品名、image
封面、description
作品描述、link_text
链接文字、link
链接地址。若不需要则将该字段设为nullreward
:Array类型,打赏二维码图片列表。例子中两个图片分别为微信和支付宝的二维码图片链接。若不需要则将该字段设为nullyourblog/source/_data/reading.json
数据文件中进行配置。读书页面有“已读”“在读”和“想读”三栏,分别对应contents
项中的readed
、reading
和wanted
字段,每个字段对应一个书籍列表,按照例子进行修改即可。yourblog/source/_data/hint.json
数据文件中进行配置。selector
项是一个数组,里面可以包含若干个CSS选择器用于选择要添加new标签的DOM元素。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(从通用代码中获取)yourblog/_config.yml
中添加如下配置代码。如果不需要搜索功能,将yourblog/themes/raytaylorism/_config.yml
中menu
的-id: search
那一整项删除即可
search:
path: search.xml
field: all
atom.xml
的链接写在yourblog/source/_data/link.json
的social项中,一般无需更改)yourblog/themes/raytaylorism/_config.yml
中的google_analytics
一项改为你的Google分析track id,留空则不启用yourblog/themes/raytaylorism/_config.yml
中的tencent_analytics
一项改为你的sId(在腾讯分析添加站点后,复制代码中sId=xxxxxxxx
那串数字就是sId),留空则不启用yourblog/themes/raytaylorism/layout/_partial/plugin/analytics.ejs
中添加相应的统计代码yourblog/themes/raytaylorism/_config.yml
中的page_stat
设为false