Skip to content
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

June updates #346

Merged
merged 61 commits into from
Jun 18, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
61 commits
Select commit Hold shift + click to select a range
6591759
command-line-arguments.md: Tag the Command Prompt code blocks
SamB Jan 29, 2021
eebc37c
fixed typo (#220)
boop5 Jan 29, 2021
a69ab41
Add note about escaping characters with backslash (#230)
mattwojo Jan 29, 2021
6fc0e34
Add icon example and folder location (#231)
mattwojo Jan 29, 2021
5d6171c
Fix default value by escaping characters (#232)
mattwojo Jan 29, 2021
7f9ca36
Add info about the command palette (#180)
skycommand Jan 30, 2021
a165f1a
Add backslash escape note (#233)
mattwojo Jan 30, 2021
0c27f87
Add a note about hiding dynamic profiles (#186)
zadjii-msft Jan 30, 2021
635421f
Clarify adding profile in ssh tutorial. Fixes #183 (#193)
camerondurham Jan 30, 2021
d503b92
Add guid command for powershell (#234)
mattwojo Jan 30, 2021
40de5ee
Change "i.e." to "e.g." (#207)
fuglede Jan 30, 2021
737c169
Old Ubuntu: Use up-to-date version of golang (#216)
justjanne Jan 30, 2021
9544259
Add startingDirectory example (#237)
mattwojo Feb 2, 2021
82a2f56
remove icon file type
mattwojo Feb 3, 2021
65c6d39
Change icon description to example
mattwojo Feb 3, 2021
6090a3e
Change false to true
mattwojo Feb 3, 2021
ca0e2ab
Remove unnecessary sentence
mattwojo Feb 3, 2021
a6393d5
Typo fixes
mattwojo Feb 3, 2021
214341c
link fix
mattwojo Feb 3, 2021
394060f
Capitalization fixes
mattwojo Feb 3, 2021
1a2ab63
shortcut fixes
mattwojo Feb 3, 2021
57fb993
page_title_updates_terminal (#243)
v-mepa Feb 19, 2021
c489882
Add docs for `newWindow` action (#259)
zadjii-msft Feb 23, 2021
20e12c8
refactor(powerline): update for oh-my-posh V3 (#263)
JanDeDobbeleer Feb 23, 2021
157b457
Improved title setting procedure on bash/Ubuntu so that it doesn't de…
Dakkaron Feb 23, 2021
b7c6304
Update powerline-setup.md (#240)
Feb 26, 2021
549c163
Merge release 1.7 into master (#264)
cinnamon-msft Feb 27, 2021
12326f0
Merge branch 'live' into master
cinnamon-msft Feb 27, 2021
6a16709
Update powerline-setup.md (#175)
mjjames Mar 23, 2021
8cb5e9d
Fix a monor typo with the default keybinding for new tab (#287)
zadjii-msft Mar 23, 2021
7cb408c
Add a note that --window is only available in 1.7+ (#288)
zadjii-msft Mar 23, 2021
7a35ea4
Fix a typo in this doc (#289)
zadjii-msft Mar 23, 2021
64fa1d7
Add a FAQ entry for folks who are confused when Settings does nothing…
zadjii-msft Mar 23, 2021
4709f0e
Add a note that you can't set the tab color from the commandline (#291)
zadjii-msft Mar 23, 2021
4633866
Add UUID generator option
mattwojo Mar 23, 2021
ddae6b8
Add online guid generator
mattwojo Mar 23, 2021
7003737
Add instructions to open defaults.json file
mattwojo Mar 23, 2021
d76ab6c
Update panes.md
mattwojo Mar 24, 2021
6533054
Add note about using settings.json...
mattwojo Mar 24, 2021
6ecd2dc
fix link
mattwojo Mar 24, 2021
85f0a29
Merge release-1.8 into master (#309)
cinnamon-msft Apr 14, 2021
86d2842
Merge branch 'live' into master
cinnamon-msft Apr 14, 2021
25d9bc0
Fix placement of unfocused appearance section (#312)
cinnamon-msft Apr 14, 2021
29cf3d4
Update TerminalDocs/command-line-arguments.md
cinnamon-msft Apr 14, 2021
7b6cd3e
Update TerminalDocs/command-line-arguments.md
cinnamon-msft Apr 14, 2021
0039bac
Add mouse interaction section (#297)
mattwojo Apr 30, 2021
a49a379
document how to start windows terminal and have it execute a command …
MarkIannucci Apr 30, 2021
cf3bd48
FIX syntax error in json configuration example (#308)
lpotherat Apr 30, 2021
febcf10
Document trimBlockSelection setting (#313)
Don-Vito Apr 30, 2021
92577e8
Updated openSettings default bindings. (#317)
Sophismata Apr 30, 2021
b87a0b0
Update powerline-setup.md (#319)
superfaz May 3, 2021
97777e1
Updates for 1.9 release (#328)
cinnamon-msft May 24, 2021
3fca8ae
Merge branch 'live' into master
cinnamon-msft May 24, 2021
347cc49
Fix links
cinnamon-msft May 25, 2021
f4f707d
Typo "Windows terminal"→"Windows Terminal" (#326)
hyoshioka0128 May 27, 2021
c024d3d
Add link to alternative install options (#321)
mattwojo May 27, 2021
cefb40f
Update `cursorHeight` minimum value (#278)
eugenesmlv May 27, 2021
bd8fbc5
Add link to install preview (#342)
mattwojo Jun 11, 2021
b4e9bba
Update default settings, add UI screenshots (#343)
mattwojo Jun 18, 2021
eb2e49b
Fix typos
mattwojo Jun 18, 2021
5102a86
Merge branch 'live' into master
mattwojo Jun 18, 2021
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
2 changes: 1 addition & 1 deletion TerminalDocs/custom-terminal-gallery/custom-schemes.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Windows terminal Custom Color Schemes guide
title: Windows Terminal Custom Color Schemes guide
description: Some sample configurations for Windows Terminal.
author: cinnamon-msft
ms.author: cinnamon
Expand Down
2 changes: 1 addition & 1 deletion TerminalDocs/customize-settings/profile-appearance.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,7 +123,7 @@ This sets the percentage height of the cursor starting from the bottom. This wil

**Necessity:** Optional

**Accepts:** Integer from 25-100
**Accepts:** Integer from 1-100

<br />

Expand Down
45 changes: 37 additions & 8 deletions TerminalDocs/get-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,21 +10,50 @@ ms.localizationpriority: high

# Install and set up Windows Terminal

## Installation
## Install

You can install Windows Terminal from the [Microsoft Store](https://aka.ms/terminal).
> [!div class="nextstepaction"]
> [Install Windows Terminal](https://aka.ms/terminal)

If you don't have access to the Microsoft Store, the builds are published on the [GitHub releases page](https://github.com/microsoft/terminal/releases). If you install from GitHub, the terminal will not automatically update with new versions.
To try the latest preview features, you may also want to [install Windows Terminal Preview](https://www.microsoft.com/p/windows-terminal-preview/9n8g5rfz9xk3#activetab=pivot:overviewtab).

## First run
> [!NOTE]
> If you don't have access to the Microsoft Store, the builds are published on the **[GitHub releases page](https://github.com/microsoft/terminal/releases)**. If you install from GitHub, Windows Terminal will not automatically update with new versions. For additional installation options using a package manager (winget, chocolatey, scoop), see the **[Windows Terminal product repo](https://github.com/microsoft/terminal#other-install-methods)**.

After installation, when you open the terminal, it will start with PowerShell as the default profile in the open tab.
## Set your default terminal application ([Preview](https://aka.ms/terminal-preview))

![Windows Terminal first run](./images/first-run.png)
To open any command line application with Windows Terminal, set it as your default terminal application.

### Dynamic profiles
1. Open Windows Terminal and go to the **Settings** UI window.
2. Select **Startup** and choose "Windows Terminal" as the **Default terminal application** setting.

The terminal will automatically create profiles for you if you have WSL distros or multiple versions of PowerShell installed. Learn more about dynamic profiles on the [Dynamic profiles page](./dynamic-profiles.md).
![Screenshot of Windows Terminal Startup default in Settings UI](./images/settings-default-shell.png)

> [!IMPORTANT]
> This feature is only available in [Windows Terminal Preview](https://aka.ms/terminal-preview).

## Set your default terminal profile

After installation, when you open Windows Terminal, it will start with the [PowerShell](/powershell) command line as the default profile in the open tab.

To change the default profile:

1. Open Windows Terminal and go to the **Settings** UI window.
2. Select **Startup** and choose the **Default profile** that you prefer.

You can also [set your default profile in the Settings.json file](./customize-settings/startup.md#default-profile) associated with Windows Terminal if you prefer.

![Screenshot of Windows Terminal Settings default profile](./images/settings-default-profile.png)

## Add new profiles

Windows Terminal will automatically create profiles for you if you have WSL distributions or multiple versions of PowerShell installed.

Your command line profiles will be listed in the Settings UI, in addition to the option to **+ Add new** profiles.

Learn more about dynamic profiles on the [Dynamic profiles page](./dynamic-profiles.md).

![Screenshot of Windows Terminal Settings list of profiles](./images/settings-dynamic-profiles.png)

## Open a new tab

Expand Down
Binary file added TerminalDocs/images/settings-default-profile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TerminalDocs/images/settings-default-shell.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added TerminalDocs/images/settings-dynamic-profiles.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 1 addition & 2 deletions TerminalDocs/tutorials/powerline-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -109,8 +109,7 @@ wget https://github.com/JanDeDobbeleer/oh-my-posh/releases/latest/download/posh-
chmod +x /usr/local/bin/oh-my-posh
```

The second step is optional. Oh-my-posh can use the same theme config regardless of the shell or evironment, so if you're already using
it on Windows Powershell for example, you can reuse that theme configuration rather than download the themes.
The second step is optional. Oh-my-posh can use the same theme config regardless of the shell or environment, so if you're already using it on Windows Powershell for example, you can reuse that theme configuration rather than download the themes.
If you plan to use it within Ubuntu WSL only, fetch the [themes](https://ohmyposh.dev/docs/themes) so you can get started right away:

```bash
Expand Down