diff --git a/documentation/README.md b/documentation/README.md index d0772dde26..9778eccef1 100644 --- a/documentation/README.md +++ b/documentation/README.md @@ -233,21 +233,54 @@ For further details on how to use these toolbars effectively, you can refer to t [Back to Table of Contents](#table-of-contents) -There are several keyboard shortcuts: - -_PgUp_ and _PgDn_ will scroll the screen vertically. This is useful for -creating long stacks of blocks. - -You can use the arrow keys to move blocks and the _Delete_ key to -remove an individual block from a stack. - -_Enter_ is the equivalent of clicking the _Run_ button. - -_Alt-C_ is copy and _Alt-V_ is paste. Be sure that the cursor is -highlighting the block(s) you want to copy. - -You can directly type notes using _d_ for `Do`, _r_ for `Re`, _m_ for -`Mi`, _f_ for `Fa`, _s_ for `Sol`, _l_ for `La`, and _t_ for `Ti`. +# Keyboard Shortcuts Guide + +## General Shortcuts + +| Key Combination (Windows) | Key Combination (Mac) | Description | +|----------------------------|-----------------------------|---------------------------------------------------------| +| `Alt + B` | `Option + B` | Save the current block artwork. | +| `Alt + C` | `Option + C` | Copy the selected blocks. | +| `Alt + E` | `Option + E` | Clear all elements. | +| `Alt + R` or `Enter` | `Option + R` or `Return` | Play the project. Activates the play button. | +| `Alt + S` | `Option + S` | Stop all running processes (e.g., turtles). | +| `Alt + H` | `Option + H` | Save help blocks - Generate and save artwork for each block.| +| `Ctrl + V` | `Command + V` | Open the paste box. | +| `Space` | `Space` | Toggle the zoom level of the stage. | +| `ESC` | `ESC` | Hide widgets or stop ongoing processes. | + +## Navigation Shortcuts + +| Key (Windows) | Key (Mac) | Description | +|---------------------|--------------------------------------|---------------------------------------------------------| +| `HOME` | `Fn + Left Arrow` | Jump to the home position for blocks or palettes. | +| `END` | `Fn + Right Arrow` | Scroll to the bottom of the page. | +| `PAGE UP` | `Fn + Up Arrow` | Scroll up by half the screen height. | +| `PAGE DOWN` | `Fn + Down Arrow` | Scroll down by half the screen height. | +| `Arrow Up` | `Arrow Up` | Move the active block or scroll up. | +| `Arrow Down` | `Arrow Down` | Move the active block or scroll down. | +| `Arrow Left` | `Arrow Left` | Move the active block or scroll left (In Horizontal mode).| +| `Arrow Right` | `Arrow Right` | Move the active block or scroll right (In Horizontal mode).| + +## Music Note Creation + +| Key (Windows) | Key (Mac) | Description | +|---------------|---------------|---------------------------| +| `D` | `D` | Create a "Do" note. | +| `R` | `R` | Create a "Re" note. | +| `M` | `M` | Create a "Mi" note. | +| `F` | `F` | Create a "Fa" note. | +| `S` | `S` | Create a "Sol" note. | +| `L` | `L` | Create a "La" note. | +| `T` | `T` | Create a "Ti" note. | + +## Special Block Manipulations + +| Key (Windows) | Key (Mac) | Description | +|----------------------------|-----------------------|-------------------------------------------------------------| +| `/` | `/` | Scroll blocks container to the right (In Horizontal mode). | +| `\` | `\` | Scroll blocks container to the left (In Horizontal mode). | +| `DEL` | `Delete` | Extract the selected block. | ## 5. Block Palettes @@ -663,4 +696,4 @@ can download. ![Planet](./planet-4.png) -[Back to Table of Contents](#table-of-contents) \ No newline at end of file +[Back to Table of Contents](#table-of-contents)