"Share on BlueSky" social media button

[kikinovak]

Hi,

I'd like to add a "Share on BlueSky" social media button to the bottom of my blog articles. The example given in the MkDocs Material documentation are only for Twitter/X and Facebook. Here in France, the overwhelming majority of geeks and sysadmins have migrated to BlueSky.

Any suggestions ?

Niki

[mocdaniel]

You will have to add a block like this to your mkdocs.yaml:

extra:
  social:
    - icon: fontawesome/brands/bluesky
      link: https://bsky.app/profile/<your-profile>
      name: <description>

name will be used as the link's title attribute. The social icon will be rendered in the footer of your page,next to the copyright notice.

More info here.

[kikinovak]

My question was not about the social media link in the page footer. I alredy have that.

What I'm looking for is a way to have a "Share this page on BlueSky" button on the bottom of blog articles.

[kamilkrzyskow]

Hi @kikinovak,
not sure why the answer for the comment system got selected here in the share bluesky thread 🤔
So you're asking about the guide for setting up a blog:
https://squidfunk.github.io/mkdocs-material/tutorials/blogs/engage/#share-and-like-buttons

And you would like to use bluesky instead of twitter?
Quick search online leads to this page: https://docs.bsky.app/docs/advanced-guides/intent-links
Bluesky only support text param, so if you have long links then it might go over the 300 character limit, idk 🤔
Modified the example from the site, untested so there could be a typo ✌️

from textwrap import dedent
import urllib.parse
import re

x_intent = "https://x.com/intent/tweet"
fb_sharer = "https://www.facebook.com/sharer/sharer.php"
bs_intent = "https://bsky.app/intent/compose"
include = re.compile(r"blog/[1-9].*")

def on_page_markdown(markdown, **kwargs):
    page = kwargs['page']
    config = kwargs['config']
    if not include.match(page.url):
        return markdown

    page_url = config.site_url+page.url
    page_title = urllib.parse.quote(page.title+'\n')
    bs_text = urllib.parse.quote(page.title+'\n'+page_url)

    return markdown + dedent(f"""
    [Share on :simple-x:]({x_intent}?text={page_title}&url={page_url}){{ .md-button }}
    [Share on :simple-facebook:]({fb_sharer}?u={page_url}){{ .md-button }}
    [Share on :simple-bluesky:]({bs_intent}?text={bs_text}){{ .md-button }}
    """)

[purplecandy]

You need to look into custom overrides with partials. I think the most suitable one would be using the post partial or the comment partial.

Take alook at this example: https://squidfunk.github.io/mkdocs-material/setup/adding-a-comment-system/

[kikinovak]

I experimented a couple hours and now I'm happy with Giscus. Works perfectly.

Cheers,

Niki