An open API service indexing awesome lists of open source software.

https://github.com/gadenbuie/quarto-bluesky-comments

Bluesky-powered comments sections for Quarto websites
https://github.com/gadenbuie/quarto-bluesky-comments

bluesky quarto-extension quarto-shortcode

Last synced: about 1 year ago
JSON representation

Bluesky-powered comments sections for Quarto websites

Awesome Lists containing this project

README

          

# Bluesky Comments For Quarto

# Installing

``` bash
quarto add gadenbuie/quarto-bluesky-comments
```

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

## Using

Adding Bluesky-powered comments to your blog is a three-step
process[^1]:

1. Publish the blog post and post about it on Bluesky.
2. Copy the link to the Bluesky post.
3. Add `{{< bluesky-comments {post-url} >}}` to your blog post and
re-publish.

Using Bluesky for comments introduces a chicken-or-egg problem. You need
one Bluesky post to watch for replies so that those replies can be shown
in your blog post as comments. But first, you need to publish your blog
so you can share it on Bluesky. Once you have the link to your skeet,
come back to your blog and add the `{{< bluesky-comments >}}` shortcode.

The `{{< bluesky-comments >}}` shortcode doesn’t add any additional
decoration (to make it as flexible as possible for your use case).
Here’s a short snippet that adds the comments under a horizontal rule
and in a “Comments” section:

``` markdown
---

## Comments {.unlisted}

{{< bluesky-comments https://bsky.app/profile/grrrck.xyz/post/3lbu5opiixc2j >}}
```

[^1]: Yes, I know, that’s actually 5 steps.