{"id":22491684,"url":"https://github.com/quarto-ext/bluesky-comments","last_synced_at":"2025-06-21T07:41:57.747Z","repository":{"id":264852220,"uuid":"894325283","full_name":"quarto-ext/bluesky-comments","owner":"quarto-ext","description":"A Quarto Shortcode Extension to Embed Comments from Bluesky","archived":false,"fork":false,"pushed_at":"2025-05-09T12:15:39.000Z","size":153,"stargazers_count":11,"open_issues_count":4,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-06-16T16:06:18.734Z","etag":null,"topics":["bluesky","discussion","quarto","quarto-extension"],"latest_commit_sha":null,"homepage":"https://quarto-ext.github.io/bluesky-comments/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quarto-ext.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["coatless"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2024-11-26T06:47:12.000Z","updated_at":"2025-05-09T12:15:43.000Z","dependencies_parsed_at":"2024-12-05T14:19:57.916Z","dependency_job_id":"5258d8e2-8945-4aef-905d-a6b8ad62de08","html_url":"https://github.com/quarto-ext/bluesky-comments","commit_stats":null,"previous_names":["coatless-quarto/bluesky-comments","quarto-ext/bluesky-comments"],"tags_count":3,"template":false,"template_full_name":"coatless-devcontainer/quarto-extension-dev","purl":"pkg:github/quarto-ext/bluesky-comments","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarto-ext%2Fbluesky-comments","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarto-ext%2Fbluesky-comments/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarto-ext%2Fbluesky-comments/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarto-ext%2Fbluesky-comments/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quarto-ext","download_url":"https://codeload.github.com/quarto-ext/bluesky-comments/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarto-ext%2Fbluesky-comments/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261087996,"owners_count":23107655,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bluesky","discussion","quarto","quarto-extension"],"created_at":"2024-12-06T18:09:05.932Z","updated_at":"2025-06-21T07:41:52.737Z","avatar_url":"https://github.com/quarto-ext.png","language":"JavaScript","funding_links":["https://github.com/sponsors/coatless"],"categories":[],"sub_categories":[],"readme":"# Bluesky Comments Extension for Quarto \u003cimg src=\"https://github.com/user-attachments/assets/260e97ce-6941-4f3a-8dc8-b7125522ebc0\" align=\"right\" alt=\"Logo: A butterfly in the blue sky with comments\" width=\"150\"/\u003e\n\n\u003e Enable Bluesky social discussions in your Quarto documents\n\nBluesky Comments is a Quarto shortcode extension that seamlessly integrates Bluesky post comments into your documents. This extension dynamically fetches and displays threaded conversations from Bluesky, creating an interactive bridge between your content and social discussions.\n\n## Installation\n\nYou can install this extension using Quarto's extension management system:\n\n```bash\nquarto add quarto-ext/bluesky-comments\n```\n\nThis will install the extension under the `_extensions` directory of your Quarto project.\n\n### Requirements\n\n- Quarto version 1.5.0 or higher\n- A web browser with JavaScript enabled\n\n## Usage\n\nTo embed comments from a Bluesky post, use the `bluesky-comments` shortcode in your Quarto document:\n\n````markdown\n{{{\u003c bluesky-comments at://did.plc/rkey \u003e}}}\n````\n\n### Converting Bluesky URLs to AT Protocol URIs\n\nTo get the correct URI format, use the [Bluesky/AT Protocol URL ↔ Identifier Converter](https://web-apps.thecoatlessprofessor.com/bluesky/profile-or-post-to-did-at-uri.html).\n\nFor example:\n\n1. **Original URL:**\n   ```\n   https://bsky.app/profile/coatless.bsky.social/post/3lbtwdydxrk26\n   ```\n\n2. **Converted AT-URI:**\n   ```\n   at://did:plc:fgeozid7uyx2lfz3yo7zvm3b/app.bsky.feed.post/3lbtwdydxrk26\n   ```\n\n3. **Final shortcode:**\n   ````markdown\n   {{\u003c bluesky-comments at://did:plc:fgeozid7uyx2lfz3yo7zvm3b/app.bsky.feed.post/3lbtwdydxrk26 \u003e}}\n   ````\n\n## Configuration\n\nThe extension can be configured through your document's YAML frontmatter or the `_quarto.yml` configuration file. Add configuration options under the `bluesky-comments` key:\n\n```yaml\n---\ntitle: \"My Document\"\nbluesky-comments:\n  mute-patterns:\n    - \"📌\"\n    - \"🔥\"\n    - \"/\\\\bspam\\\\b/i\"  # regex pattern\n  mute-users:\n    - \"did:plc:1234abcd\"\n  filter-empty-replies: true\n  visible-comments: 3\n  visible-subcomments: 3\n---\n```\n\n### Available Options\n\n- `mute-patterns`: An array of strings or regex patterns (enclosed in `/`) to filter out comments containing specific text\n- `mute-users`: An array of Bluesky DIDs to filter out comments from specific users\n- `filter-empty-replies`: Boolean flag to filter out empty or very short replies (default: `true`)\n- `visible-comments`: Number of top-level comments to show initially (default: `3`)\n- `visible-subcomments`: Number of replies to show initially under each comment (default: `3`)\n\nUsers can click \"Show more\" buttons to reveal additional comments and replies beyond these initial limits. Filtered comments are counted and displayed at the top of the comments section to maintain transparency about moderation.\n\n## Styling\n\nModify the extension's appearance by overriding CSS classes in:\n\n```defaults\n_extensions/bluesky-comments/styles.css\n```\n\n## Limitations\n\n- Only works in HTML output formats with JavaScript enabled\n- Subject to Bluesky's API rate limits and availability\n\n## Acknowledgements\n\nThis extension builds upon the innovative work of:\n\n- [Emily Liu](https://emilyliu.me/blog/comments) - [Original concept](https://bsky.app/profile/emilyliu.me/post/3lbqta5lnck2i)\n- [Samuel Newman](https://bsky.app/profile/samuel.bsky.team) - [Implementation details](https://graysky.app/blog/2024-02-05-adding-blog-comments)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquarto-ext%2Fbluesky-comments","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquarto-ext%2Fbluesky-comments","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquarto-ext%2Fbluesky-comments/lists"}