vault backup: 2025-07-03 17:48:00

new-additions/powershell-document-conversion-module.md

@@ -0,0 +1,54 @@
+# PowerShell Document Conversion
+
+PowerShell module to allow fluent conversion of "document" files,
+including markup source (.md, .adoc, .rst, etc.)
+and binary formats (.pdf, .docx, etc.),
+as well as allow ~~common high-level actions on them.~~
+
+> [!note]
+> Cmdlets should be written to accept multiple input files where appropriate.
+
+## `Convert-Document`
+
+* pandoc
+* calibre `ebook-convert` (if necessary)
+* muPDF
+* AsciiDoctor
+
+## `Measure-Document`
+
+Measure total words, occurances of unique words, etc.
+Where applicable, the same by page, as well as total pages.
+
+## `Format-Document`
+
+Run format specific linter on document.
+
+## `Get-DocumentMetadata`/`Set-DocumentMetadata`
+
+> Reconcile document metadata formats
+
+## `Import-Document`
+
+Return PSCustomObject with appropriate properties. 
+
+***
+
+## `Import-XML`
+
+Missing from base pwsh but should be straightforward to implement.
+
+```pwsh
+function Import-XML {
+    param(
+        [string]$Path
+    )
+    $xmlText = Get-Content $Path
+    $document = [xml]$xmlText
+    return $document
+}
+```
+
+`*.SupplierLink.xml`
+
+## `Unblock-Excel`