Skip to content

Commit

Permalink
June updates (#346)
Browse files Browse the repository at this point in the history
* 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.

* 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`

* Add note about escaping characters with backslash (#230)

Originally filed by Andrewery https://github.com/MicrosoftDocs/terminal/pull/134/files

* Add icon example and folder location (#231)

From #135

* Add icon example and folder location

As originally submitted by @aloneguid in #135

* Remove code brackets for readability

* Add spacing

* Fix default value by escaping characters (#232)

Original submission: https://github.com/MicrosoftDocs/terminal/pull/134/files

* 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 <mattwoj@microsoft.com>

* Add backslash escape note (#233)

...from PR #181

* Add a note about hiding dynamic profiles (#186)

* Add a note about hiding dynamic profiles

* Minor writing updates

Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>

* Clarify adding profile in ssh tutorial. Fixes #183 (#193)

* Clarify adding profile in ssh tutorial. Fixes: #183

* Remove  from docs link

* Add guid command for powershell (#234)

migrated from PR https://github.com/MicrosoftDocs/terminal/pull/199/files

* 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.

* 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.

* Add startingDirectory example (#237)

* Add startingDirectory example

* Format startingDirectory entry

* remove icon file type

Co-authored-by: Kayla Cinnamon <cinnamon@microsoft.com>

* Change icon description to example

* Change false to true

Co-authored-by: Kayla Cinnamon <cinnamon@microsoft.com>

* Remove unnecessary sentence

Co-authored-by: Kayla Cinnamon <cinnamon@microsoft.com>

* Typo fixes

Co-authored-by: Kayla Cinnamon <cinnamon@microsoft.com>

* link fix

Co-authored-by: Kayla Cinnamon <cinnamon@microsoft.com>

* Capitalization fixes

Co-authored-by: Kayla Cinnamon <cinnamon@microsoft.com>

* shortcut fixes

Co-authored-by: Kayla Cinnamon <cinnamon@microsoft.com>

* page_title_updates_terminal (#243)

* Add docs for `newWindow` action (#259)

* refactor(powerline): update for oh-my-posh V3 (#263)

* Improved title setting procedure on bash/Ubuntu so that it doesn't destroy `PS1` (#123)

Improved title setting procedure on bash/Ubuntu so that it doesn't destroy `PS1`

* Update powerline-setup.md (#240)

* Update powerline-setup.md

* Update powerline-setup.md

* Update powerline-setup.md

* fix typo

* Merge release 1.7 into master (#264)

Co-authored-by: Mike Griese <migrie@microsoft.com>
Co-authored-by: Don-Vito <khvitaly@gmail.com>

* Update powerline-setup.md (#175)

* Update powerline-setup.md

Updated Tips to include setting the Integrated terminal within Visual Studio to use the Cascadia Code Powerlines font.
Also added an additional resource which shows step by step how to do this

* Combine VS Code & VS tips for setting up powerline

* Remove external blog link

Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>

* Fix a monor typo with the default keybinding for new tab (#287)

closes #270

* Add a note that --window is only available in 1.7+ (#288)

* Add a note that --window is only available in 1.7+

  closes #282

* Whoops, those can't go on one line

* Fix a typo in this doc (#289)

* Fix a typo in this doc

Closes #280

* I bet the docs build is gonna complain about this one

* Add a FAQ entry for folks who are confused when Settings does nothing (#290)

* Add a note that you can't set the tab color from the commandline (#291)

Closes #249

* Add UUID generator option

* Add online guid generator

* Add instructions to open defaults.json file

* Update panes.md

* Add note about using settings.json...

..not defaults.json for applying color schemes across profiles.

* fix link

* Merge release-1.8 into master (#309)

Co-authored-by: Kayla Cinnamon <cinnamon@microsoft.com>
Co-authored-by: Don-Vito <khvitaly@gmail.com>
Co-authored-by: Mike Griese <migrie@microsoft.com>

* Fix placement of unfocused appearance section (#312)

* Update TerminalDocs/command-line-arguments.md

* Update TerminalDocs/command-line-arguments.md

* Add mouse interaction section (#297)

Addresses issue #6

* document how to start windows terminal and have it execute a command (#298)

* document how to start windows terminal and have it execute a command #296

* Separated the argument examples 

and included explanations of what they accomplish

* fix typo

* remove version from url

Co-authored-by: Mark Iannucci <mark.iannucci@dhha.org>
Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>

* FIX syntax error in json configuration example (#308)

FIX syntax error in json configuration example

* Document trimBlockSelection setting (#313)

* Document trimBlockSelection setting

* Add preview disclaimer

* Minor edit + note re how to select rectangular txt

* Add preview to h2

Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>

* Updated openSettings default bindings. (#317)

* Updated openSettings default bindings.

* Updated the openSettings description.

* minor edits

Co-authored-by: Matt Wojciakowski <mattwoj@microsoft.com>

* Update powerline-setup.md (#319)

Fix a typo 'optonal' replaced by 'optional'

* Updates for 1.9 release (#328)

* Fix links

* Typo "Windows terminal"→"Windows Terminal" (#326)

https://docs.microsoft.com/en-us/windows/terminal/custom-terminal-gallery/custom-schemes
#PingMSFTDocs

* Add link to alternative install options (#321)

Resolves #286

* Update `cursorHeight` minimum value (#278)

Documentation update for microsoft/terminal#9386

* Add link to install preview (#342)

* Add link to install preview

* Update wording

Co-authored-by: Kayla Cinnamon <cinnamon@microsoft.com>

* Update default settings, add UI screenshots (#343)

* Update default settings, add UI screenshots

* update screenshot

* fix numbering

* Fix screenshot steps

* Correct title verbage, update screenshot

* Add preview tags

* Fix typos

Co-authored-by: Kayla Cinnamon <cinnamon@microsoft.com>

Co-authored-by: Samuel Bronson <naesten@gmail.com>
Co-authored-by: LSC <schad.lucas@gmail.com>
Co-authored-by: skycommand <jadangerbrooks@hotmail.com>
Co-authored-by: Mike Griese <migrie@microsoft.com>
Co-authored-by: Cameron Durham <cdurham@usc.edu>
Co-authored-by: Søren Fuglede Jørgensen <github@fuglede.dk>
Co-authored-by: Janne Mareike Koschinski <janne@kuschku.de>
Co-authored-by: Kayla Cinnamon <cinnamon@microsoft.com>
Co-authored-by: Meenal Patel <42360097+v-mepa@users.noreply.github.com>
Co-authored-by: Jan De Dobbeleer <2492783+JanDeDobbeleer@users.noreply.github.com>
Co-authored-by: Dakkaron <dak1st@gmx.at>
Co-authored-by: Ibrahim Rouis <73853380+rouisibra@users.noreply.github.com>
Co-authored-by: Don-Vito <khvitaly@gmail.com>
Co-authored-by: Michael James <mike@mjjames.co.uk>
Co-authored-by: Mark Iannucci <mark.iannucci@gmail.com>
Co-authored-by: Mark Iannucci <mark.iannucci@dhha.org>
Co-authored-by: lpotherat <l.potherat@planetb.fr>
Co-authored-by: Sean Jacobs <Sophismata@users.noreply.github.com>
Co-authored-by: superfaz <16510828+superfaz@users.noreply.github.com>
Co-authored-by: Hiroshi Yoshioka <40815708+hyoshioka0128@users.noreply.github.com>
Co-authored-by: Eugene Samoylov <eugenesmlv@gmail.com>
  • Loading branch information
22 people committed Jun 18, 2021
1 parent 8cbe06e commit aef98f0
Show file tree
Hide file tree
Showing 7 changed files with 40 additions and 12 deletions.
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

0 comments on commit aef98f0

Please sign in to comment.