本主题在 Louie 基于 Fuzzz 的 Akina 主题修改的主题 Siren 基础上三次修改,显然与前辈比起来,我唯一的贡献就是把他们的代码搞得乱七八糟了吧 =.=
GitHub 地址在文末(从而确保你看到了注意事项)。
I. 特性
随机封面图
内带了一个返回随机图片的 API,把想要展示的图放到 /cover/gallery
中即可。
Lazyload
使用了开源库 jQuery-Lazyload,按需加载图片,优先加载缩略图或占位图,当图片显示在 viewport 上时才加载原图,提升网页加载速度。
另外首页文章列表设计了一个向上浮现的效果,算我最满意的一个小 trick~
文章封面视频
可将视频设为文章封面,支持 hls 流视频。使用说明见主题 wiki。
定制登陆及后台界面
后端登陆界面及 Dashboard 美化(配色方案 Sakura),你也可以自行设计配色方案(请留意“后台配置”页面下的说明),同时也有配合 pjax 实现的前端登陆,前端登陆需自行用模板创建新页面(page)。
支持 Bilibili 表情
后端请按提示切换后台为明亮主题(个人资料页切换),否则评论管理页将出现表情鬼畜。
QQ/Gravatar 头像
如果输入了 QQ 号,留言将拉取 QQ 头像,如果 QQ 号不存在或者是输入了邮箱,将拉取 Gravatar 头像。QQ 头像接口和 Gravatar 镜像都由我这边提供。
评论插图
该功能支持多个图床的接口的选择,目前支持的有 SM.MS、Imgur、Chevereto,使用前请在主题设置中配置相应的代理和API Key。
注意:目前此功能需要 PHP 开启 curl 支持,同时 Nginx/Apache 需要允许 POST 请求。
用户 UA 及 IP 定位
使用纯真 IP 数据库。对了,还有一个高仿 Bilibili 的等级系统,有空还打算再写一个头饰模块。
文章目录
使用了开源项目 tocbot,在需要目录的文章任意位置输入 [toc]
启用。文章首字的大写使用方法:把首字放到 [begin]
和 [/begin]
之间。
Mac 风格代码块
import banana
class Monkey:
# Bananas the monkey can eat.
capacity = 10
def eat(self, n):
"""Make the monkey eat n bananas!"""
self.capacity -= n * banana.size
def feeding_frenzy(self):
self.eat(9.25)
return "Yum yum"
代码高亮渲染使用的是 highlightjs。代码块可全屏,你发现了吗?
建议通过 Markdown 语法写作以便代码块正常显示,代码高亮支持二十多种常见编程语言。
前端主题切换
这部分函数写得有些凌乱,打算以后有空重构一下,可留意主题的更新。字体请留意注意事项。
时光轴
使用了 Shawn 的设计。
相册
基于 fancybox 实现的相册功能,使用说明见主题 wiki。
邮件模板
Aplayer/HermitX 支持
修改了 APlayer 的部分样式,文章内插入音乐可使用 Hermit X 插件。
CDN 优化
因为自己博客每天访问量较大(日均 PV 3000左右),所以为了减少请求数及流量,以此控制 CDN 费用(每天0.2元左右),针对性地做了 CDN 优化:主要是合并请求,并把不同类型的资源分配到不同的域名上,这些在后台界面可以调整。其他内容相对固定的资源,如贴图和前端库都放到了 jsDeliver 的公共库上。
Github Cards
可通过短代码添加: [github repo="mashirozx/Sakura"]
移动客户端*
借助 PJAX 异步加载,便于基于 WebView 开发高性能的移动客户端,切换页面时无刷新,可以获得接近 Native 的响应速度。具体可以体验我的安卓客户端。
II. 注意事项
重要★★:
主题下载后请把文件夹名字改回 Sakura
,也即,保证主题路径为 wp-content/themes/Sakura/
。
启用新主题/插件前备份数据库是一个良好的习惯。虽然我保证主题不可能损坏你的数据,但是毕竟数据无价,对吧?
建议安装的插件☆
Hermit X,基于 Aplayer 的播放器。
我也在使用的插件
Easy WP SMTP,邮件支持。
WP Statistics,统计插件,主题可选择其接口以作页面访问计数。
Login LockDown,登陆尝试限制,避免前端登陆爆破。
Wordfence Security,避免爆破和评论注入。提醒:该插件将在数据库中记录访客信息,数据库体积将略有增大。
Akismet Anti-Spam,垃圾评论过滤。
AMP,生成AMP 页面,效果就是这样,有利于提升 Google 排名。
Autoptimize,页面压缩。
Glue for Yoast SEO & AMP,AMP 增强,需配合 Yoast SEO 及 AMP 插件使用。
WP Super Cache,页面缓存,为访客自动生成缓存版网页,提升访问速度。
Yoast SEO,搜索引擎优化。
其他插件我没用过,不保证兼容性。
兼容性
服务器端
WordPress 版本:4.8+
PHP 版本:7.1+
前端
兼容主流 Chromium 内核浏览器、FireFox 浏览器。不兼容 IE (360、QQ 等双核浏览器请关闭 IE 模式)。
写作规范
主题遵循 HTML5 规范,正文部分样式完全兼容标准 Markdown 语法,因此也建议配合 WP Editor.md 插件使用 Markdown 写作,可参考《Markdown 编辑器语法指南》。
主题演示站有一篇 Markdown 语法展示,文章源码在这里。
API
下面是一些主题内已经带有的接口,无需重复构建:
Cookie:see https://2heng.xin/2018/05/12/add-a-version-control-for-cookies/
后续会考虑添加更多接口。
III. FAQ
1. 为什么开源的主题和这个博客不完全一样?
我的博客上还有一些个性化的内容,因为并不是所有人都会需要,一方面影响主题性能,另一方面为了开源还需为些部分添加开关和选项,耗费时间且没意义,所有这些内容在开源的主题中都已移除。如果你有喜欢,f12 随便抄,我没意见~
PS. 其实本站主题已经很久没有更新了,开源版主题中反而有更多新功能的。 ( ̄▽ ̄)"
标准主题演示在这里。
2. 前端代码块/WP 5.3 后台崩坏?
原先推荐的 WP Editor.md 插件在 WP 5.3 中存在严重的兼容性问题。目前最新版主题已经对评论部分做了处理,不再需要依赖该插件,所以如果更新到了 WP 5.3,请停用此插件。至于正文 Markdown 写作,目前没有好的方案,可以先用其他 Markdown 编辑器书写并转成 HTML,再粘贴进 WordPress。
3. 主题设置开关未生效?
启用主题后先点一次保存。
4. 时差问题
后台主题设置界面里添加了一个时差调节选项。
5. 插入全屏浏览的图片?
参见 主题 wiki。
6. 使用了CDN后评论定位不正确?
如果使用了 CDN 请在 WordPress 根目录的配置文件 wp-config.php
最后加上这段:
if (isset($_SERVER['HTTP_X_FORWARDED_FOR'])) {
$list = explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']);
$_SERVER['REMOTE_ADDR'] = $list[0];
}
网站建议都加上 CDN 以避免暴露服务器IP和被攻击的风险;可以使用 CloudFlare 的免费 CDN。
7. 兼容 IE 及 360 极速浏览器
前者太太太太旧啦,不考虑适配,不过 IE 浏览器可以看到一个友好的弹窗提醒。后者,明明是 IE 内核却要拼命伪装成 Chrome 内核,我能怎么办呢?
8. 文章页页首装饰图(Feature Image)
后台文章/页面编辑器中有一个设置特色图(Feature Image)的窗口,每篇文章/页面需要单独设置,没有设置时默认为空白。这不是 bug,因为并不是每篇文章都需要装饰图,视频教程。
最后,关于 bug 反馈
在提出你认为的 bug 之前,可先用这里的 Windows 调试环境(里面的主题版本是很早以前的了,请手动更新一下)复现出该问题;如果愿意帮我修改,欢迎提交 Pull request。除非是 bug,如果仅仅是其他样式/功能的需求,请自己动手吧,不过 DIY 内容也欢迎提交 Pull request。其他使用相关问题可在下面留言;主题相关问题不接受微信/邮件私信。
IV. 下载
项目发布于 GitHub:mashirozx/Sakura,如果下载速度慢可使用国内镜像,Pull Request 和 Issue 请提交到 GitHub。
目前正在重构主题,Sakura v3.x 版本人基本不再维护。重构版主题采用 webpack 打包,更易于维护和 DIY,重构项目预览(务必阅读 README):https://github.com/mashirozx/Sakura2。
主题交流群:860262481
另有 hexo 版主题分支:honjun/hexo-theme-sakura
需要服务器吗?我现在在用的这家最低 $3.5/月($2.5 版没有 IPv4),下面的邀请链接可以获得 $10 的奖励~
若有幸您采用了我的主题,欢迎交换友链。您若喜欢,打赏一下也是极吼的~
Comments | 1,984 条评论
请问这评论系统是什么评论系统?
上传主题的时候提示点击的连接失效是怎么肥死..?
时光轴和友链模板怎么使用啊,会的讲一下。
@. 时光轴、友链、留言板以及邮件问题已解决, 爬了几天坑。

@. 求教 怎么加啊
@nico liu 页面里面有模板
很棒
有没有大佬加qq教一下这里小白啊,主页面完全不会弄qwq
为什么我装完没有时间轴啊,怎么弄,另外感谢,不用大弄,太赞了,还有左下角的小姐姐怎么弄…
@为→你锁鈊。 +1
@2323825 我回了,时光轴在模板里,小姐姐要自己弄…,对小白比较难,我弄是弄出来了,但是不会调位置…,还有邮件模板自己能改吗,怎么改?
@为→你锁鈊。 时光轴怎么弄的,我用那个模伴会报错,你说一下你qq微信我加你
@. 请问时光轴你做出来了吗
@Happy 搞定了
@Happy 自己摸索了半天
@. 能加个qq吗?我想请教一下你。
我装完没有时间轴,哪里弄啊,另外,感谢,基本不用大弄,小调下就行了。
@为→你锁鈊。 时光轴的问题可以看下这里
(°∀°)ノ
https://jss.moe/641
请问怎么才可以更换主题的指针呢?
主题真的很棒 非常感谢大神 研究很久终于本地可以运行了 不过不知道为什么我的数据库老是出错 有些表只有frm文件 还有主题也显示不全 看来我还是要多尝试
请问一下,前端主题切换在那里进行更换
你好,我想知道如何使用links模板啊 我新建页面用了page-links模板但是没有什么变化
萌新想学wordpress!
Uncaught ReferenceError: wpActiveEditor is not defined 你好这个是什么情况 添加音乐和视频到文章的时候.谢谢
你好設置了yahoo大頭貼沒效果 發帖試試郵箱有沒有成功 謝謝你的theme很棒很好看~XD
@SamPI-IWGP 爲什麽在我網站大頭貼沒有效果 謝謝。
@SamPI-IWGP 啊咧 我重啓了vps就好了 不過還是謝謝了XD
给力,必须start,期待博主更多精美的主题!
@pigMan 新主题开发中。。https://dev.2heng.xin/
@Mashiro 可不可以在文章底部增加一个一件生成海报的功能呢,点击后会生成一个海报 然后保存图片 可以分享到朋友圈 好友可以通过海报的二维码访问这篇文章