hexo-theme-ylion
😊 说不定是一个让你感到惊喜的hexo主题 🍻 🍬
Translate
Korean: README Korean
Features | 特点
- jQuery Free,原生Javascript实现
- 强大的CSS3动画
- 文章过时提醒功能
- 支持文章置顶
- 网站公告功能
- 增强的站内搜索
- 首页图片懒加载
- leancloud阅读人数统计与最受欢迎文章widget
- 更强大的自定义
- 主题本身无图片
- 响应式
- gitment集成
- 支持双语对照功能
- (我编不下去了,等待你去发现~)
TODO | 计划
- 使用教程和开发Hexo主题教程
-
更多的优化(说了和没说一样==) -
文章分类目录可展开 - Javascript模块化
-
多说的样式以拓展功能(为多说默哀ing,已替换为gitment) - 数学公式支持 / updated: 2017/2/19,说明&注意事项
- 便捷翻译和双语对照功能的使用教程
- 你们来决定...🐒
Getting Started | 开始使用
Hexo 2.x
版本,为了避免未知的错误,请备份好数据,或者建立新的博客目录
Prerequisites | 前提条件
Node.js
环境、Git
环境以及 Hexo
,如果你尚未安装或者不了解 Hexo
,请参考 官方教程 进行了解以及安装。
Dependencies | 依赖安装
因为 hexo-theme-ylion 使用了 ejs
模版引擎 、 Less
CSS预编译语言以及在官方插件的基础上
进行功能的开发,依赖必不可少。
## 注意ejs的版本问题(见issue #5)
npm install hexo-renderer-ejs hexo-renderer-less hexo-generator-feed hexo-generator-sitemap hexo-deployer-git hexo-util ejs@^1.0.0 moment utils-merge --save
Download | 下载主题文件
有两种方式下载主题--下载 *.zip
文件和通过 git
,无论哪种方式请确认下载的文件目录和博客站点的theme子目录中的landscape
目录同一个级别,如下:
.
├── landscape
└── ylion
Configure | 配置
接下来就是配置的问题了,分为主题配置和站点配置,主要是主题配置。
Theme Configure | 主题配置
各个设置项均在主题配置文件中以注释的形式进行说明。详情请见配置文件。
如果你对主题的配置文件格式有疑问或者不熟悉语法,参考 阮一峰老师的博客 或者提出issue
Site Configure | 站点配置
站点一般都保持默认,这里只讲主题相关的配置。
# Pagination
## Set per_page to 0 to disable pagination
## @per_page为了首页加载速度,请设置合理的数值
per_page: 10
pagination_dir: page
theme: ylion ### 主题文件在Theme目录下的命名
### search插件基于 https://github.com/PaicHyperionDev/hexo-generator-search
### 使用说明请参考该repo
search:
path: search.xml
field: all
### 代码高亮
highlight:
enable: true
line_number: true
tab_replace:
Run | 运行预览
hexo clean && hexo g && hexo s -p 4300
监听4300端口,使用浏览器打开地址http://localhost:4300
进行预览。
Tips:
如果你为了更好地写博客,推荐两个Hexo插件:hexo-browsersync
和 hexo-admin
。
npm install hexo-browsersync --save
npm install hexo-admin --save
hexo-browsersync
主要用于监听刷新,hexo-admin
提供类似后台的功能。
前者无需配置,按照平常启用server预览即可。hexo-admin
的使用参考官方Repo
最后,Enjoy it!!!😘
Languages | 支持的语言
支持英语,简体中文和繁体中文。能力有限,欢迎翻译其他语言。
Compatibility | 兼容性
IE9+*、Chrome、Firefox、Safari
说明: IE9 支持基本功能,无动画效果以及 leancloud无法正常使用统计功能
Contribute | 贡献
主题的测试基本通过,个人使用基本没有问题,但难免会有纰漏。如果大家在使用的过程发现bug或者有改进性的建议,欢迎提出~
接受各种形式的贡献,包括不限于提交问题与需求,修复代码。期待Fork和PR~
如果喜欢该款主题,还希望不吝啬你的star~😆
Thanks | 感谢
作为一个设计天分上辈子都用光了的小前端,在设计这款主题的时候参考了好多主题和博客的设计和创意, 才能在这么短的时间内成型一个博客主题,真的特别感谢!比心 ❤️
排名不分前后:
- 阿城的blog / 借鉴了代码框
- 小胡子哥的个人网站 / 借鉴文章过期提醒和作者信息
- hexo-theme-tranquilpeak / 借鉴文章简介的布局
- hexo-theme-next / 从配置文件得知Hexo博客受欢迎的功能
- hexo-theme-landscape / 师傅带入门,初期代码参考
- hexo-generator-search / 基于插件修改,解决站内搜索
- Netcan_Space / 参考置顶功能排序算法