Annie是一个简单的Hexo博客主题,如果你喜欢散文、诗歌、小说......那么它可能合你心意! ☞预览 | PREVIEW
- 文艺、优雅、简洁的博客主题
- 页头随机背景+文章缩略图背景
- 两种主页模板,主页文章无限加载
- 分类页、标签页点击指定分类、标签后,查询并展示相关文章
- 相册页可以分类、搜索图片
- 相关文章模块:文章页展示与该篇文章相关的系列文章
- 文章评论模块:gitalk 、valine 、livere
- 文章分享模块:addThis 、baiduShare 、shareThis 、socialShare
- 文章统计模块:leancloud 、busuanzi
- 文章点赞模块:leancloud
- 文章阅读模块:toc目录、进度条、进度百分比
- 文章代码模块:代码复制、代码语言提示、5种高亮主题(Refer & use Next' theme)
- 文章Markdown:支持数学公式(MathJax),color quote(Refer & use Minos' theme )
- 站点分析模块:baidu_analytics 、cnzz_analytics 、google_analytics 、tencent_analytics:
- 站点文章搜索:local search
- 多语言支持:中文简体、中文繁体、英文
git clone https://github.com/Sariay/hexo-theme-Annie.git
然后,将站点目录下的_config.yml
文件中的theme
字段修改为Annie。
确保themes目录下存在名为Annie的文件夹(hexo-theme-Annie→Annie)
原则上,你应该编辑站点目录下的_config.yml
文件。
- 语言支持
# Site
title: SARIAY-Blog
subtitle:
description:
keywords:
author: Sariay
language:
timezone:
设置language
的值:en | zh-CN |zh-TW
- 站内搜索
第一步:安装 hexo-generator-search-zip
插件
$ npm install hexo-generator-search-zip --save
第二步:编辑站点目录下的_config.yml
文件
# 添加下列参数
search:
path: search.json
zipPath: search.zip
versionPath: searchVersion.txt
field: post
#field: post, page or all
第三步:编辑主题目录下的_config.yml
文件
# 添加下列参数(若不存在),并将enable置为true!
# Local search
# Dependencies: https://github.com/flashlab/hexo-generator-search
local_search:
enable: true
# if auto, trigger search by changing input
# if manual, trigger search by pressing enter key or search button
trigger: auto
# show top n results per article, show all results by setting to -1
top_n_per_article: 2
- 代码高亮
基于hexo自身的代码块解析插件的特性,弃用hexo-prism-plugin,参考、使用next主题的代码风格。
highlight、line_number
的值应为true
# Writing
new_post_name: :title.md # File name of new posts
default_layout: post
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab
filename_case: 0
render_drafts: false
post_asset_folder: true
relative_link: false
future: true
highlight:
enable: true
line_number: true
auto_detect: false
tab_replace:
- 设置
highlight_theme、code_copy
(主题目录的config.yml)
# post_code
# normal | night | night blue | night bright | night eighties
highlight_theme: night bright
code_copy:
enable: true
你可以阅读文章 《Annie主题使用说明》 获取相关模块的信息,例如页头背景、相册、评论、文章点赞 !
每一篇文章都可以设置一张特色图,该特色图将用于主页(文章缩略图)和文章详情页(页头背景)。
文章的模板样例如下,cover即为文章封面图的路径,你可以使用相对路径或绝对路径。
title: {{ title }}
date: {{ date }}
cover: https://.../
categories: categories
tags: tags
如果你使用主题后,几乎未改动代码,那么可以使用下面的命令行
更新主题。
cd themes/Annie
git pull
如果你使用主题后,自定义改动相当多的代码,推荐下载源码包以进行定制!
如果你有问题反馈: issues | 1261347403@qq.com(请务必先于issues中寻找答案)
如果你喜欢该主题: star (star越多,更新的动力越大😂)
如果你想定制主题: fork (当然,Annie亦期待你的贡献)
一些pull request的代码由于项目重构而未能进行merge(或者issues),重构过程中参考了这些issues。
zxdawn #6
Dinghow #10
miracleqi #16
- 评论功能
- 文章目录
- 文章点赞💗
- 阅读计数
- 相关文章
- 相册模块
- 站点分析统计b421393
- 文章分享功能b421393
- 文章目录优化b421393
- 文章字体调整b421393
- 语言支持优化 4
- 相册图片利用 5
- valine与文章阅读计数的冲突问题,参考valine官网、next主题案例(注:当前使用DesertsP版的valine)
- ...
hexo-generator-search-zip plugin by Kieran
The index-page layout referenced Diaspora
The archive-page layout referenced Feng'Blog
Other open source...
(Relevant Rights Reserved by Them!)
MIT