Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Shortcut Details to Documentation #4439

Open
wants to merge 9 commits into
base: master
Choose a base branch
from
66 changes: 50 additions & 16 deletions documentation/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -233,21 +233,55 @@ 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 + D` | `Option + D` | Prompt to delete custom macros. |
| `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
Expand Down Expand Up @@ -663,4 +697,4 @@ can download.

![Planet](./planet-4.png)

[Back to Table of Contents](#table-of-contents)
[Back to Table of Contents](#table-of-contents)
Loading