libervia-backend: README annotate

annotate README @ 2307:8fa7edd0da24

plugin Pubsub Hook: first draft: This new plugin allow to attach an external action to a Pubsub event (i.e. notification). Hook can be persitent accross restarts, or temporary (will be deleted on profile disconnection). Only Python files are handled for now. In the future, it may make sense to move hooks in a generic plugin which could be used by ad-hoc commands, messages, pubsub, etc.

author	Goffi <goffi@goffi.org>
date	Wed, 05 Jul 2017 15:05:47 +0200
parents	4f189bd1d9ed
children	8b37a62336c3

rev	line source
1997 3c92c0b977b5 version update (0.6.1) Goffi <goffi@goffi.org> parents: 1935 diff changeset	1 SàT v0.6.1
1766 d17772b0fe22 copyright update Goffi <goffi@goffi.org> parents: 1718 diff changeset	2 (c) Jérôme Poisson aka Goffi 2008-2016
d17772b0fe22 copyright update Goffi <goffi@goffi.org> parents: 1718 diff changeset	3 (c) Adrien Cossa aka Souliane 2013-2016
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	4
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	5 SàT is a XMPP (Jabber) client.
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	6
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	7
874 1f5ad976fa32 some typos fixes in the README files souliane <souliane@mailoo.org> parents: 871 diff changeset	8 LICENCE
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	9
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	10 SàT is free software: you can redistribute it and/or modify
480 2a072735e459 Licence modification: the full project is now under AGPL v3+ instead of GPL v3+ Goffi <goffi@goffi.org> parents: 459 diff changeset	11 it under the terms of the GNU Affero General Public License as published by
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	12 the Free Software Foundation, either version 3 of the License, or
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	13 (at your option) any later version.
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	14
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	15 SàT is distributed in the hope that it will be useful,
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	16 but WITHOUT ANY WARRANTY; without even the implied warranty of
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
480 2a072735e459 Licence modification: the full project is now under AGPL v3+ instead of GPL v3+ Goffi <goffi@goffi.org> parents: 459 diff changeset	18 GNU Affero General Public License for more details.
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	19
480 2a072735e459 Licence modification: the full project is now under AGPL v3+ instead of GPL v3+ Goffi <goffi@goffi.org> parents: 459 diff changeset	20 You should have received a copy of the GNU Affero General Public License
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	21 along with SàT. If not, see <http://www.gnu.org/licenses/>.
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	22
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	23
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	24 ABOUT
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	25
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	26 SàT is a XMPP (Jabber) client, made on a daemon/frontends architecture. Its aim is not only to be an instant messaging client: SàT manage microblogging, file transfer, rich text edition, piping over XMPP, XMPP remote, etc.
874 1f5ad976fa32 some typos fixes in the README files souliane <souliane@mailoo.org> parents: 871 diff changeset	27 In addition, SàT has been built with ethic in mind, a social contract show the main lines (see CONTRAT_SOCIAL or CONTRAT_SOCIAL_en). We have a lot of debates about the right way to do things, more on a social way than on a technical way (but consider technique too).
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	28
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	29 For the moment, the frontends are:
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	30
2104 4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	31 * primitivus: a console interface client, for terminal lovers
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	32 * jp: the powerful command line toolkit.
2104 4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	33 * libervia: the web frontend. It's in a different package, check libervia on the wiki: https://wiki.goffi.org/wiki/Libervia
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	34 * cagou: the desktop/mobile frontend. It's in a different package
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	35 * bellaciao: a Qt frontend at an early development stage (development currently paused)
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	36
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	37 other frontends planed in the near future:
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	38
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	39 * mobile frontends, fuse frontend, etc.
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	40
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	41
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	42 HOW TO USE IT ?
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	43
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	44 For installation instructions, please read the file "INSTALL". Note that SàT is available in several GNU/Linux distributions
238 83d2bc0abf2a version, README, CHANGELOG and INSTALL updates Goffi <goffi@goffi.org> parents: 228 diff changeset	45
2104 4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	46 A wiki is available online (https://wiki.goffi.org), in French and English so far (we would appreciate any help for other languages). You can also have a look at the bottom of this files (in contact section) for other available websites.
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	47
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	48
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	49 MISC
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	50
626 190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	51 To use SàT, you need to have D-Bus daemon launched (http://www.freedesktop.org/wiki/Software/dbus/). If you use X Window, it should already be launched. If your are on a terminal environment without X11 (e.g. on a server) you may have to launch it. You can launch a daemon using the following command:
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	52 $ eval `dbus-launch --sh-syntax`
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	53
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	54 Be careful to use the same environment variables if you start a new session.
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	55
874 1f5ad976fa32 some typos fixes in the README files souliane <souliane@mailoo.org> parents: 871 diff changeset	56 I personally use the following script to do that automatically:
626 190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	57
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	58 --- /usr/local/bin/dbus-launch.sh ---
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	59 #!/bin/sh
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	60
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	61 DBUS_PATH="/tmp/.dbus.`whoami`"
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	62
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	63 if [ ! -e $DBUS_PATH ]; then
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	64 dbus-launch --sh-syntax > $DBUS_PATH
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	65 chmod 400 $DBUS_PATH
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	66 fi
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	67
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	68 cat $DBUS_PATH
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	69 --- end of /usr/local/bin/dbus-launch.sh ---
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	70
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	71 You can launch this script by putting at the end of your .zshrc (or whatever you're using):
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	72 eval `/usr/local/bin/dbus-launch.sh`
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	73
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	74 --
190ccc6dc36c doc: added instructions to launch D-Bus on a terminal environment, as requested in bug 27. Goffi <goffi@goffi.org> parents: 614 diff changeset	75
587 952322b1d490 Remove trailing whitespaces. Emmanuel Gil Peyrot <linkmauve@linkmauve.fr> parents: 581 diff changeset	76 You can find Primitivus shortcuts on the wiki:
2104 4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	77 https://wiki.goffi.org/wiki/Primitivus
348 8ff113e2abcb updated README and CHANGELOG Goffi <goffi@goffi.org> parents: 322 diff changeset	78
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	79 --
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	80
2104 4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	81 SàT is the acronym (yes another one :( ) in tribute to the song Salut à Toi from the Bérurier Noir band and it means "hi to you" (which seems appropriate for a communication software). If you want to listen to the song, we also recommend the excellent cover from Les Ogres de Barback.
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	82 jp stands for "Jabber coPy" or "JumP", and was choosen for its similarity with "cp" and short name.
1201 62135e3ca7ff misc: README typos fixes Matteo Cypriani <mcy@lm7.fr> parents: 1192 diff changeset	83 Primitivus is based on Urwid, and, according to their FAQ, "ur" is a German prefix for "ancestral or primal" (primitivus is a latin word).
2104 4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	84 Libervia is made from "Liber" (libre) and via (road, path). It could be understood as the libre road, or the path to freedom.
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	85 Cagou is the name of a beautiful bird (who bark and can't fly) from New-Caledonia, and it's also a wink to Kivy, the framework used.
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	86
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	87
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	88 CREDIT
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	89
181 a566f654929e README update: Goffi <goffi@goffi.org> parents: 57 diff changeset	90 A big big thank to the authors/contributors of...
a566f654929e README update: Goffi <goffi@goffi.org> parents: 57 diff changeset	91
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	92 proxy65:
874 1f5ad976fa32 some typos fixes in the README files souliane <souliane@mailoo.org> parents: 871 diff changeset	93 SàT (plugin_xep_0065) use nearly all the code from proxy65 (http://code.google.com/p/proxy65/) which was coded by Dave Smith (2002-2004) and maintained by Fabio Forno (2007-2008).
1157 c4b62e6b7377 add licence information for otr.js and dependencies souliane <souliane@mailoo.org> parents: 900 diff changeset	94 As the original MIT licence allows, the code is reused and sub-licenced until GPL v3 to follow the rest of the code.
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	95
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	96 progressbar:
181 a566f654929e README update: Goffi <goffi@goffi.org> parents: 57 diff changeset	97 SàT (jp) use ProgressBar (http://pypi.python.org/pypi/progressbar/2.2), a class coded by Nilton Volpato which allow the textual representation of progression.
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	98
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	99 twisted:
348 8ff113e2abcb updated README and CHANGELOG Goffi <goffi@goffi.org> parents: 322 diff changeset	100 SàT is heavily based on the twisted framework (http://twistedmatrix.com/trac/), a very great tool which offer a lot of protocols management. There are too many contributors to name them here, so take a look on the website :).
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	101
24 61124cb82fb7 Updated README and licenses (for images), added installation instructions. Goffi <goffi@goffi.org> parents: 0 diff changeset	102 wokkel:
61124cb82fb7 Updated README and licenses (for images), added installation instructions. Goffi <goffi@goffi.org> parents: 0 diff changeset	103 SàT use a library with high level enhancements on top of twisted, which is called wokkel (http://wokkel.ik.nu). Lot of thanks to Ralph Meijer and all other contributors.
61124cb82fb7 Updated README and licenses (for images), added installation instructions. Goffi <goffi@goffi.org> parents: 0 diff changeset	104
181 a566f654929e README update: Goffi <goffi@goffi.org> parents: 57 diff changeset	105 Urwid:
a566f654929e README update: Goffi <goffi@goffi.org> parents: 57 diff changeset	106 Primitivus is based on Urwid (http://excess.org/urwid/) which saved me a lot of time. It's really a great library to easily make a sophisticated interface.
24 61124cb82fb7 Updated README and licenses (for images), added installation instructions. Goffi <goffi@goffi.org> parents: 0 diff changeset	107
348 8ff113e2abcb updated README and CHANGELOG Goffi <goffi@goffi.org> parents: 322 diff changeset	108 Pyjamas:
874 1f5ad976fa32 some typos fixes in the README files souliane <souliane@mailoo.org> parents: 871 diff changeset	109 Libervia is built with a Pyjamas (http://pyjs.org), a Google Web Toolkit port for python, including Python to Javascript compiler, and Pyjamas Desktop which allow to execute the same application on the desktop or through a browser. It's really an amazing tool.
348 8ff113e2abcb updated README and CHANGELOG Goffi <goffi@goffi.org> parents: 322 diff changeset	110
2104 4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	111 Kivy and its linked tools (python-for-android, buildozer, plyer, pyjnius):
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	112 Kivy and linked tools (https://kivy.org) are used to build Cagou frontend, and to port it on several platforms. Excellent pieces of software, well thought,
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	113
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	114 Kivy garden:
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	115 in addition to Kivy itself, extension from the garden are used:
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	116 - contextmenu: used to display main and context menus
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	117
1541 685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	118 lxml(http://lxml.de/):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	119 this powerful and efficient XML parsing module is used sometimes to replace Twisted internal tools: its API is handy, and it have some features like evil content cleaning.
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	120
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	121 pillow(https://python-pillow.github.io/):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	122 This image manipulation module is used for avatars
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	123
348 8ff113e2abcb updated README and CHANGELOG Goffi <goffi@goffi.org> parents: 322 diff changeset	124 txJSON-RPC:
8ff113e2abcb updated README and CHANGELOG Goffi <goffi@goffi.org> parents: 322 diff changeset	125 Libervia use txJSON-RPC (https://launchpad.net/txjsonrpc), a twisted library to communicate with the browser's javascript throught JSON-RPC
8ff113e2abcb updated README and CHANGELOG Goffi <goffi@goffi.org> parents: 322 diff changeset	126
578 28331ecf0a65 misc: README cleaning + added Mutagen to credits Goffi <goffi@goffi.org> parents: 576 diff changeset	127 Mutagen:
1541 685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	128 Mutagen (https://bitbucket.org/lazka/mutagen) is an audio metadata handling library, it's used by the radiocol plugin.
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	129
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	130 Python OTR (http://python-otr.pentabarf.de), PyCrypto (https://www.dlitz.net/software/pycrypto) and pyOpenSSL(https://github.com/pyca/pyopenssl):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	131 Used for cryptography
578 28331ecf0a65 misc: README cleaning + added Mutagen to credits Goffi <goffi@goffi.org> parents: 576 diff changeset	132
1157 c4b62e6b7377 add licence information for otr.js and dependencies souliane <souliane@mailoo.org> parents: 900 diff changeset	133 otr.js and its dependencies Big Integer Library, CryptoJS, EventEmitter:
c4b62e6b7377 add licence information for otr.js and dependencies souliane <souliane@mailoo.org> parents: 900 diff changeset	134 Libervia frontend uses otr.js and its dependencies:
c4b62e6b7377 add licence information for otr.js and dependencies souliane <souliane@mailoo.org> parents: 900 diff changeset	135 - otr.js was coded by Arlo Breault (2014) and is released under the Mozilla Public License Version 2.0
c4b62e6b7377 add licence information for otr.js and dependencies souliane <souliane@mailoo.org> parents: 900 diff changeset	136 - Big Integer Library was coded by Leemon Baird (2000-2013) and is in the public domain
c4b62e6b7377 add licence information for otr.js and dependencies souliane <souliane@mailoo.org> parents: 900 diff changeset	137 - CryptoJS was coded by Jeff Mott (2009-2013) and is released under the MIT licence
c4b62e6b7377 add licence information for otr.js and dependencies souliane <souliane@mailoo.org> parents: 900 diff changeset	138 - EventEmitter was coded by Oliver Caldwell (2011-2013) and is released under the MIT licence
c4b62e6b7377 add licence information for otr.js and dependencies souliane <souliane@mailoo.org> parents: 900 diff changeset	139 As the original licences allow, the code is reused and sub-licenced until GPL v3 to follow the rest of the code.
c4b62e6b7377 add licence information for otr.js and dependencies souliane <souliane@mailoo.org> parents: 900 diff changeset	140
1541 685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	141 mardown (https://pythonhosted.org/Markdown/) and html2text (https://pypi.python.org/pypi/html2text/2015.6.21):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	142 both are used for syntaxes conversions
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	143
1717 77a010f1f8cb README and README4PACKAGERS: add Jinja2 to the dependencies list souliane <souliane@mailoo.org> parents: 1561 diff changeset	144 Jinja2 (http://jinja.pocoo.org/):
77a010f1f8cb README and README4PACKAGERS: add Jinja2 to the dependencies list souliane <souliane@mailoo.org> parents: 1561 diff changeset	145 a poweful template engine for Python that we use for designing Libervia's static blog pages
77a010f1f8cb README and README4PACKAGERS: add Jinja2 to the dependencies list souliane <souliane@mailoo.org> parents: 1561 diff changeset	146
1541 685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	147 miniupnp (http://miniupnp.free.fr/):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	148 this UPnP-IGD implementation is used to facilitate P2P sessions
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	149
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	150 netifaces (https://pypi.python.org/pypi/netifaces):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	151 when available, this module is used to detect local IPs
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	152
1176 bc3cdf770328 README: redirect media credits to sat_media repository (the pictures are no more hosted here) souliane <souliane@mailoo.org> parents: 1157 diff changeset	153 pictures found in the sat_media repository and used by SàT and Libervia:
bc3cdf770328 README: redirect media credits to sat_media repository (the pictures are no more hosted here) souliane <souliane@mailoo.org> parents: 1157 diff changeset	154 Please read the credits and licence information that are given in the README and COPYING files for each work: http://repos.goffi.org/sat_media/file
181 a566f654929e README update: Goffi <goffi@goffi.org> parents: 57 diff changeset	155
a566f654929e README update: Goffi <goffi@goffi.org> parents: 57 diff changeset	156 the powerfull ImageMagick (http://www.imagemagick.org/) is used by the script written to split the previously named picture.
a566f654929e README update: Goffi <goffi@goffi.org> parents: 57 diff changeset	157
1541 685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	158 PyXDF (http://freedesktop.org/wiki/Software/pyxdg):
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	159 Used to follow FreeDesktop XDG standards
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	160
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	161 A special thank to people working on XMPP standards, libre standards are the way to go !
685fad1c18e4 README, README4PACKAGERS: some update about third party modules. Goffi <goffi@goffi.org> parents: 1396 diff changeset	162
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	163 and the others:
2104 4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	164 and of course, nothing would be possible without Python (http://www.python.org/), GNU and the Free Software Foundation (http://www.gnu.org, http://www.fsf.org/), the Linux Kernel (http://www.kernel.org/), and the coder of the tools we use like Vim (http://www.vim.org/), Mercurial (http://www.selenic.com/mercurial/wiki/), or all the KDE stuff (http://www.kde.org/ and of course http://amarok.kde.org/), and also XFCE (http://www.xfce.org), etc. Thanks thanks thanks, thanks to everybody in the Free (Libre) chain for making a part of this.
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	165
2104 4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	166 If we forgot any credit (and we probably have), please contact us (mail below) to fix it.
24 61124cb82fb7 Updated README and licenses (for images), added installation instructions. Goffi <goffi@goffi.org> parents: 0 diff changeset	167
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	168
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	169 CONTRIBUTORS
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	170
482 e0d1eed4a46b misc: updated README with contributors Goffi <goffi@goffi.org> parents: 480 diff changeset	171 Salut à Toi has received contributions from:
e0d1eed4a46b misc: updated README with contributors Goffi <goffi@goffi.org> parents: 480 diff changeset	172
1201 62135e3ca7ff misc: README typos fixes Matteo Cypriani <mcy@lm7.fr> parents: 1192 diff changeset	173 - Adrien Vigneron <adrienvigneron@mailoo.org>: huge work on Libervia's CSS, SàT Logo (the mascot is his work), and Quiz game graphics. He's friendly and talented, his work is really appreciated.
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	174
1201 62135e3ca7ff misc: README typos fixes Matteo Cypriani <mcy@lm7.fr> parents: 1192 diff changeset	175 - Xavier Maillard <xavier@maillard.im>: bugs fixes. He's following the project for a while, maybe a future frontend contributor?
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	176
816 4429bd7d5efb misc (README): updated Link Mauve and Dal contributions, moved Souliane as a main contributor Goffi <goffi@goffi.org> parents: 811 diff changeset	177 - Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>: bugs fixes, Libervia's notification, Libervia as a twisted application plugin. A guy always around XMPP projects, he plan to work on a non D-Bus bridge.
482 e0d1eed4a46b misc: updated README with contributors Goffi <goffi@goffi.org> parents: 480 diff changeset	178
1201 62135e3ca7ff misc: README typos fixes Matteo Cypriani <mcy@lm7.fr> parents: 1192 diff changeset	179 - Matthieu Rakotojaona <matthieu.rakotojaona@gmail.com>: English translation of the social contract. A great quality translation!
482 e0d1eed4a46b misc: updated README with contributors Goffi <goffi@goffi.org> parents: 480 diff changeset	180
1201 62135e3ca7ff misc: README typos fixes Matteo Cypriani <mcy@lm7.fr> parents: 1192 diff changeset	181 - Thomas Preud'homme <robotux@debian.org>: bugs fixes. He's also one of the co-maintainer of the Debian package.
614 bef0f893482f misc: added Thomas Preud'homme to contributors + a thanks message to maintainers =) Goffi <goffi@goffi.org> parents: 587 diff changeset	182
1201 62135e3ca7ff misc: README typos fixes Matteo Cypriani <mcy@lm7.fr> parents: 1192 diff changeset	183 - Dal <kedals0@gmail.com>: profiles management, argparse refactoring in jp.
658 e26134122ed7 misc: added Dal to contributors Goffi <goffi@goffi.org> parents: 640 diff changeset	184
1204 2ee0cd57144e misc: added Olly Betts to contributors + various fixed for Matteo Cypriani Goffi <goffi@goffi.org> parents: 1203 diff changeset	185 - Matteo Cypriani <mcy@lm7.fr>: jp's mainloop update + doc improvements + various fixes. He's also the other co-maintainer of the Debian package.
2ee0cd57144e misc: added Olly Betts to contributors + various fixed for Matteo Cypriani Goffi <goffi@goffi.org> parents: 1203 diff changeset	186
2006 0ddf3edf643a added Chteufleur in contributors in README Goffi <goffi@goffi.org> parents: 1997 diff changeset	187 - Olly Betts <olly@survex.com>: icon fix in Wix [N.B: Wix has since been removed]
0ddf3edf643a added Chteufleur in contributors in README Goffi <goffi@goffi.org> parents: 1997 diff changeset	188
2025 43516c915ca6 misc: updated Chteufleur contributions in README Goffi <goffi@goffi.org> parents: 2006 diff changeset	189 - Geoffrey Pouzet <chteufleur@kingpenguin.tk>: XEP-0070 and XEP-0184 implementations
900 21681070f913 misc: added Naha to README Goffi <goffi@goffi.org> parents: 887 diff changeset	190
482 e0d1eed4a46b misc: updated README with contributors Goffi <goffi@goffi.org> parents: 480 diff changeset	191 Many thanks to them.
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	192
1201 62135e3ca7ff misc: README typos fixes Matteo Cypriani <mcy@lm7.fr> parents: 1192 diff changeset	193 A big thanks also to all the maintainers of SàT packages.
614 bef0f893482f misc: added Thomas Preud'homme to contributors + a thanks message to maintainers =) Goffi <goffi@goffi.org> parents: 587 diff changeset	194
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	195
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	196 CONTACT
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	197
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	198 You can join us on the XMPP MUC room (sat@chat.jabberfr.org), or individually:
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	199
2104 4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	200 SàT team:
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	201 - contact@salut-a-toi.invalid (replace invalid by org)
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	202 - https://libervia.org/blog/salut-a-toi (blog)
4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	203
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	204 Goffi:
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	205 - goffi@goffi.org (e-mail)
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	206 - goffi@jabber.fr (jid)
2104 4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	207 - https://www.goffi.org (blog - based on Libervia -, with fresh news about SàT)
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	208
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	209 Souliane:
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	210 - souliane@mailoo.org (e-mail)
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	211 - souliane@libervia.org (jid)
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	212
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	213 You'll find the latest version and other stuffs on *.goffi.org websites:
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	214
1201 62135e3ca7ff misc: README typos fixes Matteo Cypriani <mcy@lm7.fr> parents: 1192 diff changeset	215 - wiki (wiki.goffi.org), in French & English so far
238 83d2bc0abf2a version, README, CHANGELOG and INSTALL updates Goffi <goffi@goffi.org> parents: 228 diff changeset	216 - ftp (ftp.goffi.org) for the latest version, or previous ones (and other projects)
83d2bc0abf2a version, README, CHANGELOG and INSTALL updates Goffi <goffi@goffi.org> parents: 228 diff changeset	217 - bugtracker (bugs.goffi.org) to report any problem or give suggestions
871 5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	218 - mailing lists (lists.goffi.org)
5d08ab99e8dd README and INSTALL updates Goffi <goffi@goffi.org> parents: 816 diff changeset	219
2104 4f189bd1d9ed misc: README update Goffi <goffi@goffi.org> parents: 2025 diff changeset	220 and the official SàT website is at https://www.salut-a-toi.org
0 c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	221
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	222
c4bc297b82f0 sat: goffi@necton2 parents: diff changeset	223 This software is dedicated to Roger Poisson.

Mercurial > libervia-backend

annotate README @ 2307:8fa7edd0da24