diff mod_pubsub_github.wiki @ 475:3cd17a2dd5c6

Created wiki page through web user interface.
author MWild1@gmail.com
date Tue, 19 Aug 2014 14:34:36 +0000
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_pubsub_github.wiki	Tue Aug 19 14:34:36 2014 +0000
@@ -0,0 +1,32 @@
+#summary Publish Github commits over pubsub
+#labels Stage-Beta
+
+= 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 [https://prosody.im/doc/http#virtual_hosts HTTP server documentation].
+
+= Compatibility =
+|| 0.9 || Works ||
\ No newline at end of file