robertcatgithub
diff --git a/‎ModuleCommands.md‎
Lines changed: 17 additions & 0 deletions b/‎ModuleCommands.md‎
Lines changed: 17 additions & 0 deletions
diff --git a/‎PSScriptTools.psd1‎
242 Bytes b/‎PSScriptTools.psd1‎
242 Bytes
diff --git a/‎PSScriptToolsHelp.md‎
Lines changed: 0 additions & 1612 deletions b/‎PSScriptToolsHelp.md‎
Lines changed: 0 additions & 1612 deletions
diff --git a/‎PSScriptToolsManual.pdf‎
2.78 MB b/‎PSScriptToolsManual.pdf‎
2.78 MB
diff --git a/‎PrepAdoc.ps1‎
Lines changed: 168 additions & 0 deletions b/‎PrepAdoc.ps1‎
Lines changed: 168 additions & 0 deletions
@@ -0,0 +1,17 @@
+# Module Commands
+
+This section contains the same help content you would get from a PowerShell prompt using `Get-Help`. Note that code examples have been formatted to fit the 80 character page width. Don't assume you can run examples exactly as they are shown. Some of the help examples use special or custom characters which might not render properly in the PDF.
+
+Remember, you can also view the online help for each command:
+
+```powershell
+Help Convertto-WPFGrid -online
+```
+
+If you can't remember what commands are in this module, you can always ask PowerShell.
+
+```powershell
+Get-Command -module PSScriptTools
+```
+
+Or use `Get-PSScriptTools`.
@@ -0,0 +1,168 @@
+[cmdletbinding(SupportsShouldProcess)]
+Param(
+  [Parameter(Position = 0)]
+  [ValidateNotNullOrEmpty()]
+  [ValidateScript( {Test-Path $_})]
+  [string]$Path = ".",
+  [Parameter(HelpMessage = "The path to a json file with the processing data for the folder.")]
+  [ValidateNotNullOrEmpty()]
+  [ValidateScript( {Test-Path $_})]
+  [string]$DataPath = ".\adoc-data.json"
+)
+
+$prog = @{
+  Activity         = "Prepare ADOC files"
+  Status           = "Initializing"
+  CurrentOperation = ""
+  PercentComplete  = 0
+}
+
+Write-Progress @prog
+
+$ModulePath = Convert-Path $Path
+Write-Verbose "[$(Get-Date)] Working from $modulePath"
+
+Write-Verbose "[$(Get-Date)] Importing ruby-related functions"
+. C:\scripts\rubydocs.ps1
+
+Write-Verbose "[$(Get-Date)] Importing adoc data from json"
+<#
+{
+  "Name" : "PSScriptToolsManual",
+  "Title": "PSScriptTools Manual",
+  "CodeTheme": "githubcustom",
+  "CodeThemePath": "c:\\scripts\\githubcustom.rb",
+  "Theme": "pdf-theme.yml",
+  "Files": [
+    {
+      "Name": "Intro.md",
+      "Lines": ""
+    },
+    {
+      "Name": "README.md",
+      "Lines": "1;13..15;33..-1"
+    },
+    {
+      "Name": "ModuleCommands.md",
+      "Lines": ""
+    }
+  ]
+}#>
+
+$data = Get-Content $DataPath | ConvertFrom-Json
+
+Write-Verbose "[$(Get-Date)] Get the module version"
+$ver = (Import-PowerShellDataFile $ModulePath\*.psd1).moduleversion
+Write-Verbose "[$(Get-Date)] Found version $ver"
+
+#define a here-string for the main document in Asciidoctor format
+$Main = @"
+= $($data.title) v$Ver
+:allow-uri-read:
+:autofit-option:
+:data-uri:
+:icons: font
+:iconset: fa
+:linkattrs:
+:rouge-style: $($data.codeTheme)
+:source-highlighter: rouge
+
+"@
+
+$files = $data.files
+$prog.status = "Processing main files"
+$i = 0
+foreach ($file in $files) {
+  $i++
+  $prog.CurrentOperation = $file.name
+  $prog.percentComplete = ($i/$files.count)*100
+  Write-Progress @prog
+  $item = Join-Path -Path $Modulepath -ChildPath $file.name
+  Write-Verbose "[$(Get-Date)] Converting $item"
+  Get-Item -path $item |
+  ConvertTo-Adoc -Codetheme $data.codeTheme
+
+  $adoc = $item -replace "md", "adoc"
+  $c = Get-Content $adoc
+
+  Write-Verbose "[$(Get-Date)] Adjustings links and xrefs"
+  [regex]$lx = "xref:(?<link>\S+)\.adoc\[(?<display>((\w+[\s-]\w+))+)\]"
+  $matches = $lx.matches($c)
+  foreach ($item in $matches) {
+    $link = $item.groups.where( {$_.name -eq 'link'}).value
+    $display = $item.groups.where( {$_.name -eq 'display'}).value
+
+    #split off the command name from the link to build the
+    #correct cross-reference in the PDF
+    $cmdName = $link.split("/")[-1]
+    $xlink = "$cmdName-Help"
+    $xref = "<<{0},{1}>>" -f $xlink, $display
+    #use the method because the value has regex characters
+    $c = $c.replace($item.value, $xref)
+  }
+
+  Write-Verbose "[$(Get-Date)] Updating $adoc"
+  $c | Out-File -FilePath $adoc -Encoding utf8
+
+  Write-Verbose "[$(Get-Date)] Adding to Main"
+  #include line subsets if defined
+  if ($file.lines) {
+    $trim = "lines=$($file.lines)"
+  }
+  else {
+    $trim = ""
+  }
+  $main += @"
+
+include::$($adoc)[$trim]
+
+"@
+}
+
+Write-Verbose "[$(Get-Date)] Creating adoc help files. You may need to press Enter to force the process to continue."
+
+#create the adoc files and then edit them.
+$prog.Status = "Converting markdown to adoc files"
+$prog.CurrentOperation =
+$i = 0
+$helpMD = Get-ChildItem $ModulePath\docs\*-*.md
+
+$helpmd | ForEach-Object {
+  $i++
+  $prog.CurrentOperation = $_.FullName
+  $prog.percentComplete = ($i/$helpmd.count)*100
+  Write-Progress @prog
+  ConvertTo-Adoc -Fullname $_.fullname -passthru -theme $data.codeTheme | Edit-Adoc
+}
+
+$prog.status = "Building main document"
+Write-Verbose "[$(Get-Date)] Add include links to the main document"
+$adocs = Get-ChildItem $ModulePath\docs\*.adoc -OutVariable ov | Sort-Object -property Name
+
+$i = 0
+ForEach ($item in $adocs) {
+  $i++
+  $prog.CurrentOperation = $item.name
+  $prog.percentComplete = ($i/$adocs.count)*100
+  Write-Progress @prog
+  Write-Verbose "[$(Get-Date)] Adding $($item.name)"
+  $main += @"
+
+include::docs\$($item.name)[]
+
+"@
+}
+
+$out = Join-Path -path $ModulePath -child "$($data.name).adoc"
+$prog.status = "Finalizing"
+$prog.CurrentOperation = $out
+Write-Progress @prog
+Write-Verbose "[$(Get-Date)] Saving document to $out"
+$main | Out-File -FilePath $out -Encoding utf8
+
+Write-Progress -Activity $prog.Activity -Completed
+Write-Host
+$msg = "Edit and review the adoc files and then run makepdf.ps1"
+Write-Host $msg -ForegroundColor Cyan
+
+Write-Verbose "[$(Get-Date)] Finished."