diff --git a/docs/en/first-step/q&a/index.md b/docs/en/first-step/q&a/index.md index 3d4e9534..249ab550 100644 --- a/docs/en/first-step/q&a/index.md +++ b/docs/en/first-step/q&a/index.md @@ -45,6 +45,7 @@ If your browser isn’t listed here, please report the issue on GitHub for furth ## Why do some pages return 404 errors? ::: tip + 1. Check if the redirected URL looks like `.../xxx.php/xxx/...` with plain text (not styled 404 page). If so, your server may not be correctly configured for URL rewriting (pretty permalinks). Look for a guide matching your server (Apache, Nginx, etc.). After configuring, we recommend backing up important data and reinstalling WordPress to remove faulty links. @@ -52,6 +53,17 @@ After configuring, we recommend backing up important data and reinstalling WordP 2. If that’s not the case, make sure the target page/post/category exists and has been published. ::: +## How to Edit the Navigation Menu at the Top of the Page? + +::: tip +Navigate to **Dashboard > Appearance > Menus**. Create a new menu and edit its content. After saving your menu: + +1. Locate the **Manage Locations** tab (typically displayed in the left sidebar or top tabs) +2. Assign your newly created menu to the **Navigation Menu** location + +For detailed options and settings, see **iro-Options > Global Options > Navigation Menu Options**. +::: + ## My custom images, fonts, etc., are not working. What should I do? ::: tip @@ -63,7 +75,8 @@ If using mobile resources, shrink the page width below 860px. Use dev tools or a If your browser can access the resource: Go to the Console tab and look for links with the keyword `Access-Control-Allow-Origin`. If it shows up, you need to configure your server like this (Nginx/OpenResty): -``` + +```lua server { listen 80 ; listen [::]:80 ; @@ -80,6 +93,7 @@ server { ... } ``` + If your site uses HTTPS, make sure all linked resources also use HTTPS—mixed content will be blocked. ::: @@ -115,6 +129,7 @@ Set: The theme uses automatic dark mode switching. From 22:00 to 07:00 (Beijing time), the theme switches to dark mode. If that’s not the reason: + - Did you accidentally change style via the widget panel? - Did your random image API fail? - Is there a CORS issue with your image? @@ -153,7 +168,8 @@ You can try this: Right-click the affected element → Inspect → drag to highlight the element in DevTools → look for its class. Example: -``` + +```css .leaflet-map-pane { transition: none !important; } @@ -172,6 +188,7 @@ https://highlightjs.org/#usage https://prismjs.com/#basic-usage Basic usage example: + ```html
p { color: red }
...
diff --git a/docs/zh/Sakurairo/Others/index.md b/docs/zh/Sakurairo/Others/index.md
index 5b2c0b4b..c9264ac4 100644
--- a/docs/zh/Sakurairo/Others/index.md
+++ b/docs/zh/Sakurairo/Others/index.md
@@ -243,7 +243,9 @@ google gemini: `https://generativelanguage.googleapis.com/v1beta/openai/chat/com
### Fontawesome加载源
-主题图标使用Fontawesome,默认从`https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.7.2/css/all.min.css`加载,
+主题图标需要使用Fontawesome资源,
+默认为:`https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.7.2/css/all.min.css`
+中国大陆加速可选:`https://cdn.staticfile.org/font-awesome/6.7.2/css/all.min.css`
如果您有更好更快的来源,可以填写自定义来源,不稳定的来源可能造成相关图标显示异常。
### 开发者模式
diff --git a/docs/zh/first-step/q&a/index.md b/docs/zh/first-step/q&a/index.md
index d2b93023..e773da65 100644
--- a/docs/zh/first-step/q&a/index.md
+++ b/docs/zh/first-step/q&a/index.md
@@ -5,44 +5,46 @@ title: 常见问题
# 常见问题
对于您遇到的问题,建议优先通过查找历史issues寻找可能的解决方案 [点击前往查找](https://github.com/mirai-mamori/Sakurairo/issues?q=is%3Aissue+is%3Aclosed)
-如果本文档没能解决您的问题,可以尝试使用搜索引擎搜索 “关键字 + site:docs.fuukei.org”
+如果本文档没能解决您的问题,可以尝试使用搜索引擎搜索 “关键字 + site:docs.fuukei.org”
看看是不是哪里没能引起你的注意
如果还是没能解决你的问题,可以 [在此处](https://github.com/mirai-mamori/Sakurairo/issues/new/choose) 参考模版提出您遇到的问题
## 主题设置保存不生效怎么办?
-::: tip
+::: tip
如果您使用了优化类(静态缓存等)插件,请在保存主题设置后清理插件缓存。如果仍然无法生效,请提交 issue
:::
## 主题有些图片没加载出来怎么办?
-::: tip
+::: tip
首先检查你的网络环境及缓存,确认上述无问题后,请在主题设置中选择“关于主题” --> “资源控制” --> “视觉资源路径” 修改地址
:::
-## 主题升级以后我会丢失什么吗?
+## 主题升级以后我会丢失什么吗?
-::: tip
+::: tip
在主题设置及WP内置的主题自定义CSS功能内进行的任何设置均不会丢失,而对主题本体文件的修改将会全部丢失
:::
-## 我的服务器在国内,默认更新源无法检测更新怎么办?
+## 我的服务器在国内,默认更新源无法检测更新怎么办?
-::: tip
+::: tip
在使用升级功能前,请手动前往主题设置,关于主题中切换更新源为除Github以外的其他选项即可
:::
-## 我使用的浏览器访问启用本主题的网站 出现了问题(按钮失效/无法正常显示等) 是主题问题吗?
+## 我使用的浏览器访问启用本主题的网站 出现了问题(按钮失效/无法正常显示等) 是主题问题吗?
-::: tip
+::: tip
在移动端,以下浏览器不支持:UC浏览器、夸克浏览器、QQ浏览器、安卓QQ内置浏览器、安卓微信内置浏览器。
在桌面端:不支持IE浏览器,对Edge Html引擎支援不佳。 如果你使用的浏览器不在上文范围内,请前往 Github 发送 issue 获取帮助
:::
+
## 我的网站怎么打开XX页面都是404?
-::: tip
+
+::: tip
1.请检查点击后跳转的链接是不是类似于这种:`.../xxx.php/xxx/...`,
并且是纯文字的那种(主题有风格化的404页),
如果是,那么可能是你没有正确配置伪静态,请根据你使用的服务器应用(apache、nginx等)自行寻找配置教程。
@@ -51,9 +53,18 @@ title: 常见问题
2.如果不是,请确保你这个链接确指向一个真实存在的文章/页面/分类,并且它已发布。
:::
+## 页面顶部的导航菜单内容要怎么编辑?
+
+::: tip
+请至`后台——外观——菜单`选项卡创建一个新菜单,编辑好内容后保存,然后你就可以在旁边看见`管理位置`的选项卡了,
+在导航菜单的选项上指派你刚刚创建的那个菜单就行了。
+
+更多关于导航菜单的内容详细请参阅`全局设置——导航菜单设置`的相关内容。
+:::
+
## 我设置的图片、自定义字体等资源没有生效怎么办?
-::: tip
+::: tip
遇到这类问题,请先在PC端浏览器按F12,切换到网络面板(network)使用ctrl+F5清除缓存强制刷新,
在页面停止载入后浏览所有已拉取的资源,检查资源是否被正常载入,
如果资源条目底色为红色,建议右键在新标签页打开,看看浏览器能否正常访问,
@@ -65,7 +76,8 @@ title: 常见问题
切换到控制台(console),检查蓝色链接条目,找到你设置的资源路径,
如果该条目含有关键词`“Access-Control-Allow-Origin”`,请参照以下配置更新你的资源所在网站服务器配置然后重启:
Nginx/Openresty
-```
+
+```lua
server {
listen 80 ;
listen [::]:80 ;
@@ -73,15 +85,16 @@ server {
listen [::]:443 ssl http2 ;
server_name docs.fuukei.org;
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报错”
+ 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;
+ return 200;
}
......
}
```
+
如果你的网站启用了https(htst、ssl证书),请同样引用https的资源,http的资源会被视为不安全进而被拦截。
:::
@@ -150,11 +163,13 @@ fuukei.org的网站目录/文件夹在`/opt/openresty/www/sites/fuukei.org/index

右键受影响的内容并选择检查,尝试拖拽并观察右侧开发者工具中闪烁提示的变化元素,如果观察不到就展开当前层级
找到受影响元素的class,选择其中一个复制粘贴至以下示例样式中:
-```
+
+```css
.leaflet-map-pane {
transition: none !important;
}
```
+
将该样式代码粘贴至`后台——其他设置——低使用设置——自定义CSS样式`中即可尝试修复。
该方案不保证一定生效,仅对类似已经证实的情况有效,请根据你自己的具体情况进行诊断。
:::
@@ -166,9 +181,11 @@ fuukei.org的网站目录/文件夹在`/opt/openresty/www/sites/fuukei.org/index
https://highlightjs.org/#usage
https://prismjs.com/#basic-usage
基本使用方法:
+
```html
p { color: red }
...
```
+
注意其中的``(块级标记,只有code是行内),以及class(语言标记,说明块内的语言类型) ::: \ No newline at end of file