Skip to main content

​
ankra canvas

Publish an HTML, SVG or Markdown file as a static page on the Ankra pages host, list the pages your organisation has published, and unpublish them.
Anyone holding the URL can open the page, so publish nothing you would not hand to that audience. Pages are static snapshots, expire after a retention period (--ttl-hours) and can be unpublished at any time.

​
ankra canvas list

List the canvas pages your organisation has published
Flags

​
ankra canvas publish

Publish an HTML, SVG or Markdown file and print its public URL. The language is inferred from the file extension (.html and .htm, .svg, .md) and can be set with --language. Other languages are refused, as is a file over 200000 characters. Publishing the same file again updates the same page and keeps its URL: when --conversation-id and --artifact-id are not given, both are derived from a hash of the file’s absolute path, so the page is identified by where the file lives. Moving or renaming the file publishes a new page. Pass both ids to take control of the identity yourself, for example to update a page published from the portal canvas. The URL is printed last, on its own line, so scripts can take the final line of output; with -o json the publication is printed as a JSON document instead.
Examples
Flags

​
ankra canvas unpublish

Unpublish a page by its id (shown by ‘ankra canvas list’). Its URL stops serving the page immediately.
Flags