fix: improve readme aesthetics and contents
badges, new text, more links
This commit is contained in:
parent
116c167e9a
commit
e40b2df69e
1 changed files with 60 additions and 30 deletions
90
README.rst
90
README.rst
|
@ -1,35 +1,52 @@
|
||||||
poezio
|
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
|
Homepage: https://poez.io
|
||||||
|
|
||||||
Forge Page: https://lab.louiz.org/poezio/poezio
|
Forge Page: https://lab.louiz.org/poezio/poezio
|
||||||
|
|
||||||
Poezio is a console Jabber/XMPP client. Its goal is to use anonymous
|
Poezio is a console Jabber/XMPP client. The initial goal was to provide a
|
||||||
connections to simply let the user join MultiUserChats. This way, the user
|
way of connecting easily to XMPP without the need for an account, exactly like
|
||||||
doesn't have to create a Jabber account, exactly like people are using
|
IRC clients. Poezio's commands are also designed to be close, if possible,
|
||||||
IRC. Poezio's commands are designed to be (if possible) like commonly
|
to the ones commonly used in IRC clients (weechat, irssi, etc).
|
||||||
used IRC clients (weechat, irssi, etc).
|
|
||||||
|
|
||||||
Since version 0.7, poezio can handle real Jabber accounts along with
|
For this reason, the experience is still centered around chatrooms, despite
|
||||||
roster and one-to-one conversations, making it a full-featured console
|
poezio being a full-featured XMPP client for a very long while.
|
||||||
Jabber client, but still MultiUserChats-centered.
|
|
||||||
In the future, poezio should implement at a 100% level all XEP related to
|
|
||||||
MUCs, especially XEP 0045.
|
|
||||||
|
|
||||||
Install
|
Install
|
||||||
=======
|
-------
|
||||||
|
|
||||||
You need python 3.5 or higher (preferably the latest) and the associated devel
|
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.7 or higher (preferably the latest) and the associated devel
|
||||||
package, to build C modules, and the slixmpp python library.
|
package, to build C modules, and the slixmpp python library.
|
||||||
You also need aiodns if you want SRV record support.
|
You also need aiodns if you want SRV record support.
|
||||||
|
|
||||||
Additionally, you’ll need sphinx to build the documentation pages.
|
The easiest way to have up-to-date dependencies and to be able to test
|
||||||
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
|
|
||||||
this developement version is to use the ``update.sh`` script that downloads
|
this developement version is to use the ``update.sh`` script that downloads
|
||||||
them, places them in the right directory, and builds the C module.
|
them, places them in the right directory, and builds the C module.
|
||||||
|
|
||||||
|
@ -39,7 +56,6 @@ You can then launch poezio with
|
||||||
|
|
||||||
$ ./launch.sh
|
$ ./launch.sh
|
||||||
|
|
||||||
you can now simply launch ``poezio``
|
|
||||||
|
|
||||||
You can edit the configuration file which is located in
|
You can edit the configuration file which is located in
|
||||||
``~/.config/poezio/poezio.cfg`` by default, and you will have to copy
|
``~/.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).
|
(we may implement it or not, but it’s always better to ask).
|
||||||
|
|
||||||
Authors
|
Authors
|
||||||
=======
|
-------
|
||||||
|
|
||||||
- Florent Le Coz (louiz’) <louiz@louiz.org> (developer)
|
- Florent Le Coz (louiz’) <louiz@louiz.org> (developer)
|
||||||
- Mathieu Pasquet (mathieui) <mathieui@mathieui.net> (developer)
|
- Mathieu Pasquet (mathieui) <mathieui@mathieui.net> (developer)
|
||||||
- Emmanuel Gil Peyrot (Link Mauve) <linkmauve@linkmauve.fr> (developer)
|
- Emmanuel Gil Peyrot (Link Mauve) <linkmauve@linkmauve.fr> (developer)
|
||||||
|
- Maxime Buquet (pep.) <pep@bouah.net> (developer)
|
||||||
|
|
||||||
Contact/support
|
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
|
Report a bug: https://lab.louiz.org/poezio/poezio/issues/new
|
||||||
|
|
||||||
License
|
License
|
||||||
=======
|
-------
|
||||||
|
|
||||||
Poezio is Free Software.
|
Poezio is Free Software.
|
||||||
(learn more: http://www.gnu.org/philosophy/free-sw.html)
|
(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.
|
Please read the COPYING file for details.
|
||||||
|
|
||||||
The artwork logo was made by Gaëtan Ribémont and released under
|
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
|
Hacking
|
||||||
=======
|
-------
|
||||||
|
|
||||||
If you want to contribute, you will be welcome on
|
If you want to contribute, you will be welcome on
|
||||||
`poezio@muc.poez.io <xmpp:poezio@muc.poez.io?join>`_ to announce your
|
`poezio@muc.poez.io <xmpp:poezio@muc.poez.io?join>`_ (`web chat`_)
|
||||||
ideas, what you are going to do, or to seek help if you have trouble
|
to announce your ideas, what you are going to do, or to seek help if you have
|
||||||
understanding some of the code.
|
trouble understanding some of the code.
|
||||||
|
|
||||||
The preferred way to submit changes is through a merge request on gitlab,
|
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
|
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
|
on github, or with a simple “please fetch my code on my personal git
|
||||||
repository hosted somewhere”
|
repository hosted somewhere”.
|
||||||
|
|
||||||
|
|
||||||
Thanks
|
Thanks
|
||||||
======
|
------
|
||||||
|
|
||||||
- People:
|
- People:
|
||||||
- Todd Eisenberger - Plugin system and OTR support
|
- Todd Eisenberger - Plugin system and OTR support
|
||||||
|
@ -124,3 +142,15 @@ Thanks
|
||||||
- FlashCode (weechat dev) - Useful advices on how to use ncurses efficiently
|
- FlashCode (weechat dev) - Useful advices on how to use ncurses efficiently
|
||||||
- And all the people using and testing poezio, and especially the ones present
|
- And all the people using and testing poezio, and especially the ones present
|
||||||
on the jabber chatroom doing bug reports and/or feature requests.
|
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
|
||||||
|
|
Loading…
Reference in a new issue