feat(docs): add bilingual package documentation site

2026-09-20 15:53:28 +08:00
parent 60f6f1fb1a
commit dc80bd8ae0
111 changed files with 6531 additions and 0 deletions
@@ -0,0 +1,44 @@
+---
+title: 定义 Action
+description: 在保留自动依赖收集能力的同时添加产品专属行为。
+order: 20
+toc:
+  - id: declare-the-action
+    title: 声明 Action
+  - id: custom-control
+    title: 自定义控件
+  - id: typed-values
+    title: 类型化参数
+---
+
+## 声明 Action {#declare-the-action}
+
+将命令与其编辑器依赖放在同一个定义中：
+
+```tsx
+const Mention = defineLexicalAction({
+  name: "mention",
+  label: "插入提及",
+  nodes: [MentionNode],
+  plugins: [MentionPopoverPlugin],
+  execute: ({ editor }) => openMentionPicker(editor),
+})
+```
+
+只要 `<Mention />` 出现在 `LexicalActions` 内，它需要的节点和插件就会自动启用。
+
+## 自定义控件 {#custom-control}
+
+```tsx
+<Mention>
+  {({ disabled, execute }) => (
+    <MentionButton disabled={disabled} onSelect={execute} />
+  )}
+</Mention>
+```
+
+替换可见控件不会改变依赖收集结果。
+
+## 类型化参数 {#typed-values}
+
+渲染上下文会公开带有 Action 参数类型的 `execute(value?)`。普通按钮可以使用无参数快捷方式 `onClick`。
@@ -0,0 +1,30 @@
+---
+title: 编辑器本地化
+description: 将内置标签和自定义 Actions 接入工作区国际化运行时。
+order: 21
+toc:
+  - id: add-the-catalog
+    title: 添加词典
+  - id: fallback
+    title: 回退行为
+  - id: custom-labels
+    title: 自定义标签
+---
+
+## 添加词典 {#add-the-catalog}
+
+```json
+{
+  "catalogSources": ["@workspace/lexical/locales/{locale}"]
+}
+```
+
+该包提供简体中文（`zh-Hans`）和美式英语（`en-US`）编辑器词典。
+
+## 回退行为 {#fallback}
+
+内置控件跟随当前 `@workspace/i18n` Provider。在 Provider 外部会回退为英文，使编辑器在独立预览和测试中仍可使用。
+
+## 自定义标签 {#custom-labels}
+
+外部 Action 标签可以是普通字符串，也可以是包含 `id` 和 `message` 的消息描述符。描述符会参与和应用文案相同的提取流程。