mirror of
https://github.com/zulip/zulip.git
synced 2025-11-03 05:23:35 +00:00
5359e6b0d4
This results in a substantial performance improvement for all of
Zulip's backend templates.
Changes in templates:
- Change `block.super` to `super()`.
- Remove `load` tag because Jinja2 doesn't support it.
- Use `minified_js()|safe` instead of `{% minified_js %}`.
- Use `compressed_css()|safe` instead of `{% compressed_css %}`.
- `forloop.first` -> `loop.first`.
- Use `{{ csrf_input }}` instead of `{% csrf_token %}`.
- Use `{# ... #}` instead of `{% comment %}`.
- Use `url()` instead of `{% url %}`.
- Use `_()` instead of `{% trans %}` because in Jinja `trans` is a block tag.
- Use `{% trans %}` instead of `{% blocktrans %}`.
- Use `{% raw %}` instead of `{% verbatim %}`.
Changes in tools:
- Check for `trans` block in `check-templates` instead of `blocktrans`
Changes in backend:
- Create custom `render_to_response` function which takes `request` objects
instead of `RequestContext` object. There are two reasons to do this:
1. `RequestContext` is not compatible with Jinja2
2. `RequestContext` in `render_to_response` is deprecated.
- Add Jinja2 related support files in zproject/jinja2 directory. It
includes a custom backend and a template renderer, compressors for js
and css and Jinja2 environment handler.
- Enable `slugify` and `pluralize` filters in Jinja2 environment.
Fixes #620.
108 lines
5.9 KiB
ReStructuredText
108 lines
5.9 KiB
ReStructuredText
===================
|
|
Directory structure
|
|
===================
|
|
|
|
This page documents the Zulip directory structure and how to decide where to
|
|
put a file.
|
|
|
|
Scripts
|
|
=======
|
|
|
|
+--------------------+-----------------------------------------------------------------------------------+
|
|
| ``scripts/`` | Scripts that production deployments might run manually (e.g. ``restart-server``) |
|
|
+--------------------+-----------------------------------------------------------------------------------+
|
|
| ``scripts/lib/`` | Scripts that are needed on production deployments but humans should never run |
|
|
+--------------------+-----------------------------------------------------------------------------------+
|
|
| ``scripts/setup/`` | Tools that production deployments will only run once, during installation |
|
|
+--------------------+-----------------------------------------------------------------------------------+
|
|
| ``tools/`` | Development tools |
|
|
+--------------------+-----------------------------------------------------------------------------------+
|
|
|
|
Bots
|
|
====
|
|
|
|
+------------------------+----------------------------------------------------------------------+
|
|
| ``api/integrations`` | Bots distributed as part of the Zulip API bundle. |
|
|
+------------------------+----------------------------------------------------------------------+
|
|
| ``bots/`` | Previously Zulip internal bots. These usually need a bit of work. |
|
|
+------------------------+----------------------------------------------------------------------+
|
|
|
|
Management commands
|
|
===================
|
|
|
|
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
|
|
| ``zerver/management/commands/`` | Management commands one might run at a production deployment site (e.g. scripts to change a value or deactivate a user properly) |
|
|
+-------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
Views
|
|
=====
|
|
|
|
+--------------------------------+-----------------------------------------+
|
|
| ``zerver/tornadoviews.py`` | Tornado views |
|
|
+--------------------------------+-----------------------------------------+
|
|
| ``zerver/views/webhooks.py`` | Webhook views |
|
|
+--------------------------------+-----------------------------------------+
|
|
| ``zerver/views/messages.py`` | message-related views |
|
|
+--------------------------------+-----------------------------------------+
|
|
| ``zerver/views/__init__.py`` | other Django views |
|
|
+--------------------------------+-----------------------------------------+
|
|
|
|
Jinja2 Compatibility Files
|
|
==========================
|
|
|
|
+-------------------------------------+--------------------------------------------------------------------+
|
|
| ``zproject/jinja2/__init__.py`` | Jinja2 environment |
|
|
+-------------------------------------+--------------------------------------------------------------------+
|
|
| ``zproject/jinja2/backends.py`` | Jinja2 backend |
|
|
+-------------------------------------+--------------------------------------------------------------------+
|
|
| ``zproject/jinja2/compressors.py`` | Jinja2 compatible functions of Django-Pipeline |
|
|
+-------------------------------------+--------------------------------------------------------------------+
|
|
|
|
|
|
Static assets
|
|
=============
|
|
|
|
+---------------+---------------------------------------------------------------------------------------------------------------+
|
|
| ``assets/`` | For assets not to be served to the web (e.g. the system to generate our favicons) |
|
|
+---------------+---------------------------------------------------------------------------------------------------------------+
|
|
| ``static/`` | For things we do want to both serve to the web and distribute to production deployments (e.g. the webpages) |
|
|
+---------------+---------------------------------------------------------------------------------------------------------------+
|
|
|
|
Puppet
|
|
======
|
|
|
|
+--------------------+----------------------------------------------------------------------------------+
|
|
| ``puppet/zulip`` | For configuration for production deployments |
|
|
+--------------------+----------------------------------------------------------------------------------+
|
|
|
|
Templates
|
|
=========
|
|
|
|
+--------------------------+--------------------------------------------------------+
|
|
| ``templates/zerver`` | For Jinja2 templates for the backend (for zerver app) |
|
|
+--------------------------+--------------------------------------------------------+
|
|
| ``static/templates`` | Handlebars templates for the frontend |
|
|
+--------------------------+--------------------------------------------------------+
|
|
|
|
Tests
|
|
=====
|
|
|
|
+-------------------------+-----------------------------------+
|
|
| ``zerver/tests/`` | Backend tests |
|
|
+-------------------------+-----------------------------------+
|
|
| ``frontend_tests/node`` | Node Frontend unit tests |
|
|
+-------------------------+-----------------------------------+
|
|
| ``frontend_tests/tests``| Casper frontend tests |
|
|
+-------------------------+-----------------------------------+
|
|
|
|
Documentation
|
|
=============
|
|
|
|
+-------------+-----------------------------------------------+
|
|
| ``docs/`` | Source for this documentation |
|
|
+-------------+-----------------------------------------------+
|
|
|
|
You can consult the repository's .gitattributes file to see exactly
|
|
which components are excluded from production releases (release
|
|
tarballs are generated using tools/build-release-tarball).
|