From 216202268e4470d268bbcdd55babfba3bce75cec Mon Sep 17 00:00:00 2001
From: StartAutomating <james.brundage@start-automating.com>
Date: Sun, 19 Apr 2026 14:29:00 -0700
Subject: [PATCH 1/3] feat: `Get-JSONLD` improvement ( Fixes #12, Fixes #27 )

Aliasing to uri, handling direct JSON-LD links
---
 Commands/Get-JsonLD.ps1 | 175 +++++++++++++++++++++++++---------------
 1 file changed, 110 insertions(+), 65 deletions(-)

diff --git a/Commands/Get-JsonLD.ps1 b/Commands/Get-JsonLD.ps1
index a7a5b71..23b34c5 100644
--- a/Commands/Get-JsonLD.ps1
+++ b/Commands/Get-JsonLD.ps1
@@ -21,7 +21,7 @@ function Get-JsonLD {
     param(
     # The URL that may contain JSON-LD data
     [Parameter(Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName)]
-    [Alias('href')]
+    [Alias('href','uri')]
     [Uri]
     $Url,
 
@@ -42,10 +42,8 @@ function Get-JsonLD {
     [string]
     $as = 'jsonld',
 
-    [switch]
-    $RawHtml,
-
     # If set, will force the request to be made even if the URL has already been cached.
+    [Alias('IgnoreCache')]
     [switch]
     $Force
     )
@@ -71,53 +69,140 @@ application/ld\+json                          # The type that indicates linked d
             $script:Cache = [Ordered]@{}
         }
 
+        # Construct a filter to match and output 
+        filter matchAndOutput {
+            
+            $contentToMatch = $_
+            if ($contentToMatch -match '^\s{0,}\{') {
+                $contentToMatch = "<script type='application/ld+json'>$($contentToMatch)</script>"                
+            }
+            
+            if ($as -eq 'html') {            
+                return $contentToMatch
+            }            
+            
+            # Find all linked data tags within the response
+            foreach ($match in $linkedDataRegex.Matches("$($contentToMatch)")) {
+                # If we want the result as xml
+                if ($As -eq 'xml') {
+                    # try to cast it
+                    $matchXml ="$match" -as [xml]
+                    if ($matchXml) {
+                        # and output it if found.
+                        $matchXml
+                        continue
+                    } else {
+                        # otherwise, fall back to the `<script>` tag
+                        $As = 'script'
+                    }
+                }
+
+                # If we want the tag, that should be the whole match
+                if ($As -eq 'script') {
+                    "$match"
+                    continue
+                }
+                
+                # If we want it as json, we have a match group.
+                if ($As -eq 'json') {
+                    $match.Groups['JsonContent'].Value
+                    continue
+                }
+                # Otherwise, we want it as linked data, so convert from the json
+                foreach ($jsonObject in 
+                    $match.Groups['JsonContent'].Value | 
+                        ConvertFrom-Json
+                ) {
+                    # If there was a `@type` or `@graph` property
+                    if (
+                        $jsonObject.'@type' -or 
+                        $jsonObject.'@graph'
+                    ) {
+                        # output the object as jsonld
+                        $jsonObject | output
+                        continue                    
+                    }                
+                    # If there is neither a `@type` or a `@graph`
+                    else {
+                        # just output the object.
+                        $jsonObject
+                    }                
+                }
+            }
+
+        }
+
+        # Construct a filter to output out content
+        
         filter output {
+            # We want JSON-LD types to become .pstypenames, and this should happen recursively.
             $in = $_
+            # we can use `MyInvocation.MyCommand` to anonymously recurse
+            # (this makes it easier if the name of this command changes)
             $mySelf = $MyInvocation.MyCommand
+
+            # Context could be a string or an object
+            # When it is a string, it is a root type.
             if ($in.'@context' -is [string]) {
-                $context  = $in.'@context'
+                $context  = $in.'@context' # so set the context
+                # ( this variable will leek down into lower scopes )
+                # ( so we can reuse common contexts (like `schema.org` ))
             }
+            
+            # If we have a graph of outputs
             if ($in.'@graph') {
+                # decorate the entire graph as `application/ld+json`
                 if ($in.pstypenames -ne 'application/ld+json') {
                     $in.pstypenames.insert(0,'application/ld+json')
                 }
+                # and then call ourself
                 foreach ($graphObject in $in.'@graph') {
+                    # (null the return so we only output the topmost object)
                     $null = $graphObject |
                         & $mySelf
                 }
             }
+            # If we have a single type of object
             elseif ($in.'@type') {
-
+                # combine it with the context to get our typename
                 $typeName = if ($context) {
                     $context, $in.'@type' -join '/'
                 } else {
                     $in.'@type'
                 }
 
+                # Decorate the type as `application/ld+json`
                 if ($in.pstypenames -ne 'application/ld+json') {
                     $in.pstypenames.insert(0,'application/ld+json')
                 }
+                # and decocate the item as the `$typeName`
                 if ($in.pstypenames -ne $typeName) {
                     $in.pstypenames.insert(0,$typeName)
                 }
 
+                # Then go over each property
                 foreach ($property in $in.psobject.properties) {
+                    # if the property had a `@type`
                     if ($property.value.'@type') {
+                        # call ourself on the value
+                        # (null the return so we only output the topmost object)
                         $null = $property.value |
                             & $mySelf
-                    }                    
-                }                                
+                    }
+                }
             }
+
+            # Now that we've finished decorating out graph or type
+            # output our modified input.
             $in
         }
 
+        # Files will be treated as .json
         $foreachFile = {
             $inFile = $_.FullName
-            try {
-                
+            try {                
                 Get-Content -LiteralPath $_.FullName -Raw | 
-                    ConvertFrom-Json |
-                        output
+                    matchAndOutput
             } catch {
                 Write-Verbose "$($inFile.FullName) : $_"
             }
@@ -151,63 +236,23 @@ application/ld\+json                          # The type that indicates linked d
             
         $restResponse = 
             if ($Force -or -not $script:Cache[$url]) {
-                $script:Cache[$url] = Invoke-RestMethod -Uri $Url
+                $script:Cache[$url] = Invoke-WebRequest -Uri $Url
                 $script:Cache[$url]
             } else {
                 $script:Cache[$url]
             }
-
-        if ($as -eq 'html') {
-            return $restResponse
-        }                
         
-        # Find all linked data tags within the response
-        foreach ($match in $linkedDataRegex.Matches("$restResponse")) {
-            # If we want the result as xml
-            if ($As -eq 'xml') {
-                # try to cast it
-                $matchXml ="$match" -as [xml]
-                if ($matchXml) {
-                    # and output it if found.
-                    $matchXml
-                    continue
-                } else {
-                    # otherwise, fall back to the `<script>` tag
-                    $As = 'script'
-                }
-            }
-
-            # If we want the tag, that should be the whole match
-            if ($As -eq 'script') {
-                "$match"
-                continue
-            }
-            
-            # If we want it as json, we have a match group.
-            if ($As -eq 'json') {
-                $match.Groups['JsonContent'].Value
-                continue
-            }
-            # Otherwise, we want it as linked data, so convert from the json
-            foreach ($jsonObject in 
-                $match.Groups['JsonContent'].Value | 
-                    ConvertFrom-Json
-            ) {
-                # If there was a `@type` or `@graph` property
-                if (
-                    $jsonObject.'@type' -or 
-                    $jsonObject.'@graph'
-                ) {
-                    # output the object as jsonld
-                    $jsonObject | output
-                    continue                    
-                }                
-                # If there is neither a `@type` or a `@graph`
-                else {
-                    # just output the object.
-                    $jsonObject
-                }                
-            }
-        }        
+        
+        if ($restResponse.Headers['Content-Type'] -match 'json') {
+            if ($restResponse.Content -is [byte[]]) {                    
+                [Text.Encoding]::UTF8.GetString($restResponse.Content) | matchAndOutput
+            } else {
+                $restResponse.Content | matchAndOutput
+            }                
+        } elseif ($restResponse.Content -is [string]) {
+            $restResponse.Content | matchAndOutput
+        } else {
+            ""
+        }                
     }
 }

From 065c1e490aaed2aaf8c16b25b481e3280ffc9a4c Mon Sep 17 00:00:00 2001
From: StartAutomating <james.brundage@start-automating.com>
Date: Sun, 19 Apr 2026 14:42:09 -0700
Subject: [PATCH 2/3] feat: `README.md.ps1` ( Fixes #28 )

---
 JSON-LD.psd1  |  31 +++----
 README.md     |  63 +++++++++++---
 README.md.ps1 | 229 ++++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 298 insertions(+), 25 deletions(-)
 create mode 100644 README.md.ps1

diff --git a/JSON-LD.psd1 b/JSON-LD.psd1
index c55b799..44d155b 100644
--- a/JSON-LD.psd1
+++ b/JSON-LD.psd1
@@ -1,6 +1,6 @@
 @{
     RootModule = 'JSON-LD.psm1'
-    ModuleVersion = '0.1.1'
+    ModuleVersion = '0.1.2'
     GUID = '4e65477c-012c-4077-87c7-3e07964636ce'
     Author = 'James Brundage'
     CompanyName = 'Start-Automating'
@@ -16,22 +16,24 @@
             # A URL to the license for this module.
             ProjectURI = 'https://github.com/PoshWeb/JSON-LD'
             LicenseURI = 'https://github.com/PoshWeb/JSON-LD/blob/main/LICENSE'
+            PSIntro = @'
+Get JSON Linked Data with PowerShell
+
+Gets information stored in a page's [json-ld](https://json-ld.org/) (json linked data)
+
+Many pages expose this information for search engine optimization.
+
+This module lets you easily get and work with JSON-LD objects.
+'@
             ReleaseNotes = @'
 ---
 
-## JSON-LD 0.1.1
+## JSON-LD 0.1.2
+
+* Aliasing Url to Uri (#12)
+* Supporting direct JSON-LD content links (#27)
 
-* Updating Examples (#13)
-* Simplfiying module scaffolding (#15)
-* Building types with EZOut (#5)
-* Supporting file input (#23)
-* `Get-JSONLD -as`
-  * `Get-JSONLD -as json` (#16)
-  * `Get-JSONLD -as html` (#17)
-  * `Get-JSONLD -as script` (#18)
-  * `Get-JSONLD -as xml` (#19)
-* Adding conversion to JsonSchema (#21)
-* Adding conversion to At Protocol Lexicons (#22)
+Thanks @AniTexs for the suggestion!
 
 ---
 
@@ -45,5 +47,4 @@ Additional History in [CHANGELOG](https://github.com/PoshWeb/JSON-LD/blob/main/C
         }
     }
     
-}
-
+}
\ No newline at end of file
diff --git a/README.md b/README.md
index 02d222d..f71a65c 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,69 @@
 # JSON-LD
-
+[![JSON-LD](https://img.shields.io/powershellgallery/dt/JSON-LD)](https://www.powershellgallery.com/packages/JSON-LD/)
+## Get JSON Linked Data with PowerShell
 Get JSON Linked Data with PowerShell
 
 Gets information stored in a page's [json-ld](https://json-ld.org/) (json linked data)
 
-Many pages expose this information for search engine optimization.  
+Many pages expose this information for search engine optimization.
 
-## JSON-LD in PowerShell
+This module lets you easily get and work with JSON-LD objects.
 
-JSON-LD is one of a number of ways you can get more information about a page.
+## Installing and Importing
 
-This information can be useful in any number of fun and useful PowerShell scenarios
+You can install JSON-LD from the [PowerShell gallery](https://powershellgallery.com/)
 
-For example, let's get information about a movie.
+~~~PowerShell
+Install-Module JSON-LD -Scope CurrentUser -Force
+~~~
+
+Once installed, you can import the module with:
 
 ~~~PowerShell
-Get-JsonLD -Url https://letterboxd.com/film/amelie/
+Import-Module JSON-LD -PassThru
+~~~
+
+
+You can also clone the repo and import the module locally:
+
+~~~PowerShell
+git clone https://github.com/PoshWeb/JSON-LD
+cd ./JSON-LD
+Import-Module ./ -PassThru
 ~~~
 
-Let's take things a step further, and get the information we can know about any movie:
+## Functions
+JSON-LD has 1 function
+### Get-JsonLD
+#### Gets JSON-LD data from a given URL.
+Gets JSON Linked Data from a given URL.
 
+This is a format used by many websites to provide structured data about their content.
+##### Examples
+###### Example 1
+Want to get information about a movie?  Linked Data to the rescue!
 ~~~PowerShell
-JsonLD https://schema.org/Movie
+Get-JsonLD -Url https://letterboxd.com/film/amelie/
 ~~~
- 
\ No newline at end of file
+###### Example 2
+Want information about an article?  Lots of news sites use this format.
+~~~PowerShell
+Get-JsonLD https://www.thebulwark.com/p/mahmoud-khalil-immigration-detention-first-amendment-free-speech-rights
+~~~
+###### Example 3
+Want to get information about a schema?
+~~~PowerShell
+jsonld https://schema.org/Movie
+# Get-JSONLD will output the contents of a `@Graph` object if no `@type` is found.
+~~~
+##### Parameters
+
+|Name|Type|Description|
+|-|-|-|
+|Url|Uri|The URL that may contain JSON-LD data|
+|as|String|If set, will the output as:<br/><br/>|as|is|<br/>|-|-|<br/>|html|the response as text|<br/>|json|the match as json|<br/>|*jsonld`|ld`|linkedData*|the match as linked data|'<br/>|script|the script tag|<br/>|xml|the script tag, as xml||
+|Force|SwitchParameter|If set, will force the request to be made even if the URL has already been cached.|
+
+> (c) 2025-2026 Start-Automating.
+
+> [LICENSE](https://github.com/PoshWeb/JSON-LD/blob/main/LICENSE)
diff --git a/README.md.ps1 b/README.md.ps1
new file mode 100644
index 0000000..2a709bd
--- /dev/null
+++ b/README.md.ps1
@@ -0,0 +1,229 @@
+<#
+.SYNOPSIS
+    README.md.ps1
+.DESCRIPTION
+    README.md.ps1 makes README.md
+
+    This is a simple and helpful scripting convention for writing READMEs.
+
+    `./README.md.ps1 > ./README.md`
+
+    Feel free to copy and paste this code.
+    
+    Please document your parameters, and add NOTES.
+.NOTES        
+    This README.md.ps1 is used to generate help for a module.
+
+    It:
+
+    * Outputs the name and description
+    * Provides installation instructions
+    * Lists commands
+    * Lists parameters
+    * Lists examples    
+.EXAMPLE
+    ./README.md.ps1 > ./README.md
+.EXAMPLE
+    Get-Help ./README.md.ps1
+#>
+param(
+# The name of the module     
+[string]$ModuleName = $($PSScriptRoot | Split-Path -Leaf),
+
+# The domains that serve git repositories.
+# If the project uri links to this domain, 
+# installation instructions will show how to import the module locally.
+[string[]]
+$GitDomains = @(
+    'github.com', 'tangled.org', 'tangled.sh', 'codeberg.org'
+),
+
+# If set, we don't need no badges.
+[switch]
+$NoBadge,
+
+# If set, will not display gallery instructions or badges
+[switch]
+$NotOnGallery
+)
+
+Push-Location $PSScriptRoot
+
+# Import the module
+$module = Import-Module "./$ModuleName.psd1" -PassThru
+
+# And output a header
+"# $module"
+
+if (-not $NoBadge) {
+    # If it is on the gallery, show the downloads badge.
+    if (-not $NotOnGallery) {        
+        @(
+            "[!"
+                "[$ModuleName](https://img.shields.io/powershellgallery/dt/$ModuleName)"             
+            "](https://www.powershellgallery.com/packages/$ModuleName/)"
+        ) -join ''
+    }    
+}
+
+# Show the module description
+"## $($module.Description)"
+
+# Show any intro section defined in the manifest
+$module.PrivateData.PSData.PSIntro
+
+#region Boilerplate installation instructions
+if (-not $NotOnGallery) {
+@"
+
+## Installing and Importing
+
+You can install $ModuleName from the [PowerShell gallery](https://powershellgallery.com/)
+
+~~~PowerShell
+Install-Module $($ModuleName) -Scope CurrentUser -Force
+~~~
+
+Once installed, you can import the module with:
+
+~~~PowerShell
+Import-Module $ModuleName -PassThru
+~~~
+
+"@
+}
+#endregion Gallery installation instructions
+
+#region Git installation instructions
+$projectUri = $module.PrivateData.PSData.ProjectURI -as [uri]
+
+if ($projectUri.DnsSafeHost -in $GitDomains) {
+@"
+
+You can also clone the repo and import the module locally:
+
+~~~PowerShell
+git clone $projectUri
+cd ./$ModuleName
+Import-Module ./ -PassThru
+~~~
+
+"@
+}
+#endregion Git installation instructions
+
+#region Exported Functions
+$exportedFunctions = $module.ExportedFunctions
+if ($exportedFunctions) {
+
+    "## Functions"
+
+    "$($ModuleName) has $($exportedFunctions.Count) function$(
+        if ($exportedFunctions.Count -gt 1) { "s"}
+    )"
+
+    foreach ($export in $exportedFunctions.Keys | Sort-Object) {                
+        # Get help if it there is help to get
+        $help = Get-Help $export
+        # If the help is a string, 
+        if ($help -is [string]) {
+            # make it preformatted text
+            "~~~"
+            "$export"
+            "~~~"
+        } else {
+            # Otherwise, add list the export
+            "### $($export)"
+
+            # And make it's synopsis a header
+            "#### $($help.SYNOPSIS)"
+
+            # put the description below that
+            "$($help.Description.text -join [Environment]::NewLine)"
+            
+            if ($help.examples.example) {
+                # Show our examples
+                "##### Examples"
+            }
+            
+
+            $exampleNumber = 0
+            foreach ($example in $help.examples.example) {
+                $markdownLines = @()
+                $exampleNumber++
+                $nonCommentLine = $false
+                "###### Example $exampleNumber"
+                
+                # Combine the code and remarks
+                $exampleLines = 
+                    @(
+                        $example.Code
+                        foreach ($remark in $example.Remarks.text) {
+                            if (-not $remark) { continue }
+                            $remark
+                        }
+                    ) -join ([Environment]::NewLine) -split '(?>\r\n|\n)' # and split into lines
+
+                # Go thru each line in the example as part of a loop
+                $codeBlock = @(foreach ($exampleLine in $exampleLines) {
+                    # Any comments until the first uncommentedLine are markdown
+                    if ($exampleLine -match '^\#' -and -not $nonCommentLine) {
+                        $markdownLines += $exampleLine -replace '^\#\s{0,1}'
+                    } else {
+                        $nonCommentLine = $true
+                        $exampleLine
+                    }
+                }) -join [Environment]::NewLine
+
+                $markdownLines
+                "~~~PowerShell"
+                $CodeBlock
+                "~~~"
+            }
+
+            $relatedUris = foreach ($link in $help.relatedLinks.navigationLink) {
+                if ($link.uri) {
+                    $link.uri
+                }
+            }
+            if ($relatedUris) {
+                "#### Links"
+                foreach ($related in $relatedUris) {
+                    "* [$related]($related)"
+                }
+            }
+
+            # Make a table of parameters
+            if ($help.parameters.parameter) {
+                "##### Parameters"
+
+                ""                
+
+                "|Name|Type|Description|"
+                "|-|-|-|"
+                foreach ($parameter in $help.Parameters.Parameter) {
+                    "|$($parameter.Name)|$($parameter.type.name)|$(
+                        $parameter.description.text -replace '(?>\r\n|\n)', '<br/>'
+                    )|"
+                }
+
+                ""
+            }
+            
+        }
+    }
+}
+#endregion Exported Functions
+
+#region Copyright Notice
+if ($module.Copyright) {
+    "> $($module.Copyright)"        
+}
+
+if ($module.PrivateData.PSData.LicenseUri) {
+    ""
+    "> [LICENSE]($($module.PrivateData.PSData.LicenseUri))"
+}
+#endregion Copyright Notice
+
+Pop-Location
\ No newline at end of file

From efc2b30ae894132b77ab01d03ab7f6ec21517b47 Mon Sep 17 00:00:00 2001
From: StartAutomating <james.brundage@start-automating.com>
Date: Sun, 19 Apr 2026 14:43:45 -0700
Subject: [PATCH 3/3] release: JSON-LD 0.1.2

Updating Release Notes and CHANGELOG
---
 CHANGELOG.md | 8 ++++++++
 JSON-LD.psd1 | 5 ++---
 2 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 049b0d5..0d1906f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,14 @@ Please:
 
 ---
 
+## JSON-LD 0.1.2
+
+* Aliasing Url to Uri (#12)
+* Supporting direct JSON-LD content links (#27) (Thanks @AniTexs!)
+* Generating README.md (#28)
+
+---
+
 ## JSON-LD 0.1.1
 
 * Updating Examples (#13)
diff --git a/JSON-LD.psd1 b/JSON-LD.psd1
index 44d155b..808e229 100644
--- a/JSON-LD.psd1
+++ b/JSON-LD.psd1
@@ -31,9 +31,8 @@ This module lets you easily get and work with JSON-LD objects.
 ## JSON-LD 0.1.2
 
 * Aliasing Url to Uri (#12)
-* Supporting direct JSON-LD content links (#27)
-
-Thanks @AniTexs for the suggestion!
+* Supporting direct JSON-LD content links (#27) (Thanks @AniTexs!)
+* Generating README.md (#28)
 
 ---