diff --git a/documentation/ghkeyboard.md b/documentation/ghkeyboard.md new file mode 100644 index 00000000..66c0cdd9 --- /dev/null +++ b/documentation/ghkeyboard.md @@ -0,0 +1,199 @@ +--- +title: Keyboard shortcuts +intro: 'Nearly every page on {% data variables.product.product_name %} has a keyboard shortcut to perform actions faster.' +redirect_from: + - /articles/using-keyboard-shortcuts/ + - /categories/75/articles/ + - /categories/keyboard-shortcuts/ + - /articles/keyboard-shortcuts +versions: + free-pro-team: '*' + enterprise-server: '*' + github-ae: '*' +--- + + +### About keyboard shortcuts + +Typing ? in {% data variables.product.product_name %} brings up a dialog box that lists the keyboard shortcuts available for that page. You can use these keyboard shortcuts to perform actions across the site without using your mouse to navigate. + +Below is a list of some of the available keyboard shortcuts. + +### Site wide shortcuts + +| Keyboard shortcut | Description +|-----------|------------ +|s or / | Focus the search bar. For more information, see "[About searching on {% data variables.product.company_short %}](/articles/about-searching-on-github)." +|g n | Go to your notifications. For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %}"[About notifications](/github/managing-subscriptions-and-notifications-on-github/about-notifications){% else %}"[About notifications](/github/receiving-notifications-about-activity-on-github/about-notifications){% endif %}." +|esc | When focused on a user, issue, or pull request hovercard, closes the hovercard and refocuses on the element the hovercard is in + +### Repositories + +| Keyboard shortcut | Description +|-----------|------------ +|g c | Go to the **Code** tab +|g i | Go to the **Issues** tab. For more information, see "[About issues](/articles/about-issues)." +|g p | Go to the **Pull requests** tab. For more information, see "[About pull requests](/articles/about-pull-requests)."{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +|g a | Go to the **Actions** tab. For more information, see "[About Actions](/actions/getting-started-with-github-actions/about-github-actions)."{% endif %} +|g b | Go to the **Projects** tab. For more information, see "[About project boards](/articles/about-project-boards)." +|g w | Go to the **Wiki** tab. For more information, see "[About wikis](/articles/about-wikis)." + +### Source code editing + +| Keyboard shortcut | Description +|-----------|------------ +|e | Open source code file in the **Edit file** tab +|control f or command f | Start searching in file editor +|control g or command g | Find next +|shift control g or shift command g | Find previous +|shift control f or command option f | Replace +|shift control r or shift command option f | Replace all +|alt g | Jump to line +|control z or command z | Undo +|control y or command y | Redo +|cmd + shift + p | Toggles between the **Edit file** and **Preview changes** tabs + +For more keyboard shortcuts, see the [CodeMirror documentation](https://codemirror.net/doc/manual.html#commands). + +### Source code browsing + +| Keyboard shortcut | Description +|-----------|------------ +|t | Activates the file finder +|l | Jump to a line in your code +|w | Switch to a new branch or tag +|y | Expand a URL to its canonical form. For more information, see "[Getting permanent links to files](/articles/getting-permanent-links-to-files)." +|i | Show or hide comments on diffs. For more information, see "[Commenting on the diff of a pull request](/articles/commenting-on-the-diff-of-a-pull-request)." +|a | Show or hide annotations on diffs +|b | Open blame view. For more information, see "[Tracing changes in a file](/articles/tracing-changes-in-a-file)." + +### Comments + +| Keyboard shortcut | Description +|-----------|------------ +| control b or command b | Inserts Markdown formatting for bolding text +| control i or command i | Inserts Markdown formatting for italicizing text +| control k or command k | Inserts Markdown formatting for creating a link +| control shift p or command shift p| Toggles between the **Write** and **Preview** comment tabs +| control enter | Submits a comment +| control . and then control [saved reply number] | Opens saved replies menu and then autofills comment field with a saved reply. For more information, see "[About saved replies](/articles/about-saved-replies)."{% if currentVersion == "free-pro-team@latest" %} +|control g or command g | Insert a suggestion. For more information, see "[Reviewing proposed changes in a pull request](/articles/reviewing-proposed-changes-in-a-pull-request)." |{% endif %} +| r | Quote the selected text in your reply. For more information, see "[Basic writing and formatting syntax](/articles/basic-writing-and-formatting-syntax#quoting-text)." | + +### Issue and pull request lists + +| Keyboard shortcut | Description +|-----------|------------ +|c | Create an issue +| control / or command / | Focus your cursor on the issues or pull requests search bar. For more information, see "[Using search to filter issues and pull requests](/articles/using-search-to-filter-issues-and-pull-requests)."|| +|u | Filter by author +|l | Filter by or edit labels. For more information, see "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)." +| alt and click | While filtering by labels, exclude labels. For more information, see "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)." +|m | Filter by or edit milestones. For more information, see "[Filtering issues and pull requests by milestone](/articles/filtering-issues-and-pull-requests-by-milestone)." +|a | Filter by or edit assignee. For more information, see "[Filtering issues and pull requests by assignees](/articles/filtering-issues-and-pull-requests-by-assignees)." +|o or enter | Open issue + +### Issues and pull requests +| Keyboard shortcut | Description +|-----------|------------ +|q | Request a reviewer. For more information, see "[Requesting a pull request review](/articles/requesting-a-pull-request-review/)." +|m | Set a milestone. For more information, see "[Associating milestones with issues and pull requests](/articles/associating-milestones-with-issues-and-pull-requests/)." +|l | Apply a label. For more information, see "[Applying labels to issues and pull requests](/articles/applying-labels-to-issues-and-pull-requests/)." +|a | Set an assignee. For more information, see "[Assigning issues and pull requests to other {% data variables.product.company_short %} users](/articles/assigning-issues-and-pull-requests-to-other-github-users/)." +|cmd + shift + p or control + shift + p | Toggles between the **Write** and **Preview** tabs + +### Changes in pull requests + +| Keyboard shortcut | Description +|-----------|------------ +|c | Open the list of commits in the pull request +|t | Open the list of changed files in the pull request +|j | Move selection down in the list +|k | Move selection up in the list +| cmd + shift + enter | Add a single comment on a pull request diff | +| alt and click | Toggle between collapsing and expanding all outdated review comments in a pull request by holding down `alt` and clicking **Show outdated** or **Hide outdated**.|{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %} +| Click, then shift and click | Comment on multiple lines of a pull request by clicking a line number, holding shift, then clicking another line number. For more information, see "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request#adding-line-comments-to-a-pull-request)."|{% endif %} + +### Project boards + +#### Moving a column + +| Keyboard shortcut | Description +|-----------|------------ +|enter or space | Start moving the focused column +|escape | Cancel the move in progress +|enter | Complete the move in progress +|← or h | Move column to the left +|command + ← or command + h or control + ← or control + h | Move column to the leftmost position +|→ or l | Move column to the right +|command + → or command + l or control + → or control + l | Move column to the rightmost position + +#### Moving a card + +| Keyboard shortcut | Description +|-----------|------------ +|enter or space | Start moving the focused card +|escape | Cancel the move in progress +|enter | Complete the move in progress +|↓ or j | Move card down +|command + ↓ or command + j or control + ↓ or control + j | Move card to the bottom of the column +|↑ or k | Move card up +|command + ↑ or command + k or control + ↑ or control + k | Move card to the top of the column +|← or h | Move card to the bottom of the column on the left +|shift + ← or shift + h | Move card to the top of the column on the left +|command + ← or command + h or control + ← or control + h | Move card to the bottom of the leftmost column +|command + shift + ← or command + shift + h or control + shift + ← or control + shift + h | Move card to the top of the leftmost column +|→ | Move card to the bottom of the column on the right +|shift + → or shift + l | Move card to the top of the column on the right +|command + → or command + l or control + → or control + l | Move card to the bottom of the rightmost column +|command + shift + → or command + shift + l or control + shift + → or control + shift + l | Move card to the bottom of the rightmost column + +#### Previewing a card + +| Keyboard shortcut | Description +|-----------|------------ +|esc | Close the card preview pane + +{% if currentVersion == "free-pro-team@latest" %} +### {% data variables.product.prodname_actions %} + +| Keyboard shortcut | Description +|-----------|------------ +|command + space or control + space | In the workflow editor, get suggestions for your workflow file. +|g f | Go to the workflow file +|shift + t or T | Toggle timestamps in logs +|shift + f or F | Toggle full-screen logs +|esc | Exit full-screen logs + +{% endif %} + +### Notifications + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %} +| Keyboard shortcut | Description +|-----------|------------ +|e | Mark as done +| shift + u| Mark as unread +| shift + i| Mark as read +| shift + m | Unsubscribe + +{% else %} + +| Keyboard shortcut | Description +|-----------|------------ +|e or I or y | Mark as read +|shift + m | Mute thread +{% endif %} + +### Network graph + +| Keyboard shortcut | Description +|-----------|------------ +|← or h | Scroll left +|→ or l | Scroll right +|↑ or k | Scroll up +|↓ or j | Scroll down +|shift + ← or shift + h | Scroll all the way left +|shift + → or shift + l | Scroll all the way right +|shift + ↑ or shift + k | Scroll all the way up +|shift + ↓ or shift + j | Scroll all the way down diff --git a/pages/Keyboard.md b/pages/Keyboard.md new file mode 100644 index 00000000..3b462b94 --- /dev/null +++ b/pages/Keyboard.md @@ -0,0 +1,6 @@ +# ⌨ iPhone x Bluetooth Keyboard: The Definitive Guide + +![iPhone 12 Pro Max and Magic Keyboard](https://i.snap.as/DwWLDmo1.jpeg) + +## Announcing a project I shouldn't have to invest my time in. +