From af7f31e19b6c5157719fdc446754c0a637e700e3 Mon Sep 17 00:00:00 2001 From: sch Date: Wed, 10 Jul 2024 05:10:55 +0200 Subject: [PATCH] Improve wording --- README.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index e41d48d..0e4b270 100644 --- a/README.md +++ b/README.md @@ -15,14 +15,14 @@ This software was inspired from Tigase and was motivated by Movim. ## Motivation -PubSubToAtom is a syndication project which makes journals and publications that are hosted on XMPP PubSub nodes, available +PubSub To Atom 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 PubSubToAtom, and the rest of the content is delivered from an XMPP server (i.e. PubSub nodes). +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 PubSub To Atom, 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 XSLT stylesheets from client-side. +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 PubSubToAtom 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 PubSubToAtom would save bandwidth and system overhead, which includes CPU, I/O and RAM usage. +Because PubSub To Atom 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 PubSub To Atom would save bandwidth and system overhead, which includes CPU, I/O and RAM usage. ## Requirements @@ -44,8 +44,7 @@ Because PubSubToAtom reads XMPP PubSub nodes, it is possible to view a complete ### Download -Extract the source package to a directory that you have permission to run -software. +Extract the source package to a directory that you have permission to run software. ```shell $ git clone https://git.xmpp-it.net/sch/PubSubToAtom @@ -58,7 +57,7 @@ Add account credentials to file `configuration.toml`. ### Start -Execute PubSubToAtom with one of the following commands: +Execute PubSub To Atom with one of the following commands: ```shell $ python -m uvicorn pubsub_to_atom:app --reload @@ -73,9 +72,9 @@ It is possible to view a complete node and even a single item, which means, that ### Viewing PubSub -Suppose you have the following nodes and items. +Suppose you have the following PubSub nodes and items. -|PubSub |Node |Item | +|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 | @@ -83,6 +82,7 @@ Suppose you have the following nodes and items. |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 @@ -90,6 +90,7 @@ Suppose you have the following nodes and 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 @@ -124,7 +125,7 @@ Thank you to to Mr. Timothée Jaussoin ([edhelas](https://edhelas.movim.eu/)) wh 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](https://blog.woodpeckersnest.space/)) for testing and deploying PubSubToAtom into production. +And an important thank you to Mr. Simone Canaletti ([roughnecks](https://blog.woodpeckersnest.space/)) for testing and deploying PubSub To Atom into production. ## Similar Projects