mirror of
https://github.com/fleschutz/PowerShell.git
synced 2024-12-27 17:19:16 +01:00
125 lines
3.3 KiB
PowerShell
125 lines
3.3 KiB
PowerShell
<#
|
|
.SYNOPSIS
|
|
Converts the comment-based help of a PowerShell script to Markdown
|
|
.DESCRIPTION
|
|
This script converts the comment-based help of a PowerShell script to Markdown.
|
|
.PARAMETER filename
|
|
Specifies the path to the PowerShell script
|
|
.EXAMPLE
|
|
PS> ./convert-ps2md myscript.ps1
|
|
.NOTES
|
|
Author: Markus Fleschutz · License: CC0
|
|
.LINK
|
|
https://github.com/fleschutz/PowerShell
|
|
#>
|
|
|
|
param([string]$filename = "")
|
|
|
|
function EncodePartOfHtml { param([string]$Value)
|
|
($Value -replace '<', '<') -replace '>', '>'
|
|
}
|
|
|
|
function GetCode { param($Example)
|
|
$codeAndRemarks = (($Example | Out-String) -replace ($Example.title), '').Trim() -split "`r`n"
|
|
|
|
$code = New-Object "System.Collections.Generic.List[string]"
|
|
for ($i = 0; $i -lt $codeAndRemarks.Length; $i++) {
|
|
if ($codeAndRemarks[$i] -eq 'DESCRIPTION' -and $codeAndRemarks[$i + 1] -eq '-----------') { break }
|
|
if ($codeAndRemarks[$i] -eq '' -and $codeAndRemarks[$i + 1] -eq '') { continue }
|
|
if (1 -le $i -and $i -le 2) { continue }
|
|
$codeAndRemarks[$i] = ($codeAndRemarks[$i] | Out-String) -replace "PS>","PS> "
|
|
$code.Add($codeAndRemarks[$i])
|
|
}
|
|
|
|
$code -join "`r`n"
|
|
}
|
|
|
|
function GetRemark { param($Example)
|
|
$codeAndRemarks = (($Example | Out-String) -replace ($Example.title), '').Trim() -split "`r`n"
|
|
|
|
$isSkipped = $false
|
|
$remark = New-Object "System.Collections.Generic.List[string]"
|
|
for ($i = 0; $i -lt $codeAndRemarks.Length; $i++) {
|
|
if (!$isSkipped -and $codeAndRemarks[$i - 2] -ne 'DESCRIPTION' -and $codeAndRemarks[$i - 1] -ne '-----------') {
|
|
continue
|
|
}
|
|
$isSkipped = $true
|
|
$remark.Add($codeAndRemarks[$i])
|
|
}
|
|
|
|
$remark -join "`r`n"
|
|
}
|
|
|
|
try {
|
|
if ($filename -eq "") { $filename = read-host "Enter path to PowerShell script" }
|
|
$ScriptName = (get-item "$filename").Name
|
|
|
|
$full = Get-Help $filename -Full
|
|
|
|
"## $ScriptName - $($full.Synopsis)"
|
|
|
|
$Description = ($full.description | Out-String).Trim()
|
|
if ($Description -ne "") {
|
|
""
|
|
"$Description"
|
|
}
|
|
|
|
""
|
|
"## Parameters"
|
|
"``````powershell"
|
|
$Syntax = (($full.syntax | Out-String) -replace "`r`n", "`r`n").Trim()
|
|
$Syntax = (($Syntax | Out-String) -replace "/home/mf/PowerShell/Scripts/", "")
|
|
if ($Syntax -ne "") {
|
|
"$Syntax"
|
|
}
|
|
|
|
foreach($parameter in $full.parameters.parameter) {
|
|
"$(((($parameter | Out-String).Trim() -split "`r`n")[-5..-1] | % { $_.Trim() }) -join "`r`n")"
|
|
""
|
|
}
|
|
"[<CommonParameters>]"
|
|
" This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, "
|
|
" WarningVariable, OutBuffer, PipelineVariable, and OutVariable."
|
|
"``````"
|
|
|
|
foreach($input in $full.inputTypes.inputType) {
|
|
""
|
|
"## Inputs"
|
|
"$($input.type.name)"
|
|
}
|
|
|
|
foreach($output in $full.outputTypes.outputType) {
|
|
""
|
|
"## Outputs"
|
|
"$($output.type.name)"
|
|
}
|
|
|
|
foreach($example in $full.examples.example) {
|
|
""
|
|
"## Example"
|
|
"``````powershell"
|
|
"$(GetCode $example)"
|
|
"``````"
|
|
}
|
|
|
|
$Notes = ($full.alertSet.alert | Out-String).Trim()
|
|
if ($Notes -ne "") {
|
|
""
|
|
"## Notes"
|
|
"$Notes"
|
|
}
|
|
|
|
$Links = ($full.relatedlinks | Out-String).Trim()
|
|
if ($Links -ne "") {
|
|
""
|
|
"## Related Links"
|
|
"$Links"
|
|
}
|
|
|
|
""
|
|
"*Generated by convert-ps2md.ps1 using the comment-based help of $ScriptName*"
|
|
} catch {
|
|
"⚠️ Error: $($Error[0]) ($($MyInvocation.MyCommand.Name):$($_.InvocationInfo.ScriptLineNumber))"
|
|
exit 1
|
|
}
|