Skip to content

Commit ff42e13

Browse files
docs(common): content for server blazor first steps
1 parent 7073f9d commit ff42e13

File tree

6 files changed

+29
-72
lines changed

6 files changed

+29
-72
lines changed

_contentTemplates/common/get-started.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,3 +39,10 @@ You can also use the official VS 2019 installation and enable the .NET Core 3.0
3939
>note Once you have the Blazor application running, continue to the next steps.
4040
#end
4141

42+
43+
#add-nuget-feed
44+
## Add the Telerik NuGet Feed to Visual Studio
45+
46+
Telerik UI for Blazor is distributed through our private NuGet feed. Follow the [Setup the Telerik Private NuGet Feed]({%slug installation/nuget%}) article to set this up in case you don't have it already.
47+
#end
48+

getting-started/client-blazor.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ position: 1
1010

1111
# First Steps with Client-side UI for Blazor
1212

13-
This article explains how to get the Telerik UI for Blazor components in your Client-side Blazor project and start using them quickly. The process consists of the following steps:
13+
This article explains how to get the Telerik UI for Blazor components in your **Client-side** Blazor project and start using them quickly. The process consists of the following steps:
1414

1515
1. [Set Up a Blazor Project](#set-up-a-blazor-project)
1616
1. [Add the Telerik NuGet Feed to Visual Studio](#add-the-telerik-nuget-feed-to-visual-studio)
@@ -114,4 +114,4 @@ The final step is to actually use a component on a view and run it in the browse
114114

115115
Now you have the Telerik components running in your Blazor app.
116116

117-
Next, you can explore the [live demos](https://demos.telerik.com/blazor) and the [examples repo](https://github.com/telerik/ui-for-blazor-examples/) we have.
117+
Next, you can explore the [live demos](https://demos.telerik.com/blazor) and the rest of the documentation.
25.9 KB
Loading
38.1 KB
Loading
42 KB
Loading

getting-started/server-blazor.md

Lines changed: 20 additions & 70 deletions
Original file line numberDiff line numberDiff line change
@@ -1,81 +1,31 @@
11
---
2-
title: First Steps
3-
page_title: First Steps with UI for Blazor
4-
description: First Steps with UI for Blazor
2+
title: Server-side Blazor
3+
page_title: First Steps with Server-side UI for Blazor
4+
description: First Steps with UI for Blazor Server-side
55
slug: getting-started/server-side
6-
tags: get,started,first,steps
7-
published: True
6+
tags: get,started,first,steps,server
7+
published: true
88
position: 1
99
---
1010

11-
# First Steps with UI for Blazor
11+
# First Steps with Server-side UI for Blazor
1212

13-
This article explains how to get the Telerik UI for Blazor components in your project and start using them quickly. The process consists of the following steps:
13+
This article explains how to get the Telerik UI for Blazor components in your **Server-side** Blazor project and start using them quickly. The process consists of the following steps:
1414

1515
1. [Set Up a Blazor Project](#set-up-a-blazor-project)
1616
1. [Add the Telerik NuGet Feed to Visual Studio](#add-the-telerik-nuget-feed-to-visual-studio)
1717
1. [Add the Telerik Components to Your Project](#add-the-telerik-components-to-your-project)
1818
1. [Add a Telerik Component to a View](#add-a-telerik-component-to-a-view)
1919

20-
<!-- Once you have your first simple control up and running, take a look at the [next steps](#next-steps) section to start exploring the control functionality in more detail.-->
20+
@[template](/_contentTemplates/common/get-started.md#add-latest-ms-bits-server-side-link)
2121

22-
## Set Up a Blazor Project
2322

24-
[Blazor](https://blazor.net/) is still an experimental technology, so you need to ensure you can run its vanilla version first. To do that, follow the MSDN tutorial and make sure that you can run the basic sample Blazor application: [https://docs.microsoft.com/en-us/aspnet/core/client-side/spa/blazor/get-started](https://docs.microsoft.com/en-us/aspnet/core/client-side/spa/blazor/get-started).
25-
26-
>tip Make sure that you have the latest bits installed (ASP.NET Core 3.0 and Visual Studo 2019 Preview channel are required). You can also use the official VS 2019 installation and enable the .NET Core 3.0 Preview in Tools > Options > Projects and Solutions > .NET Core -> select "Use previews of the .NET Core SDK".
27-
28-
Once you have a Blazor application running, continue to the next steps.
29-
30-
## Add the Telerik NuGet Feed to Visual Studio
31-
32-
Telerik UI for Blazor is distributed through our private NuGet feed. If you already have that working (for exapmle, you have used other tools of ours through it), skip to the [Add the Telerik Components to Your Project](#add-the-telerik-components-to-your-project) section.
33-
34-
To add the Telerik private NuGet feed, follow the steps below:
35-
36-
1. Download the [latest NuGet executable](https://dist.nuget.org/win-x86-commandline/latest/nuget.exe).
37-
1. Open a Command Prompt and change the path to where the `nuget.exe` is downloaded.
38-
1. Execute the command from the example below.
39-
40-
### Store Encrypted Credentials
41-
42-
The command from the example below stores a token in the `%AppData%\NuGet\NuGet.config` file. Your original credentials cannot be obtained from this token.
43-
44-
>note If you are unable to connect to the feed by using encrypted credentials, try the alternative approach of storing credentials in clear text explained below. The ASP.NET Core tooling this steps on does not fully support encrypted credentials.
45-
46-
>caption Store Encrypted Credentials for the Telerik NuGet feed
47-
48-
```
49-
NuGet Sources Add -Name "telerik.com" -Source "https://nuget.telerik.com/nuget" ^
50-
-UserName "your login email" -Password "your password"
51-
```
52-
53-
### Store Credentials in Clear Text for the Telerik NuGet feed
54-
55-
The command from the example below stores the password in clear text in the `%AppData%\NuGet\NuGet.config` file. If you are unable to connect to the feed using encrypted credentials, use this alternative approach.
56-
57-
>caption Store Plain-text Credentials for the Telerik NuGet feed
58-
59-
```
60-
NuGet Sources Add -Name "telerik.com" -Source "https://nuget.telerik.com/nuget" ^
61-
-UserName "your login email" -Password "your password" ^
62-
-StorePasswordInClearText
63-
```
64-
65-
If you have already stored a token instead of storing the credentials as clear text, update the definition in the `%AppData%\NuGet\NuGet.config` file by using the following command.
66-
67-
>caption Update Plain-text Credentials for the Telerik NuGet feed
68-
69-
```
70-
NuGet Sources Update -Name "telerik.com" -Source "https://nuget.telerik.com/nuget" ^
71-
-UserName "your login email" -Password "your password" ^
72-
-StorePasswordInClearText
73-
```
23+
@[template](/_contentTemplates/common/get-started.md#add-nuget-feed)
7424

7525

7626
## Add the Telerik Components to Your Project
7727

78-
We recommend the usage of `Blazor (ASP.NET Hosted)` project. If you have one, go to the [Add to Existing Project](#add-to-existing-project) section below.
28+
To use Blazor server-side, you need to use the `Razor Components` type of project. If you have one, go to the [Add to Existing Project](#add-to-existing-project) section below.
7929

8030
If you don't have a Blazor project set up, first you need to create one:
8131

@@ -87,9 +37,9 @@ If you don't have a Blazor project set up, first you need to create one:
8737

8838
![Create new ASP.NET Core Web Application](images/create-new-application.jpg)
8939

90-
1. Choose the `Blazor (ASP.NET Hosted)` project type and click `Create`.
40+
1. Choose the `Razor Components` project type and click `Create`.
9141

92-
![Select Blazor Project Type](images/choose-project-template.png)
42+
![Select Blazor Project Type](images/choose-project-template-server-blazor.png)
9343

9444

9545
### Add to Existing Project
@@ -100,34 +50,34 @@ To get access to the UI for Blazor components, follow these steps:
10050

10151
1. Install the `Telerik.UI.for.Blazor` NuGet package to your Blazor project. If you do not see it in the `telerik.com` feed, wait for a about 20-30 minutes after activating the trial:
10252

103-
1. Right-click on the `Client` project in the solution and select `Manage NuGet Packages`:
53+
1. Right-click on the project in the solution and select `Manage NuGet Packages`:
10454

105-
![](images/manage-nuget-packages-for-client-app.png)
55+
![](images/manage-nuget-packages-for-server-app.png)
10656

10757
1. Choose the `telerik.com` feed, find the `Telerik.UI.for.Blazor` package and click `Install`:
10858

10959
![Add Telerik Blazor Package to Client Project](images/add-telerik-nuget-to-client-app.png)
11060

111-
1. Open the `_ViewImports.cshtml` at the root of the client web application and add the following line to register the Telerik components for the entire project:
61+
1. Open the `~/Components/_ViewImports.cshtml` file and add the following line to register the Telerik components for all component files:
11262

11363
**CSHTML**
11464

11565
@addTagHelper *,Telerik.Blazor
11666

117-
1. Open the `~/wwwroot/index.html` file in the client web application and register the [Theme stylesheet]({%slug general-information/themes%}) (make sure to use the correct version that matches the official Kendo UI for jQuery release number):
67+
1. Open the `~/Pages/Index.cshtml` and register the [Theme stylesheet]({%slug general-information/themes%}) (note the escaping for the `@` symbol):
11868

11969
**HTML**
12070

121-
<link id="kendoCss" rel="stylesheet" href="https://unpkg.com/@progress/kendo-theme-default@latest/dist/all.css" />
71+
<link id="kendoCss" rel="stylesheet" href="https://unpkg.com/@@progress/kendo-theme-default@@latest/dist/all.css" />
12272

12373

124-
Now your project can use the Telerik UI for Blazor components in all its views.
74+
Now your project can use the Telerik UI for Blazor components in all its component files.
12575

12676
## Add a Telerik Component to a View
12777

12878
The final step is to actually use a component on a view and run it in the browser. For example:
12979

130-
1. **Add** a **Button** component to the `~/Pages/Index.cshtml` view:
80+
1. **Add** a **Button** component to the `~/Components/Pages/Index.cshtml` view:
13181

13282
**CSHTML**
13383

@@ -162,4 +112,4 @@ The final step is to actually use a component on a view and run it in the browse
162112

163113
Now you have the Telerik components running in your Blazor app.
164114

165-
Next, you can explore the [live demos](https://demos.telerik.com/blazor) and the [examples repo](https://github.com/telerik/ui-for-blazor-examples/) we have.
115+
Next, you can explore the [live demos](https://demos.telerik.com/blazor) and the rest of the documentation.

0 commit comments

Comments
 (0)