Skip to content

Conversation

Syphdias
Copy link
Contributor

@Syphdias Syphdias commented Dec 3, 2024

What does this PR change? What problem does it solve?

Mastodon (and potentially other fediverse clients) can attribute a shared link to a fediverse user.

This adds the ability to do so by setting the social.fediverse_creator to "@user@instance.example.com".

It has the prerequisite that the website the shared link is from is on your allow list. To set this up in Mastodon:

  1. "Preferences" on the right-hand side
  2. "Public profile" on the left-hand side
  3. "Versification" tab in the top bar
  4. In the section "Author attribution", add all relevant domains to the field for "Websites allowed to credit you" (one per line)
  5. "Save changes"

Note that this is not retroactive and failing to set up to the correct domain in the allow list beforehand will not update old links in post and might even be cached for a specific link on a specific instance.

Furthermore, the docs for this feature should include the prerequisite and its pitfall of not setting up the allowed domain beforehand.

Also, this might also be interesting to do on an article basis. It is not for me right now.

PR Checklist

  • This change adds/updates translations and I have used the template present here.
  • I have enabled maintainer edits for this PR.
  • I have verified that the code works as described/as intended.
  • This change adds a Social Icon which has a permissive license to use it.
  • This change does not include any CDN resources/links.
  • This change does not include any unrelated scripts such as bash and python scripts.
  • This change updates the overridden internal templates from HUGO's repository.

Mastodon (and potentially other fediverse clients) can attribute a
shared link to a fediverse user.

This adds the ability to do so by setting the `social.fediverse_creator`
to "@user@instance.example.com".

It has the prerequisite that the website the shared link is from is on
your allow list. To set this up in Mastodon:
1. "Preferences" on the right-hand side
2. "Public profile" on the left-hand side
3. "Versification" tab in the top bar
4. In the section "Author attribution", add all relevant domains to the
   field for "Websites allowed to credit you" (one per line)
5. "Save changes"

Note that this is not retroactive and failing to set up to the correct
domain in the allow list beforehand will not update old links in post
and might even be cached for a specific link on a specific instance.

Furthermore, the docs for this feature should include the prerequisite
and its pitfall of not setting up the allowed domain beforehand.

Also, this might also be interesting to do on an article basis. It is
not for me right now.
Copy link

sonarqubecloud bot commented Dec 3, 2024

@Syphdias
Copy link
Contributor Author

Syphdias commented Dec 3, 2024

A screenshot of what it adds. On the lower one I forgot to add the domain to the allow list, so it has no attribution. It worked for the upper one.
image

@David-Guillot
Copy link
Contributor

David-Guillot commented Dec 3, 2024

Duplicate of #1619 , which is currently blocked by an unresolved discussion.

adityatelange added a commit that referenced this pull request Mar 1, 2025
**Usage**

Site level:

params:
  social:
    fediverse_creator: "@username@mastodon.social"

Page (Overrides Site level value):

---
title: "My Page"
social:
  fediverse_creator: "@username@mastodon.social"
---


Closes #1618 #1642

---------

Co-authored-by: Aditya Telange <21258296+adityatelange@users.noreply.github.com>
@adityatelange
Copy link
Owner

#1619 is merged, thanks @Syphdias

Yurzi pushed a commit to Yurzi/hugo-PaperMod that referenced this pull request May 1, 2025
**Usage**

Site level:

params:
  social:
    fediverse_creator: "@username@mastodon.social"

Page (Overrides Site level value):

---
title: "My Page"
social:
  fediverse_creator: "@username@mastodon.social"
---


Closes adityatelange#1618 adityatelange#1642

---------

Co-authored-by: Aditya Telange <21258296+adityatelange@users.noreply.github.com>
vikas-0 added a commit to vikas-0/hugo-PaperMod that referenced this pull request Jul 19, 2025
* improve Toc

* i18n: adds Occitan language (adityatelange#1539)

* Update Turkish translation (adityatelange#1564)

Fix a typo and improve the translation

* Update bug report template to use GitHub's form schema

* Update enhancement issue template to use GitHub's form schema

* Add a social icon for Dzen (adityatelange#1599)

* Add a social icon for Wikipedia (adityatelange#1600)

* Use new 'Image render hook' template from Hugo. (adityatelange#1526)

* Pull render-image template from Hugo
https://github.com/gohugoio/hugo/commits/master/tpl/tplimpl/embedded/templates/_default/_markup/render-image.html

cloned at b893a09aa62c01a62e32b0effdb02e86b51d46d6

* Add loading=lazy attribute

adityatelange@c353447

* Update minimum required Hugo version to 0.125.7

* Update GitHub Actions workflows to use latest versions of dependencies

* [PATCH] hugolib: Deprecate site methods Author, Authors, and Social

cherry-picked from gohugoio/hugo@d4d49e0

* [PATCH] tpl/tplimpl: Remove trailing slash from void elements

cherry-picked from gohugoio/hugo@2f7df4b

* Update translations for he.yaml (adityatelange#1594)

* Replace thumbnailUrl with logo for json schema (adityatelange#1488)

thumbnailUrl is not part of Organization: https://schema.org/Organization

* JSON Schema uses 'image' for a Person and 'logo' for an Organization.

* [PATCH] tpl/tplimpl: Improve embedded opengraph template

Changes:

- Add tags per documentation
- Prefer site.Title over site.Params.title
- Plainify titles, tags, and descriptions
- Add fallback values for locale
- Fix pages related by series
- Improve readability

Co-authored-by: tomy0000000 <git@tomy.me>
Co-authored-by: sean-au <sean@powerfulwebdesign.com.au>

* Re-add support for cover images in OpenGraph

4a4d0c0

* [PATCH] tpl/tplimpl: Fix double-escaping in opengraph template

cherry-picked from gohugoio/hugo@fb51b69

* Update PaperMod version to v8+ in license.css and license.js

* Update LICENSE
Add current year 2025

* chore: remove obsolete polywork icon (adityatelange#1677)

The service has been shutdown as of 2025-01-31 and is no more

See https://deepnewz.com/startups/polywork-irish-startup-backed-stripe-collison-brothers-to-shut-down-560973fe

* Fix typos in github templates (adityatelange#1673)

* Fix typos in ISSUE_TEMPLATE

* Remove redundant space in pull request template

* Add social icon for Bookwyrm (adityatelange#1681)

* add farcaster logo to social icons (adityatelange#1686)

* Add social icon for Forgejo (adityatelange#1684)

* Improve style consistency of Bluesky SVG icon (adityatelange#1679)

* Add aria-label to theme toggle button for accessibility (adityatelange#1669)

* feat: add svg icon for linktree (adityatelange#1652)

* Add Whatsapp icon to social icons (adityatelange#1531)

Co-authored-by: Aditya Telange <21258296+adityatelange@users.noreply.github.com>

* Add social icon for Jamendo (adityatelange#1685)

Co-authored-by: PepeV_nRT <153303346+pepev-nrt@users.noreply.github.com>

* Add social icon for Nextcloud (adityatelange#1683)

* [FEATURE] new opengraph 'fediverse:creator' meta (adityatelange#1619)

**Usage**

Site level:

params:
  social:
    fediverse_creator: "@username@mastodon.social"

Page (Overrides Site level value):

---
title: "My Page"
social:
  fediverse_creator: "@username@mastodon.social"
---


Closes adityatelange#1618 adityatelange#1642

---------

Co-authored-by: Aditya Telange <21258296+adityatelange@users.noreply.github.com>

* Feat/improve cover image gen (adityatelange#1628)

* Refactor cover.html

* Refactor 2

* Refactor 3

* Refactor 4

* Refactor 5

* add comments and refactor more

* Refactor cover.html to use <figcaption> for image captions

* Add comments and manage whitespace

* Remove pointer-event prevention from entry-cover image

* Add demosite link to theme.toml (adityatelange#1724)

* Implement fixes for refreshed template system for Hugo v0.146.0+ (adityatelange#1726)

* Add rel=edit attribute to change suggestion link

* Add social icon for zcal (adityatelange#1746)

* Add Finnish language translation (adityatelange#1736)

* Fix breadcumb alignment in post-single

fixes: adityatelange#1732

---------

Co-authored-by: Aditya Telange <21258296+adityatelange@users.noreply.github.com>
Co-authored-by: ensag-dev <59049879+ensag-dev@users.noreply.github.com>
Co-authored-by: Berk Elyesa Yıldırım <beryesa@sayafe.org>
Co-authored-by: Geeqla <1140778+geeqla@users.noreply.github.com>
Co-authored-by: Joe Mooring <joe.mooring@veriphor.com>
Co-authored-by: Idan Hazan <as4ny0o@gmail.com>
Co-authored-by: Hong Xu <hong@topbug.net>
Co-authored-by: tomy0000000 <git@tomy.me>
Co-authored-by: sean-au <sean@powerfulwebdesign.com.au>
Co-authored-by: Morgan Roderick <20321+mroderick@users.noreply.github.com>
Co-authored-by: Tim Hsiung <yutingh@synology.com>
Co-authored-by: PepeV_nRT <153303346+pepev-nrt@users.noreply.github.com>
Co-authored-by: Chris Natoli <natolichris@gmail.com>
Co-authored-by: Davide Cultrera <6017063+dabikuru@users.noreply.github.com>
Co-authored-by: Colton Loftus <70598503+C-Loftus@users.noreply.github.com>
Co-authored-by: GiggleSquid <jack.connors@protonmail.com>
Co-authored-by: misdirectionmaster <63507708+misdirectionmaster@users.noreply.github.com>
Co-authored-by: Massimo Barbieri <massimo@fsfe.org>
Co-authored-by: David Guillot <david@guillot.me>
Co-authored-by: Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com>
Co-authored-by: Jake Bailey <5341706+jakebailey@users.noreply.github.com>
Co-authored-by: James <37276661+capjamesg@users.noreply.github.com>
Co-authored-by: Anthony Accioly <1591739+aaccioly@users.noreply.github.com>
Co-authored-by: Atte <47223277+addei@users.noreply.github.com>
Razzile pushed a commit to Razzile/hugo-PaperMod that referenced this pull request Aug 1, 2025
**Usage**

Site level:

params:
  social:
    fediverse_creator: "@username@mastodon.social"

Page (Overrides Site level value):

---
title: "My Page"
social:
  fediverse_creator: "@username@mastodon.social"
---


Closes adityatelange#1618 adityatelange#1642

---------

Co-authored-by: Aditya Telange <21258296+adityatelange@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants