Skip to content

docs: 修改和补充文档#40

Open
MoYingJi wants to merge 16 commits into
SPlayer-Dev:devfrom
MoYingJi:pr/docs
Open

docs: 修改和补充文档#40
MoYingJi wants to merge 16 commits into
SPlayer-Dev:devfrom
MoYingJi:pr/docs

Conversation

@MoYingJi

@MoYingJi MoYingJi commented Jun 17, 2026

Copy link
Copy Markdown
Collaborator

commits 有点太多了,这个 PR 还是压缩合并吧(

整个 PR 的更改有点乱,可以具体看每一个 commit 都改了什么

Copilot 说 Markdown 扩展到容器的语法有些问题。用 VitePress 的语法还是 GitHub 的语法还是给 imsyy 决定吧(VitePress 兼容 GitHub 的语法,我不清楚副作用。GitHub 不兼容 VitePress 的语法)

Copilot AI review requested due to automatic review settings June 17, 2026 13:13

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

本 PR 更新了 Wayland 排障文档,旨在补充/调整在 Wayland 会话下的运行建议与桌面歌词窗口规则示例,帮助用户在不同 DE/WM 下更稳定地使用窗口相关功能。

Changes:

  • 调整“切回 X11(Xwayland)”的说明与桌面项修改指引,并补充 KDE/Niri 的窗口规则示例
  • 更新桌面歌词窗口规则章节结构(新增可导入规则的 <details>
  • 精简了原先关于“原生 Wayland(可选)”的说明段落

Comment thread docs/troubleshooting/wayland.md Outdated
Comment thread docs/troubleshooting/wayland.md Outdated
Comment thread docs/troubleshooting/wayland.md
@MoYingJi MoYingJi marked this pull request as draft June 17, 2026 13:17
@MoYingJi MoYingJi changed the title docs(wayland): 稍微改了一点 docs: 稍微改了一点 Jun 17, 2026
| ------- | ----------------------------------------------------------- |
| Windows | `%APPDATA%\SPlayer-Next\app-data\logs\` |
| macOS | `~/Library/Application Support/SPlayer-Next/app-data/logs/` |
| Linux | `~/.config/SPlayer-Next/app-data/logs/` |

@MoYingJi MoYingJi Jun 17, 2026

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

-| Linux   | `~/.config/SPlayer-Next/app-data/logs/`                     |
+| Linux   | `$XDG_CONFIG_HOME/SPlayer-Next/app-data/logs/`              |

不知道哪种好。$XDG_CONFIG_HOME 更准确,~/.config 更新手友好。我问了 LLM 说最好两种都写 (-_-)

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

Comment thread docs/troubleshooting/wayland.md
Comment thread docs/troubleshooting/wayland.md
Comment thread docs/troubleshooting/debug.md
Comment thread docs/contributing.md

### Visual Studio Code 系列

推荐使用 [i18n Ally](https://marketplace.visualstudio.com/items?itemName=Lokalise.i18n-ally) 插件

@MoYingJi MoYingJi Jun 19, 2026

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

这个插件我怎么都整不好,好不容易整好了一次没法复现,空在这了(

感觉还是有点不优雅。我不会搞(
@MoYingJi MoYingJi changed the title docs: 稍微改了一点 docs: 修改和补充文档 Jun 19, 2026
@MoYingJi MoYingJi marked this pull request as ready for review June 19, 2026 15:26
Copilot AI review requested due to automatic review settings June 19, 2026 15:26

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated 3 comments.

Comment on lines +33 to +37
> [!IMPORTANT]
>
> 即使切换回 Xwayland,全局快捷键仍可能无法正常生效。
>
> 部分桌面环境对此有支持。如 KDE Plasma Wayland 可以在 **系统设置 → 应用程序权限 → 旧式 X11 应用程序支持** 中,将 **监听按键** 设置为 「**和上面一样,加上按住 Ctrl、Alt、Meta 等修饰键时按下的任何按键**」
Comment on lines +125 to +135
> [!TIP]
>
> 要判断一个窗口是原生 Wayland 还是 Xwayland 主要有以下两种方式
>
> - xprop
>
> 安装在终端中执行 `xprop`,然后点击对应的窗口。若什么事情都没发生,则该窗口是原生 Wayland;若终端中出现了该窗口的详细信息,则该窗口是 Xwayland
>
> - xeyes
>
> 安装并打开 `xeyes`,应该会打开一个窗口,上面有 “一双眼睛”。在 Xwayland 窗口中,它的视线会跟随鼠标(一直看向鼠标所在的位置);在原生 Wayland 窗口中,它保持不动
Comment on lines +39 to +41
> [!IMPORTANT]
>
> 如果是 Linux,请先查看 [Linux Wayland 兼容性](./wayland)。报告故障时附带桌面环境、发行版、所使用的安装包格式(官方包)或构建脚本(第三方包)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants