annotate README4PACKAGERS @ 873:36572b0a56e6

README4PACKAGERS update
author Goffi <goffi@goffi.org>
date Wed, 26 Feb 2014 01:54:16 +0100
parents a650f01737d7
children 3a943b5f2cec
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
872
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
1 First of all, thank you for packaging SàT :)
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
2
873
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
3 You will find below the list of dependencies for the backend and the frontends, and some other infos.
872
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
4
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
5 ############################
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
6 List of general dependencies
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
7 ############################
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
8
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
9 Python 2.7
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
10 dbus-python
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
11
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
12 ####################################
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
13 List of dependencies for SàT backend
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
14 ####################################
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
15
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
16 cStringIO
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
17 html2text
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
18 lxml
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
19 Mutagen
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
20 PIL
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
21 PyFeed
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
22 Twisted Core
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
23 Twisted Mail
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
24 Twisted Web
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
25 Twisted Words
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
26 Wokkel
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
27 xe
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
28 Zope
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
29
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
30 Recommandation: markdown
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
31
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
32 ####################################
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
33 List of dependencies for Jp frontend
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
34 ####################################
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
35
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
36 GObject
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
37 progressbar
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
38
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
39 ############################################
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
40 List of dependencies for Primitivus frontend
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
41 ############################################
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
42
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
43 GObject
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
44 progressbar
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
45 Urwid
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
46 Urwid-satext
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
47
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
48 Suggestion: Python X Library
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
49
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
50 #####################################
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
51 List of dependencies for Wix frontend
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
52 #####################################
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
53
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
54 wxPython
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
55
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
56
873
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
57 ##################
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
58 Satellite projects
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
59 ##################
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
60
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
61 Several project have been made around SàT, they are all available at http://repos.goffi.org:
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
62
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
63 - Libervia: the both Ajax and static web frontend
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
64
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
65 - SàT PubSub: a PubSub service which manage experimental features like fine permission tuning
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
66
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
67 - SàT media: Media needed to by the frontends
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
68
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
69 - Urwid SàText: Widgets for urwid library, designed for SàT but can be useful for other projects. Mandatory for Primitivus
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
70
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
71 ## Folowing ones are not needed in a distribution, because there are in a too early stage of development, or not useful for general purpose ##
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
72
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
73 - Bellaciao: a Qt frontend, at an early stage of development
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
74
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
75 - Salut: a XMPP directory, at a very early stage of development
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
76
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
77 - SàT Website: the code of the website
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
78
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
79
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
80 ########
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
81 Licences
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
82 ########
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
83
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
84 We are careful about the licences we use. Our projects are licenced as follow:
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
85
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
86 - Libervia, SàT PubSub, Bellaciao, Salut, SàT Website: AGPL v3+
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
87
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
88 - Urwid SàText: LGPL v3+
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
89
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
90 When an external code is included (portion or library), we indicate the source and the licence, and we are careful to take Libre licences only. If we have a mistake somewhere, please let us know.
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
91
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
92 The case of SàT Media is particular are there is a compilation of media from severals sources. SàT Logo was made by Adrien Vigneron and is under CC By-SA. Other works are all under Free licences, licences are specified in the base directory of each package.
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
93
872
a650f01737d7 added README4PACKAGERS
souliane <souliane@mailoo.org>
parents:
diff changeset
94
873
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
95 #####################
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
96 Packages and versions
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
97 #####################
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
98
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
99 We have packaged Wix, Primitivus, and jp with the core backend, as we thing theses frontends should be shipped with each SàT distribution. But it would be nice to allow the use to install them separately: Wix will be useless for a server.
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
100
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
101 Libervia is on its all package because of its specificities (it's a huge project by itself, it use Pyjamas Python => JS Compiler, etc). But it's a part of the same project.
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
102
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
103 All the official frontends have the same version, which is the version of the backend they use.
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
104
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
105
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
106 #######
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
107 Updates
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
108 #######
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
109
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
110 There is a sqlite database per user (default in ~/.sat.db, we don't follow XDG base directory specifications yet), it is updated automatically if there is a schema change.
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
111
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
112
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
113 ##############
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
114 CONTRAT SOCIAL
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
115 ##############
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
116
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
117 The social contract is an important part of the project, please don't forget to distribute it with SàT
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
118
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
119
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
120 ####
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
121 MISC
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
122 ####
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
123
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
124 There is a completion file for Zsh which detect the parameters of jp. It's available in misc/ directory (.jp) and must be available in a path included in user's fpath.
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
125 The translation are global to all the frontend (no translation available in Libervia yet). There are not up-to-date for 0.4 version.
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
126
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
127
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
128
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
129
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
130 Thank you again for you help, don't forget to give us your name and contact email so we can credit you, and don't hesitate to contact us if you have any question (on the sat XMPP room at sat@chat.jabberfr.org, or check README for individual contacts).
36572b0a56e6 README4PACKAGERS update
Goffi <goffi@goffi.org>
parents: 872
diff changeset
131