720a46686b
fetches docfx, builds the metadata and builds the docs with the correct filters builds the UI docs from the same powershell script
101 lines
2.7 KiB
PowerShell
101 lines
2.7 KiB
PowerShell
$PSScriptFilePath = (Get-Item $MyInvocation.MyCommand.Path);
|
|
$RepoRoot = (get-item $PSScriptFilePath).Directory.Parent.FullName;
|
|
$SolutionRoot = Join-Path -Path $RepoRoot "src";
|
|
$ToolsRoot = Join-Path -Path $RepoRoot "tools";
|
|
$DocFx = Join-Path -Path $ToolsRoot "docfx\docfx.exe"
|
|
$DocFxFolder = (Join-Path -Path $ToolsRoot "docfx")
|
|
$DocFxJson = Join-Path -Path $RepoRoot "apidocs\docfx.json"
|
|
$7Zip = Join-Path -Path $ToolsRoot "7zip\7za.exe"
|
|
$DocFxSiteOutput = Join-Path -Path $RepoRoot "apidocs\_site\*.*"
|
|
$NgDocsSiteOutput = Join-Path -Path $RepoRoot "src\Umbraco.Web.UI.Client\docs\api\*.*"
|
|
$ProgFiles86 = [Environment]::GetEnvironmentVariable("ProgramFiles(x86)");
|
|
$MSBuild = "$ProgFiles86\MSBuild\14.0\Bin\MSBuild.exe"
|
|
|
|
|
|
################ Do the UI docs
|
|
|
|
"Changing to Umbraco.Web.UI.Client folder"
|
|
cd ..
|
|
cd src\Umbraco.Web.UI.Client
|
|
Write-Host $(Get-Location)
|
|
|
|
"Creating build folder so MSBuild doesn't run the whole grunt build"
|
|
if (-Not (Test-Path "build")) {
|
|
md "build"
|
|
}
|
|
|
|
"Installing node"
|
|
# Check if Install-Product exists, should only exist on the build server
|
|
if (Get-Command Install-Product -errorAction SilentlyContinue)
|
|
{
|
|
Install-Product node ''
|
|
}
|
|
|
|
"Installing node modules"
|
|
& npm install
|
|
|
|
"Installing grunt"
|
|
& npm install -g grunt-cli
|
|
|
|
"Moving back to build folder"
|
|
cd ..
|
|
cd ..
|
|
cd build
|
|
Write-Host $(Get-Location)
|
|
|
|
& grunt --gruntfile ../src/umbraco.web.ui.client/gruntfile.js docs
|
|
|
|
# change baseUrl
|
|
$BaseUrl = "https://our.umbraco.org/apidocs/ui/"
|
|
$IndexPath = "../src/umbraco.web.ui.client/docs/api/index.html"
|
|
(Get-Content $IndexPath).replace('location.href.replace(rUrl, indexFile)', "`'" + $BaseUrl + "`'") | Set-Content $IndexPath
|
|
# zip it
|
|
|
|
& $7Zip a -tzip ui-docs.zip $NgDocsSiteOutput -r
|
|
|
|
################ Do the c# docs
|
|
|
|
# Build the solution in debug mode
|
|
$SolutionPath = Join-Path -Path $SolutionRoot -ChildPath "umbraco.sln"
|
|
& $MSBuild "$SolutionPath" /p:Configuration=Debug /maxcpucount /t:Clean
|
|
if (-not $?)
|
|
{
|
|
throw "The MSBuild process returned an error code."
|
|
}
|
|
& $MSBuild "$SolutionPath" /p:Configuration=Debug /maxcpucount
|
|
if (-not $?)
|
|
{
|
|
throw "The MSBuild process returned an error code."
|
|
}
|
|
|
|
# Go get docfx if we don't hae it
|
|
$FileExists = Test-Path $DocFx
|
|
If ($FileExists -eq $False) {
|
|
|
|
If(!(Test-Path $DocFxFolder))
|
|
{
|
|
New-Item $DocFxFolder -type directory
|
|
}
|
|
|
|
$DocFxZip = Join-Path -Path $ToolsRoot "docfx\docfx.zip"
|
|
$DocFxSource = "https://github.com/dotnet/docfx/releases/download/v1.9.4/docfx.zip"
|
|
Invoke-WebRequest $DocFxSource -OutFile $DocFxZip
|
|
|
|
#unzip it
|
|
& $7Zip e $DocFxZip "-o$DocFxFolder"
|
|
}
|
|
|
|
#clear site
|
|
If(Test-Path(Join-Path -Path $RepoRoot "apidocs\_site"))
|
|
{
|
|
Remove-Item $DocFxSiteOutput -recurse
|
|
}
|
|
|
|
# run it!
|
|
& $DocFx metadata $DocFxJson
|
|
& $DocFx build $DocFxJson
|
|
|
|
# zip it
|
|
|
|
& $7Zip a -tzip csharp-docs.zip $DocFxSiteOutput -r
|