Skip to content

Commit d2654b0

Browse files
authored
Add Shortcut Details to Documentation (sugarlabs#4439)
* dark mode bug set pitch preview changes * grid option disappears when click expand btn * changes * Added keyboard shortcuts Docs * added mac keys * Update README.md * changes
1 parent b9c16a0 commit d2654b0

File tree

1 file changed

+49
-16
lines changed

1 file changed

+49
-16
lines changed

documentation/README.md

Lines changed: 49 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -233,21 +233,54 @@ For further details on how to use these toolbars effectively, you can refer to t
233233
[Back to Table of Contents](#table-of-contents)
234234

235235

236-
There are several keyboard shortcuts:
237-
238-
_PgUp_ and _PgDn_ will scroll the screen vertically. This is useful for
239-
creating long stacks of blocks.
240-
241-
You can use the arrow keys to move blocks and the _Delete_ key to
242-
remove an individual block from a stack.
243-
244-
_Enter_ is the equivalent of clicking the _Run_ button.
245-
246-
_Alt-C_ is copy and _Alt-V_ is paste. Be sure that the cursor is
247-
highlighting the block(s) you want to copy.
248-
249-
You can directly type notes using _d_ for `Do`, _r_ for `Re`, _m_ for
250-
`Mi`, _f_ for `Fa`, _s_ for `Sol`, _l_ for `La`, and _t_ for `Ti`.
236+
# Keyboard Shortcuts Guide
237+
238+
## General Shortcuts
239+
240+
| Key Combination (Windows) | Key Combination (Mac) | Description |
241+
|----------------------------|-----------------------------|---------------------------------------------------------|
242+
| `Alt + B` | `Option + B` | Save the current block artwork. |
243+
| `Alt + C` | `Option + C` | Copy the selected blocks. |
244+
| `Alt + E` | `Option + E` | Clear all elements. |
245+
| `Alt + R` or `Enter` | `Option + R` or `Return` | Play the project. Activates the play button. |
246+
| `Alt + S` | `Option + S` | Stop all running processes (e.g., turtles). |
247+
| `Alt + H` | `Option + H` | Save help blocks - Generate and save artwork for each block.|
248+
| `Ctrl + V` | `Command + V` | Open the paste box. |
249+
| `Space` | `Space` | Toggle the zoom level of the stage. |
250+
| `ESC` | `ESC` | Hide widgets or stop ongoing processes. |
251+
252+
## Navigation Shortcuts
253+
254+
| Key (Windows) | Key (Mac) | Description |
255+
|---------------------|--------------------------------------|---------------------------------------------------------|
256+
| `HOME` | `Fn + Left Arrow` | Jump to the home position for blocks or palettes. |
257+
| `END` | `Fn + Right Arrow` | Scroll to the bottom of the page. |
258+
| `PAGE UP` | `Fn + Up Arrow` | Scroll up by half the screen height. |
259+
| `PAGE DOWN` | `Fn + Down Arrow` | Scroll down by half the screen height. |
260+
| `Arrow Up` | `Arrow Up` | Move the active block or scroll up. |
261+
| `Arrow Down` | `Arrow Down` | Move the active block or scroll down. |
262+
| `Arrow Left` | `Arrow Left` | Move the active block or scroll left (In Horizontal mode).|
263+
| `Arrow Right` | `Arrow Right` | Move the active block or scroll right (In Horizontal mode).|
264+
265+
## Music Note Creation
266+
267+
| Key (Windows) | Key (Mac) | Description |
268+
|---------------|---------------|---------------------------|
269+
| `D` | `D` | Create a "Do" note. |
270+
| `R` | `R` | Create a "Re" note. |
271+
| `M` | `M` | Create a "Mi" note. |
272+
| `F` | `F` | Create a "Fa" note. |
273+
| `S` | `S` | Create a "Sol" note. |
274+
| `L` | `L` | Create a "La" note. |
275+
| `T` | `T` | Create a "Ti" note. |
276+
277+
## Special Block Manipulations
278+
279+
| Key (Windows) | Key (Mac) | Description |
280+
|----------------------------|-----------------------|-------------------------------------------------------------|
281+
| `/` | `/` | Scroll blocks container to the right (In Horizontal mode). |
282+
| `\` | `\` | Scroll blocks container to the left (In Horizontal mode). |
283+
| `DEL` | `Delete` | Extract the selected block. |
251284

252285

253286
## 5. Block Palettes
@@ -663,4 +696,4 @@ can download.
663696

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

666-
[Back to Table of Contents](#table-of-contents)
699+
[Back to Table of Contents](#table-of-contents)

0 commit comments

Comments
 (0)