27
edits
(→Prerequisites: Performance suggestions: Ruby 1.9 and thin) |
No edit summary |
||
(10 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
Thanks for downloading the code to the Bespin project. You can easily get Bespin's Python server running on your local Mac or Linux machine (see note about Windows below). | Thanks for downloading the code to the Bespin project. You can easily get Bespin's Python server running on your local Mac or Linux machine (see note about Windows below). | ||
== Prerequisites == | == Prerequisites == | ||
Line 12: | Line 6: | ||
*Mercurial | *Mercurial | ||
*Python 2.5 or 2.6 | *Python 2.5 or 2.6 | ||
Python 2.6 is preferred. | |||
'''NOTE FOR LINUX USERS:''' ''If you are running on a Linux system, you will likely need a "python-dev" and "ruby1.8-dev" (on Ubuntu; possibly "python-devel" elsewhere) package installed, if you do not already have it. If you want to build the embedded release, you will want libyaml: the package on Ubuntu is "libyaml-dev".'' | |||
'''NOTE FOR LINUX USERS:''' ''If you are running on a Linux system, you will likely need a "python-dev" (on Ubuntu; possibly "python-devel" elsewhere) package installed, if you do not already have it.'' | |||
'''NOTE FOR MAC USERS:''' ''You will need Xcode installed.'' | '''NOTE FOR MAC USERS:''' ''You will need Xcode installed.'' | ||
Line 43: | Line 30: | ||
python bootstrap.py --no-site-packages | python bootstrap.py --no-site-packages | ||
to get the environment set up. This is built around [http://pypi.python.org/pypi/virtualenv virtualenv]. | to get the environment set up. This is built around [http://pypi.python.org/pypi/virtualenv virtualenv]. Please watch for helpful hints and instructions on screen. | ||
In Unix-like environments, the next step is to activate the virtualenv using this command: | |||
source bin/activate | |||
on Windows, the command is Scripts/activate.bat | |||
Once the virtualenv is activate, you need to get the server set up: | |||
paver install_server | |||
And the first time around, you're also going to want to get a database set up: | |||
paver create_db | |||
If you have some trouble on macos x like the error message: ImportError: No module named `xxx' | |||
It's probably cause the server side is not completely installed so try | |||
cd ../bespinserver | |||
paver develop | |||
paver create_db | |||
==Starting the development server== | |||
If you are no longer (or not yet) in the virtualenv environment run within the bespinclient directory: | |||
source bin/activate | |||
To start the server execute: | |||
paver start | |||
This will start the Bespin server. You can now access the Bespin editor at http://localhost:8080/ in you browser. | |||
Have fun! | |||
==More Documentation== | ==More Documentation== | ||
The documentation of the last release is [https://bespin.mozillalabs.com/docs/ here]. | |||
==Contributing to Bespin== | ==Contributing to Bespin== |
edits