XEP-0277: 4. Navigation

[sjehuda]

3. Comments
   Juliet and Benvolio may want to discuss about latest Romeo's post. To enable this, Romeo's client MAY add a "atom:link" element to the PubSub item. The element MUST have "rel", "title" and "href" attributes, where "rel" MUST have the "replies" value; "title" MUST have the "comments" value; "href" MUST be an XMPP URI (see RFC 5122 [5] and RFC 3986 [6]).

https://xmpp.org/extensions/xep-0277.xml#comments

4. Navigation
   Romeo might want to relate several posts of a similar concern. To enable this, Romeo's client MAY add a "atom:link" element to the PubSub item. The element MUST have "rel", "title" and "href" attributes, where "rel" MUST have the "navigation" value; "title" MUST have the "index" or "previous" or "proceed" value; "href" MUST be an XMPP URI (see RFC 5122 [5] and RFC 3986 [6]).

https://xmpp.org/extensions/xep-0277.xml#navigation

[guusdk]

I don't quite understand this issue. Are you suggesting to add or replace the texts that you're quoting? Can you please explicitly state what the intended changes are (and provide a motivation)?

[sjehuda]

I want to add a new section between section three and the current section four.

Functionality

This part of the XEP-0277 specification would allow for publishing platforms to define navigation controls such as "index" (i.e. main), "next", and "previous", to navigate from post to post and over entire PEP or PubSub journals.

Examples

Among many possible uses, this would be useful to better organize information, by segregate longer articles into several shorter articles, albeit this can be done with tags, yet "next"' and "previous" navihation controls would make that segregation more obvious and accessible.

Another use would be to manage PEP or PubSub journals as traditional Gemini and HTTP sites, over XMPP, with the help of navigational directives.

It would also be useful for forum management over XMPP PubSub, instead of utilizing nodes of type "collection", provided that more navigational directives be defined.

Furthermore, we can also define more navigational rules (perhaps rel="navigation-toc" or rel="navigation" title="toc" or rel="navigation" title="batch-toc" or rel="navigation" title="set-toc") to add links for a table of contents.

Demonstration

I am currently realizing that mechanism over Atom Syndication Format document in a journal publishing platform https://journal.woodpeckersnest.eu/posts/2024-11-05-xmpp-as-the-internet/?xml which XSLT stylesheet realizes into navigation links "Previous" and "Proceed".

<link href="https://journal.woodpeckersnest.eu/posts/2025-05-05-the-garden-metaphor-of-worldwide-finance/"
      rel="navigation"
      title="previous"
      type="application/atom+xml"/>