pillar/README.md
Sybren A. Stüvel d6506b6402 Moved Celery CLI commands to 'manage.py celery' submodule + added extensions:
Added a 'celery queue' command, which is supposed to show queued
Celery tasks (but doesn't work quite as I'd expect).

Added a 'celery purge' command, which purges queued Celery tasks.
2017-06-06 15:05:18 +02:00

2.5 KiB

Pillar

This is the latest iteration on the Attract project. We are building a unified framework called Pillar. Pillar will combine Blender Cloud and Attract. You can see Pillar in action on the Blender Cloud.

Custom fonts

The icons on the website are drawn using a custom font, stored in pillar/web/static/font. This font is generated via Fontello by uploading pillar/web/static/font/config.json.

Note that we only use the WOFF and WOFF2 formats, and discard the others supplied by Fontello.

After replacing the font files & config.json, edit the Fontello-supplied font.css to remove all font formats except woff and woff2. Then upload it to css2sass to convert it to SASS, and place it in src/styles/font-pillar.sass.

Don't forget to Gulp!

Installation

Make sure your /data directory exists and is writable by the current user. Alternatively, provide a pillar/config_local.py that changes the relevant settings.

git clone git@git.blender.org:pillar-python-sdk.git ../pillar-python-sdk
pip install -e ../pillar-python-sdk
pip install -U -r requirements.txt
pip install -e .

HDRi viewer

The HDRi viewer uses Google VRView. To upgrade, get those files:

and place them in pillar/web/static/assets/vrview. Replace images/loading.gif in embed.min.js with static/pillar/assets/vrview/loading.gif.

You may also want to compare their index.html to our src/templates/vrview.jade.

When on a HDRi page with the viewer embedded, use this JavaScript code to find the current yaw: vrview_window.contentWindow.yaw(). This can be passed as default_yaw parameter to the iframe.

Celery

Pillar requires Celery for background task processing. This in turn requires a backend and a broker, for which the default Pillar configuration uses Redis and RabbitMQ.

You can run the Celery Worker using manage.py celery worker.

Find other Celery operations with the manage.py celery command.