Skip to content

Formatting and phrases #4946

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

Merged
merged 2 commits into from
Apr 12, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions hub/powertoys/awake.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,18 +49,18 @@ To manage the execution of the tool from the system tray, right-click on the Pow

## Command Line Interface (CLI)

PowerToys Awake can also be executed as a standalone application, directly from the PowerToys folder. The following command line arguments can be used when running `PowerToys.Awake.exe` from the terminal or via a `.lnk` shortcut file:
PowerToys Awake can also be executed as a standalone application, directly from the PowerToys folder. The following command line arguments can be used when running _PowerToys.Awake.exe_ from the terminal or via a _.lnk_ shortcut file:

| Argument | Description |
| :---------------- | :---------- |
| `--use-pt-config` | Use the PowerToys configuration file to manage the settings. This assumes that there is a `settings.json` file for Awake, generated by PowerToys, that contains all required runtime information. This includes the Behavior Mode (indefinite or timed), whether screens should be kept on, and what the values for hours and minutes are for a temporary keep-awake.<br/>When this argument is used, all other arguments are ignored. Awake will look for changes in the `settings.json` file to update its state. |
| `--use-pt-config` | Use the PowerToys configuration file to manage the settings. This assumes that there is a _settings.json_ file for Awake, generated by PowerToys, that contains all required runtime information. This includes the Behavior Mode (indefinite or timed), whether screens should be kept on, and what the values for hours and minutes are for a temporary keep-awake.<br/>When this argument is used, all other arguments are ignored. Awake will look for changes in the `settings.json` file to update its state. |
| `--display-on` | Keep displays on or off while the machine is kept awake. Expected values are `true` or `false`. |
| `--time-limit` | Duration, in seconds, during which Awake keeps the computer awake. Can be used in combination with `--display-on`. |
| `--expire-at` | Expiration date and/or time when Awake will turn off and resume the standard power state. Can be used in combination with `--display-on`. |
| `--pid` | Attaches the execution of Awake to a Process ID (PID). When the process with a given PID terminates, Awake terminates as well. |

> [!NOTE]
> The `settings.json` configuration file is located at `%HomePath%\AppData\Local\Microsoft\PowerToys\Awake\`. "Keep awake temporarily" options can be adjusted by modifying the `"customTrayTimes"` value, an array consisting of name and duration (in seconds) to stay awake. For example: `"customTrayTimes":{"8 hours":28800}`.
> The _settings.json_ configuration file is located at `%HomePath%\AppData\Local\Microsoft\PowerToys\Awake\`. "Keep awake temporarily" options can be adjusted by modifying the `"customTrayTimes"` value, an array consisting of name and duration (in seconds) to stay awake. For example: `"customTrayTimes":{"8 hours":28800}`.

In absence of command-line arguments, PowerToys Awake will keep the computer awake indefinitely.

Expand Down
4 changes: 2 additions & 2 deletions hub/powertoys/cmd-not-found.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ A PowerShell 7 module that detects command-line errors and suggests a relevant W

## Install the module

To install the Command Not Found module, navigate to the Command Not Found page in PowerToys settings and select the **Install** button. Once the module installation has completed, PowerShell 7 experimental features needed for the module to function will be enabled:
To install the Command Not Found module, go to the Command Not Found page in PowerToys settings and select **Install**. Once the installation has completed, PowerShell 7 experimental features needed for the module to function will be enabled:

- PSFeedbackProvider
- PSCommandNotFoundSuggestion
Expand All @@ -39,4 +39,4 @@ Import-Module "<powertoys install dir>/WinGetCommandNotFound.psd1"

## Uninstall the module

To uninstall the Command Not Found module, navigate to the Command Not Found page in PowerToys settings and select the **Uninstall** button. Once the module uninstall has completed, the block of commands previously added will be removed from the PowerShell profile file.
To uninstall the Command Not Found module, go to the Command Not Found page in PowerToys settings and select **Uninstall**. Once the uninstallation has completed, the block of commands previously added will be removed from the PowerShell profile file.
26 changes: 13 additions & 13 deletions hub/powertoys/color-picker.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ A system-wide color picking utility for Windows to pick colors from any screen a

### Enabling Color Picker

Enable Color Picker in the **Color Picker** tab in PowerToys Settings.
Enable Color Picker in PowerToys Settings.

### Activating Color Picker

Expand Down Expand Up @@ -50,18 +50,18 @@ The Color Picker editor stores a history of up to 20 picked colors and lets you

The colored bar at the top of the Color Picker editor lets you:

* fine tune your chosen color
* pick a similar color
- fine tune your chosen color
- pick a similar color

To fine tune your chosen color, select the central color in the color bar. The fine-tuning control lets you change the color's **HSV**, **RGB**, and **HEX** values. **Select** adds the new color to the colors history.

To choose a similar color, select one of the segments on the left and right edges of the color bar. The Color Picker editor suggests two lighter shades on the left of the bar, and two darker shades on the right of the bar. Selecting one of these similar colors adds that color to the colors history.
To choose a similar color, select one of the segments on the top and bottom edges of the color bar. Selecting one of these similar colors adds it to the history.

![Color Picker Editor window](../images/pt-colorpicker-editor.gif)

To remove a color from the colors history, right-click a color and select **Remove**.
To remove a color from the history, right-click a color and select **Remove**.

To export the colors history, select and hold (or right-click) a color and select **Export**. You can group the exported values by colors or formats.
To export the colors history, right-click a color and select **Export**. You can group the values by colors or formats.

## Settings

Expand All @@ -70,26 +70,26 @@ Color Picker has the following settings:
| Setting | Description |
| :--- | :--- |
| **Activation shortcut** | The shortcut that activates Color Picker. |
| **Activation behavior** | Changes what happens when you activate Color Picker. Read more about this setting in [Activating Color Picker](#activating-color-picker). |
| **Activation behavior** | Sets what happens when you activate Color Picker. Read more about this setting in [Activating Color Picker](#activating-color-picker). |
| **Default color format** | The color format that Color Picker copies to the clipboard. |
| **Show color name** | When turned on, this setting shows a high-level representation of the color. For example, 'Light Green', 'Green', or 'Dark Green'. |
| **Color formats** | This section lets you enable and add different color formats, and change the order of color formats in the Color Picker editor. Read more about **Color formats** in [Managing color formats](#managing-color-formats).
| **Show color name** | Shows a high-level representation of the color. For example, 'Light Green', 'Green', or 'Dark Green'. |
| **Color formats** | Enable and add different color formats, and change the order of color formats in the Color Picker editor. Read more about color formats in [Managing color formats](#managing-color-formats).

![Color Picker Settings screenshot](../images/pt-colorpicker-settings.png)

### Managing color formats

You can add, edit, delete, disable, and change the order of color formats in **Color formats**.

To change the order that color formats appear in the Color Picker editor, select **•••** next to a color format and select **Move up** or **Move down**.
To change the order that color formats appear in the Color Picker editor, select the **more** button (•••) next to a color format and select **Move up** or **Move down**.

To disable a color format, turn off the toggle next to that color format. Color Picker doesn't show disabled color formats in the editor.

To delete a color format, select **•••** next to a color format and select **Delete**.
To delete a color format, select the **more** button (•••) next to a color format and select **Delete**.

To add a new color format, select **Add custom color format**. Choose the color format's **Name** and **Format**. Select **Save** to add the color format. The syntax for color formats is described in the **Add custom color format** dialog.
To add a new color format, select **Add custom color format**. Enter the color format's **Name** and **Format**. The syntax for color formats is described in the dialog.

To edit a color format, select it from the list. Edit the color format's **Name** and **Format** in the **Edit custom color format** dialog. Select **Update** to save your changes. The syntax for color formats is described in the **Edit custom color format** dialog.
To edit a color format, select it from the list. Edit the color format's **Name** and **Format** in the **Edit custom color format** dialog. The syntax for color formats is described in the dialog.

Define color formats with these parameters:

Expand Down
9 changes: 5 additions & 4 deletions hub/powertoys/crop-and-lock.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ PowerToys **Crop And Lock** allows you to crop a current application into a smal

### How to use

To start using Crop And Lock, enable it in the PowerToys Settings (**Crop And Lock** tab).
To start using Crop And Lock, enable it in PowerToys Settings.

Once enabled, focus a Window and press the "Thumbnail" shortcut (default: <kbd>⊞ Win</kbd>+<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>T</kbd>) or the "Reparent" shortcut (default: <kbd>⊞ Win</kbd>+<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>R</kbd>) to select an area of the window to crop.

Expand All @@ -32,14 +32,15 @@ Select the **Close** button of the cropped window to close it and restore the or

### Thumbnail

Creates a window that shows the selected area of the original window. Any changes to the original window's selected area will be reflected on the thumbnail, but the original application can't be controlled through the thumbnail. This mode has the most compatibility with other applications.
Creates a window that shows the selected area of the original window. Any changes to the original window's selected area will be reflected on the thumbnail, but the original application can't be controlled through the thumbnail. This mode has the best compatibility.

### Reparent

Creates a window that replaces the original window, showing only the selected area. The application will now be controlled through the cropped window. Closing the cropped window will restore the original window. Not every window will react well to being contained on another application so this mode has many compatibility issues. It's advisable to use the "Thumbnail" mode instead if you find that a windows isn't reacting well to being cropped with the "Reparent" mode.
Creates a window that replaces the original window, showing only the selected area. The application will now be controlled through the cropped window. Closing the cropped window will restore the original window.
Not every window will react well to being contained in another application so this mode has many compatibility issues. It's advisable to use the "Thumbnail" mode instead if you find that a windows isn't reacting well to being cropped with the "Reparent" mode.

## Known issues

- Cropping maximized or full-screen windows in "Reparent" mode might not work. It's recommended to resize the window to fill the screen corners instead.
- Some UWP apps won't react well to being cropped in "Reparent" mode. The Windows Calculator is a notable example of this.
- Some UWP apps won't react well to being cropped in "Reparent" mode. Windows Calculator is a notable example of this.
- Applications that use sub-windows or tabs can react poorly to being cropped in "Reparent" mode. Notepad and OneNote are notable examples of applications that react poorly.
8 changes: 4 additions & 4 deletions hub/powertoys/environment-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@ no-loc: [PowerToys, Windows, Environment Variables, Win]

# Environment Variables

Environment Variables offers an easy and convenient way to manage environment variables. It also allows you to create profiles for managing a set of variables together. Profile variables have precedence over User and System variables. Applying the profile adds variables to User environment variables in the background. When a profile is applied, if there is an existing User variable with the same name, a backup variable is created in User variables which will be reverted to the original value on profile un-apply.

Environment Variables offers an easy and convenient way to manage environment variables. It allows you to create profiles for managing a set of variables together. Profile variables have precedence over User and System variables.
Applying the profile adds variables to User environment variables in the background. When a profile is applied, if there is an existing User variable with the same name, a backup variable is created in User variables which will be reverted to the original value on profile un-apply.
Applied variables list shows the current state of the environment, respecting the order of evaluation of environment variables (Profile > User > System). Evaluated Path variable value is shown at the top of the list.

![PowerToys Environment Variables screenshot](../images/powertoys-environment-variables.png)
Expand Down Expand Up @@ -42,8 +42,8 @@ To apply a profile, set the **profile** toggle to On. Only one profile can be ap

## Settings

From the Settings menu, the following options can be configured:
From the settings, the following options can be configured:

| Setting | Description |
| :--- | :--- |
| Open as administrator | Allow management of System variables. If disabled, only profile and User variables can be modified. Environment Variables is opened as administrator by default. |
| Open as administrator | Allow management of System variables. If off, only profile and User variables can be modified. Environment Variables is opened as administrator by default. |
Loading