collective
Browse / github.com/storytold/wordcraft / patch
docs: add extensible usage guides with an initial German translation
docs: add extensible usage guides with an initial German translation Everyday instructions are scattered across the README, parity documents and topic pages. This adds a language index and an English guide with German as the initial example translation at `docs/usage/usage.md` and `usage-de.md`, linked from the README, with core workflows, all 163 default command-keybinding entries and selected UI/context controls. The guides link to existing topic pages, identify the source revision checked, explain native/web and context differences, and explicitly list remaining handbook coverage. Clipboard documentation preserves the current behavior: Ctrl+Shift+C/V copies
- Status
- open
- Score
- 0.00
- Adopters
- 0 other operators
- Author
- LabDennis (imported from pull request #4543, open)
- Base
2cf1d6c7ae94723a45bd6e7e8c884fe375148750- Size
- +923 −3 in 8 files
- Review
- pending
- Shared
- 2026-10-28
- Id
90937c2a6aaafa3d9190aebf
How it went
No other operator has reported using it yet.
Diff
raw · AGENTS.md CLAUDE.md README.md ROADMAP.md docs/roadmap.md docs/usage/README.md docs/usage/usage-de.md docs/usage/usage.md
@@ -65,6 +65,27 @@ Typing, Enter, Backspace, Tab, lists, AutoCorrect and AutoFormat follow Word's o ## Roadmap Progress docs follow [`craftrules/standards/progress-docs.md`](https://github.com/storytold/craftrules/blob/main/standards/progress-docs.md): `ROADMAP.md` (stage, headline numbers, progress log), `docs/target-app-parity.md` (the assessment), `docs/gaps.md` (ranked work list), `docs/roadmap.md` (milestones, Current focus), `docs/architecture.md`, and the parity checklists `docs/file-format-parity.md`, `docs/layout-parity.md`, `docs/typing-parity.md`, `docs/ui-parity.md`, `docs/hardware-parity.md`, `docs/localization-parity.md`. When work lands, update the gap, the parity doc and the progress log, and bump each touched doc's status line and revision history. +## User documentation++The [English guide](docs/usage/usage.md) is the source text; the+[German guide](docs/usage/usage-de.md) is the initial example translation, not a limit on languages.+The [language index and translation guide](docs/usage/README.md) explains how to add more languages+as `docs/usage/usage-<language-code>.md`.++- When adding, changing or removing a user-facing feature or keyboard shortcut, update the+ English instructions and affected **existing translations in the same change**.+- Describe actual behavior: where to find the action, prerequisites, steps, expected result,+ keyboard context, platform differences and relevant limitations. Do not document planned+ features or proposed bindings as available.+- Reuse an existing canonical topic page instead of duplicating it. Keep translated guides,+ their coverage notes, the language index and README links aligned when adding or moving docs.+- Verify shortcuts against the command registry **and** the relevant UI/tool/context handlers;+ distinguish defaults from custom assignments and text-field/dialog input. Check relative links+ and anchors, and update the checked revision/date after re-verifying the relevant guide.+- New translations follow the English guide's structure and coverage. Retain findable UI labels,+ exact key combinations and limitations. List only existing translations, without placeholder files.+- If a change has no user-facing effect, state in the PR why no usage update is needed.+ ## Contributor credits (About window) - About ▸ Contributors/Models are compiled into the binary from `contributors/contributors.json`@@ -2,6 +2,13 @@ WordCraft is a clean-room, open-source, Rust-native word processor targeting Microsoft Word parity — and going further on speed, openness and agent control. It runs natively on macOS, Windows, Linux and BSD, and on the web via WASM. Siblings with the same conventions: `../photocraft` (Photoshop), `../vectorcraft` (Illustrator), `../filmcraft` (Premiere), `../lightcraft` (Lightroom), `../pdfcraft` (Acrobat), `../effectcraft` (After Effects), `../designcraft` (InDesign). Shared rules and learnings: [`storytold/craftrules`](https://github.com/storytold/craftrules) (`../../craftrules`) — read its `AGENTS.md`. +## User documentation++Follow the [user-documentation rule in AGENTS.md](AGENTS.md#user-documentation): update the+English usage guide and affected existing translations with user-facing feature and keyboard+changes. German is the initial example; the [language index](docs/usage/README.md) explains+how to add other languages.+ ## Start every session here 1. Read `plan/STATUS.md` (current milestone, next task), then the task in `plan/execution-plan.md` and the relevant `plan/architecture.md` section. `plan/` is gitignored (local only); if it's missing, start from `ROADMAP.md`, `docs/gaps.md` and `docs/roadmap.md` (Current focus). 2. Follow the autonomous operation protocol (`plan/execution-plan.md` §5). Don't stop to ask unless a decision is genuinely the owner's (licensing, publishing, pushing to new remotes, secrets).@@ -69,6 +69,8 @@ <a href="#license-and-credits">License and credits</a> </p> +**User guide and keyboard shortcuts:** [English](docs/usage/usage.md) · [Deutsch](docs/usage/usage-de.md) · [All languages / translate](docs/usage/README.md)+ ## A tour Every screenshot below is WordCraft itself, rendered offscreen by its own UI test harness@@ -4,7 +4,7 @@ **Stage: alpha** · next: beta, ~15 points (60% → 75% ready for real work) and ~150–230 h away -> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-25 · **Change:** trivial (progress log: Custom document properties dialog, #2982; previously trivial: progress log: View › New Window; previously trivial: progress log: interface translations come from storytold/craft-i18n through the `craft-i18n` crate; previously trivial: progress log: disabled-control reasons translated in every interface language, #2678; previously trivial: progress log: mail merge record navigation and record ranges for printing, #3028; previously trivial: selection bar for right-to-left paragraphs and table rows; previously trivial: group connector rerouting preserves rotated and flipped free or unresolved endpoints under nonuniform group scaling; readiness estimates unchanged; previously trivial: progress log: a word with no break opportunity in it no longer makes the layout quadratic, #3412; previously trivial: progress log: a relationship the markup names without the prefix is read as it wrote, and an ordinary `id` names no part; previously trivial: progress log: a document with many relationships opens in the time its part takes, and an id the text only mentions is not a reference, #3411; previously trivial: progress log: read only and comments-only protection grey out edits; previously trivial: progress log: an empty paragraph with a hidden mark shows nothing, not even its list number, #3982; previously trivial: progress log: "NaN" in the Font dialog's Size box no longer closes the app, #3663; previously trivial: progress log: a table cell span from a `.json` file no longer overflows, #3637; previously trivial: progress log: a click in the footer while editing the header moves there; previously trivial: explicit documents keep the editor when recovery discovery finishes; readable recovery controls; previously trivial: Slovenian interface catalog, 2,614 entries; previously trivial: Insert Table of Figures dialog for any caption label, #3013; previously trivial: progress log: Home › Underline drop-down, #2738; previously trivial: personal templates in File › New and Save as Word Template, #2852; previously trivial: progress log: the scrollbar page tip stays on one line, #3341; previously trivial: progress log: forms protection greys out the control buttons; previously trivial: progress log: a document with many content controls saves in the time the controls take, #13; previously trivial: progress log: Word signature lines kept on save; previously trivial: a Thai run with Latin finds one installed font covering it all on Linux too, #1549; previously trivial: progress log: closing the header returns to the body selection, #3331; previously trivial: progress log: saving to a NAS share mounted by GVFS, #3003; previously trivial: progress log: a picture dragged near the bottom of a page lands there, #3169; previously trivial: centred list labels after leading page breaks, #2964; previously trivial: progress log: inline pictures drag to an insertion cursor and stay inline, #2233, #2234; previously trivial: progress log: a text file saved over itself closes without asking, #2376; previously trivial: progress log: a text frame in the paragraph defaults frames nothing, #2360; previously trivial: fixed font inputs in four layout controls; previously trivial: typing no longer starts render threads on every repaint, #3027; previously trivial: a right, centre or decimal tab whose text doesn't fit, or a left tab past the right indent, goes to the next line with its text, #1840; previously trivial: progress log: banded rows shade as in Word, #3415; previously trivial: progress log: the table handles show while the caret is in the table, #2428; previously trivial: progress log: a click below a floating table reaches the text after it, #2038; previously trivial: progress log: Delete on selected table cells leaves one empty paragraph in each, #2802; previously trivial: progress log: lam-alef in exported PDFs extracts whole with fonts that draw it as two glyphs, #2310; previously trivial: Bullets and Numbering toggle off style-inherited lists at their effective level, including basedOn chains and numbered ListParagraph styles; other paragraphs and list definitions stay unchanged (related to #3459); previously trivial: Russian sorting keeps ё with е and recognises decomposed ё/й; previously trivial: progress log: a text box that keeps the keyboard no longer resets the input method every frame, #2986; previously trivial: progress log: recovery copies and .json files store pictures as base64, #586 follow-up; previously trivial: progress log: legacy menu keys, #1697; previously trivial: progress log: shape gradients and transparency, #1500; previously trivial: progress log: Focus fills the screen, and Full Screen View shows the pages alone, #1678; previously trivial: progress log: text above a float's anchor wraps around it, #2048; previously trivial: progress log: File › Recover follows the app theme, #3243; previously trivial: progress log: formatting toolbar with the text context menu, #2959; previously trivial: progress log: caret inside ligatures, #1974; previously trivial: text typed into a content control takes the control's formatting; localized placeholder styles recognised; previously trivial: forms protection keeps its content controls: no inserting, Properties or Remove Content Control; previously trivial: long navigation headings wrap onto further lines within the pane, #3015; previously trivial: clearing a no-match font query keeps the recent heading visible, #2068; previously trivial: a word after a slash wraps whole, like Word, #2963; previously trivial: progress log: a header-cell picture watermark sits behind the text, #1775; previously trivial: symbols keep their font when the text font changes, #2036; previously trivial: opening a DOCX no longer copies its pictures; previously trivial: Add Font imports every selected font file, #1789); previously trivial (RTF export writes sections (gap 19); previously trivial: ODT export writes sections (gap 19); previously trivial: Read Aloud speaks each sentence in its own language, #1843; previously trivial: hint-reliant CJK outlines; previously trivial: Ctrl+wheel zoom no longer scrolls the document, #1743; previously trivial: progress log: Turkish case mapping in AutoCorrect, #1923; previously trivial: a mouse drag on a table leaves the view where it is, #1738; previously trivial: progress log: Hebrew field results and smart quotes, #1670; previously trivial: Backspace removes a selected table, rows or columns, #1844; previously trivial: progress log: mixed Hebrew/Latin text keeps its order in Word, #1543; previously trivial: progress log: web typing in non-Latin text no longer repeats, #1480; previously trivial: progress log: font family caches bounded and math font lookups follow font changes, #1354; previously trivial: `-->` AutoCorrect replacement, #2223; previously trivial: numbered headings, #1793; previously trivial: Navigation Find exposes Results, #2096; previously trivial: progress log: Columns on selected text, #2024; previously trivial: progress log: legacy outline, shadow, emboss and imprint text effects drawn, #2534; previously trivial: progress log: Indonesian proofing, #498; previously trivial: progress log: DOCX glossary documents (building blocks); previously trivial: progress log: Read Mode keeps the keyboard and shows whole, unobscured columns, #1772); previously trivial: progress log: font list entries of tall-ascent fonts no longer cut off, #2570); previously trivial: progress log: Split Cells and Convert Text to Table dialogs follow the Word check, #2592; previously trivial: a new source's Tag is made like Word's, three letters of the author and two digits of the year with a number added when taken, and an edit keeps the Tag, #2094; previously trivial: Web Layout fills the window width, #1876; previously trivial: progress log: Different First Page headers reachable from page 1, #2826; previously trivial: Language dialog keeps inherited proofing language and no-proof choices (#2717); previously trivial: progress log: web preferences kept between visits, #2132; previously trivial: progress log: undrawable private-use list bullets show the level's default bullet, #1683; previously trivial: progress log: `w:eastAsianLayout` kept on save; previously trivial: table style editor formats every part, #714); previously trivial: VML freeforms read and kept on save; previously trivial: progress log: consistent preferred cell widths; previously trivial: multi-paragraph field instructions no longer add blank lines; previously trivial: page-break-only list paragraphs hide their labels; previously trivial: progress log: grouped `flowChartOr` shapes draw their circle and crossing spokes; previously trivial: progress log: copies keep their formatting in other programs, #1523; previously trivial: progress log: privacy options on save, #1062; previously trivial: progress log: equation pictures in theme colours on Windows, #1002; previously trivial: symbol fonts, #776; previously trivial: the save prompt answers from the keyboard, #861; previously trivial: table column and row markers on the rulers, #700; previously trivial: table borders and the resize handle drag on the page, #217; previously trivial: formatting revisions landed, #41; previously trivial: Draw tab ink, #307, and Draw Table and Eraser, #303, landed: catalog 402/434; previously minor: readiness table with hours per audience; full number back to the additive weighted sum, 60%; mainstream and essentials numbers added; alpha gate checked; previously major: full re-measure against Word for Mac 16.113.4; restructured to the craftrules progress-docs standard) · **Target:** Microsoft Word (Microsoft 365) for Mac 16.113.4+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-27 · **Change:** trivial (initial English/German user guide and shortcut reference; estimates unchanged); previous update: trivial (progress log: Custom document properties dialog, #2982; previously trivial: progress log: View › New Window; previously trivial: progress log: interface translations come from storytold/craft-i18n through the `craft-i18n` crate; previously trivial: progress log: disabled-control reasons translated in every interface language, #2678; previously trivial: progress log: mail merge record navigation and record ranges for printing, #3028; previously trivial: selection bar for right-to-left paragraphs and table rows; previously trivial: group connector rerouting preserves rotated and flipped free or unresolved endpoints under nonuniform group scaling; readiness estimates unchanged; previously trivial: progress log: a word with no break opportunity in it no longer makes the layout quadratic, #3412; previously trivial: progress log: a relationship the markup names without the prefix is read as it wrote, and an ordinary `id` names no part; previously trivial: progress log: a document with many relationships opens in the time its part takes, and an id the text only mentions is not a reference, #3411; previously trivial: progress log: read only and comments-only protection grey out edits; previously trivial: progress log: an empty paragraph with a hidden mark shows nothing, not even its list number, #3982; previously trivial: progress log: "NaN" in the Font dialog's Size box no longer closes the app, #3663; previously trivial: progress log: a table cell span from a `.json` file no longer overflows, #3637; previously trivial: progress log: a click in the footer while editing the header moves there; previously trivial: explicit documents keep the editor when recovery discovery finishes; readable recovery controls; previously trivial: Slovenian interface catalog, 2,614 entries; previously trivial: Insert Table of Figures dialog for any caption label, #3013; previously trivial: progress log: Home › Underline drop-down, #2738; previously trivial: personal templates in File › New and Save as Word Template, #2852; previously trivial: progress log: the scrollbar page tip stays on one line, #3341; previously trivial: progress log: forms protection greys out the control buttons; previously trivial: progress log: a document with many content controls saves in the time the controls take, #13; previously trivial: progress log: Word signature lines kept on save; previously trivial: a Thai run with Latin finds one installed font covering it all on Linux too, #1549; previously trivial: progress log: closing the header returns to the body selection, #3331; previously trivial: progress log: saving to a NAS share mounted by GVFS, #3003; previously trivial: progress log: a picture dragged near the bottom of a page lands there, #3169; previously trivial: centred list labels after leading page breaks, #2964; previously trivial: progress log: inline pictures drag to an insertion cursor and stay inline, #2233, #2234; previously trivial: progress log: a text file saved over itself closes without asking, #2376; previously trivial: progress log: a text frame in the paragraph defaults frames nothing, #2360; previously trivial: fixed font inputs in four layout controls; previously trivial: typing no longer starts render threads on every repaint, #3027; previously trivial: a right, centre or decimal tab whose text doesn't fit, or a left tab past the right indent, goes to the next line with its text, #1840; previously trivial: progress log: banded rows shade as in Word, #3415; previously trivial: progress log: the table handles show while the caret is in the table, #2428; previously trivial: progress log: a click below a floating table reaches the text after it, #2038; previously trivial: progress log: Delete on selected table cells leaves one empty paragraph in each, #2802; previously trivial: progress log: lam-alef in exported PDFs extracts whole with fonts that draw it as two glyphs, #2310; previously trivial: Bullets and Numbering toggle off style-inherited lists at their effective level, including basedOn chains and numbered ListParagraph styles; other paragraphs and list definitions stay unchanged (related to #3459); previously trivial: Russian sorting keeps ё with е and recognises decomposed ё/й; previously trivial: progress log: a text box that keeps the keyboard no longer resets the input method every frame, #2986; previously trivial: progress log: recovery copies and .json files store pictures as base64, #586 follow-up; previously trivial: progress log: legacy menu keys, #1697; previously trivial: progress log: shape gradients and transparency, #1500; previously trivial: progress log: Focus fills the screen, and Full Screen View shows the pages alone, #1678; previously trivial: progress log: text above a float's anchor wraps around it, #2048; previously trivial: progress log: File › Recover follows the app theme, #3243; previously trivial: progress log: formatting toolbar with the text context menu, #2959; previously trivial: progress log: caret inside ligatures, #1974; previously trivial: text typed into a content control takes the control's formatting; localized placeholder styles recognised; previously trivial: forms protection keeps its content controls: no inserting, Properties or Remove Content Control; previously trivial: long navigation headings wrap onto further lines within the pane, #3015; previously trivial: clearing a no-match font query keeps the recent heading visible, #2068; previously trivial: a word after a slash wraps whole, like Word, #2963; previously trivial: progress log: a header-cell picture watermark sits behind the text, #1775; previously trivial: symbols keep their font when the text font changes, #2036; previously trivial: opening a DOCX no longer copies its pictures; previously trivial: Add Font imports every selected font file, #1789); previously trivial (RTF export writes sections (gap 19); previously trivial: ODT export writes sections (gap 19); previously trivial: Read Aloud speaks each sentence in its own language, #1843; previously trivial: hint-reliant CJK outlines; previously trivial: Ctrl+wheel zoom no longer scrolls the document, #1743; previously trivial: progress log: Turkish case mapping in AutoCorrect, #1923; previously trivial: a mouse drag on a table leaves the view where it is, #1738; previously trivial: progress log: Hebrew field results and smart quotes, #1670; previously trivial: Backspace removes a selected table, rows or columns, #1844; previously trivial: progress log: mixed Hebrew/Latin text keeps its order in Word, #1543; previously trivial: progress log: web typing in non-Latin text no longer repeats, #1480; previously trivial: progress log: font family caches bounded and math font lookups follow font changes, #1354; previously trivial: `-->` AutoCorrect replacement, #2223; previously trivial: numbered headings, #1793; previously trivial: Navigation Find exposes Results, #2096; previously trivial: progress log: Columns on selected text, #2024; previously trivial: progress log: legacy outline, shadow, emboss and imprint text effects drawn, #2534; previously trivial: progress log: Indonesian proofing, #498; previously trivial: progress log: DOCX glossary documents (building blocks); previously trivial: progress log: Read Mode keeps the keyboard and shows whole, unobscured columns, #1772); previously trivial: progress log: font list entries of tall-ascent fonts no longer cut off, #2570); previously trivial: progress log: Split Cells and Convert Text to Table dialogs follow the Word check, #2592; previously trivial: a new source's Tag is made like Word's, three letters of the author and two digits of the year with a number added when taken, and an edit keeps the Tag, #2094; previously trivial: Web Layout fills the window width, #1876; previously trivial: progress log: Different First Page headers reachable from page 1, #2826; previously trivial: Language dialog keeps inherited proofing language and no-proof choices (#2717); previously trivial: progress log: web preferences kept between visits, #2132; previously trivial: progress log: undrawable private-use list bullets show the level's default bullet, #1683; previously trivial: progress log: `w:eastAsianLayout` kept on save; previously trivial: table style editor formats every part, #714); previously trivial: VML freeforms read and kept on save; previously trivial: progress log: consistent preferred cell widths; previously trivial: multi-paragraph field instructions no longer add blank lines; previously trivial: page-break-only list paragraphs hide their labels; previously trivial: progress log: grouped `flowChartOr` shapes draw their circle and crossing spokes; previously trivial: progress log: copies keep their formatting in other programs, #1523; previously trivial: progress log: privacy options on save, #1062; previously trivial: progress log: equation pictures in theme colours on Windows, #1002; previously trivial: symbol fonts, #776; previously trivial: the save prompt answers from the keyboard, #861; previously trivial: table column and row markers on the rulers, #700; previously trivial: table borders and the resize handle drag on the page, #217; previously trivial: formatting revisions landed, #41; previously trivial: Draw tab ink, #307, and Draw Table and Eraser, #303, landed: catalog 402/434; previously minor: readiness table with hours per audience; full number back to the additive weighted sum, 60%; mainstream and essentials numbers added; alpha gate checked; previously major: full re-measure against Word for Mac 16.113.4; restructured to the craftrules progress-docs standard) · **Target:** Microsoft Word (Microsoft 365) for Mac 16.113.4 > **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-18 · **Change:** trivial (English dialects in proofing, #1281; previously trivial: triple borders draw three lines, #1740; previously trivial: progress log: double-clicking a later page's footer no longer scrolls up, #2103; previously trivial: long navigation headings wrap onto further lines within the pane, #3015; previously trivial: clearing a no-match font query keeps the recent heading visible, #2068; previously trivial: a word after a slash wraps whole, like Word, #2963; previously trivial: RTF export writes sections (gap 19); previously trivial: ODT export writes sections (gap 19); previously trivial: progress log: pasted blockquotes are indented paragraphs, #1270; previously trivial: progress log: print-area strings translated in every catalog; previously trivial: progress log: comments readable in the dark theme, #2045; previously trivial: progress log: ODT sections, #1379; previously trivial: progress log: table deletes, Change Case and Unlink Fields respect Track Changes and locked content controls, #1329; previously trivial: progress log: rounded rectangle corners, #1476; previously trivial: progress log: Save As type list, #1399; previously trivial: progress log: privacy options on save, #1062; previously trivial: progress log: equation pictures in theme colours on Windows, #1002; previously trivial: symbol fonts, #776; previously trivial: the save prompt answers from the keyboard, #861; previously trivial: table column and row markers on the rulers, #700; previously trivial: table borders and the resize handle drag on the page, #217; previously trivial: formatting revisions landed, #41; previously trivial: Draw tab ink, #307, and Draw Table and Eraser, #303, landed: catalog 402/434; previously minor: readiness table with hours per audience; full number back to the additive weighted sum, 60%; mainstream and essentials numbers added; alpha gate checked; previously major: full re-measure against Word for Mac 16.113.4; restructured to the craftrules progress-docs standard) · **Target:** Microsoft Word (Microsoft 365) for Mac 16.113.4 > **Printing update:** 2026-10-12 · direct desktop printing through craft-print; details below. @@ -311,6 +311,7 @@ Imported Word 97–2003 `.doc`/`.dot` files now ask for a supported DOCX target | 2026-10-17 | Non-overlapping body floating tables clear header tables. Original native controls distinguish never-overlap from allowed overlap. | | 2026-10-14 | Comment text being typed is no longer lost or misplaced (#1348): an edit or reply the document refuses (for example read-only protection) keeps the typed text in its field and says why on the status line; drafts belong to their document, so after New or Open a comment with the same number shows its own text; Save, Export, Print, Close, New and Open write pending comment text first; if the document refuses it, Save, Export and Print carry on with the stored comments and show why on the status line (a refused draft is dropped when Save is the only change), while Close, New and Open show the Save Changes prompt (Don't Save drops text the document refuses); Escape discards what was typed; in a document protected as read only or for forms the comment fields can't be typed in | |---|---|+| 2026-10-27 | Initial [English](docs/usage/usage.md) / [German](docs/usage/usage-de.md) user guide, source-checked default shortcuts and agent maintenance rule; advanced coverage remains open. Readiness estimates unchanged. | | 2026-10-18 | Explicit New/Open keeps the requested document visible when startup recovery discovery finishes; older copies stay available. Recover uses the regular theme. See docs/recovery.md. | | 2026-10-15 | A floating picture or shape in a table cell set to align centre or bottom no longer lands half its height above its line (#1887); it starts at the anchor line | | 2026-10-18 | Picture Format › Size (#2573): width and height in the interface unit, and a size typed in any unit works, pixels too (`300 px` keeps the picture's proportions, #1901), applied once typed (Enter, Tab or a click elsewhere; Esc cancels) in one undo step. The group's launcher opens a Size dialog: height and width, scale of the original size (or of the size it opened with), Lock aspect ratio, the original size with its pixels, and Reset. `picture.size {"original": true, "scale"?}` sizes from the original; sizes past 4000 pt that keep the proportions shrink as a whole. |@@ -643,6 +644,7 @@ Footer page-table height and body wrapping are corrected. Other pagination gaps | Date | Change | Summary | |---|---|---|+| 2026-10-27 | trivial | Initial bilingual user guide and default shortcut reference; documentation maintenance rule added; readiness estimates unchanged | | 2026-10-22 | trivial | Progress log: one native window per open document | | 2026-10-22 | trivial | Progress log: every open document keeps its own recovery copy | | 2026-10-22 | trivial | Progress log: several open documents in the desktop window |@@ -1,6 +1,6 @@ # WordCraft roadmap: milestones and what's next -> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-25 · **Change:** trivial (egui 0.37 migration: 27 interface languages remain pinned by `craft-i18n.rev` (9205108…), and the input-method handling has synthetic regressions while managed CI passed and native acceptance (#155–#164) remains open; previously trivial: M6: Manage Sources imports Word's `Sources.xml`, #2640; previously minor: Czech proofing review fixes; previously minor: Portuguese proofing; previously minor: Polish interface and Polish proofing; previously trivial: M7: formatting revisions landed, #41; previously trivial: M5: Draw Table and Eraser landed, #303; previously minor: beta distance restated: ~15 points, ~150–230 h; previously: alpha gate checked: six core workflows pass; previously major: milestones moved here from ROADMAP.md; Current focus set from the re-measured gaps) · **Target:** Microsoft Word (Microsoft 365) for Mac 16.113.4+> **Last reviewed:** 2026-10-10 · **Last updated:** 2026-10-27 · **Change:** trivial (initial English/German user guide and shortcut reference; estimates unchanged); previous update: trivial (egui 0.37 migration: 27 interface languages remain pinned by `craft-i18n.rev` (9205108…), and the input-method handling has synthetic regressions while managed CI passed and native acceptance (#155–#164) remains open; previously trivial: M6: Manage Sources imports Word's `Sources.xml`, #2640; previously minor: Czech proofing review fixes; previously minor: Portuguese proofing; previously minor: Polish interface and Polish proofing; previously trivial: M7: formatting revisions landed, #41; previously trivial: M5: Draw Table and Eraser landed, #303; previously minor: beta distance restated: ~15 points, ~150–230 h; previously: alpha gate checked: six core workflows pass; previously major: milestones moved here from ROADMAP.md; Current focus set from the re-measured gaps) · **Target:** Microsoft Word (Microsoft 365) for Mac 16.113.4 Forward-looking plan. The summary is [`ROADMAP.md`](../ROADMAP.md); the ranked work list is [`gaps.md`](gaps.md); the numbers are in [`target-app-parity.md`](target-app-parity.md). Hours are@@ -61,7 +61,7 @@ partial rows are fidelity gaps (beta work), not broken workflows. WordCraft stay | M11 | Draw and objects | text wrap, text boxes, canvas handles, rotation (#332), ink pens and eraser (#307), contour wrap (#354), lasso, Add Pen, Ink to Shape and Ink Replay (#395) done; Ink to Math, grouping missing | 35–55 h | | M12 | Formats breadth (PDF, ODT, RTF, HTML, MD, TXT, LaTeX, `.doc` import) | done (first versions); `.doc` write, encryption, minor formats missing | 60–100 h | | M13 | Performance budgets | on track (1.4 ms relayout); large real-world documents unmeasured | 10–20 h |-| M14 | 1.0 polish, packaging, signing | releases v0.1.0–v0.4.0 published (signed macOS, Windows MSI x64/x86/arm64, Linux, FreeBSD, web) | — |+| M14 | 1.0 polish, packaging, signing | releases v0.1.0–v0.4.0 published (signed macOS, Windows MSI x64/x86/arm64, Linux, FreeBSD, web) Initial [English/German user guide](usage/usage.md) and default shortcut inventory added; advanced handbook coverage remains open. | — | | M15 | Localization (12 key languages, RTL interface, proofing languages) | 27 UI languages from the shared catalogs pinned by `craft-i18n.rev` (`9205108c…`); proofing: English, Polish, Portuguese, Italian, Croatian, Turkish, Russian, Czech, Indonesian and Spanish, plus Bulgarian and German hyphenation only; native-speaker review and native IME acceptance (#155–#164) remain open | 70–115 h | | M16 | Right-to-left and East Asian typography | RTL paragraphs done (#207) | 30–45 h | @@ -74,6 +74,7 @@ languages, screen-reader access, ecosystem decisions (VBA, add-ins, cloud), an i | Date | Change | Summary | |---|---|---|+| 2026-10-27 | trivial | Initial bilingual user guide and default shortcut reference; documentation maintenance rule added; readiness estimates unchanged | | 2026-10-25 | trivial | egui 0.37 migration: 27 interface languages remain pinned by `craft-i18n.rev` (9205108…); input-method surrounding-delete and commit handling has synthetic regressions only, with managed CI passing; native acceptance (#155–#164) and native-speaker review remain open | | 2026-10-18 | trivial | M6: Manage Sources imports Word's `Sources.xml` (#2640) | | 2026-10-12 | minor | Czech proofing review: short-word splits rank after deletion, NOSUGGEST excludes suggestions while accepting typed forms, affix comments apply only to headers, ratios keep spaces and repeated-word messages use Czech quotes; synthetic engine end-to-end and latency checks |new file mode 100644@@ -0,0 +1,29 @@+# WordCraft usage guides and translations++The English guide is the source text for this handbook. German is the first example translation;+other languages are welcome. Documentation language is separate from the app's interface language.++| Language | Guide | Coverage |+|---|---|---|+| English | [User guide](usage.md) | Initial workflows and shortcut reference; remaining coverage is listed in the guide |+| Deutsch | [Bedienungsanleitung](usage-de.md) | Erste Beispielübersetzung mit demselben Umfang; offene Themen stehen in der Anleitung |++## Add another language++1. Start from [usage.md](usage.md) and create `usage-<language-code>.md` in this folder.+ For example, French would use `usage-fr.md` and Brazilian Portuguese `usage-pt-BR.md`.+ These are naming examples, not translations that already exist.+2. Translate the guide's explanations and contents links. Keep matching topic coverage, examples,+ shortcut values, contexts and limitations. Retain the exact English UI labels where useful+ for locating commands, with an explanation in the target language.+3. Link to existing detailed topic pages instead of duplicating them. Say when those linked+ pages are in another language. Check relative links and the translated heading anchors.+4. Include a link back to this index and to the English guide. Add the completed guide to the+ table above; the project README links here so every language remains discoverable.+5. Review the translation for meaning and verify shortcut/platform claims against the implementation.+ Record the source revision/date checked in the guide. Do not imply a platform was tested+ merely because its keys were translated.++Keep the English guide and affected existing translations current when behavior changes, as+required by [AGENTS.md](../../AGENTS.md#user-documentation). Add languages when their guide is+available; do not create empty files or list planned translations as complete.new file mode 100644@@ -0,0 +1,433 @@+# WordCraft – Bedienungsanleitung++[English](usage.md) · [Alle Sprachen / Übersetzen](README.md) · [Projekt-README](../../README.md)++Englisch ist die Ausgangsfassung; Deutsch dient als erste Beispielübersetzung. Weitere Sprachen+sind nach demselben Aufbau willkommen (siehe Sprachindex).++Diese Anleitung bündelt alltägliche Abläufe und Tastenkürzel. Englische Befehlsnamen bleiben zur+Orientierung im Menüband und in der Befehlssuche erhalten; die Oberfläche kann sie übersetzen.+Abgeglichen mit Quellstand [2cf1d6c](https://github.com/storytold/wordcraft/tree/2cf1d6c7ae94723a45bd6e7e8c884fe375148750)+am 27.10.2026. Eine heruntergeladene Version kann davon abweichen.++## Inhalt++- [Starten, speichern und exportieren](#starten-speichern-und-exportieren)+- [Schreiben, auswählen, kopieren und einfügen](#schreiben-auswählen-kopieren-und-einfügen)+- [Dokument formatieren und strukturieren](#dokument-formatieren-und-strukturieren)+- [Überprüfen, Verweise und Seriendruck](#überprüfen-verweise-und-seriendruck)+- [Einstellungen und eigene Tastenkürzel](#einstellungen-und-eigene-tastenkürzel)+- [Tastenkürzelreferenz](#tastenkürzelreferenz)+- [Kontextabhängige Bedienung](#kontextabhängige-bedienung)+- [Weitere Hilfe und Abdeckung](#weitere-hilfe-und-abdeckung)++## Starten, speichern und exportieren++1. Unter **File › New** ein leeres Dokument oder eine Vorlage wählen; mit **File › Open** eine+ vorhandene Datei öffnen.+2. Im Dokument schreiben. Unter **File › Save As** Namen, Speicherort und Format festlegen;+ weitere Änderungen mit **Save** speichern. Um die Eingabedatei zu behalten, einen neuen Namen wählen.+3. **File › Export › Export PDF** erstellt eine PDF-Kopie. **File › Print** öffnet die+ Druckeinstellungen. Mit **Print Markup** festlegen, ob Kommentare und nachverfolgte Änderungen+ in der Ausgabe erscheinen.++WordCraft liest und schreibt unter anderem DOCX, ODT, RTF, HTML, Markdown und Text;+das ältere DOC wird importiert. Eine Konvertierung kann Inhalt oder Layout verändern: Vor einem+Formatwechsel die [Formatreferenz](../file-format-parity.md) beachten und die gespeicherte bzw.+exportierte Datei prüfen. Installation und Build bleiben im [README](../../README.md) dokumentiert.+Bei unterbrochener Arbeit hilft die [Wiederherstellungsanleitung](../recovery.md).++## Schreiben, auswählen, kopieren und einfügen++Ein Klick setzt die Einfügemarke, Ziehen markiert Text. **Shift** beim Bewegen der Einfügemarke+erweitert die Auswahl. **Enter** beginnt einen Absatz, **Shift+Enter** fügt einen Zeilenumbruch ein.+In Listen setzt Enter die Liste fort und Tab ändert die Ebene; in Tabellen bewegt Tab zwischen+Zellen. Die [Dokumentation zum Schreibverhalten](../typing-parity.md) beschreibt Details und Ausnahmen.++Text markieren und **Home › Clipboard › Copy** oder **Cut** wählen, dann am Ziel die Einfügemarke+setzen und **Paste** ausführen. Normales Einfügen nutzt vorhandene Zwischenablageformatierung;+das Ergebnis hängt von den Formaten der Quellanwendung ab. **Paste: Keep Text Only** fügt reinen+Text ein, **Paste Special** bietet die verfügbaren Zwischenablageformate an.++Die Standardbelegung unterscheidet **Textinhalt** und **Formatierung**:++| Aktion | Windows / Linux / BSD | macOS |+|---|---|---|+| Inhalt kopieren | Ctrl+C / Ctrl+Insert | Cmd+C / Cmd+Insert |+| Inhalt einfügen | Ctrl+V / Shift+Insert | Cmd+V / Shift+Insert |+| Nur Text einfügen | Ctrl+Shift+Alt+V | Cmd+Shift+Alt+V |+| Formatierung kopieren | Ctrl+Shift+C | Cmd+Shift+C |+| Formatierung übertragen | Ctrl+Shift+V | Cmd+Shift+V |+| Inhalte einfügen (Paste Special) | Ctrl+Alt+V | Cmd+Alt+V |++**Copy Formatting / Paste Formatting** übertragen die Formatierung der Quellauswahl auf das Ziel;+sie kopieren oder fügen keinen reinen Text ein. Im geprüften Befehlsverzeichnis gibt es weder ein+Standardkürzel für unformatiertes Kopieren noch für Ctrl+Alt+Insert oder Shift+Alt+Insert.++Unter **Home › Editing › Find** suchen, mit **Find and Replace** Treffer ersetzen und mit **Go To**+navigieren. **Undo** macht eine Bearbeitung rückgängig, **Redo** stellt sie wieder her.+**Repeat** führt die letzte wiederholbare Aktion erneut aus und ist eine andere Funktion als Redo.++## Dokument formatieren und strukturieren++Vorher Text markieren oder die Einfügemarke in den gewünschten Absatz setzen.++| Aufgabe | Wo und wie | Ergebnis / Kontext |+|---|---|---|+| Zeichen gestalten | **Home › Font**: Schriftart, Größe, Hervorhebung, Farbe wählen | Formatiert die Auswahl oder anschließend eingegebenen Text |+| Absätze gestalten | **Home › Paragraph**: Ausrichtung, Abstände, Einzüge oder Liste wählen | Ändert die ausgewählten Absätze |+| Einheitliche Überschriften | Unter **Home › Styles** Normal oder eine Heading-Vorlage anwenden | Überschriften strukturieren das Dokument; Vorlagen im Styles-Bereich verwalten |+| Seiten einrichten | Unter **Layout** Ränder, Ausrichtung, Papiergröße, Spalten und Umbrüche einstellen | Ändert Seiten-/Abschnittslayout; Einschränkungen stehen in der [Layoutreferenz](../layout-parity.md) |+| Tabelle einfügen | **Insert › Table**, Abmessungen wählen und Zellen bearbeiten | Tabellenbefehle wirken auf die aktuelle Tabelle/Zellauswahl; Tab wechselt Zellen |+| Bilder, Formen oder Diagramme | Passenden **Insert**-Befehl wählen und das eingefügte Objekt auswählen | Kontextsteuerung für Größe, Position und Textumbruch verwenden |+| Link oder Textmarke | **Insert › Links**: Text wählen, Link oder Bookmark öffnen und Ziel/Namen eingeben | Erstellt einen navigierbaren Verweis |+| Kopf-/Fußzeilen und Felder | Unter **Insert** die Kopf-/Fußzeilenbefehle bzw. **Text › Quick Parts** verwenden | Felder lassen sich aktualisieren; Kopf-/Fußzeilen gehören zu Abschnitten |+| Ansicht wechseln | Unter **View** Print Layout, Draft, Outline, Read Mode oder geteilte Ansicht wählen | Ändert die Arbeitsansicht, nicht die gespeicherte Seitengröße |++## Überprüfen, Verweise und Seriendruck++- **Review:** **Track Changes** vor den zu protokollierenden Bearbeitungen einschalten. Für einen+ Kommentar Text markieren und **New Comment** wählen. Mit den Prüfwerkzeugen Änderungen annehmen+ oder ablehnen und zwischen Kommentaren wechseln. Ausblenden von Markierungen nimmt Änderungen+ nicht an. **Spelling & Grammar** prüft die Sprache; die [Wörterbuchanleitung](../spelling-dictionaries.md)+ erklärt Installation und Auswahl.+- **References:** Vor dem Inhaltsverzeichnis Überschriftenvorlagen anwenden. **Insert Footnote**+ oder **Insert Endnote** an der gewünschten Verweisposition wählen. Felder nach Dokumentänderungen+ aktualisieren. Zitate, Literaturverzeichnis, Beschriftungen und Indexeinträge liegen unter+ **References**; für [Zotero](../zotero.md) gibt es eine eigene Einrichtungs- und Bedienungsanleitung.+- **Mailings:** Empfänger auswählen, Seriendruckfelder ins Dokument einfügen und **Preview Results**+ prüfen. Danach **Finish & Merge** oder **Print Documents** verwenden. Datensätze in der Vorschau+ prüfen, bevor die Ausgabe erstellt wird. Eine konfigurierte Empfängerquelle ist erforderlich.++## Einstellungen und eigene Tastenkürzel++Anwendungseinstellungen liegen unter **File › Options**. Die Tastenkürzel stehen unter+**Tools › Customize Keyboard** oder **File › Options › Keyboard shortcuts**:++1. Kategorie und Befehl auswählen oder den Dialogfilter verwenden.+2. Aktuelle Belegungen prüfen. **New shortcut** fokussieren und die gewünschte Kombination drücken.+3. Angezeigte Zuordnung prüfen und mit **Assign** zuweisen. Eine vorhandene Belegung mit **Remove**+ entfernen. **Reset All** stellt nach einer Bestätigung die Standardbelegung wieder her.++Die Belegungen werden in den Einstellungen gespeichert. Der Dialog akzeptiert Kombinationen mit+Modifikatortasten oder Funktionstasten statt unmodifizierter Buchstabentasten. Eigene Zuordnungen+und entfernte Belegungen können von den Tabellen abweichen.+Unter Windows/Linux/BSD klappt **Ctrl+F1** das Menüband ein/aus, sofern kein anderer Befehl zugewiesen+wurde; unter macOS gilt **Cmd+Alt+R**. **Alt+Q** öffnet auf Nicht-macOS-Builds die Befehlssuche.++## Tastenkürzelreferenz++Aufgeführt sind die **163 Befehle mit Standardkürzeln** des geprüften Engine-Verzeichnisses,+nach Bereichen sortiert; anschließend folgen Oberflächen- und Kontextsteuerungen. Befehle ohne+Standardkürzel sind, soweit unterstützt, über Oberfläche oder Befehlssuche erreichbar. Dies ist+ein Quellcodeabgleich, keine Bestätigung eines praktischen Tests jeder Kombination auf jeder Plattform.++- **Ctrl** heißt auf deutschen Tastaturen **Strg**, **Shift** bedeutet **Umschalt**,+ **Insert** bedeutet **Einfg**, **Delete** bedeutet **Entf**, **Home/End** bedeutet **Pos1/Ende**,+ **PageUp/PageDown** bedeutet **Bild auf/ab**, **Space** bedeutet **Leertaste**.+ **Cmd** ist Command (⌘), **Alt** auf macOS Option (⌥). Der Schrägstrich trennt Alternativen;+ **—** bedeutet keine Standardbelegung auf dieser Plattform.+- Die Plattformspalten gelten für native Builds. Der Web-Build nutzt die Nicht-macOS-Standardbelegungen+ des Verzeichnisses; seine primäre Modifikatortaste folgt der Browserplattform. Browser oder+ Betriebssystem können Kürzel vorher abfangen. Funktionstasten benötigen je nach Tastatur **Fn**.+- Für Bearbeitung und Navigation ins Dokument klicken. Ein fokussiertes Textfeld oder ein Dialog+ verarbeitet seine eigenen Eingaben. Gliederungs-, Feld-, Tabellen-, Prüf- und Seriendruckbefehle+ benötigen ihren jeweiligen Kontext. Ein Kürzel aktiviert keinen deaktivierten Befehl.+- Zeichenbezeichnungen entsprechen den registrierten Tasten; Satzzeichen liegen je nach Tastaturlayout+ an anderen Stellen. Die englischen Befehlsnamen werden um deutsche Erläuterungen ergänzt.++### Dateien++Quelle: [file](../../crates/engine/src/cmd/file.rs).++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| New — Neues Dokument | `Ctrl+N` | `Cmd+N` |+| Open — Öffnen | `Ctrl+O / Ctrl+F12 / Ctrl+Alt+F2` | `Cmd+O / Cmd+F12 / Cmd+Alt+F2` |+| Save — Speichern | `Ctrl+S / Shift+F12 / Alt+Shift+F2` | `Cmd+S / Shift+F12 / Alt+Shift+F2` |+| Save As — Speichern unter | `F12 / Alt+F2` | `F12 / Cmd+Shift+S` |+| Print — Drucken | `Ctrl+P / Ctrl+Shift+F12 / Ctrl+F2 / Ctrl+Alt+I` | `Cmd+P / Cmd+Shift+F12 / Cmd+F2 / Cmd+Alt+I` |+| Close — Schließen | `Ctrl+W / Ctrl+F4` | `Cmd+W / Cmd+F4` |++### Schreiben und Sonderzeichen++Quelle: [text](../../crates/engine/src/cmd/text.rs).++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| New Paragraph — Neuer Absatz | `Enter` | `Enter` |+| Line Break — Zeilenumbruch | `Shift+Enter` | `Shift+Enter` |+| Page Break — Seitenumbruch | `Ctrl+Enter` | `Cmd+Enter` |+| Column Break — Spaltenumbruch | `Ctrl+Shift+Enter` | `Cmd+Shift+Enter` |+| Tab — Tabulator bzw. nächster Listeneinzug/Tabellenzelle | `Tab` | `Tab` |+| Shift+Tab — Einzug zurück bzw. vorherige Tabellenzelle | `Shift+Tab` | `Shift+Tab` |+| Tab Character — Tabulatorzeichen einfügen | `Ctrl+Tab` | `Alt+Tab` |+| Backspace — Rückwärts löschen | `Backspace` | `Backspace` |+| Delete — Vorwärts löschen | `Delete` | `Delete` |+| Delete Previous Word — Vorheriges Wort löschen | `Ctrl+Backspace / Alt+Backspace` | `Cmd+Backspace / Alt+Backspace` |+| Delete Next Word — Nächstes Wort löschen | `Ctrl+Delete / Alt+Delete` | `Cmd+Delete / Alt+Delete` |+| Nonbreaking Space — Geschütztes Leerzeichen | `Ctrl+Shift+Space` | `Cmd+Shift+Space` |+| Nonbreaking Hyphen — Geschützter Bindestrich | `Ctrl+Shift+-` | `Cmd+Shift+-` |+| Optional Hyphen — Bedingter Trennstrich | `Ctrl+-` | `Cmd+-` |+| Toggle Unicode Character — Unicode-Code und Zeichen umwandeln | `Alt+X` | — |+| Em Dash — Geviertstrich | `Ctrl+Alt+-` | `Cmd+Alt+-` |+| Copyright Sign — Copyright-Zeichen | `Ctrl+Alt+C` | — |+| Registered Sign — Zeichen für eingetragene Marke | `Ctrl+Alt+R` | — |+| Trademark Sign — Markenzeichen | `Ctrl+Alt+T` | — |+| Ellipsis — Auslassungszeichen | `Ctrl+Alt+.` | — |++### Navigation und Auswahl++Quelle: [caret](../../crates/engine/src/cmd/caret.rs), [column](../../crates/engine/src/cmd/column.rs).++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| Column Selection — Spaltenauswahl | `Ctrl+Shift+F8` | `Cmd+Shift+F8` |+| Left — Nach links | `Left` | `Left` |+| Right — Nach rechts | `Right` | `Right` |+| Up — Nach oben | `Up` | `Up` |+| Down — Nach unten | `Down` | `Down` |+| Word Left — Wort nach links | `Ctrl+Left / Alt+Left` | `Alt+Left` |+| Word Right — Wort nach rechts | `Ctrl+Right / Alt+Right` | `Alt+Right` |+| Line Start — Zeilenanfang | `Home` | `Home / Cmd+Left` |+| Line End — Zeilenende | `End` | `End / Cmd+Right` |+| Paragraph Up — Absatz nach oben | `Ctrl+Up / Alt+Up` | `Cmd+Up / Alt+Up` |+| Paragraph Down — Absatz nach unten | `Ctrl+Down / Alt+Down` | `Cmd+Down / Alt+Down` |+| Document Start — Dokumentanfang | `Ctrl+Home` | `Cmd+Home` |+| Document End — Dokumentende | `Ctrl+End` | `Cmd+End` |+| Page Up — Seite nach oben | `PageUp` | `PageUp` |+| Page Down — Seite nach unten | `PageDown` | `PageDown` |+| Select All — Alles auswählen | `Ctrl+A` | `Cmd+A` |+| Collapse Selection — Auswahl aufheben | `Escape` | `Escape` |++### Bearbeitung und Zwischenablage++Quelle: [edit](../../crates/engine/src/cmd/edit.rs), [paste](../../crates/engine/src/cmd/paste.rs).++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| Undo — Rückgängig | `Ctrl+Z` | `Cmd+Z` |+| Redo — Wiederherstellen | `Ctrl+Y / Ctrl+Shift+Z` | `Cmd+Y / Cmd+Shift+Z` |+| Cut — Ausschneiden | `Ctrl+X` | `Cmd+X` |+| Copy — Kopieren | `Ctrl+C / Ctrl+Insert` | `Cmd+C / Cmd+Insert` |+| Spike — Auswahl ausschneiden und in der Sammlung ablegen | `Ctrl+F3` | `Cmd+F3` |+| Insert Spike — Gesammelte Ausschnitte einfügen | `Ctrl+Shift+F3` | `Cmd+Shift+F3` |+| Paste — Einfügen | `Ctrl+V / Shift+Insert` | `Cmd+V / Shift+Insert` |+| Paste: Keep Text Only — Nur Text einfügen | `Ctrl+Shift+Alt+V` | `Cmd+Shift+Alt+V` |+| Find — Suchen | `Ctrl+F` | `Cmd+F` |+| Find Next — Nächster Treffer | `Ctrl+G / F3 / Shift+F4 / Ctrl+PageDown` | `Cmd+G / F3 / Shift+F4 / Cmd+PageDown` |+| Find Previous — Vorheriger Treffer | `Ctrl+PageUp` | `Cmd+Shift+G / Cmd+PageUp` |+| Find and Replace — Suchen und Ersetzen | `Ctrl+H` | `Cmd+H / Ctrl+H` |+| Go To — Gehe zu | `Ctrl+Alt+G / F5` | `Cmd+Alt+G / F5` |+| Go Back — Zur letzten Bearbeitungsstelle zurück | `Shift+F5 / Ctrl+Alt+Z` | `Shift+F5 / Cmd+Alt+Z` |+| Copy Formatting — Formatierung kopieren | `Ctrl+Shift+C` | `Cmd+Shift+C` |+| Paste Formatting — Formatierung übertragen | `Ctrl+Shift+V` | `Cmd+Shift+V` |+| Paste Special — Inhalte einfügen | `Ctrl+Alt+V` | `Cmd+Alt+V` |++### Zeichenformatierung++Quelle: [format](../../crates/engine/src/cmd/format.rs).++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| Bold — Fett | `Ctrl+B` | `Cmd+B` |+| Italic — Kursiv | `Ctrl+I` | `Cmd+I` |+| Underline — Unterstreichen | `Ctrl+U` | `Cmd+U` |+| Double Underline — Doppelt unterstreichen | `Ctrl+Shift+D` | `Cmd+Shift+D` |+| Underline Words Only — Nur Wörter unterstreichen | `Ctrl+Shift+W` | `Cmd+Shift+W` |+| Strikethrough — Durchstreichen | `Ctrl+Shift+X` | `Cmd+Shift+X` |+| Subscript — Tiefstellen | `Ctrl+=` | `Cmd+=` |+| Superscript — Hochstellen | `Ctrl+Shift+=` | `Cmd+Shift+=` |+| All Caps — Großbuchstaben | `Ctrl+Shift+A` | `Cmd+Shift+A` |+| Small Caps — Kapitälchen | `Ctrl+Shift+K` | `Cmd+Shift+K` |+| Hidden — Ausgeblendeter Text | `Ctrl+Shift+H` | `Cmd+Shift+H` |+| Font — Schriftart | `Ctrl+Shift+F` | `Cmd+Shift+F` |+| Font Size — Schriftgröße | `Ctrl+Shift+P` | `Cmd+Shift+P` |+| Increase Font Size — Schrift vergrößern | `Ctrl+Shift+. / Ctrl+Shift+>` | `Cmd+Shift+. / Cmd+Shift+>` |+| Decrease Font Size — Schrift verkleinern | `Ctrl+Shift+, / Ctrl+Shift+<` | `Cmd+Shift+, / Cmd+Shift+<` |+| Grow Font 1 Point — Schrift um einen Punkt vergrößern | `Ctrl+]` | `Cmd+]` |+| Shrink Font 1 Point — Schrift um einen Punkt verkleinern | `Ctrl+[` | `Cmd+[` |+| Text Highlight Color — Text hervorheben | `Ctrl+Alt+H` | — |+| Change Case — Groß-/Kleinschreibung ändern | `Shift+F3` | `Shift+F3` |+| Reset Character Formatting — Zeichenformatierung zurücksetzen | `Ctrl+Space` | `Ctrl+Space` |+| Font Dialog — Schriftartdialog | `Ctrl+D` | `Cmd+D` |++### Absätze und Formatvorlagen++Quelle: [para](../../crates/engine/src/cmd/para.rs), [inspector](../../crates/engine/src/cmd/inspector.rs).++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| Style Inspector — Formatvorlagen prüfen | `Shift+F1` | `Shift+F1` |+| Align Left — Linksbündig | `Ctrl+L` | `Cmd+L` |+| Center — Zentriert | `Ctrl+E` | `Cmd+E` |+| Align Right — Rechtsbündig | `Ctrl+R` | `Cmd+R` |+| Justify — Blocksatz | `Ctrl+J` | `Cmd+J` |+| Distributed — Verteilte Ausrichtung | `Ctrl+Shift+J` | `Cmd+Shift+J` |+| Increase Indent — Einzug vergrößern | `Ctrl+M` | `Cmd+M` |+| Decrease Indent — Einzug verkleinern | `Ctrl+Shift+M` | `Cmd+Shift+M` |+| Hanging Indent — Hängenden Einzug vergrößern | `Ctrl+T` | `Cmd+T` |+| Reduce Hanging Indent — Hängenden Einzug verkleinern | `Ctrl+Shift+T` | `Cmd+Shift+T` |+| Single Spacing — Einfacher Zeilenabstand | `Ctrl+1` | `Cmd+1` |+| Double Spacing — Doppelter Zeilenabstand | `Ctrl+2` | `Cmd+2` |+| 1.5 Line Spacing — 1,5-facher Zeilenabstand | `Ctrl+5` | `Cmd+5` |+| Add Space Before Paragraph — Abstand vor Absatz umschalten | `Ctrl+0` | `Cmd+0` |+| Reset Paragraph Formatting — Absatzformatierung zurücksetzen | `Ctrl+Q` | `Ctrl+Q` |+| Normal Style — Standardformatvorlage | `Ctrl+Shift+N` | `Cmd+Shift+N` |+| Heading 1 — Überschrift 1 | `Ctrl+Alt+1` | `Cmd+Alt+1` |+| Heading 2 — Überschrift 2 | `Ctrl+Alt+2` | `Cmd+Alt+2` |+| Heading 3 — Überschrift 3 | `Ctrl+Alt+3` | `Cmd+Alt+3` |+| Bullets — Aufzählung | `Ctrl+Shift+L` | `Cmd+Shift+L` |+| Move Paragraph Up — Absatz nach oben verschieben | `Alt+Shift+Up` | `Ctrl+Shift+Up` |+| Move Paragraph Down — Absatz nach unten verschieben | `Alt+Shift+Down` | `Ctrl+Shift+Down` |+| Promote — Ebene höher | `Alt+Shift+Left` | `Ctrl+Shift+Left` |+| Demote — Ebene tiefer | `Alt+Shift+Right` | `Ctrl+Shift+Right` |+| Styles Pane — Formatvorlagenbereich | `Ctrl+Alt+Shift+S` | `Cmd+Alt+Shift+S` |+| Apply Styles — Formatvorlage anwenden | `Ctrl+Shift+S` | — |++### Einfügen++Quelle: [insert](../../crates/engine/src/cmd/insert.rs), [equation](../../crates/engine/src/cmd/equation.rs).++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| Equation — Gleichung einfügen | `Alt+=` | `Alt+=` |+| Link — Link einfügen | `Ctrl+K` | `Cmd+K` |+| Bookmark — Textmarke einfügen | `Ctrl+Shift+F5` | `Cmd+Shift+F5` |+| Field — Feld einfügen | `Ctrl+F9` | `Cmd+F9` |+| Insert Date Field — Datumsfeld einfügen | `Alt+Shift+D` | `Ctrl+Shift+D` |+| Insert Time Field — Uhrzeitfeld einfügen | `Alt+Shift+T` | `Ctrl+Shift+T` |+| Insert Page Field — Seitenzahlfeld einfügen | `Alt+Shift+P` | `Ctrl+Shift+P` |++### Ansichten und Gliederung++Quelle: [view](../../crates/engine/src/cmd/view.rs), [outline](../../crates/engine/src/cmd/outline.rs).++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| Show/Hide ¶ — Formatierungszeichen anzeigen/ausblenden | `Ctrl+Shift+8 / Ctrl+8` | `Cmd+Shift+8 / Cmd+8` |+| Print Layout — Drucklayout | `Ctrl+Alt+P` | `Cmd+Alt+P` |+| Draft — Entwurfsansicht | `Ctrl+Alt+N` | `Cmd+Alt+N` |+| Outline — Gliederungsansicht | `Ctrl+Alt+O` | `Cmd+Alt+O` |+| Split — Ansicht teilen | `Ctrl+Alt+S` | `Cmd+Alt+S` |+| Full Screen — Vollbild | `F11` | `Cmd+Ctrl+F / F11` |+| Expand — Gliederung aufklappen | `Alt+Shift+=` | `Alt+Shift+=` |+| Collapse — Gliederung einklappen | `Alt+Shift+-` | `Alt+Shift+-` |+| Show Level 1 — Bis Gliederungsebene 1 anzeigen | `Alt+Shift+1` | `Alt+Shift+1` |+| Show Level 2 — Bis Gliederungsebene 2 anzeigen | `Alt+Shift+2` | `Alt+Shift+2` |+| Show Level 3 — Bis Gliederungsebene 3 anzeigen | `Alt+Shift+3` | `Alt+Shift+3` |+| Show Level 4 — Bis Gliederungsebene 4 anzeigen | `Alt+Shift+4` | `Alt+Shift+4` |+| Show Level 5 — Bis Gliederungsebene 5 anzeigen | `Alt+Shift+5` | `Alt+Shift+5` |+| Show Level 6 — Bis Gliederungsebene 6 anzeigen | `Alt+Shift+6` | `Alt+Shift+6` |+| Show Level 7 — Bis Gliederungsebene 7 anzeigen | `Alt+Shift+7` | `Alt+Shift+7` |+| Show Level 8 — Bis Gliederungsebene 8 anzeigen | `Alt+Shift+8` | `Alt+Shift+8` |+| Show Level 9 — Bis Gliederungsebene 9 anzeigen | `Alt+Shift+9` | `Alt+Shift+9` |+| Show All Levels — Alle Gliederungsebenen anzeigen | `Alt+Shift+A` | `Alt+Shift+A` |+| Show First Line Only — Nur erste Zeile anzeigen | `Alt+Shift+L` | — |++### Verweise und Felder++Quelle: [references](../../crates/engine/src/cmd/references.rs), [fields](../../crates/engine/src/cmd/fields.rs), [index](../../crates/engine/src/cmd/index.rs), [citations](../../crates/engine/src/cmd/citations.rs).++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| Mark Entry — Indexeintrag markieren | `Alt+Shift+X` | — |+| Field Codes — Feldfunktionen anzeigen | `Alt+F9` | `Alt+F9` |+| Toggle Field Codes — Feldfunktion umschalten | `Shift+F9` | `Shift+F9` |+| Unlink Fields — Feldverknüpfung aufheben | `Ctrl+Shift+F9` | `Cmd+Shift+F9` |+| Lock Fields — Felder sperren | `Ctrl+F11` | `Cmd+F11` |+| Unlock Fields — Felder entsperren | `Ctrl+Shift+F11` | `Cmd+Shift+F11` |+| Next Field — Nächstes Feld | `Alt+F1` | `Alt+F1` |+| Previous Field — Vorheriges Feld | `Shift+F11 / Alt+Shift+F1` | `Shift+F11 / Alt+Shift+F1` |+| Mark Citation — Zitat für Rechtsgrundlagenverzeichnis markieren | `Alt+Shift+I` | — |+| Insert Footnote — Fußnote einfügen | `Ctrl+Alt+F` | `Cmd+Alt+F` |+| Insert Endnote — Endnote einfügen | `Ctrl+Alt+D` | `Cmd+Alt+E` |+| Next Footnote — Nächste Fußnote | `Alt+Shift+> / Alt+Shift+.` | — |+| Update Field — Feld aktualisieren | `F9` | `F9` |++### Überprüfen++Quelle: [review](../../crates/engine/src/cmd/review.rs), [speech](../../crates/engine/src/cmd/speech.rs).++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| Read Aloud — Vorlesen | `Ctrl+Alt+Space` | `Cmd+Alt+Space` |+| New Comment — Neuer Kommentar | `Ctrl+Alt+M` | `Cmd+Alt+A / Cmd+Alt+M` |+| Track Changes — Änderungen nachverfolgen | `Ctrl+Shift+E` | `Cmd+Shift+E` |+| Word Count — Wörter zählen | `Ctrl+Shift+G` | — |+| Spelling & Grammar — Rechtschreibung und Grammatik | `F7 / Alt+F7` | `F7 / Alt+F7 / Cmd+Alt+L` |+| Thesaurus — Synonyme | `Shift+F7` | `Shift+F7` |++### Seriendruck++Quelle: [mailings](../../crates/engine/src/cmd/mailings.rs).++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| Edit Recipient List — Empfängerliste bearbeiten | `Alt+Shift+E` | — |+| Insert Merge Field — Seriendruckfeld einfügen | `Alt+Shift+F` | — |+| Preview Results — Seriendruckvorschau | `Alt+Shift+K` | — |+| Finish & Merge — Seriendruck abschließen | `Alt+Shift+N` | — |+| Print Documents — Seriendokumente drucken | `Alt+Shift+M` | — |++### Weitere Werkzeuge++Quelle: [tools/specs](../../crates/engine/src/cmd/tools/specs.rs).++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| Repeat — Letzte Aktion wiederholen | `F4` | `F4` |+| Macros — Makros | `Alt+F8` | `Alt+F8` |+| Search — Befehl suchen | `Alt+Q` | — |+| AutoText — AutoText einfügen | `Alt+F3` | — |+| Link to Previous — Mit vorherigem Abschnitt verknüpfen | `Alt+Shift+R` | — |+| Extend Selection — Auswahl erweitern | `F8` | `F8` |++## Kontextabhängige Bedienung++Diese Steuerungen ergänzen das Befehlsverzeichnis. Ein fokussierter Dialog, ein Menü, ein ausgewähltes+Objekt oder ein aktives Werkzeug kann Vorrang vor normaler Textbearbeitung haben.++| Kontext | Tasten / Geste | Wirkung |+|---|---|---|+| Textnavigation | Shift + Bewegungskürzel | Erweitert die Auswahl, sofern die Kombination nicht ausdrücklich anders belegt ist |+| Ausgewählter Text | Shift+Delete | Schneidet die Auswahl aus; ohne Auswahl keine Wirkung |+| Dokument | Shift+Backspace | Löscht rückwärts |+| Dokument | Insert | Schaltet Überschreiben nur um, wenn unter **File › Options › Advanced** aktiviert |+| Menüband | F10; auf Nicht-macOS Alt kurz drücken und loslassen | Zeigt KeyTips; den eingeblendeten Buchstaben folgen. Escape geht zurück |+| Menüband | Ctrl+F1 (Nicht-macOS); Cmd+Alt+R (macOS) | Klappt das Menüband ein/aus; eine eigene Ctrl+F1-Zuordnung hat Vorrang |+| Dokument | Shift+F10 | Öffnet das Kontextmenü |+| Read Mode | PageDown / Right; PageUp / Left | Nächste/vorherige Leseseite |+| Read Mode / Vollbildansichten | Escape | Beendet die Ansicht, nachdem nähere Kontexte wie Auswahl, Werkzeuge oder Menüs Escape verarbeitet haben |+| Gleichungsbearbeitung | Pfeile, Home, End | Bewegt innerhalb der Gleichung |+| Gleichungsbearbeitung | Tab / Shift+Tab | Nächster/vorheriger Gleichungsteil |+| Gleichungsbearbeitung | Backspace / Delete; Enter; Escape | Löscht in der Gleichung; baut die Gleichung auf oder beginnt einen neuen Absatz, wenn nichts aufzubauen ist; beendet die Gleichungsbearbeitung |+| Text in Textfeld / WordArt | Escape | Wählt das umgebende Objekt; Delete kann es anschließend entfernen |+| Kopf-/Fußzeile ohne Textauswahl | Escape | Kehrt zum Hauptdokument zurück |+| Formatübertragung, Stift/Radierer oder Tabellenzeichnen | Escape | Beendet das aktive Werkzeug |++Quellen: [Kürzelverarbeitung](../../crates/ui-egui/src/keys/shortcuts.rs),+[Dokumenteingabe](../../crates/ui-egui/src/keys/canvas.rs), [KeyTips](../../crates/ui-egui/src/keytips.rs).++## Weitere Hilfe und Abdeckung++| Thema | Vorhandene Dokumentation |+|---|---|+| Wiederherstellung und ungespeicherte Arbeit | [Recovery](../recovery.md) |+| Sprachprüfung einrichten | [Wörterbücher](../spelling-dictionaries.md) |+| Literaturverwaltung | [Zotero](../zotero.md) |+| Formate, Layout und Schreibverhalten | [Dateiformate](../file-format-parity.md), [Layout](../layout-parity.md), [Schreibverhalten](../typing-parity.md) |+| Oberfläche und Plattformen | [UI](../ui-parity.md), [Lokalisierung](../localization-parity.md), [Hardware/Plattformen](../hardware-parity.md) |+| Automatisierung | [MCP](../mcp.md), [Steuerprotokoll](../control-protocol.md), [CLI-Beispiele im README](../../README.md#for-agents-cli-and-mcp) |+| Bekannte Lücken und geplante Arbeit | [Lücken](../gaps.md), [Roadmap](../roadmap.md) |++Dies ist ein erstes Handbuch, noch keine vollständige Anleitung für jeden Befehl. Ausführliche+Abläufe für komplexe Tabellen und Objekte, Zeichnen, Gleichungen, Dokumentenschutz, Makros und jeden+einzelnen Dialog müssen ergänzt werden. Die Kürzeltabellen decken alle Standardbelegungen des+geprüften Engine-Verzeichnisses und die oben aufgeführten Kontextsteuerungen ab; weitere Objekt-,+Werkzeug- und Dialoggesten benötigen noch einen systematischen Durchgang. Vorhandene Themenseiten+bleiben für ihre Details maßgeblich und sind derzeit überwiegend englisch. Geplante Fähigkeiten+in Roadmap-/Paritätsseiten sind keine Bedienungsanleitung für bereits verfügbare Funktionen.++Für Beitragende: Englische Anleitung und vorhandene Übersetzungen synchron halten und das Verhalten am Quellcode prüfen;+siehe [AGENTS.md](../../AGENTS.md#user-documentation).new file mode 100644@@ -0,0 +1,425 @@+# WordCraft user guide++[Deutsch](usage-de.md) · [All languages / translate](README.md) · [Project README](../../README.md)++English is the source text; German is the initial example translation. Further languages can+follow the same structure (see the language index).++This guide collects everyday workflows and keyboard shortcuts. English command names are used+so you can find the same actions in the ribbon or command search; the interface may translate them.+Checked against source revision [2cf1d6c](https://github.com/storytold/wordcraft/tree/2cf1d6c7ae94723a45bd6e7e8c884fe375148750)+on 2026-10-27. A downloaded release may differ.++## Contents++- [Start, save and export](#start-save-and-export)+- [Write, select, copy and paste](#write-select-copy-and-paste)+- [Format and structure a document](#format-and-structure-a-document)+- [Review, references and mail merge](#review-references-and-mail-merge)+- [Settings and keyboard customization](#settings-and-keyboard-customization)+- [Keyboard reference](#keyboard-reference)+- [Context-sensitive controls](#context-sensitive-controls)+- [Further help and coverage](#further-help-and-coverage)++## Start, save and export++1. Choose **File › New** for a blank document or a template, or **File › Open** for an existing file.+2. Write in the document canvas. Use **File › Save As** to choose a name, location and format;+ use **Save** for subsequent changes. To keep an input file, save under a new name.+3. Choose **File › Export › Export PDF** for a PDF copy, or **File › Print** to review print settings.+ Check **Print Markup** when deciding whether comments and tracked changes appear in output.++WordCraft reads and writes DOCX, ODT, RTF, HTML, Markdown and text, among other formats;+legacy DOC is an import format. Format conversion can change content or layout: consult the+[file-format reference](../file-format-parity.md) before relying on a round trip, and inspect the+saved/exported file. Installation and build instructions remain in the [README](../../README.md).+For interrupted work, use the existing [recovery guide](../recovery.md).++## Write, select, copy and paste++Click to place the caret, drag to select text, or hold **Shift** while moving the caret to extend+a selection. **Enter** starts a paragraph; **Shift+Enter** inserts a line break. In a list, Enter+continues the list and Tab changes its level; in a table, Tab moves between cells. See+[typing behavior](../typing-parity.md) for the detailed rules and exceptions.++Select text before **Home › Clipboard › Copy** or **Cut**, place the caret at the destination,+then choose **Paste**. Normal paste uses available clipboard formatting; the result depends on+the formats supplied by the source application. **Paste: Keep Text Only** inserts plain text;+**Paste Special** offers the available clipboard representations.++The defaults distinguish **text content** from **formatting**:++| Action | Windows / Linux / BSD | macOS |+|---|---|---|+| Copy content | Ctrl+C / Ctrl+Insert | Cmd+C / Cmd+Insert |+| Paste content | Ctrl+V / Shift+Insert | Cmd+V / Shift+Insert |+| Paste: Keep Text Only | Ctrl+Shift+Alt+V | Cmd+Shift+Alt+V |+| Copy Formatting | Ctrl+Shift+C | Cmd+Shift+C |+| Paste Formatting | Ctrl+Shift+V | Cmd+Shift+V |+| Paste Special | Ctrl+Alt+V | Cmd+Alt+V |++**Copy Formatting / Paste Formatting** transfer the source selection's formatting to the target;+they do not copy or paste plain text. There is no default plain-text-copy binding, nor a default+Ctrl+Alt+Insert or Shift+Alt+Insert binding in the checked registry.++Use **Home › Editing › Find** to search, **Find and Replace** to change matches, and **Go To**+to navigate. **Undo** reverses an edit; **Redo** restores it. **Repeat** repeats the last repeatable+action and is distinct from Redo.++## Format and structure a document++Select the text or place the caret in the relevant paragraph before using these controls.++| Task | Where and how | Result / context |+|---|---|---|+| Change character appearance | **Home › Font**: choose the face, size, emphasis, color or highlight | Applies character formatting to the selection or subsequent typing |+| Set paragraph layout | **Home › Paragraph**: choose alignment, spacing, indents or a list | Changes the selected paragraphs |+| Use consistent headings | **Home › Styles**: apply Normal or a Heading style | Headings provide document structure; use the Styles pane to manage styles |+| Set up pages | **Layout**: set margins, orientation, paper size, columns and breaks | Controls page/section layout; [layout coverage](../layout-parity.md) records limitations |+| Add a table | **Insert › Table**, choose dimensions, then edit cells | Table controls act on the current table/cell selection; Tab navigates cells |+| Add pictures, shapes or charts | Choose the matching **Insert** command, then select the inserted object | Use its contextual controls for size, position and wrapping |+| Add a link or bookmark | **Insert › Links**: select text, choose Link or Bookmark and supply its destination/name | Creates a navigable reference |+| Add headers, footers or fields | Use **Insert** and the corresponding header/footer or **Text › Quick Parts** controls | Fields can be updated; headers/footers belong to sections |+| Change the view | **View**: Print Layout, Draft, Outline, Read Mode or split view | Changes how you work with the document, not its saved page size |++## Review, references and mail merge++- **Review:** enable **Track Changes** before edits you want recorded. Select text and choose+ **New Comment** to discuss it. Use the review controls to accept/reject changes and navigate+ comments. Hiding markup does not accept revisions. Run **Spelling & Grammar** for proofing;+ [spelling dictionaries](../spelling-dictionaries.md) explains dictionary installation and selection.+- **References:** apply heading styles before inserting a table of contents. Use **Insert Footnote**+ or **Insert Endnote** at the reference position. Refresh fields after changing the document.+ Citations, bibliography, captions and index entries live on **References**;+ [Zotero integration](../zotero.md) has its own setup and usage instructions.+- **Mailings:** choose recipients, insert merge fields into the document, inspect **Preview Results**,+ then use **Finish & Merge** or **Print Documents**. Verify records in the preview before producing+ the merged output. These commands require a configured recipient source.++## Settings and keyboard customization++Use **File › Options** for application settings. To inspect or change shortcuts, open+**Tools › Customize Keyboard**, or **File › Options › Keyboard shortcuts**:++1. Choose a category and command (or use the dialog's filter).+2. Inspect its current keys. Focus **New shortcut** and press the desired combination.+3. Check the displayed assignment and choose **Assign**; select an existing binding and **Remove**+ to remove it. **Reset All** asks for confirmation before restoring defaults.++Assignments are saved in preferences. The dialog accepts modified keys or function keys, rather+than unmodified typing letters. User assignments/removals can change the tables below.+On Windows/Linux/BSD **Ctrl+F1** collapses the ribbon unless assigned to another command;+on macOS use **Cmd+Alt+R**. **Alt+Q** opens command search on non-macOS builds.++## Keyboard reference++These are the **163 command entries with default shortcuts** in the checked engine registry,+grouped by area, followed by UI/context controls. Commands with no default binding remain available+through the UI or command search where supported. This is a source-checked inventory, not a claim+that every combination was exercised on every platform.++- **Ctrl** is Control; **Cmd** is Command (⌘); **Alt** is Option (⌥) on macOS.+ **Shift** is ⇧. A slash separates alternative combinations; **—** means no default for that platform.+- The platform columns describe native builds. The web build uses the non-macOS registry defaults;+ its primary modifier follows the browser platform. Browsers and the operating system may consume+ shortcuts before WordCraft sees them. Function keys may require **Fn** on your keyboard.+- Click the document canvas for editing/navigation keys. A focused text box or dialog owns its+ input. Outline, field, table, review and mail-merge commands require the corresponding context.+ A disabled command does not become available merely because its shortcut is pressed.+- The character names reflect the registered keys; punctuation placement varies with keyboard layout.++### Files++Source: [file](../../crates/engine/src/cmd/file.rs).++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| New | `Ctrl+N` | `Cmd+N` |+| Open | `Ctrl+O / Ctrl+F12 / Ctrl+Alt+F2` | `Cmd+O / Cmd+F12 / Cmd+Alt+F2` |+| Save | `Ctrl+S / Shift+F12 / Alt+Shift+F2` | `Cmd+S / Shift+F12 / Alt+Shift+F2` |+| Save As | `F12 / Alt+F2` | `F12 / Cmd+Shift+S` |+| Print | `Ctrl+P / Ctrl+Shift+F12 / Ctrl+F2 / Ctrl+Alt+I` | `Cmd+P / Cmd+Shift+F12 / Cmd+F2 / Cmd+Alt+I` |+| Close | `Ctrl+W / Ctrl+F4` | `Cmd+W / Cmd+F4` |++### Typing and special characters++Source: [text](../../crates/engine/src/cmd/text.rs).++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| New Paragraph | `Enter` | `Enter` |+| Line Break | `Shift+Enter` | `Shift+Enter` |+| Page Break | `Ctrl+Enter` | `Cmd+Enter` |+| Column Break | `Ctrl+Shift+Enter` | `Cmd+Shift+Enter` |+| Tab | `Tab` | `Tab` |+| Shift+Tab | `Shift+Tab` | `Shift+Tab` |+| Tab Character | `Ctrl+Tab` | `Alt+Tab` |+| Backspace | `Backspace` | `Backspace` |+| Delete | `Delete` | `Delete` |+| Delete Previous Word | `Ctrl+Backspace / Alt+Backspace` | `Cmd+Backspace / Alt+Backspace` |+| Delete Next Word | `Ctrl+Delete / Alt+Delete` | `Cmd+Delete / Alt+Delete` |+| Nonbreaking Space | `Ctrl+Shift+Space` | `Cmd+Shift+Space` |+| Nonbreaking Hyphen | `Ctrl+Shift+-` | `Cmd+Shift+-` |+| Optional Hyphen | `Ctrl+-` | `Cmd+-` |+| Toggle Unicode Character | `Alt+X` | — |+| Em Dash | `Ctrl+Alt+-` | `Cmd+Alt+-` |+| Copyright Sign | `Ctrl+Alt+C` | — |+| Registered Sign | `Ctrl+Alt+R` | — |+| Trademark Sign | `Ctrl+Alt+T` | — |+| Ellipsis | `Ctrl+Alt+.` | — |++### Navigation and selection++Source: [caret](../../crates/engine/src/cmd/caret.rs), [column](../../crates/engine/src/cmd/column.rs).++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| Column Selection | `Ctrl+Shift+F8` | `Cmd+Shift+F8` |+| Left | `Left` | `Left` |+| Right | `Right` | `Right` |+| Up | `Up` | `Up` |+| Down | `Down` | `Down` |+| Word Left | `Ctrl+Left / Alt+Left` | `Alt+Left` |+| Word Right | `Ctrl+Right / Alt+Right` | `Alt+Right` |+| Line Start | `Home` | `Home / Cmd+Left` |+| Line End | `End` | `End / Cmd+Right` |+| Paragraph Up | `Ctrl+Up / Alt+Up` | `Cmd+Up / Alt+Up` |+| Paragraph Down | `Ctrl+Down / Alt+Down` | `Cmd+Down / Alt+Down` |+| Document Start | `Ctrl+Home` | `Cmd+Home` |+| Document End | `Ctrl+End` | `Cmd+End` |+| Page Up | `PageUp` | `PageUp` |+| Page Down | `PageDown` | `PageDown` |+| Select All | `Ctrl+A` | `Cmd+A` |+| Collapse Selection | `Escape` | `Escape` |++### Editing and clipboard++Source: [edit](../../crates/engine/src/cmd/edit.rs), [paste](../../crates/engine/src/cmd/paste.rs).++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| Undo | `Ctrl+Z` | `Cmd+Z` |+| Redo | `Ctrl+Y / Ctrl+Shift+Z` | `Cmd+Y / Cmd+Shift+Z` |+| Cut | `Ctrl+X` | `Cmd+X` |+| Copy | `Ctrl+C / Ctrl+Insert` | `Cmd+C / Cmd+Insert` |+| Spike | `Ctrl+F3` | `Cmd+F3` |+| Insert Spike | `Ctrl+Shift+F3` | `Cmd+Shift+F3` |+| Paste | `Ctrl+V / Shift+Insert` | `Cmd+V / Shift+Insert` |+| Paste: Keep Text Only | `Ctrl+Shift+Alt+V` | `Cmd+Shift+Alt+V` |+| Find | `Ctrl+F` | `Cmd+F` |+| Find Next | `Ctrl+G / F3 / Shift+F4 / Ctrl+PageDown` | `Cmd+G / F3 / Shift+F4 / Cmd+PageDown` |+| Find Previous | `Ctrl+PageUp` | `Cmd+Shift+G / Cmd+PageUp` |+| Find and Replace | `Ctrl+H` | `Cmd+H / Ctrl+H` |+| Go To | `Ctrl+Alt+G / F5` | `Cmd+Alt+G / F5` |+| Go Back | `Shift+F5 / Ctrl+Alt+Z` | `Shift+F5 / Cmd+Alt+Z` |+| Copy Formatting | `Ctrl+Shift+C` | `Cmd+Shift+C` |+| Paste Formatting | `Ctrl+Shift+V` | `Cmd+Shift+V` |+| Paste Special | `Ctrl+Alt+V` | `Cmd+Alt+V` |++### Character formatting++Source: [format](../../crates/engine/src/cmd/format.rs).++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| Bold | `Ctrl+B` | `Cmd+B` |+| Italic | `Ctrl+I` | `Cmd+I` |+| Underline | `Ctrl+U` | `Cmd+U` |+| Double Underline | `Ctrl+Shift+D` | `Cmd+Shift+D` |+| Underline Words Only | `Ctrl+Shift+W` | `Cmd+Shift+W` |+| Strikethrough | `Ctrl+Shift+X` | `Cmd+Shift+X` |+| Subscript | `Ctrl+=` | `Cmd+=` |+| Superscript | `Ctrl+Shift+=` | `Cmd+Shift+=` |+| All Caps | `Ctrl+Shift+A` | `Cmd+Shift+A` |+| Small Caps | `Ctrl+Shift+K` | `Cmd+Shift+K` |+| Hidden | `Ctrl+Shift+H` | `Cmd+Shift+H` |+| Font | `Ctrl+Shift+F` | `Cmd+Shift+F` |+| Font Size | `Ctrl+Shift+P` | `Cmd+Shift+P` |+| Increase Font Size | `Ctrl+Shift+. / Ctrl+Shift+>` | `Cmd+Shift+. / Cmd+Shift+>` |+| Decrease Font Size | `Ctrl+Shift+, / Ctrl+Shift+<` | `Cmd+Shift+, / Cmd+Shift+<` |+| Grow Font 1 Point | `Ctrl+]` | `Cmd+]` |+| Shrink Font 1 Point | `Ctrl+[` | `Cmd+[` |+| Text Highlight Color | `Ctrl+Alt+H` | — |+| Change Case | `Shift+F3` | `Shift+F3` |+| Reset Character Formatting | `Ctrl+Space` | `Ctrl+Space` |+| Font Dialog | `Ctrl+D` | `Cmd+D` |++### Paragraphs and styles++Source: [para](../../crates/engine/src/cmd/para.rs), [inspector](../../crates/engine/src/cmd/inspector.rs).++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| Style Inspector | `Shift+F1` | `Shift+F1` |+| Align Left | `Ctrl+L` | `Cmd+L` |+| Center | `Ctrl+E` | `Cmd+E` |+| Align Right | `Ctrl+R` | `Cmd+R` |+| Justify | `Ctrl+J` | `Cmd+J` |+| Distributed | `Ctrl+Shift+J` | `Cmd+Shift+J` |+| Increase Indent | `Ctrl+M` | `Cmd+M` |+| Decrease Indent | `Ctrl+Shift+M` | `Cmd+Shift+M` |+| Hanging Indent | `Ctrl+T` | `Cmd+T` |+| Reduce Hanging Indent | `Ctrl+Shift+T` | `Cmd+Shift+T` |+| Single Spacing | `Ctrl+1` | `Cmd+1` |+| Double Spacing | `Ctrl+2` | `Cmd+2` |+| 1.5 Line Spacing | `Ctrl+5` | `Cmd+5` |+| Add Space Before Paragraph | `Ctrl+0` | `Cmd+0` |+| Reset Paragraph Formatting | `Ctrl+Q` | `Ctrl+Q` |+| Normal Style | `Ctrl+Shift+N` | `Cmd+Shift+N` |+| Heading 1 | `Ctrl+Alt+1` | `Cmd+Alt+1` |+| Heading 2 | `Ctrl+Alt+2` | `Cmd+Alt+2` |+| Heading 3 | `Ctrl+Alt+3` | `Cmd+Alt+3` |+| Bullets | `Ctrl+Shift+L` | `Cmd+Shift+L` |+| Move Paragraph Up | `Alt+Shift+Up` | `Ctrl+Shift+Up` |+| Move Paragraph Down | `Alt+Shift+Down` | `Ctrl+Shift+Down` |+| Promote | `Alt+Shift+Left` | `Ctrl+Shift+Left` |+| Demote | `Alt+Shift+Right` | `Ctrl+Shift+Right` |+| Styles Pane | `Ctrl+Alt+Shift+S` | `Cmd+Alt+Shift+S` |+| Apply Styles | `Ctrl+Shift+S` | — |++### Insert++Source: [insert](../../crates/engine/src/cmd/insert.rs), [equation](../../crates/engine/src/cmd/equation.rs).++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| Equation | `Alt+=` | `Alt+=` |+| Link | `Ctrl+K` | `Cmd+K` |+| Bookmark | `Ctrl+Shift+F5` | `Cmd+Shift+F5` |+| Field | `Ctrl+F9` | `Cmd+F9` |+| Insert Date Field | `Alt+Shift+D` | `Ctrl+Shift+D` |+| Insert Time Field | `Alt+Shift+T` | `Ctrl+Shift+T` |+| Insert Page Field | `Alt+Shift+P` | `Ctrl+Shift+P` |++### Views and outline++Source: [view](../../crates/engine/src/cmd/view.rs), [outline](../../crates/engine/src/cmd/outline.rs).++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| Show/Hide ¶ | `Ctrl+Shift+8 / Ctrl+8` | `Cmd+Shift+8 / Cmd+8` |+| Print Layout | `Ctrl+Alt+P` | `Cmd+Alt+P` |+| Draft | `Ctrl+Alt+N` | `Cmd+Alt+N` |+| Outline | `Ctrl+Alt+O` | `Cmd+Alt+O` |+| Split | `Ctrl+Alt+S` | `Cmd+Alt+S` |+| Full Screen | `F11` | `Cmd+Ctrl+F / F11` |+| Expand | `Alt+Shift+=` | `Alt+Shift+=` |+| Collapse | `Alt+Shift+-` | `Alt+Shift+-` |+| Show Level 1 | `Alt+Shift+1` | `Alt+Shift+1` |+| Show Level 2 | `Alt+Shift+2` | `Alt+Shift+2` |+| Show Level 3 | `Alt+Shift+3` | `Alt+Shift+3` |+| Show Level 4 | `Alt+Shift+4` | `Alt+Shift+4` |+| Show Level 5 | `Alt+Shift+5` | `Alt+Shift+5` |+| Show Level 6 | `Alt+Shift+6` | `Alt+Shift+6` |+| Show Level 7 | `Alt+Shift+7` | `Alt+Shift+7` |+| Show Level 8 | `Alt+Shift+8` | `Alt+Shift+8` |+| Show Level 9 | `Alt+Shift+9` | `Alt+Shift+9` |+| Show All Levels | `Alt+Shift+A` | `Alt+Shift+A` |+| Show First Line Only | `Alt+Shift+L` | — |++### References and fields++Source: [references](../../crates/engine/src/cmd/references.rs), [fields](../../crates/engine/src/cmd/fields.rs), [index](../../crates/engine/src/cmd/index.rs), [citations](../../crates/engine/src/cmd/citations.rs).++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| Mark Entry | `Alt+Shift+X` | — |+| Field Codes | `Alt+F9` | `Alt+F9` |+| Toggle Field Codes | `Shift+F9` | `Shift+F9` |+| Unlink Fields | `Ctrl+Shift+F9` | `Cmd+Shift+F9` |+| Lock Fields | `Ctrl+F11` | `Cmd+F11` |+| Unlock Fields | `Ctrl+Shift+F11` | `Cmd+Shift+F11` |+| Next Field | `Alt+F1` | `Alt+F1` |+| Previous Field | `Shift+F11 / Alt+Shift+F1` | `Shift+F11 / Alt+Shift+F1` |+| Mark Citation | `Alt+Shift+I` | — |+| Insert Footnote | `Ctrl+Alt+F` | `Cmd+Alt+F` |+| Insert Endnote | `Ctrl+Alt+D` | `Cmd+Alt+E` |+| Next Footnote | `Alt+Shift+> / Alt+Shift+.` | — |+| Update Field | `F9` | `F9` |++### Review++Source: [review](../../crates/engine/src/cmd/review.rs), [speech](../../crates/engine/src/cmd/speech.rs).++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| Read Aloud | `Ctrl+Alt+Space` | `Cmd+Alt+Space` |+| New Comment | `Ctrl+Alt+M` | `Cmd+Alt+A / Cmd+Alt+M` |+| Track Changes | `Ctrl+Shift+E` | `Cmd+Shift+E` |+| Word Count | `Ctrl+Shift+G` | — |+| Spelling & Grammar | `F7 / Alt+F7` | `F7 / Alt+F7 / Cmd+Alt+L` |+| Thesaurus | `Shift+F7` | `Shift+F7` |++### Mail merge++Source: [mailings](../../crates/engine/src/cmd/mailings.rs).++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| Edit Recipient List | `Alt+Shift+E` | — |+| Insert Merge Field | `Alt+Shift+F` | — |+| Preview Results | `Alt+Shift+K` | — |+| Finish & Merge | `Alt+Shift+N` | — |+| Print Documents | `Alt+Shift+M` | — |++### Other tools++Source: [tools/specs](../../crates/engine/src/cmd/tools/specs.rs).++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| Repeat | `F4` | `F4` |+| Macros | `Alt+F8` | `Alt+F8` |+| Search | `Alt+Q` | — |+| AutoText | `Alt+F3` | — |+| Link to Previous | `Alt+Shift+R` | — |+| Extend Selection | `F8` | `F8` |++## Context-sensitive controls++These controls supplement the registry. A focused dialog, menu, selected object or active tool can+take precedence over ordinary text editing.++| Context | Keys / gesture | Effect |+|---|---|---|+| Text navigation | Shift + a caret-movement shortcut | Extends the selection when that combination has no explicit assignment |+| Selected text | Shift+Delete | Cuts the selection; does nothing without a selection |+| Document | Shift+Backspace | Deletes backward |+| Document | Insert | Toggles overtype only if enabled in **File › Options › Advanced** |+| Ribbon | F10; tap and release Alt on non-macOS | Shows KeyTips; follow the displayed letters. Escape backs out |+| Ribbon | Ctrl+F1 (non-macOS); Cmd+Alt+R (macOS) | Collapses/expands the ribbon; a custom Ctrl+F1 assignment takes precedence |+| Document | Shift+F10 | Opens the context menu |+| Read Mode | PageDown / Right; PageUp / Left | Next/previous reading page |+| Read Mode / full-screen views | Escape | Exits after nearer contexts such as selections, tools or menus have handled Escape |+| Equation editing | Arrows, Home, End | Moves inside the equation |+| Equation editing | Tab / Shift+Tab | Next/previous equation part |+| Equation editing | Backspace / Delete; Enter; Escape | Deletes within the equation; builds up the equation, or starts a new paragraph when there is nothing to build; exits equation editing |+| Text box / WordArt text | Escape | Selects the containing object; Delete can then remove it |+| Header/footer with a collapsed selection | Escape | Returns to the main document |+| Format Painter, pen/eraser or table drawing | Escape | Ends the active tool |++Sources: [UI shortcut dispatch](../../crates/ui-egui/src/keys/shortcuts.rs),+[canvas input](../../crates/ui-egui/src/keys/canvas.rs), [KeyTips](../../crates/ui-egui/src/keytips.rs).++## Further help and coverage++| Topic | Existing documentation |+|---|---|+| Recovery and unsaved work | [Recovery](../recovery.md) |+| Proofing setup | [Spelling dictionaries](../spelling-dictionaries.md) |+| Reference manager | [Zotero](../zotero.md) |+| Formats, layout and typing details | [File formats](../file-format-parity.md), [layout](../layout-parity.md), [typing](../typing-parity.md) |+| Interface/platform behavior | [UI](../ui-parity.md), [localization](../localization-parity.md), [hardware/platforms](../hardware-parity.md) |+| Automation | [MCP](../mcp.md), [control protocol](../control-protocol.md), [README CLI examples](../../README.md#for-agents-cli-and-mcp) |+| Known gaps and planned work | [Gaps](../gaps.md), [roadmap](../roadmap.md) |++This is an initial handbook, not a complete tutorial for every command. Detailed walkthroughs for+advanced tables and objects, drawing, equations, document protection, macros and every individual+dialog remain to be expanded. The shortcut tables cover all default bindings in the checked engine+registry plus the contextual controls listed above; additional object/tool/dialog gestures still+need a systematic walkthrough. Existing topic pages remain authoritative for their details and+are currently mostly English. Planned capabilities in roadmap/parity pages are not instructions+for available features.++Contributors: keep the English guide and existing translations aligned and verify behavior against the implementation;+see [AGENTS.md](../../AGENTS.md#user-documentation).