Skip to content

Commit 7251ed5

Browse files
committed
That Docs Authoring Pack is nice!
1 parent c643149 commit 7251ed5

16 files changed

+99
-107
lines changed

hub/powertoys/administrator.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: PowerToys administrator mode for Windows
33
description: For PowerToys to work with an app running in elevated admin mode, PowerToys must be running in administrator mode as well.
4-
ms.date: 05/28/2021
4+
ms.date: 04/27/2022
55
ms.topic: article
66
ms.localizationpriority: medium
77
no-loc: [PowerToys, Windows, FancyZones, Fancy, Zone, Zones]
@@ -56,9 +56,9 @@ Most apps do not need to run with elevated permission. A common scenario, howeve
5656

5757
If you see this User Account Control prompt, the application is requesting administrator level elevated permission:
5858

59-
![Windows elevated permission prompt screenshot](../images/pt-admin-prompt.png)
59+
![Windows elevated permission prompt screenshot.](../images/pt-admin-prompt.png)
6060

6161
In the case of an elevated command line, typically the text "Administrator" will be included in the title bar.
6262

63-
![Windows admin command line screenshot](../images/pt-admin-terminal.png)
63+
![Windows admin command line screenshot.](../images/pt-admin-terminal.png)
6464

hub/powertoys/always-on-top.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: PowerToys Always on Top utility for Windows
33
description: A system-wide utility for Windows that allows you to pin windows to the top of your screen.
4-
ms.date: 01/06/2021
4+
ms.date: 04/27/2022
55
ms.topic: article
66
no-loc: [PowerToys, Windows, Always on Top, Win]
77
---
@@ -10,9 +10,9 @@ no-loc: [PowerToys, Windows, Always on Top, Win]
1010

1111
A system-wide utility for Windows that allows you to pin windows to the top of all your windows.
1212

13-
![AlwaysOnTop screenshot](../images/pt-always-on-top.png)
13+
![AlwaysOnTop screenshot.](../images/pt-always-on-top.png)
1414

15-
### Toggle windows to be on top
15+
## Toggle windows to be on top
1616

1717
With the activation / deactivation shortcut (default: <kbd>⊞ Win</kbd>+<kbd>Ctrl</kbd>+<kbd>T</kbd>), the targeted window will be placed above all non-topmost windows and should stay above them, even when the window is deactivated.
1818

hub/powertoys/awake.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: PowerToys Awake utility for Windows
33
description: A tool for a Windows computer to stay awake.
4-
ms.date: 06/28/2021
4+
ms.date: 04/27/2022
55
ms.topic: article
66
ms.localizationpriority: medium
77
---
@@ -20,10 +20,9 @@ PowerToys Awake can be used directly from PowerToys Settings or as a standalone
2020

2121
## Settings
2222

23-
<!-- [Jay] GUI text should be updated to "PowerToys Awake", then change following text and images accordingly -->
2423
In the PowerToys Settings view, start PowerToys Awake by using the **Enable Awake** toggle. Once enabled, the application will manage the awakeness state of the computer.
2524

26-
![A screenshot of the Awake settings](../images/pt-awake-settings-menu.png)
25+
![A screenshot of the Awake settings.](../images/pt-awake-settings-menu.png)
2726

2827
The following Awake states can be selected:
2928

@@ -45,7 +44,7 @@ While PowerToys Awake can keep the computer awake indefinitely or temporarily, i
4544

4645
To manage the execution of the tool from the system tray, right-click on the PowerToys Awake icon.
4746

48-
![Awake settings managed from the system tray on Windows](../images/pt-awake-tray.gif)
47+
![Awake settings managed from the system tray on Windows.](../images/pt-awake-tray.gif)
4948

5049

5150
## Command Line Interface (CLI)

hub/powertoys/color-picker.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: PowerToys Color Picker utility for Windows
33
description: A system-wide color picking utility for Windows that enables you to pick colors from the screen and automatically copies the default value to your clipboard.
4-
ms.date: 05/28/2021
4+
ms.date: 04/27/2022
55
ms.topic: article
66
ms.localizationpriority: medium
77
no-loc: [PowerToys, Windows, FancyZones, Fancy, Zone, Zones]
@@ -11,7 +11,7 @@ no-loc: [PowerToys, Windows, FancyZones, Fancy, Zone, Zones]
1111

1212
A system-wide color picking utility for Windows that enables you to pick colors from any currently running application and can copy it in a configurable format to your clipboard.
1313

14-
![ColorPicker](../images/pt-colorpicker-hex-editor.png)
14+
![ColorPicker.](../images/pt-colorpicker-hex-editor.png)
1515

1616
## Getting started
1717

@@ -35,10 +35,11 @@ After the Color Picker is activated, hover your mouse cursor over the color you
3535

3636
The copied color will be stored in your clipboard in the format that is configured in the settings (default: HEX).
3737

38-
![Selecting a Color](../images/pt-colorpicker.gif)
38+
![Selecting a Color.](../images/pt-colorpicker.gif)
3939

4040
> [!TIP]
4141
> To select the color of the non-hover state of a element:
42+
>
4243
> - Move the mouse pointer close, but not over the element
4344
> - Zoom in by scrolling the mouse wheel up (image will be frozen)
4445
> - In the enlarged area, you can pick the color of the element
@@ -51,7 +52,7 @@ The editor also allows you to fine-tune any picked color or get a new similar co
5152

5253
The color in the middle represents your currently selected color from the colors history. By clicking on it, the fine-tuning configuration control will appear, where you can change HSV or RGB values of the current color. Pressing <kbd>Select</kbd> will add newly configured color into the colors history.
5354

54-
![ColorPicker Editor window](../images/pt-colorpicker-editor.gif)
55+
![ColorPicker Editor window.](../images/pt-colorpicker-editor.gif)
5556

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

@@ -64,7 +65,7 @@ Color Picker has following settings:
6465
- Format of a copied color (HEX, RGB, etc.)
6566
- Order and presence of color formats in the editor
6667

67-
![ColorPicker Settings screenshot](../images/pt-colorpicker-settings.png)
68+
![ColorPicker Settings screenshot.](../images/pt-colorpicker-settings.png)
6869

6970
## Limitations
7071

hub/powertoys/fancyzones.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: PowerToys FancyZones utility for Windows
33
description: A window manager utility for arranging and snapping windows into efficient layouts
4-
ms.date: 01/03/2022
4+
ms.date: 04/27/2022
55
ms.topic: article
66
ms.localizationpriority: medium
77
no-loc: [PowerToys, Windows, FancyZones, Fancy, Zone, Zones, Win]
@@ -11,7 +11,7 @@ no-loc: [PowerToys, Windows, FancyZones, Fancy, Zone, Zones, Win]
1111

1212
FancyZones is a window manager utility for arranging and snapping windows into efficient layouts to improve the speed of your workflow and restore layouts quickly. FancyZones allows you to define a set of window locations for a desktop that are drag targets for windows. When you drag a window into a zone, the window is resized and repositioned to fill that zone.
1313

14-
![FancyZones in action screenshot](../images/pt-fancy-zones2.png)
14+
![FancyZones in action screenshot.](../images/pt-fancy-zones2.png)
1515

1616

1717
## Getting started snapping windows
@@ -20,11 +20,11 @@ If two zones are adjacent, a window can be snapped to the sum of their area (rou
2020

2121
It's also possible to snap to any number of zones. First, drag the window until one zone is activated, then press and hold the <kbd>Control</kbd> key while dragging the window to select multiple zones.
2222

23-
![Two Zones Activation screenshot](../images/pt-fancyzones-twozones.png)
23+
![Two Zones Activation screenshot.](../images/pt-fancyzones-twozones.png)
2424

2525
To snap a window to multiple zones using only the keyboard, first turn on the setting **Override Windows Snap** and select **Move windows based on: Relative position** as shown below. After snapping a window to one zone, use <kbd>Win</kbd>+<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>[arrows]</kbd> to expand the window to multiple zones.
2626

27-
![Settings for Snapping to Multiple Zones via Keyboard](../images/pt-window-snap-multiple-zones-w-keyboard-settings.png)
27+
![Settings for Snapping to Multiple Zones via Keyboard.](../images/pt-window-snap-multiple-zones-w-keyboard-settings.png)
2828

2929
### Window switching
3030

@@ -54,25 +54,25 @@ Launch the zones editor using the button in the PowerToys Settings menu or by pr
5454
> [!NOTE]
5555
> Previous to PowerToys v0.39, this shortcut was <kbd>Win</kbd>+<kbd>`</kbd> without Shift. This was updated so that it does not conflict with [Windows Terminal Quake mode](/windows/terminal/tips-and-tricks#quake-mode) shortcut.
5656
57-
![FancyZones Settings UI](../images/pt-fancyzones-settings.png)
57+
![FancyZones Settings UI.](../images/pt-fancyzones-settings.png)
5858

5959
### Choose your layout (Layout Editor)
6060

6161
When first launched, the zones editor presents a list of layouts that can be adjusted by how many windows are on the monitor. Selecting a layout shows a preview of that layout on the monitor. The selected layout is applied automatically. Double-clicking a layout will apply it and automatically close the editor.
6262

63-
![FancyZones Picker screenshot](../images/pt-fancyzones-picker.png)
63+
![FancyZones Picker screenshot.](../images/pt-fancyzones-picker.png)
6464

6565
If multiple displays are in use, the editor will detect the available monitors and display them for you to choose between. The chosen monitor will then be the target of the selected layout.
6666

67-
![FancyZones Picker Multiple Monitors](../images/pt-fancyzones-multimon.png)
67+
![FancyZones Picker Multiple Monitors.](../images/pt-fancyzones-multimon.png)
6868

6969
### Space around zones
7070

7171
The **Show space around zones** setting enables you to determine what sort of margin will surround each FancyZone window. The **Space around zones** field enables you to set a custom value for the width of the margin. With the Zones Editor open, change the **Show space around zones** after changing the values to see the new value applied.
7272

7373
The **Distance to highlight adjacent zones** enables you to set a custom value for the amount of space between zones until they snap together, or before both are highlighted enabling them to merge together.
7474

75-
![FancyZones space around zones screenshot](../images/pt-fancyzones-spacearound.png)
75+
![FancyZones space around zones screenshot.](../images/pt-fancyzones-spacearound.png)
7676

7777
### Creating a custom layout
7878

@@ -86,21 +86,21 @@ The **Grid** model starts with a three column grid and allows zones to be create
8686
- To move a divider: click on the thumb and drag.
8787
- To merge zones: select a zone and hold the left mouse button and drag the mouse until multiple zones are selected, release the button and a popup menu will show up. Click "Merge" and they will become one big zone. This is how a zone would be deleted, by merging it into another zone.
8888

89-
![FancyZones Table Editor Mode](../images/pt-fancyzones-grideditor.png)
89+
![FancyZones Table Editor Mode.](../images/pt-fancyzones-grideditor.png)
9090

9191
The **Canvas** model starts with a blank layout and supports adding zones that can be dragged and resized similar to windows. Canvas layouts are directly tied to DPI and resolution of the monitor.
9292

9393
Canvas layout also has keyboard support for zone editing. Use the <kbd>arrow</kbd> keys (up, down, left, right) to move a zone by 10 pixels, or <kbd>Ctrl</kbd>+<kbd>arrow</kbd> to move a zone by 1 pixel. Use the <kbd>Shift</kbd>+<kbd>arrow</kbd> keys to resize a zone by 10 pixels (5 per edge), or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>arrow</kbd> to resize a zone by 2 pixels (1 per edge). To switch between the editor and dialog, press the <kbd>Ctrl</kbd>+<kbd>Tab</kbd> keys.
9494

95-
![FancyZones Window Editor Mode](../images/pt-fancyzones-canvaseditor.png)
95+
![FancyZones Window Editor Mode.](../images/pt-fancyzones-canvaseditor.png)
9696

9797
### Quickly changing between custom layouts
9898

9999
A custom layout can be configured to have a user-defined hotkey to quickly apply it to the desired desktop. The hotkey can be set by opening the custom layout's edit menu. Once set, the custom layout can be applied by pressing the <kbd>Win</kbd>+<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>[number]</kbd> binding. The layout can also be applied by pressing the hotkey when dragging a window.
100100

101101
In the demo below, we start with a default template applied to the screen and two custom layouts that we assign hotkeys for. We then use the <kbd>Win</kbd>+<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>[number]</kbd> binding to apply the first custom layout and snap a window to it. Finally, we apply the second custom layout while dragging a window and snap the window to it.
102102

103-
![FancyZones Quick-Swap Layouts settings and usage](../images/pt-fancyzones-quickswap.gif)
103+
![FancyZones Quick-Swap Layouts settings and usage.](../images/pt-fancyzones-quickswap.gif)
104104

105105
> [!TIP]
106106
> The settings for the zone layouts and monitors are saved in file `%LocalAppData%\Microsoft\PowerToys\FancyZones\zones-settings.json`. This can be manually changed to tweak zones, and exported to share layouts across devices.
@@ -138,4 +138,4 @@ In the demo below, we start with a default template applied to the screen and tw
138138
| Flash zones when switching layout | The zones will flash when a layout is selected via the shortcut. |
139139
| Exclude applications from snapping to zones | Add an application's name, or part of the name, one per line (e.g. adding `Notepad` will match both `Notepad.exe` and `Notepad++.exe`; to match only `Notepad.exe` add the `.exe` extension) |
140140

141-
![FancyZones Settings bottom screenshot](../images/pt-fancyzones-settings2.png)
141+
![FancyZones Settings bottom screenshot.](../images/pt-fancyzones-settings2.png)

hub/powertoys/file-explorer.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: PowerToys File Explorer add-ons utility for Windows
33
description: A File Explorer add-on that enables different preview pane and thumbnail renderers for different file types.
4-
ms.date: 02/02/2022
4+
ms.date: 04/27/2022
55
ms.topic: article
66
ms.localizationpriority: medium
77
no-loc: [PowerToys, Windows, File Explorer, Monaco]
@@ -31,19 +31,15 @@ Preview Pane is an existing feature in the Windows File Explorer which shows a l
3131

3232
To enable, first set all to **On**.
3333

34-
![PowerToys Settings Enable File Explorer screenshot](../images/powertoys-settings-fileexplorer.png)
34+
![PowerToys Settings Enable File Explorer screenshot.](../images/powertoys-settings-fileexplorer.png)
3535

3636
> [!NOTE]
3737
> Windows Explorer has an additional setting that needs to be checked in order for preview handlers to work. Open Explorer's Folder options, go to tab "View", under "Advanced settings" check **Show preview handlers in preview pane**.
3838
39-
**Windows 11**
40-
4139
In Windows 11, open Windows File Explorer, select the **View** menu in the File Explorer ribbon. Hover over **Show**, and then select **Preview pane**.
4240

4341
![PowerToys Preview Pane demo for Windows 11.](../images/powertoys-fileexplorer-win11.gif)
4442

45-
**Windows 10**
46-
4743
In Windows 10, open Windows File Explorer, select the **View** tab in the File Explorer ribbon, and then select **Preview Pane**.
4844

4945
![PowerToys Preview Pane demo for Windows 10.](../images/powertoys-fileexplorer.gif)

hub/powertoys/image-resizer.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: PowerToys Image Resizer utility for Windows
33
description: A Windows shell extension for bulk image-resizing
4-
ms.date: 05/28/2021
4+
ms.date: 04/27/2022
55
ms.topic: article
66
ms.localizationpriority: medium
77
no-loc: [PowerToys, Windows, File Explorer, Image Resizer]
@@ -11,11 +11,11 @@ no-loc: [PowerToys, Windows, File Explorer, Image Resizer]
1111

1212
Image Resizer is a Windows shell extension for bulk image-resizing. After installing PowerToys, right-click on one or more selected image files in File Explorer, and then select **Resize pictures** from the menu.
1313

14-
![Image Resizer Demo](../images/powertoys-resize-images.gif)
14+
![Image Resizer Demo.](../images/powertoys-resize-images.gif)
1515

1616
Image Resizer allows you to resize images by dragging and dropping your selected files with the right mouse button. This way, resized pictures can quickly be saved in a different folder.
1717

18-
![Image Resizer Drag And Drop Demo](../images/powertoys-resize-drag-drop.gif)
18+
![Image Resizer Drag And Drop Demo.](../images/powertoys-resize-drag-drop.gif)
1919

2020
> [!NOTE]
2121
> If **Ignore the orientation of pictures** is checked, the width and height of the specified size _may_ be swapped to match the orientation (portrait/landscape) of the current image. In other words: If checked, the **smallest** number (in width/height) in the settings will be applied to the **smallest** dimension of the picture. Regardless if this is declared as width or height. The idea is that different photos with different orientations will still be the same size.
@@ -24,7 +24,7 @@ Image Resizer allows you to resize images by dragging and dropping your selected
2424

2525
Inside the PowerToys Settings window, on the Image Resizer tab, you can configure the following settings.
2626

27-
![PowerToys Image Resizer Settings](../images/powertoys-imageresize-settings.png)
27+
![PowerToys Image Resizer Settings.](../images/powertoys-imageresize-settings.png)
2828

2929
### Sizes
3030

@@ -41,7 +41,7 @@ Add new preset sizes. Each size can be configured as Fill, Fit or Stretch. The d
4141
4242
### Fallback encoding
4343

44-
The fallback encoder is used when the file cannot be saved in its original format. For example, the Windows Metafile (.wmf) image format has a decoder to read the image, but no encoder to write a new image. In this case, the image cannot be saved in its original format. Image Resizer enables you to specify what format the fallback encoder will use: PNG, JPEG, TIFF, BMP, GIF, or WMPhoto settings. **This is not a file type conversion tool, but only works as a fallback for unsupported file formats.**
44+
The fallback encoder is used when the file cannot be saved in its original format. For example, the Windows Meta File (.wmf) image format has a decoder to read the image, but no encoder to write a new image. In this case, the image cannot be saved in its original format. Image Resizer enables you to specify what format the fallback encoder will use: PNG, JPEG, TIFF, BMP, GIF, or WMPhoto settings. **This is not a file type conversion tool, but only works as a fallback for unsupported file formats.**
4545

4646
### File
4747

0 commit comments

Comments
 (0)