Isso – a commenting server similar to Disqus

Isso – Ich schrei sonst – is a lightweight commenting server written in Python and JavaScript. It aims to be a drop-in replacement for Disqus.

A personal example. my web site has host on the github pages, and I use a server to host my comment system. this comment system was power by the the isso. see website here.

See posativ.org/isso for more details.

How to

• you can look up the the official tutorial here
• here is my details to install the isso from source code.

Install From Source

• install sqlite3(make sure your version is larger than 3.3.8).
• install nodejs and npm, bower.
• install the python isso module in a virtual env.
• compile the source js for your client end.

here is installation passed from the python2.7 version, node 0.10.41, npm 1.3.10.

1. install the sqlite3, python2.7, and virtual env.

sudo apt-get install sqlite3 python2.7 python2-pip
sudo pip install virtualenv virtualenvwrapper

2. install the isso from source

# config the virtual env wrapper envirionment
# add this to your .bashrc

export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python2
export WORKON_HOME=$HOME/.virtualenvs
source /usr/local/bin/virtualenvwrapper.sh

# create the directory
mkdir ~/.virtualenvs

# restart the bash and create the virtual env
mkvirtualenv isso

# now you should in the isso virtual env
# download or clone this repository.
git clone https://github.com/smileboywtu/isso.git

# install python isso module
cd isso
python setup.py install

3. compile the js file

# an easy easy way to install node and npm with apt
sudo apt-get install node npm

# or you can follow the steps of the official nodejs website.
curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
sudo apt-get install -y nodejs

# or install npm manually
curl -L https://www.npmjs.com/install.sh | sudo sh

# create a link on ubuntu
sudo ln -s /usr/bin/nodejs /usr/bin/node

# install bower after you have install node and npm
npm install -g bower

# inside the directory where the makefile exist.
make init

# check dependency
# you need to install all dependency installed under the python2.7
# version. make sure you install the dependency with the required
# version.
make check

# compile js code from source.
# this will compile the embed.min.js for your client side.
# if you can't see the embed.min.js inside the isso/isso/js after
# this command, you may get error of compilation.
# as I look details about the source code of isso, the isso just
# reference the js directory to find out the js file, so do not
# move or delect the source directory.
make js

4. run and test

# inside the isso virtual env
# use workon isso to shift to the isso virtual env you created.
isso run

# open the simple index.html inside the source directory.
# follow the official website for more usage details.
# if you can't comment or get some errors, just use the
# browser's develop tool to detect the error or contact
# other people like me to help you out.

Thanks for reading.

happy coding. leave me a message here. or just send a email(smileboywtu@gmail.com) to me if you need help.