譯者：Lamond Lu

譯文：https://www.cnblogs.com/lwqlun/p/10894497.html

原文作者：Maria

原文鏈接：https://devblogs.microsoft.com/dotnet/creating-interactive-net-documentation/

背景

當(dāng)我們編寫(xiě)開(kāi)發(fā)人員使用的文檔時(shí)，我們需要捕捉他們的興趣，并引導(dǎo)他們盡快走上成功的道路。開(kāi)發(fā)人員生態(tài)系統(tǒng)一直在為社區(qū)提供可交互的文檔，用戶可以一個(gè)地方閱讀文檔，運(yùn)行代碼并進(jìn)行編輯。

在過(guò)去的2年里，.NET語(yǔ)言團(tuán)隊(duì)一直在不斷發(fā)展Try .NET, 以支持在線和離線的交互式文檔。

什么是Try .NET

Try .NET是一個(gè)基于.NET Core的交互式文檔生成器。

控制臺(tái)標(biāo)簽頁(yè)： *WASM Initialized*

網(wǎng)絡(luò)標(biāo)簽頁(yè)： DLLs

Try .NET提供了全局工具dotnet try, 以方便.NET開(kāi)發(fā)人員創(chuàng)建可交互的Markdown文件。

為了使你的Markdown文件具有交互性，你需要安裝.NET Core的SDK, 全局工具dotnet try, 以及Visual Studio / VS Code。

使用Try .NET, 我們可以擴(kuò)展隔離代碼塊，給它添加一些額外的參數(shù)。

``` cs --region methods --source-file .myappProgram.cs --project .myappmyapp.csproj 
var name ='Rain';
Console.WriteLine($'Hello {name.ToUpper()}!');
```

使用

在Markdown中，我們擴(kuò)展了代碼塊，提供了--region參數(shù)，用它可以指定C代碼中的分塊(region)。

所以，你的Program.cs文件看起來(lái)可能是這樣的。

嘗試使用全局工具dotnet try

dotnet try現(xiàn)在已經(jīng)可以使用了。這是一個(gè)dotnet try全局工具的早期預(yù)覽版，你可以從我們的倉(cāng)儲(chǔ)克隆代碼。

入門

• 克隆代碼倉(cāng)儲(chǔ)

• 簽出Samples分支

• 安裝.NET Core 2.1或3.0預(yù)覽版

• 打開(kāi)控制臺(tái)窗口

• 安裝Try .NET全局工具

dotnet tool install --global dotnet-try --version 1.0.19264.11

更新dotnet try也很簡(jiǎn)單，只需要運(yùn)行如下命令

定位到當(dāng)前倉(cāng)儲(chǔ)的Samples目錄，輸入dotnet try

瀏覽器會(huì)自動(dòng)打開(kāi)

●編號(hào)317，輸入編號(hào)直達(dá)本文

●輸入m獲取文章目錄