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 key cheatsheet to user-doc? #1471

Open
Akuli opened this issue Mar 30, 2024 · 4 comments
Open

add key cheatsheet to user-doc? #1471

Akuli opened this issue Mar 30, 2024 · 4 comments
Labels

Comments

@Akuli
Copy link
Owner

Akuli commented Mar 30, 2024

There was a key cheatsheet in the old Porcupine Wiki, deleted in #1470.

Content of key cheatsheet when it was deleted
Porcupine behaves a lot like other text editing programs, so you can
just [install Porcupine](https://github.com/Akuli/porcupine/#installing-porcupine) and
[[start using it|First Program]]. You can also do handy things to write
things even faster, and that's what this page is all about.

Start by checking if your keyboard has keys labelled Home, End, Page Up,
Page Down and Delete. Sometimes these keys have abbreviated labels on them,
for example, my keyboard's Page Down key is labelled PgDn. If your
keyboard doesn't have all of these keys but you would like to do
something with them, [let me know](https://github.com/Akuli/porcupine/issues/new)
so I can add other key combinations that do the same thing.

## The Cheatsheet

Here's a list of useful key combinations. Don't study this list by
reading it, you'll learn it a lot better if you try these things
yourself. On Mac, use the Command key instead of Control.

[comment]: # (this table has really long lines, fortunately there's no style guide for writing markdown :D)

| Key Combination           | Without Control or Alt            | With Control                                  | With Control and Shift                | With Alt                                          |
|---------------------------|-----------------------------------|-----------------------------------------------|---------------------------------------|---------------------------------------------------|
| Arrow keys left and right | Move one character at a time      | Move word by word                             |                                       |                                                   |
| Arrow keys up and down    | Move to previous or next line     | Move to next empty line                       |                                       |                                                   |
| Enter                     | New line                          | New line, don't auto-indent                   |                                       | New line, with same indentation as prevoius line  |
| Backspace                 | Delete character before cursor    | Delete the word before the cursor             | Delete from line beginning to cursor  |                                                   |
| Del                       | Delete character after cursor     | Delete word after cursor                      | Delete from cursor to line end        |                                                   |
| Home                      | Go to beginning of line           | Go to beginning of the whole file             |                                       |                                                   |
| End                       | Go to end of line                 | Go to end of file                             |                                       |                                                   |
| Page Up                   | Scroll up a screenful at a time   |                                               |                                       |                                                   |
| Page Down                 | Scroll down a screenful           |                                               |                                       |                                                   |

You can see many more key combinations by exploring the menu bar at top.

I have mixed thoughts about this. On the one hand, nobody ever used it. On the other hand, it could be useful for someone who wants to make their editing habits more efficient.

Here are rdbende's thoughts: (taken from #1470)

This looks good to me. Not sure how useful the key cheatsheet actually was, I expect most people use the accelerators shown in the menu anyway.

Although the tabular approach is pretty cool to explain the thinking behind the key combinations chosen.

@Akuli Akuli added the docs label Mar 30, 2024
@ethical-haquer
Copy link
Contributor

Is there still a key cheat-sheet anywhere? I think there should still be one somewhere.

@Akuli
Copy link
Owner Author

Akuli commented Apr 4, 2024

Currently, the only place where you find a cheat sheet is this issue. (Click the little arrow thing. It will expand.)

Feel free to make a PR that adds the key cheatsheet to user-doc folder and updates it :)

@ethical-haquer
Copy link
Contributor

Currently, the only place where you find a cheat sheet is this issue. (Click the little arrow thing. It will expand.)

Feel free to make a PR that adds the key cheatsheet to user-doc folder and updates it :)

👍
I know, I meant other than here though.
By "update" you mean the key-combos have changed?
Is there somewhere in the code to see them?

@Akuli
Copy link
Owner Author

Akuli commented Apr 5, 2024

I don't think they have changed much, but the table seems incomplete. It has many empty cells.

Instead of looking at the code, the best way to figure them out is to just press keys and see what happens. Most of the key bindings in the cheat sheet are the defaults for text widgets, while others are Porcupine-specific.

Also, instead of a key cheatsheet, maybe we should tell users how to experiment and learn that way. For example, if you can move with arrow keys, also try holding down control or shift while pressing arrow keys.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants