Diff

mod_http_roster_admin/README.markdown @ 3007:af1b3cef52e1

mod_http_roster_admin: Add syntax highlighting hints
author Kim Alvefur <zash@zash.se>
date Mon, 30 Apr 2018 01:49:59 +0200
parent 3006:e6f91e00b507
line wrap: on
line diff
--- a/mod_http_roster_admin/README.markdown	Sun Apr 29 08:33:54 2018 +0100
+++ b/mod_http_roster_admin/README.markdown	Mon Apr 30 01:49:59 2018 +0200
@@ -21,19 +21,21 @@
 In `.parts/prosody/etc/prosody/prosody.cfg.lua`, where your particular
 `VirtualHost` is being configured, add the following:
 
-    modules_enabled = {
-        "http_roster_admin",
-        "block_subscriptions",
-        "storage_memory",
-        "http_files"
-    }
-    modules_disabled = {
-         -- Prosody will get the roster from the backend app,
-         -- so we disable the default roster module.
-        "roster"
-    }
-    storage = { roster = "memory" }
-    http_roster_url = "http://localhost/contacts/%s" -- %s will be replaced by an URL-encoded username
+``` lua
+modules_enabled = {
+    "http_roster_admin",
+    "block_subscriptions",
+    "storage_memory",
+    "http_files"
+}
+modules_disabled = {
+     -- Prosody will get the roster from the backend app,
+     -- so we disable the default roster module.
+    "roster"
+}
+storage = { roster = "memory" }
+http_roster_url = "http://localhost/contacts/%s" -- %s will be replaced by an URL-encoded username
+```
 
 The `http_roster_url` parameter needs to be configured to point to the
 URL in the backend application which returns users' contacts rosters.
@@ -64,15 +66,17 @@
 If the user 'john' has friends 'marie' and 'michael', the web app would return a HTTP '200 OK' response
 with the following contents:
 
-    {
-        "marie@example.com": {
-            "name": "Marie"
-        },
-    
-        "michael@example.com": {
-            "name": "Michael"
-        }
+``` json
+{
+    "marie@example.com": {
+        "name": "Marie"
+    },
+
+    "michael@example.com": {
+        "name": "Michael"
     }
+}
+```
 
 ### Notifying Prosody of roster changes
 
@@ -95,7 +99,9 @@
 For example, if user ‘john’ became friends with ‘aaron’, both john’s
 contact list and aaron’s contact lists have changed:
 
-    ["john", "aaron"]
+``` json
+["john", "aaron"]
+```
 
 When the operation is complete Prosody will reply with a summary of the
 operation - a JSON object containing:
@@ -107,12 +113,14 @@
 
 Example:
 
-    {
-        "status":  "ok",
-        "message": "roster update complete",
-        "updated": 2,
-        "errors":  0
-    }
+``` json
+{
+    "status":  "ok",
+    "message": "roster update complete",
+    "updated": 2,
+    "errors":  0
+}
+```
 
 Prosody may also return status codes `400` or `500` in case of errors (such
 as a missing/malformed body).