forked from GNUsocial/gnu-social
update the README
This commit is contained in:
parent
de47c827b7
commit
fae7c08f2d
107
README
107
README
@ -2,8 +2,8 @@
|
|||||||
README
|
README
|
||||||
------
|
------
|
||||||
|
|
||||||
Laconica 0.6.4 ("Catapult")
|
Laconica 0.7.0 ("Rockville")
|
||||||
11 December 2008
|
27 January 2009
|
||||||
|
|
||||||
This is the README file for Laconica, the Open Source microblogging
|
This is the README file for Laconica, the Open Source microblogging
|
||||||
platform. It includes installation instructions, descriptions of
|
platform. It includes installation instructions, descriptions of
|
||||||
@ -19,7 +19,7 @@ microblogging platform. It helps people in a community, company or
|
|||||||
group to exchange short (140 character) messages over the Web. Users
|
group to exchange short (140 character) messages over the Web. Users
|
||||||
can choose which people to "follow" and receive only their friends' or
|
can choose which people to "follow" and receive only their friends' or
|
||||||
colleagues' status messages. It provides a similar service to sites
|
colleagues' status messages. It provides a similar service to sites
|
||||||
like Twitter, Jaiku, Pownce and Plurk.
|
like Twitter, Jaiku and Plurk.
|
||||||
|
|
||||||
With a little work, status messages can be sent to mobile phones,
|
With a little work, status messages can be sent to mobile phones,
|
||||||
instant messenger programs (GTalk/Jabber), and specially-designed
|
instant messenger programs (GTalk/Jabber), and specially-designed
|
||||||
@ -71,56 +71,35 @@ for additional terms.
|
|||||||
New this version
|
New this version
|
||||||
================
|
================
|
||||||
|
|
||||||
This is a minor feature and security improvement version from version
|
This is a major feature release, and includes some bug fixes from the
|
||||||
0.6.3 (release 24 Nov 2008). Notable features of version 0.6.4 include:
|
previous version (0.7.0, released December 14 2008.)
|
||||||
|
|
||||||
- "private" installs won't show any data to the outside world; redirect
|
- Support for groups. Users can join groups and send themed notices
|
||||||
non-logged-in users to login. (See "Private" below)
|
to those groups. All other members of the group receive the notices.
|
||||||
- Ability to "block" a subscriber, which forces them to unsubscribe,
|
- Laconica-specific extensions to the Twitter API.
|
||||||
doesn't allow them to subscribe again, and doesn't allow them to send
|
- A Facebook application.
|
||||||
@-replies
|
- A massive UI redesign. The HTML generated by Laconica has changed
|
||||||
- Fine-grained control of subscriptions; users can choose not to receive
|
significantly, to make theming easier and to give a more open look
|
||||||
notices from other users over SMS, or IM, or both
|
by default. Also, sidebar.
|
||||||
- support for Mozilla microsummaries
|
- Massive code hygiene changes to move towards compliance with the PEAR
|
||||||
(https://wiki.mozilla.org/Microsummaries)
|
coding standards and to support the new UI redesign.
|
||||||
- more efficient support for blacklisting users from the public page
|
- Began the breakup of util.php -- moved about 30% of code to a views
|
||||||
- instructions on the public page for people who aren't logged in
|
hierarchy.
|
||||||
- better registration instructions
|
- UI elements for statistical information (like top posters or most
|
||||||
- a check for license compatibility in receiving OMB notices
|
popular groups) added in a sidebar.
|
||||||
- HTML output in RSS 1.0, 2.0, and Atom feeds
|
- include Javascript badge by Kent Brewster.
|
||||||
- tuned and more reliable 'rememberme' cookies for username/password
|
- Updated online documentation.
|
||||||
and OpenID logins
|
- Cropping of user avatars using Jcrop.
|
||||||
- a utility for setting user passwords
|
- fix for Twitter bridge to not send "Expect:" headers.
|
||||||
- a "ban" configuration variable to ban certain users from posting
|
- add 'dm' as a synonym for 'd' in commands.
|
||||||
notices
|
- Upgrade upstream version of jQuery to 1.3.
|
||||||
- an configurable posting throttle to keep any one user from flooding
|
- Upgrade upstream version of PHP-OpenID to 2.1.2.
|
||||||
the site with messages.
|
- Move OpenMicroBlogging specification to its own repository.
|
||||||
- fine-tuned url-shortening: only shorten if it's needed, only expand
|
- Make tag-based RSS streams work.
|
||||||
certain URLs, and handle failure of URL-shortening services reliably
|
- Additional locales: Bulgarian, Catalan, Greek, Hebrew, simplified
|
||||||
- disable Ajax input for notices, subscribe, nudge, while the
|
Chinese, Telugu, Taiwanese Chinese, Vietnamese,
|
||||||
request is processing
|
- PostgreSQL updates.
|
||||||
- early implementation of support for Last-Modified and ETag-based
|
- Nasty bug in Twitter bridge that wouldn't verify with Twitter
|
||||||
caching
|
|
||||||
- initial microformats support
|
|
||||||
- redirect on bad nicknames in URLs
|
|
||||||
- correctly send emails in recipient's, not sender's, language
|
|
||||||
- correct email content type
|
|
||||||
- Change "Most Favorited" page to "Popular"
|
|
||||||
- properly support the "since" parameter in API calls
|
|
||||||
- Fix for changes in validate_credentials API call for the Twitter
|
|
||||||
bridge
|
|
||||||
- Fix for fatal error when sending email confirmation on registration
|
|
||||||
- Better replies for commands sent through the Ajax channel
|
|
||||||
- Add a User-Agent string for OMB requests
|
|
||||||
- Upgrade upstream library XMPPHP
|
|
||||||
- Upgrade upstream library JQuery Forms
|
|
||||||
- Code cleanup: checkboxes have proper <label> elements
|
|
||||||
- Code cleanup: consolidated various notice-listing code in one place
|
|
||||||
- Better support for unsubscribing from a remote user
|
|
||||||
- Stump of experimental Facebook application (not ready for use! code
|
|
||||||
review only!)
|
|
||||||
- Stump of experimental user account deletion (not ready for use! code
|
|
||||||
review only!)
|
|
||||||
|
|
||||||
Prerequisites
|
Prerequisites
|
||||||
=============
|
=============
|
||||||
@ -202,6 +181,7 @@ and the URLs are listed here for your convenience.
|
|||||||
version (patches have been submitted). Upgrading to the upstream
|
version (patches have been submitted). Upgrading to the upstream
|
||||||
version may render your Laconica site unable to send or receive XMPP
|
version may render your Laconica site unable to send or receive XMPP
|
||||||
messages.
|
messages.
|
||||||
|
- Facebook library. Used for the Facebook application.
|
||||||
|
|
||||||
A design goal of Laconica is that the basic Web functionality should
|
A design goal of Laconica is that the basic Web functionality should
|
||||||
work on even the most restrictive commercial hosting services.
|
work on even the most restrictive commercial hosting services.
|
||||||
@ -219,9 +199,9 @@ especially if you've previously installed PHP/MySQL packages.
|
|||||||
1. Unpack the tarball you downloaded on your Web server. Usually a
|
1. Unpack the tarball you downloaded on your Web server. Usually a
|
||||||
command like this will work:
|
command like this will work:
|
||||||
|
|
||||||
tar zxf laconica-0.6.4.tar.gz
|
tar zxf laconica-0.7.0.tar.gz
|
||||||
|
|
||||||
...which will make a laconica-0.6.4 subdirectory in your current
|
...which will make a laconica-0.7.0 subdirectory in your current
|
||||||
directory. (If you don't have shell access on your Web server, you
|
directory. (If you don't have shell access on your Web server, you
|
||||||
may have to unpack the tarball on your local computer and FTP the
|
may have to unpack the tarball on your local computer and FTP the
|
||||||
files to the server.)
|
files to the server.)
|
||||||
@ -229,7 +209,7 @@ especially if you've previously installed PHP/MySQL packages.
|
|||||||
2. Move the tarball to a directory of your choosing in your Web root
|
2. Move the tarball to a directory of your choosing in your Web root
|
||||||
directory. Usually something like this will work:
|
directory. Usually something like this will work:
|
||||||
|
|
||||||
mv laconica-0.6.4 /var/www/mublog
|
mv laconica-0.7.0 /var/www/mublog
|
||||||
|
|
||||||
This will make your Laconica instance available in the mublog path of
|
This will make your Laconica instance available in the mublog path of
|
||||||
your server, like "http://example.net/mublog". "microblog" or
|
your server, like "http://example.net/mublog". "microblog" or
|
||||||
@ -380,7 +360,7 @@ configuration is essentially email configuration.
|
|||||||
Each user sends to a made-up email address, which they keep a secret.
|
Each user sends to a made-up email address, which they keep a secret.
|
||||||
Incoming email that is "From" the user's SMS email address, and "To"
|
Incoming email that is "From" the user's SMS email address, and "To"
|
||||||
the users' secret email address on the site's domain, will be
|
the users' secret email address on the site's domain, will be
|
||||||
converted to a message and stored in the DB.
|
converted to a notice and stored in the DB.
|
||||||
|
|
||||||
For this to work, there *must* be a domain or sub-domain for which all
|
For this to work, there *must* be a domain or sub-domain for which all
|
||||||
(or most) incoming email can pass through the incoming mail filter.
|
(or most) incoming email can pass through the incoming mail filter.
|
||||||
@ -625,6 +605,10 @@ default-avatar-mini.png: Ditto ditto, but 24x24. For subscriptions
|
|||||||
You may want to start by copying the files from the default theme to
|
You may want to start by copying the files from the default theme to
|
||||||
your own directory.
|
your own directory.
|
||||||
|
|
||||||
|
NOTE: the HTML generated by Laconica changed *radically* between
|
||||||
|
version 0.6.x and 0.7.x. Older themes will need signification
|
||||||
|
modification to use the new output format.
|
||||||
|
|
||||||
Translation
|
Translation
|
||||||
-----------
|
-----------
|
||||||
|
|
||||||
@ -669,7 +653,7 @@ Upgrading
|
|||||||
If you've been using Laconica 0.6, 0.5 or lower, or if you've been
|
If you've been using Laconica 0.6, 0.5 or lower, or if you've been
|
||||||
tracking the "git" version of the software, you will probably want
|
tracking the "git" version of the software, you will probably want
|
||||||
to upgrade and keep your existing data. There is no automated upgrade
|
to upgrade and keep your existing data. There is no automated upgrade
|
||||||
procedure in Laconica 0.6.4. Try these step-by-step instructions; read
|
procedure in Laconica 0.7.0. Try these step-by-step instructions; read
|
||||||
to the end first before trying them.
|
to the end first before trying them.
|
||||||
|
|
||||||
0. Download Laconica and set up all the prerequisites as if you were
|
0. Download Laconica and set up all the prerequisites as if you were
|
||||||
@ -1077,7 +1061,7 @@ repository (see below), and you get a compilation error ("unexpected
|
|||||||
T_STRING") in the browser, check to see that you don't have any
|
T_STRING") in the browser, check to see that you don't have any
|
||||||
conflicts in your code.
|
conflicts in your code.
|
||||||
|
|
||||||
If you upgraded to Laconica 0.6.4 without reading the "Notice inboxes"
|
If you upgraded to Laconica 0.7.0 without reading the "Notice inboxes"
|
||||||
section above, and all your users' 'Personal' tabs are empty, read the
|
section above, and all your users' 'Personal' tabs are empty, read the
|
||||||
"Notice inboxes" section above.
|
"Notice inboxes" section above.
|
||||||
|
|
||||||
@ -1156,9 +1140,12 @@ if anyone's been overlooked in error.
|
|||||||
* Erik Stambaugh
|
* Erik Stambaugh
|
||||||
* 'drry'
|
* 'drry'
|
||||||
* Gina Haeussge
|
* Gina Haeussge
|
||||||
* Ken Sheppardson (Trac server, man-about-town)
|
|
||||||
* Tiago 'gouki' Faria (entrans)
|
|
||||||
* Tryggvi Björgvinsson
|
* Tryggvi Björgvinsson
|
||||||
|
* Adrian Lang
|
||||||
|
* Ori Avtalion
|
||||||
|
* Meitar Moscovitz
|
||||||
|
* Ken Sheppardson (Trac server, man-about-town)
|
||||||
|
* Tiago 'gouki' Faria (i18n managerx)
|
||||||
|
|
||||||
Thanks also to the developers of our upstream library code and to the
|
Thanks also to the developers of our upstream library code and to the
|
||||||
thousands of people who have tried out Identi.ca, installed Laconi.ca,
|
thousands of people who have tried out Identi.ca, installed Laconi.ca,
|
||||||
|
Loading…
x
Reference in New Issue
Block a user