Skip to content

Commit d7729a7

Browse files
authored
pull base content,head:MicrosoftDocs:main,into:wwlpublishsync
2 parents 45e693c + 989f806 commit d7729a7

File tree

46 files changed

+919
-68
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+919
-68
lines changed

learn-pr/windows/develop-web-apps-with-vs-code/includes/1-introduction.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
Visual Studio Code is an open source, lightweight, and full-featured text editor that supports a multitude of extensions for all kinds of developers. If you are getting started in the larger world of web development, Visual Studio Code can be a valuable tool. Features such as build scripts, environments, debugging, and more, combined with its role of powerful text editor, are of particular value to new developers. Visual Studio Code handles all this in one environment without the traditionally heavy integrated development environment (IDE).
1+
Visual Studio Code is an open source, lightweight, and full-featured text editor that supports a multitude of extensions for all kinds of developers. If you're getting started in the larger world of web development, Visual Studio Code can be a valuable tool. Features such as build scripts, environments, debugging, and more, combined with its role of powerful text editor, are of particular value to new developers. Visual Studio Code handles all of these features in one environment without the traditionally heavy integrated development environment (IDE).
22

3-
Visual Studio Code is built on a platform called Electron, and is available for Windows, macOS, and Linux. This learning module will be as platform-independent as possible. Though some screenshots may be from specific platforms, the information should transfer to any platform with some minor adaptation (for example, shortcut key combinations).
3+
Visual Studio Code is built on a platform called Electron, and is available for Windows, macOS, and Linux. This learning module is as platform-independent as possible. Though some screenshots might be from specific platforms, the information should transfer to any platform with some minor adaptation.
44

55
Here's a list of some of Visual Studio Code's key features:
66

@@ -14,4 +14,4 @@ Here's a list of some of Visual Studio Code's key features:
1414
- Open source
1515
- Extensible
1616

17-
In this module, you will learn how to install and use Visual Studio Code with some basic web development extensions, then use these features to make a *very* simple web application. Even if you've never written a web app, you'll still be successful with this module. And if you are an experienced web developer, you can still learn many useful things here to get you started with Visual Studio Code.
17+
In this module, you learn how to install and use Visual Studio Code with some basic web development extensions, then use these features to make a basic web application. Even if you have never written a web app, you can still be successful with this module. And if you're an experienced web developer, you can still learn many useful things here to get you started with Visual Studio Code.

learn-pr/windows/develop-web-apps-with-vs-code/includes/2-installation-and-tour.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -2,39 +2,39 @@ To begin, let's download and install Visual Studio Code locally, then take a sho
22

33
## Download
44

5-
Browse to [https://code.visualstudio.com](https://code.visualstudio.com) and select the stable build for your platform. The Insiders Edition is like using a beta test version of the next update, but is not applicable for this learning module. If you don't see your specific platform, select [Other downloads](https://code.visualstudio.com/#alt-downloads) to see all currently supported builds.
5+
Browse to [https://code.visualstudio.com](https://code.visualstudio.com) and select the stable build for your platform. The Insiders Edition is like using a beta test version of the next update, but isn't applicable for this learning module. If you don't see your specific platform, select [Other downloads](https://code.visualstudio.com/#alt-downloads) to see all currently supported builds.
66

77
## Install
88

9-
During installation, be sure to check out the options presented and select any opt-in features you'd like. These options are mostly for convenience and personal preference, so you can accept the defaults to simplify your installation. Below are the Windows options and their defaults.
9+
During installation, be sure to check out the options presented and select any opt-in features you'd like. These options are mostly for convenience and personal preference, so you can accept the defaults to simplify your installation. The following image shows the Windows options and their defaults.
1010

11-
![Windows installation options.](../media/install-options.PNG)
11+
![Screenshot that shows the Windows installation options for Visual Studio Code.](../media/2-visual-studio-code-install-options-2023.png)
1212

13-
Take a moment on first run to check for available updates. On Windows, this can be easily done using the **Help** pulldown menu and selecting **Check for Updates**. This option may appear in other pulldown menu locations on other platforms.
13+
Take a moment on first run to check for available updates. On Windows, updates can be done using the **Help** pulldown menu and selecting **Check for Updates**. This option may appear in other pulldown menu locations on other platforms.
1414

1515
## Tour
1616

17-
Let's take a look at a few key features of the user interface, and a short tour of Visual Studio Code's core functionality. When you first run Visual Studio Code, you should see a "Welcome" page similar to the screenshot below. If you don't see the Welcome page, you can access it using the **Help > Welcome** dropdown menu item.
17+
Let's take a look at a few key features of the user interface, and a short tour of Visual Studio Code's core functionality. When you first run Visual Studio Code, you should see a "Welcome" page similar to the following screenshot. If you don't see the Welcome page, you can access it using the **Help > Welcome** dropdown menu item.
1818

19-
![First run after installation.](../media/welcome.PNG)
19+
:::image type="content" source="../media/2-visual-studio-code-welcome.png" alt-text="Screenshot that shows the Visual Studio Code Welcome screen after the initial installation." lightbox="../media/2-visual-studio-code-welcome.png":::
2020

2121
### User interface
2222

23-
The first thing you'll probably notice is how simple the interface seems to be. This is intentional, but hides the true power of this editor. For now, familiarize yourself with the main UI components.
23+
The first thing you probably notice is how simple the interface seems to be. This simplicity is intentional, but hides the true power of this editor. For now, familiarize yourself with the main UI components.
2424

25-
![User interface components.](../media/interface.PNG)
25+
![Screenshot that shows the Visual Studio Code user interface components with arrow callouts and keyboard shortcuts displayed.](../media/2-visual-studio-code-interface-2023.png)
2626

27-
One UI function you are likely to find quite valuable is the Command Palette (F1 on any platform, Ctrl + Shift + P on Windows, and listed under the **View** dropdown menu). It's a great starting place if you have an idea what you'd like to do in Visual Studio Code, but can't recall exactly how to do it.
27+
One UI function you're likely to find valuable is the Command Palette, which is F1 on any platform, Ctrl + Shift + P on Windows, and is listed under the **View** dropdown menu. It's a great starting place if you have an idea of what you'd like to do in Visual Studio Code, but can't recall exactly how to do it.
2828

29-
![Command palette.](../media/F1.PNG)
29+
:::image type="content" source="../media/2-visual-studio-code-command-palette.png" alt-text="Screenshot that shows Visual Studio Code with the command palette open." lightbox="../media/2-visual-studio-code-command-palette.png":::
3030

31-
By default, the Command Palette comes up in Command mode, signified by the `>` prompt. This mode includes most Visual Studio Code functionality, including finding keyboard shortcuts. But there's far more available here. For a list, press F1 + backspace to remove the command prompt (`>`) and type a question mark (`?`). Take a moment to explore these modes if you'd like.
31+
By default, the Command Palette comes up in Command mode, signified by the `>` prompt. This mode includes most Visual Studio Code functionality, including finding keyboard shortcuts. But there's far more available here. For a list, press F1 + backspace to remove the command prompt `>` and type a question mark `?`. Take a moment to explore these modes if you'd like.
3232

3333
### Color themes
3434

35-
Changing the look of your editor is a big deal to most of us. Visual Studio Code makes it easy with Themes. On the Welcome page, select **Color theme** under **Customize** and you'll see something like the following.
35+
Changing the look of your editor is important to most of us. Visual Studio Code makes it easy with Themes. On the Welcome page, select **Color theme** under **Customize** and you see something like the following screenshot:
3636

37-
![Color themes list.](../media/color-themes.PNG)
37+
:::image type="content" source="../media/2-visual-studio-code-color-themes-2023.png" alt-text="Screenshot that shows Visual Studio Code with the Color theme options displayed." lightbox="../media/2-visual-studio-code-color-themes-2023.png":::
3838

3939
> [!NOTE]
4040
> You can also get to this list in other ways, such as the Command palette, pulldown menus, and keyboard shortcuts.
@@ -43,8 +43,8 @@ Take this opportunity to try our different color themes. If the default themes a
4343

4444
### Tools and extensions
4545

46-
Click on the **Tools and languages** topic under **Customize** and you'll see the left pane expand to show the current list of available extensions, similar to what you see below. You can also use the **View** menu and select **Extensions**. Note that the first option adds the filter `@category:"programming languages"` to the extensions list, to show only extensions in that category. You can edit this filter yourself, or clear it with the **Clear Extensions Input** button (highlighted in the screenshot below).
46+
Select **Tools and languages** under **Customize** and see the left pane expand to show the current list of available extensions, similar to what you see in the next screenshot. You can also use the **View** menu and select **Extensions**. The first option adds the filter `@category:"programming languages"` to the extensions list, to show only extensions in that category. You can edit this filter yourself, or clear it with the **Clear Extensions Input** button.
4747

48-
![Tools and Languages Extensions.](../media/tools-list.PNG)
48+
:::image type="content" source="../media/2-visual-studio-code-extensions.png" alt-text="Screenshot that shows the Extensions menu selected in Visual Studio Code.":::
4949

50-
We won't install any of these right now, but feel free to take a moment to scroll through the list to get an idea of the varied options available. We'll discuss extensions in more depth in the next unit.
50+
We're not installing any of these extensions right now, but take a moment to scroll through the list to get an idea of the various options. We'll discuss extensions in more depth in the next unit.
Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,57 +1,57 @@
1-
In this unit, you'll learn how easy it is to locate and install Visual Studio Code extensions. As seen previously, Visual Studio Code installs with many built-in extensions, but it does not come bundled with support for every development language and environment. By using the Extensions Marketplace, you can locate the tools, languages, and debuggers you need for your particular workflow and personal preference. Additionally, there are many extensions that add to the powerful features of Visual Studio Code for even greater customization and control, efficiency, and maybe even some fun.
1+
In this unit, learn how easy it is to locate and install Visual Studio Code extensions. As seen previously, Visual Studio Code installs with many built-in extensions, but it doesn't come bundled with support for every development language and environment. By using the Extensions Marketplace, you can locate the tools, languages, and debuggers you need for your particular workflow and personal preference. Additionally, there are many extensions that add to the powerful features of Visual Studio Code for even greater customization and control, efficiency, and maybe even some fun.
22

33
## Extension Marketplace
44

5-
In the previous unit, you saw the default list presented when you access the Extension Marketplace. Let's look more closely at that, and install a few things.
5+
In the previous unit, you saw the default list presented when you access the Extension Marketplace. Let's look more closely at that list, and then install a few things.
66

77
### Searching for extensions
88

9-
On the left of the Visual Studio Code UI is the Activity Bar. If you do not see an Activity Bar, toggle it on by navigating the pulldown menu sequence: **View > Appearance > Show Activity Bar**. The **Extensions** icon is the highlighted icon in the following graphic.
9+
The Activity Bar is on the left of the Visual Studio Code UI. If you don't see an Activity Bar, toggle it on by navigating the pulldown menu sequence: **View > Appearance > Show Activity Bar**. The **Extensions** icon is the highlighted icon in the following graphic.
1010

11-
![Extensions Marketplace icon.](../media/activity-icon-extensions.png)
11+
:::image type="content" source="../media/3-visual-studio-code-select-extension.png" alt-text="Screenshot that shows the Visual Studio Code Extension icon highlighted with a red box on the Activity Bar.":::
1212

13-
By default, all activity icons are showing. If you don't see this icon, right-click in the vacant area of the Activity Bar to see the list of available icons, and select **Extensions**. Open the Extensions list by selecting the icon shown below.
13+
By default, all activity icons are showing. If you don't see this icon, right-click in the vacant area of the Activity Bar to see the list of available icons, and select **Extensions**. Select the Extension icon to open the Extensions list.
1414

1515
> [!NOTE]
16-
> There is a keyboard shortcut for extensions. Hover your mouse over the **Extensions** icon to see yours (varies by platform).
16+
> There's a keyboard shortcut for extensions. Hover your mouse over the **Extensions** icon to see yours (varies by platform).
1717
18-
Since this is your first time installing any extensions, you'll see only a list of popular extensions on the marketplace.
18+
Since it's your first time installing any extensions, you see only a list of popular extensions on the marketplace.
1919

20-
![Example list of extensions.](../media/default-extensions-list.png)
20+
:::image type="content" source="../media/2-visual-studio-code-extensions.png" alt-text="Screenshot that shows the Extensions button selected in Visual Studio Code.":::
2121

22-
This list is one way to browse, but with so many extensions available, it's usually quicker to use the Search box at the top.
22+
This list is one way to browse, but with so many extensions available, it's quicker to use the Search box at the top.
2323

2424
To give you an idea of the variety of choices available for a given category of extensions, type **icons** in the search box. You should see many pages of extensions, sorted by default order (a combination of install count and rating). You can sort more specifically by choosing a sort from the ellipsis icon (`...`) in the upper-right corner of the Extensions area.
2525

2626
### Installing and managing extensions
2727

28-
Installing is as easy as clicking the **Install** button on an extension entry in the Marketplace. Let's install a few now. Use the Search box to locate the extensions listed below, and then use the **Install** button on each (we'll get into the function of each of these later):
28+
Installing is as easy as clicking the **Install** button on an extension entry in the Marketplace. Let's install a few now. Use the Search box to locate the following extensions, and then use the **Install** button on each:
2929

3030
- Material Theme
3131
- Prettier Now
3232
- Bracket Pair Colorizer
3333
- Live Server
3434

35-
While installing, removing, disabling, and enabling extensions, the button may change into a **Reload** button. Be sure to select it if applicable.
35+
While you install, remove, disable, and enable extensions, the button might change into a **Reload** button. Select it if applicable.
3636

3737
#### Material Theme
3838

39-
Just for fun, let's play around with this one a little bit. Once it's installed and ready, bring up the Color Themes (remember, there are many ways to get there, from pull-down menu sequences to keyboard shortcuts and the Welcome page). We use the direct shortcut Ctrl-K, Ctrl-T (Cmd-K, Cmd-T on macOS). Now use the up and down arrow keys to change the theme. You'll see the change immediately as you select new themes. Try out some of the Material Themes that now appear in the list to find one you like. Even if you don't select one you prefer now, if you're like many of us, you'll eventually enjoy a quick change to the color theme once in a while. Adding lots of choices can help you with this, so feel free to add more themes.
39+
Just for fun, let's play around with this extension slightly. Once it's installed and ready, bring up the Color Themes (remember, there are many ways to get there, from pull-down menu sequences to keyboard shortcuts and the Welcome page). We use the direct shortcut Ctrl-K, Ctrl-T (Cmd-K, Cmd-T on macOS). Now use the up and down arrow keys to change the theme. You can see the change immediately as you select new themes. Try out some of the Material Themes that appear in the list to find one you like. Even if you don't select one you prefer now, if you're like many of us, you enjoy a quick change to the color theme on occasion. Adding lots of choices can help you with this change, so feel free to add more themes.
4040

4141
This extension is here to illustrate customization features. You can safely remove or disable it if you don't like it.
4242

4343
#### Prettier Now
4444

45-
This extension is a *beautifier*. In case you aren't already aware, this term refers to an editor's ability to format your code automatically using certain rules the designer has decided work well for the type of code you're' working with, so it can be a subtle but powerful tool to use. There are many beautifiers available in the Extensions Marketplace, but this one has a lot of options and is easy to use.
45+
This extension is a *beautifier*. This term refers to an editor's ability to format your code automatically by using certain rules that the designer thinks work well for the type of code you working with. It can be a subtle but powerful tool to use. There are many beautifiers available in the Extensions Marketplace, but this one has many options and is easy to use.
4646

4747
Again, if you don't care for this extension, feel free to disable it or choose a different one.
4848

4949
#### Bracket Pair Colorizer
5050

51-
As with the beautifier and theme we installed, this is an extension that can help you code more efficiently with visual feedback, but isn't required for web development. However, this extension can truly save you a lot of time troubleshooting, and provide your eyes some relief.
51+
As with the beautifier and theme we installed, this extension can help you code more efficiently with visual feedback, but isn't required for web development. However, this extension can save you much time troubleshooting, and provide your eyes with some relief.
5252

5353
#### Live Server
5454

55-
This extension provides a local development server with a live reload feature for static and dynamic pages. This greatly eases web development by providing real-time updates to your content in a web browser. As with most extensions, there are other choices for this functionality in the Marketplace, but we'll use this one for now.
55+
This extension provides a local development server with a live reload feature for static and dynamic pages. It greatly eases web development by providing real-time updates to your content in a web browser. As with most extensions, there are other choices for this functionality in the marketplace, but we're going to use this one for now.
5656

57-
This is the only extension here that we'll be using in later units, and other modules might also direct you to install it or a similar extension. Next, we'll put together a simple web page and you'll see how this extension works.
57+
This extension is the only one here that we use in later units, and other modules might also direct you to install it or a similar extension. Next, we put together a simple web page and you can see how this extension works.

0 commit comments

Comments
 (0)