Install¶
You will have to install pip and virtualenv on your system. You should first install pip package then it will be easier to install virtualenv with it, like this :
sudo pip install virtualenv
It is recommended to install it in a virtualenv environment like this :
virtualenv --no-site-packages my_optimus_projects
cd my_optimus_projects
source bin/activate
pip install optimus
This way you can work safely on your projects within this environment without any change to your system.
Also you can install it directly on your system without virtualenv, just use pip :
sudo pip install optimus
Operator system¶
Optimus has been developed for Linux systems, it works also on Windows and MacOSX but you should have some tasks that will differs from the present documentation.
Asset compressor¶
Default install comes with yui-compressor as a dependancy to use with webassets because it is a great choice to compress CSS and Javascript assets. But beware that it requires you to have a Java Runtime Environment installed on your system, the OpenJDK is perfectly supported.
Webserver for development¶
You can install cherrypy, a simple Web server, to see your builded pages :
pip install cherrypy==3.2.4
Read Web server to see how to use it.
Enable i18n support¶
Then you will have to enable it by adding the Jinja2 i18n extension in your settings :
JINJA_EXTENSIONS = (
...
'jinja2.ext.i18n',
...
)
This is only for a new project manually created, i18n
project template already installs this for you.
Use Foundation 3¶
This will require a recent Compass install and thus, a recent Ruby install too. If you encounter problems with this, you can see to rvm to install a more recent Ruby version without touching your system packages.
Just target the correct version when you install the Foundation gem :
gem install --version '3.2.5' zurb-foundation
Then you should install the plugin to have a project template to create new projects that allready embeds Foundation 3 :
pip install optimus_foundation
Use Foundation 5¶
This will also require a recent Compass install and thus, a recent Ruby install too. If you encounter problems with this, you can see to rvm to install a more recent Ruby version without touching your system packages.
Then just install the plugin to have a project template to create new projects that allready embeds Foundation 5 :
pip install optimus_foundation_5