Microsoft.PowerShell.PlatyPS.psm1
function Show-HelpPreview { [CmdletBinding()] [OutputType('MamlCommandHelpInfo')] param( [Parameter(Mandatory=$true, ValueFromPipeline=$true, ParameterSetName = "Path", Position=1)] [SupportsWildcards()] [string[]]$Path, [Parameter(Mandatory=$true, ValueFromPipeline=$true, ParameterSetName = "LiteralPath", Position=1)] [Alias('PSPath', 'LP')] [string[]]$LiteralPath, [switch]$ConvertNotesToList, [switch]$ConvertDoubleDashLists ) process { if ($PSCmdlet.ParameterSetName -eq 'LiteralPath') { $paths = $LiteralPath } else { $paths = $Path } foreach ($MamlFilePath in $paths) { if ($PSCmdlet.ParameterSetName -eq 'LiteralPath') { $fileArgs = @{ LiteralPath = $MamlFilePath } } else { $fileArgs = @{ LiteralPath = $MamlFilePath } } if (-not (Test-path -Type Leaf @fileArgs)) { Write-Error -Message "File '${MamlFilePath}' does not exist." continue } # this is Resolve-Path that resolves mounted drives (i.e. good for tests) $MamlFilePath = (Get-ChildItem @fileArgs -ErrorAction Stop).FullName # Read the maml file $xml = [xml](Get-Content @fileArgs -Raw -ea SilentlyContinue) if (-not $xml) { # already error-out on the conversion, no need to repeat ourselves continue } # we need a copy of maml file to bypass powershell cache, # in case we reuse the same filename few times. $MamlCopyPath = [System.IO.Path]::GetTempFileName() try { if ($ConvertDoubleDashLists) { $null = $xml.GetElementsByTagName('maml:para') | ForEach-Object { # Convert "-- "-lists into "- "-lists # to make them markdown compatible # as described in https://github.com/PowerShell/platyPS/issues/117 $newInnerXml = $_.get_InnerXml() -replace "(`n|^)-- ", '$1- ' $_.set_InnerXml($newInnerXml) } } if ($ConvertNotesToList) { # Add inline bullet-list, as described in https://github.com/PowerShell/platyPS/issues/125 $xml.helpItems.command.alertSet.alert | ForEach-Object { # make first <para> a list item # add indentations to other <para> to make them continuation of list item $_.ChildNodes | Select-Object -First 1 | ForEach-Object { $newInnerXml = '* ' + $_.get_InnerXml() $_.set_InnerXml($newInnerXml) } $_.ChildNodes | Select-Object -Skip 1 | ForEach-Object { # this character is not a valid space. # We have to use some odd character here, becasue help engine strips out # all legetimate whitespaces. # Note: powershell doesn't render it properly, it will appear as a non-writable char. $newInnerXml = ([string][char]0xc2a0) * 2 + $_.get_InnerXml() $_.set_InnerXml($newInnerXml) } } } # in PS v5 help engine is not happy, when first non-empty link (== Online version link) is not a valid URI # User encounter this problem too oftern to ignore it, hence this workaround in platyPS: # always add a dummy link with a valid URI into xml and then remove the first link from the help object. # for more context see https://github.com/PowerShell/platyPS/issues/144 $xml.helpItems.command.relatedLinks | ForEach-Object { if ($_) { $_.InnerXml = '<maml:navigationLink xmlns:maml="http://schemas.microsoft.com/maml/2004/10"><maml:linkText>PLATYPS_DUMMY_LINK</maml:linkText><maml:uri>https://github.com/PowerShell/platyPS/issues/144</maml:uri></maml:navigationLink>' + $_.InnerXml } } $xml.Save($MamlCopyPath) foreach ($command in $xml.helpItems.command.details.name) { #PlatyPS will have trouble parsing a command with space around the name. $command = $command.Trim() $thisDefinition = @" <# .ExternalHelp $MamlCopyPath #> filter $command { [CmdletBinding()] Param ( [Parameter(Mandatory=`$true)] [switch]`$platyPSHijack ) Microsoft.PowerShell.Utility\Write-Warning 'PlatyPS hijacked your command $command.' Microsoft.PowerShell.Utility\Write-Warning 'We are sorry for that. It means, there is a bug in our Get-HelpPreview logic.' Microsoft.PowerShell.Utility\Write-Warning 'Please report this issue https://github.com/PowerShell/platyPS/issues' Microsoft.PowerShell.Utility\Write-Warning 'Restart PowerShell to fix the problem.' } # filter is rare enough to distinguish with other commands `$innerHelp = Microsoft.PowerShell.Core\Get-Help $command -Full -Category filter Microsoft.PowerShell.Core\Export-ModuleMember -Function @() "@ $m = New-Module ( [scriptblock]::Create( "$thisDefinition" )) $help = & $m { $innerHelp } # this is the second part of the workaround for https://github.com/PowerShell/platyPS/issues/144 # see comments above for context $help.relatedLinks | ForEach-Object { if ($_) { $_.navigationLink = $_.navigationLink | Select-Object -Skip 1 } } $help # yeild } } finally { Remove-Item $MamlCopyPath } } } } function Assert-TargetInFilesystem { param ([string]$target) $item = Get-Item $target -ErrorAction SilentlyContinue if ($item.PSProvider.Name -ne 'FileSystem') { throw "Target '$target' is not in the filesystem." } } function Assert-Command { param ([string]$command) $cmd = Get-Command $command -ErrorAction SilentlyContinue -Type Application if (-not $cmd) { throw "Command '$command' not found." } } function MakeHelpInfoXml { Param( [Parameter(mandatory=$true)] [string] $ModuleName, [Parameter(mandatory=$true)] [string] $GUID, [Parameter(mandatory=$true)] [string] $HelpCulture, [Parameter(mandatory=$true)] [string] $HelpVersion, [Parameter(mandatory=$true)] [string] $URI, [Parameter(mandatory=$true)] [string] $OutputFolder ) $HelpInfoFileNme = $ModuleName + "_" + $GUID + "_HelpInfo.xml" $OutputFullPath = Join-Path $OutputFolder $HelpInfoFileNme if(Test-Path $OutputFullPath -PathType Leaf) { [xml] $HelpInfoContent = Get-Content $OutputFullPath } #Create the base XML object for the Helpinfo.xml file. $xml = [xml]::new() $ns = "http://schemas.microsoft.com/powershell/help/2010/05" $declaration = $xml.CreateXmlDeclaration("1.0","utf-8",$null) $rootNode = $xml.CreateElement("HelpInfo",$ns) $null = $xml.InsertBefore($declaration,$xml.DocumentElement) $null = $xml.AppendChild($rootNode) $HelpContentUriNode = $xml.CreateElement("HelpContentURI",$ns) $HelpContentUriNode.InnerText = $URI $null = $xml["HelpInfo"].AppendChild($HelpContentUriNode) $HelpSupportedCulturesNode = $xml.CreateElement("SupportedUICultures",$ns) $null = $xml["HelpInfo"].AppendChild($HelpSupportedCulturesNode) #If no previous help file if(-not $HelpInfoContent) { $HelpUICultureNode = $xml.CreateElement("UICulture",$ns) $null = $xml["HelpInfo"]["SupportedUICultures"].AppendChild($HelpUICultureNode) $HelpUICultureNameNode = $xml.CreateElement("UICultureName",$ns) $HelpUICultureNameNode.InnerText = $HelpCulture $null = $xml["HelpInfo"]["SupportedUICultures"]["UICulture"].AppendChild($HelpUICultureNameNode) $HelpUICultureVersionNode = $xml.CreateElement("UICultureVersion",$ns) $HelpUICultureVersionNode.InnerText = $HelpVersion $null = $xml["HelpInfo"]["SupportedUICultures"]["UICulture"].AppendChild($HelpUICultureVersionNode) [xml] $HelpInfoContent = $xml } else { #Get old culture info $ExistingCultures = @{} foreach($Culture in $HelpInfoContent.HelpInfo.SupportedUICultures.UICulture) { $ExistingCultures.Add($Culture.UICultureName, $Culture.UICultureVersion) } #If culture exists update version, if not, add culture and version if(-not ($HelpCulture -in $ExistingCultures.Keys)) { $null = $ExistingCultures.Add($HelpCulture,$HelpVersion) } else { $ExistingCultures[$HelpCulture] = $HelpVersion } $cultureNames = @() $cultureNames += $ExistingCultures.GetEnumerator() #write out cultures to XML for($i=0;$i -lt $ExistingCultures.Count; $i++) { $HelpUICultureNode = $xml.CreateElement("UICulture",$ns) $HelpUICultureNameNode = $xml.CreateElement("UICultureName",$ns) $HelpUICultureNameNode.InnerText = $cultureNames[$i].Name $null = $HelpUICultureNode.AppendChild($HelpUICultureNameNode) $HelpUICultureVersionNode = $xml.CreateElement("UICultureVersion",$ns) $HelpUICultureVersionNode.InnerText = $cultureNames[$i].Value $null = $HelpUICultureNode.AppendChild($HelpUICultureVersionNode) $null = $xml["HelpInfo"]["SupportedUICultures"].AppendChild($HelpUICultureNode) } [xml] $HelpInfoContent = $xml } $outputItem = Get-Item $outputFullPath $null = $HelpInfoContent.Save($outputItem.FullName) # return this to the caller $outputItem } function New-HelpCabinetFile { [Cmdletbinding(SupportsShouldProcess=$true)] [OutputType([System.IO.FileInfo])] param( [parameter(Mandatory=$true)] [ValidateScript({(Test-Path $_ -PathType Container)})] [string] $CabinetFilesFolder, [parameter(Mandatory=$true)] [ValidateScript({(Test-Path $_ -PathType Leaf)})] [string] $MarkdownModuleFile, [parameter(Mandatory=$true)] [string] $OutputFolder ) end { if (! $IsWindows) { throw "'New-HelpCabinetFile' is only supported on Windows." } if (Test-Path -Path $outputFolder -PathType Leaf) { throw "Output folder '$outputFolder' is not a directory." } $outputFiles = @() if (! $PSCmdlet.ShouldProcess($OutputFolder, "Create Cabinet File")) { return } $MODULE_PAGE_MODULE_NAME = "Module Name" $MODULE_PAGE_GUID = "Module Guid" $MODULE_PAGE_LOCALE = "Locale" $MODULE_PAGE_FW_LINK = "HelpInfoUri" # was 'Download Help Link' $MODULE_PAGE_HELP_VERSION = "Help Version" $MODULE_PAGE_ADDITIONAL_LOCALE = "Additional Locale" $outputFolderInfo = Get-Item $OutputFolder -ErrorAction SilentlyContinue if (! $outputFolderInfo) { $unresolvedOutputFolder = $executioncontext.sessionstate.path.GetUnresolvedProviderPathFromPSPath($OutputFolder) $outputFolderDrive = Get-PSDrive ((split-path -qual $unresolvedOutputFolder).trim(":")) if ($outputFolderDrive.Provider.Name -ne 'FileSystem') { throw "Output folder '$OutputFolder' is not in the filesystem." } $null = New-Item -Type Directory $OutputFolder -ErrorAction Stop } else { Assert-TargetInFilesystem -target $OutputFolder } Assert-Command MakeCab.exe #Testing for files in source directory if((Get-ChildItem -Path $CabinetFilesFolder).Count -le 0) { throw "Path '${CabinetFilesFolder}' does not contain any files." } #Testing for valid help file types $ValidHelpFileTypes = '.xml', '.txt' $HelpFiles = Get-ChildItem -Path $CabinetFilesFolder -File $ValidHelpFiles = $HelpFiles | Where-Object { $_.Extension -in $ValidHelpFileTypes } $InvalidHelpFiles = $HelpFiles | Where-Object { $_.Extension -notin $ValidHelpFileTypes } if(-not $ValidHelpFiles) { throw "No valid help files found in '${CabinetFilesFolder}'." } if($InvalidHelpFiles) { $InvalidHelpFiles | ForEach-Object { Write-Warning -Message "File '${$_}' is not a valid help file type. Excluding from Cab file." } } ###Get Yaml Metadata here $mf = Import-MarkdownModuleFile -Path $MarkdownModuleFile $ModuleName = $mf.Metadata[$MODULE_PAGE_MODULE_NAME] $Guid = $mf.Metadata[$MODULE_PAGE_GUID] $Locale = $mf.Metadata[$MODULE_PAGE_LOCALE] $FwLink = $mf.Metadata[$MODULE_PAGE_FW_LINK] $HelpVersion = $mf.Metadata[$MODULE_PAGE_HELP_VERSION] $AdditionalLocale = $mf.Metadata[$MODULE_PAGE_ADDITIONAL_LOCALE] #Create HelpInfo File Write-Verbose -Message "Creating cab for '${ModuleName}', with Guid '${Guid}', in Locale '${Locale}'" #Building the cabinet file name. $cabName = ("{0}_{1}_{2}_HelpContent.cab" -f $ModuleName,$Guid,$Locale) $zipName = ("{0}_{1}_{2}_HelpContent.zip" -f $ModuleName,$Guid,$Locale) $zipPath = (Join-Path $OutputFolder $zipName) #Setting Cab Directives, make a cab is turned on, compression is turned on Write-Verbose -Message "Creating Cabinet file directives." $DirectiveFile = "dir.dff" New-Item -ItemType File -Name $DirectiveFile -Force | Out-Null Add-Content $DirectiveFile ".Set Cabinet=on" Add-Content $DirectiveFile ".Set Compress=on" Add-Content $DirectiveFile ".Set MaxDiskSize=CDROM" #Creates an entry in the cab directive file for each file in the source directory (uses FullName to get fuly qualified file path and name) foreach($file in $ValidHelpFiles) { Add-Content $DirectiveFile ("'" + ($file).FullName +"'" ) Compress-Archive -DestinationPath $zipPath -Path $file.FullName -Update } #Making Cab Write-Verbose -Message "Creating Cabinet file." MakeCab.exe /f $DirectiveFile | Out-Null #Naming CabFile Write-Verbose -Message "Moving the cabinet file to path '${OutputFolder}'" Copy-Item "disk1/1.cab" (Join-Path $OutputFolder $cabName) #Remove ExtraFiles created by the cabbing process Write-Verbose -Message "Removing unnecessary cabinet file contents." Remove-Item "setup.inf" -ErrorAction SilentlyContinue Remove-Item "setup.rpt" -ErrorAction SilentlyContinue Remove-Item $DirectiveFile -ErrorAction SilentlyContinue Remove-Item -Path "disk1" -Recurse -ErrorAction SilentlyContinue #Create the HelpInfo Xml $outputFiles += MakeHelpInfoXml -ModuleName $ModuleName -GUID $Guid -HelpCulture $Locale -HelpVersion $HelpVersion -URI $FwLink -OutputFolder $OutputFolder if($AdditionalLocale) { $allLocales = $AdditionalLocale foreach($loc in $allLocales) { #Create the HelpInfo Xml for each locale $locVersion = $mf.Metadata["$loc Version"] if([String]::IsNullOrEmpty($locVersion)) { Write-Warning -Message "No version found for Locale '{$loc}'." } else { $outputFiles += MakeHelpInfoXml -ModuleName $ModuleName -GUID $Guid -HelpCulture $loc -HelpVersion $locVersion -URI $FwLink -OutputFolder $OutputFolder } } } $outputFiles } } # SIG # Begin signature block # MIIoKgYJKoZIhvcNAQcCoIIoGzCCKBcCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAyGmtg/Ajh1Y9o # tt+Kw2MKJ0FNnQfXLiKNnRHidDY8B6CCDXYwggX0MIID3KADAgECAhMzAAAEBGx0 # Bv9XKydyAAAAAAQEMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjQwOTEyMjAxMTE0WhcNMjUwOTExMjAxMTE0WjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQC0KDfaY50MDqsEGdlIzDHBd6CqIMRQWW9Af1LHDDTuFjfDsvna0nEuDSYJmNyz # NB10jpbg0lhvkT1AzfX2TLITSXwS8D+mBzGCWMM/wTpciWBV/pbjSazbzoKvRrNo # DV/u9omOM2Eawyo5JJJdNkM2d8qzkQ0bRuRd4HarmGunSouyb9NY7egWN5E5lUc3 # a2AROzAdHdYpObpCOdeAY2P5XqtJkk79aROpzw16wCjdSn8qMzCBzR7rvH2WVkvF # HLIxZQET1yhPb6lRmpgBQNnzidHV2Ocxjc8wNiIDzgbDkmlx54QPfw7RwQi8p1fy # 4byhBrTjv568x8NGv3gwb0RbAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQU8huhNbETDU+ZWllL4DNMPCijEU4w # RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW # MBQGA1UEBRMNMjMwMDEyKzUwMjkyMzAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci # tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG # CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu # Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0 # MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAIjmD9IpQVvfB1QehvpC # Ge7QeTQkKQ7j3bmDMjwSqFL4ri6ae9IFTdpywn5smmtSIyKYDn3/nHtaEn0X1NBj # L5oP0BjAy1sqxD+uy35B+V8wv5GrxhMDJP8l2QjLtH/UglSTIhLqyt8bUAqVfyfp # h4COMRvwwjTvChtCnUXXACuCXYHWalOoc0OU2oGN+mPJIJJxaNQc1sjBsMbGIWv3 # cmgSHkCEmrMv7yaidpePt6V+yPMik+eXw3IfZ5eNOiNgL1rZzgSJfTnvUqiaEQ0X # dG1HbkDv9fv6CTq6m4Ty3IzLiwGSXYxRIXTxT4TYs5VxHy2uFjFXWVSL0J2ARTYL # E4Oyl1wXDF1PX4bxg1yDMfKPHcE1Ijic5lx1KdK1SkaEJdto4hd++05J9Bf9TAmi # u6EK6C9Oe5vRadroJCK26uCUI4zIjL/qG7mswW+qT0CW0gnR9JHkXCWNbo8ccMk1 # sJatmRoSAifbgzaYbUz8+lv+IXy5GFuAmLnNbGjacB3IMGpa+lbFgih57/fIhamq # 5VhxgaEmn/UjWyr+cPiAFWuTVIpfsOjbEAww75wURNM1Imp9NJKye1O24EspEHmb # DmqCUcq7NqkOKIG4PVm3hDDED/WQpzJDkvu4FrIbvyTGVU01vKsg4UfcdiZ0fQ+/ # V0hf8yrtq9CkB8iIuk5bBxuPMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq # hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x # EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv # bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5 # IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG # EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG # A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg # Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC # CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03 # a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr # rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg # OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy # 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9 # sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh # dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k # A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB # w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn # Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90 # lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w # ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o # ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD # VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa # BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny # bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG # AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t # L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV # HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3 # dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG # AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl # AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb # C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l # hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6 # I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0 # wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560 # STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam # ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa # J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah # XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA # 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt # Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr # /Xmfwb1tbWrJUnMTDXpQzTGCGgowghoGAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp # Z25pbmcgUENBIDIwMTECEzMAAAQEbHQG/1crJ3IAAAAABAQwDQYJYIZIAWUDBAIB # BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO # MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIDDztrQcoHapGkM1LHBJjFjO # xLnNTVWH1/iXP+uKlhwbMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A # cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB # BQAEggEAZpff40synbzxp5dJ0bDyuTyp+4vAcyOv6h8FTPeBHXV7O01UJp2+KdB+ # NgxvoW/X4O9CBZNtlJ0WTojxD4W95AS7XO0NRYoYddujlD7/hdBHNQ0EBeQZmQrR # +O6q+At3yRWKMIvxcN1DqK7tG6YPFyljrvtdwXh3stNxb7lkZsPYEgFcOd61pa9Y # UToGzI+AGJfzjSl4QwpxZ8GNCxsUcJqRyWUooE4pPerEABSlRVlW6rH3RpFz6aAX # AHcwcRejIYq17VSXQJ8wYrDLwYx5zILpcsCf8/S/KmFvQrXRBnUU2HZ2c6JuqJ/c # VKKcMkS8XN9a7yLY/tKRtNCxP9/j7aGCF5QwgheQBgorBgEEAYI3AwMBMYIXgDCC # F3wGCSqGSIb3DQEHAqCCF20wghdpAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsq # hkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl # AwQCAQUABCAvKuEsAzPbHItcfItYnfwlAoX9rbsMMNmuBAykUxkjHQIGZ8YipnsZ # GBMyMDI1MDMxMjE3NTQxNC4yODNaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l # cmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046ODYwMy0w # NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Wg # ghHqMIIHIDCCBQigAwIBAgITMwAAAgcsETmJzYX7xQABAAACBzANBgkqhkiG9w0B # AQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD # VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNTAxMzAxOTQy # NTJaFw0yNjA0MjIxOTQyNTJaMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz # aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv # cnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25z # MScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046ODYwMy0wNUUwLUQ5NDcxJTAjBgNV # BAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEB # AQUAA4ICDwAwggIKAoICAQDFP/96dPmcfgODe3/nuFveuBst/JmSxSkOn89ZFytH # Qm344iLoPqkVws+CiUejQabKf+/c7KU1nqwAmmtiPnG8zm4Sl9+RJZaQ4Dx3qtA9 # mdQdS7Chf6YUbP4Z++8laNbTQigJoXCmzlV34vmC4zpFrET4KAATjXSPK0sQuFhK # r7ltNaMFGclXSnIhcnScj9QUDVLQpAsJtsKHyHN7cN74aEXLpFGc1I+WYFRxaTgq # SPqGRfEfuQ2yGrAbWjJYOXueeTA1MVKhW8zzSEpfjKeK/t2XuKykpCUaKn5s8sqN # bI3bHt/rE/pNzwWnAKz+POBRbJxIkmL+n/EMVir5u8uyWPl1t88MK551AGVh+2H4 # ziR14YDxzyCG924gaonKjicYnWUBOtXrnPK6AS/LN6Y+8Kxh26a6vKbFbzaqWXAj # zEiQ8EY9K9pYI/KCygixjDwHfUgVSWCyT8Kw7mGByUZmRPPxXONluMe/P8CtBJMp # uh8CBWyjvFfFmOSNRK8ETkUmlTUAR1CIOaeBqLGwscShFfyvDQrbChmhXib4nRMX # 5U9Yr9d7VcYHn6eZJsgyzh5QKlIbCQC/YvhFK42ceCBDMbc+Ot5R6T/Mwce5jVyV # CmqXVxWOaQc4rA2nV7onMOZC6UvCG8LGFSZBnj1loDDLWo/I+RuRok2j/Q4zcMnw # kQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFHK1UmLCvXrQCvR98JBq18/4zo0eMB8G # A1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCG # Tmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUy # MFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4w # XAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2Vy # dHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwG # A1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQD # AgeAMA0GCSqGSIb3DQEBCwUAA4ICAQDju0quPbnix0slEjD7j2224pYOPGTmdDvO # 0+bNRCNkZqUv07P04nf1If3Y/iJEmUaU7w12Fm582ImpD/Kw2ClXrNKLPTBO6nfx # vOPGtalpAl4wqoGgZxvpxb2yEunG4yZQ6EQOpg1dE9uOXoze3gD4Hjtcc75kca8y # ivowEI+rhXuVUWB7vog4TGUxKdnDvpk5GSGXnOhPDhdId+g6hRyXdZiwgEa+q9M9 # Xctz4TGhDgOKFsYxFhXNJZo9KRuGq6evhtyNduYrkzjDtWS6gW8akR59UhuLGsVq # +4AgqEY8WlXjQGM2OTkyBnlQLpB8qD7x9jRpY2Cq0OWWlK0wfH/1zefrWN5+be87 # Sw2TPcIudIJn39bbDG7awKMVYDHfsPJ8ZvxgWkZuf6ZZAkph0eYGh3IV845taLkd # LOCvw49Wxqha5Dmi2Ojh8Gja5v9kyY3KTFyX3T4C2scxfgp/6xRd+DGOhNVPvVPa # /3yRUqY5s5UYpy8DnbppV7nQO2se3HvCSbrb+yPyeob1kUfMYa9fE2bEsoMbOaHR # gGji8ZPt/Jd2bPfdQoBHcUOqPwjHBUIcSc7xdJZYjRb4m81qxjma3DLjuOFljMZT # YovRiGvEML9xZj2pHRUyv+s5v7VGwcM6rjNYM4qzZQM6A2RGYJGU780GQG0QO98w # +sucuTVrfTCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZI # hvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # MjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAy # MDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp # bWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC # AQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25Phdg # M/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPF # dvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6 # GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBp # Dco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50Zu # yjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3E # XzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0 # lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1q # GFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ # +QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PA # PBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkw # EgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxG # NSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARV # MFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWlj # cm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAK # BggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC # AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX # zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v # cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI # KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG # 9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0x # M7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmC # VgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449 # xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wM # nosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDS # PeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2d # Y3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxn # GSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+Crvs # QWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokL # jzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL # 6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNN # MIICNQIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp # bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw # b3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEn # MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjg2MDMtMDVFMC1EOTQ3MSUwIwYDVQQD # ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQDT # vVU/Yj9lUSyeDCaiJ2Da5hUiS6CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w # IFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA63vVITAiGA8yMDI1MDMxMjA5NDA0 # OVoYDzIwMjUwMzEzMDk0MDQ5WjB0MDoGCisGAQQBhFkKBAExLDAqMAoCBQDre9Uh # AgEAMAcCAQACAifxMAcCAQACAhLgMAoCBQDrfSahAgEAMDYGCisGAQQBhFkKBAIx # KDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZI # hvcNAQELBQADggEBAFvXODMO5MbFYPDUKCOxVogdFsQdAW9qsBnkISe07dihp6Wy # Cq6kM9OcRxQMBDSlH1s6xeJeEDbVexq2Mk3hGH6bU5nE32K4zZBsXljUC/0mBSkI # gy5cunDjlkb9tLyMaWsLs5zt6asgouYRFr7sv6lORmadiI9N095lyPVctm21mBUC # U9YzdESTtFU/hvbVpXXLclX8zliTAxu57Vk/RG3XG91w0vQ17wWDhXq+Ik78LFii # RWl/87CoGlpi+2wwgDmokWxc8gle6QMzWItHCJYl0/o/4fj8R/lKmTDimrshCXwc # sKB64iEl7MsA7lzjKubBs23A89ebY6w1Stf4RicxggQNMIIECQIBATCBkzB8MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNy # b3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAgcsETmJzYX7xQABAAACBzAN # BglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8G # CSqGSIb3DQEJBDEiBCDyymFuGVaWkiF0D2No0o0XG6jMPGUmLMTrdwyjnr5IsTCB # +gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIC/31NHQds1IZ5sPnv59p+v6BjBD # goDPIwiAmn0PHqezMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh # c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD # b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw # MTACEzMAAAIHLBE5ic2F+8UAAQAAAgcwIgQgkrPKi6S+sKw2HHef0SwGSNu9g8v8 # NOtpCMypJ+sy7dkwDQYJKoZIhvcNAQELBQAEggIAP+nU1fhIK+T1ex4tPYHcElvb # kPIxF+OLwdGaW4xj7pM1iXKpVW6/M3O4psdt/+SzKDBFoqiYse+0yKGg9rk3cjLF # klum005OIz0wi2suALsJwoeMxFV/STWHIo3cykJynOiWjNUzPK+DBHcRJi+V6uL1 # 2o6uuJnfC702TaCMcXUZ0EjSjx8YuNFl1XxkU9eM+J9XOnRlXRMLqbF7kUhficvX # 9yXS6FlgLaVJTJufM0QGgH3p63yhFaWBpBTEzm5bMiS/XYx++SokLAqak5bADwwg # lOcBg4EYxSSTPubdL9jP+V1M6VyooaH3YxwoWU5Xjucw1LgyfobKlCKp/69CFRjU # iiv6rHvX4U23bSTGGR7MusxIncNsfsMlVNq96h8U4ueMa6jjEtejP5z1mAYzF7wK # Wph1wQm4Bs9yxBax9+4D5trqUaat5k6DCoRRWU8FU9V90gWa5g5CsgAmEpBFNdoT # w0M7wrlhvzaD0QyalAlSinLaMo0AEy2BGtYbK5zd/O1bPmFxHYW/oxKzBBLMeODL # i0B29Y1U7HRvKvXIF6pZ94hjrSMmHb3j/Ze9YHLdb4Z1FHNxfB+CemT84W/2UOmt # /FrKwJv+JEGsJSOLPKC6qwYPQPkWcFqSrntVHUQMfqfu3A0maSCdgImVnXze6wyT # Yi/Vk2jdFLFv6R/Wizs= # SIG # End signature block |