Setting up utterances

What is Utterances?

Utterances is a comments widget powered by GitHub Issues. When visitors comment, Utterances creates GitHub issues in the designated repository to store and manage comments. Users must authenticate with GitHub to comment, which helps reduce spam and links comments to accounts.

FRQ 1: Explain the primary function of Utterances and how it leverages GitHub's features to achieve its purpose.

How to Install Utterances

Follow these steps to install Utterances on your repository:

Visit the Utterances GitHub App page and click "Install".
Select the repository or grant access to all repositories as needed.
Configure the app's permissions (issues access is required).

Usage Snippet (HTML include)

Place this script in an include (e.g., `_includes/utterances.html`) or directly in your post layout to enable comments:

<script src="https://utteranc.es/client.js"
    repo="OWNER/REPO"
    issue-term="title"
    label="blogpost-comment"
    theme="github-light"
    crossorigin="anonymous"
async>
</script>

FRQ 2: A student reports that Utterances works locally but not on the live GitHub Pages site. What is the likely cause and fix?

Troubleshooting

Common issues:

Utterances creates issues only if the configured repository has issue creation enabled.
Make sure the repo attribute in the snippet points to the correct repository (owner/name).
On GitHub Pages, ensure the page is deployed (not just local). If using Actions, confirm the deployment is successful.

FRQ 3: List two checks you would perform if Utterances fails to create issues on the live site.