mirrors/fep
1
0
Fork 0
mirror of https://codeberg.org/fediverse/fep.git synced 2026-08-05 19:55:46 +00:00
Code Packages Wiki Activity

fep-b2b8-preview-content (#592)

Browse Source 
Quick additional PR! Added `inReplyTo` and harmonized recommendations for URLs in the preview.

Reviewed-on: https://codeberg.org/fediverse/fep/pulls/592
Co-authored-by: Evan Prodromou <codeberg@evanprodromou.name>
Co-committed-by: Evan Prodromou <codeberg@evanprodromou.name>
This commit is contained in:
Evan Prodromou
2025-05-09 18:44:11 +00:00
committed by silverpill
parent db0f01dd7f
commit b2f9e045e9
1 changed files with 7 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
fep/b2b8/fep-b2b8.md
+7 -7
View File
@@ -148,12 +148,16 @@ Comments are usually `Note` objects, but can be other types of objects like `Art
This property provides the same functionality as the `comments` property in RSS 2.0.
### `inReplyTo`
If the text is a reply to another ActivityPub object, such as an `Article` or `Note`, the `inReplyTo` property can include a string with the URL of the object being replied to, or a JSON object representing that object.
If the text is a commentary on or review of a particular link on the Web, the `inReplyTo` property can include a `Link` object with a `href` property that is the URL of the linked resource.
### `attachment`
The [attachment](https://www.w3.org/TR/activitystreams-vocabulary/#dfn-attachment) property provides additional media that is part of the text. This can include images, video, audio, or other media. Consumers can use this property to pre-fetch media for display without needing to load and parse the full `content` property.
If the text is a commentary on or review of a particular link on the Web, the `attachment` property can include a `Link` object with a `href` property that is the URL of the linked resource.
### `tag`
The [tag](https://www.w3.org/TR/activitystreams-vocabulary/#dfn-tag) property provides additional metadata about the text. There are two important types of tags:
@@ -175,14 +179,10 @@ The [generator](https://www.w3.org/TR/activitystreams-vocabulary/#dfn-generator)
In AS2, the `preview` property provides an abbreviated version of the content of the object. Especially for microblogging applications, the `preview` property is a useful fallback for supporting unrecognized object types like `Article`.
For an article, the `preview` can be a `Note` that gives a well-formatted preview of the article content in its `content` property. For example, the `name`, `summary`, and a link to the `url` would be an appropriate representation.
For an article, the `preview` can be a `Note` that gives a well-formatted preview of the article content in its `content` property. For example, the `name`, `summary`, and a link to the `url` would be an appropriate representation. Additional navigation to other pages on the originating site, like category links, home page links, and other affordances like "favourite", "like", "bookmark" or other buttons should not be included.
The `content` property of the `preview` should include a minimal set of HTML elements, as described in [ActivityPub Primer HTML](https://www.w3.org/wiki/ActivityPub/Primer/HTML).
The HTML should only include an excerpt or summary of the full article text. Additional navigation to other pages on the originating site, like category links, home page links. Other affordances like "favourite", "like", "bookmark" or other buttons should not be included.
The `preview` property should not include a link to the full article with a "Read more..." link. The consumer should use the `url` property of the `Article` to link to the full article.
Metadata on the `Article` that applies equally to the preview, such as `attributedTo`, `published`, `updated`, and `tag` can be repeated in the `preview` property. The consumer should fall back to the `Article` properties if they are not present in the `preview`.
The `image` property of the `Article` may be included in the `preview` property as `attachment` items.