summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authormathieui <mathieui@mathieui.net>2021-04-17 15:50:24 +0200
committermathieui <mathieui@mathieui.net>2021-04-17 18:56:19 +0200
commite40b2df69e3f5b7ee80d48663fe4c0b2ebb98d7e (patch)
treea76592571a4be0d66e6910d9b2eb3286005562f5
parent116c167e9ac545aca978ced8afa3ba236ef5a60f (diff)
downloadpoezio-e40b2df69e3f5b7ee80d48663fe4c0b2ebb98d7e.tar.gz
poezio-e40b2df69e3f5b7ee80d48663fe4c0b2ebb98d7e.tar.bz2
poezio-e40b2df69e3f5b7ee80d48663fe4c0b2ebb98d7e.tar.xz
poezio-e40b2df69e3f5b7ee80d48663fe4c0b2ebb98d7e.zip
fix: improve readme aesthetics and contents
badges, new text, more links
-rw-r--r--README.rst90
1 files changed, 60 insertions, 30 deletions
diff --git a/README.rst b/README.rst
index 34c01b1f..3028c5f5 100644
--- a/README.rst
+++ b/README.rst
@@ -1,35 +1,52 @@
poezio
======
+.. image:: https://lab.louiz.org/poezio/poezio/-/raw/main/data/poezio_logo.svg
+ :alt: Poezio logo
+ :width: 200
+
+|pipeline| |python versions| |license|
+
+|discuss|
+
Homepage: https://poez.io
Forge Page: https://lab.louiz.org/poezio/poezio
-Poezio is a console Jabber/XMPP client. Its goal is to use anonymous
-connections to simply let the user join MultiUserChats. This way, the user
-doesn't have to create a Jabber account, exactly like people are using
-IRC. Poezio's commands are designed to be (if possible) like commonly
-used IRC clients (weechat, irssi, etc).
+Poezio is a console Jabber/XMPP client. The initial goal was to provide a
+way of connecting easily to XMPP without the need for an account, exactly like
+IRC clients. Poezio's commands are also designed to be close, if possible,
+to the ones commonly used in IRC clients (weechat, irssi, etc).
-Since version 0.7, poezio can handle real Jabber accounts along with
-roster and one-to-one conversations, making it a full-featured console
-Jabber client, but still MultiUserChats-centered.
-In the future, poezio should implement at a 100% level all XEP related to
-MUCs, especially XEP 0045.
+For this reason, the experience is still centered around chatrooms, despite
+poezio being a full-featured XMPP client for a very long while.
Install
-=======
+-------
+
+Packages
+~~~~~~~~
+
+The stable version of poezio is packaged in
+`a number of GNU/Linux (and OpenBSD) distributions <https://doc.poez.io/install.html#poezio-in-the-gnu-linux-distributions>`_.
+
+
+If it is not packaged in your distribution, you can run the
+`flatpak <https://flathub.org/apps/details/io.poez.Poezio>`_ or use pip
+to install the package from `Pypi <https://pypi.org/project/slixmpp/>`_.
+
+
+From git
+~~~~~~~~
+
+`Documentation <https://doc.poez.io/install.html#install-from-source>`_
-You need python 3.5 or higher (preferably the latest) and the associated devel
+
+You need python 3.7 or higher (preferably the latest) and the associated devel
package, to build C modules, and the slixmpp python library.
You also need aiodns if you want SRV record support.
-Additionally, you’ll need sphinx to build the documentation pages.
-To read the documentation without these dependancies just read the rst
-files in the doc/source/ directory or the generated documentation on the
-website.
-
-The simplest way to have up-to-date dependencies and to be able to test
+The easiest way to have up-to-date dependencies and to be able to test
this developement version is to use the ``update.sh`` script that downloads
them, places them in the right directory, and builds the C module.
@@ -39,7 +56,6 @@ You can then launch poezio with
$ ./launch.sh
-you can now simply launch ``poezio``
You can edit the configuration file which is located in
``~/.config/poezio/poezio.cfg`` by default, and you will have to copy
@@ -58,21 +74,23 @@ Please DO report any bug you encounter and ask for any feature you want
(we may implement it or not, but it’s always better to ask).
Authors
-=======
+-------
- Florent Le Coz (louiz’) <louiz@louiz.org> (developer)
- Mathieu Pasquet (mathieui) <mathieui@mathieui.net> (developer)
- Emmanuel Gil Peyrot (Link Mauve) <linkmauve@linkmauve.fr> (developer)
+- Maxime Buquet (pep.) <pep@bouah.net> (developer)
Contact/support
-===============
+---------------
-Jabber ChatRoom: `poezio@muc.poez.io <xmpp:poezio@muc.poez.io?join>`_
+Jabber chat room: `poezio@muc.poez.io <xmpp:poezio@muc.poez.io?join>`_
+(`web chat`_)
Report a bug: https://lab.louiz.org/poezio/poezio/issues/new
License
-=======
+-------
Poezio is Free Software.
(learn more: http://www.gnu.org/philosophy/free-sw.html)
@@ -81,25 +99,25 @@ Poezio is released under the zlib License.
Please read the COPYING file for details.
The artwork logo was made by Gaëtan Ribémont and released under
-the Creative Commons BY license (http://creativecommons.org/licenses/by/2.0/)
+the `Creative Commons BY license <http://creativecommons.org/licenses/by/2.0/>`_.
Hacking
-=======
+-------
If you want to contribute, you will be welcome on
-`poezio@muc.poez.io <xmpp:poezio@muc.poez.io?join>`_ to announce your
-ideas, what you are going to do, or to seek help if you have trouble
-understanding some of the code.
+`poezio@muc.poez.io <xmpp:poezio@muc.poez.io?join>`_ (`web chat`_)
+to announce your ideas, what you are going to do, or to seek help if you have
+trouble understanding some of the code.
The preferred way to submit changes is through a merge request on gitlab,
at https://lab.louiz.org/poezio/poezio, but we also accept contributions
on github, or with a simple “please fetch my code on my personal git
-repository hosted somewhere”
+repository hosted somewhere”.
Thanks
-======
+------
- People:
- Todd Eisenberger - Plugin system and OTR support
@@ -124,3 +142,15 @@ Thanks
- FlashCode (weechat dev) - Useful advices on how to use ncurses efficiently
- And all the people using and testing poezio, and especially the ones present
on the jabber chatroom doing bug reports and/or feature requests.
+
+
+.. |pipeline| image:: https://lab.louiz.org/poezio/poezio/badges/main/pipeline.svg
+
+.. |python versions| image:: https://img.shields.io/pypi/pyversions/poezio.svg
+
+.. |license| image:: https://img.shields.io/badge/license-zlib-blue.svg
+
+.. |discuss| image:: https://inverse.chat/badge.svg?room=poezio@muc.poez.io
+ :target: https://chat.jabberfr.org/converse.js/poezio@muc.poez.io
+
+.. _web chat: https://chat.jabberfr.org/converse.js/poezio@muc.poez.io