summaryrefslogtreecommitdiffstats
path: root/src/journal/2-comments.rst
diff options
context:
space:
mode:
Diffstat (limited to 'src/journal/2-comments.rst')
-rw-r--r--src/journal/2-comments.rst50
1 files changed, 42 insertions, 8 deletions
diff --git a/src/journal/2-comments.rst b/src/journal/2-comments.rst
index 7dffe53..e983249 100644
--- a/src/journal/2-comments.rst
+++ b/src/journal/2-comments.rst
@@ -4,17 +4,48 @@
author: Johannes Löthberg
author_link: /~kyrias/about.html
-Finally set it up so that each journal entry gets a separate page generated for itself too in addition to being on the `journal index`_. Each entry gets a file in the ``/~kyrias/journal/`` subdirectory named after the entry source file but with the extension changed to ``.html`` instead of ``.rst``.
+Finally set it up so that each journal entry gets a separate page generated for
+itself too in addition to being on the `journal index`_. Each entry gets a file
+in the ``/~kyrias/journal/`` subdirectory named after the entry source file but
+with the extension changed to ``.html`` instead of ``.rst``.
-My first thought for which commenting system to use was disqus, but I don't really like using it at all in practice so I quickly decided against it. I do quite like discourse_ though and thought about setting it up, but that would require me setting up PostgreSQL and Redis, neither of which I feel like setting up nor that I would have any other use for, and both would use up quite a bit of resources for basically nothing, so discourse was out.
+My first thought for which commenting system to use was disqus, but I don't
+really like using it at all in practice so I quickly decided against it. I do
+quite like discourse_ though and thought about setting it up, but that would
+require me setting up PostgreSQL and Redis, neither of which I feel like
+setting up nor that I would have any other use for, and both would use up quite
+a bit of resources for basically nothing, so discourse was out.
-After looking around for a bit and finding a few disqus clones I finally found isso_, which is named after either a German abbreviation or after the 360th_ Pokémon’s name in German. While it’s probably the first alternative, the second sounds more fun so I’ll just go with that.
+After looking around for a bit and finding a few disqus clones I finally found
+isso_, which is named after either a German abbreviation or after the 360th_
+Pokémon’s name in German. While it’s probably the first alternative, the second
+sounds more fun so I’ll just go with that.
-Isso is a rather simple commenting server written in python, uses Markdown for stylinx (hopefully I can get it to do reStructuredText too maybe), and using SQLite for storage which is a plus since it means I don't have to set up some big bulky SQL server. All you need to do to try it out is on the `quickstart page`_, but it roughly comes down to first installing isso (it’s installable through ``pip``), then writing a really short config file that tells isso where to store the SQLite database for comments and which hosts isso will be used on for CORS_. After that you just start isso up pointing it at the config file and it’s up and running. The client-side of isso is just ``script`` and ``section`` tag away, and then you’re done setting it up.
+Isso is a rather simple commenting server written in python, uses Markdown for
+stylinx (hopefully I can get it to do reStructuredText too maybe), and using
+SQLite for storage which is a plus since it means I don't have to set up some
+big bulky SQL server. All you need to do to try it out is on the `quickstart
+page`_, but it roughly comes down to first installing isso (it’s installable
+through ``pip``), then writing a really short config file that tells isso where
+to store the SQLite database for comments and which hosts isso will be used on
+for CORS_. After that you just start isso up pointing it at the config file and
+it’s up and running. The client-side of isso is just ``script`` and ``section``
+tag away, and then you’re done setting it up.
-Isso has support for simple moderation where new comments end up in a queue and has to be manually activated by going through a URL that can be emailed to you if you want, and things like rate limiting new comments. All of it is documented on the `server configuration`_ and `client configuration`_ pages, and there's also some info on the isso API and things like a comment counter. I could continue rambling about what it supports, but that would be rather pointless since it’s written so nicely on their website.
+Isso has support for simple moderation where new comments end up in a queue and
+has to be manually activated by going through a URL that can be emailed to you
+if you want, and things like rate limiting new comments. All of it is
+documented on the `server configuration`_ and `client configuration`_ pages,
+and there's also some info on the isso API and things like a comment counter. I
+could continue rambling about what it supports, but that would be rather
+pointless since it’s written so nicely on their website.
-Where I had some issues was getting it run properly under uWSGI_ and using NGINX_ as a reverse proxy, but it turned out after an hour of testing that I had installed uWSGI but not the python plugin. D’oh. Once I had that installed and added ``plugins = python`` to the uWSGI config file and adjusted my NGINX config file slightly since I run isso under a sub URI instead of on a separate domain it worked perfectly though.
+Where I had some issues was getting it run properly under uWSGI_ and using
+NGINX_ as a reverse proxy, but it turned out after an hour of testing that I
+had installed uWSGI but not the python plugin. D’oh. Once I had that installed
+and added ``plugins = python`` to the uWSGI config file and adjusted my NGINX
+config file slightly since I run isso under a sub URI instead of on a separate
+domain it worked perfectly though.
Here’s the config files I’m currently using:
@@ -22,9 +53,12 @@ Here’s the config files I’m currently using:
<script src="https://gist.github.com/kyrias/f7ec681e1c8c2effdb7e.js"></script>
-As far as I know the ``uwsgi_param HTTP_X_SCRIPT_NAME /isso;`` line is only needed if you’re running isso under a sub URI and I think it isn’t needed if you aren’t, but don’t quite me on that.
+As far as I know the ``uwsgi_param HTTP_X_SCRIPT_NAME /isso;`` line is only
+needed if you’re running isso under a sub URI and I think it isn’t needed if
+you aren’t, but don’t quite me on that.
-I have yet to set up the moderation part of isso though, and that’s probably what I’m going to play with next.
+I have yet to set up the moderation part of isso though, and that’s probably
+what I’m going to play with next.
geros ilas.