Migrating Site Comments to Utterances

[ til python ] · 1 min read

Today I learnt how to migrate comments on this site to Utterances. The comments functionality on this site has migrated from Discus to Commento and most recently, utterances. You can see the history in the comments here.

Here are the steps I took:

  • Create a repo just for comments.
  • Set up utteranc.es with the repo.
  • Add the html below to my layout template.
<script src="https://utteranc.es/client.js"
        repo="eugeneyan/eugeneyan-comments"
        issue-term="url"
        theme="github-light"
        crossorigin="anonymous"
        async>
</script>
{
  "issue": {
    "title": "Imported from some other system",
    "body": "..."
  },
  "comments": [
    {
      "body": "comment",
      "create_at": "timestamp"
    }
  ]
}
  • Read the json comments, clean them up, and upload via the GitHub API (code).

Now all comments are GitHub issues. Here’s an example of how it looks like in a post. One downside is that readers will need to login via GitHub to be able to comment; hope this isn’t too big of a barrier.


Share on:

Browse related tags: [ til python ]

Want New Posts By Email?

Weekly updates about 🚀Effective Data Science, 📚Learning, and 📈Career.

    Welcome gift: A 5-day email course on How to be an Effective Data Scientist 🚀