docfx 2.77.0

前缀预留
dotnet tool install --global docfx --version 2.77.0                
此包包含一个可以从shell/命令行调用的.NET工具
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local docfx --version 2.77.0                
此包包含一个可以从shell/命令行调用的.NET工具
#tool dotnet:?package=docfx&version=2.77.0                
nuke :add-package docfx --version 2.77.0                

使用 docfx 构建您的文档

NuGet Help Wanted

使用 docfx 分析您的技术文档站,包括着陆页、Markdown、.NET、REST API 等 API 参考文档。


如你所知,docfx 已转移到作为 .NET 基金会项目。Microsoft Learn 不再使用 docfx,并且自2022年11月起不再支持该项目。

docfx 计划继续作为社区主导的项目。我们希望产生带有新特性以及对现有和新用例的改进的未来版本。我们也希望邀请任何感兴趣的相关方参与这个项目。如果你想联系社区团队,请打开一个讨论线程。

入门

  1. 将 docfx 安装为全局工具

    dotnet tool install -g docfx
    
  2. 创建并本地启动一个网站

    docfx init -y
    docfx build docfx_project\docfx.json --serve
    
  3. 转到 https://:8080 查看示例网站。

有关更多信息,请参阅入门

[!TIP] Docfx 将夜间构建发布到 GitHub Packages,这让你可以了解 Docfx 的最新进展。

贡献

讨论 中提问或进行一般性讨论。使用 问题 报告错误或提出功能请求。

我们欢迎通过合并请求进行代码贡献。标记为 help-wanted 的问题是开始贡献代码的好选择。

先决条件

构建和测试

  • templates 目录中构建站点模板
    • 运行 npm install 以恢复 npm 依赖项。
    • 运行 npm run build 以构建模板。
  • 运行 dotnet build 以构建项目或使用 Visual Studio 构建 docfx.sln
  • 运行 dotnet test 以测试项目或使用 Visual Studio 测试资源管理器。
    • 运行 git lfs checkout 以检出用于快照测试的文件

分支和发布

main 分支是拉取请求和其他大多数开发活动的默认分支。我们偶尔会使用 feature/* 分支进行重要功能的开发。

发布基于稳定的 main 分支提交,使用 GitHub 发布。鼓励使用 常规提交

Docfx 并不按照常规的时间表发布,新版本会在维护者看到足够的变化,认为有必要发布新版本时出现。有时我们会使用预发布版本来尝试破坏性变更并从社区获取反馈。

路线图

我们使用 里程碑 来沟通即将到来的 Docfx 变更。

  • 工作集 是目前正在积极工作的功能。并非这个桶中的所有功能都会在下一个版本中提交,但它们反映了维护者未来一段时期的工作重点。

  • 待办事项 是一些未来版本的功能候选者,但目前尚未积极开发。

许可

此项目使用 MIT 许可证。

.NET 基金会

此项目得到 .NET 基金会 的支持。

此项目采用了由贡献者公约定义的代码准则,以明确我们社区中期望的行为。更多信息请参阅 .NET 基金会代码准则

产品 兼容的和额外的计算目标框架版本。
.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 已计算。
兼容的目标框架
包含的目标框架(在包中)
了解更多关于 目标框架.NET Standard

此包无依赖项。

版本 下载 最后更新
2.77.0 70,327 7/1/2024
2.76.0 202,903 4/7/2024
2.75.3 157,464 2/18/2024
2.75.2 54,777 1/27/2024
2.75.1 60,909 1/13/2024
2.75.0 6,161 1/12/2024
2.74.1 116,802 11/30/2023
2.74.0 40,923 11/20/2023
2.73.2 24,507 11/13/2023
2.73.1 7,759 11/7/2023
2.73.0 9,031 11/2/2023
2.72.1 11,452 10/28/2023
2.72.0 9,777 10/24/2023
2.71.1 7,967 10/18/2023
2.71.0 34,691 9/30/2023
2.70.4 24,173 9/18/2023
2.70.3 31,303 9/5/2023
2.70.2 1,470 9/4/2023
2.70.1 16,154 8/21/2023
2.70.0 38,514 8/2/2023
2.67.5 76,153 6/21/2023
2.67.3 21,736 6/2/2023
2.67.2 6,277 5/26/2023
2.67.1 34,617 5/16/2023
2.67.0 14,940 5/6/2023
2.66.2 22,341 4/26/2023
2.66.1 1,816 4/25/2023
2.66.0 2,061 4/24/2023
2.65.3 12,542 4/14/2023
2.65.2 5,116 4/11/2023
2.65.1 2,423 4/9/2023
2.65.0 1,907 4/7/2023
2.64.0 40,959 3/30/2023
2.63.1 9,312 3/21/2023
2.63.0 1,494 3/20/2023
2.62.2 13,242 3/7/2023
2.62.1 17,854 2/15/2023
2.62.0 1,145 2/14/2023
2.61.0 53,941 1/30/2023
2.60.2 31,496 1/20/2023
2.60.1 4,381 1/18/2023
2.60.0 3,225 1/13/2023
2.60.0-preview.2 819 12/25/2022
2.60.0-preview.1 657 12/20/2022
2.59.4 6,599 9/7/2022
2.59.3 1,301 7/6/2022
2.59.2 1,544 4/11/2022
2.59.1 748 3/31/2022
2.59.0 1,256 1/19/2022
2.58.9 1,104 11/4/2021
2.58.8 502 11/1/2021
2.58.5 501 10/26/2021
2.58.4 1,563 9/14/2021
2.58.3 732 9/7/2021
2.58.2 1,110 8/24/2021
2.58.1 505 8/23/2021
2.58.0 3,432 6/9/2021
2.57.2 1,632 4/14/2021
2.57.1 579 4/13/2021
2.57.0 651 4/9/2021
2.56.7 3,228 3/2/2021
2.56.6 4,220 12/10/2020
2.56.5 1,398 11/10/2020
2.56.4 1,038 10/20/2020
2.56.3 739 10/12/2020
2.56.2 2,363 7/27/2020
2.56.1 1,228 7/6/2020
2.56.0 944 6/29/2020
2.55.0 1,188 6/12/2020
2.53.1 2,322 5/11/2020
2.52.0 1,793 4/13/2020
2.51.0 1,603 3/20/2020
2.50.0 1,727 3/2/2020
2.49.0 816 2/17/2020
2.48.1 2,894 1/13/2020
2.48.0 2,080 12/9/2019
2.47.0 2,092 10/31/2019
2.46.0 1,415 10/14/2019
2.45.1 2,011 9/15/2019
2.45.0 1,607 8/25/2019
2.44.0 1,606 8/2/2019
2.43.2 2,317 7/2/2019
2.43.1 1,452 6/14/2019
2.42.4 2,338 5/24/2019
2.42.3 13,242 5/13/2019
2.42.2 883 5/10/2019
2.42.0 1,170 4/22/2019
2.41.0 1,990 3/29/2019
2.40.11 2,317 2/16/2019
2.40.10 1,888 2/1/2019
2.40.9 963 1/31/2019
2.40.8 1,488 1/25/2019
2.40.7 2,696 1/4/2019
2.40.5 974 12/19/2018
2.40.4 2,800 11/26/2018
2.40.2 1,891 11/7/2018
2.40.1 1,532 10/29/2018
2.40.0 2,183 10/12/2018
2.39.2 3,186 9/9/2018
2.39.1 1,285 9/4/2018
2.39.0 1,303 9/2/2018
2.38.1 6,233 8/16/2018
2.38.0 1,831 8/13/2018
2.37.2 1,902 7/31/2018
2.37.1 1,187 7/31/2018
2.36.2 1,474 6/13/2018
2.36.1 1,524 5/25/2018
2.36.0 1,289 5/21/2018
2.36.0-alpha-0159-g25e5900b4 964 4/26/2018
2.35.4 1,440 5/2/2018
2.35.3 1,306 5/2/2018
2.35.0-alpha-0153-g6da267dd4 968 4/25/2018
2.33.2 1,454 4/3/2018
2.33.1 1,293 4/3/2018
2.33.0 1,415 3/19/2018
2.32.2 1,230 3/12/2018
2.32.0 1,376 2/28/2018
2.31.0 1,491 2/5/2018
2.30.0 1,475 1/12/2018
2.29.1 1,333 12/29/2017
2.28.3 1,283 12/14/2017
2.28.2 1,350 12/7/2017
2.28.1 1,244 12/1/2017
2.28.0 1,248 11/30/2017
2.27.0 1,258 11/21/2017
2.26.3 1,344 10/26/2017
2.26.1 1,231 10/24/2017
2.26.0 1,219 10/23/2017
2.25.1 1,249 10/9/2017
2.25.0 1,221 10/9/2017
2.24.0 1,423 9/11/2017
2.23.1 1,347 8/22/2017
2.22.3 1,241 8/17/2017
2.22.1 1,253 8/2/2017
2.22.0 1,266 8/1/2017
2.21.2 1,236 7/26/2017
2.21.1 1,335 7/17/2017
2.20.0 1,307 7/12/2017
2.19.2 1,284 6/29/2017
2.18.5 1,324 6/15/2017
2.18.4 1,278 6/9/2017
2.18.3 1,280 6/8/2017
2.18.1 1,237 5/31/2017
2.17.5 1,268 5/23/2017
2.17.3 1,260 5/11/2017
2.17.2 1,251 5/9/2017
2.16.8 1,292 5/3/2017
2.16.7 1,258 4/26/2017
2.16.5 1,235 4/25/2017
2.16.2 1,259 4/20/2017
2.16.0 1,312 4/17/2017
2.15.5 1,392 4/6/2017
2.15.2 1,275 3/29/2017
2.13.1 1,314 3/7/2017
2.13.0 1,310 3/6/2017
2.12.1 1,330 2/14/2017
2.12.0 1,279 2/13/2017
2.11.3 1,316 2/7/2017
2.11.2 1,288 1/25/2017
2.11.1 1,254 1/24/2017
2.11.0 1,250 1/23/2017
2.10.2 1,277 1/4/2017
2.10.1 1,241 1/4/2017
2.10.0 1,337 1/3/2017
2.9.3 1,255 12/15/2016
2.9.2 1,277 12/14/2016
2.9.1 1,232 12/13/2016
2.9.0 1,319 12/12/2016
2.8.2 1,301 11/28/2016
2.8.1 1,273 11/24/2016
2.8.0 1,306 11/22/2016
2.7.3 1,581 11/8/2016
2.7.2 1,525 11/3/2016
2.7.1 1,510 11/1/2016
2.7.0 1,322 10/31/2016
2.6.3 1,344 10/25/2016
2.6.1 1,284 10/11/2016
2.6.0 1,305 10/10/2016
2.5.4 1,784 9/22/2016
2.5.3 1,653 9/20/2016
2.5.2 1,432 9/19/2016
2.5.1 1,539 9/19/2016
2.5.0 1,333 9/14/2016
2.4.0 1,390 8/29/2016
2.3.1 1,332 8/22/2016
2.3.0 1,440 8/8/2016
2.2.2 1,344 7/22/2016
2.2.1 1,330 7/19/2016
2.2.0 1,326 7/18/2016
2.1.0 1,446 6/27/2016
2.0.2 1,280 6/22/2016
2.0.1 1,323 6/7/2016
2.0.0 1,423 6/6/2016
1.9.4 1,683 5/19/2016
1.9.3 1,305 5/19/2016
1.9.0 1,255 5/16/2016
1.8.4 1,298 5/10/2016
1.8.1 1,298 5/4/2016
1.8.0 1,565 4/25/2016
1.7.2 1,344 4/20/2016
1.7.1 1,309 4/7/2016
1.7.0 1,281 4/6/2016
1.6.1 1,347 3/16/2016
1.5.0 1,388 2/22/2016
1.4.2 1,364 2/3/2016
1.4.1 1,304 2/2/2016
1.4.0 1,330 2/1/2016
1.3.7 1,352 1/21/2016
1.3.5 1,346 1/13/2016
1.3.3 1,468 1/13/2016
1.3.0 1,327 1/11/2016
1.2.2 1,385 12/30/2015
1.2.1 1,311 12/15/2015
1.2.0 1,857 12/14/2015
1.1.0 1,358 12/9/2015
1.0.0 1,571 11/20/2015
0.3.11-alpha-9-gdaed198 1,057 11/16/2015
0.3.0 1,432 11/12/2015
0.0.1-alpha-1523061607 1,101 6/23/2015
0.0.1-alpha-1523061604 1,069 6/23/2015
0.0.1-alpha-1518061325 1,037 6/18/2015
0.0.1-alpha-1518061107 998 6/18/2015
0.0.1-alpha-1517061543 1,080 6/17/2015
0.0.1-alpha-1517061409 1,121 6/17/2015