diff options
Diffstat (limited to '23.md')
| -rw-r--r-- | 23.md | 16 |
1 files changed, 5 insertions, 11 deletions
| @@ -24,23 +24,17 @@ These articles are meant to be editable, so they should make use of the replacea | |||
| 24 | 24 | ||
| 25 | ### Linking | 25 | ### Linking |
| 26 | 26 | ||
| 27 | The article may be linked to using the NIP-19 `nref` code, which should contain both the public key of the author and the article identifier (the `"d"` tag) and some relays. With that information it is possible to locate the article. | 27 | The article may be linked to using the NIP-19 `nref` code along with the `"f"` tag (see NIP-33 and NIP-19). |
| 28 | 28 | ||
| 29 | ### References | 29 | ### References |
| 30 | 30 | ||
| 31 | Writing clients should implement support for parsing pasted NIP-19 `nref` identifiers and adding them automatically to the list of `.tags` of the event, replacing the actual content with a string like `#[tag_index]` in the same way as NIP-08 -- or, if the reference is in the form of a URL (for example, `[click here](nref...)`) then they should be replaced with just the tag number directly (for example, `[click here][0]`). | 31 | Writing clients should implement support for parsing pasted NIP-19 `nref` identifiers and adding them automatically to the list of `.tags` of the event, replacing the actual content with a string like `#[tag_index]` in the same way as NIP-08 -- or, if the reference is in the form of a URL (for example, `[click here](nref1...)`) then they should be replaced with just the tag number directly as if link with that name existed at the bottom of the Markdown (for example, `[click here][0]`). |
| 32 | 32 | ||
| 33 | Reader clients should parse the Markdown and replace these references with either internal links so the referenced events can be accessed directly, with NIP-21 `nostr:` links or direct links to web clients that will handle these references. | 33 | Reader clients should parse the Markdown and replace these references with either internal links so the referenced events can be accessed directly, with NIP-21 `nostr:nref1...` links or direct links to web clients that will handle these references. |
| 34 | 34 | ||
| 35 | The idea here is that having these tags is that reader clients can display a list of backreferences at the bottom when one article mentions another. | 35 | The idea here is that having these tags is that reader clients can display a list of backreferences at the bottom when one article mentions another. |
| 36 | 36 | ||
| 37 | ### `kind:1` interface | 37 | The same principles can be applied to `nevent1...`, `note1...`, `nprofile1...` or `npub1...`. |
| 38 | |||
| 39 | In case there is the desire for users or clients to share the written article on their "social" clients, a `kind:1` event must be used. | ||
| 40 | |||
| 41 | Since "social" clients aren't expected to understand this NIP, these notes should contain a URL like `nostr:nref1...` specifying the `nref1` code for the article, such that it can be rendered clickable and other users can use a different client than their "social" to read the article -- and also if their client handles both kinds of posts, their client may recognize the URL and handle it internally. | ||
| 42 | |||
| 43 | For clients that want to implement the ability for users to comment on these articles. `kind:1` notes should be used as the comments. They must be made in reply to another `kind:1` as above, such that other people on "social" clients can see the comments and get the context from the note above and load the article being commented on if they so desire. | ||
| 44 | 38 | ||
| 45 | ## Example of an event | 39 | ## Example of an event |
| 46 | 40 | ||
| @@ -67,7 +61,7 @@ Derived event: | |||
| 67 | ["t", "lorem"], | 61 | ["t", "lorem"], |
| 68 | ["t", "ipsum"], | 62 | ["t", "ipsum"], |
| 69 | ["e", "b3e392b11f5d4f28321cedd09303a748acfd0487aea5a7450b3481c60b6e4f87", "wss://relay.example.com"], | 63 | ["e", "b3e392b11f5d4f28321cedd09303a748acfd0487aea5a7450b3481c60b6e4f87", "wss://relay.example.com"], |
| 70 | ["e", "a695f6b60119d9521934a691347d9f78e8770b56da16bb255ee286ddf9fda919", "wss://relay.nostr.org"] | 64 | ["f", "a695f6b60119d9521934a691347d9f78e8770b56da16bb255ee286ddf9fda919:ipsum", "wss://relay.nostr.org"] |
| 71 | ], | 65 | ], |
| 72 | "pubkey": "...", | 66 | "pubkey": "...", |
| 73 | "id": "..." | 67 | "id": "..." |