Isso – Ich schrei sonst

You love static blog generators (especially Acrylamid cough) and the only option to interact with the community is Disqus. There's nothing wrong with it, but if you care about the privacy of your audience you are better off with a comment system that is under your control. This is, where Isso comes into play.

Try Yourself!

Isso is not stable (pretty far from that state) and the database format may change without any backwards compatibility. Just saying.

Features

• CRUD comments written in Markdown
• SQLite backend, Disqus import
• client-side JS (currently 61kb minified, 21kb gzipped)
• I18N, available in german and english (also fallback)

Roadmap

• Ping/TrackBack™ support
• simple admin interface (needs contributor)
• spam filtering

Installation

• Python 2.6, 2.7 or 3.3
• easy_install or pip

Install Isso (and its dependencies) with:

~> pip install isso

Before you start, you may want to import comments from Disqus.com:

~> isso import ~/Downloads/user-2013-09-02T11_39_22.971478-all.xml
[100%]  53 threads, 192 comments

You start the server via (try to visit http://localhost:8080/static/post.html).

~> isso run

If that is working, you may want to edit the configuration.

Webserver Configuration

This part is not fun, I know. I have prepared two possible setups for nginx, using Isso on the same domain as the blog, and on a different domain. Each setup has its own benefits.

Isso on a Sub URI

Let's assume you want Isso on /isso, use the following nginx snippet:

server {
    listen       [::]:80;
    listen       [::]:443 ssl;
    server_name  example.tld;
    root         /var/www/example.tld;

    location /isso {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Script-Name /isso;
        proxy_pass http://localhost:8080;
    }
}

<script src="http://example.tld/isso/js/embed.min.js"></script>
<div id="isso-thread"></div>

Isso on a Dedicated Domain

Now, assuming you have your isso instance running on a different URL, such as http://example.tld:8080, but your blog runs on http://example.tld:

~> cat example.cfg
[general]
host = http://example.tld/
~> isso -c example.cfg run
2013-10-30 09:32:48,369 WARNING: unable to connect to SMTP server
2013-10-30 09:32:48,408 WARNING: connected to HTTP server
2013-10-30 09:32:48,409 INFO:  * Running on http://localhost:8080/

Make sure, Isso can connect to server that hosts your blog, otherwise you are not able to post comments.

Integrate Isso with:

<script src="http://example.tld:8080/js/embed.min.js"></script>
<div id="isso-thread"></div>

Also, put the plain isso server behind a real web server or use uWSGI.

Website Integration

To enable comments, add a <div id="isso-thread"></div> or <section id="isso-thread" ... below your post.

To add comment count links to your index page, include count.min.js at the very bottom of your document. All links followed by #isso-thread, are updated with the current comment count.

This functionality is already included when you embed embed.min.js, do not mix embed.min.js and count.min.js in a single document.

Other Documents

• Configuration
• API overview
• uWSGI usage

Alternatives

• talkatv – Python
• Juvia – Ruby on Rails
• Tildehash.com – PHP
• SO: Unobtrusive, self-hosted comments