Docs: DocFx Build Failure for API Docs

[NightOwl888]

Docs: DocFx Build Failure for API Docs

[Shazwazza]

oh my :(

[NightOwl888]

@Shazwazza - Yeah, I think we will need to download the docfx source and run it in the debugger to determine how to fix the load issues with the plugins and also fix the MavenReference problem. For MavenReference I think we may need to switch to using the DLL/XML output instead of using the .csproj file, since it appears docfx doesn't actually run MSBuild.

[filzrev]

Lucene.Net.Analysis.OpenNLP now fails to build metatdata when executed from docfx.

On my environment.
It can successfully execute docfx metadata docfx.analysis-opennlp.json command with following changes.

1. Remove MSBuild TargetFramework property from docfx.analysis-opennlp.json

It seems this settings override target framework(net6) that specified at Lucene.Net.Analysis.OpenNLP.csproj.

lucenenet/websites/apidocs/docfx.analysis-opennlp.json

Lines 17 to 19 in 43e0e89

	"properties": {
	"TargetFramework": "netstandard2.0"
	}

2. Build with .NET 8 SDK v8.0.200
I've confirmed following error is not occurred when build with .NET 8 preview SDK 8.0.200.

> ROSLYNCODETASKFACTORYCSHARPCOMPILER : error : Unknown command '/noconfig'.
C:\Users\sample\.nuget\packages\ikvm.image\8.7.5\buildTransitive\IKVM.Image.targets(95,9): error : The source file for this compilation can be found at: "C:\Users\sample\AppData\Local\Temp\MSBuildTempsample\tmpe1e76f87dcd94e66b4bcf0ec3cccbc5b.tmp"

Minimum reproducible .csproj for this issue

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net6</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="IKVM.Maven.Sdk" Version="1.6.8" />
    <PackageReference Include="IKVM.Image" Version="8.7.5" />
  </ItemGroup>
</Project>

[paulirwin]

When I try to run the docs.ps1 script on macOS arm64, I get the following error after the "Building api metadata for..." lines:

Building api metadata for /{path_to}/lucene.net/websites/apidocs/docfx.demo.json...
Building site output for /{path_to}/lucene.net/websites/apidocs/docfx.codecs.json...
Get-Content: /{path_to}/lucene.net/websites/apidocs/docs.ps1:222
Line |
 222 |          $xrefMap = Get-Content $xrefFile -Raw
     |                     ~~~~~~~~~~~~~~~~~~~~~~~~~~
     | Cannot find path '/{path_to}/lucene.net/websites/apidocs/_site/api/codecs/xrefmap.yml' because it does
     | not exist.