README.rst: Add server-setup instructions
authorW. Trevor King <wking@tremily.us>
Mon, 22 Sep 2014 13:12:33 +0000 (06:12 -0700)
committerW. Trevor King <wking@tremily.us>
Mon, 22 Sep 2014 14:08:51 +0000 (07:08 -0700)
It's no fun when projects don't tell you how to use them ;).

README.rst

index b1deb22e787a13666145e70d9a6989574a495ec4..ca2d24f20f5e8b1e7c010e8bf0092a91095e6a41 100644 (file)
@@ -1,5 +1,47 @@
-Nmhive is a webserver for nmbug, allowing you to remotely query and
-manage tags.  There is also a bookmarklet that provides a convenient
-interface for managing tags while browsing Gmane_.
+Nmhive is a webserver for nmbug_, allowing you to remotely query and
+manage notmuch_ tags.  There is also a bookmarklet that provides a
+convenient interface for managing tags while browsing Gmane_.
 
+Dependencies
+============
+
+* Flask_
+* Flask-Cors_
+
+The versions shouldn't matter too much, but I'm testing with Flask
+0.10.1 and Flask-Cors 1.9.0.
+
+Server setup
+============
+
+Launch the server with something like::
+
+  $ nmhive.py -H 0.0.0.0 -p 5000
+   * Running on http://0.0.0.0:5000/
+  …
+
+You can kill the server whenever you like (e.g. via ``ctrl+c``)
+without worrying about corrupting your local notmuch or nmbug
+databases.
+
+Then edit ``nmbug_server`` in ``nmbug.js`` to point at that interface.
+Serve ``nmbug.js`` and ``index.html`` somewhere.  I serve them with
+Nginx_, but you use whatever you like, including `Python's`__
+`http.server`_ with something like::
+
+  $ python -m http.server 8000
+
+__ Python_
+
+Point your users to the served ``index.html`` so they can get the
+bookmarklet and read the instructions for using it.
+
+
+.. _nmbug: http://notmuchmail.org/nmbug/
+.. _notmuch: http://notmuchmail.org/
 .. _Gmane: http://gmane.org/
+.. _Flask: http://flask.pocoo.org/
+.. _Flask-Cors: https://pypi.python.org/pypi/Flask-Cors/
+.. _Nginx: http://nginx.org/
+.. _Python: https://www.python.org/
+.. _http.server: https://docs.python.org/3/library/http.server.html