collective
Browse / github.com/storytold/pdfcraft / patch
docs: add extensible usage guides with an initial German translation
docs: add extensible usage guides with an initial German translation ## What this changes Everyday instructions are spread across the README and individual topic pages. Add English/German usage entry points at `docs/usage/usage.md` and `usage-de.md`, with core task workflows, all 25 default registry shortcuts, additional view/context controls, platform limitations and links to existing detailed guides. The README links the initial guides and a language index. English is the source text; German is the first example translation. Additional languages can use `usage-<language-code>.md`, following the naming/review instructions in `docs/usage/README.md`. AGENTS.md
- Status
- open
- Score
- 0.00
- Adopters
- 0 other operators
- Author
- LabDennis (imported from pull request #4940, open)
- Base
1dd2737b47a9c1c9562f0af563053d1bf510e4bf- Size
- +498 −3 in 8 files
- Review
- pending
- Shared
- 2026-10-28
- Id
23a727193b7199cd0cea5ce7
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
@@ -121,6 +121,27 @@ PdfCraft opens files from strangers, and people trust it with their work. A malf Follow `CLAUDE.md`. It covers quality gates, layering, commit rules and how to run and look at the app. +## 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 @@ PdfCraft is a clean-room, open-source, Rust-native PDF application targeting Adobe Acrobat Pro parity. It runs natively on macOS, Windows, Linux and FreeBSD, and on the web via WASM. It is the sibling of `../photocraft` (a Photoshop-class editor) and follows the same conventions. +## 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`: the current milestone, the next unchecked task and any blockers. `ROADMAP.md` is the one-page summary (stage, numbers, progress log) and `docs/roadmap.md` the milestone table; at the end of every session update the milestone row and add a line to the ROADMAP.md progress log. - Read `docs/gaps.md` (the ranked gaps: Acrobat interop, the open-issue backlog, the renderer and a fidelity harness, editing existing content, Pro workflows, 1.0 polish) and `docs/target-app-parity.md` (the numbers and how they are measured) before choosing work. Prefer the gaps over new P2/P3 features, and keep both documents true when things change (`docs/` progress docs follow craftrules `standards/progress-docs.md`: status line, revision history).@@ -71,6 +71,8 @@ --- +**User guide and keyboard shortcuts:** [English](docs/usage/usage.md) · [Deutsch](docs/usage/usage-de.md) · [All languages / translate](docs/usage/README.md)+ ## Community PdfCraft is part of [ArtCraft](https://getartcraft.com). Come say hello, get help and follow development:@@ -2,7 +2,7 @@ **Stage: alpha** · next: beta, ~25% (ready for real work 50% → 75%) and ~400–700 h away -> **Last reviewed:** 2026-10-25 | **Last updated:** 2026-10-25 | **Change:** minor (M14 localization current state: Arabic logical catalog, explicit RTL label direction and mirrored stock chrome; native/browser RTL workflows unqualified. Native release Hans face via LXGW WenKai Lite; estimates unchanged)+> **Last reviewed:** 2026-10-25 | **Last updated:** 2026-10-27 | **Change:** trivial (initial English/German user guide and shortcut reference; estimates unchanged); previous update: minor (M14 localization current state: Arabic logical catalog, explicit RTL label direction and mirrored stock chrome; native/browser RTL workflows unqualified. Native release Hans face via LXGW WenKai Lite; estimates unchanged) > **Last reviewed:** 2026-10-23 · **Last updated:** 2026-10-23 · **Change:** minor (M7, #2636 partial: pasting added text boxes and images in the engine and through `content_copy`; estimates unchanged) > **Last reviewed:** 2026-10-23 · **Last updated:** 2026-10-23 · **Change:** minor (M11: image optimization accounts for page-local UserUnit; estimates unchanged) > **Last reviewed:** 2026-10-23 | **Last updated:** 2026-10-23 | **Change:** minor (M10: Word table cells use the widths of their own grid columns; estimates unchanged)@@ -199,6 +199,8 @@ Ranked; detail and the full milestone table in [docs/roadmap.md](docs/roadmap.md ## Progress log +- **2026-10-27 (M14, documentation):** Initial [English](docs/usage/usage.md) / [German](docs/usage/usage-de.md) user guide, default shortcut inventory and agent maintenance rule. Advanced coverage remains open; estimates unchanged.+ - **2026-10-24 (M10, #4158 partial):** Word, HTML, RTF and PowerPoint export keep a block that continues another on its line (an italic case name, a link, a superscript) as a run in its own style inside that paragraph, with the source's word space, instead of a paragraph of its own. Style changes that wrap onto the next line still split paragraphs (the reading blocks keep style boundaries). Estimates unchanged. - **2026-10-24 (M3, window move on Wayland, #3970 follow-up):** After a move or resize by PdfCraft's own title bar or edges, the button release given back to egui goes before the pointer leaving the window, so hover no longer sticks at the old place until the pointer moves. Found by CodeRabbit in review of #3970; a unit test covers it. Estimates unchanged. - **2026-10-24 (M14, #4253):** The annotation quick bar remembers Keep tool selected across restarts, including unpinning. Old and malformed settings keep safe defaults; the opt-in UI control channel reads and changes the same preference. Estimates unchanged.@@ -682,6 +684,7 @@ Newest first: the date, what moved, and the new overall estimate. | Date | Change | Summary | |---|---|---|+| 2026-10-27 | trivial | Initial bilingual user guide and default shortcut reference; documentation maintenance rule added; readiness estimates unchanged | | 2026-10-23 | minor | M8, #3205 follow-up: phone-pattern redaction includes the +39 country code on labelled Italian geographic numbers with a slash; dates, protocol identifiers and whole-run guards remain. Estimates unchanged. | | 2026-10-23 | minor | M11: image downsampling measures physical resolution after page-local UserUnit scaling, including shared nested forms; synthetic measurement and optimization regressions. Estimates unchanged. | | 2026-10-23 | minor | M10: Word table cells use the grid columns they span, including cells after a merged cell; synthetic export regression and CLI reproduction. Estimates unchanged. |@@ -1,6 +1,6 @@ # PdfCraft roadmap: milestones and what's next -> **Last reviewed:** 2026-10-25 | **Last updated:** 2026-10-25 | **Change:** minor (M14 localization current state: Arabic logical catalog, explicit RTL label direction and mirrored stock chrome; native/browser RTL workflows unqualified. Native release Hans face via LXGW WenKai Lite; estimates unchanged)+> **Last reviewed:** 2026-10-25 | **Last updated:** 2026-10-27 | **Change:** trivial (initial English/German user guide and shortcut reference; estimates unchanged); previous update: minor (M14 localization current state: Arabic logical catalog, explicit RTL label direction and mirrored stock chrome; native/browser RTL workflows unqualified. Native release Hans face via LXGW WenKai Lite; estimates unchanged) > **Last reviewed:** 2026-10-23 · **Last updated:** 2026-10-23 · **Change:** minor (M7, #2636 partial: pasting added text boxes and images in the engine and through `content_copy`; estimates unchanged) > **Last reviewed:** 2026-10-23 · **Last updated:** 2026-10-23 · **Change:** minor (M11: image optimization accounts for page-local UserUnit; estimates unchanged) @@ -199,7 +199,7 @@ total matches the parity estimate. | M13 | Automation (MCP, Action Wizard, CLI) + AI providers | 60–120 | 45% | 25–45 | Done: MCP resources (document info, text, page images); headless tool table (123 tools incl. signing, optimizing, initial view, links, stamps, data exchange, comment review, forms authoring and scripts, redaction, sanitize, print, add content), opt-in MCP server over stdio, CLI `run`/`tools` (closed stdout pipes exit cleanly), UI control channel with drag. Missing: Action Wizard, AI providers<br>Done since: CLI run and MCP reject missing, empty, repeated and option-valued --root arguments before any tool/script execution or MCP initialization. A single-hyphen directory name remains valid; synthetic CLI regressions preserve a would-be overwritten file. `text_find` also caps the per-page match ranges it materializes at the remaining result limit plus one continuation match. CLI robustness scans visit each directory once through overlapping roots and symlink aliases. | | M12 | Accessibility, compare, measure, search, XFA | 200–380 | 30% | 90–160 | Done: new `a11y` crate with the Accessibility Checker (all 32 rules, report, Fix/Skip/Explain, options dialog and results panel, agent tools). Locatable figure, annotation and form findings highlight their page bounds. Character encoding accepts Identity-H/V with Adobe CJK collections and predefined CJK CMaps independently (#3673); per-glyph validation and embedded-font extraction remain separate.<br>Done since: 2D distance, perimeter and area measurements with persistent viewport calibration, snapping, live information and CSV export; a bounded text-only auto-tag proposal tool; text-only Apply writes marked content, paragraph tags and a parent tree, then opens the Tags panel for review. Missing: mixed-content and field autotag, heading/list/table/figure classification, Order/Content panels, Reading Order tool, compare, geospatial/3D measurement, search index, XFA<br>Done since: CLI info, text and render use dynamic XFA layout pages, with synthetic count/text/pixel and copy-permission regressions (#1645).<br>Reading colours: pending page backgrounds follow the configured colour (#2059). | | M13 | Automation (MCP, Action Wizard, CLI) + AI providers | 60–120 | 45% | 25–45 | Done: MCP resources (document info, text, page images); headless tool table (123 tools incl. signing, optimizing, initial view, links, stamps, data exchange, comment review, forms authoring and scripts, redaction, sanitize, print, add content), opt-in MCP server over stdio, CLI `run`/`tools` (closed stdout pipes exit cleanly), UI control channel with drag. Missing: Action Wizard, AI providers<br>Done since: CLI run and MCP reject missing, empty, repeated and option-valued --root arguments before any tool/script execution or MCP initialization. A single-hyphen directory name remains valid; synthetic CLI regressions preserve a would-be overwritten file. `text_find` also caps the per-page match ranges it materializes at the remaining result limit plus one continuation match. |-| M14 | 1.0 polish: performance, localization, installers | 120–250 | 15% | 80–150 | Done: PhotoCraft's translation system (`i18n/`: TSV catalogs, `tl!`, command-id and plural entries, system-language detection, strict catalog tests); every dialog, panel and notice goes through `tl!`. Catalogs of ≈ 2,000–2,140 entries for Japanese, Simplified and Traditional Chinese, Russian, Bulgarian, German, Spanish, French, Telugu, Hungarian, Ukrainian and Arabic (logical catalog; explicit right-to-left labels and mirrored stock chrome; end-to-end RTL workflows unqualified); the 2,674-entry Brazilian Portuguese catalog covers the current key union; Czech covers the menus. Italian has 2,528 entries: every key of the other catalogs that the code looks up. Signed and notarized macOS builds, signed Windows installers (x64, x86, ARM64), AppImage, deb, rpm, Flatpak and FreeBSD packages. #307 (bounded large-PDF memory): shared resource indexes and parser metadata, lazy inspection, bounded caches; a 9,156-page file inspects in ≈ 1.8 s at ≈ 500 MiB instead of exceeding 10 GiB. Edits let go of the previous working file before writing the next (a 1 GiB file peaks at two copies while editing, not three; gap 13). Shortcut display uses localized modifier/key names across menus, toolbar, palette, Help and tooltips (#496). Lithuanian adds a 2,578-entry catalog and date names, reviewed by a native-speaking contributor. Norwegian Bokmål adds a catalog and date names (terminology reviewed by a native speaker). Validated candidate (macOS raster probe; Windows runtime unverified): the Windows policy changes only embedded JetBrains Mono; horizontal alpha-edge energy per ink improves 2.78%, 3.87% and 1.59% at 100%, 125% and 150%, and is down 0.79% at 200%. Inter is pixel-identical; layout hashes, glyph coverage and the 8 MiB atlas are unchanged. Timing and RSS ranges overlap, with no improvement claimed. Estimates unchanged. Candidate #2383 clamps GPU requests to supported limits while retaining the adapter texture extent; synthetic V3D/downlevel and Windows GPU-required tests pass, but Raspberry Pi startup is unverified. Missing: end-to-end RTL workflow qualification, a Chinese web UI face, Hindi/Indonesian/Korean, file-backed input and global memory budgets, performance budgets, keyboard-only operation Linux/Unix UI fallback fonts also use Fontconfig directories, including Nix store paths, with bounded discovery and the existing candidate allowlist; relative includes and digit-prefixed config filtering have isolated regressions. Missing: end-to-end RTL workflow qualification, a Chinese web UI face, Hindi/Indonesian/Korean, file-backed input and global memory budgets, performance budgets, keyboard-only operation XDG desktops use the configuration base for preferences with non-overwriting migration and original-data preservation (#1395). Traditional Chinese accessibility statuses, rule semantics and Taiwan form/table terms have catalog regressions. Long main-menu lists scroll in short windows (#3373). Missing: end-to-end RTL workflow qualification, a Chinese web UI face, Hindi/Indonesian/Korean, file-backed input and global memory budgets, performance budgets, keyboard-only operation. Candidate #3558: bounded-worker macOS per-file PDFCraft association recovery after desktop open/save/sign; metadata-only watcher handling and upstream #3042 shared-writer preservation; recovery parser limits do not narrow save limits. Native workflow qualified on macOS 27.0.1; other versions and physical SMB/FUSE volumes remain unqualified. Estimates unchanged. Missing: end-to-end RTL workflow qualification, a Chinese web UI face, Hindi/Indonesian/Korean/Vietnamese, file-backed input and global memory budgets, performance budgets, keyboard-only operation. |+| M14 | 1.0 polish: performance, localization, installers | 120–250 | 15% | 80–150 | Done: PhotoCraft's translation system (`i18n/`: TSV catalogs, `tl!`, command-id and plural entries, system-language detection, strict catalog tests); every dialog, panel and notice goes through `tl!`. Catalogs of ≈ 2,000–2,140 entries for Japanese, Simplified and Traditional Chinese, Russian, Bulgarian, German, Spanish, French, Telugu, Hungarian, Ukrainian and Arabic (logical catalog; explicit right-to-left labels and mirrored stock chrome; end-to-end RTL workflows unqualified); the 2,674-entry Brazilian Portuguese catalog covers the current key union; Czech covers the menus. Italian has 2,528 entries: every key of the other catalogs that the code looks up. Signed and notarized macOS builds, signed Windows installers (x64, x86, ARM64), AppImage, deb, rpm, Flatpak and FreeBSD packages. #307 (bounded large-PDF memory): shared resource indexes and parser metadata, lazy inspection, bounded caches; a 9,156-page file inspects in ≈ 1.8 s at ≈ 500 MiB instead of exceeding 10 GiB. Edits let go of the previous working file before writing the next (a 1 GiB file peaks at two copies while editing, not three; gap 13). Shortcut display uses localized modifier/key names across menus, toolbar, palette, Help and tooltips (#496). Lithuanian adds a 2,578-entry catalog and date names, reviewed by a native-speaking contributor. Norwegian Bokmål adds a catalog and date names (terminology reviewed by a native speaker). Validated candidate (macOS raster probe; Windows runtime unverified): the Windows policy changes only embedded JetBrains Mono; horizontal alpha-edge energy per ink improves 2.78%, 3.87% and 1.59% at 100%, 125% and 150%, and is down 0.79% at 200%. Inter is pixel-identical; layout hashes, glyph coverage and the 8 MiB atlas are unchanged. Timing and RSS ranges overlap, with no improvement claimed. Estimates unchanged. Candidate #2383 clamps GPU requests to supported limits while retaining the adapter texture extent; synthetic V3D/downlevel and Windows GPU-required tests pass, but Raspberry Pi startup is unverified. Missing: end-to-end RTL workflow qualification, a Chinese web UI face, Hindi/Indonesian/Korean, file-backed input and global memory budgets, performance budgets, keyboard-only operation Linux/Unix UI fallback fonts also use Fontconfig directories, including Nix store paths, with bounded discovery and the existing candidate allowlist; relative includes and digit-prefixed config filtering have isolated regressions. Missing: end-to-end RTL workflow qualification, a Chinese web UI face, Hindi/Indonesian/Korean, file-backed input and global memory budgets, performance budgets, keyboard-only operation XDG desktops use the configuration base for preferences with non-overwriting migration and original-data preservation (#1395). Traditional Chinese accessibility statuses, rule semantics and Taiwan form/table terms have catalog regressions. Long main-menu lists scroll in short windows (#3373). Missing: end-to-end RTL workflow qualification, a Chinese web UI face, Hindi/Indonesian/Korean, file-backed input and global memory budgets, performance budgets, keyboard-only operation. Candidate #3558: bounded-worker macOS per-file PDFCraft association recovery after desktop open/save/sign; metadata-only watcher handling and upstream #3042 shared-writer preservation; recovery parser limits do not narrow save limits. Native workflow qualified on macOS 27.0.1; other versions and physical SMB/FUSE volumes remain unqualified. Estimates unchanged. Missing: end-to-end RTL workflow qualification, a Chinese web UI face, Hindi/Indonesian/Korean/Vietnamese, file-backed input and global memory budgets, performance budgets, keyboard-only operation. Initial [English/German user guide](usage/usage.md) and default shortcut inventory added; advanced handbook coverage remains open. | | M13 | Automation (MCP, Action Wizard, CLI) + AI providers | 60–120 | 45% | 25–45 | Done: MCP resources (document info, text, page images); headless tool table (123 tools incl. signing, optimizing, initial view, links, stamps, data exchange, comment review, forms authoring and scripts, redaction, sanitize, print, add content), opt-in MCP server over stdio, CLI `run`/`tools` (closed stdout pipes exit cleanly), UI control channel with drag. Missing: Action Wizard, AI providers | | | **Total** | **2,085–3,840** | **≈ 49% ready** | **≈ 770–1,400** | Area view of the same work: [target-app-parity.md](target-app-parity.md#by-feature-area) | @@ -254,6 +254,7 @@ Estimates unchanged. | Date | Change | Summary | |---|---|---|+| 2026-10-27 | trivial | Initial bilingual user guide and default shortcut reference; documentation maintenance rule added; readiness estimates unchanged | | 2026-10-24 | minor | M3, #3970 follow-up: the button release given back after a window move or resize goes before the pointer leaving, so hover doesn't stick. Estimates unchanged. | | 2026-10-23 | minor | M8, #3205 follow-up: phone-pattern redaction includes the +39 country code on labelled Italian geographic numbers with a slash; dates, protocol identifiers and whole-run guards remain. Estimates unchanged. | | 2026-10-23 | minor | M10: Word table cells use the grid columns they span, including cells after a merged cell; synthetic export regression and CLI reproduction. Estimates unchanged. |new file mode 100644@@ -0,0 +1,29 @@+# PdfCraft 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,219 @@+# PdfCraft – 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).++Hier beginnen alltägliche PDF-Abläufe, Tastenkürzel und Verweise auf ausführliche Anleitungen.+Englische UI-Bezeichnungen bleiben erhalten, damit die Befehle in Menüs oder der Befehlspalette+auffindbar sind, auch wenn die Oberfläche eine andere Sprache verwendet. Abgeglichen mit Quellstand+[1dd2737](https://github.com/storytold/pdfcraft/tree/1dd2737b47a9c1c9562f0af563053d1bf510e4bf)+am 27.10.2026. Eine heruntergeladene Version kann davon abweichen.++## Inhalt++- [Öffnen, speichern und Werkzeuge finden](#öffnen-speichern-und-werkzeuge-finden)+- [Lesen, suchen und kopieren](#lesen-suchen-und-kopieren)+- [Seiten ordnen, zusammenführen und teilen](#seiten-ordnen-zusammenführen-und-teilen)+- [Kommentare, Formulare und Bearbeitung](#kommentare-formulare-und-bearbeitung)+- [Weitere Werkzeuge und Ausgabe](#weitere-werkzeuge-und-ausgabe)+- [Tastenkürzelreferenz](#tastenkürzelreferenz)+- [Ansichts- und Kontextsteuerung](#ansichts--und-kontextsteuerung)+- [Einstellungen, Grenzen und weitere Hilfe](#einstellungen-grenzen-und-weitere-hilfe)++## Öffnen, speichern und Werkzeuge finden++1. Unter **File › Open…** eine PDF auswählen oder auf Home eine zuletzt verwendete Datei öffnen.+ Ein verlangtes Öffnungspasswort eingeben. Vom Autor gesetzte Beschränkungen können Kopieren,+ Drucken oder Bearbeiten deaktivieren; **File › Security properties…** zeigt die Berechtigungen.+2. Eine Aufgabe unter **All tools** wählen oder mit **Ctrl+K** (**Cmd+K** unter macOS) einen Befehl+ suchen. Die Palette akzeptiert englische und übersetzte Namen sowie Befehls-IDs. Ein als noch in+ Entwicklung markiertes Werkzeug ist kein abgeschlossener Arbeitsablauf.+3. Änderungen mit **File › Save** speichern. **Save as…** erstellt eine separate Ausgabedatei.+ Ungespeicherte Tabs zeigen einen Punkt; beim Schließen wird nach ungespeicherten Änderungen gefragt.+ Nach einem unerwarteten Ende wird Wiederherstellung angeboten.++Installation, Downloads und Bauen aus dem Quellcode stehen im [README](../../README.md).++## Lesen, suchen und kopieren++Über das Seitenzahlfeld, Seitenminiaturen oder den Bookmarks-Bereich navigieren. Die Suche nach+Lesezeichentiteln findet auch verschachtelte Einträge. Unter **View › Page display** Einzel-/Doppelseite+und kontinuierliches Scrollen wählen. Für einen durchgehenden Streifen Single page wählen,+Continuous scrolling aktivieren und Show gaps between pages deaktivieren. Das entfernt Abstände+der Ansicht, nicht weiße PDF-Seitenränder. [Seitenanzeige](../page-display.md) erklärt Beispiele und Vorgaben.++Mit **Ctrl+F / Cmd+F** einen Suchtext eingeben und mit **Ctrl+G / Cmd+G** bzw. dem Kürzel für den+vorherigen Treffer wechseln. **Advanced search…** öffnet die erweiterte Suchoberfläche.+Das Auswahlwerkzeug (**V**) wählen, über Text ziehen und mit **Ctrl+C / Cmd+C** extrahierten Text+kopieren. Ein Doppelklick wählt ein Wort. Kopieren hängt von PDF-Berechtigungen und vorhandenem+Text ab; eine reine Bildseite benötigt zuerst **Scan & OCR**, damit Wörter such- und kopierbar sind.+**Edit › Column select** bzw. Alt/Option-Ziehen mit dem Auswahlwerkzeug begrenzt die Auswahl auf ein Rechteck.++Mit dem Handwerkzeug (**H**) verschieben oder beim Ziehen vorübergehend Space halten.+**File › Word count…** zählt das Dokument oder die aktuelle Seite; die [Wortzählanleitung](../word-count.md)+erklärt Ausschlüsse und Scans. Beim Kopieren von PDF-Text ist keine Übernahme vollständiger+Textverarbeitungsformatierung zugesichert.++## Seiten ordnen, zusammenführen und teilen++1. **Pages › Organize pages** öffnet die Seitenübersicht.+2. Eine Seite wählen, mit Ctrl-Klick/Cmd-Klick einzelne Seiten ergänzen oder mit Shift-Klick einen Bereich.+3. Über die Seitensteuerung die Auswahl drehen, löschen, einfügen oder verschieben. **Delete** entfernt+ ausgewählte Seiten; **Ctrl+A / Cmd+A** wählt alle Seiten, wenn die Übersicht die Tastatureingabe hat.+4. Die neue Reihenfolge prüfen und speichern. **Undo** macht eine Bearbeitung rückgängig, **Redo** stellt sie wieder her.++**File › Combine files…** verbindet PDFs zu einem Dokument. **Extract** kopiert ausgewählte Seiten+in ein anderes Dokument; **Split** teilt nach Seitenanzahl oder Trennstellen. In den jeweiligen+Datei-/Ausgabeoptionen den Speicherort wählen. Vorhandene Kommandozeilenrezepte stehen unter+[CLI-Stapelverarbeitung](../cli-batch.md).++## Kommentare, Formulare und Bearbeitung++| Aufgabe | Schritte / Einstieg | Ergebnis und Grenzen |+|---|---|---|+| PDF kommentieren | **Add a sticky note** oder ein Markierungswerkzeug in der Palette suchen, auf der Seite klicken/ziehen und **Comments panel** prüfen | Erstellt Anmerkungen; schreibt den ursprünglichen Text nicht um |+| Vorhandenes Formular ausfüllen | Textfelder, Kontrollkästchen oder Listen anklicken; Werte im **Form fields panel** prüfen und speichern | Benötigt ausfüllbare Felder und entsprechende Berechtigung |+| Formularfelder erstellen | **Prepare a form**, dann ein Feldwerkzeug oder **Detect form fields** wählen; Eigenschaften und Tab-Reihenfolge prüfen | Erstellt interaktive Felder; erkannte Felder vor der Weitergabe kontrollieren |+| Flaches Formular beschriften | **Fill & Sign: add text** suchen und Text platzieren | Erstellt eine sichtbare Anmerkung statt eines interaktiven Felds |+| Vorhandenen Text bearbeiten | **Edit a PDF › Edit text & images**, dann Textbereich anklicken und bearbeiten | Schrift-/Zeichenverfügbarkeit und PDF-Struktur können begrenzen; siehe [Textbearbeitung](../editing-existing-text.md) |+| Abbildung verschieben/vergrößern | In **Edit text & images** die Abbildung auswählen, sie oder eine Ecke ziehen; zum Drehen das Kontextmenü verwenden | Abbildungen können gruppierte Grafiken sein; siehe [Bildbearbeitung und Grenzen](../editing-images.md) |+| Mehrere Objekte verschieben | In **Edit text & images** mit Modifikatortaste anklicken oder Auswahlrechteck ziehen, dann die Gruppe verschieben | Jeweils auf einer Seite; siehe [Mehrfachauswahl](../editing-multiple-objects.md) |++Nach der Bearbeitung speichern. Soll die Quelldatei erhalten bleiben, zuerst **Save as…** wählen.++## Weitere Werkzeuge und Ausgabe++Die Palette bietet diese Einstiege. Den Optionen des jeweiligen Dialogs folgen und die Ausgabe+prüfen; die Übersicht verspricht keine vollständige Kompatibilität mit jeder PDF.++| Aufgabe | Einstieg und nächster Schritt |+|---|---|+| Scan erkennen | **Recognize text…** in Scan & OCR; Seiten/Optionen wählen, Erkennung starten und den suchbaren Text prüfen |+| Vertraulichen Seiteninhalt entfernen | Mit **Redact text and images** markieren, danach **Apply redactions…** ausführen; Markierungen allein entfernen keinen Inhalt. Gespeichertes Ergebnis prüfen |+| Verborgene Informationen entfernen | **Remove hidden information…** oder **Sanitize document…**; vor dem Anwenden prüfen, was entfernt wird |+| Passwortschutz | **Protect using password…**; Schutzoptionen festlegen und speichern, danach **Security properties…** prüfen |+| Sichtbare Unterschrift/Initialen | **Fill & Sign: sign** bzw. **Fill & Sign: initials** platzieren; das unterscheidet sich von einer digitalen Signatur mit Zertifikat |+| Digitale Signaturen | **Digitally sign**, **Signatures panel**, **Validate all signatures**; dem Zertifikatsablauf folgen und den gemeldeten Prüfstatus beachten |+| Barrierefreiheit | **Check for accessibility…** starten, Bericht und passende Werkzeuge für Tags/Alternativtexte prüfen |+| Export | Unter **File** stehen Bild-, Text-, Word-, PowerPoint-, HTML- und RTF-Export; Ziel wählen und Wiedergabetreue prüfen |+| Drucken | **File › Print…**; Seiten und Druckereinstellungen wählen, dann drucken (Desktop) |+| Dateigröße verringern | **File › Reduce file size…** oder **Optimize PDF…**; Optionen wählen und die entstandene Kopie prüfen |++Umgesetzter Umfang und Einschränkungen stehen in der [Formatreferenz](../file-format-parity.md)+und den [bekannten Lücken](../gaps.md). Office-Konvertierungen, erweiterte Signaturen und+Standardkonformitätsabläufe sind unvollständig; ein Menüeintrag garantiert keine professionelle Funktionsparität.++## Tastenkürzelreferenz++Die Tabelle enthält alle **25 Standardkürzel** aus dem+[Befehlsverzeichnis](../../crates/engine/src/commands.rs). Weitere Ansichts-/Werkzeugtasten folgen danach.+**Ctrl** bedeutet **Strg**, **Shift** bedeutet **Umschalt**, **Cmd** bedeutet Command (⌘).+Alt heißt auf macOS Option (⌥). **Delete** bedeutet **Entf**, **Home/End** bedeutet **Pos1/Ende**,+**PageUp/PageDown** bedeutet **Bild auf/ab**, **Space** bedeutet **Leertaste**. Schrägstriche trennen+Alternativen. Funktionstasten können Fn benötigen. Die Plattformspalten gelten für native Builds;+Browser oder Betriebssystem können Tasten abfangen, Satzzeichen hängen vom Tastaturlayout ab.++Die meisten Befehlskürzel sind außerhalb der Textbearbeitung nutzbar; Undo/Redo wirken in einem+fokussierten Texteditor auf dessen Text statt auf das Dokument. Modale Dialoge verarbeiten ihre+eigenen Tasten. Deaktivierte Befehle benötigen weiterhin das passende Dokument, eine Auswahl oder+Berechtigungen. **Help › Keyboard shortcuts** öffnet die Referenz in der Anwendung; dieser Dialog+zeigt Belegungen an und dient nicht zum Zuweisen eigener Kürzel.++| Befehl / Bedeutung | Windows / Linux / BSD | macOS |+|---|---|---|+| Open… — Öffnen | `Ctrl+O` | `Cmd+O` |+| Save — Speichern | `Ctrl+S` | `Cmd+S` |+| Save as… — Speichern unter | `Ctrl+Shift+S` | `Cmd+Shift+S` |+| Close file — Datei schließen | `Ctrl+W` | `Cmd+W` |+| Close all — Alle Dateien schließen | `Ctrl+Shift+W` | `Cmd+Shift+W` |+| Print… — Drucken | `Ctrl+P` | `Cmd+P` |+| Document properties… — Dokumenteigenschaften | `Ctrl+D` | `Cmd+D` |+| Undo — Rückgängig | `Ctrl+Z` | `Cmd+Z` |+| Redo — Wiederherstellen | `Ctrl+Shift+Z` | `Cmd+Shift+Z` |+| Find… — Suchen | `Ctrl+F` | `Cmd+F` |+| Advanced search… — Erweiterte Suche | `Ctrl+Shift+F` | `Cmd+Shift+F` |+| Find tools and commands… — Werkzeuge und Befehle suchen | `Ctrl+K` | `Cmd+K` |+| Fit visible — Sichtbaren Seiteninhalt einpassen | `Ctrl+3` | `Cmd+3` |+| Full screen mode — Vollbildmodus | `Ctrl+L` | `Cmd+L` |+| Read mode — Lesemodus | `Ctrl+H` | `Cmd+Ctrl+H` |+| Next tab — Nächster Tab | `Ctrl+Tab` | `Ctrl+Tab` |+| Previous tab — Vorheriger Tab | `Ctrl+Shift+Tab` | `Ctrl+Shift+Tab` |+| Previous view — Vorherige Ansicht | `Ctrl+[` | `Cmd+[` |+| Next view — Nächste Ansicht | `Ctrl+]` | `Cmd+]` |+| Go to page… — Gehe zu Seite | `Ctrl+Shift+N` | `Cmd+Shift+N` |+| Show or hide the side panel — Seitenbereich anzeigen/ausblenden | `F4` | `F4` |+| Show or hide the Tools panel — Werkzeugbereich anzeigen/ausblenden | `Shift+F4` | `Shift+F4` |+| Preferences… — Einstellungen | `Ctrl+,` | `Cmd+,` |+| JavaScript console… — JavaScript-Konsole | `Ctrl+J` | `Cmd+J` |+| New bookmark — Neues Lesezeichen | `Ctrl+B` | `Cmd+B` |++## Ansichts- und Kontextsteuerung++Hier bedeutet **Mod** Ctrl auf Windows/Linux/BSD und Cmd auf macOS. Vor Ansichtskürzeln ins+Dokument klicken; Textfelder, Formularfelder, Palette oder Dialoge können die Eingabe zuerst verarbeiten.++| Kontext | Tasten / Geste | Wirkung |+|---|---|---|+| Suche | Mod+G / Mod+Shift+G | Nächster/vorheriger Treffer, auch mit Fokus im Suchfeld |+| Textauswahl | Mod+C; Doppelklick | Kopiert ausgewählten Text; wählt ein Wort |+| Auswahl | Mod+A | Wählt Dokumenttext, Seiten in Organize oder Felder in Prepare a form; ein fokussierter Texteditor wählt seinen eigenen Text |+| Ausgewähltes Bild | Mod+C | Kopiert bei Berechtigung das Bild als Datei; im Web Save Image As verwenden |+| Desktop-Dokument mit Bild in Zwischenablage | Mod+V | Fügt das Bild auf der aktuellen Seite ein; Textfelder, Organize und Prepare a form haben eigenes Einfügeverhalten |+| Ansicht | Mod+1 / Mod+0 / Mod+2 | Originalgröße / ganze Seite / Seitenbreite |+| Ansicht | Mod+Plus oder Mod+Equals / Mod+Minus | Vergrößert/verkleinert; in Organize ändert das die Miniaturgröße |+| Organize pages | Mod+0 | Setzt den Miniaturzoom zurück |+| Ansicht | Mod+Shift+Plus oder Mod+Shift+Equals / Mod+Shift+Minus | Dreht die Ansicht im/gegen den Uhrzeigersinn; das ist eine andere Funktion als das Drehen gespeicherter Dokumentseiten |+| Ansicht | Pinch-Geste; Ctrl-Scrollen | Ändert den Zoom |+| Navigation | Home / End | Erste/letzte Seite |+| Navigation | Left / Right; Mod+PageUp / Mod+PageDown | Vorherige/nächste Seite |+| Navigation | PageUp / PageDown | Scrollt in kontinuierlicher Ansicht um einen Bildschirm, sonst Seitenwechsel |+| Navigation | Up / Down | Scrollt um eine Zeile; kann am Rand einer Einzelseite weiterblättern |+| Vollbildpräsentation | Space oder Enter / Backspace | Nächste/vorherige Seite |+| Freie Dokumentfläche | V / H; Space halten | Auswahl-/Handwerkzeug; vorübergehendes Verschieben bis Space losgelassen wird |+| Ausgewählte Seiten in Organize | Delete | Löscht ausgewählte Seiten |+| Ausgewählte Objekte / Anmerkungen / vorbereitete Felder | Pfeiltasten | Verschiebt die Auswahl, wenn das Werkzeug die Tasten verarbeitet, statt Seiten zu wechseln |+| Edit text & images | Shift/Ctrl/Cmd-Klick; durch leeren Bereich ziehen | Schaltet Objekte in der Auswahl um; zieht ein Auswahlrechteck |+| Auswahl / Suche / Vollbild | Escape | Hebt den nächsten aktiven Kontext auf bzw. bricht ihn ab; kann Suche oder Vollbild beenden |++Quellen: [Ansichtsnavigation](../../crates/ui-egui/src/canvas/navigation.rs),+[Tastaturverarbeitung](../../crates/ui-egui/src/app/keys.rs),+[Kürzelreferenz der Anwendung](../../crates/ui-egui/src/dialogs.rs),+[Zwischenablage](../../crates/ui-egui/src/app/clipboard.rs),+[Bildkopie](../../crates/ui-egui/src/canvas/image_pick.rs),+[Einfügen von Bildern](../../crates/ui-egui/src/tools/content_ui.rs),+[Mehrfachauswahl](../editing-multiple-objects.md).++## Einstellungen, Grenzen und weitere Hilfe++**Edit › Preferences…** (Ctrl+, / Cmd+,) enthält Anwendungseinstellungen wie Oberflächensprache+und Vorgaben für Dokument/Ansicht. Der Werkzeugbereich kann links oder rechts stehen; seine innere+Kante lässt sich zum Ändern der Breite ziehen. **View › Reset side panels** stellt die Standardanordnung+wieder her. F4 schaltet den Seitenbereich um, Shift+F4 den Werkzeugbereich.++Desktop und Web unterscheiden sich: Der geprüfte Web-Build bietet weder Drucken noch Wiederöffnen+eines geschlossenen dateibasierten Tabs oder Anzeigen seiner Datei im System-Dateimanager.+Bilddateien lassen sich nicht in die Systemzwischenablage kopieren; dafür **Save Image As** nutzen.+Vom Browser abgefangene Kürzel und Zwischenablageberechtigungen können die Bedienung ebenfalls+beeinflussen. Details stehen in den vorhandenen Referenzen:++| Thema | Dokumentation |+|---|---|+| Seitenlayout und Abstände | [Seitenanzeige](../page-display.md) |+| Text, Bilder und Gruppen | [Textbearbeitung](../editing-existing-text.md), [Bilder](../editing-images.md), [Mehrfachauswahl](../editing-multiple-objects.md) |+| Text zählen | [Wortzählung](../word-count.md) |+| Oberflächensprache | [Lokalisierung](../localization.md) |+| Startprobleme | [Windows-Renderer](../windows-renderer-startup.md), [Entwicklung/Logs](../development.md) |+| Automatisierung und Stapelverarbeitung | [CLI-Stapelverarbeitung](../cli-batch.md), [MCP](../mcp.md) |+| Kompatibilität und offene Arbeit | [Dateiformate](../file-format-parity.md), [UI-Abdeckung](../ui-parity.md), [Lücken](../gaps.md), [Roadmap](../roadmap.md) |++Dieses erste Handbuch deckt die Kernabläufe, alle Standardkürzel des Befehlsverzeichnisses und die+oben aufgeführten Ansichts-/Kontextsteuerungen ab. Es ist noch keine vollständige Anleitung für+jedes Werkzeug oder jeden Dialog. Ausführliche Abläufe für Signaturen, Barrierefreiheitskorrekturen,+OCR-Optionen, Optimierung, komplexe Formulare und weitere Dialog-/Werkzeuggesten müssen noch ergänzt+und geprüft werden. Verlinkte Themenseiten bleiben für ihre Details maßgeblich und sind derzeit+überwiegend englisch. Roadmap-Einträge sind Pläne, keine Anleitung für bereits verfügbare Funktionen.++Für Beitragende: Bei sichtbaren Änderungen die englische Anleitung und vorhandene Übersetzungen aktualisieren und relevante Tasten+sowie Links prüfen; siehe [AGENTS.md](../../AGENTS.md#user-documentation).new file mode 100644@@ -0,0 +1,213 @@+# PdfCraft 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).++Start here for everyday PDF workflows, keyboard shortcuts and links to detailed instructions.+English UI labels are retained so commands can be found in the menus or command palette, even if+your interface uses another language. Checked against source revision+[1dd2737](https://github.com/storytold/pdfcraft/tree/1dd2737b47a9c1c9562f0af563053d1bf510e4bf)+on 2026-10-27. A downloaded release may differ.++## Contents++- [Open, save and find tools](#open-save-and-find-tools)+- [Read, search and copy](#read-search-and-copy)+- [Organize, combine and split](#organize-combine-and-split)+- [Comments, forms and editing](#comments-forms-and-editing)+- [More tools and output](#more-tools-and-output)+- [Keyboard reference](#keyboard-reference)+- [View and context controls](#view-and-context-controls)+- [Settings, limitations and further help](#settings-limitations-and-further-help)++## Open, save and find tools++1. Use **File › Open…** to select a PDF, or choose a recent document on Home. Enter the opening+ password when requested. Author-imposed restrictions can disable copying, printing or editing;+ **File › Security properties…** explains the document's permissions.+2. Choose a task in **All tools**, or press **Ctrl+K** (**Cmd+K** on macOS) and search for a command.+ The palette accepts English names, translated names and command IDs. A tool marked as still in+ development is not a completed workflow.+3. Save changes with **File › Save**. Use **Save as…** for a separate output file. Unsaved tabs have+ a dot; closing asks what to do with unsaved changes. Recovery is offered after an unexpected exit.++Installation, available downloads and building from source are in the [README](../../README.md).++## Read, search and copy++Use the page-number field, page thumbnails or Bookmarks panel to navigate. Search bookmark titles+to find nested entries. Under **View › Page display**, choose single-page/two-page layout and+continuous scrolling. For a continuous strip, choose Single page, enable Continuous scrolling and+turn off Show gaps between pages. This removes the viewer's spacing, not white margins in the PDF.+See [page display](../page-display.md) for examples and defaults.++Press **Ctrl+F / Cmd+F**, enter text and step through matches with **Ctrl+G / Cmd+G** or the+previous-match shortcut. **Advanced search…** opens the broader search interface.+Choose the Select tool (**V**), drag across text, then **Ctrl+C / Cmd+C** to copy extracted text.+Double-click selects a word. Copying depends on PDF permissions and available text; a page that is+only an image needs **Scan & OCR** before its words can be searched or copied.+**Edit › Column select** (or Alt/Option-drag with the Select tool) restricts selection to a rectangle.++Use the Hand tool (**H**) to pan, or hold Space temporarily while dragging. **File › Word count…**+counts the document or current page; the [word-count guide](../word-count.md) explains exclusions+and scanned pages. Copying PDF text does not imply preservation of a word processor's rich formatting.++## Organize, combine and split++1. Open **Pages › Organize pages** to see the page grid.+2. Select a page, Ctrl-click/Cmd-click to add individual pages, or Shift-click a range.+3. Use the page controls to rotate, delete, insert or move the selection. **Delete** removes the+ selected pages; **Ctrl+A / Cmd+A** selects all pages while the grid owns the keyboard.+4. Review the resulting order and save. **Undo** reverses an edit; **Redo** restores it.++**File › Combine files…** joins PDFs into one document. **Extract** copies selected pages into+another document; **Split** divides a document by page count or split points. Use the resulting+file/output options to choose where the new documents are written. Existing command-line recipes+for these tasks are in [CLI batch operations](../cli-batch.md).++## Comments, forms and editing++| Task | Steps / entry point | Result and limits |+|---|---|---|+| Comment on a PDF | Find **Add a sticky note** or a markup tool in the palette, then click/drag on the page; inspect **Comments panel** | Adds annotations; it does not rewrite the original text |+| Fill an existing form | Click its text fields, checkboxes or lists; use **Form fields panel** to inspect values, then save | Requires fillable fields and the document's fill permission |+| Create form fields | Choose **Prepare a form**, then a field tool or **Detect form fields**; inspect field properties and tab order | Creates interactive fields; inspect detected fields before distributing the PDF |+| Add text to a flat form | Find **Fill & Sign: add text** and place the text on the page | Adds a visible annotation rather than an interactive field |+| Edit existing text | **Edit a PDF › Edit text & images**, then click a text region and edit it | Font/glyph availability and PDF structure can limit edits; follow [editing existing text](../editing-existing-text.md) |+| Move or resize a figure | In **Edit text & images**, select the figure, drag it or a corner; use its context menu for rotation | Some figures are grouped artwork; see [image editing and restrictions](../editing-images.md) |+| Move several objects | In **Edit text & images**, modifier-click objects or draw a selection rectangle, then drag the group | One page at a time; see [multiple-object editing](../editing-multiple-objects.md) |++Save after editing. For a copy that leaves the source file intact, choose **Save as…** first.++## More tools and output++The palette provides these entry points. Follow each dialog's options and review the output;+this overview does not promise full compatibility with every PDF.++| Task | Entry point and next action |+|---|---|+| Recognize a scan | **Recognize text…** in Scan & OCR; choose the pages/options, run recognition and inspect the searchable text |+| Remove sensitive page content | Mark with **Redact text and images**, then **Apply redactions…**; marks alone do not remove content. Review the saved result |+| Remove hidden information | **Remove hidden information…** or **Sanitize document…**; inspect what will be removed before applying |+| Password protection | **Protect using password…**; set the dialog's protection options and save. Inspect **Security properties…** afterward |+| Visible signature/initials | **Fill & Sign: sign** or **Fill & Sign: initials**; place the appearance. These are distinct from a certificate-based digital signature |+| Digital signatures | **Digitally sign**, **Signatures panel**, **Validate all signatures**; use the certificate workflow and inspect reported validation status |+| Accessibility | **Check for accessibility…**, then inspect the report and relevant tagging/alternate-text tools |+| Export | **File** provides image, text, Word, PowerPoint, HTML and RTF export commands; choose a destination and inspect fidelity |+| Print | **File › Print…**; choose pages and printer settings, then print (desktop) |+| Reduce size | **File › Reduce file size…** or **Optimize PDF…**; choose options and inspect the resulting copy |++For implemented scope and limitations, use the [file-format reference](../file-format-parity.md)+and [known gaps](../gaps.md). Office conversions, advanced signatures and standards workflows+have incomplete coverage; their presence in a menu is not a guarantee of professional parity.++## Keyboard reference++The table lists all **25 default shortcut entries** from the+[command registry](../../crates/engine/src/commands.rs). Additional view/tool keys follow below.+**Ctrl** means Control, **Cmd** means Command (⌘), and **Shift** is ⇧; Alt is Option (⌥) on macOS.+Slashes separate alternatives. Function keys may require Fn. Native platform columns are shown;+browsers and the operating system may intercept keys, and punctuation depends on keyboard layout.++Most command shortcuts work outside text editing; Undo/Redo act on a focused text editor instead+of the document. Modal dialogs own their keys. Disabled commands still require their document,+selection or permissions. Open **Help › Keyboard shortcuts** for the in-app reference; it is a+reference dialog, not a shortcut-assignment editor.++| Command | Windows / Linux / BSD | macOS |+|---|---|---|+| Open… | `Ctrl+O` | `Cmd+O` |+| Save | `Ctrl+S` | `Cmd+S` |+| Save as… | `Ctrl+Shift+S` | `Cmd+Shift+S` |+| Close file | `Ctrl+W` | `Cmd+W` |+| Close all | `Ctrl+Shift+W` | `Cmd+Shift+W` |+| Print… | `Ctrl+P` | `Cmd+P` |+| Document properties… | `Ctrl+D` | `Cmd+D` |+| Undo | `Ctrl+Z` | `Cmd+Z` |+| Redo | `Ctrl+Shift+Z` | `Cmd+Shift+Z` |+| Find… | `Ctrl+F` | `Cmd+F` |+| Advanced search… | `Ctrl+Shift+F` | `Cmd+Shift+F` |+| Find tools and commands… | `Ctrl+K` | `Cmd+K` |+| Fit visible | `Ctrl+3` | `Cmd+3` |+| Full screen mode | `Ctrl+L` | `Cmd+L` |+| Read mode | `Ctrl+H` | `Cmd+Ctrl+H` |+| Next tab | `Ctrl+Tab` | `Ctrl+Tab` |+| Previous tab | `Ctrl+Shift+Tab` | `Ctrl+Shift+Tab` |+| Previous view | `Ctrl+[` | `Cmd+[` |+| Next view | `Ctrl+]` | `Cmd+]` |+| Go to page… | `Ctrl+Shift+N` | `Cmd+Shift+N` |+| Show or hide the side panel | `F4` | `F4` |+| Show or hide the Tools panel | `Shift+F4` | `Shift+F4` |+| Preferences… | `Ctrl+,` | `Cmd+,` |+| JavaScript console… | `Ctrl+J` | `Cmd+J` |+| New bookmark | `Ctrl+B` | `Cmd+B` |++## View and context controls++In this section **Mod** means Ctrl on Windows/Linux/BSD and Cmd on macOS. Click the document+before using view keys; an active text field, form field, palette or dialog can take precedence.++| Context | Keys / gesture | Effect |+|---|---|---|+| Search | Mod+G / Mod+Shift+G | Next/previous match, including while the Find input has focus |+| Text selection | Mod+C; double-click | Copies selected text; selects a word |+| Selection | Mod+A | Selects document text, pages in Organize, or fields in Prepare a form; a focused text editor selects its own text |+| Selected picture | Mod+C | Copies the picture as a file if permitted; web users need Save Image As |+| Desktop document, clipboard contains an image | Mod+V | Adds the image to the current page; text fields, Organize and Prepare a form have their own paste behavior |+| View | Mod+1 / Mod+0 / Mod+2 | Actual size / fit page / fit width |+| View | Mod+Plus or Mod+Equals / Mod+Minus | Zoom in/out; in Organize this changes thumbnail size instead |+| Organize pages | Mod+0 | Resets thumbnail zoom |+| View | Mod+Shift+Plus or Mod+Shift+Equals / Mod+Shift+Minus | Rotates the view clockwise/counterclockwise; this is distinct from rotating document pages |+| View | Pinch; Ctrl-scroll | Changes zoom |+| Navigation | Home / End | First/last page |+| Navigation | Left / Right; Mod+PageUp / Mod+PageDown | Previous/next page |+| Navigation | PageUp / PageDown | Scrolls by a screen in continuous view; changes page in noncontinuous view |+| Navigation | Up / Down | Scrolls by a line; can turn a single page at its edge |+| Full-screen presentation | Space or Enter / Backspace | Next/previous page |+| Free document canvas | V / H; hold Space | Select / Hand tool; temporarily pan until Space is released |+| Selected pages in Organize | Delete | Deletes the selected pages |+| Selected objects / annotations / prepared fields | Arrow keys | Nudges the selection when that tool owns the keys, rather than navigating pages |+| Edit text & images | Shift/Ctrl/Cmd-click; drag empty space | Toggles objects in the selection; draws a selection rectangle |+| Selection / search / full screen | Escape | Clears/cancels the nearest active context; can close Find or leave full screen |++Sources: [view navigation](../../crates/ui-egui/src/canvas/navigation.rs),+[app key routing](../../crates/ui-egui/src/app/keys.rs),+[in-app shortcut reference](../../crates/ui-egui/src/dialogs.rs),+[clipboard](../../crates/ui-egui/src/app/clipboard.rs),+[image copying](../../crates/ui-egui/src/canvas/image_pick.rs),+[image paste](../../crates/ui-egui/src/tools/content_ui.rs),+[multiple-object guide](../editing-multiple-objects.md).++## Settings, limitations and further help++**Edit › Preferences…** (Ctrl+, / Cmd+,) controls application settings, including interface+language and default document/view options. The Tools panel can sit on either side; drag a panel's+inner edge to resize it. **View › Reset side panels** restores the default arrangement.+F4 toggles the side panel, Shift+F4 the Tools panel.++Desktop and web differ: the checked web build does not provide printing, reopening a closed+file-backed tab or revealing its file in the system file manager. It cannot put an image file+on the system clipboard; use **Save Image As**. Browser shortcut interception and clipboard+permissions can also affect operation. Consult the existing references for detailed support:++| Topic | Documentation |+|---|---|+| Page layouts and spacing | [Page display](../page-display.md) |+| Text, images and groups | [Text editing](../editing-existing-text.md), [images](../editing-images.md), [multiple objects](../editing-multiple-objects.md) |+| Counting text | [Word count](../word-count.md) |+| Interface language | [Localization](../localization.md) |+| Startup problems | [Windows renderer startup](../windows-renderer-startup.md), [development/logs](../development.md) |+| Automation and batch work | [CLI batch](../cli-batch.md), [MCP](../mcp.md) |+| Compatibility and unfinished work | [File formats](../file-format-parity.md), [UI coverage](../ui-parity.md), [gaps](../gaps.md), [roadmap](../roadmap.md) |++This initial handbook covers core workflows, all default registry shortcuts and the view/context+controls listed above. It is not yet an exhaustive tutorial for every tool or dialog. Detailed+walkthroughs for signatures, accessibility remediation, OCR options, optimization, advanced forms+and the remaining dialog/tool gestures still need to be expanded and checked. Existing linked+pages remain authoritative for their details and are currently mostly English. Roadmap entries+are plans, not instructions for features already available.++Contributors: update the English guide and existing translations with user-facing changes and verify the relevant+keys and links; see [AGENTS.md](../../AGENTS.md#user-documentation).