Skip to content

Commit dad4d6f

Browse files
committed
Adjust and smooth out the language
1 parent e39c618 commit dad4d6f

File tree

1 file changed

+32
-27
lines changed

1 file changed

+32
-27
lines changed

docs/getting-started.md

Lines changed: 32 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -7,57 +7,60 @@ M60 is a compact keyboard. It has a keymap composed of multiple layers, which is
77
## Keymap
88

99
As the 60% keyboard lacks a lot of keys such as F1~F12 and arrow keys, <kbd>Fn</kbd> is used to activate a new layer.
10-
When holding <kbd>Fn</kbd> down, the following keys are activated.
10+
11+
By default, holding <kbd>Fn</kbd> down activates the following functions:
1112

1213
![](https://gitee.com/makerdiary/python-keyboard/raw/resource/img/layer1.svg)
1314

14-
+ <kbd>Fn</kbd> + <kbd>M</kbd> triggers No.0 macro
15-
+ <kbd>Fn</kbd> + <kbd>P</kbd> suspends the keyboard when only powered by battery.
16-
+ <kbd>Fn</kbd> + <kbd>B</kbd> enters its bootloader (only for upgrade)
15+
- <kbd>Fn</kbd> + <kbd>M</kbd> triggers No.0 macro
16+
- <kbd>Fn</kbd> + <kbd>P</kbd> suspends the keyboard when only powered by battery.
17+
- <kbd>Fn</kbd> + <kbd>B</kbd> enters its bootloader (only for used for firmware upgrades)
18+
19+
Except for <kbd>Fn</kbd>, any normal key can be used as a Tap-key. A Tap-key is a key that can be used as an ordinary key when tapped, or can be held down to activate alternate functions.
1720

18-
Except <kbd>Fn</kbd>, a normal key can be used as a Tap-key, which is holding a key down to activate an alternate function.
21+
All of the default Tap-keys, including <kbd>D</kbd>, <kbd>B</kbd>, and <kbd>;</kbd> can be [re-configured](configuration.md).
1922

2023
### Using <kbd>B</kbd> to configure Bluetooth and USB
2124

22-
<kbd>B</kbd> is used as a Tap-key to configure Bluetooth and USB. Taping <kbd>B</kbd> outputs `b` (press & release quickly). Holding <kbd>B</kbd> down activates another new layer. With the layer, the following functions are available:
25+
<kbd>B</kbd> is the default Tap-key to configure Bluetooth and USB. Tapping <kbd>B</kbd> (i.e., pressing & releasing it quickly) outputs `b`. Holding <kbd>B</kbd> down activates another the Bluetooth keyboard layer. When the Bluetooth layer is active, the following functions are available:
2326

24-
+ <kbd>B</kbd> + <kbd>Esc</kbd> toggles Bluetooth
25-
+ <kbd>B</kbd> + <kbd>0</kbd> ~ <kbd>9</kbd> changes Bluetooth ID to switch between multiple computers and phones
26-
+ <kbd>B</kbd> + <kbd>U</kbd> toggles USB
27+
- <kbd>B</kbd> + <kbd>Esc</kbd> toggles Bluetooth
28+
- <kbd>B</kbd> + <kbd>0</kbd> ~ <kbd>9</kbd> changes Bluetooth ID to switch between multiple computers and phones
29+
- <kbd>B</kbd> + <kbd>U</kbd> toggles USB
2730

2831
### Using <kbd>D</kbd> for Navigation
2932

30-
<kbd>D</kbd> is also used as a Tap key for navigation functions.
33+
<kbd>D</kbd> is the default Tap-key to activate the navigation functions.
3134

3235
![](https://gitee.com/makerdiary/python-keyboard/raw/master/img/d-for-navigation.png)
3336

34-
+ <kbd>D</kbd> + <kbd>H</kbd> → <kbd>←</kbd>
35-
+ <kbd>D</kbd> + <kbd>J</kbd> → <kbd>↓</kbd>
36-
+ <kbd>D</kbd> + <kbd>K</kbd> → <kbd>↑</kbd>
37-
+ <kbd>D</kbd> + <kbd>L</kbd> → <kbd>→</kbd>
38-
+ <kbd>D</kbd> + <kbd>U</kbd> → <kbd>PgUp</kbd>
39-
+ <kbd>D</kbd> + <kbd>N</kbd> → <kbd>PgDn</kbd>
37+
- <kbd>D</kbd> + <kbd>H</kbd> → <kbd>←</kbd>
38+
- <kbd>D</kbd> + <kbd>J</kbd> → <kbd>↓</kbd>
39+
- <kbd>D</kbd> + <kbd>K</kbd> → <kbd>↑</kbd>
40+
- <kbd>D</kbd> + <kbd>L</kbd> → <kbd>→</kbd>
41+
- <kbd>D</kbd> + <kbd>U</kbd> → <kbd>PgUp</kbd>
42+
- <kbd>D</kbd> + <kbd>N</kbd> → <kbd>PgDn</kbd>
4043

4144
### Using <kbd>;</kbd> as <kbd>Ctrl</kbd>
4245

43-
<kbd>;</kbd> is another type of Tap-key. Taping <kbd>;</kbd> outputs `;`. However, holding <kbd>;</kbd> down outputs `Ctrl` instead of activating a layer.
46+
<kbd>;</kbd> is a different type of Tap-key. Tapping <kbd>;</kbd> outputs `;`. However, holding <kbd>;</kbd> down outputs `Ctrl` instead of activating a layer.
4447

4548
![](https://github.com/xiongyihui/keyboard/raw/master/img/semicolon_as_ctrl.png)
4649

47-
+ <kbd>;</kbd> + <kbd>c</kbd> = <kbd>Ctrl</kbd> + <kbd>c</kbd>
48-
+ <kbd>;</kbd> + <kbd>v</kbd> = <kbd>Ctrl</kbd> + <kbd>v</kbd>
49-
+ <kbd>;</kbd> + <kbd>x</kbd> = <kbd>Ctrl</kbd> + <kbd>x</kbd>
50-
+ <kbd>;</kbd> + <kbd>a</kbd> = <kbd>Ctrl</kbd> + <kbd>a</kbd>
51-
50+
- <kbd>;</kbd> + <kbd>c</kbd> = <kbd>Ctrl</kbd> + <kbd>c</kbd>
51+
- <kbd>;</kbd> + <kbd>v</kbd> = <kbd>Ctrl</kbd> + <kbd>v</kbd>
52+
- <kbd>;</kbd> + <kbd>x</kbd> = <kbd>Ctrl</kbd> + <kbd>x</kbd>
53+
- <kbd>;</kbd> + <kbd>a</kbd> = <kbd>Ctrl</kbd> + <kbd>a</kbd>
5254

5355
## Using Pair-keys
5456

55-
Simultaneously pressing two keys (interval less than 10ms) activates an alternate function.
56-
By default, <kbd>J</kbd> <kbd>K</kbd> are used as a pair-keys. When simultaneously pressing <kbd>J</kbd> and <kbd>K</kbd> in a text editor, it will output a pre-defined string.
57+
Simultaneously pressing two keys (i.e., pressing them in an interval of less than 10ms) activates an alternate function.
58+
59+
Two sets of pair-keys are configured by default, to illustrate how to set up these keys. These include <kbd>J</kbd> <kbd>K</kbd> and <kbd>U</kbd> <kbd>I</kbd>. As shipped, simultaneously pressing <kbd>J</kbd> and <kbd>K</kbd> or <kbd>U</kbd> and <kbd>I</kbd> in a text editor will output a pre-defined string (_e.g._, "You just triggered pair keys #0").
5760

5861
## Setup Bluetooth
5962

60-
First, we press <kbd>B</kbd> + <kbd>1</kbd> to start Bluetooth advertising, and then we will see the blue LED under <kbd>1</kbd> is in breathing mode:
63+
First, press <kbd>B</kbd> + <kbd>1</kbd> to start Bluetooth advertising. You will then see the blue LED under <kbd>1</kbd> enter in "breathing" mode and flash slowly
6164

6265
![](https://gitee.com/makerdiary/python-keyboard/raw/resource/img/ble_broadcast.gif)
6366

@@ -73,8 +76,10 @@ Choose `Bluetooth` in the `Add a device` dialog, then you will see the device `P
7376

7477
<img src="https://gitee.com/makerdiary/python-keyboard/raw/resource/img/windows-add-bluetooth-device-en.png" width="400">
7578

76-
When to connect the keyboard to a second computer, just use <kbd>B</kbd> + <kbd>2</kbd> to start connecting. From <kbd>0</kbd> to <kbd>9</kbd>, the keyboard can connect to 10 bluetooth devices.
79+
In order to connect the keyboard to a second computer, just use <kbd>B</kbd> + <kbd>2</kbd> to start connecting. From <kbd>0</kbd> to <kbd>9</kbd>, the keyboard can connect to 10 bluetooth devices.
7780

7881
## Go further
7982

80-
We hope M60 brings you an idea to make a keyboard more productive. You may have your own thoughts of configuring a keyboard. Follow [the configuring guide](configuration.md) to find what works best for you.
83+
We hope M60 keyboard incites ideas to make a keyboard more productive, all without having to install any third-party software or drivers on your computer.
84+
85+
If you have your own thoughts on how to best configure the keyboard, just follow [the configuring guide](configuration.md) to find what works best for you.

0 commit comments

Comments
 (0)