diff --git a/.github/workflows/ghpages.yml b/.github/workflows/ghpages.yml index 8d6d439..1e58316 100644 --- a/.github/workflows/ghpages.yml +++ b/.github/workflows/ghpages.yml @@ -25,7 +25,7 @@ jobs: - name: Install .NET OMD Generator run: dotnet tool install --tool-path .tools/omd dotMorten.OmdGenerator --version 1.2.0 - + - name: Generate OMD run: | mkdir artifacts/docs/api @@ -35,6 +35,7 @@ jobs: env: DOCFX_SOURCE_BRANCH_NAME: master run: | + dotnet nuget install memberpage -Version 2.48.1 -OutputDirectory docs .tools/docfx/docfx.exe docs/docfx.json powershell -ExecutionPolicy ByPass -command "docs\FixApiRefLinks" -Path artifacts\docs_site\api\ diff --git a/docs/BuildDoc.cmd b/docs/BuildDoc.cmd index 84336d3..311da36 100644 --- a/docs/BuildDoc.cmd +++ b/docs/BuildDoc.cmd @@ -11,14 +11,19 @@ IF NOT EXIST "%DocFxFolder%\v%DocFXVersion%\docfx.exe" ( powershell -ExecutionPolicy ByPass -command "Expand-Archive -LiteralPath '%DocFxFolder%\docfx_v%DocFXVersion%.zip' -DestinationPath '%DocFxFolder%\v%DocFXVersion%'" DEL "%DocFxFolder%\docfx_v%DocFXVersion%.zip" /Q ) +IF NOT EXIST "..\.tools\nuget.exe" ( + powershell -ExecutionPolicy ByPass -command "Invoke-WebRequest -Uri "https://dist.nuget.org/win-x86-commandline/latest/nuget.exe" -OutFile '%~dp0..\.tools\nuget.exe'" +) REM Generate OMD -dotnet tool install --tool-path .tools/omd dotMorten.OmdGenerator --version 1.2.0 +dotnet tool install --tool-path %~dp0../.tools/omd dotMorten.OmdGenerator --version 1.2.0 mkdir %~dp0../artifacts/docs/api -.tools\omd\generateomd /source=%~dp0../src/NmeaParser /output=%~dp0../artifacts/docs/api/omd.html /preprocessors=NETSTANDARD1_4;NETSTANDARD +%~dp0..\.tools\omd\generateomd /source=%~dp0../src/NmeaParser /output=%~dp0../artifacts/docs/api/omd.html /preprocessors=NETSTANDARD1_4;NETSTANDARD +%~dp0..\.tools\nuget install memberpage -Version 2.48.1 -OutputDirectory %~dp0 +PAUSE REM Build the output site (HTML) from the generated metadata and input files (uses configuration in docfx.json in this folder) -REM %DocFxFolder%\v%DocFXVersion%\docfx.exe %~dp0\docfx.json +%DocFxFolder%\v%DocFXVersion%\docfx.exe %~dp0\docfx.json ECHO Fixing API Reference Links powershell -ExecutionPolicy ByPass -command "%~dp0FixApiRefLinks.ps1" -Path %~dp0..\artifacts\docs_site\api\ start http://localhost:8080 diff --git a/docs/docfx.json b/docs/docfx.json index ddbb05f..d745121 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -127,7 +127,7 @@ "globalMetadataFiles": [], "fileMetadataFiles": [], "template": [ - "default","template_overrides" + "default","template_overrides","memberpage.2.48.1/content" ], "postProcessors": [], "markdownEngineName": "markdig",