Browse and create XHTML based sites generated from PubSub nodes.
Find a file
Schimon Jehudah, Adv. 694c8bb489 Set pathname /opml as a pathname for OPML;
Add a message to be displayed upon empty content;
Add more error handlings;
Fix error related to Markdown parsing;
Fix error related to Atom Syndication Format;
Thank you roughnecks.
2024-07-12 16:50:59 +03:00
css Set pathname /opml as a pathname for OPML; 2024-07-12 16:50:59 +03:00
data Add a dummy file 2024-07-11 16:53:42 +02:00
graphic Add file favicon.ico. 2024-07-09 18:17:18 +03:00
screenshot Add graphical previews (screenshots); 2024-07-09 16:54:37 +03:00
script Set pathname /opml as a pathname for OPML; 2024-07-12 16:50:59 +03:00
xsl Set pathname /opml as a pathname for OPML; 2024-07-12 16:50:59 +03:00
configuration.toml Add OPML support; 2024-07-12 15:39:17 +03:00
favicon.ico Add file favicon.ico. 2024-07-09 18:17:18 +03:00
LICENSE Initial commit 2024-07-08 10:57:51 +02:00
pubsub_to_atom.py Set pathname /opml as a pathname for OPML; 2024-07-12 16:50:59 +03:00
README.md Rename project to XMPP Journal Publisher; 2024-07-11 20:56:20 +03:00

XMPP Journal Publisher

Previously, XMPP PubSub To Atom ("XPTA").

XMPP Journal Publisher ("XJP") is a software that parses XMPP Pubsub Nodes and sends them as Atom Syndication Format or OPML over HTTP.

XJP generates Atom syndication feeds (RFC 4287) from XMPP PubSub nodes (XEP-0060).

XJP includes XSLT stylesheets that transforms PubSub nodes into static XHTML journal sites.

XJP was inspired from Tigase and was motivated by Movim.

Preview

berlin-xmpp-meetup let-s-talk-about-xmpp-tricks-with-conversations-author-daniel-gultsch-OqjaQh 59d860ab-d7c8-477c-bb4b-86924485cbbb selection

Motivation

XMPP Journal Publisher is a syndication project which makes journals and publications that are hosted on XMPP PubSub nodes, available from HTTP to both, XML news readers and even HTML browsers.

This means that instead of hosting a journal or publication site in the old fashion (i.e. HTML documents hosted on an HTTP server), one only has to have an HTTP server to operate XMPP Journal Publisher, and the rest of the content is delivered from an XMPP server (i.e. PubSub nodes).

The project also showcases the non-necessity of HTML, as it automatically generates valid XHTML pages by HTML browsers (client-side) from XSLT stylesheets.

Because XMPP Journal Publisher reads XMPP PubSub nodes, it is possible to view a complete set of node items, and even a single node item, which means, that a considered and carefully earnest use of XMPP Journal Publisher would save bandwidth and system overhead, which includes CPU, I/O and RAM usage.

Requirements

  • Python >= 3.5
  • fastapi
  • feedgenerator
  • lxml
  • slixmpp
  • tomllib
  • uvicorn

Installation

Debian-based Distro

# apt install python3 python3-fastapi python3-feedgenerator python3-lxml python3-slixmpp python3-tomli uvicorn

Download

Extract the source package to a directory that you have permission to run software.

$ git clone https://git.xmpp-it.net/sch/XJP
$ cd XJP/

Configure

Add account credentials to file configuration.toml.

Start

Execute XMPP Journal Publisher with one of the following commands:

$ python -m uvicorn pubsub_to_atom:app --reload
$ python -m uvicorn pubsub_to_atom:app --reload --host 127.0.0.1 --port 8000
$ uvicorn pubsub_to_atom:app --host 127.0.0.1 --port 8000
$ fastapi dev pubsub_to_atom.py

Usage

It is possible to view a complete node and even a single item, which means, that it is possible to save bandwidth and it further means that a considered and carefully earnest use of this software would save system overhead, which includes CPU, I/O and RAM usage.

Viewing PubSub

Suppose you have the following PubSub nodes and items.

Jabber ID Node Item
blog.jmp.chat urn:xmpp:microblog:0 launch-2023
edhelas%40movim.eu urn:xmpp:microblog:0 working-on-launching-the-movim-network-qPBzwc
goffi%40goffi.org urn:xmpp:microblog:0 libervia-v0-8-la-cecilia-BdQ4
news.movim.eu Phoronix
pubsub.movim.eu berlin-xmpp-meetup 7363a41d-1146-40b3-ac0f-8ee2559591a3
pubsub.movim.eu berlin-xmpp-meetup let-s-talk-about-the-xsf-and-possibly-other-things-6A8eV4
pubsub%40sure.im news

To view node items

http://127.0.0.1:8000/atom?pubsub=edhelas%40movim.eu&node=urn%3Axmpp%3Amicroblog%3A0
http://127.0.0.1:8000/atom?pubsub=news.movim.eu&node=Phoronix
http://127.0.0.1:8000/atom?pubsub=pubsub.movim.eu&node=berlin-xmpp-meetup
http://127.0.0.1:8000/atom?pubsub=pubsub%40sure.im&node=news

To view a node item

http://127.0.0.1:8000/atom?pubsub=blog.jmp.chat&node=urn%3Axmpp%3Amicroblog%3A0&item=launch-2023
http://127.0.0.1:8000/atom?pubsub=edhelas%40movim.eu&node=urn%3Axmpp%3Amicroblog%3A0&item=working-on-launching-the-movim-network-qPBzwc
http://127.0.0.1:8000/atom?pubsub=goffi%40goffi.org&node=urn%3Axmpp%3Amicroblog%3A0&item=libervia-v0-8-la-cecilia-BdQ4
http://127.0.0.1:8000/atom?pubsub=pubsub.movim.eu&node=berlin-xmpp-meetup&item=7363a41d-1146-40b3-ac0f-8ee2559591a3
http://127.0.0.1:8000/atom?pubsub=pubsub.movim.eu&node=berlin-xmpp-meetup&item=let-s-talk-about-the-xsf-and-possibly-other-things-6A8eV4

Supported XEPs

Author

Schimon Jehudah Zackary

License

CSS and XSLT stylesheets are licensed under the license MIT.

JS scripts are licensed under the license MIT.

Python code is licensed under the license AGPL-3.0 only.

Acknowledgement

Thank you to Mr. Peter Saint-Andre (stpeter) for manifesting Atom Over XMPP.

Thank you to Mr. Wojtek and Tigase for publicly exposing an implementation of PubSub as Syndication at Sure.IM as feeds.tigase.im.

Thank you to to Mr. Timothée Jaussoin (edhelas) who consistently and earnestly showcases the potential of PubSub as a publication platform with project Movim.

A special thank you to the gentlemen "d3x" and "cchianel" from IRC channel #python on irc.libera.chat for initial references concerning code, servers and FastAPI.

And an important thank you to Mr. Simone Canaletti (roughnecks) for testing and deploying XMPP Journal Publisher into production.

Similar Projects

  • AtomEntry and PubSubPublishViewImpl - Convert XMPP Pubsub Nodes to Atom Syndication Format and convey them over HTTP.

  • AtomToPubsub - A little client that parses Atom + RSS feeds and send them on XMPP Pubsub Nodes.