Sakura Theme FAQ

发布于 2020-02-20  1568 次阅读


最近在群里也随意看了一下,发现还是有挺多小白和萌新的(虽然我也是XD。然后来来去去也是在问那几个问题。因此也心血来潮,整理一下近期看到大家询问的比较多的一些问题,尽我所能来回答一下。当然大家如果有我没收录的问题也可以单独问我,或者你有什么好的想法也可以跟我补充说明,也欢迎大家debug。感谢大家的支持~

2020.2.21 更新友链和时光轴的食用方法
2020.2.26 更新关于首页不显示某些文章的设置方法
2020.2.29 修复关于设置小工具的错误
2020.3.15 添加了推荐插件
2020.3.24 修复并添加了DIY之后主题的更新方法

写在前面

搭建网站其实并不是一个容易活,尤其对于计算机基础相对薄弱的萌新来说。因此,如果你想做出有着你个人特色的网站,或者在白猫的基础上进行一定程度的DIY,对以下技术略有涉猎还是非常有必要的

  • HTML5
  • CSS
  • Javascript
  • PHP

实际上除了javascript和PHP两门编程语言可能有点复杂之外,HTML5和CSS我个人认为还是非常容易上手的!不出一个星期就能熟练运用了~

当然如果你只想直接拿白猫的主题来用,不想去添加或者修改什么,那也是可以不需要了解的~

除此之外,最好学会如何百度以及学会查看白猫在github中写的wiki。个人经验来说,wordpress很多问题都是可以百度得到的。

很多问题你可以通过以下资源获得解答:

百度:www.baidu.com

Sakura主题的wiki:https://github.com/mashirozx/Sakura/wiki

Sakura主题说明:https://2heng.xin/theme-sakura/

关于wordpress的使用方法,您可以通过wordpress大学的教程区进行相关的学习:

wordpress大学:https://www.wpdaxue.com/

实践出真知,很多小白一直在询问这些那些,可是如果自己不上手做做研究一下怎么知道行不行呢?

最后再声明一点:本FAQ将尽量围绕白猫已经开源的部分或者其他博主发布的部分进行答复,出于对白猫个人的尊重,一些在他博客中出现但并未开源的元素(例如关于我等)这里不做统一解答。也建议大家不要做伸手党,什么都希望其他大佬能直接解决(那你能帮帮我吗.jpg)。大家可以自寻寻找其他博主发布的资源作为代替或者学习上述技术后自力更生,丰衣足食(๑•̀ㅂ•́)و✧

本FAQ将分为两个部分:wordpress部分和Sakura主题部分,如果内容比较多大家可以使用ctrl+F进行关键字搜索

使用的Sakura版本:v3.3.7,wordpress版本:5.3.2

请尽量更新到Sakura的最新版本。

建议使用的插件

下面插件因为与主题适应性极好,最好安装,甚至安装后可以解决你的大部分问题

(由于国内常常访问插件时425,故在这里贴出的都是插件的 github 界面)

  • wp editor.md

https://github.com/LuRenJiasWorld/WP-Editor.md

建议各位小伙伴都去了解一下 markdown 的书写方式,这是一种非常高效便捷的写作语法。

因为我一开始用 wordpress 的时候就已经使用这个插件了所以不太清楚不用这个插件是怎么样的orz

  • Hermit X

https://github.com/MoePlayer/Hermit-X

Hermit X 就是可以让你插入网易云音乐的一个插件啦(效果看本站音乐台

大家如果在插件安装页面搜索到的 Hermit,是老版本的,建议安装这个新版的Hermit X

而且这个插件,也只有在安装了 wp editor.md 插件之后才能更好的发挥作用(就是在编辑界面多了一个添加音乐的按钮,在原版编辑器当中是没有的。

wordpress部分

如何在菜单中显示二级菜单同时一级菜单的按钮不可点击?

在wordpress后台 -> 外观 -> 菜单

在“添加菜单项”当中选择自定义链接。

在URL当中随便输入一串字符,链接文本为按钮的名字。如图所示:

点击“添加到菜单”,就可以在右侧操作窗口中看到了

之后我们再将URL的内容进行去除,并拖曳添加你的二级目录。最后结果如图所示:

怎么制作有一系列文章的分类页面?

在wordpress后台 -> 文章 -> 分类目录里面进行设置。

白猫大大的留言板是怎么弄的?

留言板为一个普通的页面,与普通的wordpress页面食用方法一致。将一个页面的评论打开,就可以作为留言板了。

关于白猫的诗词,这里白猫使用了今日诗词的api:https://www.jinrishici.com/

具体食用方法请查看上方链接并通过HTML、CSS、Javascript的相关知识自己制作。

大家也可以调用其他例如一言api等实现类似效果。

当评论之后,如何在回复时发送电子邮件通知评论人?

wordpress默认是会发送邮件的,但要开启填写电邮。该选项在设置 -> 讨论 -> 其他评论设置当中“评论作者必须填入姓名和电子邮件地址”勾选并保存。

同时在Sakura主题设置当中的“其他”选项卡中“邮件回复通知”可以设置让用户自行选择是否开启邮件回复通知。

之后我们需要配置wordpress的邮件系统。

这里需要安装一个邮件插件,大家可以在插件 -> 安装插件进行插件的安装下载,直接搜索mail或者邮件即可。

这里以Easy WP SMTP举例。

进入Easy WP SMTP的后台界面

From Email Address:发件地址。你可以选择你的qq邮箱、163邮箱或者其他邮箱。

From name:邮件发件人的名字,默认你的站点名称。

Reply-To Email Address:回复邮件地址。指当有人回复你网站发出的邮件之后的收件地址。可以选填,留白即代表和发件地址相同。

SMTP Host:邮件服务商的SMTP地址。大家可以通过你的邮箱设置当中找到,也可以百度搜索到。

Type of Encryption:加密类型。也需要在你的邮箱设置当中查找。一般都为SSL。

SMTP Port:SMTP端口。在邮箱设置当中查找,不同服务商不相同。

SMTP Authentication:SMTP验证。默认Yes即可。

SMTP Username:SMTP用户名。默认为你的邮箱用户名,如果有特殊请联系邮件服务商。

SMTP Password:SMTP密码。这里有一个坑,很多邮件服务商的SMTP密码是独立的,不与你原本邮箱密码相同。例如TX邮箱需要在设置当中自行开启SMTP服务之后再查看单独的密码。需要把这个密码填入进去。大家可以搜索你的邮箱运营如何查看SMTP密码。

填好以后点按钮保存。在上方的Test Email选项卡中可以进行测试是否配置成功。

为什么我的文章写出来是404?

伪静态和固定链接没有做好。

如果是小白建站应该都会使用宝塔面板,可以一键配置伪静态。

在你的宝塔面板的网站选项卡中,找到你的网站,点击右边的“设置”按钮。

在设置界面当中选择伪静态,上方的下拉框中找到“wordpress”选项,选择后点击保存即可。

如果你没用宝塔面板,那也可以通过手动修改Nginx的方式来添加伪静态。

在nginx当中添加以下规则:

location /
{
     try_files $uri $uri/ /index.php?$args;
}

rewrite /wp-admin$ $scheme://$host$uri/ permanent;

然后运行nginx -s reload重新加载nginx设置即可。

(当然你有能力使用Nginx配置网站,也有能力不看这个FAQ了。。。)

之后在wordpress后台 -> 设置 -> 固定链接设置当中就可以任意选择你想使用的设置了。

个人建议选择自定义结构,有利于SEO收录以及个人记录。

(条目缺省:Apache服务器的相关方法待补充)

为什么我安装不了插件/wordpress无法更新?

最近wordpress源站受到大量攻击。服务器不稳定,经常出现Too many Requests的错误。安装不了插件属于正常现象。可以在服务器较稳定的时候去wordpress.org上手动下载后传到网站根目录下的wp-content/plugin文件夹下解压。

如何写文章?

建议安装WP Editor.md插件,比wordpress原版编辑器友好。

同时wordpress的文章使用markdown标记语言进行书写,简单易上手。大家可以自行百度markdown的食用方法,也可以使用例如Typora等markdown编辑工具在本地写好文章后再拷贝到wordpress文章页。

如何制作白猫大大的歌曲清单?

白猫这里使用了Hermit插件,可以去后台或者wordpress.org下载。

RSS是什么,如何生成RSS?

简易信息聚合(也叫聚合内容)是一种RSS基于XML标准,在互联网上被广泛采用的内容包装和投递协议。RSS(Really Simple Syndication)是一种描述和同步网站内容的格式,是使用最广泛的XML应用。RSS搭建了信息迅速传播的一个技术平台,使得每个人都成为潜在的信息提供者。发布一个RSS文件后,这个RSS Feed中包含的信息就能直接被其他站点调用,而且由于这些数据都是标准的XML格式,所以也能在其他的终端和服务中使用,是一种描述和同步网站内容的格式。

——百度百科

简单来说,就是一个XML文件,可以获取你的所有文章。其他人可以订阅你的RSS,并在你发布新文章后收到订阅更新。

制作RSS可以参考这个教程:https://sspai.com/post/34320

网站加载太慢了,怎么提速?

使用CDN以及使用相关wordpress插件(如super cache)等,自行百度。

Sakura主题部分

请在查阅以下内容前认真阅读Sakura主题的Wiki和白猫博客的Sakura主题介绍!

以下回答默认的操作面板为wp后台->Sakura主题设置

如何修改首页大图?

Sakura版本3.3.6情况下:

在sakura主题设置当中的第一屏设置下

在“封面图片库选项”下有三个选项:

  • 内置原图随机图:即调用主题内置的随机图函数,使用方法为将你需要用的图片放入主题文件夹下的manifest文件夹下。之后在“封面图片库URL”下填入一个Rest URL(可以理解为一个特定的链接格式)。即https://example.com/wp-json/sakura/v1/image/cover ,将example.com换成你的域名即可。
  • webp优化随机图:webp是一种新的图片格式,对浏览器非常友好。建议使用。食用方法:https://github.com/mashirozx/Sakura/wiki/options
  • 外部随机图API:API可以理解成一些dalao帮你把东西和资源打包好后给你个链接,直接调用就行。食用方法为将封面图片库URL修改成API提供的链接即可。例如https://api.btstu.cn/提供的随机壁纸,直接将提供的链接填入即可。

Sakura版本3.3.3~3.3.5

建议升级3.3.6(别问,问就是懒XD)。

因为3.3.3有点小bug,因此其实还是建议升级会比较好。而且之后版本也主要是修复了这个bug。

Sakura版本3.3.3以下

将图片放入/cover/gallery下即可

如何更新Sakura主题?

手动更新可以在这里进行下载最新源码。将新的主题上传服务器替换旧的主题即可。设置都保存在数据库当中,不必担心。

但更建议使用github命令行更新。

这里直接照搬wiki页面:

切换到主题目录:

cd /PATH/TO/wp-content/themes/Sakura

检查 Git 更新:

git fetch origin

下载更新:

git pull origin

这时 Sakura 内的主题文件已经更新为最新版了,如有 PHP、WordPress 缓存,刷新缓存即可。

以上为官方的更新方法,建议使用。

当然还同样有很多小朋友自己DIY过主题的,这样子更新,所有的DIY就会都没有了,那咋办呀?

这里相信懂git的同学都知道怎么做啦,以下内容是给不清楚git食用方法的同学的。

第一步我们依然是需要 git fetch origin

之后呢,我们要对我们的DIY内容进行一个提交,依次输入以下两条命令:

git add .

git commit -m 'DIY Update'

此处字符串 "DIY Update" 可以替换任意内容。

如果你是第一次在服务器上使用 commit 指令,则 git 会提示需要输入你的邮箱以及姓名之类的,执行完提示的指令之后(应该是两条 git config global指令)再执行一次 commit 指令,将当前的 DIY 修改提交到版本库当中。

之后我们需要进行将 origin 分支(也就是白猫的新版本)与你刚刚提交的DIY版本进行一个合并,只需一个merge指令即可:

git merge origin

git 会自动帮你把你所有的修改与白猫的版本进行一个自动合并,非常方便。但同样假如有个地方你也修改了,白猫也修改了,git 就犯愁了:这个时候该怎么合并鸭~

因此你会看到 merge 的输出(以我的举例子):

root@debian:/www/wwwroot/davincievans.top/wp-content/themes/Sakura# git merge origin
Auto-merging tpl/content-thumb.php
Auto-merging tpl/content-none.php
Auto-merging style.css
Auto-merging languages/zh_CN.po
Auto-merging languages/zh_CN.mo
Auto-merging languages/sakura.pot
Auto-merging languages/en_US.po
Auto-merging languages/en_US.mo
Auto-merging js/sakura-app.js
Auto-merging inc/theme_plus.php
Auto-merging inc/swicher.php
Auto-merging inc/decorate.php
Auto-merging inc/api.php
Auto-merging functions.php
Auto-merging comments.php
CONFLICT (content): Merge conflict in comments.php //大家注意这一行
Auto-merging cdn/js/src/11.third-part-functions.js
Automatic merge failed; fix conflicts and then commit the result.

在这里,我和白猫都修改了 comments.php 的同一处地方,因此 git 不知道如何合并,需要我们进行手动合并。

git 会很贴心的将冲突位置标志在文件当中,我们只需要打开 comments.php,往下翻直到看到:

<<<<<<< HEAD
                            'avatar' => '<div class="cmt-info-container...此处省略
=======
                            'avatar' => '<div class="cmt-info-container...此处省略
>>>>>>> origin

git 会用<<<<<<<<<>>>>>>>>>>>>标记出不同的版本。HEAD 代表我们的版本,origin代表白猫的版本,中间用了===========进行分割开来。

假设你需要保存你的DIY版本,那么将HEAD与分割线之间的代码留下来,其余的都删除,保存文件,再执行一次commit

git commit -m 'DIY Update'

更新完成。

首页文章块的热度不显示?

安装WP-Statistics插件。

或者在后台—其他下面将统计接口改成主题内建。

Sakura无法使用?

截止本文编辑时,Sakura的最新版本为v3.3.6。Sakura2主题还未完成,请多加注意是否有下载错误。

Sakura主题所需要的php版本为7.1以上,请到服务器内确保php版本足够高。

若仍有出错,请检查是否是出现文件损坏,同时可以查看是否其他主题使用正常。

若仍有错误,可以到Github页面下提Issues进行解决。

左下角的小人儿/看板娘怎么添加的?

使用插件poilive2d。插件作者地址:https://daidr.me/archives/code-176.html

白猫大大留言板的诗词是怎么实现的?

每日诗词api接口:https://www.jinrishici.com/

我想修改xxx/添加xxx怎么搞?

这里涉及到主题的DIY部分,建议在拥有一定的技术基础之后再进行操作。

Sakura主题的静态文件默认走CDN,因此需要在后台让其调用本地的js库DIY效果才会生效。具体设置位置为 CDN -> 本地调用主题js,css文件。

为什么不详细写出各种DIY的方法呢?毕竟大家的想法千变万化,修改的方式也是各有不同。甚至不同的方式在有的服务器可以,有的却不行。总之这是一个自己的DIY过程。毕竟有各种想法,而我也没有这么多精力对每一个想法去编写代码一一尝试。因此也希望大家如果有想要的DIY尽量动手做,你也可以分享自己的DIY成果。

虽然说DIY需要一定技术,但每个DIY的总体思路都是一致的,跟着解决问题的思路走就可以了。

所需技术在文章开头已经列出。

实际上思路很简单:找到要修改/添加的位置 -> 修改源码即可。请勤用f12在页面中进行审查元素以及使用ctrl+F查找源码位置。这可以解决大部分问题。

我个人认为白猫的编程习惯和命名习惯还是不错的,只要看得懂英文应该都能知道自己需要修改哪些文件。建议自己动手操作或者百度之后还不行再到群里询问,不要做伸手党!

这里以修改评论区头像为例:

近段时间白猫的一些资源似乎挂了,这也导致使用主题的同学的一些资源未能加载出来。

图片挂了说明图片的src有问题。

我们在头像上点击右键 -> 检查或者按f12。找到图片的src。

你也可以同样使用控制台来查看有无报错之类的,总之找到问题的源头还是不算难的。

(这里为了做示例我修改成了aaaa)

然后我们复制这个src,返回到主题文件夹下面。

可能很多文件大家看的很头疼,但都是有线索的。

比如我们这里是修改评论区的,而评论区在很多个页面下都有。所以实际上有一个单独的程序来控制评论区的渲染。

经过查看发现一个comments.php,就是这没跑了。

进入后按ctrl+f查找src的位置

定位好之后将其修改成你所想要的图片链接即可。

最后说明一下:DIY会出现各种奇葩的问题,因此请确保自己熟练的情况下再做修改。同时做好文件的备份工作。

菜单如何居中?

主题本身没有居中,要想居中请自行修改菜单CSS的margin选项(本人没有修改这里,待补充)

菜单选项旁的小符号是如何制作的?

请自行百度font-awesome以及font-awesome animation,主题均已引入了这两个包,直接在菜单中插入相关的html代码即可。

白猫的友链界面是如何生成的?

在wordpress页面那里新建一个页面,在右边的模板下方选择Links。

页面的内容可以填入你的友链格式啊或者其他内容之类的balabala。

保存该页面,在wordpress后台找到链接选项卡,在这个地方就可以进行添加友链啦

可以参考下图来进行设置

之后进入刚刚设置的友链页面,即可看到渲染效果

这个小标题是通过设置链接的分类目录来实现的,主题也能实现自动渲染。

时间轴页面如何添加?

在新建页面 -> 模板下选择时间轴即可。

如何设置某个分类的文章在首页不显示?

在Sakura设置下的“其他”选项卡中。

其中需要填写的是你的分类目录的ID,这个ID可以通过打开你的分类目录的编辑页,查看该编辑页的URL链接。找到其中有一个字符为tag_id=xxxx,这个xxxx即为该分类目录的id,把这个填进去即可。

怎么使用小工具?

首先你需要在Sakura后台的“其他”选项卡中勾选“支持侧栏小部件”,只有这个选项打开才能在外观中找到小工具选项。

在wordpress后台 -> 外观 ->小工具选项中,对小工具进行设置。

Sakura主题的小工具位置在左下角,将播放器拉开即可。


先写这么多吧,之后看到问题再添加。

也欢迎大家来向我提出好的意见之类的。欢迎交流~


You Are All Stardust.