public/New-TriliumNote.ps1
|
function New-TriliumNote { <# .SYNOPSIS Creates a new Trilium note. .DESCRIPTION Creates a new Trilium note under the specified parent note ID (defaults to 'root') with the provided content. You must provide content for the note. Optionally, you can specify a title and note type. If -NoteType is not specified, the note will default to type 'text' and mime 'text/html'. .PARAMETER ParentNoteId The parent note ID to create the new note under. If not specified, the note will be created under the root note. Default is 'root'. Required? false Position? 0 Default value 'root' Accept pipeline input? false Accept wildcard characters? false .PARAMETER Title The title of the new note. Optional. If not specified, the note will be created without a title. Required? false Position? 1 Default value None Accept pipeline input? false Accept wildcard characters? false .PARAMETER Content The content of the new note. This parameter is required. The note will not be created without content. Required? true Position? 2 Default value None Accept pipeline input? false Accept wildcard characters? false .PARAMETER NoteType The type of the new note. Optional. Must be one of: text, book, canvas, mermaid, geoMap, mindMap, relationMap, renderNote, webview, PlainText, CSS, html, http, JSbackend, JSfrontend, json, markdown, powershell, python, ruby, shellBash, sql, sqliteTrilium, xml, yaml If not specified, defaults to 'text' with mime 'text/html'. Required? false Position? Named Default value None Accept pipeline input? false Accept wildcard characters? false .PARAMETER SkipCertCheck Option to skip certificate check. Optional. Use this if you are connecting to a Trilium server with a self-signed certificate. Required? false Position? Named Default value None Accept pipeline input? false Accept wildcard characters? false .EXAMPLE New-TriliumNote -Content "This is a new note." Creates a new note under the root with the specified content and default type 'text' and mime 'text/html'. .EXAMPLE New-TriliumNote -Title "My Note" -Content "This is a new note." -NoteType markdown Creates a new note under the root with the specified title, content, and type 'code' with mime 'text/x-markdown'. .EXAMPLE New-TriliumNote -ParentNoteId "abcdef123456" -Title "Child Note" -Content "Child note content." Creates a new note under the specified parent note with the given title and content, using default type 'text' and mime 'text/html'. .EXAMPLE New-TriliumNote -Content "Geo data" -NoteType geoMap Creates a new note under the root with the specified content and type 'geoMap' with mime 'application/json'. .NOTES This function requires that authentication has been set using Connect-TriliumAuth. The -Content parameter is always required. All other parameters are optional. If -NoteType is not specified, the note will be created as a standard text note (type 'text', mime 'text/html'). If -ParentNoteId is not specified, the note will be created under the root note. If -Title is not specified, the note will be created without a title. .LINK https://github.com/ptmorris1/TriliumNext-Powershell-Module #> [CmdletBinding(SupportsShouldProcess = $true)] param ( # Parent note ID to create the new note under [Parameter()] [string]$ParentNoteId = 'root', # Title of the new note [Parameter()] [string]$Title, # Content of the new note [Parameter(Mandatory = $true)] [string]$Content, # Optional note type [Parameter()] [ValidateSet('text','book','canvas','mermaid','geoMap','mindMap','relationMap','renderNote','webview', 'PlainText','CSS','html','http','JSbackend','JSfrontend','json','markdown','powershell','python','ruby','shellBash','sql','sqliteTrilium','xml','yaml')] [string]$NoteType, [Parameter()] [switch]$SkipCertCheck ) begin { if (!$global:TriliumCreds) { Write-Error -Message 'Need to run: Connect-TriliumAuth'; exit } } process { try { if ($SkipCertCheck -eq $true) { $PSDefaultParameterValues = @{'Invoke-RestMethod:SkipCertificateCheck' = $true } } $TriliumHeaders = @{} $TriliumHeaders.Add('Authorization', "$($TriliumCreds.Authorization)") $uri = "$($TriliumCreds.URL)/create-note" $mimeMap = @( [PSCustomObject]@{ Note = 'PlainText'; Type = 'code'; Mime = 'text/plain' } [PSCustomObject]@{ Note = 'CSS'; Type = 'code'; Mime = 'text/css' } [PSCustomObject]@{ Note = 'html'; Type = 'code'; Mime = 'text/html' } [PSCustomObject]@{ Note = 'http'; Type = 'code'; Mime = 'message/http' } [PSCustomObject]@{ Note = 'JSbackend'; Type = 'code'; Mime = 'application/javascript;env=backend' } [PSCustomObject]@{ Note = 'JSfrontend'; Type = 'code'; Mime = 'application/javascript;env=frontend' } [PSCustomObject]@{ Note = 'json'; Type = 'code'; Mime = 'application/json' } [PSCustomObject]@{ Note = 'markdown'; Type = 'code'; Mime = 'text/x-markdown' } [PSCustomObject]@{ Note = 'powershell'; Type = 'code'; Mime = 'application/x-powershell' } [PSCustomObject]@{ Note = 'python'; Type = 'code'; Mime = 'text/x-python' } [PSCustomObject]@{ Note = 'ruby'; Type = 'code'; Mime = 'text/x-ruby' } [PSCustomObject]@{ Note = 'shellBash'; Type = 'code'; Mime = 'text/x-sh' } [PSCustomObject]@{ Note = 'sql'; Type = 'code'; Mime = 'text/x-sql' } [PSCustomObject]@{ Note = 'sqliteTrilium'; Type = 'code'; Mime = 'text/x-sqlite;schema=trilium' } [PSCustomObject]@{ Note = 'xml'; Type = 'code'; Mime = 'text/xml' } [PSCustomObject]@{ Note = 'yaml'; Type = 'code'; Mime = 'text/x-yaml' } [PSCustomObject]@{ Note = 'text'; Type = 'text'; Mime = 'text/html' } [PSCustomObject]@{ Note = 'book'; Type = 'book'; Mime = $null } [PSCustomObject]@{ Note = 'canvas'; Type = 'canvas'; Mime = 'application/json' } [PSCustomObject]@{ Note = 'mermaid'; Type = 'mermaid'; Mime = 'text/mermaid' } [PSCustomObject]@{ Note = 'geoMap'; Type = 'geoMap'; Mime = 'application/json' } [PSCustomObject]@{ Note = 'mindMap'; Type = 'mindMap'; Mime = 'application/json' } [PSCustomObject]@{ Note = 'relationMap'; Type = 'relationMap'; Mime = 'application/json' } [PSCustomObject]@{ Note = 'renderNote'; Type = 'renderNote'; Mime = $null } [PSCustomObject]@{ Note = 'webview'; Type = 'webview'; Mime = $null } ) $body = @{ parentNoteId = $ParentNoteId } if ($Title) { $body.title = $Title } if ($Content) { $body.content = $Content } if ($NoteType) { $mimeObj = $mimeMap | Where-Object { $_.Note -eq $NoteType } if ($mimeObj) { $body.type = $mimeObj.Type if ($null -ne $mimeObj.Mime) { $body.mime = $mimeObj.Mime } } else { $body.type = $NoteType } } elseif (-not $body.ContainsKey('type')) { $body.type = 'text' $body.mime = 'text/html' } $body = $body | ConvertTo-Json if ($PSCmdlet.ShouldProcess($uri, 'Create new note')) { Invoke-RestMethod -Uri $uri -Headers $TriliumHeaders -SkipHeaderValidation -ContentType 'application/json' -Body $body -Method Post } } catch { $_.Exception.Response } } end { return } } |