docfx init -y
Remove-Item docfx.json,index.md,toc.yml

1行目

DocFXの初期ファイルが作成されます。

2行目

ソリューションのルートでは不要なので削除します。

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <IsPackable>false</IsPackable>
  </PropertyGroup>
  <Target Name="BuildDocs" AfterTargets="Build"
          Condition="'$(SolutionPath)' != '' And '$(Configuration)' == 'Release'">
    <Message Text="Generating DocFX metadata..."      Importance="high" />
    <WriteLinesToFile File="_includes/version.md" Lines='$(Version)' Overwrite="true" />
    <Message Text="Generating DocFX documentation..." Importance="high" />
    <Exec Command="docfx metadata docfx.json" />
    <Exec Command="docfx build    docfx.json" />
  </Target>
</Project>

3行目～4行目

Docsプロジェクトのプロパティを定義しています。

6行目～7行目

ソリューションのReleaseビルドのときにHTMLドキュメントを生成します。

9行目

mdファイルへの埋め込み用ファイルを生成しています。

11行目～12行目

htmlファイルを生成しています。

{
  "$schema": "https://raw.githubusercontent.com/dotnet/docfx/main/schemas/docfx.schema.json",
  "metadata": [
    {
      "src": [
        {
          "src": "../",
          "files": [ "/Com/Com.csproj", "/NuGet/NuGet.csproj" ],
          "exclude": [ "**/bin/**", "**/obj/**" ]
        }
      ],
      "dest": "_api",
      "disableGitFeatures": true
    }
  ],
  "build": {
    "content": [
      {
        "files": [ "**/*.md", "toc.yml", "_api/**.yml" ]
        "exclude": [ "_includes/**" ]
      }
    ],
    "dest": "_site",
  }
}

3行目～15行目

apiフォルダーにドキュメント用のymlファイルを生成します。

16行目～24行目

_siteフォルダーにHTMLドキュメントを生成します。

20行目

_includesフォルダーをHTMLドキュメントの生成対象外にしています。

# ProgressLLC.OAuthLib ([!include[](includes/_version.md)])
プログレス合同会社 OAuth 2.0 ライブラリ

## COM版
- <xref:ProgressLLC.OAuthLib.Com>

## NuGet版
- <xref:ProgressLLC.OAuthLib.NuGet>

1行目

includes/_version.mdの内容を取り込んでバージョンを表示します。

5行目

COMのnamespaceをxrefで指定します。

8行目

NuGetのnamespaceをxrefで指定します。

   :

# DocFX Genarated file
Docs/_site
Docs/api
Docs/includes

4行目～5行目

DocFXが自動で生成するフォルダーです。

6行目

ビルド時に生成する組み込み用のファイルが格納されるフォルダーです。