tasks/generateHelp.PlatyPS.build.ps1
|
param ( [Parameter()] [System.IO.DirectoryInfo] $ProjectPath = (property ProjectPath $BuildRoot), [Parameter()] [System.String] $ProjectName = (property ProjectName ''), [Parameter()] [System.String] $SourcePath = (property SourcePath ''), [Parameter()] [System.String] $HelpFolder = (property HelpFolder 'docs'), [Parameter()] [System.String] $BuildOutput = (property BuildOutput 'C:\BuildOutput'), [Parameter()] [cultureInfo] $HelpCultureInfo = 'en-US', [Parameter()] [System.String] $LineSeparation = (property LineSeparation ('-' * 78)) ) Task UpdateHelp { if ([System.String]::IsNullOrEmpty($ProjectName)) { $ProjectName = Get-ProjectName -BuildRoot $BuildRoot } if ([System.String]::IsNullOrEmpty($SourcePath)) { $SourcePath = Get-SourcePath -BuildRoot $BuildRoot } $LineSeparation "`t`t`t UPDATE HELP MARKDOWN FILE" $LineSeparation if (-not (Split-Path -Path $BuildOutput -IsAbsolute)) { $BuildOutput = Join-Path -Path $ProjectPath.FullName -ChildPath $BuildOutput } if (-not (Split-Path -Path $HelpFolder -IsAbsolute)) { $HelpFolder = Join-Path -Path $SourcePath -ChildPath $HelpFolder } Import-Module -Name $ProjectName -Force Update-MarkdownHelpModule -Path $HelpFolder } Task GenerateMamlFromMd { if ([System.String]::IsNullOrEmpty($ProjectName)) { $ProjectName = Get-ProjectName -BuildRoot $BuildRoot } if ([System.String]::IsNullOrEmpty($SourcePath)) { $SourcePath = Get-SourcePath -BuildRoot $BuildRoot } $LineSeparation "`t`t`t GENERATE MAML IN BUILD OUTPUT" $LineSeparation if (-not (Split-Path -Path $BuildOutput -IsAbsolute)) { $BuildOutput = Join-Path -Path $ProjectPath.FullName -ChildPath $BuildOutput } if (-not (Split-Path -Path $HelpFolder -IsAbsolute)) { $HelpFolder = Join-Path -Path $SourcePath -ChildPath $HelpFolder } $BuiltModuleFolder = Join-Path -Path $BuildOutput -ChildPath $ProjectName $HelpFolder = Join-Path -Path $SourcePath -ChildPath $HelpFolder New-ExternalHelp -Path $HelpFolder -OutputPath "$(Join-Path $BuiltModuleFolder $HelpCultureInfo)" -Force } |