Sybren A. Stüvel
3b452d14ce
The attachments should now be rendered using `{attachment slug}` instead
of `@[slug]`. The `link` attribute can be specified in the shortcode
(for attachments that support it), rather than in the attachment itself.
The attachment subdocument is now reduced to `{oid: File ObjectID}`, and
nodes without attachments should NOT have an `attachment` property at
all (previously it would be an empty dict). This makes querying for
nodes with/out attachments easier.
The CLI command `upgrade_attachment_schema` can do dry-run and remove
empty attachments:
- Added --go to actually perform the database changes.
- Remove empty attachments, so that a node either has one or more
attachments or no attachments sub-document at all.
The CLI command `upgrade_attachment_usage` converts `@[slug]` to
`{attachment slug}`. It also takes into account 'link' and 'link_custom'
fields on the attachment. After conversion those fields are removed from
the attachment itself.
Simplified maintentance CLI commands that iterate over all projects:
I've moved the common approach (either run on one project or all of
them, skipping deleted ones, giving a message upon dry-run, and showing
duration of the command) to a new _db_projects() function. The new
function is now used by two recently-touched CLI commands; more of them
could be migrated to use this.
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.pug.
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.
Translations
If the language you want to support doesn't exist, you need to run: translations init es_AR.
Every time a new string is marked for translation you need to update the entire catalog: translations update
And once more strings are translated, you need to compile the translations: translations compile
To mark strings strings for translations in Python scripts you need to
wrap them with the flask_babel.gettext function.
For .pug templates wrap them with _().