Skip to content

Navigation Menu

Sign in
Appearance settings
Sign up
Appearance settings

Commit 64161be

Browse filesBrowse the repository at this point in the historyBrowse files
minor symfony#65620 [Notifier][Bluesky] Document the automatic rich text detection (Amoifr)
This PR was merged into the 8.2 branch. Discussion ---------- [Notifier][Bluesky] Document the automatic rich text detection | Q | A | ------------- | --- | Branch? | 8.2 | Bug fix? | no | New feature? | no | Deprecations? | no | Issues | Fix symfony/symfony-docs#22564 | License | MIT Documents the rich text facets in the README of the Bluesky bridge, as asked in symfony/symfony-docs#22564: the new hashtag facets of symfony#59784 (detection rules, fullwidth marker, lexicon limits) together with the pre-existing mention and URL detection, which was not documented either. `notifier.rst` links to this README, so nothing to add on the docs side. Commits ------- d47d3b6 [Notifier][Bluesky] Document the automatic rich text detection
2 parents 53bf627 + d47d3b6 commit 64161be
Copy full SHA for 64161be

1 file changed

+21Lines changed: 21 additions & 0 deletions

File tree

Expand file treeCollapse file tree
Open diff view settings
Filter options
  • src/Symfony/Component/Notifier/Bridge/Bluesky
Expand file treeCollapse file tree
Open diff view settings
Collapse file

‎src/Symfony/Component/Notifier/Bridge/Bluesky/README.md‎

Copy file name to clipboardExpand all lines: src/Symfony/Component/Notifier/Bridge/Bluesky/README.md
+21Lines changed: 21 additions & 0 deletions
  • Display the source diff
  • Display the rich diff
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,27 @@ $message->options($options);
3434
$chatter->send($message);
3535
```
3636

37+
Automatic Rich Text Detection
38+
-----------------------------
39+
40+
Bluesky posts have no markup: rich text is declared through "facets", byte
41+
ranges of the text that clients render as links. The transport detects them
42+
automatically in the message, no option is needed:
43+
44+
* mentions, e.g. `@nyholm.bsky.social` (the handle must resolve on the
45+
configured endpoint);
46+
* URLs, e.g. `https://symfony.com`;
47+
* hashtags, e.g. `#symfony` (also with the fullwidth `` marker), which makes
48+
them clickable and attaches the post to the tag feed.
49+
50+
A hashtag needs at least one character that is neither a digit nor
51+
punctuation (so `#123` is left as plain text), trailing punctuation is not
52+
part of the tag, and a `#` inside a URL is part of the link, not a tag.
53+
Following the lexicon limits, a tag longer than 64 graphemes or 640 bytes is
54+
left as plain text instead of making the whole post fail.
55+
56+
Hashtag facets require version 8.2 or higher of the bridge.
57+
3758
Sponsor
3859
-------
3960

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.