WordCraft 快速上手：13 个选项卡 + Alt+Q，一周学会 Word 级排版

【免费下载链接】wordcraftAn open-source, clean-room reimplementation of Microsoft Word in pure Rust项目地址: https://gitcode.com/gh_mirrors/word/wordcraft

WordCraft 是一款纯 Rust 开源文字处理器，对 Microsoft Word 工作流做了 clean-room 重实现，内置 13 个 Ribbon 选项卡、422 条命令。这份 WordCraft 新手指南带你走完第一周真正会碰到的操作：从启动、日常写作、快捷键与命令面板，到个性化定制。

30 秒运行示例文档

这一节帮你从零跑到看到第一页画面。

装好 Rust 后，克隆仓库并运行内置示例：

git clone https://gitcode.com/gh_mirrors/word/wordcraft cd wordcraft cargo run --release -p wordcraft -- --sample

--sample会打开示例文档 "The Open Studio Handbook"，由crates/engine/src/sample.rs（示例文档生成）在代码中生成。启动后你会看到四个区域：

• 快速访问工具栏（QAT）：窗口顶部，默认放保存、撤销、重做 3 个按钮
• Ribbon 选项卡：QAT 下方一排标签页，是所有功能的入口
• 文档画布：中央编辑区，带标尺、格式标记和实时样式预览
• 导航窗格：左侧列出文档标题大纲，点击直接跳转

💡 点左上角File进入 Backstage（后台视图），新建模板、最近文档、导出 PDF 都在这里。

写第一次正经文档：画布、Home 选项卡与导航窗格

这一节用"写半页笔记"的微场景，带你熟悉 WordCraft 入门必知的操作面。

13 个 Ribbon 选项卡在crates/engine/src/ribbon.rs（选项卡定义）中定义，与 Word 一一对应：

现在写半页笔记：点画布直接打字；选中几个字按Ctrl/⌘ + B加粗；段落套上 Home 选项卡的样式，整段格式一次到位。文档变长后，左侧导航窗格实时生成标题大纲，长文跳转不再滚动到眼花。选错格式按F8可逐层扩大选区（词到句到段），改起来更顺手。

少点击写作法：WordCraft 快捷键与 Alt+Q 命令面板

这一节把高频 WordCraft 快捷键和命令面板收进同一主题：降低每次操作的点击成本。

macOS 上 Ctrl 一律换成 ⌘，先记这张表：

界面级快捷键处理在crates/ui-egui/src/keys/shortcuts.rs（界面快捷键分发），文档层键位映射在crates/engine/src/keymap.rs（键位映射解析）。

一键调出 WordCraft 命令面板

找不到按钮时，用 Alt+Q 一句话执行任意命令：

1. 按Alt + Q，或点标题栏搜索框
2. 输入短语：insert table、export pdf、watermark
3. 列表实时过滤 422 条命令，按Enter直接执行
4. 没匹配到命令时，会提示"在文档中查找该词"，自动跳到导航窗格

面板实现在crates/ui-egui/src/dialogs/dispatch.rs（命令面板界面）。

💡 Ribbon 按钮、快捷键、CLI、MCP 服务共用同一套命令 ID。你在屏幕上学会的format.bold，在命令行里同样有效。

从模板到专业排版：Design、Layout、References 三连

这一节用"做一份简历 + 写一份带目录的报告"两个真实任务，串起三个排版选项卡。

做简历走这条路：

• File 后台视图选简历模板起步，版式不用自己从零搭
• Design 选项卡切换主题与样式集，DRAFT 水印一键加上
• Layout 选项卡调页边距、分栏，行号、首字下沉也归它管

写报告走这条路：正文一律套 Heading 1/2 样式，切到 References 选项卡插入目录，自动生成、随正文更新。脚注、交叉引用、四种学术引用格式都在这一个选项卡里。

成稿后从 File 后台视图导出：PDF、ODT、RTF、Markdown 都是直接选项。

让工具长到你的手上：Ribbon 定制与键位自定义

这一节把键位和 Ribbon 改成你自己的用法。

• 键位自定义：Customize Keyboard 对话框（crates/ui-egui/src/dialogs/dialogs_keyboard.rs，键盘自定义对话框）可为任意命令指定按键
• Ribbon 重排：Customize Ribbon 可隐藏内置选项卡、创建自定义选项卡和分组，把常用命令聚拢
• QAT 增删：快速访问工具栏默认 3 个命令，可换成你最高频的那几个
• 深色模式：View 选项卡一键切换，夜里写文档眼睛更舒服
• 多语言：界面支持 27 种语言，语言表注册在crates/ui-egui/src/i18n.rs（语言目录注册），默认跟随系统语言

🔧 以上布局与键位都存进偏好设置，重启后依然生效，随时可一键恢复默认。

下一步：用 wordcraft-cli 把文档处理搬进终端

第一周学完，自然的一步是把批量处理交给命令行：

wordcraft-cli run --file report.docx --cmd 'format.bold={}'

同一条命令 ID 还能通过wordcraft-cli mcp暴露给 AI 代理，脚本化批处理从此可行。

🚀 更完整的特性清单见 README.md，后续演进路线见 docs/roadmap.md。

【免费下载链接】wordcraftAn open-source, clean-room reimplementation of Microsoft Word in pure Rust项目地址: https://gitcode.com/gh_mirrors/word/wordcraft