Diff

mod_pubsub_github/README.markdown @ 1803:4d73a1a6ba68

Convert all wiki pages to Markdown
author Kim Alvefur <zash@zash.se>
date Fri, 28 Aug 2015 18:03:58 +0200
child 3258:85e3117b2b60
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_pubsub_github/README.markdown	Fri Aug 28 18:03:58 2015 +0200
@@ -0,0 +1,42 @@
+---
+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.
+
+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.
+
+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.9   Works
+  ----- -------