publish.github_gist publisher in github plugin

[traut]

Description

GitHub Gists is a very easy way to publish Markdown / HTML content on the internet.

Use Case

Publish rendered content (Markdown / HTML) as a public or private GitHub Gist.

Requirements

• configuration attributes:
  • github_token -- a required string attribute, that contains a valid GitHub Auth token. It will be used in the HTTP header during API calls: Authorization: Bearer $TOKEN (docs)
• execution attributes:
  • description - (optional) a string attribute, treated as a Go-template string
  • filename - (optional) a string attribute, a key for a file content to be included in the gist. Treated as a Go-template string
    • if not set, the value will be <template-name>.<format-ext>, where <template-name> is the name of the Fabric document template, and <format-ext> is a file extension for a selected content format (md / html)
  • make_public - (optional) a bool attribute, false by default (!)
  • gist_id - (optional) a string attribute. If provided, the existing gist is updated (using gist update endpoint) instead of creating a new gist

Notes:

• the data sink supports only markdown and HTML output formats
• after the context is published, the data sink should output an info log message with a link to the gist created / updated

Additional Information

• https://docs.github.com/en/rest/gists/gists?apiVersion=2022-11-28#create-a-gist
• https://docs.github.com/en/rest/gists/gists?apiVersion=2022-11-28#update-a-gist
• data.github_issues plugin #37