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 } $null = $HelpInfoContent.Save($OutputFullPath) $outputItem = Get-Item $OutputFullPath # 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 # MIIoVQYJKoZIhvcNAQcCoIIoRjCCKEICAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBaipMmPAOm3PrQ # FHzqlC/baFN+KP5j/1KxkRNKY00en6CCDYUwggYDMIID66ADAgECAhMzAAAEA73V # lV0POxitAAAAAAQDMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjQwOTEyMjAxMTEzWhcNMjUwOTExMjAxMTEzWjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQCfdGddwIOnbRYUyg03O3iz19XXZPmuhEmW/5uyEN+8mgxl+HJGeLGBR8YButGV # LVK38RxcVcPYyFGQXcKcxgih4w4y4zJi3GvawLYHlsNExQwz+v0jgY/aejBS2EJY # oUhLVE+UzRihV8ooxoftsmKLb2xb7BoFS6UAo3Zz4afnOdqI7FGoi7g4vx/0MIdi # kwTn5N56TdIv3mwfkZCFmrsKpN0zR8HD8WYsvH3xKkG7u/xdqmhPPqMmnI2jOFw/ # /n2aL8W7i1Pasja8PnRXH/QaVH0M1nanL+LI9TsMb/enWfXOW65Gne5cqMN9Uofv # ENtdwwEmJ3bZrcI9u4LZAkujAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQU6m4qAkpz4641iK2irF8eWsSBcBkw # VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh # dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwMjkyNjAfBgNVHSMEGDAW # gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw # MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov # L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx # XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB # AFFo/6E4LX51IqFuoKvUsi80QytGI5ASQ9zsPpBa0z78hutiJd6w154JkcIx/f7r # EBK4NhD4DIFNfRiVdI7EacEs7OAS6QHF7Nt+eFRNOTtgHb9PExRy4EI/jnMwzQJV # NokTxu2WgHr/fBsWs6G9AcIgvHjWNN3qRSrhsgEdqHc0bRDUf8UILAdEZOMBvKLC # rmf+kJPEvPldgK7hFO/L9kmcVe67BnKejDKO73Sa56AJOhM7CkeATrJFxO9GLXos # oKvrwBvynxAg18W+pagTAkJefzneuWSmniTurPCUE2JnvW7DalvONDOtG01sIVAB # +ahO2wcUPa2Zm9AiDVBWTMz9XUoKMcvngi2oqbsDLhbK+pYrRUgRpNt0y1sxZsXO # raGRF8lM2cWvtEkV5UL+TQM1ppv5unDHkW8JS+QnfPbB8dZVRyRmMQ4aY/tx5x5+ # sX6semJ//FbiclSMxSI+zINu1jYerdUwuCi+P6p7SmQmClhDM+6Q+btE2FtpsU0W # +r6RdYFf/P+nK6j2otl9Nvr3tWLu+WXmz8MGM+18ynJ+lYbSmFWcAj7SYziAfT0s # IwlQRFkyC71tsIZUhBHtxPliGUu362lIO0Lpe0DOrg8lspnEWOkHnCT5JEnWCbzu # iVt8RX1IV07uIveNZuOBWLVCzWJjEGa+HhaEtavjy6i7MIIHejCCBWKgAwIBAgIK # YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV # BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv # c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm # aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw # OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD # VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG # 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la # UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc # 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D # dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+ # lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk # kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6 # A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd # X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL # 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd # sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3 # T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS # 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI # bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL # BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD # uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv # c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf # MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3 # dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf # MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF # BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h # cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA # YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn # 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7 # v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b # pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/ # KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy # CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp # mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi # hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb # BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS # oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL # gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX # cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCGiYwghoiAgEBMIGVMH4x # CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt # b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p # Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAQDvdWVXQ87GK0AAAAA # BAMwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw # HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIEM9 # IMSx+Ycq/QiWKA8NswAtMGEWVZRISH//1bc8qad4MEIGCisGAQQBgjcCAQwxNDAy # oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20wDQYJKoZIhvcNAQEBBQAEggEAQjti2WwC4mBRLxpa3nMiKeExvk8HXSBWs6C7 # YJA+p2AMraec0V9h6X7gDPheEIs741+n2hRQucdlbuQgP4ge3hlOHIpVPiz7hH1N # pCxK54JZhQPQypzbVXfstCgXpiVUGe1aa1OgmqYS6pDYbt7M0lg/jd22bisBeweP # G29F68J1YM0oO4TvI+jbjc6OKlASK1dQ+VMkiLRgg2lzG2Q1ss3mj6bHjWdR2Y+Q # SNdHZ+k9D77GJb+O2Ck+VG7A7TR0JNaEi9T8SoZnyIsLrvay3vjYDM/5cz1dav9k # t9c/RzHBxHYK3Wg4jUq812c6GPYAuwlUbr0wMFJN+sYfIm3p7qGCF7AwghesBgor # BgEEAYI3AwMBMYIXnDCCF5gGCSqGSIb3DQEHAqCCF4kwgheFAgEDMQ8wDQYJYIZI # AWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGE # WQoDATAxMA0GCWCGSAFlAwQCAQUABCBRJXiTYk0dGFjqVLRuq/FTu/nWjHAYDXtn # CLquRGWDKQIGaFmQcT1WGBMyMDI1MDcwMjIyMTE0Ni44OTJaMASAAgH0oIHZpIHW # MIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQL # EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsT # Hm5TaGllbGQgVFNTIEVTTjo2NTFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9z # b2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEf4wggcoMIIFEKADAgECAhMzAAAB9ZkJ # lLzxxlCMAAEAAAH1MA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w # IFBDQSAyMDEwMB4XDTI0MDcyNTE4MzEwMVoXDTI1MTAyMjE4MzEwMVowgdMxCzAJ # BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jv # c29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVs # ZCBUU1MgRVNOOjY1MUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGlt # ZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA # zO90cFQTWd/WP84IT7JMIW1fQL61sdfgmhlfT0nvYEb2kvkNF073ZwjveuSWot38 # 7LjE0TCiG93e6I0HzIFQBnbxGP/WPBUirFq7WE5RAsuhNfYUL+PIb9jJq3CwWxIC # fw5t/pTyIOHjKvo1lQOTWZypir/psZwEE7y2uWAPbZJTFrKen5R73x2Hbxy4eW1D # cmXjym2wFWv10sBH40ajJfe+OkwcTdoYrY3KkpN/RQSjeycK0bhjo0CGYIYa+ZMA # ao0SNR/R1J1Y6sLkiCJO3aQrbS1Sz7l+/qJgy8fyEZMND5Ms7C0sEaOvoBHiWSpT # M4vc0xDLCmc6PGv03CtWu2KiyqrL8BAB1EYyOShI3IT79arDIDrL+de91FfjmSbB # Y5j+HvS0l3dXkjP3Hon8b74lWwikF0rzErF0n3khVAusx7Sm1oGG+06hz9XAy3Wo # u+T6Se6oa5LDiQgPTfWR/j9FNk8Ju06oSfTh6c03V0ulla0Iwy+HzUl+WmYxFLU0 # PiaXsmgudNwVqn51zr+Bi3XPJ85wWuy6GGT7nBDmXNzTNkzK98DBQjTOabQXUZ88 # 4Yb9DFNcigmeVTYkyUXZ6hscd8Nyq45A3D3bk+nXnsogK1Z7zZj6XbGft7xgOYvv # eU6p0+frthbF7MXv+i5qcD9HfFmOq4VYHevVesYb6P0CAwEAAaOCAUkwggFFMB0G # A1UdDgQWBBRV4Hxb9Uo0oHDwJZJe22ixe2B1ATAfBgNVHSMEGDAWgBSfpxVdAF5i # XYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jv # c29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENB # JTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRw # Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRp # bWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1Ud # JQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsF # AAOCAgEAcwxmVPaA9xHffuom0TOSp2hspuf1G0cHW/KXHAuhnpW8/Svlq5j9aKI/ # 8/G6fGIQMr0zlpau8jy83I4zclGdJjl5S02SxDlUKawtWvgf7ida06PgjeQM1eX4 # Lut4bbPfT0FEp77G76hhysXxTJNHv5y+fwThUeiiclihZwqcZMpa46m+oV6igTU6 # I0EnneotMqFs0Q3zHgVVr4WXjnG2Bcnkip42edyg/9iXczqTBrEkvTz0UlltpFGa # QnLzq+No8VEgq0UG7W1ELZGhmmxFmHABwTT6sPJFV68DfLoC0iB9Qbb9VZ8mvbTV # 5JtISBklTuVAlEkzXi9LIjNmx+kndBfKP8dxG/xbRXptQDQDaCsS6ogLkwLgH6zS # s+ul9WmzI0F8zImbhnZhUziIHheFo4H+ZoojPYcgTK6/3bkSbOabmQFf95B8B6e5 # WqXbS5s9OdMdUlW1gTI1r5u+WAwH2KG7dxneoTbf/jYl3TUtP7AHpyck2c0nun/Q # 0Cycpa9QUH/Dy01k6tQomNXGjivg2/BGcgZJ0Hw8C6KVelEJ31xLoE21m9+NEgSK # CRoFE1Lkma31SyIaynbdYEb8sOlZynMdm8yPldDwuF54vJiEArjrcDNXe6BobZUi # TWSKvv1DJadR1SUCO/Od21GgU+hZqu+dKgjKAYdeTIvi9R2rtLYwggdxMIIFWaAD # AgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYD # VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe # MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3Nv # ZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIy # MjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo # aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y # cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw # MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5 # vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64 # NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhu # je3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl # 3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPg # yY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I # 5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2 # ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/ # TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy # 16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y # 1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6H # XtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMB # AAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQW # BBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30B # ATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz # L0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYB # BAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMB # Af8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBL # oEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv # TWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggr # BgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNS # b29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1Vffwq # reEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27 # DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pv # vinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9Ak # vUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWK # NsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2 # kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+ # c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep # 8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+Dvk # txW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1Zyvg # DbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/ # 2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDWTCCAkECAQEwggEBoYHZpIHW # MIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH # UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQL # EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsT # Hm5TaGllbGQgVFNTIEVTTjo2NTFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9z # b2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIaAxUAJsAKu48NbR5Y # Rg3WSBQCyjzdkvaggYMwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz # aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv # cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx # MDANBgkqhkiG9w0BAQsFAAIFAOwP68gwIhgPMjAyNTA3MDIxNzMyNTZaGA8yMDI1 # MDcwMzE3MzI1NlowdzA9BgorBgEEAYRZCgQBMS8wLTAKAgUA7A/ryAIBADAKAgEA # AgIs+AIB/zAHAgEAAgISuTAKAgUA7BE9SAIBADA2BgorBgEEAYRZCgQCMSgwJjAM # BgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEB # CwUAA4IBAQBsFOO+URl/7ZYAUXOI1CR/ZEXHFgyko6ojzM2Ir4pttX+iCCH8fYrQ # eQdCGLtwDcTW0bZcX7klLGCtDmlqRG+fgb4aQv07S75ukLhmdejIER8iq4QbpjEV # iLdeSyFkXswmfQfndznDFgXCDtidKdlMxJ/yLOKEtD5iuB7/bTxf43YmXjH9i2V6 # s5q0krKft8bSiIJ7GECfbZaAEPTr8kKA27Wm2PjBs/WuuuSigY077VOEf4wgSUtW # G7t4qUV2TY1lIUo6lli6vPRKBblFZ4DphSHM1vOiZt0hV/0/70RgwwAdCEJAJoj0 # qo8QtJoYXW4i1/PbYxpC+B8tdsGVbshKMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UE # BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc # BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0 # IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAH1mQmUvPHGUIwAAQAAAfUwDQYJYIZI # AWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG # 9w0BCQQxIgQgeVHK9RqtPp+ropLI3PinF56tcysP5+wJkuyaDUjGL+0wgfoGCyqG # SIb3DQEJEAIvMYHqMIHnMIHkMIG9BCDB1vLSFwh09ISu4kdEv4/tg9eR1Yk8w5x7 # j5GThqaPNTCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n # dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y # YXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMz # AAAB9ZkJlLzxxlCMAAEAAAH1MCIEIKKEnDmSWkxCKEZYgXnvv5Han9SQGxAsdEAr # +a6p/7GQMA0GCSqGSIb3DQEBCwUABIICAH+9RXJQeh/56o0thyBu/uR3nxht0P9L # GhyhjuHdJ4HPsQsYf9vHloD/OZypFbqPoJzM0Imka5eQZAXq1n+NFV7d2dnawllk # bEkHGj9dUg6w3ON/2naifr0yzlGMIl8bHnVgCyhjflQtrVHkjMel9xrxkRH4WU9k # KjkKqCOMR+XWDC1+YYWY6l93jjQOv1EyuXUQJPxi1gxJnW6YMn7jMg4bmx4q9HqL # gg4CP4KNv3+oPY4dFWYsv2ASS8nQRZfRmwX+4cN3VFiZIB80S4+zU1t0qipdsBmx # sorFQNNLlU9Q08KrlFfTvdOwAvW2HV0m2zhBIcSi7ToiQiMUnF+7fX0sUAy25o7m # aseRSVwdJlqSSY3XzI79DqO3h1vfLYpfssEqj4guAdA3PhWjz6a64SHoEG/darFV # 3JW9fia6VOE/E1LF7POoASzUQERdV6OF2NQ0lmM9OkqDOlomBxJHiKkVH8ZKVUnI # hJhZrpBuOlHti7tGYHgHtkRz8FjBBWUQDQRr+4sywC/pgCnD971AiswNKAjk47od # G3SZ6o3nN4/ptK5tHVdxEoAqiYtJJDKdGh1VS1o0h64zzwlhhZHYxEMsnFQPGWxW # LT9qv4N5HCw4lhi2y8gYEPyqZQkvxxExSjx/3g+VJLjJqbBwkt1uQA2ny/mwiIpL # e86j6U441/xa # SIG # End signature block |