diff options
Diffstat (limited to '84.md')
| -rw-r--r-- | 84.md | 37 |
1 files changed, 37 insertions, 0 deletions
| @@ -0,0 +1,37 @@ | |||
| 1 | NIP-84 | ||
| 2 | ====== | ||
| 3 | |||
| 4 | Highlights | ||
| 5 | ---------- | ||
| 6 | |||
| 7 | `draft` `optional` `author:pablof7z` | ||
| 8 | |||
| 9 | This NIP defines `kind:9802`, a "highlight" event, to signal content a user finds valuable. | ||
| 10 | |||
| 11 | ## Format | ||
| 12 | The `.content` of these events is the highlighted portion of the text. | ||
| 13 | |||
| 14 | `.content` might be empty for highlights of non-text based media (e.g. NIP-94 audio/video). | ||
| 15 | |||
| 16 | ### References | ||
| 17 | Events SHOULD tag the source of the highlight, whether nostr-native or not. | ||
| 18 | `a` or `e` tags should be used for nostr events and `r` tags for URLs. | ||
| 19 | |||
| 20 | When tagging a URL, clients generating these events SHOULD do a best effort of cleaning the URL from trackers | ||
| 21 | or obvious non-useful information from the query string. | ||
| 22 | |||
| 23 | ### Attribution | ||
| 24 | Clients MAY include one or more `p` tags, tagging the original authors of the material being highlighted; this is particularly | ||
| 25 | useful when highlighting non-nostr content for which the client might be able to get a nostr pubkey somehow | ||
| 26 | (e.g. prompting the user or reading a `<meta name="nostr:nprofile1..." />` tag on the document). A role MAY be included as the | ||
| 27 | last value of the tag. | ||
| 28 | |||
| 29 | ```json | ||
| 30 | [ "p", "<pubkey-hex>", "<relay-url>", "author" ], | ||
| 31 | [ "p", "<pubkey-hex>", "<relay-url>", "author" ], | ||
| 32 | [ "p", "<pubkey-hex>", "<relay-url>", "editor" ], | ||
| 33 | ``` | ||
| 34 | |||
| 35 | ### Context | ||
| 36 | Clients MAY include a `context` tag, useful when the highlight is a subset of a paragraph and displaying the | ||
| 37 | surrounding content might be beneficial to give context to the higlight. | ||