Gecko [ www.finalhopeacademy.com ]

Name	Size	Permission
filters	[ DIR ]	drwxr-xr-x
functions	[ DIR ]	drwxr-xr-x
tags	[ DIR ]	drwxr-xr-x
tests	[ DIR ]	drwxr-xr-x
advanced.rst	27.58 KB	-rw-r--r--
api.rst	18.93 KB	-rw-r--r--
coding_standards.rst	2.33 KB	-rw-r--r--
deprecated.rst	304 B	-rw-r--r--
index.rst	220 B	-rw-r--r--
installation.rst	907 B	-rw-r--r--
internals.rst	4.36 KB	-rw-r--r--
intro.rst	2.45 KB	-rw-r--r--
recipes.rst	17.06 KB	-rw-r--r--
templates.rst	26.27 KB	-rw-r--r--

Code Editor : coding_standards.rst

Coding Standards
================

When writing Twig templates, we recommend you to follow these official coding
standards:

* Put one (and only one) space after the start of a delimiter (``{{``, ``{%``,
  and ``{#``) and before the end of a delimiter (``}}``, ``%}``, and ``#}``):

.. code-block:: jinja

{{ foo }}
    {# comment #}
    {% if foo %}{% endif %}

When using the whitespace control character, do not put any spaces between
  it and the delimiter:

.. code-block:: jinja

{{- foo -}}
    {#- comment -#}
    {%- if foo -%}{%- endif -%}

* Put one (and only one) space before and after the following operators:
  comparison operators (``==``, ``!=``, ``<``, ``>``, ``>=``, ``<=``), math
  operators (``+``, ``-``, ``/``, ``*``, ``%``, ``//``, ``**``), logic
  operators (``not``, ``and``, ``or``), ``~``, ``is``, ``in``, and the ternary
  operator (``?:``):

.. code-block:: jinja

* Put one (and only one) space after the ``:`` sign in hashes and ``,`` in
  arrays and hashes:

.. code-block:: jinja

{{ [1, 2, 3] }}
     {{ {'foo': 'bar'} }}

* Do not put any spaces after an opening parenthesis and before a closing
  parenthesis in expressions:

.. code-block:: jinja

* Do not put any spaces before and after string delimiters:

.. code-block:: jinja

* Do not put any spaces before and after the following operators: ``|``,
  ``.``, ``..``, ``[]``:

.. code-block:: jinja

{{ foo|upper|lower }}
    {{ user.name }}
    {{ user[name] }}
    {% for i in 1..12 %}{% endfor %}

* Do not put any spaces before and after the parenthesis used for filter and
  function calls:

.. code-block:: jinja

* Do not put any spaces before and after the opening and the closing of arrays
  and hashes:

.. code-block:: jinja

{{ [1, 2, 3] }}
     {{ {'foo': 'bar'} }}

* Use lower cased and underscored variable names:

.. code-block:: jinja

{% set foo = 'foo' %}
     {% set foo_bar = 'foo' %}

* Indent your code inside tags (use the same indentation as the one used for
  the target language of the rendered template):

.. code-block:: jinja

{% block foo %}
         {% if true %}
             true
         {% endif %}
     {% endblock %}

${this.title}

Code Editor : coding_standards.rst