Skip to content

docs: 补充-clear 写法与 -concat 提示 #78

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Yunease wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: 补充-clear 写法与 -concat 提示 #78

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion src/script-reference/commands/say.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,10 @@ changeFigure:1/closed_eyes.png -next;
没眼看了！ -concat;
```

::: tip
如果在拼接文本前使用了 applyStyle 修改文本框文本的样式，如让文字变色，由于 outer 与 inner 作用于整个文本框的文本，因此无法通过这种方式单独更改个别文本的颜色，反而会因为样式的更新导致完整的拼接文本会重新播放一遍。
:::
Comment on lines +45 to +47
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot Feb 8, 2026

Choose a reason for hiding this comment

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

medium

这部分提示信息写得很好，清晰地指出了 applyStyle 和 -concat 同时使用时可能遇到的问题。
为了让它更易于理解，可以考虑稍作简化和调整。当前的句子较长，并且提到了 outer 和 inner，这可能对不熟悉内部实现的用户造成困惑。
建议修改为更直接的描述，强调 applyStyle 作用于整个文本框，并说明可能导致的后果。

Suggested change
::: tip
如果在拼接文本前使用了 applyStyle 修改文本框文本的样式，如让文字变色，由于 outer 与 inner 作用于整个文本框的文本，因此无法通过这种方式单独更改个别文本的颜色，反而会因为样式的更新导致完整的拼接文本会重新播放一遍。
:::
::: tip
请注意，`applyStyle` 会作用于整个文本框。因此，在拼接文本 (`-concat`) 时，无法通过 `applyStyle` 单独更改部分文本的颜色。这样做反而可能因样式更新，导致已拼接的文本重新播放。
:::


### speaker
- 字符串

Expand Down Expand Up @@ -71,7 +75,8 @@ WebGAL 支持说话者的简化写法。

```webgal
say:这是一句话。 -speaker=角色A;
say:这是一个旁白。 -clear;
say:这是一个旁白。 -clear; 没有值的情况默认关闭说话者栏
Copy link
Contributor

@gemini-code-assist gemini-code-assist bot Feb 8, 2026

Choose a reason for hiding this comment

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

medium

这里的注释“没有值的情况默认关闭说话者栏”中的“默认”一词可能稍有歧义。-clear 是一个布尔标志，它的出现即代表值为 true，并非一种“默认”行为。为了更精确地描述这种简写形式，建议将注释修改得更简洁、准确。

Suggested change
say:这是一个旁白。 -clear; 没有值的情况默认关闭说话者栏
say:这是一个旁白。 -clear; ; 等同于 -clear=true

say:这是一个旁白。 -clear=true;
say:这是一句话。 -speaker=角色B;
```

Expand Down