242 lines
7.5 KiB
Markdown
242 lines
7.5 KiB
Markdown
# GNU social 1.1.2 (alpha)
|
|
August 2014
|
|
|
|
(c) Free Software Foundation, Inc
|
|
(c) StatusNet, Inc
|
|
|
|
This is the README file for GNU social, the free
|
|
software social networking platform. It includes
|
|
general information about the software and the
|
|
project.
|
|
|
|
Some other files to review:
|
|
|
|
- INSTALL: instructions on how to install the software.
|
|
- UPGRADE: upgrading from earlier versions
|
|
- CONFIGURE: configuration options in gruesome detail.
|
|
- PLUGINS.txt: how to install and configure plugins.
|
|
- EVENTS.txt: events supported by the plugin system
|
|
- COPYING: full text of the software license
|
|
|
|
Information on using GNU social can be found in
|
|
the "doc" subdirectory or in the "help" section
|
|
on-line, or you can catch us on IRC in #social on
|
|
the freenode network.
|
|
|
|
## About
|
|
|
|
GNU social is a free social networking
|
|
platform. It helps people in a community, company
|
|
or group to exchange short status updates, do
|
|
polls, announce events, or other social activities
|
|
(and you can add more!). Users can choose which
|
|
people to "follow" and receive only their friends'
|
|
or colleagues' status messages. It provides a
|
|
similar service to sites like Twitter, Google+ or
|
|
Facebook, but is much more awesome.
|
|
|
|
With a little work, status messages can be sent to
|
|
mobile phones, instant messenger programs (using
|
|
XMPP), and specially-designed desktop clients that
|
|
support the Twitter API.
|
|
|
|
GNU social supports an open standard called
|
|
OStatus <http://ostatus.org/> that lets users in
|
|
different networks follow each other. It enables a
|
|
distributed social network spread all across the
|
|
Web.
|
|
|
|
GNU social was originally developed for the
|
|
service, Identi.ca <http://identi.ca/>.
|
|
|
|
It is shared with you in hope that you too make an
|
|
service available to your users. To learn more,
|
|
please see the Open Software Service Definition
|
|
1.1:
|
|
|
|
http://www.opendefinition.org/ossd
|
|
|
|
### License
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Affero General Public License as
|
|
published by the Free Software Foundation, either version 3 of the
|
|
License, or (at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Affero General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Affero General Public
|
|
License along with this program, in the file "COPYING". If not, see
|
|
<http://www.gnu.org/licenses/>.
|
|
|
|
IMPORTANT NOTE: The GNU Affero General Public License (AGPL) has
|
|
*different requirements* from the "regular" GPL. In particular, if
|
|
you make modifications to the GNU social source code on your server,
|
|
you *MUST MAKE AVAILABLE* the modified version of the source code
|
|
to your users under the same license. This is a legal requirement
|
|
of using the software, and if you do not wish to share your
|
|
modifications, *YOU MAY NOT INSTALL GNU SOCIAL*.
|
|
|
|
Documentation in the /doc-src/ directory is available under the
|
|
Creative Commons Attribution 3.0 Unported license, with attribution to
|
|
"GNU social". See http://creativecommons.org/licenses/by/3.0/ for details.
|
|
|
|
CSS and images in the /theme/ directory are available under the
|
|
Creative Commons Attribution 3.0 Unported license, with attribution to
|
|
"GNU social". See http://creativecommons.org/licenses/by/3.0/ for details.
|
|
|
|
Our understanding and intention is that if you add your own theme that
|
|
uses only CSS and images, those files are not subject to the copyleft
|
|
requirements of the Affero General Public License 3.0. See
|
|
http://wordpress.org/news/2009/07/themes-are-gpl-too/ . This is not
|
|
legal advice; consult your lawyer.
|
|
|
|
Additional library software has been made available in the 'extlib'
|
|
directory. All of it is Free Software and can be distributed under
|
|
liberal terms, but those terms may differ in detail from the AGPL's
|
|
particulars. See each package's license file in the extlib directory
|
|
for additional terms.
|
|
|
|
## New this version
|
|
|
|
This is a security fix and bug fix release since 1.1.0,
|
|
released 2 July 2012. All 1.1.0 sites should upgrade to this version.
|
|
|
|
It includes the following changes:
|
|
|
|
- Fixes for SQL injection errors in profile lists.
|
|
- Improved ActivityStreams JSON representation of activities and objects.
|
|
- Upgrade to the Twitter 1.1 API.
|
|
- More robust handling of errors in distribution.
|
|
- Fix error in OStatus subscription for remote groups.
|
|
- Fix error in XMPP distribution.
|
|
|
|
### Troubleshooting
|
|
|
|
The primary output for GNU social is syslog,
|
|
unless you configured a separate logfile. This is
|
|
probably the first place to look if you're getting
|
|
weird behaviour from GNU social.
|
|
|
|
If you're tracking the unstable version of
|
|
GNU social in the git repository (see below), and you
|
|
get a compilation error ("unexpected T_STRING") in
|
|
the browser, check to see that you don't have any
|
|
conflicts in your code.
|
|
|
|
### Unstable version
|
|
|
|
If you're adventurous or impatient, you may want
|
|
to install the development version of
|
|
StatusNet. To get it, use the git version control
|
|
tool <http://git-scm.com/> like so:
|
|
|
|
git clone git@gitorious.org:social/mainline.git
|
|
|
|
Using it is a mixed bag. On the positive side, it
|
|
usually includes the latest security and bug fix
|
|
patches. On the downside, it may also include
|
|
changes that require admin intervention (like
|
|
running a script or even raw SQL!) that may not be
|
|
documented yet. It may be a good idea to test this
|
|
version before installing it on your production
|
|
machines.
|
|
|
|
To keep it up-to-date, use 'git pull'. Watch for
|
|
conflicts!
|
|
|
|
## Further information
|
|
|
|
There are several ways to get more information
|
|
about GNU social.
|
|
|
|
* The #social IRC channel on freenode.net <http://www.freenode.net/>.
|
|
* The GNU social website
|
|
* Following us on GNU social -- http://quitter.se/gnusocial
|
|
* Following us on Twitter -- https://twitter.com/gnusocial
|
|
|
|
* GNU social has a bug tracker for any defects you may find, or ideas for
|
|
making things better. http://bugz.foocorp.net/
|
|
|
|
Credits
|
|
=======
|
|
|
|
The following is an incomplete list of developers
|
|
who've worked on GNU social, or its predecessors
|
|
StatusNet and Free Social. Apologies for any
|
|
oversight; please let mattl@gnu.org know if
|
|
anyone's been overlooked in error.
|
|
|
|
## Project Founders
|
|
|
|
* Matt Lee (GNU social)
|
|
* Evan Prodromou (StatusNet)
|
|
* Mikael Nordfeldth (Free Social)
|
|
|
|
Thanks to all of the StatusNet developers:
|
|
|
|
* Zach Copley, StatusNet, Inc.
|
|
* Earle Martin, StatusNet, Inc.
|
|
* Marie-Claude Doyon, designer, StatusNet, Inc.
|
|
* Sarven Capadisli, StatusNet, Inc.
|
|
* Robin Millette, StatusNet, Inc.
|
|
* Ciaran Gultnieks
|
|
* Michael Landers
|
|
* Ori Avtalion
|
|
* Garret Buell
|
|
* Mike Cochrane
|
|
* Matthew Gregg
|
|
* Florian Biree
|
|
* Erik Stambaugh
|
|
* 'drry'
|
|
* Gina Haeussge
|
|
* Tryggvi Björgvinsson
|
|
* Adrian Lang
|
|
* Ori Avtalion
|
|
* Meitar Moscovitz
|
|
* Ken Sheppardson (Trac server, man-about-town)
|
|
* Tiago 'gouki' Faria (i18n manager)
|
|
* Sean Murphy
|
|
* Leslie Michael Orchard
|
|
* Eric Helgeson
|
|
* Ken Sedgwick
|
|
* Brian Hendrickson
|
|
* Tobias Diekershoff
|
|
* Dan Moore
|
|
* Fil
|
|
* Jeff Mitchell
|
|
* Brenda Wallace
|
|
* Jeffery To
|
|
* Federico Marani
|
|
* mEDI
|
|
* Brett Taylor
|
|
* Brigitte Schuster
|
|
* Siebrand Mazeland and the amazing volunteer translators at translatewiki.net
|
|
* Brion Vibber, StatusNet, Inc.
|
|
* James Walker, StatusNet, Inc.
|
|
* Samantha Doherty, designer, StatusNet, Inc.
|
|
|
|
### Extra special thanks to the GNU socialites
|
|
|
|
* Craig Andrews
|
|
* Donald Robertson
|
|
* Deb Nicholson
|
|
* Ian Denhart
|
|
* Steven DuBois
|
|
* Blaine Cook
|
|
* Henry Story
|
|
* Melvin Carvalho
|
|
|
|
Thanks also to the developers of our upstream
|
|
library code and to the thousands of people who
|
|
have tried out GNU social, told their friends, and
|
|
built the fediverse network to what it is today.
|
|
|
|
### License help from
|
|
|
|
* Bradley M. Kuhn
|
|
|