| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455 |
- param (
- [switch]$API
- )
- # Remove build.log file
- If(Test-Path build.log)
- {
- Remove-Item build.log
- }
- Start-Transcript -Path build.log
- # Generate API doc
- if ($API)
- {
- Write-Host "Generating API documentation..."
- # Run MSBuild restore
- $msbuild = & ("${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe") -latest -requires Microsoft.Component.MSBuild -find MSBuild\**\Bin\MSBuild.exe | select-object -first 1
- & $msbuild ..\stride\build\Stride.sln /t:Restore
- if ($LastExitCode -ne 0)
- {
- Write-Host "Failed to restore nuget packages"
- exit $LastExitCode
- }
-
- # Build metadata from C# source
- deps\docfx\docfx.exe metadata en/docfx.json
- if ($LastExitCode -ne 0)
- {
- Write-Host "Failed to generate API metadata"
- exit $LastExitCode
- }
- }
- else
- {
- If(Test-Path en/api/.manifest)
- {
- Write-Host "Erasing API documentation..."
- Remove-Item en/api/*yml -recurse
- Remove-Item en/api/.manifest
- }
- }
- Write-Host "Generating documentation..."
- # Output to both build.log and console
- deps\docfx\docfx.exe build en\docfx.json
- if ($LastExitCode -ne 0)
- {
- Write-Host "Failed to build doc"
- exit $LastExitCode
- }
- # Copy extra items
- Copy-Item en/ReleaseNotes/ReleaseNotes.md _site/en/ReleaseNotes/
- Stop-Transcript
|