From 6591759ca5ff29c6e53a6b3fcc0f87af2c5df2f8 Mon Sep 17 00:00:00 2001 From: Samuel Bronson Date: Thu, 28 Jan 2021 19:53:11 -0500 Subject: [PATCH 01/21] command-line-arguments.md: Tag the Command Prompt code blocks For some reason they were tagged as bash, which broke highlighting in at least one of them. --- TerminalDocs/command-line-arguments.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/TerminalDocs/command-line-arguments.md b/TerminalDocs/command-line-arguments.md index 701ba25b..593e5695 100644 --- a/TerminalDocs/command-line-arguments.md +++ b/TerminalDocs/command-line-arguments.md @@ -20,7 +20,7 @@ You can use `wt.exe` to open a new instance of Windows Terminal from the command The `wt` command line accepts two types of values: **options** and **commands**. **Options** are a list of flags and other parameters that can control the behavior of the `wt` command line as a whole. **Commands** provide the action, or list of actions separated by semicolons, that should be implemented. If no command is specified, then the command is assumed to be `new-tab` by default. -```bash +```cmd wt [options] [command ; ] ``` @@ -61,7 +61,7 @@ To open a new terminal instance, in this case the command will open the profile #### [Command Prompt](#tab/windows) -```bash +```cmd wt -p "Ubuntu-18.04" ``` @@ -91,7 +91,7 @@ To specify the folder that should be used as the starting directory for the cons #### [Command Prompt](#tab/windows) -```bash +```cmd wt -d d:\ ``` @@ -119,7 +119,7 @@ To open a new terminal instance with multiple tabs, enter: #### [Command Prompt](#tab/windows) -```bash +```cmd wt ; ; ``` @@ -147,7 +147,7 @@ To open a new terminal instance with multiple tabs, in this case a Command Promp #### [Command Prompt](#tab/windows) -```bash +```cmd wt -p "Command Prompt" ; new-tab -p "Windows PowerShell" ``` @@ -177,7 +177,7 @@ To open a new terminal instance with one tab containing three panes running a Co #### [Command Prompt](#tab/windows) -```bash +```cmd wt -p "Command Prompt" ; split-pane -p "Windows PowerShell" ; split-pane -H wsl.exe ``` @@ -209,7 +209,7 @@ The `new-tab` and `split-pane` commands can be sequenced to get multiple tabs, e #### [Command Prompt](#tab/windows) -```bash +```cmd wt -p "Command Prompt" ; split-pane -V wsl.exe ; new-tab -d c:\ ; split-pane -H -d c:\ wsl.exe ``` @@ -239,7 +239,7 @@ To open a new terminal instance with custom tab titles, use the `--title` argume #### [Command Prompt](#tab/windows) -```bash +```cmd wt --title tabname1 ; new-tab -p "Ubuntu-18.04" --title tabname2 ``` @@ -267,7 +267,7 @@ To open a new terminal instance with custom tab colors, use the `--tabColor` arg #### [Command Prompt](#tab/windows) -```bash +```cmd wt --tabColor #009999 ; new-tab --tabColor #f59218 ``` @@ -304,7 +304,7 @@ To open a new terminal instance with a specific tab in focus, use the `-t` flag #### [Command Prompt](#tab/windows) -```bash +```cmd wt ; new-tab -p "Ubuntu-18.04" ; focus-tab -t 1 ``` From eebc37c0dac0fc7ce26cff15fa93940fad787b98 Mon Sep 17 00:00:00 2001 From: LSC Date: Fri, 29 Jan 2021 21:08:37 +0100 Subject: [PATCH 02/21] fixed typo (#220) in line 98 it's `C:\\path\\to\\icon.png` while in line 115 it was `C:\\path\\to\\icon` so I've added the missing `.png` --- TerminalDocs/command-palette.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TerminalDocs/command-palette.md b/TerminalDocs/command-palette.md index 7736df5a..e5dd0884 100644 --- a/TerminalDocs/command-palette.md +++ b/TerminalDocs/command-palette.md @@ -121,7 +121,7 @@ The above command would behave like the following three commands: "command": { "action": "newTab", "profile": "Command Prompt" } }, { - "icon": "C:\\path\\to\\icon", + "icon": "C:\\path\\to\\icon.png", "name": "PowerShell", "command": { "action": "newTab", "profile": "PowerShell" } }, From a69ab41d1930a30b2082fb400a88130664ddbc4d Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Fri, 29 Jan 2021 12:57:11 -0800 Subject: [PATCH 03/21] Add note about escaping characters with backslash (#230) Originally filed by Andrewery https://github.com/MicrosoftDocs/terminal/pull/134/files --- TerminalDocs/customize-settings/interaction.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/TerminalDocs/customize-settings/interaction.md b/TerminalDocs/customize-settings/interaction.md index 3dbfe627..594d4bf7 100644 --- a/TerminalDocs/customize-settings/interaction.md +++ b/TerminalDocs/customize-settings/interaction.md @@ -59,7 +59,8 @@ This determines the word delimiters used in a double-click selection. Word delim **Default value:**  /\()"'-:,.;<>~!@#$%^&*|+=[]{}~?│
_(`│` is `U+2502 BOX DRAWINGS LIGHT VERTICAL`)_ -
+> [!IMPORTANT] +> The following characters must be escaped with a backslash : `\`, `"` ___ From 6fc0e348ad2a5f0111f8785bfce8be29cbd43ab0 Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Fri, 29 Jan 2021 13:18:57 -0800 Subject: [PATCH 04/21] Add icon example and folder location (#231) From https://github.com/MicrosoftDocs/terminal/pull/135 * Add icon example and folder location As originally submitted by @aloneguid in https://github.com/MicrosoftDocs/terminal/pull/135 * Remove code brackets for readability * Add spacing --- TerminalDocs/customize-settings/profile-general.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/TerminalDocs/customize-settings/profile-general.md b/TerminalDocs/customize-settings/profile-general.md index 50d31a51..aad75c72 100644 --- a/TerminalDocs/customize-settings/profile-general.md +++ b/TerminalDocs/customize-settings/profile-general.md @@ -95,7 +95,12 @@ This sets the icon that displays within the tab, dropdown menu, jumplist, and ta **Accepts:** File location as a string, or an emoji -
+The icon image file will need to be placed in a location that the Terminal app can read. Place icon images in the Windows Terminal AppData folder, located at:
+ +`%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState` +
+
+As an example, if you place the icon image `ubuntu.ico` in this folder, the property will be `"icon": "ms-appdata:///roaming/ubuntu.ico"`. ___ From 5d6171c6a56bfca0fc78c8fc8be599ceb341fab7 Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Fri, 29 Jan 2021 13:33:52 -0800 Subject: [PATCH 05/21] Fix default value by escaping characters (#232) Original submission: https://github.com/MicrosoftDocs/terminal/pull/134/files --- TerminalDocs/customize-settings/interaction.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/TerminalDocs/customize-settings/interaction.md b/TerminalDocs/customize-settings/interaction.md index 594d4bf7..4b442c26 100644 --- a/TerminalDocs/customize-settings/interaction.md +++ b/TerminalDocs/customize-settings/interaction.md @@ -57,7 +57,10 @@ This determines the word delimiters used in a double-click selection. Word delim **Accepts:** Characters as a string -**Default value:**  /\()"'-:,.;<>~!@#$%^&*|+=[]{}~?│
_(`│` is `U+2502 BOX DRAWINGS LIGHT VERTICAL`)_ +**Default value:** + /\\()\"'-:,.;<>~!@#$%^&*|+=[]{}~?│ +
+_(`│` is `U+2502 BOX DRAWINGS LIGHT VERTICAL`)_ > [!IMPORTANT] > The following characters must be escaped with a backslash : `\`, `"` From 7f9ca36b46cdea27b89e934defcd01619f24c8ad Mon Sep 17 00:00:00 2001 From: skycommand Date: Sat, 30 Jan 2021 04:37:30 +0330 Subject: [PATCH 06/21] Add info about the command palette (#180) * Add info about the command palette 1. Add info about the command palette. 2. Typo fixes (e.g. "quick-start guide" instead of "quickstart") 3. Style fix, e.g. we don't have a keyboard key whose full name is "alt+shift+plus". * revert description Co-authored-by: Matt Wojciakowski --- TerminalDocs/get-started.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/TerminalDocs/get-started.md b/TerminalDocs/get-started.md index b09ca5bd..cf7e426d 100644 --- a/TerminalDocs/get-started.md +++ b/TerminalDocs/get-started.md @@ -1,6 +1,6 @@ --- title: Windows Terminal installation -description: In this quickstart, you will learn how to install and run Windows Terminal. +description: In this quickstart, you will learn how to install and set up Windows Terminal. author: cinnamon-msft ms.author: cinnamon ms.date: 01/28/2021 @@ -28,11 +28,17 @@ The terminal will automatically create profiles for you if you have WSL distros ## Open a new tab -You can open a new tab of the default profile by pressing ctrl+shift+t or by selecting the + (plus) button. To open a different profile, select the ˅ (arrow) next to the + button to open the dropdown menu. From there, you can select which profile to open. +You can open a new tab of the default profile by pressing Ctrl+Shift+T or by selecting the + (plus) button. To open a different profile, select the ˅ (arrow) next to the + button to open the dropdown menu. From there, you can select which profile to open. + +## Invoke the command palette + +You can invoke most features of Windows Terminal through the [command palette](./command-palette.md). The default key combination to invoke it is Ctrl+Shift+P. Without the command palette, you have to learn the keyboard shortcut for each feature. + +![Example of the command palette in use](./images/command-palette-iterable-commands.gif) ## Open a new pane -You can run multiple shells side-by-side using panes. To open a pane, you can use alt+shift+plus for a vertical pane or alt+shift+minus for a horizontal one. You can also use alt+shift+d to open a duplicate pane of your focused profile. Learn more about panes on the [Panes page](./panes.md). +You can run multiple shells side-by-side using panes. To open a pane, you can use Alt+Shift+= for a vertical pane or Alt+Shift+- for a horizontal one. You can also use Alt+Shift+D to open a duplicate pane of your focused profile. Learn more about panes on the [Panes page](./panes.md). ## Configuration From a165f1a08b608c215f4355fe446ccd3cd18e71d8 Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Fri, 29 Jan 2021 17:30:17 -0800 Subject: [PATCH 07/21] Add backslash escape note (#233) ...from PR https://github.com/MicrosoftDocs/terminal/pull/181 --- .../customize-settings/profile-general.md | 24 +++++++++---------- 1 file changed, 11 insertions(+), 13 deletions(-) diff --git a/TerminalDocs/customize-settings/profile-general.md b/TerminalDocs/customize-settings/profile-general.md index aad75c72..c0eb5f08 100644 --- a/TerminalDocs/customize-settings/profile-general.md +++ b/TerminalDocs/customize-settings/profile-general.md @@ -70,19 +70,17 @@ This is the directory the shell starts in when it is loaded.
-> [!NOTE] -> When setting the starting directory that your installed WSL distributions open to, you should use this format: `"startingDirectory": "\\\\wsl$\\DISTRO NAME\\home\\USERNAME"`, replacing with the name of your distribution. For example, `"startingDirectory": "\\\\wsl$\\Ubuntu-20.04\\home\\user1"`. - -> [!NOTE] -> Omitting the startingDirectory value in a profile results in... -
-..if you run Windows Terminal from the Start menu: C:\windows\system32 -
-..if you run wt.exe from the Start menu: C:\windows\system32 -
-..if you run wt.exe from Win+R: %USERPROFILE% -
-..if you run wt.exe from the explorer address bar: whatever folder you were looking at. +Backslashes need to be escaped. For example, `C:\Users\USERNAME\Documents` should be entered as `C:\\Users\\USERNAME\\Documents`. + +When setting the starting directory that your installed WSL distributions open to, use the format: `"startingDirectory": "\\\\wsl$\\DISTRO NAME\\home\\USERNAME"`, replacing with the placeholders with the proper names of your distribution. For example, `"startingDirectory": "\\\\wsl$\\Ubuntu-20.04\\home\\user1"`. + +Omitting the startingDirectory value in a profile has different results depending on where it's run... + +- If you run Windows Terminal from the Start menu: C:\windows\system32 +- If you run wt.exe from the Start menu: C:\windows\system32 +- If you run wt.exe from Win+R: %USERPROFILE% +- If you run wt.exe from the explorer address bar: whatever folder you were looking at. + ___ ## Icon From 0c27f872c250f21091991efd0ccbac3f400ba6cf Mon Sep 17 00:00:00 2001 From: Mike Griese Date: Fri, 29 Jan 2021 21:02:23 -0600 Subject: [PATCH 08/21] Add a note about hiding dynamic profiles (#186) * Add a note about hiding dynamic profiles * Minor writing updates Co-authored-by: Matt Wojciakowski --- TerminalDocs/troubleshooting.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/TerminalDocs/troubleshooting.md b/TerminalDocs/troubleshooting.md index 0233768e..8245cc0a 100644 --- a/TerminalDocs/troubleshooting.md +++ b/TerminalDocs/troubleshooting.md @@ -62,6 +62,14 @@ Alternatively, if you are running a script using the `commandline` profile setti The purpose of `startingDirectory` is to launch a new Windows Terminal instance in the given directory. If the terminal runs any code that changes its directory, that may be a good place to take a look. +## Deleting a profile + +By default, the Windows Terminal ships with a built-in PowerShell and a Command Prompt profile. Terminal will also autodetect if other command line applications are installed, such as Powershell Core, WSL distributions (Ubuntu, Debian, etc), or Azure Cloud Shell. We call these types of automatically generated profiles "Dynamic profiles". + +For both built-in and dynamic profiles, deleting the profile from your Terminal settings.json file will not remove it from your profiles. Built-in profiles are defined in `defaults.json`, so they're alwways available. Dynamic profiles will attempt to create a json stub for their profile in your `settings.json` file whenever a profile is not already present in the file. + +The only way to truly remove these profiles from the list is by "hiding" them. To hide a profile, add the property `"hidden": false` to the profile. + ## Ctrl+= does not increase the font size If you are using a German keyboard layout, you may run into this problem. ctrl+= gets deserialized as ctrl+shift+0 if your main keyboard layout is set to German. This is the correct mapping for German keyboards. From 635421fb4422ed849f4066bb9645b205c017e85e Mon Sep 17 00:00:00 2001 From: Cameron Durham Date: Fri, 29 Jan 2021 19:03:39 -0800 Subject: [PATCH 09/21] Clarify adding profile in ssh tutorial. Fixes #183 (#193) * Clarify adding profile in ssh tutorial. Fixes: #183 * Remove from docs link --- TerminalDocs/tutorials/ssh.md | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-) diff --git a/TerminalDocs/tutorials/ssh.md b/TerminalDocs/tutorials/ssh.md index 1cc23329..ea62af5c 100644 --- a/TerminalDocs/tutorials/ssh.md +++ b/TerminalDocs/tutorials/ssh.md @@ -16,18 +16,27 @@ In this tutorial, you'll learn how to set up a profile in Windows Terminal that ## Create a profile -You can start an SSH session in your command prompt by executing `ssh user@machine` and you will be prompted to enter your password. You can create a Windows Terminal profile that does this on startup by adding the `commandline` setting to a profile in your settings.json file. +You can start an SSH session in your command prompt by executing `ssh user@machine` and you will be prompted to enter your password. You can create a Windows Terminal profile that does this on startup by adding the `commandline` setting to a profile in your settings.json file inside the `list` of profile objects. -```js -"commandline": "ssh cinnamon@roll" +```json +{ + "name": "user@machine ssh profile", + "commandline": "ssh user@machine", +} ``` +For more information, see: + +* [Windows Terminal Profile Settings](https://docs.microsoft.com/windows/terminal/customize-settings/profile-settings) + ## Specify starting directory To specify the starting directory for a ssh session invoked by Windows Terminal, you can use this command: -```bash -"commandline": "ssh -t bob@foo \"cd /data/bob && exec bash -l\"" +```json +{ + "commandline": "ssh -t bob@foo \"cd /data/bob && exec bash -l\"" +} ``` The `-t` flag forces pseudo-terminal allocation. This can be used to execute arbitrary screen-based programs on a remote machine, e.g. when implementing menu services. You will need to use escaped double quotes as bourne shell derivatives don't do any additional parsing for a string in single quotes. From d503b922ce601e0e32e6360f26e40eb0791f4afe Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Fri, 29 Jan 2021 19:13:24 -0800 Subject: [PATCH 10/21] Add guid command for powershell (#234) migrated from PR https://github.com/MicrosoftDocs/terminal/pull/199/files --- TerminalDocs/customize-settings/profile-advanced.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/TerminalDocs/customize-settings/profile-advanced.md b/TerminalDocs/customize-settings/profile-advanced.md index 2877c354..0d74522f 100644 --- a/TerminalDocs/customize-settings/profile-advanced.md +++ b/TerminalDocs/customize-settings/profile-advanced.md @@ -151,7 +151,8 @@ Profiles can use a GUID as a unique identifier. To make a profile your default p **Accepts:** GUID as a string in registry format: `"{00000000-0000-0000-0000-000000000000}"` -
+> [!TIP] +> You can run `[guid]::NewGuid()` in PowerShell to generate a GUID for your custom profile. ___ From 40de5eec2aa3a5f47e8560186f679bb7039d81d0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=B8ren=20Fuglede=20J=C3=B8rgensen?= Date: Sat, 30 Jan 2021 04:14:11 +0100 Subject: [PATCH 11/21] Change "i.e." to "e.g." (#207) This seems to be the intended meaning: There are Linux distributions that are not Ubuntu, but Ubuntu is an example of a Linux distribution for which the behavior is the given. --- TerminalDocs/tutorials/tab-title.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TerminalDocs/tutorials/tab-title.md b/TerminalDocs/tutorials/tab-title.md index cb5d5554..be2629dc 100644 --- a/TerminalDocs/tutorials/tab-title.md +++ b/TerminalDocs/tutorials/tab-title.md @@ -43,7 +43,7 @@ A shell has full control over its own title. However, each shell sets its title | Command Prompt | `TITLE "New Title"` | | bash* | `echo -ne "\033]0;New Title\a"` | -Note that some Linux distributions (i.e. Ubuntu) set their title automatically as you interact with the shell. If the above command doesn't work, run the following command: +Note that some Linux distributions (e.g. Ubuntu) set their title automatically as you interact with the shell. If the above command doesn't work, run the following command: ```bash PS1=$ From 737c16931f8dd11e3a79c0d232a88ff174011a97 Mon Sep 17 00:00:00 2001 From: Janne Mareike Koschinski Date: Sat, 30 Jan 2021 04:15:15 +0100 Subject: [PATCH 12/21] Old Ubuntu: Use up-to-date version of golang (#216) Currently, the install recommends using an out-of-date version of golang, which in turn causes issues while installing powerline-go. --- TerminalDocs/tutorials/powerline-setup.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/TerminalDocs/tutorials/powerline-setup.md b/TerminalDocs/tutorials/powerline-setup.md index e68f3c18..57f41e23 100644 --- a/TerminalDocs/tutorials/powerline-setup.md +++ b/TerminalDocs/tutorials/powerline-setup.md @@ -102,6 +102,13 @@ sudo apt install golang-go go get -u github.com/justjanne/powerline-go ``` +> [!TIP] +> If you're using Ubuntu 18.04 or 16.04, you'll need to first install the correct version of golang: +> ```bash +> sudo add-apt-repository ppa:longsleep/golang-backports +> sudo apt update +> ``` + ### Customize your Ubuntu prompt Open your `~/.bashrc` file with `nano ~/.bashrc` or the text editor of your choice. This is a bash script that runs every time bash starts. Add the following, though beware that GOPATH may already exist: From 9544259cd8beaa717560f2c95deacc6cef4b2948 Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Mon, 1 Feb 2021 17:07:10 -0800 Subject: [PATCH 13/21] Add startingDirectory example (#237) * Add startingDirectory example * Format startingDirectory entry --- TerminalDocs/customize-settings/profile-general.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/TerminalDocs/customize-settings/profile-general.md b/TerminalDocs/customize-settings/profile-general.md index c0eb5f08..c0e8f2ba 100644 --- a/TerminalDocs/customize-settings/profile-general.md +++ b/TerminalDocs/customize-settings/profile-general.md @@ -68,19 +68,19 @@ This is the directory the shell starts in when it is loaded. **Default value:** `"%USERPROFILE%"` -
- -Backslashes need to be escaped. For example, `C:\Users\USERNAME\Documents` should be entered as `C:\\Users\\USERNAME\\Documents`. +**Example:** Start the PowerShell profile in the *GitHubRepos* folder of your *Documents* directory by finding the powershell.exe profile and adding `"startingDirectory": "%USERPROFILE%/Documents/GitHubRepos",` -When setting the starting directory that your installed WSL distributions open to, use the format: `"startingDirectory": "\\\\wsl$\\DISTRO NAME\\home\\USERNAME"`, replacing with the placeholders with the proper names of your distribution. For example, `"startingDirectory": "\\\\wsl$\\Ubuntu-20.04\\home\\user1"`. - -Omitting the startingDirectory value in a profile has different results depending on where it's run... +**Example with WSL:** When setting the starting directory for a [Linux distribution installed via WSL](https://docs.microsoft.com/windows/wsl/install-win10), use the format: `"startingDirectory": "\\\\wsl$\\DISTRO NAME\\home\\USERNAME"`, replacing with the placeholders with the proper names of your distribution. For example, `"startingDirectory": "\\\\wsl$\\Ubuntu-20.04\\home\\user1"`. +**Default behavior:** When the startingDirectory value is not specified, you will get different results depending on where you launch Terminal: - If you run Windows Terminal from the Start menu: C:\windows\system32 - If you run wt.exe from the Start menu: C:\windows\system32 - If you run wt.exe from Win+R: %USERPROFILE% - If you run wt.exe from the explorer address bar: whatever folder you were looking at. +> [!NOTE] +> Backslashes need to be escaped. For example, `C:\Users\USERNAME\Documents` should be entered as `C:\\Users\\USERNAME\\Documents`. + ___ ## Icon From 82a2f56183e55bda735803410e1559f3bc9b2cbc Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Tue, 2 Feb 2021 17:38:21 -0800 Subject: [PATCH 14/21] remove icon file type Co-authored-by: Kayla Cinnamon --- TerminalDocs/command-palette.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TerminalDocs/command-palette.md b/TerminalDocs/command-palette.md index e5dd0884..7736df5a 100644 --- a/TerminalDocs/command-palette.md +++ b/TerminalDocs/command-palette.md @@ -121,7 +121,7 @@ The above command would behave like the following three commands: "command": { "action": "newTab", "profile": "Command Prompt" } }, { - "icon": "C:\\path\\to\\icon.png", + "icon": "C:\\path\\to\\icon", "name": "PowerShell", "command": { "action": "newTab", "profile": "PowerShell" } }, From 65c6d39fa227b38f63415fa9d818f0622aabf79b Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Tue, 2 Feb 2021 17:45:04 -0800 Subject: [PATCH 15/21] Change icon description to example --- TerminalDocs/customize-settings/profile-general.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/TerminalDocs/customize-settings/profile-general.md b/TerminalDocs/customize-settings/profile-general.md index c0e8f2ba..88463a55 100644 --- a/TerminalDocs/customize-settings/profile-general.md +++ b/TerminalDocs/customize-settings/profile-general.md @@ -93,13 +93,9 @@ This sets the icon that displays within the tab, dropdown menu, jumplist, and ta **Accepts:** File location as a string, or an emoji -The icon image file will need to be placed in a location that the Terminal app can read. Place icon images in the Windows Terminal AppData folder, located at:
+**Example:** Placing the icon image `ubuntu.ico` in the folder located at `%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState`, you can display the icon by adding this line to the profile in your settings.json: `"icon": "ms-appdata:///roaming/ubuntu.ico"`. -`%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\RoamingState`
-
-As an example, if you place the icon image `ubuntu.ico` in this folder, the property will be `"icon": "ms-appdata:///roaming/ubuntu.ico"`. - ___ ## Tab title From 6090a3e7e2e6e1d4eafe49886567737da7599aec Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Tue, 2 Feb 2021 17:47:15 -0800 Subject: [PATCH 16/21] Change false to true Co-authored-by: Kayla Cinnamon --- TerminalDocs/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TerminalDocs/troubleshooting.md b/TerminalDocs/troubleshooting.md index 8245cc0a..2def9817 100644 --- a/TerminalDocs/troubleshooting.md +++ b/TerminalDocs/troubleshooting.md @@ -68,7 +68,7 @@ By default, the Windows Terminal ships with a built-in PowerShell and a Command For both built-in and dynamic profiles, deleting the profile from your Terminal settings.json file will not remove it from your profiles. Built-in profiles are defined in `defaults.json`, so they're alwways available. Dynamic profiles will attempt to create a json stub for their profile in your `settings.json` file whenever a profile is not already present in the file. -The only way to truly remove these profiles from the list is by "hiding" them. To hide a profile, add the property `"hidden": false` to the profile. +The only way to truly remove these profiles from the list is by "hiding" them. To hide a profile, add the property `"hidden": true` to the profile. ## Ctrl+= does not increase the font size From ca0e2ab6537f7d2bbe052e5f294a7d3822182326 Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Tue, 2 Feb 2021 17:47:55 -0800 Subject: [PATCH 17/21] Remove unnecessary sentence Co-authored-by: Kayla Cinnamon --- TerminalDocs/get-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TerminalDocs/get-started.md b/TerminalDocs/get-started.md index cf7e426d..793afa52 100644 --- a/TerminalDocs/get-started.md +++ b/TerminalDocs/get-started.md @@ -32,7 +32,7 @@ You can open a new tab of the default profile by pressing Ctrl+S ## Invoke the command palette -You can invoke most features of Windows Terminal through the [command palette](./command-palette.md). The default key combination to invoke it is Ctrl+Shift+P. Without the command palette, you have to learn the keyboard shortcut for each feature. +You can invoke most features of Windows Terminal through the [command palette](./command-palette.md). The default key combination to invoke it is Ctrl+Shift+P. ![Example of the command palette in use](./images/command-palette-iterable-commands.gif) From a6393d5e5f43af3bca9fe278aa66b9a6394b8650 Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Tue, 2 Feb 2021 17:48:16 -0800 Subject: [PATCH 18/21] Typo fixes Co-authored-by: Kayla Cinnamon --- TerminalDocs/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TerminalDocs/troubleshooting.md b/TerminalDocs/troubleshooting.md index 2def9817..c139ef67 100644 --- a/TerminalDocs/troubleshooting.md +++ b/TerminalDocs/troubleshooting.md @@ -66,7 +66,7 @@ The purpose of `startingDirectory` is to launch a new Windows Terminal instance By default, the Windows Terminal ships with a built-in PowerShell and a Command Prompt profile. Terminal will also autodetect if other command line applications are installed, such as Powershell Core, WSL distributions (Ubuntu, Debian, etc), or Azure Cloud Shell. We call these types of automatically generated profiles "Dynamic profiles". -For both built-in and dynamic profiles, deleting the profile from your Terminal settings.json file will not remove it from your profiles. Built-in profiles are defined in `defaults.json`, so they're alwways available. Dynamic profiles will attempt to create a json stub for their profile in your `settings.json` file whenever a profile is not already present in the file. +For both built-in and dynamic profiles, deleting the profile from your settings.json file will not remove it from your profiles. Built-in profiles are defined in `defaults.json`, so they're always available. Dynamic profiles will attempt to create a JSON stub for their profile in your `settings.json` file whenever a profile is not already present in the file. The only way to truly remove these profiles from the list is by "hiding" them. To hide a profile, add the property `"hidden": true` to the profile. From 214341cdfaf16ca229dfb4deebcdb59f3c9c615d Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Tue, 2 Feb 2021 17:48:29 -0800 Subject: [PATCH 19/21] link fix Co-authored-by: Kayla Cinnamon --- TerminalDocs/tutorials/ssh.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TerminalDocs/tutorials/ssh.md b/TerminalDocs/tutorials/ssh.md index ea62af5c..3afc024b 100644 --- a/TerminalDocs/tutorials/ssh.md +++ b/TerminalDocs/tutorials/ssh.md @@ -27,7 +27,7 @@ You can start an SSH session in your command prompt by executing `ssh user@machi For more information, see: -* [Windows Terminal Profile Settings](https://docs.microsoft.com/windows/terminal/customize-settings/profile-settings) +* [Windows Terminal Profile - General settings](./../customize-settings/profile-general.md) ## Specify starting directory From 394060f49f4c52beef747c9a34b97bc1971a205b Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Tue, 2 Feb 2021 17:48:52 -0800 Subject: [PATCH 20/21] Capitalization fixes Co-authored-by: Kayla Cinnamon --- TerminalDocs/troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TerminalDocs/troubleshooting.md b/TerminalDocs/troubleshooting.md index c139ef67..57afe484 100644 --- a/TerminalDocs/troubleshooting.md +++ b/TerminalDocs/troubleshooting.md @@ -64,7 +64,7 @@ The purpose of `startingDirectory` is to launch a new Windows Terminal instance ## Deleting a profile -By default, the Windows Terminal ships with a built-in PowerShell and a Command Prompt profile. Terminal will also autodetect if other command line applications are installed, such as Powershell Core, WSL distributions (Ubuntu, Debian, etc), or Azure Cloud Shell. We call these types of automatically generated profiles "Dynamic profiles". +By default, Windows Terminal ships with a built-in PowerShell and a Command Prompt profile. The terminal will also autodetect if other command line applications are installed, such as PowerShell Core, WSL distributions (Ubuntu, Debian, etc), and Azure Cloud Shell. We call these types of automatically generated profiles "Dynamic profiles". For both built-in and dynamic profiles, deleting the profile from your settings.json file will not remove it from your profiles. Built-in profiles are defined in `defaults.json`, so they're always available. Dynamic profiles will attempt to create a JSON stub for their profile in your `settings.json` file whenever a profile is not already present in the file. From 1a2ab634367e2796bf6bbab7d176ca0d41eecfdc Mon Sep 17 00:00:00 2001 From: Matt Wojciakowski Date: Tue, 2 Feb 2021 17:49:07 -0800 Subject: [PATCH 21/21] shortcut fixes Co-authored-by: Kayla Cinnamon --- TerminalDocs/get-started.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TerminalDocs/get-started.md b/TerminalDocs/get-started.md index 793afa52..b9b2e9f6 100644 --- a/TerminalDocs/get-started.md +++ b/TerminalDocs/get-started.md @@ -38,7 +38,7 @@ You can invoke most features of Windows Terminal through the [command palette](. ## Open a new pane -You can run multiple shells side-by-side using panes. To open a pane, you can use Alt+Shift+= for a vertical pane or Alt+Shift+- for a horizontal one. You can also use Alt+Shift+D to open a duplicate pane of your focused profile. Learn more about panes on the [Panes page](./panes.md). +You can run multiple shells side-by-side using panes. To open a pane, you can use Alt+Shift++ for a vertical pane or Alt+Shift+- for a horizontal one. You can also use Alt+Shift+D to open a duplicate pane of your focused profile. Learn more about panes on the [Panes page](./panes.md). ## Configuration