It's a simple Playdoh instance, which is a Django project.
These instructions assume you have git and pip installed. If you don't have pip install, you can install it with easy_install pip.
Start by getting the source:
$ git clone --recursive git://github.com/mozilla/bedrock.git $ cd bedrock
(Make sure you use --recursive)
You need to create a virtual environment for Python libraries. Skip the first instruction if you already have virtualenv installed:
$ pip install virtualenv # installs virtualenv, skip if already have it $ virtualenv venv # create a virtual env in the folder `venv` $ source venv/bin/activate # activate the virtual env $ pip install -r requirements/compiled.txt # installs compiled dependencies
If you are on OSX and some of the compiled dependencies fails to compile, try explicitly setting the arch flags and try again:
$ export ARCHFLAGS="-arch i386 -arch x86_64" $ pip install -r requirements/compiled.txt
Now configure the application to run locally by creating your local settings file:
$ cp settings/local.py-dist settings/local.py
You shouldn't need customize anything in there yet.
Check out the latest product-details:
$ ./manage.py update_product_details
Lastly, you need to install node and the less package. Soon you won't need this for local development but currently it compiles the LESS CSS code on the server-side:
$ npm -g install less
You don't have to use npm to install less; feel free to install it however you want.
Add the path to the LESS compiler in you local.py config file in the settings folder. It is most likely /usr/local/bin/lessc, so add the following line:
LESS_BIN = '/usr/local/bin/lessc'
Make it run
To make the server run, make sure you are inside a virtualenv, and then run the server:
$ ./manage.py runserver
If you are not inside a virtualenv, you can activate it by doing:
$ source venv/bin/activate
If you get the error "NoneType is not iterable", you didn't check out the latest product-details. See the above section for that.
If you want to install localizations, just check out the
git svn clone https://svn.mozilla.org/projects/mozilla.com/trunk/locales/ locale # or svn checkout https://svn.mozilla.org/projects/mozilla.com/trunk/locales/ locale
You can use git or svn to checkout the repo. Make sure that it is named
locale. If you already have it checked out as
locales, just do:
ln -s locales locale
You can read more details about how to localize content :ref:`here<l10n>`.
A shortcut for activating virtual envs in zsh is . venv/bin/activate. The dot is the same as source.
There's a project called virtualenvwrapper that provides a better interface for managing/activating virtual envs, so you can use that if you want.