Talkyard is a new commenting system for Jekyll and other static site generators. It’s Disqus alternative — but open source so you can install it for free on your own server. There’s hosting too for €3, so you don’t need a server. Lightweight, just 140 kb javascript (compare with Disqus, about 750 kb).

This website is a static Jekyll blog, with Talkyard comments below each blog post — look at the bottom of the pages. Talkyard is forum software too, with chat and question-answers features — so you can create a community for your website, integrated with the blog comments.

Demo video:


Here’s a demo Jekyll discussion.

Longer demo discussion (the one in the video).

Quick test if this is for you

Maybe you don’t want to get a server and install, or sign up for our hosted service, just to find out if Talkyard works for your blog / website? Here’re 3 quick steps for you to try out Talkyard:

  1. Add this to your _config.yml file:

    talkyard_server_url: https://comments-demo.talkyard.io
    
  2. Do real installation step 3 below, i.e. add the _includes/talkyard-comments.html file.

  3. Do real installation step 4 below, i.e. start including that file. Restart Jekyll afterwards.

Now, regenerate your blog and look at the comment section that should appear below the blog posts. You can post test comments but they’ll disappear later on, some day. Currently the comment section background color is always white, but later on you’ll be able to tweak how it looks.

Are you satisfied with how it looks? If not, you can “complain”: https://www.talkyard.io/forum/latest/support, maybe we can make it look better.

If you like it, then do real installation step 1 below, and step 2 again — and this time, specify the address to your own Talkyard site. (Skip step 3 and 4, you’ve done them already.)

Real installation

Install this commenting system in four steps:

  1. Go to https://www.talkyard.io and click Start a Community, choose Blog Comments and type your website address. Copy the address to your new embedded comments site.

  2. In your Jekyll site configuration, i.e. _config.yml, add this config value and paste the address:

    talkyard_server_url: https://comments-for-your-site.talkyard.io
    
  3. Create a file _includes/talkyard-comments.html: (TEST001 is intentional)

    TEST001
    {% if site.talkyard_server_url %}
    {% capture script_url %}{%
      if site.talkyard_script_url %}{{ site.talkyard_script_url }}{%
      else %}{{ 'https://cdn.talkyard.net/-/talkyard-comments.min.js' }}{%
      endif %}{%
    endcapture %}
    
    <script>talkyardServerUrl='{{ site.talkyard_server_url }}';</script>
    <script async defer src="{{ script_url }}"></script>
    <div class="talkyard-comments" data-discussion-id="{{ page.discussion_id }}" style="margin-top: 45px;">
    <noscript>Please enable Javascript to view comments.</noscript>
    <p style="margin-top: 25px; opacity: 0.9; font-size: 96%">Comments powered by
    <a href="https://www.talkyard.io">Talkyard</a>.</p>
    </div>
    {% endif %}
    
  4. Add this in your post template, i.e. _layouts/post.html, where you want comments to appear:

    {% include talkyard-comments.html %}
    

    If you don’t have a _layout/posts.html file, that’s because by default Jekyll hides it. Read more here: https://jekyllrb.com/docs/themes/#overriding-theme-defaults about where you’ll find it (and you need to copy it to your directory).

  5. Optionally, add a frontmatter discussion_id: per-discussion-id to your blog posts / articles. Then, you can change the URL to a blog post, without the discussion disappearing.

Now, restart Jekyll and reload a blog post in the browser. Do you see a comments section now? If so, remove TEST001 above. If not — do you see TEST001? If you do see TEST001 but not the comments, then ask for help, see below. If you don’t see TEST001, you added the comments code at the wrong place, or you’re looking at the wrong page.

Again, note that Talkyard also is forum software, with chat and Q&A features — so you can create a community for your website, integrated with the blog comments.

You can ask for help in the support forum, and suggest ideas. Or post a comment below on this page (test comments are fine too).