Documentation Status Open Source License PyPI Package PyPI Package Downloads

Sphinx extension for embeding Isso comments in documents.


The extension allows your embedding Isso comments in your Sphinx documentation:

Getting Started


We assume you already have a Sphinx documentation, if not, see Getting Started with Sphinx.

First, downloading extension from PyPI:

$ pip install sphinxnotes-isso

Then, add the extension name to extensions configuration item in your conf.py:

extensions = [
          # …
          # …

Set ⚙️isso_url to the URL of your Isso server.

isso_url = 'https://HOST:PORT'

And then you can use directive isso to insert a Isso comment box, see Usage for more details.

.. isso::

Feel free to comment~


The Sphinx Notes Project

The project is developed by Shengyu Zhang, as part of The Sphinx Notes Project.

The Sphinx Notes Project