Open Social Comments for Quarto

This extension adds social media comments to your Quarto blog posts, supporting both Mastodon and Bluesky.

You can see (and leave a comment on) a working example on my blog here.

Note: This extension was previously named "quarto-mastodon-comments". The repository has been renamed to better reflect its expanded functionality. The old installation command will continue to work thanks to GitHub's automatic redirects.

Migration from quarto-mastodon-comments

If you previously used quarto-mastodon-comments, the simplest migration path is to install open-social-comments alongside it:

1. Keep your existing quarto-mastodon-comments installation to maintain compatibility with older posts
2. Install open-social-comments using the command below
3. For new posts, use the open-social-comments configuration format

This approach ensures your existing posts continue to work while allowing you to use the expanded features in new content.

Installing

quarto install extension AndreasThinks/open-social-comments

If you previously installed this extension as quarto-mastodon-comments, you don't need to make any changes. GitHub's redirects ensure that existing installations continue to work.

This will install the extension under the _extensions subdirectory. If you're using version control, you will want to check in this directory.

Using

Mastodon Comments

1. Create a post about your content on Mastodon (for example, an announcement post)
2. Click on this post to obtain the relevant "toot id" from the URL
3. Add the following to your post's YAML header, replacing the values with your Mastodon details:

filters:
  - open-social-comments
mastodon_comments:
  user: "AndreasThinks"
  host: "fosstodon.org"
  toot_id: "111995180253316042"

Bluesky Comments

1. Create a post about your content on Bluesky
2. Copy the post's URL
3. Add the following to your post's YAML header:

filters:
  - open-social-comments
bluesky_comments:
  post_uri: "https://bsky.app/profile/theradr.bsky.social/post/3knoaw5z4ek2v"

Using Both

You can enable both Mastodon and Bluesky comments on the same post by including both configurations:

filters:
  - open-social-comments
mastodon_comments:
  user: "AndreasThinks"
  host: "fosstodon.org"
  toot_id: "111995180253316042"
bluesky_comments:
  post_uri: "https://bsky.app/profile/theradr.bsky.social/post/3knoaw5z4ek2v"

Acknowledgements

This project builds upon and is inspired by the work of others:

• The Mastodon comments component is based on the mastodon-comments webcomponent by dpecos
• The Bluesky comments implementation draws from this webcomponent by LoueeD
• Icons are provided by Font Awesome via their CDN

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.