Isso (Disqus alternative) just works, and we should probably mention it in the doc

I have discovered Isso recently, it’s a self hosted alternative to Disqus.

I checked if mkdocs-material was supporting it but couldn’t find anything in the doc.

I still managed to integrate it by replacing the disqus block with Isso stuff and it just works great:

{% extends "base.html" %}

{% block disqus %}

<!-- replace disqus with isso -->
<script 
	data-isso="https://comment.example.org/" 
	data-isso-css="true" 
	data-isso-require-author="true" 
	data-isso-require-email="true" 
	data-isso-reply-to-self="false"
	src="https://comment.example.org/js/embed.min.js">
</script>
<section id="isso-thread"></section>

<noscript>Please enable JavaScript to view the comments.</noscript>
{% endblock %}

I think it would be nice to mention in the doc that Isso can work.

Now my question is, should I make a PR documenting this thing above that I consider a “workaround”, or would you rather develop a proper integration?

[Guts]

@sebw no worries, I’ve managed and I put it here, maybe it could help someone else:

extra:
  comments_url: http://comments-isso.example.com

In main.html:

[...]
{% block disqus %}

  {% if not page.is_homepage %}
    {# Comment system (Isso) #}
    <div id="__comments">
      <script
        data-isso="{{ config.extra.comments_url }}/"
        data-isso-require-author="true"
        data-isso-require-email="true"
        data-isso-reply-to-self="false"
        data-isso-vote="true"
        src="{{ config.extra.comments_url }}/js/embed.min.js">
      </script>
      <hr><section id="isso-thread"><h2>Comments</h2></section>
      <noscript>Please enable JavaScript to view the comments.</noscript>
    </div>
  {% endif %}
{% endblock %}
[...]

Please note that I chose to disable comments on homepage.

[anjannair]

{% endif %}

Thank you for this solution @Guts, I somehow couldn’t locate the exclude homepage solution until I stumbled upon your solution!