NIP-84: Highlights #501

pablof7z · 2023-05-05T20:30:38Z

This NIP introduces kind:9802 Highlight event as implemented by https://highlighter.com and https://habla.news

kind:9802 events are highlights of nostr events' content (e.g., kind:1 or kind:30023) or URLs, signaling content of importance to a user.

NIP text: https://github.com/pablof7z/nips/blob/highlights/84.md

@fiatjaf @verbiricha

staab

Do we already have a NIP for bookmarks (other than e lists)? This seems like a more granular form of the same thing. Fully support it though.

staab · 2023-05-06T15:41:23Z

84.md

+[ "range", 42, 84, "context" ] # highlight begins at index position 42 of the `context` tag's value
+```
+
+#### Non-text-based nostr events's highlights


damn it! 😂 thanks

You missed a chance to use the most amazing feature of the English language.

staab · 2023-05-06T15:44:59Z

84.md

+Clients MAY include a `context` tag, useful when the highlight is a subset of a paragraph and displaying the
+surrounding content might be beneficial to give context to the higlight.


Maybe clarify that this is a larger text excerpt of the original content, that wasn't immediately obvious to me. Or just refer to the example below.

Oh, yeah, good point

84.md

verbiricha · 2023-05-08T07:38:30Z

84.md

+#### Non-text-based nostr events's highlights
+
+A `kind:9802` event that tags a NIP-94 event which includes a video or audio file can use ranges to
+indicate the start/end time position in seconds.


Should we include a tag that marks the highlight as audio/video? It seems to me that audio/video refs could be r (youtube link), a (replaceable event representing a track) or e (NIP-94 audio/video file).

@pablof7z can you answer this?

84.md

verbiricha · 2023-05-08T07:43:30Z

Do we already have a NIP for bookmarks (other than e lists)? This seems like a more granular form of the same thing. Fully support it though.

Yes, NIP-51 categorized bookmark lists

84.md

staab · 2023-06-19T12:45:56Z

Next release of Coracle will have support for rendering highlights.

arthurfranca · 2023-06-19T13:28:21Z

84.md

+[ "p", "...", "author" ],
+[ "p", "...", "author" ],
+[ "p", "...", "editor" ],


Suggested change

[ "p", "...", "author" ],

[ "p", "...", "author" ],

[ "p", "...", "editor" ],

[ "p", "...", "<recommended relay URL>", "author" ],

[ "p", "...", "<recommended relay URL>", "author" ],

[ "p", "...", "<recommended relay URL>", "editor" ],

@pablof7z please ack here.

84.md

arthurfranca · 2023-06-19T13:45:05Z

84.md

+`a` or `e` tags should be used for nostr events and `r` tags for URLs.
+
+When tagging a URL, clients generating these events SHOULD do a best effort of cleaning the URL from trackers
+or obvious non-useful information from the query string.


Maybe it is a good idea to say that r urls should remove trailing slash so to ease querying.
So https://footstr.com/zapvertise/ -> https://footstr.com/zapvertise
And https://example.com/?article=987 -> https://example.com?article=987

And also normalize/sort the query strings, remove the # section, port names, prefer https?

Good idea. Remove port if 80 (http) or 443 (https) only.

fiatjaf · 2023-06-19T18:48:01Z

Is this a thing? I think I missed this NIP entirely.

pablof7z · 2023-06-19T18:49:45Z

Is this a thing? I think I missed this NIP entirely.

with support on amethyst, highlighter, habla and soon(TM) coracle 😉

fiatjaf · 2023-06-19T18:50:56Z

Is the NIP number a reference to some historical event?

pablof7z · 2023-06-19T18:51:56Z

Is the NIP number a reference to some historical event?

haha, no, this one is random and has no special meaning 😅

Co-authored-by: Alejandro <[email protected]>

84.md

Co-authored-by: Alejandro <[email protected]>

Co-authored-by: arthurfranca <[email protected]>

staab

I implemented support for this in Coracle yesterday, one thing I'd like to see is an alt/summary/comment tag that allows people to leave a note about the highlight (like a quote tweet). I left a note on highlighter about a highlight, but it didn't show up on the event itself.

sroertgen · 2023-09-22T12:01:55Z

Any specific reason why this is not merged yet?
@pablof7z @fiatjaf @verbiricha @arthurfranca

pablof7z · 2023-09-22T12:13:18Z

I need to update some stuff based on comments but totally forgot; I'll do it soon so we can merge

pablof7z · 2023-09-22T12:40:49Z

I implemented support for this in Coracle yesterday, one thing I'd like to see is an alt/summary/comment tag that allows people to leave a note about the highlight (like a quote tweet). I left a note on highlighter about a highlight, but it didn't show up on the event itself.

I do this with a kind 1 quoting the kind 9802.

alltheseas · 2024-06-25T13:33:56Z

@pablof7z

Does the spec allow for combination of a quote note (I believe this is 'q' tag x NIP-18) functionality + highlight functionality?

For instance, if I quote a few words from a note, does NIP-84 specify a way to combine quote note functionality that I can display with the highlight, so that I can add my commentary to the highlight?

Example mockup:

cc @ericholguin

pablof7z · 2024-06-25T23:05:54Z

quote highlights are kind:1s that q tag a kind:9802 and have a [ "k", "9802" ] tag. I added some examples in nevent1qgs04xzt6ldm9qhs0ctw0t58kf4z57umjzmjg6jywu0seadwtqqc75spz3mhxw309akx7cmpd35x7um58g6n2deh9uqzqh3mxdlhenu4u7ph2je80qkvplrlaysapjm2lp5uf35y9qkgml4vx7gzjg

highlights draft

0213f1e

staab approved these changes May 6, 2023

View reviewed changes

verbiricha reviewed May 8, 2023

View reviewed changes

84.md Outdated Show resolved Hide resolved

verbiricha reviewed May 8, 2023

View reviewed changes

84.md Show resolved Hide resolved

staab mentioned this pull request May 25, 2023

New specification for NIP-51 to accept curated articles (edited from NIP-24 proposition for topics) #492

Closed

arthurfranca suggested changes Jun 19, 2023

View reviewed changes

Update 84.md

008061e

Co-authored-by: Alejandro <[email protected]>

fiatjaf reviewed Jun 19, 2023

View reviewed changes

84.md Outdated Show resolved Hide resolved

fiatjaf and others added 4 commits June 19, 2023 16:10

Update 84.md

4514bd3

Update 84.md

d714a52

Co-authored-by: Alejandro <[email protected]>

Update 84.md

b0c44b9

Co-authored-by: arthurfranca <[email protected]>

Update 84.md

3ee0493

Co-authored-by: arthurfranca <[email protected]>

fiatjaf requested review from verbiricha, arthurfranca and staab June 19, 2023 19:40

fiatjaf approved these changes Jun 19, 2023

View reviewed changes

Merge branch 'master' into highlights

adedce7

staab approved these changes Jun 19, 2023

View reviewed changes

fiatjaf merged commit b128ad9 into nostr-protocol:master Nov 7, 2023

alltheseas mentioned this pull request Jun 25, 2024

highlight quote note damus-io/damus#2316

Closed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

NIP-84: Highlights #501

NIP-84: Highlights #501

pablof7z commented May 5, 2023 •

edited

Loading

staab left a comment

staab May 6, 2023

pablof7z May 6, 2023

fiatjaf May 8, 2023

staab May 6, 2023

pablof7z May 6, 2023

verbiricha May 8, 2023

fiatjaf Jun 19, 2023

verbiricha commented May 8, 2023

staab commented Jun 19, 2023

arthurfranca Jun 19, 2023

fiatjaf Jun 19, 2023

arthurfranca Jun 19, 2023

fiatjaf Jun 19, 2023 •

edited

Loading

arthurfranca Jun 19, 2023

fiatjaf commented Jun 19, 2023

pablof7z commented Jun 19, 2023

fiatjaf commented Jun 19, 2023

pablof7z commented Jun 19, 2023

staab left a comment

sroertgen commented Sep 22, 2023

pablof7z commented Sep 22, 2023

pablof7z commented Sep 22, 2023

alltheseas commented Jun 25, 2024 •

edited

Loading

pablof7z commented Jun 25, 2024

		Clients MAY include a `context` tag, useful when the highlight is a subset of a paragraph and displaying the
		surrounding content might be beneficial to give context to the higlight.

NIP-84: Highlights #501

NIP-84: Highlights #501

Conversation

pablof7z commented May 5, 2023 • edited Loading

staab left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

verbiricha commented May 8, 2023

staab commented Jun 19, 2023

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

fiatjaf Jun 19, 2023 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

fiatjaf commented Jun 19, 2023

pablof7z commented Jun 19, 2023

fiatjaf commented Jun 19, 2023

pablof7z commented Jun 19, 2023

staab left a comment

Choose a reason for hiding this comment

sroertgen commented Sep 22, 2023

pablof7z commented Sep 22, 2023

pablof7z commented Sep 22, 2023

alltheseas commented Jun 25, 2024 • edited Loading

pablof7z commented Jun 25, 2024

pablof7z commented May 5, 2023 •

edited

Loading

fiatjaf Jun 19, 2023 •

edited

Loading

alltheseas commented Jun 25, 2024 •

edited

Loading