Microsoft.DocAsCode.Dotnet 2.67.5
前缀已保留
Docfx 已完全过渡,成为完全由社区驱动的 .NET 基金会项目,以造福社区。因此,我们正在将 NuGet 包名称、程序集名称和命名空间名称从 Microsoft.DocAsCode.* 更改为 Docfx.*。
dotnet add package Microsoft.DocAsCode.Dotnet --version 2.67.5
NuGet\Install-Package Microsoft.DocAsCode.Dotnet -Version 2.67.5
<PackageReference Include="Microsoft.DocAsCode.Dotnet" Version="2.67.5" />
paket add Microsoft.DocAsCode.Dotnet --version 2.67.5
#r "nuget: Microsoft.DocAsCode.Dotnet, 2.67.5"
// Install Microsoft.DocAsCode.Dotnet as a Cake Addin #addin nuget:?package=Microsoft.DocAsCode.Dotnet&version=2.67.5 // Install Microsoft.DocAsCode.Dotnet as a Cake Tool #tool nuget:?package=Microsoft.DocAsCode.Dotnet&version=2.67.5
使用 docfx 构建您的文档
使用 docfx,带上页、Markdown、.NET、REST API 以及更多构建您的技术文档网站。
⚠️⚠️⚠️ 注意⚠️⚠️⚠️
DocFX 正在过渡到 .NET 基金会,作为一个官方 .NET 项目!
- DocFX 团队正在改进主分支。这将为项目引入新的功能和错误修复,删除一些不再必要的较旧代码和功能,以及更新依赖关系和简化项目结构。请关注路线图。
- 由于网站架构变更,DocFX无法再直接支持构建Microsoft Learn内容。包含Microsoft Learn Markdown内容的开源仓库仍将接受pull请求和更改,但不能直接使用DocFX构建。
- 未来,我们只将支持将该工具作为新网站的静态站点生成器,而不是用于在Microsoft Learn上构建官方Microsoft内容的工具。
入门指南
安装docfx作为全局工具
dotnet tool install -g docfx
在本地创建并启动一个网站
docfx init -q docfx build docfx_project\docfx.json --serve
访问 https://127.0.0.1:8080 以查看示例网站。
有关更多信息,请参阅入门。
贡献
有关问题和一般讨论,请在讨论中使用。有关错误报告和功能建议,请在问题中使用。
我们欢迎通过pull请求提交代码贡献,标记为 help-wanted
的是开始贡献代码的好选择。
先决条件
- 安装Visual Studio 2022(社区版或更高版本)并确保您拥有最新更新。
- 安装
.NET Core SDK 6.x和7.x。 - 安装NodeJS(16.x.x)。
- 可选:在Windows上安装wkhtmltopdf以测试使用
choco install wkhtmltopdf
的PDF。
构建和测试
- 在
templates
目录中构建网站模板- 运行
npm install
以还原npm依赖项。 - 运行
npm run build
以构建模板。
- 运行
- 运行
dotnet build
来构建项目或使用Visual Studio构建docfx.sln
。 - 运行
dotnet test
来测试项目或使用Visual Studio测试资源管理器。- 运行
git lfs checkout
以检出文件进行快照测试
- 运行
分支和发布
main
分支是pull请求和大多数其他开发活动的默认分支。我们偶尔会使用feature/*
分支进行史诗级功能开发。
发布基于一个稳定的main
分支提交,使用GitHub Releases。鼓励使用常规提交。
Docfx不会按照常规节奏发布,新版本何时到来取决于维护者认为更改足够多,需要新的版本。有时我们会使用预发布版来尝试破坏性更改并从社区获得反馈。
路线图
我们使用里程碑来传达即将到来的docfx更改
许可
该项目基于MIT许可证。
.NET 基金会
该项目由.NET Foundation支持。
该项目采用了由Contributor Covenant定义的行为准则,以阐明我们社区中预期的行为。有关更多信息,请参阅.NET Foundation行为准则。
产品 | 版本 兼容和额外的目标框架版本。 |
---|---|
.NET | net6.0 兼容。 net6.0-android 已计算。 net6.0-ios 已计算。 net6.0-maccatalyst 已计算。 net6.0-macos 已计算。 net6.0-tvos 已计算。 net6.0-windows 已计算。 net7.0 兼容。 net7.0-android 已计算。 net7.0-ios 已计算。 net7.0-maccatalyst 已计算。 net7.0-macos 已计算。 net7.0-tvos 已计算。 net7.0-windows 已计算。 net8.0 兼容。 net8.0-android 已计算。 net8.0-browser 已计算。 net8.0-ios 已计算。 net8.0-maccatalyst 已计算。 net8.0-macos 已计算。 net8.0-tvos 已计算。 net8.0-windows 已计算。 |
-
net6.0
- ICSharpCode.Decompiler (>= 8.0.0.7246-preview3)
- Markdig (>= 0.31.0)
- Microsoft.Build (>= 17.6.3)
- Microsoft.Build.Locator (>= 1.5.5)
- Microsoft.CodeAnalysis (>= 4.6.0)
- Microsoft.CodeAnalysis.Common (>= 4.6.0)
- Microsoft.CodeAnalysis.CSharp (>= 4.6.0)
- Microsoft.CodeAnalysis.CSharp.Workspaces (>= 4.6.0)
- Microsoft.CodeAnalysis.VisualBasic (>= 4.6.0)
- Microsoft.CodeAnalysis.VisualBasic.Workspaces (>= 4.6.0)
- Microsoft.CodeAnalysis.Workspaces.Common (>= 4.6.0)
- Microsoft.CodeAnalysis.Workspaces.MSBuild (>= 4.6.0)
- Microsoft.DocAsCode.Common (>= 2.67.5)
- Microsoft.DocAsCode.DataContracts.Common (>= 2.67.5)
- Microsoft.DocAsCode.Glob (>= 2.67.5)
- Microsoft.DocAsCode.Plugins (>= 2.67.5)
- Microsoft.DocAsCode.YamlSerialization (>= 2.67.5)
- System.Configuration.ConfigurationManager (>= 7.0.0)
-
net7.0
- ICSharpCode.Decompiler (>= 8.0.0.7246-preview3)
- Markdig (>= 0.31.0)
- Microsoft.Build (>= 17.6.3)
- Microsoft.Build.Locator (>= 1.5.5)
- Microsoft.CodeAnalysis (>= 4.6.0)
- Microsoft.CodeAnalysis.Common (>= 4.6.0)
- Microsoft.CodeAnalysis.CSharp (>= 4.6.0)
- Microsoft.CodeAnalysis.CSharp.Workspaces (>= 4.6.0)
- Microsoft.CodeAnalysis.VisualBasic (>= 4.6.0)
- Microsoft.CodeAnalysis.VisualBasic.Workspaces (>= 4.6.0)
- Microsoft.CodeAnalysis.Workspaces.Common (>= 4.6.0)
- Microsoft.CodeAnalysis.Workspaces.MSBuild (>= 4.6.0)
- Microsoft.DocAsCode.Common (>= 2.67.5)
- Microsoft.DocAsCode.DataContracts.Common (>= 2.67.5)
- Microsoft.DocAsCode.Glob (>= 2.67.5)
- Microsoft.DocAsCode.Plugins (>= 2.67.5)
- Microsoft.DocAsCode.YamlSerialization (>= 2.67.5)
- System.Configuration.ConfigurationManager (>= 7.0.0)
-
net8.0
- ICSharpCode.Decompiler (>= 8.0.0.7246-preview3)
- Markdig (>= 0.31.0)
- Microsoft.Build (>= 17.6.3)
- Microsoft.Build.Locator (>= 1.5.5)
- Microsoft.CodeAnalysis (>= 4.6.0)
- Microsoft.CodeAnalysis.Common (>= 4.6.0)
- Microsoft.CodeAnalysis.CSharp (>= 4.6.0)
- Microsoft.CodeAnalysis.CSharp.Workspaces (>= 4.6.0)
- Microsoft.CodeAnalysis.VisualBasic (>= 4.6.0)
- Microsoft.CodeAnalysis.VisualBasic.Workspaces (>= 4.6.0)
- Microsoft.CodeAnalysis.Workspaces.Common (>= 4.6.0)
- Microsoft.CodeAnalysis.Workspaces.MSBuild (>= 4.6.0)
- Microsoft.DocAsCode.Common (>= 2.67.5)
- Microsoft.DocAsCode.DataContracts.Common (>= 2.67.5)
- Microsoft.DocAsCode.Glob (>= 2.67.5)
- Microsoft.DocAsCode.Plugins (>= 2.67.5)
- Microsoft.DocAsCode.YamlSerialization (>= 2.67.5)
- System.Configuration.ConfigurationManager (>= 7.0.0)
NuGet 包 (2)
展示依赖于 Microsoft.DocAsCode.Dotnet 的前两个 NuGet 包
包 | 下载 |
---|---|
Microsoft.DocAsCode.Build.ManagedReference 包描述 |
|
Microsoft.DocAsCode.Build.MemberLevelManagedReference 包描述 |
GitHub 仓库
此包没有被任何流行的 GitHub 仓库使用。
版本 | 下载 | 最后更新 | |
---|---|---|---|
2.67.5 | 8,500 | 6/21/2023 | |
2.67.3 | 1,556 | 6/2/2023 | |
2.67.2 | 438 | 5/26/2023 | |
2.67.1 | 739 | 5/16/2023 | |
2.67.0 | 843 | 5/6/2023 | |
2.66.2 | 4,656 | 4/26/2023 | |
2.66.1 | 325 | 4/25/2023 | |
2.66.0 | 389 | 4/24/2023 | |
2.65.3 | 403 | 4/14/2023 | |
2.65.2 | 379 | 4/11/2023 | |
2.65.1 | 334 | 4/9/2023 | |
2.65.0 | 401 | 4/7/2023 | |
2.64.0 | 4,913 | 3/30/2023 | |
2.63.1 | 1,035 | 3/21/2023 | |
2.63.0 | 469 | 3/20/2023 | |
2.62.2 | 540 | 3/7/2023 | |
2.62.1 | 1,955 | 2/15/2023 | |
2.62.0 | 485 | 2/14/2023 |