Merge pull request #72 from fluentmigrator/feature/issue-71-fix-docfx…

…-build

Fix issue #71 - docfx build

api/toc.yml

@@ -1,12 +1,12 @@
 - name: Version 2.x
   href: v2.x/toc.yml
-  topicHref: v2.x/index.md
+  topicHref: v2.x/index.html
 - name: Version 3.x
-  href: v3.x/
-  topicHref: v3.x/index.md
+  href: v3.x/toc.yml
+  topicHref: v3.x/index.html
 - name: Version 4.x
-  href: v4.x/
-  topicHref: v4.x/index.md
+  href: v4.x/toc.yml
+  topicHref: v4.x/index.html
 - name: Version 5.x
-  href: v5.x/
-  topicHref: v5.x/index.md
+  href: v5.x/toc.yml
+  topicHref: v5.x/index.html

azure-pipelines.yml

@@ -9,27 +9,18 @@ trigger:
 pool:
   vmImage: 'ubuntu-latest'
 
-variables:
-  docFxTool: 'mono docfx.console/tools/docfx.exe'
-
 steps:
 - script: |
     git submodule update --init --recursive
   displayName: 'Update submodules (main fluentmigrator repo)'
 
-- task: NuGetToolInstaller@1
-
-# We need to use 2.59.4 of docfx.console due to https://github.com/dotnet/docfx/issues/8097 
-# which is fixed by https://github.com/dotnet/docfx/pull/8135
-- task: NuGetCommand@2
-  displayName: 'Install docfx.console'
-  inputs:
-    command: 'custom'
-    arguments: 'install docfx.console -Version 2.59.4 -ExcludeVersion'
+- script: |
+    dotnet tool install -g docfx --version 2.75.2
+  displayName: 'Install dotnet tool DocFX'
 
 - script: |
-    $(docFxTool) metadata docfx.json
-    $(docFxTool) build docfx.json
+    docfx metadata docfx.json
+    docfx build docfx.json
   displayName: 'Run DocFX build'
 
 - task: ArchiveFiles@2

docfx.json

@@ -18,7 +18,7 @@
       "filter": "api-filter.yml",
       "disableGitFeatures": true,
       "properties": {
-        "TargetFramework": "net461"
+        "TargetFramework": "net45"
       }
     },
     {
@@ -81,7 +81,7 @@
       "filter": "api-filter.yml",
       "disableGitFeatures": true,
       "properties": {
-        "TargetFramework": "net461"
+        "TargetFramework": "net48"
       }
     }
   ],
@@ -96,7 +96,20 @@
       {
         "files": [ "**.yml", "**.md" ],
         "src": "api/v3.x",
-        "dest": "api/v3.x"
+        "dest": "api/v3.x",
+        "group": "v3.x"
+      },
+      {
+        "files": [ "**.yml", "**.md" ],
+        "src": "api/v4.x",
+        "dest": "api/v4.x",
+        "group": "v4.x"
+      },
+      {
+        "files": [ "**.yml", "**.md" ],
+        "src": "api/v5.x",
+        "dest": "api/v5.x",
+        "group": "v5.x"
       },
       {
         "files": [
@@ -139,6 +152,24 @@
           "obj/**",
           "_site/**"
         ]
+      },
+      {
+        "files": [
+          "apidoc/v4.x/**.md"
+        ],
+        "exclude": [
+          "obj/**",
+          "_site/**"
+        ]
+      },
+      {
+        "files": [
+          "apidoc/v5.x/**.md"
+        ],
+        "exclude": [
+          "obj/**",
+          "_site/**"
+        ]
       }
     ],
     "dest": "_site",
@@ -177,6 +208,16 @@
           "repo": "https://github.com/fluentmigrator/documentation",
           "branch": "master",
           "apiSpecFolder": "apidoc/v3.x"
+        },
+        "api/v4.x/**": {
+          "repo": "https://github.com/fluentmigrator/documentation",
+          "branch": "master",
+          "apiSpecFolder": "apidoc/v4.x"
+        },
+        "api/v5.x/**": {
+          "repo": "https://github.com/fluentmigrator/documentation",
+          "branch": "master",
+          "apiSpecFolder": "apidoc/v5.x"
         }
       }
     }

global.json

@@ -0,0 +1,5 @@
+{
+    "sdk": {
+        "version": "8.0.101"
+    }
+}