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
NuGet 团队不负责 此客户端 的支持。请联系其 管理员 获取支持。
nuke :add-package docfx --version 2.77.0
NuGet 团队不负责 此客户端 的支持。请联系其 管理员 获取支持。
使用 docfx 构建您的文档
使用 docfx 分析您的技术文档站,包括着陆页、Markdown、.NET、REST API 等 API 参考文档。
如你所知,docfx 已转移到作为 .NET 基金会项目。Microsoft Learn 不再使用 docfx,并且自2022年11月起不再支持该项目。
docfx 计划继续作为社区主导的项目。我们希望产生带有新特性以及对现有和新用例的改进的未来版本。我们也希望邀请任何感兴趣的相关方参与这个项目。如果你想联系社区团队,请打开一个讨论线程。
入门
将 docfx 安装为全局工具
dotnet tool install -g docfx
创建并本地启动一个网站
docfx init -y docfx build docfx_project\docfx.json --serve
转到 https://:8080 查看示例网站。
有关更多信息,请参阅入门。
[!TIP] Docfx 将夜间构建发布到 GitHub Packages,这让你可以了解 Docfx 的最新进展。
贡献
在 讨论 中提问或进行一般性讨论。使用 问题 报告错误或提出功能请求。
我们欢迎通过合并请求进行代码贡献。标记为 help-wanted
的问题是开始贡献代码的好选择。
先决条件
- 安装 Visual Studio 2022(社区版或更高版本) 并确保您拥有最新的更新。
- 安装 .NET SDK 6.x 和 8.x。
- 安装 NodeJS(20.x.x)。
构建和测试
- 在
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 已计算。 |
此包无依赖项。
版本 | 下载 | 最后更新 |
---|---|---|
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 |