TF Discuss Loading

Configuration

Repository

Choose the repository TF Discuss will connect to. Make sure that:

  1. The TF Discuss app is installed, otherwise visitors will not be able to comment and react.
  2. The Discussions feature is turned on by enabling it for your repository.

A public GitHub repository. This repo is where the discussions will be linked to.

Page Discussions Mapping

Choose the mapping between the embedding page and the embedded discussion.

TF Discuss will search for a discussion whose title contains the page's pathname URL component.

TF Discuss will search for a discussion whose title contains the page's URL.

TF Discuss will search for a discussion whose title contains the page's <title> HTML tag.

TF Discuss will search for a discussion whose title contains the page's <meta property="og:title"> HTML tag.

TF Discuss will search for a discussion whose title contains a specific term.

TF Discuss will load a specific discussion by number. This option does not support automatic discussion creation.

Avoid mismatches due to GitHub's fuzzy searching method when there are multiple discussions with similar titles. See the documentation for more details.

Discussion Category

Choose the discussion category where new discussions will be created. It is recommended to use a category with the Announcements type so that new discussions can only be created by maintainers and giscus.

When searching for a matching discussion, TF Discuss will only search in this category.

Features

Choose whether specific features should be enabled.

The reactions for the discussion's main post will be shown before the comments.

Discussion metadata will be sent periodically to the parent window (the embedding page). For demonstration, enable this option and open your browser's console on this page. See the documentation for more details.

The comment input box will be placed above the comments, so that users can leave a comment without scrolling to the bottom of the discussion.

Loading of the comments will be deferred until the user scrolls near the comments container. This is done by adding loading="lazy" to the <iframe> element.

Theme

Choose a theme that matches your website. Can't find one that does? Contribute a new theme.

Enable TF Discuss

Add the following <script> tag to your website's template where you want the comments to appear. If an element with the class .giscus exists, the comments will be placed there instead.

You have not configured your repository and/or category. The values for those fields will not show up until you fill them out.
<script src="https://discuss.tenetforce.ai/client.js"
        data-repo="[ENTER REPO HERE]"
        data-repo-id="[ENTER REPO ID HERE]"
        data-category="[ENTER CATEGORY NAME HERE]"
        data-category-id="[ENTER CATEGORY ID HERE]"
        data-mapping="pathname"
        data-strict="0"
        data-reactions-enabled="1"
        data-emit-metadata="0"
        data-input-position="bottom"
        data-theme="preferred_color_scheme"
        data-lang="en"
        crossorigin="anonymous"
        async>
</script>

You can customize the container layout using the .giscus and .giscus-frame selectors from the embedding page.

Powered by Tenet Force