Skip to content

Commit

Permalink
Merge pull request #19 from nicocatxzc/main
Browse files Browse the repository at this point in the history
增加Faq说明,修复部分排版,移除了文章功能区挂掉的图片,然后新增了一个整的并做了相关讲解,对一些设置项进行了更详细的说明
  • Loading branch information
mirai-mamori authored Nov 10, 2024
2 parents 52ad221 + b239fed commit 166cd0a
Show file tree
Hide file tree
Showing 6 changed files with 117 additions and 39 deletions.
19 changes: 12 additions & 7 deletions docs/Sakurairo/Global/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -347,11 +347,14 @@ title: 全局设置

### 使用自定义 MetingAPI 或者歌单文件

不指定默认使用主题内建的MetingAPI,使用海外服务器可能会被拦截,使用自定义MetingAPI可以解决此问题。
如何搭建MetingAPI? 项目地址:https://github.com/metowolf/Meting-API ,建议参考网上教程使用容器化部署

或者直接填写静态歌单文件,手动指定各个资源的url,但是只有填写歌单id后才会生效,随便填一个即可
虽然前端代码访问时仍然会带歌单id等查询参数,但是访问静态文件的话一般情况下会被服务器无视。
不指定默认使用主题内建的MetingAPI,使用海外服务器可能会被拦截,
使用自定义MetingAPI可以解决此问题。
如何搭建MetingAPI?
项目地址:https://github.com/metowolf/Meting-API ,建议参考网上教程使用容器化部署

或者直接填写静态歌单文件,手动指定各个资源的url,保存为.json文件后将其url填入设置项即可。
但是只有填写歌单id后才会生效,随便填一个就行
虽然前端代码访问时仍然会带歌单id等查询参数,但是访问静态文件的话一般情况下会被服务器无视。
示例(一块块复制粘贴填写即可,最后一块 `}`后不要留 `,`):


Expand All @@ -373,8 +376,10 @@ title: 全局设置
}
]
```
懒得从0开始编写?您也可以从网上公开的公益api获取一份后进行删改(获取格式:apiurl?server=运营商&type=playlist&id=歌单id)
网易为netease,QQ音乐为tencent,如有更多疑问请参考官方说明文档,其他运营商可能未适配
懒得从0开始编写?
您也可以从网上公开的公益api获取一份后进行删改(获取格式:apiurl?server=运营商&type=playlist&id=歌单id)
网易为netease,QQ音乐为tencent,
如有更多疑问请参考官方说明文档,其他运营商可能未适配

### 页尾在线音乐播放器代理

Expand Down
19 changes: 12 additions & 7 deletions docs/Sakurairo/Homepage/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -263,6 +263,11 @@ title: 主页设置
### 社交网络

>部分url获取教程:🪧
比如抖音,可以使用网页版在“未登录”的情况下搜索自己发过的作品,或者评论过的视频,
从自己的头像可以点进自己的网页版空间,然后复制url即可
跟b站不同,登录都复制的是self链接,分享出去的是打不开的!

- 支持填写:
- 微信
- QQ
Expand All @@ -272,15 +277,15 @@ title: 主页设置
- GitHub
- Telegram
- Steam
- Youtube
- Instgram
- 抖音
- 小红书
- Discord
- 知乎
- QQ 空间
- Lofter
- 优酷
- 领英
- 推特
- 脸书
- CSDN
- 简书
- Twitter
- Facebook
- 自定义社交网络图标及链接
- 电子邮件用户名
- 电子邮件域
Expand Down
Binary file added docs/Sakurairo/Pages/docs_aera_discribtion.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
29 changes: 5 additions & 24 deletions docs/Sakurairo/Pages/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ title: 页面设置

![圆角样式](https://s.nmxc.ltd/sakurairo_vision/@2.6/options/page_style_iro.webp)
- 直角样式

![直角样式](https://s.nmxc.ltd/sakurairo_vision/@2.6/options/page_style_sakura.webp)

### 页面排版样式
Expand Down Expand Up @@ -72,37 +73,17 @@ title: 页面设置

关闭后图片中功能栏将在页面中隐藏

![功能栏](https://pic.aiccrop.com/origin/2023/07/64a254deabc2e.png)
![功能栏](./docs_aera_discribtion.png)

### 文章知识共享协议

![版权提示](https://pic.aiccrop.com/origin/2023/07/64a23315c3245.png)
从左到右依次为文章知识共享协议、作者头像、作者昵称、作者个人介绍、文章最后更新时间、文章标签
在文章页面设置页均有其对应的设置项决定是否开启,目前暂无法更改其显示顺序

### 文章页面赞赏功能(支付宝/微信二维码)

- 文章页面赞赏按钮支付宝二维码:填写收款码 URL

- 文章页面赞赏按钮微信二维码:填写收款码 URL

### 文章页面作者头像

![作者头像](https://pic.aiccrop.com/origin/2023/07/64a23325411dd.png)

### 文章页面作者名字

![作者名字](https://pic.aiccrop.com/origin/2023/07/64a254d81353a.png)

### 文章页面作者签名

![作者签名](https://pic.aiccrop.com/origin/2023/07/64a254d18fca7.png)

### 文章最后更新时间

![更新时间](https://pic.aiccrop.com/origin/2023/07/64a24cf1a195e.png)

### 文章标签

![文章标签](https://pic.aiccrop.com/origin/2023/07/64a254ca555a7.png)

### 文章页面上下文章切换

Expand Down Expand Up @@ -316,4 +297,4 @@ WordPress 默认会使用邮件通知用户评论收到回复,开启之后允

### 管理员邮件回复通知

开启之后当管理员评论收到回复时使用邮件通知
开启之后当管理员评论收到回复时使用邮件通知
18 changes: 18 additions & 0 deletions docs/Sakurairo/Update-Log/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,24 @@ title: 更新日志
---
# 更新日志 <Badge type="tip" text="By Kanochan, AstroNomen"/>

## 2.7.2

**发布日期**[2024年11月3日](https://github.com/mirai-mamori/Sakurairo/releases/tag/2.7.2)

![img](https://p.sda1.dev/19/8fb19c945f83abb12cdeecceeb5413ce/image.png)

### 新增功能

* 增加自定义歌单的功能,用户可以使用自定义MetingAPI或者直接指定歌单文件

### 问题修复

* 修复了站内搜索引擎

## 优化项目

* 增强对Alpine Linux的兼容性

## 2.7.1.1

**发布日期**[2024年10月20日](https://github.com/mirai-mamori/Sakurairo/releases/tag/2.7.1.1)
Expand Down
71 changes: 70 additions & 1 deletion docs/first-step/q&a/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,12 @@ title: 常见问题

# 常见问题

对于您遇到的问题,建议优先通过查找历史issues寻找可能的解决方案 [点击前往查找](https://github.com/mirai-mamori/Sakurairo/issues?q=is%3Aissue+is%3Aclosed)
如果本文档没能解决您的问题,可以尝试使用搜索引擎搜索 “关键字 + site:docs.fuukei.org”
看看是不是哪里没能引起你的注意

如果还是没能解决你的问题,可以 [在此处](https://github.com/mirai-mamori/Sakurairo/issues/new/choose) 参考模版提出您遇到的问题

## 主题设置保存不生效怎么办?

::: tip
Expand All @@ -20,7 +26,9 @@ title: 常见问题
## 主题升级以后我会丢失什么吗?

::: tip
在主题设置及WP内置的主题自定义CSS功能内进行的任何设置均不会丢失,而对主题本体文件的修改将会丢失
在主题设置及WP内置的主题自定义CSS功能内进行的任何设置均不会丢失,而对主题本体文件的修改将会丢失
因为wordpress本身的特性,使用主题内建的的随机图片(gallary目录)在wordpress后台更新主题后会被清空,
如果你使用主题内建随机图片,请手动上传主题更新文件到wp-content/themes目录完全覆盖进行手动更新
:::

## 我的服务器在国内,默认更新源无法检测更新怎么办?
Expand All @@ -36,3 +44,64 @@ title: 常见问题
在桌面端:不支持IE浏览器,对Edge Html引擎支援不佳。 如果你使用的浏览器不在上文范围内,请前往 Github 发送 issue 获取帮助
:::

### 我设置的图片、自定义字体等资源没有生效怎么办?

::: tip
遇到这类问题,请先在PC端浏览器按F12,切换到网络面板(network)使用ctrl+F5清除缓存强制刷新,
在页面停止载入后浏览所有已拉取的资源,检查资源是否被正常载入,
如果资源条目底色为红色,建议右键在新标签页打开,看看浏览器能否正常访问,
如果浏览器不能正常访问,请检查相关资源路径设置是否正确

对于手机端用到的资源请将页面宽度调到860px以下,建议额外使用插件将UA设置为安卓手机,然后按上方操作进行调试。

浏览器可以正常访问:
切换到控制台(console),检查蓝色链接条目,找到你设置的资源路径,
如果该条目含有关键词`“Access-Control-Allow-Origin”`,请参照以下配置更新你的资源所在网站服务器配置然后重启:
Nginx/Openresty
```
server {
listen 80 ;
listen [::]:80 ;
listen 443 ssl http2 ;
listen [::]:443 ssl http2 ;
server_name record.nicocat.cc;
index index.php index.html index.htm default.php default.htm default.html;
add_header Access-Control-Allow-Origin '*' always; |<<<主要就是参考这三项所在位置添加这三项即可
add_header Access-Control-Allow-Methods '*' always; | 套了cdn的域名请自行参考网上教程进行相关配置
add_header Access-Control-Allow-Headers '*' always; | 关键词“CORS报错”
if ($request_method = 'OPTIONS') {
return 200;
}
......
}
```
如果你的网站启用了https(htst、ssl证书),请同样引用https的资源,http的资源会被视为不安全进而被拦截。
:::

### 我的主页为什么有奇怪的声音?

::: tip
查看浏览器网页标签是否有🔊图标可以判断是否是您的网页发出的声音,
如果是,可以尝试关闭“全局设置——额外设置——音符触动特效”后刷新检查
:::

### 怎么配置cdn?图片cdn怎么使用?

::: tip
在“其他设置——低使用设置——图片cdn”,
该功能可以修改全局上传到媒体库的文件的链接,其实不只是图片,
为你的uploads目录单独建立一个服务器,分配一个二级域名即可,

举个例子:
比如你的博客是`fuukei.org`,可以为`files.fuukei.org`配置cdn
fuukei.org的网站目录/文件夹在`/opt/openresty/openresty/www/sites/fuukei.org/index`
那么为需要代理的目录/文件夹就是`/opt/openresty/openresty/www/sites/nicocat.cc/index/wp-content/uploads`
你可以创建一个新的站点,为其分配二级域名`files.fuukei.org`,然后创建index软链接或者硬链接指向需要代理的目录/文件夹即可
如果你是使用docker部署的web服务器,在挂载卷中将wordpress目录挂载为本地目录,
然后将uploads目录挂载为cdn域名网站的index目录即可

那么你在图片CDN设置项应该填写的就是“`https://files.fuukei.org`

同样,不一定必须指派index目录,如果您多个网站共用这一个资源站,
目录映射对了,设置填写对了同样可以生效

0 comments on commit 166cd0a

Please sign in to comment.