view mod_pubsub_github/README.markdown @ 3404:6444fb5dbb51

mod_xhtmlim: Turn unknown elements into <span> In HTML, you're supposed to replace unknown tags with their content. The :maptags API can't replace tags with text, but replacing with <span> should close enough.
author Kim Alvefur <zash@zash.se>
date Thu, 13 Dec 2018 14:32:17 +0100
parents f48bedd1d433
children b583cce491de
line wrap: on
line source

---
labels: 'Stage-Beta'
summary: Publish Github commits over pubsub
---

## Introduction

This module accepts Github web hooks and publishes them to a local
pubsub component for XMPP clients to subscribe to.

Entries are pushed as Atom payloads.

It may also work with Gitlab.

## Configuration

Load the module on a pubsub component:

    Component "pubsub.example.com" "pubsub"
        modules_enabled = { "pubsub_github" }

The module also takes the following config options:

  Name             Default     Description
  ---------------- ----------- -------------------------------------------
  github\_node     "github"    The pubsub node to publish commits on.
  github\_secret   *not set*   Shared secret used to sign HTTP requests.

The URL for Github to post to would be either:

-   http://pubsub.example.com:5280/pubsub\_github
-   https://pubsub.example.com:5281/pubsub\_github

If your HTTP host doesn't match the pubsub component's address, you will
need to inform Prosody. For more info see Prosody's [HTTP server
documentation](https://prosody.im/doc/http#virtual_hosts).

## Compatibility

  ------ -------------
  0.10   Should work
  0.9    Works
  ------ -------------