Add DocFx project

Use "dotnet msbuild" command

Author: lukebakken

.gitignore

@@ -2,6 +2,8 @@
 ## Generated files
 ###################
 
+api/
+_site/
 gensrc/
 [Ll]ocal.props
 [Ll]ocal.dist

build.sh

@@ -2,11 +2,23 @@
 
 set -e
 
-SCRIPT=$0
-SCRIPT_DIR=$(cd $(dirname "$SCRIPT") && pwd)
+if command -v realpath >/dev/null 2>&1
+then
+    readonly script_dir="$(dirname "$(realpath "$0")")"
+else
+    readonly script_dir="$(cd "$(dirname "$0")" && pwd)"
+fi
 
 dotnet restore ./RabbitMQDotNetClient.sln
-dotnet run -p $SCRIPT_DIR/projects/client/Apigen/Apigen.csproj --apiName:AMQP_0_9_1 $SCRIPT_DIR/docs/specs/amqp0-9-1.stripped.xml $SCRIPT_DIR/gensrc/autogenerated-api-0-9-1.cs
-# we have to use msbuild or else multi-targeting doesn't work
-msbuild $SCRIPT_DIR/projects/client/RabbitMQ.Client/RabbitMQ.Client.csproj
-dotnet build $SCRIPT_DIR/projects/client/Unit/Unit.csproj
+dotnet run -p "$script_dir/projects/client/Apigen/Apigen.csproj" --apiName:AMQP_0_9_1 \
+    "$script_dir/docs/specs/amqp0-9-1.stripped.xml" \
+    "$script_dir/gensrc/autogenerated-api-0-9-1.cs"
+
+if command -v msbuild >/dev/null 2>&1
+then
+    # we have to use msbuild or else multi-targeting doesn't work
+    msbuild "$script_dir/projects/client/RabbitMQ.Client/RabbitMQ.Client.csproj"
+else
+    dotnet msbuild "$script_dir/projects/client/RabbitMQ.Client/RabbitMQ.Client.csproj"
+fi
+dotnet build "$script_dir/projects/client/Unit/Unit.csproj"

docfx.json

@@ -0,0 +1,75 @@
+{
+  "metadata": [
+    {
+      "src": [
+        {
+          "files": [
+            "projects/**.csproj"
+          ],
+          "exclude": [
+            "**/obj/**",
+            "**/bin/**",
+            "_site/**"
+          ]
+        }
+      ],
+      "dest": "api",
+      "disableGitFeatures": false
+    }
+  ],
+  "build": {
+    "content": [
+      {
+        "files": [
+          "api/**.yml",
+          "api/index.md"
+        ]
+      },
+      {
+        "files": [
+          "articles/**.md",
+          "articles/**/toc.yml",
+          "toc.yml",
+          "*.md"
+        ],
+        "exclude": [
+          "obj/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "resource": [
+      {
+        "files": [
+          "images/**"
+        ],
+        "exclude": [
+          "obj/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "overwrite": [
+      {
+        "files": [
+          "apidoc/**.md"
+        ],
+        "exclude": [
+          "obj/**",
+          "_site/**"
+        ]
+      }
+    ],
+    "dest": "_site",
+    "globalMetadataFiles": [],
+    "fileMetadataFiles": [],
+    "template": [
+      "default"
+    ],
+    "postProcessors": [],
+    "noLangKeyword": false,
+    "keepFileLink": false,
+    "cleanupCacheHistory": false,
+    "disableGitFeatures": false
+  }
+}