27
edits
(→Getting Started: Make this continue to read properly.) |
No edit summary |
||
(21 intermediate revisions by 7 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 == | |||
You will need the following installed on your system to get Bespin up and running: | |||
*Mercurial | |||
*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 MAC USERS:''' ''You will need Xcode installed.'' | |||
'''NOTE FOR WINDOWS USERS:''' ''Most Bespin developers are using unix-like platforms. Bespin's server should be able to run on Windows, though. You'll need a C compiler, and you can use Microsoft's free [http://www.microsoft.com/Express/VC/ Visual C++] compiler. As an alternative, you can use [http://www.cygwin.com/ Cygwin] or [http://www.mingw.org/ MinGW] to have a unix-like environment on your Windows system.'' | |||
==Getting Started== | ==Getting Started== | ||
Run: | Run: | ||
hg clone http://hg.mozilla.org/labs/bespinclient | |||
hg clone http://hg.mozilla.org/labs/bespinserver | |||
cd bespinclient | |||
This will get the Bespin client and Python Bespin server code checked out. The <code>bespinclient/</code> directory is the "main" directory that you'll use. (See the [[Labs/Bespin/DeveloperGuide/UsingMercurial|Using Mercurial]] article for more detailed instructions on using Mercurial.) | |||
To set up Bespin for the first time, run: | To set up Bespin for the first time, run: | ||
python bootstrap.py --no-site-packages | |||
to get the environment set up. This is built around 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. | |||
You can | |||
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== | ||
Line 59: | Line 74: | ||
For details see: | For details see: | ||
:[[Labs/Bespin/Contributing]] | :[[Labs/Bespin/Contributing]] | ||
edits