本主题在 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 条评论
emmmm~重复反馈下…不知道会不会挨揍~
https://github.com/mashirozx/Sakura/issues/67
怎么做出这个呢~

@上官月染 CSS自定义字体
@Spirit 谢谢回答~虽然还是不知道怎么做就是了~
@上官月染 后台自定义css填写:
.moe-mashiro {
font-family: ‘Moe-Mashiro’,’Merriweather Sans’,Helvetica,Tahoma,Arial,’PingFang SC’,’Hiragino Sans GB’,’Microsoft Yahei’,’WenQuanYi Micro Hei’,Sans-Serif;
}
@后宫学长 嗯嗯,不过这个字体文件里面只有标题上用到的那几个字哦
@Mashiro 才发现,你自己做的字体呀。
使用主题后仪表盘没有变化
@eternal 变化什么?
@Spirit 就是文章里说的Dashboard 美化
@eternal 登录后台注意看
主题文件夹/inc/css/dashboard-light.css
有没有被加载出来,没有就在functions.php
中的admin_style()
里补上@Spirit 没有加载出来,但是functions.php中却有这一句
if ( get_user_option( ‘admin_color’ ) == “light” ) {
wp_enqueue_style(‘cus-styles-light’, get_site_url() . ‘/wp-content/themes/Sakura/inc/css/dashboard-light.css’);
}
@Spirit 把判断上面的这句wp_enqueue_style(‘cus-styles-light’, get_site_url() . ‘/wp-content/themes/Sakura/inc/css/dashboard-fix.css’); 删了就好了….
@Spirit 我这样该会有什么影响吗?dashboard-fix.css有什么用?
@eternal 那是应该是修复后台小电视表情的,你可以把
wp_enqueue_style(‘cus-styles-light’, get_site_url() . ‘/wp-content/themes/Sakura/inc/css/dashboard-fix.css’)
中的cus-styles-light
修改为其它名字@eternal 好像是上次更新时删多了一行,下次更新时解决
大佬请问监控怎么做
@smallxu038 试试Netdata叭
@smallxu038 Grafana+Prometheus+Zabbix
https://sufe.gq/
为什么点开我的文章啥都没出现,其他主题可以显示,哪里没设置吗,还有首页的导航页,怎么出现QQ、微信那种个人介绍?找了半天也不知道哪里没设置好。。。
@梦似幻≈ 1.点开文章要出现什么吗?描述不清楚欸,,
2.取消勾选
Sakura主题设置-社交信息
@Spirit 点开文章不出现文章内容。。。
@梦似幻≈ 有网址吗,我看看吧
@Spirit https://119.23.213.172/wordpress/
刚刚把那个社交信息勾选去掉也显示不了那个个人页。。。感觉我的主题安装有问题。。。
@梦似幻≈ 兄弟,我打不开你发的地址~
@Spirit 不可能啊。。。我能打开的。。你试试https://119.23.213.172能打开吗
@梦似幻≈ 无响应
@Spirit 那算了。。。。。。还是谢谢你了
@梦似幻≈ 刚打开 示例页面 正常,你检查下主题页面中的 注意事项 和 FAQ ,再重新更新下固定链接试试
@梦似幻≈ 还有看看伪静态设置对没
@Spirit 好的,谢谢表哥
之前遇到的代码块显示问题好像又复现了,手头没有电脑只有手机,搞了一个下午还没有搞定(还是太菜)
麻烦大佬帮忙看一下
@へキシス雪桜 我知道原因了,就是因为开了CDN,导致了代码块显示异常。这个有没有办法从服务器上解决呢
@へキシス雪桜 WP Editor.md 插件的问题,只有暂时禁用了。
我视频怎么不行啊?一直载入中
主页视频界面为什么只有声音没有画面出来?F12不报错
设置了特色图片,但是进入文章页面之后标题并没有背景(您可以进我网站名为特色图的文章查看,那个设置了特色图,主页也可以显示,但是文章页标题处并没有显示特色图),请问是我设置问题还是什么,还有菜单栏那部分要怎么居中
@svipwuyu 请在
外观-Sakura主题设置-基本设置
中取消勾选头部装饰图
适合二次元
You don’t have permission to access /wp-admin/update.php on this server.
每次安装都显示这个.直接安装目录里也用不了,无语.
@素墨乂 修改
/wp-admin/update.php
的权限为755请问下手机网页对banner那图片没做自适应。请问可以怎么解决。CSS那边我比对了下没有更改。


@阝丿 堅 可以了,之前在imgbox.php修改了个东西,导致出问题了
请问下如果后台登陆地址被修改后打不开了,如何改回去?
本人小白,想学习WordPress,该去哪里找一些学习资料或者开源项目呢
@你的优乐美啊 直接抓来一个主题魔改,有问题问google,英文搜索结果质量比中文高100倍,wp的文档也很详细,请认准https://codex.wordpress.org
发现bug
1.友链logo获取错误,本来是a站logo,却在b站上显示
2.统计问题,该主题依靠统计插件,该插件似乎不能将WordPress之前的统计导入,导致所有文章阅读量归零。
3.不能加载内联图像,这个就没什好说的了一直在哪里转圈圈
4.主页有时会白屏,这个可能是我的问题,等我排查一下。
详细信息我已在https://www.gymxbl.com/946.html这篇文章指出。望大佬修复。
@smallxu038 1.我的小站暂未发现该问题,请检查友链具体设置

2.这个没办法,数据库不一样
(苦笑)
3.我发现是图像class缺少lazyload,我的解决方法:在functions.php对应的行数,修改替换图片那个函数的正则表达式
4.应该是着陆页非首页时首页浮现效果延时
如有不对,请指正
@spirit1431007 能否将旧siren的阅读量统计表导入到该主题的阅读量统计表?(本人仅仅为一初中生,有许多不解之谜,请大佬指教)
@smallxu038 不太了解siren主题的统计方式
不过wp-statistics的数据库是可以修改的。只是阅读数可以修改wordpress数据库/wp_statistics_visit
的对应值,想要修改具体访客的话在wordpress数据库/wp_statistics_visitor
中操作,如果不嫌麻烦可以试试看。@spirit1431007 大佬能够给予指点吗?
@spirit1431007 我发现,切换回siren,浏览量仍然会叠加会去

@smallxu038 叠加?那可能浏览统计数据在
wp-post
表里(我也不太确定),你多找找几个表,这么大的数应该很好找@smallxu038 噗,忘记删除线的格式了
,将就看吧
@smallxu038 siren统计用的是一个wordpress的自定义字段,而本主题使用的是wp-statistics插件提供的计数接口,该插件依据数据库中记录的IP计数,所以无法实现导入
@Mashiro 那能否到数据库内,手动修改插件的表呢?以及友链logo能否自定义呢?(好多无法自动获取)内联图像不加载如何解决?
@smallxu038 不现实。。友链logo在链接编辑页面填写图片地址就行了
@Mashiro 您好,我发现我在页脚的每日一言一直不能居中,不管用了何种方法,这是我从来没遇到过的,请您指导
@Mashiro 同样的,参考我的测试站(正在二改siren)jx.gymxbl.com则无此问题
那个音乐歌单的页面在哪里找?
@不想取昵称 安装Hermit X播放器