Get-MarkdownMetadata

Riferimento

Modulo:: platyPS

Ottiene i metadati dall'intestazione di un file markdown.

Sintassi

Get-MarkdownMetadata
   -Path <String[]>
   [<CommonParameters>]

Get-MarkdownMetadata
   -Markdown <String>
   [<CommonParameters>]

Descrizione

Il cmdlet Get-MarkdownMetadata ottiene i metadati dall'intestazione di un file markdown supportato da PlatyPS. Il comando restituisce i metadati come tabella hash.

PlatyPS archivia i metadati nel blocco di intestazione di un file markdown come coppie chiave-valore di stringhe. Per impostazione predefinita, PlatyPS archivia il nome file della Guida e la versione dello schema markdown.

La sezione Metadati può contenere valori forniti dall'utente da usare con strumenti esterni. Il cmdlet New-ExternalHelp ignora questi metadati.

Esempio

Esempio 1: Ottenere metadati da un file

PS C:\> Get-MarkdownMetadata -Path ".\docs\Get-MarkdownMetadata.md"

Key                Value
---                -----
external help file platyPS-help.xml
schema             2.0.0

Questo comando recupera i metadati da un file markdown.

Esempio 2: Ottenere metadati da una stringa markdown

PS C:\> $Markdown = Get-Content -Path ".\docs\Get-MarkdownMetadata.md" -Raw
PS C:\> Get-MarkdownMetadata -Markdown $Markdown

Key                Value
---                -----
external help file platyPS-help.xml
schema             2.0.0

Il primo comando ottiene il contenuto di un file e li archivia nella variabile $Markdown.

Il secondo comando recupera i metadati dalla stringa in $Metadata.

Esempio 3: Ottenere metadati da tutti i file in una cartella

PS C:\> Get-MarkdownMetadata -Path ".\docs"

Key                Value
---                -----
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0

Questo comando ottiene i metadati da ognuno dei file markdown nella cartella .\docs.

Parametri

-Markdown

Specifica una stringa contenente testo formattato markdown.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Path

Specifica una matrice di percorsi di file o cartelle markdown.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	True

Input

String[]

È possibile inviare tramite pipe una matrice di percorsi a questo cmdlet.

Output

Dictionary[String, String]

Il cmdlet restituisce un oggetto Dictionary[String, String]. Il dizionario contiene coppie chiave-valore trovate nel blocco di metadati markdown.

Condividi tramite