### Run Isso Server

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/guides/quickstart.md

This command starts the Isso comment server using a specified configuration file. It's recommended to run Isso on a non-public interface and configure a reverse proxy like Nginx.

```bash
(.venv) $ isso -c /path/to/isso.cfg run
2013-11-25 15:31:34,773 INFO: connected to HTTP server
```

--------------------------------

### Install uWSGI for Isso

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

Installs the uWSGI server and its development dependencies using apt-get and pip. This is required for deploying Isso with uWSGI.

```sh
apt-get install build-essential python-dev
pip install uwsgi
```

--------------------------------

### Configure and Run Isso with uWSGI

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

Sets up and starts the Isso comment system using a uWSGI INI configuration file. This includes creating a spooling directory and launching uWSGI.

```ini
[uwsgi]
http = :8080
master = true
; set to `nproc`
processes = 4
cache2 = name=hash,items=1024,blocksize=32
; you may change this
spooler = /tmp/isso/mail
module = isso.run
; uncomment if you use a virtual environment
; virtualenv = /path/to/isso
env = ISSO_SETTINGS=/path/to/isso.cfg
```

```sh
mkdir /tmp/isso/mail
uwsgi /path/to/uwsgi.ini
```

--------------------------------

### Install gunicorn for Isso

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

Installs the gunicorn WSGI HTTP server using pip. This is necessary for deploying Isso with gunicorn.

```sh
pip install gunicorn
```

--------------------------------

### Basic Isso Configuration Example

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/server-config.md

A minimal INI-style configuration file for Isso, specifying the database path and server host. This serves as a starting point for customizing Isso's behavior.

```ini
[general]
dbpath = /var/lib/isso/comments.db
host = https://example.tld/
[server]
listen = http://localhost:1234/
```

--------------------------------

### Install flup for FastCGI

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

Command to install the `flup` library using pip, which is required for running Isso as a FastCGI script.

```sh
$ pip install flup
```

--------------------------------

### Install Sphinx and Build Docs (Console)

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/contributing/documentation.md

Commands to set up a virtual environment, install Sphinx, and build the documentation site. Requires Python and pip. Ensures the correct Sphinx version is used.

```console
$ virtualenv --download .venv && $ source .venv/bin/activate
(.venv) $ pip install sphinx
(.venv) $ sphinx-build --version
~> sphinx-build 4.5.0
```

```console
(.venv) $ make site
```

--------------------------------

### Install Isso from Source

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/installation.md

This sequence of commands clones the Isso repository, sets up a Python virtual environment, installs JavaScript dependencies, builds the frontend, and then installs Isso in an editable mode for development. It's a prerequisite for hacking on Isso.

```console
$ git clone https://github.com/isso-comments/isso.git
$ cd isso/
$ virtualenv --download .venv
$ source .venv/bin/activate
$ make init
$ make js
(.venv) $ pip install -e .  # -e = "editable" installation for development
(.venv) $ isso -c /path/to/isso.cfg run
```

--------------------------------

### Configure Isso Server Settings

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/guides/quickstart.md

This configuration sets the database path and allowed hosts for CORS. It also shows how to enable comment moderation and configure SMTP for notifications. Ensure the dbpath has correct permissions.

```ini
[general]
; database location, check permissions, automatically created if it
; does not exist
dbpath = /var/lib/isso/comments.db
; for docker image: dbpath = /db/comments.db
;
; your website or blog (not the location of Isso!)
host = http://example.tld/
; you can add multiple hosts for local development
; or SSL connections. There is no wildcard to allow
; any domain.
host =
    http://localhost:1234/
    http://example.tld/
    https://example.tld/

[moderation]
enabled = true

[general]
notify = smtp
[smtp]
; SMTP settings

```

--------------------------------

### Isso WSGI Startup Script (Virtualenv)

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

A Python script for Isso deployment with mod_wsgi when installed in a virtual environment. It adds the virtual environment's site-packages to Python's path before initializing the application. This script prioritizes system modules.

```python
import site
site.addsitedir("/path/to/isso_virtualenv")

import os

from isso import make_app
from isso import dist, config

application = make_app(
config.load(
config.default_file(),
"/path/to/isso.cfg",
),
multiprocessing=True)
```

--------------------------------

### Install gevent for Isso

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

Installs the gevent library, a coroutine-based networking library, using pip. This is a prerequisite for deploying Isso with gevent.

```sh
pip install gevent
```

--------------------------------

### Start and Manage Isso Docker Compose Services

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/technical-docs/testing.md

Instructions for starting, running, and stopping the Isso server using Docker Compose. This ensures a consistent and isolated environment for testing.

```bash
$ docker compose up -d

$ docker compose down -v
```

--------------------------------

### Installing and Using Sphinx Autobuild for Docs Development

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/contributing/documentation.md

Provides instructions for installing and using `sphinx-autobuild` to streamline the documentation development process. It enables automatic rebuilding of documentation upon file changes and live browser refreshing.

```console
(.venv) $ pip install sphinx-autobuild
(.venv) $ sphinx-autobuild -b dirhtml docs/ docs/_build/html
```

--------------------------------

### Run Isso with gunicorn

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

Starts the Isso comment system using the gunicorn WSGI server. This command sets the ISSO_SETTINGS environment variable and specifies the host, port, and number of workers.

```sh
export ISSO_SETTINGS="/path/to/isso.cfg"
gunicorn -b localhost:8080 -w 4 --preload isso.run
```

--------------------------------

### Install sassc and Re-generate CSS (Console)

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/contributing/documentation.md

Instructions for installing the sassc compiler and regenerating CSS files from SCSS. This is necessary when stylesheet changes are made.

```console
$ apt install sassc
$ make css
```

--------------------------------

### Isso WSGI Startup Script (Basic)

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

A basic Python script to initialize the Isso application using mod_wsgi. It loads configuration and enables multiprocessing. Assumes Isso is in the system module search path.

```python
import os

from isso import make_app
from isso import dist, config

application = make_app(
config.load(
config.default_file(),
"/path/to/isso.cfg"),
multiprocessing=True)
```

--------------------------------

### Apache mod_wsgi Configuration

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

Example Apache configuration for serving Isso via mod_wsgi. It defines a WSGI daemon process and maps a URL path to the Isso WSGI script. Ensure the database directory is writable by the Apache user.

```apache
<VirtualHost *>
    ServerName example.org

    WSGIDaemonProcess isso user=www-data group=www-data threads=5
    WSGIScriptAlias /mounted_isso_path /path/to/isso.wsgi
</VirtualHost>
```

--------------------------------

### Run Isso with gevent

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

Executes the Isso comment system using the gevent WSGI server. This command assumes gevent is installed and Isso is accessible.

```sh
isso -c my.cfg run
```

--------------------------------

### Apache mod_fastcgi Configuration

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

Apache configuration directives for deploying Isso using mod_fastcgi. This setup is suitable for hosting environments that restrict long-running processes. It requires the `fastcgi-script` handler.

```apache
LoadModule fastcgi_module /usr/lib64/httpd/modules/mod_fastcgi.so

FastCgiServer /var/www/html/yourapplication/app.fcgi -idle-timeout 300 -processes 5

<VirtualHost *>
    ServerName example.org

    AddHandler fastcgi-script fcgi
    ScriptAlias / /var/www/isso.fcgi

    <Location />
        SetHandler fastcgi-script
    </Location>
</VirtualHost>
```

--------------------------------

### GET /config

Source: https://context7.com/isso-comments/isso/llms.txt

Retrieves the client configuration settings from the server.

```APIDOC
## GET /config

### Description
Retrieves client configuration that depends on server settings, such as moderation preferences and feature flags.

### Method
GET

### Endpoint
`/config`

### Response
#### Success Response (200 OK)
Returns a JSON object containing server configuration settings.

#### Response Example
```json
{
  "config": {
    "reply-to-self": false,
    "require-email": false,
    "require-author": false,
    "reply-notifications": true,
    "gravatar": false,
    "feed": true
  }
}
```
```

--------------------------------

### Import Comments using Isso CLI

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/guides/quickstart.md

This command imports comments from external services like Disqus or WordPress into Isso. It requires the path to the Isso configuration file and the path to the exported XML file. The type of import (disqus or wordpress) must be specified.

```bash
(.venv) $ isso -c /path/to/isso.cfg import -t [disqus|wordpress] disqus-or-wordpress.xml
```

--------------------------------

### reStructuredText Formatting Examples

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/contributing/documentation.md

Demonstrates basic reStructuredText syntax for emphasis, bolding, and code samples. This is fundamental for writing content within the documentation.

```rst
One asterisk: *text* for emphasis (italics),
Two asterisks: **text** for strong emphasis (boldface), and
Double backticks: ``text`` for code samples.
```

--------------------------------

### Isso WSGI Startup Script (Virtualenv Priority)

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

This Python script configures Isso for mod_wsgi deployment within a virtual environment, giving priority to modules within the virtual environment over system modules. It manipulates sys.path to achieve this.

```python
import os
import site
import sys

# Remember original sys.path.
prev_sys_path = list(sys.path)

# Add the new site-packages directory.
site.addsitedir("/path/to/isso_virtualenv")

# Reorder sys.path so new directories at the front.
new_sys_path = []
for item in list(sys.path):
    if item not in prev_sys_path:
        new_sys_path.append(item)
        sys.path.remove(item)
sys.path[:0] = new_sys_path

from isso import make_app
from isso import dist, config

application = make_app(
config.load(
config.default_file(),
"/path/to/isso.cfg",
),
multiprocessing=True)
```

--------------------------------

### Nginx Configuration for Isso Proxy

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/guides/quickstart.md

This Nginx configuration sets up a server block to proxy requests for a dedicated domain (e.g., comments.example.tld) to the Isso server running on localhost:8080. It includes essential proxy headers for correct request handling.

```nginx
server {
    listen [::]:80;
    server_name comments.example.tld;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

```

--------------------------------

### Embed Isso Comments in HTML

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/guides/quickstart.md

This HTML snippet integrates Isso comments into a website. It includes a script tag pointing to the Isso embed script and a section for displaying the comment thread. The `data-isso` attribute specifies the Isso server URL.

```html
<script data-isso="//comments.example.tld/"
        src="//comments.example.tld/js/embed.min.js"></script>

<section id="isso-thread">
    <noscript>Javascript needs to be activated to view comments.</noscript>
</section>

```

--------------------------------

### GET /config

Source: https://github.com/isso-comments/isso/blob/master/CHANGES.rst

Fetches server configuration options that affect the client. This endpoint provides information necessary for the client-side to interact correctly with the server.

```APIDOC
## GET /config

### Description
Fetches server configuration options that affect the client.

### Method
GET

### Endpoint
/config

### Parameters
#### Query Parameters
None

#### Request Body
None

### Response
#### Success Response (200)
- **field** (type) - Description of the configuration field.

#### Response Example
```json
{
  "example": "{\"max-comment-depth\": 5, \"feeds\": true}"
}
```
```

--------------------------------

### SysVinit Script for Isso Service

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/installation.md

This is a basic SysVinit script designed to manage the Isso service. It utilizes `start-stop-daemon` to handle starting, stopping, and restarting the Isso process in the background, including PID file management and user execution. This script is intended for inspiration when creating custom init scripts.

```sh
#!/bin/sh
### BEGIN INIT INFO
# Provides:          isso
# Required-Start:    $local_fs $network
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Description:       lightweight Disqus alternative
### END INIT INFO

EXEC=/opt/isso/bin/isso
EXEC_OPTS="-c /etc/isso.cfg run"

RUNAS=isso
PIDFILE=/var/run/isso.pid

start() {
  echo 'Starting service…' >&2
  start-stop-daemon --start --user "$RUNAS" --background --make-pidfile --pidfile $PIDFILE \
                    --exec $EXEC -- $EXEC_OPTS
}

stop() {
  echo 'Stopping service…' >&2
  start-stop-daemon --stop --user "$RUNAS" --pidfile $PIDFILE --exec $EXEC
}

case "$1" in
  start)
    start
    ;;  stop)
    stop
    ;;
  restart)
    stop
    start
    ;;  *)
    echo "Usage: $0 {start|stop|restart}"
esac
```

--------------------------------

### reStructuredText Link Syntax

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/contributing/documentation.md

Examples of creating inline web links and reference-style links in reStructuredText. These are used for internal and external referencing.

```rst
Use `Link text <https://domain.invalid/>`_ for **inline web links**.

This is a paragraph that contains `a link`_ using **references**.

.. _a link: https://domain.invalid/
```

--------------------------------

### Nginx Configuration for Multiple Isso Sites

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/multi-site-sub-uri.md

This Nginx configuration example shows how to proxy requests to a running Isso instance that is configured to serve multiple websites. It directs traffic for 'comments.example' to the Isso backend running on 'localhost:8080'.

```nginx
server {
    listen [::]:80;
    server_name comments.example;

    location / {
        proxy_pass http://localhost:8080;
    }
}
```

--------------------------------

### Isso FastCGI Script

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/deployment.md

A Python script to run Isso as a FastCGI application using the `flup` library. It includes optional configuration for virtual environments and initializes the Isso application with a specified configuration file.

```python
#!/usr/bin/env python
#: uncomment if you're using a virtualenv
# import sys
# sys.path.insert(0, '<your_local_path>/lib/python3.<ver>/site-packages')

from isso import make_app, dist, config
import os

from flup.server.fcgi import WSGIServer

application = make_app(config.load(
    config.default_file(),
    "/path/to/isso.cfg"))
WSGIServer(application).run()
```

--------------------------------

### Get Server Configuration via REST API

Source: https://context7.com/isso-comments/isso/llms.txt

Retrieves the client configuration settings from the Isso server. This configuration depends on various server-side settings and is essential for client-side initialization.

```shell
# Fetch client config
curl 'https://comments.example.tld/config'
```

--------------------------------

### Jest Snapshot Testing Example

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/technical-docs/testing-client.md

This JavaScript code demonstrates how to use Jest's snapshot testing feature. Instead of manually comparing large HTML strings, `toMatchSnapshot()` checks the current DOM structure against a saved snapshot file. This simplifies UI testing and ensures consistency.

```javascript
expect($(".isso-textarea-wrapper").innerHTML).toMatchSnapshot();
```

--------------------------------

### Running Isso with Configuration File

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/server-config.md

Demonstrates two methods to run the Isso server using a specified configuration file: directly via a command-line argument or by setting an environment variable.

```console
(.venv) $ isso -c /path/to/isso.cfg
```

```console
(.venv) $ env ISSO_SETTINGS=/path/to/isso.cfg$ isso
```

--------------------------------

### Build and Run Isso with Docker (Latest Image)

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/installation.md

This process involves building a Docker image for Isso using `make docker`, which tags it as `isso:latest`. It then runs this custom image, similar to the release image, mapping configuration and database volumes. Adjust the configuration file before running.

```console
$ mkdir -p config/ db/
$ cp contrib/isso.sample.cfg config/isso.cfg
# Set 'dbpath' to '/db/comments.db' and adjust 'host'
$ docker run -d --rm --name isso -p 127.0.0.1:8080:8080 \
    -v $PWD/config:/config -v $PWD/db:/db \
    isso:latest
```

--------------------------------

### Get Atom Feed for a Comment Thread using Isso REST API

Source: https://context7.com/isso-comments/isso/llms.txt

This example shows how to retrieve an Atom feed for a comment thread. This functionality requires the `[rss] base` configuration to be enabled in Isso. The specific curl command for this is not provided, but the description indicates the purpose.

```bash
# GET an Atom feed for a comment thread
# Requires [rss] base configuration.
# Example: curl 'https://comments.example.tld/feed/?uri=/blog/article/'
```

--------------------------------

### Count Comments for Multiple Threads using Isso REST API

Source: https://context7.com/isso-comments/isso/llms.txt

This example shows how to efficiently get comment counts for multiple threads in a single request. It uses a POST request to the /count endpoint with a JSON array of thread URIs. The response is an array of counts corresponding to the order of the URIs provided.

```bash
# Get comment counts for multiple threads
curl -X POST 'https://comments.example.tld/count' \
  -H 'Content-Type: application/json' \
  -d '["/blog/first-post/", "/blog/second-post/", "/blog/third-post/"]'

# Response (200 OK) - array of counts in same order:
[12, 5, 0]
```

--------------------------------

### Listen Option for Host and Port Configuration

Source: https://github.com/isso-comments/isso/blob/master/CHANGES.rst

The 'listen' option replaces the separate 'host' and 'port' settings to provide more flexibility, including support for UNIX domain sockets. The format is 'http://host:port' or 'unix://path/to/socket'. This change is related to issue #25.

```ini
listen = http://localhost:8080
# or
unix = unix:///tmp/isso.sock
```

--------------------------------

### Serve Generated API Documentation with Python

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/server-api.md

This command uses Python's built-in HTTP server to serve the generated API documentation files. This is necessary because browsers will block local file access for security reasons, preventing API calls from being made directly.

```bash
python -m http.server
```

--------------------------------

### Docker Deployment

Source: https://context7.com/isso-comments/isso/llms.txt

Instructions for deploying Isso using Docker, including pulling the latest release.

```APIDOC
## Docker Deployment

### Description
Run Isso using Docker, with instructions for pulling the latest stable release. It is recommended to mount configuration and database volumes for persistence.

### Pull Latest Stable Release
#### Usage
```bash
docker pull ghcr.io/isso-comments/isso:release
```
```

--------------------------------

### API: Fetch Server Configuration (Python)

Source: https://github.com/isso-comments/isso/blob/master/docs/news.md

Introduces a new `/config` endpoint to the API, allowing clients to fetch server configuration options that influence client-side behavior. This helps in synchronizing client and server settings.

```python
# Add /config endpoint for fetching server configuration options that
# affect the client ([#880](https://github.com/posativ/isso/pull/880), ix5)
```

--------------------------------

### Build Docker Images for Isso Testing and Production

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/technical-docs/testing.md

Commands to build the necessary Docker images for Isso. 'docker-testbed' prepares an image for running tests, including dependencies like headless chromium. 'docker' creates a production-ready image.

```console
# Prepare testbed image
$ make docker-testbed

# Create production image
$ make docker
```

--------------------------------

### GET /feed

Source: https://context7.com/isso-comments/isso/llms.txt

Retrieves the Atom feed for comments on a specific thread.

```APIDOC
## GET /feed

### Description
Retrieves the Atom feed for comments on a specific thread.

### Method
GET

### Endpoint
`/feed?uri=<thread_uri>`

### Parameters
#### Query Parameters
- **uri** (string) - Required - The URI of the thread for which to retrieve the comment feed.

### Response
#### Success Response (200 OK)
Returns an Atom XML feed containing comments for the specified thread.

#### Response Example
```xml
<?xml version='1.0' encoding='utf-8'?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:thr="http://purl.org/syndication/thread/1.0">
  <updated>2022-05-24T20:38:04.032789Z</updated>
  <id>tag:example.tld,2018:/isso/thread/blog/article/</id>
  <title>Comments for example.tld/blog/article/</title>
  <entry>
    <id>tag:example.tld,2018:/isso/1/2</id>
    <title>Comment #2</title>
    <updated>2022-05-24T20:38:04.032789Z</updated>
    <author><name>Jane Smith</name></author>
    <link href="https://example.tld/blog/article/#isso-2" />
    <content type="html">&lt;p&gt;Great article!&lt;/p&gt;</content>
  </entry>
</feed>
```
```

--------------------------------

### Client Integration Options

Source: https://github.com/isso-comments/isso/blob/master/CHANGES.rst

New options control client-side integration. 'data-isso-css="false"' prevents CSS injection, 'data-isso-lang="de"' sets the language, and 'data-isso-reply-to-self="true"' enables replies to one's own comments.

```html
<script src="/path/to/isso.js" data-isso-css="false" data-isso-lang="de" data-isso-reply-to-self="true"></script>
```

--------------------------------

### POST /count

Source: https://github.com/isso-comments/isso/blob/master/CHANGES.rst

Retrieves the count of comments for a given URI. This endpoint replaces the deprecated GET /count endpoint.

```APIDOC
## POST /count

### Description
Retrieves the count of comments for a given URI. This endpoint replaces the deprecated GET /count endpoint.

### Method
POST

### Endpoint
/count

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **uri** (string) - Required - The URI for which to count comments.

### Request Example
```json
{
  "uri": "https://example.com/"
}
```

### Response
#### Success Response (200)
- **count** (integer) - The number of comments for the specified URI.

#### Response Example
```json
{
  "count": 15
}
```
```

--------------------------------

### Referencing Shell Commands and Scripts in Isso Docs

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/contributing/documentation.md

Demonstrates the correct way to reference shell commands and actual shell scripts within the Isso documentation. It specifies using `$ /usr/bin/command` for commands and `code-block:: console` for interactive sessions, while `sh` is reserved for actual scripts.

```rst
Use `$ /usr/bin/command` to refer to shell commands and use
`code-block:: console` over `bash` or `sh`.
For actual shell scripts, use `sh`.
Use `(.venv) $ python [cmd]` for things that need to be run inside a
virtual environment and be consistent
```

--------------------------------

### GET /latest

Source: https://context7.com/isso-comments/isso/llms.txt

Retrieves the most recent comments across all threads, optionally limited by a count.

```APIDOC
## GET /latest

### Description
Retrieves the most recent comments across all threads. This endpoint requires `latest-enabled = true` in the server configuration.

### Method
GET

### Endpoint
`/latest?limit=<count>`

### Parameters
#### Query Parameters
- **limit** (integer) - Optional - The maximum number of latest comments to retrieve.

### Response
#### Success Response (200 OK)
Returns a JSON array of the latest comments.

#### Response Example
```json
[
  {
    "id": 42,
    "uri": "/blog/newest-post/",
    "text": "<p>Latest comment here</p>",
    "author": "Recent User",
    "parent": null,
    "created": 1464914341.312426,
    "modified": null,
    "mode": 1,
    "likes": 0,
    "dislikes": 0,
    "website": null
  },
  {
    "id": 41,
    "uri": "/blog/other-post/",
    "text": "<p>Another recent comment</p>",
    "author": null,
    "parent": null,
    "created": 1464912312.123416,
    "modified": null,
    "mode": 1,
    "likes": 1,
    "dislikes": 0,
    "website": null
  }
]
```
```

--------------------------------

### GET / - Fetch Comments

Source: https://context7.com/isso-comments/isso/llms.txt

Retrieves comments for a specific thread with options for pagination and sorting.

```APIDOC
## GET /

### Description
Retrieves comments for a specific thread with options for pagination and sorting.

### Method
GET

### Endpoint
`/`

### Query Parameters
- **uri** (string) - Required - The URI of the thread to fetch comments for.
- **limit** (integer) - Optional - The maximum number of top-level comments to return.
- **nested_limit** (integer) - Optional - The maximum number of nested replies per comment.
- **sort** (string) - Optional - The sorting order. Possible values: `newest`, `upvotes`.
- **after** (integer) - Optional - Fetch comments created after this timestamp.

### Response
#### Success Response (200 OK)
- **id** (null) - Placeholder for comment ID (null for thread root).
- **total_replies** (integer) - Total number of replies for the thread.
- **hidden_replies** (integer) - Number of hidden replies.
- **replies** (array) - An array of comment objects.
  - **id** (integer) - The unique identifier of the comment.
  - **parent** (integer|null) - The ID of the parent comment.
  - **text** (string) - The rendered HTML content of the comment.
  - **author** (string|null) - The author of the comment.
  - **website** (string|null) - The website of the author.
  - **mode** (integer) - The comment mode.
  - **created** (float) - The creation timestamp.
  - **modified** (float|null) - The modification timestamp.
  - **likes** (integer) - The number of likes.
  - **dislikes** (integer) - The number of dislikes.
  - **hash** (string) - A hash of the comment.
  - **total_replies** (integer) - Total number of replies for this comment.
  - **hidden_replies** (integer) - Number of hidden replies for this comment.
  - **replies** (array) - Nested replies.
- **config** (object) - Configuration settings for comments.
  - **reply-to-self** (boolean)
  - **require-email** (boolean)
  - **require-author** (boolean)
  - **reply-notifications** (boolean)
  - **gravatar** (boolean)
  - **feed** (boolean)

#### Response Example
```json
{
  "id": null,
  "total_replies": 14,
  "hidden_replies": 12,
  "replies": [
    {
      "id": 1,
      "parent": null,
      "text": "<p>Hello, World!</p>",
      "author": "Anonymous",
      "website": null,
      "mode": 1,
      "created": 1464818460.732863,
      "modified": null,
      "likes": 2,
      "dislikes": 0,
      "hash": "1cb6cc0309a2",
      "total_replies": 1,
      "hidden_replies": 0,
      "replies": [
        {
          "id": 2,
          "parent": 1,
          "text": "<p>Hi there!</p>",
          "author": null,
          "website": null,
          "mode": 1,
          "created": 1464818460.769638,
          "modified": null,
          "likes": 0,
          "dislikes": 0,
          "hash": "2af4e1a6c96a"
        }
      ]
    }
  ],
  "config": {
    "reply-to-self": false,
    "require-email": false,
    "require-author": false,
    "reply-notifications": false,
    "gravatar": false,
    "feed": true
  }
}
```
```

--------------------------------

### Run Isso with Docker

Source: https://context7.com/isso-comments/isso/llms.txt

Launches the Isso comment server as a Docker container. It maps ports, mounts configuration and database volumes, and sets the environment variable for settings.

```docker
docker run -d \
  --name isso \
  -p 8080:8080 \
  -v /path/to/isso.cfg:/config/isso.cfg \
  -v /path/to/db:/db \
  -e ISSO_SETTINGS=/config/isso.cfg \
  ghcr.io/isso-comments/isso:release
```

--------------------------------

### GET /feed - Atom Feed

Source: https://context7.com/isso-comments/isso/llms.txt

Retrieves an Atom feed for a comment thread. Requires `[rss] base` configuration.

```APIDOC
## GET /feed

### Description
Retrieves an Atom feed for a comment thread. Requires `[rss] base` configuration.

### Method
GET

### Endpoint
`/feed`

### Query Parameters
- **uri** (string) - Required - The URI of the thread to get the Atom feed for.

### Response
#### Success Response (200 OK)
- **Atom Feed**: An XML document formatted according to the Atom Syndication Format.

#### Response Example
(Atom feed XML content - omitted for brevity)
```

--------------------------------

### Isso Duplicate Slash Fix Revert

Source: https://github.com/isso-comments/isso/blob/master/CHANGES.rst

This reverts a fix for duplicate slashes in URLs. The original fix prevented Isso from starting in some cases, so it has been rolled back.

```python
# Revert fix for duplicate slashes, as it prevents isso from
# starting in some cases. #523
```

--------------------------------

### Get Atom Feed for a Thread

Source: https://context7.com/isso-comments/isso/llms.txt

Retrieves the Atom feed for comments on a specific blog article. This is useful for syndication and keeping track of new comments.

```shell
curl 'https://comments.example.tld/feed?uri=/blog/article/'
```

--------------------------------

### Configuring Multiple Hosts for Isso

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/server-config.md

Illustrates how to specify multiple website hosts in the [general] section of the Isso configuration. This is necessary for security reasons, particularly for CORS, and allows for fallback to non-SSL if needed.

```ini
[general]
host =
    http://example.tld/
    https://example.tld/
```

--------------------------------

### Custom CSS for Textarea Replacement

Source: https://github.com/isso-comments/isso/blob/master/CHANGES.rst

When replacing '<textarea>' with '<div contenteditable="true">', custom CSS might need adjustments. This example shows how to style the new element.

```css
.textarea {
  white-space: pre;
}
```

--------------------------------

### Run Isso with Docker (Release Image)

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/installation.md

This command pulls the latest stable Docker image for Isso and runs it as a detached service. It maps host directories for configuration and database storage to the container and exposes the service on port 8080. Ensure the configuration file is adjusted for `dbpath` and `host`.

```console
$ docker pull ghcr.io/isso-comments/isso:release
$ mkdir -p config/ db/
$ cp contrib/isso.sample.cfg config/isso.cfg
# Set 'dbpath' to '/db/comments.db' and adjust 'host'
$ docker run -d --rm --name isso -p 127.0.0.1:8080:8080 \
    -v /var/lib/isso:/config -v /var/lib/isso:/db \
    ghcr.io/isso-comments/isso:release
```

--------------------------------

### Configure Hash Handling for Security (Python)

Source: https://github.com/isso-comments/isso/blob/master/CHANGES.rst

This section allows customization of hash handling for security-sensitive data. You can specify a salt, choose a hashing algorithm (like pbkdf2), and tune its parameters. This is crucial for securely storing user-related information.

```ini
[hash]
salt = Eech7co8Ohloopo9Ol6baimi
algorithm = pbkdf2

```

--------------------------------

### Get Latest Comments via REST API

Source: https://context7.com/isso-comments/isso/llms.txt

Fetches the most recent comments across all threads. Requires the 'latest-enabled' configuration to be true on the server. The 'limit' parameter controls the number of comments returned.

```shell
# Get latest 5 comments
curl 'https://comments.example.tld/latest?limit=5'
```

--------------------------------

### Configure SMTP From Header

Source: https://github.com/isso-comments/isso/blob/master/CHANGES.rst

Allows setting a full 'From' header for SMTP notifications. This is configured in the [smtp] section of the configuration file.

```ini
[smtp]
from = Foo Bar <spam@local>
```

--------------------------------

### Generate Docker Screenshots for Isso

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/technical-docs/testing-client.md

These commands are used within the Isso project to manage visual regression testing through screenshots. The first command generates new screenshots, the second compares them against existing hash files, and the third updates the hash files if visual changes are intentional. It is recommended to use Docker for consistent results across different environments.

```console
$ make docker-generate-screenshots
```

```console
$ make docker-compare-screenshots
```

```console
$ make docker-update-screenshots
```

--------------------------------

### API: Count Endpoint Change (Python)

Source: https://github.com/isso-comments/isso/blob/master/docs/news.md

Removes the `/count` GET endpoint and mandates the use of the POST method instead. This change affects how comment counts are retrieved via the API.

```python
# Remove /count GET endpoint (use POST instead) ([#883](https://github.com/posativ/isso/pull/883), ix5)
```

--------------------------------

### Multiple Site Support

Source: https://github.com/isso-comments/isso/blob/master/CHANGES.rst

The project now supports multiple websites, a feature that is part of the broader effort related to issue #34.

```text
part of #34
```

--------------------------------

### Configure Isso Server Settings (INI)

Source: https://github.com/isso-comments/isso/blob/master/docs/news.md

Demonstrates how client-side settings can be overridden by server configurations. When these settings are present in the server configuration, the corresponding `data-isso-*` attributes on the client will be ignored.

```ini
[general]
reply-notifications
gravatar
[guard]
reply-to-self
require-author
require-email
```

--------------------------------

### Load Comments After AJAX Content Load

Source: https://context7.com/isso-comments/isso/llms.txt

An example of loading comments after article content is loaded via AJAX. It updates the thread ID and then fetches comments, suitable for dynamic content loading scenarios.

```javascript
// Example: Load comments after AJAX content load
function loadArticle(articlePath) {
  fetch(`/api/articles${articlePath}`)
    .then(response => response.json())
    .then(article => {
      document.getElementById('article-content').innerHTML = article.content;
      document.getElementById('isso-thread').setAttribute('data-isso-id', articlePath);
      window.Isso.fetchComments();
    });
}
```

--------------------------------

### Configure Logging to File (Python)

Source: https://github.com/isso-comments/isso/blob/master/CHANGES.rst

This setting enables logging of application events to a specified file. By providing a file path to the 'log-file' option under the '[general]' section, Isso can persist logs for debugging and monitoring purposes. If left empty, logging behavior may default to console output.

```ini
[general]
log-file = /var/log/isso.log

```

--------------------------------

### Run Isso Development Server with Python Virtual Environment

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/technical-docs/testing.md

This snippet demonstrates how to set up a Python virtual environment and run the Isso development server. It's useful for local development and debugging, providing a live instance of Isso at localhost:8080.

```bash
$ virtualenv --download .venv
$ source .venv/bin/activate
(.venv) $ isso -c contrib/isso-dev.cfg run
```

--------------------------------

### Nginx Configuration for Isso on Sub-URI

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/multi-site-sub-uri.md

This Nginx configuration demonstrates how to run Isso on a sub-URI (e.g., '/isso') on the same domain as the main website. This setup helps circumvent CORS issues and ensures compatibility with privacy-focused browser extensions.

```nginx
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_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_pass http://localhost:8080;
    }
}
```

--------------------------------

### Export Isso Comments to CSV using Bash

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/guides/tips-and-tricks.md

This script exports all comments from an Isso SQLite database to a CSV file. It requires `sqlite3` to be installed and accessible. The output includes page URI, title, comment details, and author information.

```bash
dbpath='/path/to/your/isso.db'
data=$(sqlite3 ${dbpath} -csv 'SELECT threads.uri, threads.title, comments.id, comments.mode, datetime(comments.created, "unixepoch", "localtime"), datetime(comments.modified, "unixepoch", "localtime"), comments.author, comments.email, comments.website, comments.remote_addr, comments.likes, comments.dislikes, comments.voters,comments.text FROM comments INNER JOIN threads ON comments.tid=threads.id')
header='"page: URI","page: title","ID","mode","created on","modified on","author: name","author: email","author: website","author: IP","likes","dislikes","voters","text"'
echo -e "${header}
""${data}" > export.csv
```

--------------------------------

### POST /preview - Preview Comment

Source: https://context7.com/isso-comments/isso/llms.txt

Provides a preview of how Markdown text will be rendered as HTML.

```APIDOC
## POST /preview

### Description
Provides a preview of how Markdown text will be rendered as HTML.

### Method
POST

### Endpoint
`/preview`

### Request Body
- **text** (string) - Required - The raw Markdown text to preview.

### Request Example
```json
{
  "text": "# Heading\n\nSome **bold** and *italic* text with `code`."
}
```

### Response
#### Success Response (200 OK)
- **text** (string) - The rendered HTML content.

#### Response Example
```json
{
  "text": "<h1>Heading</h1>\n<p>Some <strong>bold</strong> and <em>italic</em> text with <code>code</code>.</p>"
}
```
```

--------------------------------

### Delete a Comment using Isso REST API

Source: https://context7.com/isso-comments/isso/llms.txt

This example shows how to delete a comment using a DELETE request to the /id/{comment_id} endpoint. Authentication with a cookie file is required. The response will be null if the deletion is successful and the comment has no replies, or it will return the comment object marked as deleted if it has replies.

```bash
# Delete comment with id 1
curl -X DELETE 'https://comments.example.tld/id/1' \
  -H 'Content-Type: application/json' \
  -b cookies.txt

# Response if no replies (200 OK):
null

# Response if comment has replies (200 OK) - comment marked as deleted but kept:
{
  "id": 1,
  "parent": null,
  "text": "",
  "author": null,
  "website": null,
  "mode": 4,
  "created": 1464940838.254393,
  "modified": 1464943500.123456,
  "likes": 0,
  "dislikes": 0
}
```

--------------------------------

### Isso Admin Interface Initialization

Source: https://github.com/isso-comments/isso/blob/master/CHANGES.rst

This change modifies the default behavior of the admin interface. It will not be enabled with a default password by default, enhancing security.

```python
# Don't enable admin interface with default password by default.  #491
```

--------------------------------

### Nginx Reverse Proxy for Isso

Source: https://context7.com/isso-comments/isso/llms.txt

Nginx configurations for setting up a reverse proxy to Isso. It covers scenarios for running Isso on a subdomain and on a sub-path of a main website, including necessary header configurations.

```nginx
# Isso on subdomain (recommended)
server {
    listen 443 ssl http2;
    server_name comments.example.tld;

    ssl_certificate /etc/ssl/certs/example.tld.crt;
    ssl_certificate_key /etc/ssl/private/example.tld.key;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

# Isso on sub-path of main site
server {
    listen 443 ssl http2;
    server_name example.tld;

    # Your main site configuration...

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

--------------------------------

### Override Isso Translation Strings (HTML)

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/client-config.md

This snippet illustrates how to override specific translation strings used by the Isso client. By appending `-text-[lang]` to a translation key and using it as a `data-isso-` attribute, you can customize the text displayed to users for a particular language. For example, overriding the 'postbox-notification' message for English is shown.

```html
data-isso-postbox-notification-text-en="Select to be notified of replies to your comment"
```

--------------------------------

### Configure apiDoc for Live API Testing

Source: https://github.com/isso-comments/isso/blob/master/docs/docs/reference/server-api.md

This JSON configuration snippet sets up apiDoc for live API testing. It defines the API name, version, and the sample URL for testing endpoints. The 'private' field can be set to 'true' to exclude private API endpoints from documentation.

```json
{
  "name": "Isso API",
  "version": "0.13.0",
  "sampleUrl": "http://localhost:8080",
  "private": "true"
}
```