Info

Newebe is a distributed social platform.

Author

Gelnior (http://gelnior.wordpress.com)

License

AGPL v3.0

Version

0.5.0

• python >= 2.6
• couchdb >= 0.11.0
• couchdbkit >= 0.4.8
• tornado >= 2.0.0
• daemon >= 1.0.0
• pycurl >= 1.0.0
• markdown >= 2.0.0
• pytz
• PIL >= 1.1.6
• lettuce >= 0.1.9

Set up a development environment (Ubuntu and Debian) ==============================================

Server

Install following packages:

python python-setuptools python-pip python-pycurl python-daemon python-imaging couchdb git openssl

Then via easy_install:

pip install -r deploy/requirements.txt

Retrieve Newebe project:

git clone http://github.com/gelnior/newebe.git

In Newebe settings file (settings.py), set DEBUG variable to True.

Then, still in Newebe directory set DB by running:

python syncdb.py

step 4 Set DEBUG constant to True in settings.py or local_settings.py

To change database name or port change, you must modify your settings.py file by settings the following constants : TORNADO_PORT and COUCHDB_DB_NAME. Default port is 8000 and default database name is newebe. Time zone is set in the same you. So if you want to set your own time zone, you must change the TIMEZONE constant value by your timezone. Here is the list of [[available timezones]].

NB: The best way to deal with specific configuration is to set this variable in a file called local_settings.py in the same directory as settings.py.

local_settings.py exemple:

TORNADO_PORT = 8000
COUCHDB_DB_NAME = "newebe"
TIMEZONE = "Europe/Paris"
DEBUG = True
COOKIE_KEY = "61oETzKXQAGaYdkL5gEmGeJJFuYh7EQnp2XdTP1o/Vo="

Create certificate for HTTPS. This will ask some questions, answer as you like:

sudo openssl genrsa -out ./server.key 1024
sudo openssl req -new -x509 -days 3650 -key ./server.key -out ./server.crt

Run server:

python newebe_server.py

and, at last run the server:

python newebe_server.py

In your browser, connect to http://localhost:8000/ and check that everything is fine.

Client

To work on client you will need node.js. So first install it:

git clone https://github.com/ry/node.git

cd node
./configure
make
make install

Then install its package manager, NPM:

curl http://npmjs.org/install.sh | sh

Now install tools we need, Coffeescript compiler:

npm install coffe-script

Cake, the build tool:

npm install cake

UglifyJS, the minifier:

npm install uglifyjs

And the Stylus compiler for CSS:

npm install stylus

Then when you finish to work on client code. At the root of the module you worked on, type:

cake build

or for automatic build:

cake watch