Skip to content

Warning

You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?

Discord Welcome

Actions
Keep channel content in-sync with Markdown based templates
v0.2.0
Star (7)

Tags

 (1)

Discord Welcome Action Node.js CI Action Test

Action to keep channel content in-sync with Markdown based templates

Stability

This action is tested on every push with a Test Workflow to ensure things function as expected. However it has not been extensively battle-tested with many different inputs and configurations so please report any issues you may find.

Once the action matures and is more extensively tested it will be promoted from v0 to v1.

Prerequisites

  • A Discord Bot with Manage Webhooks and Manage Messages permissions in the target server(s)
  • One or more Markdown template documents using the extended syntax (see below)

Usage

Action Inputs

Name Type Required Default Description
discord-token String true n/a Discord Bot Login Token
content String true ./content Path to a directory containing template documents

Markdown Syntax

Template documents can make use of any Markdown syntax that Discord directly supports, as templates are sent almost verbatim to the target channels. You can also use --- (horizontal rules) to break up the document into multiple messages, otherwise messages will be split automatically.

Images will also be embedded correctly, however images must be in a message of their own to be parsed correctly.

Finally, bulleted lists will be transformed to use the Unicode bullet character.

You can see an example of the syntax here.

Frontmatter

All Markdown templates must have YAML frontmatter to denote the channel target and allow you to pass additional per-template configuration.

Name Type Required Default Description
channel String true n/a Snowflake ID of the target channel
senderName String false Server Name Name of the user sending the message(s)
senderImage String false Server Icon Icon for the user sending the message(s)

Example Workflow

name: Update Welcome
on: [push]

jobs:
  execute:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3
      - name: Update Welcome
        uses: lolPants/discord-welcome-action@v0
        with:
          content: ./content
          discord-token: ${{ secrets.DISCORD_TOKEN }}

Discord Welcome is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

Keep channel content in-sync with Markdown based templates
v0.2.0

Tags

 (1)

Discord Welcome is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.